คู่มือการใช้งาน CodeIgniter เวอร์ชั่น 1.7.2


Smiley Helper

ไฟล์ Smiley Helper มีฟังก์ชันที่ช่วยจัดการสัญลักษณ์รูปยิ้มต่างๆ (สัญลักษณ์ที่แสดงถึงอารมณ์หรือที่เรียกันติดปากว่า emoticon)

เรียกใช้งานผู้ช่วยนี้

ผู้ช่วยนี้จะถูกเรียกใช้งานได้จากโค้ดต่อไปนี้

$this->load->helper('smiley');

คำอธิบายอย่างสั้น

ผู้ช่วยสัญลักษณ์ยิ้มจะแปลจากข้อความธรรมดาเช่น :-) และเปลี่ยนไปเป็นรูปแทนอย่างนี้ smile!

มันยังช่วยคุณแสดงผลลัพธ์เป็นรูปสัญลักษณ์ยิ้มเมื่อคุณคลิกใส่ไปในแบบฟอร์ม ตัวอย่างเช่น ถ้าคุณมีบล็อคที่ยอมให้ผู้ใช้งานแสดงความคิดเห็น คุณสามารถโชว์สัญลักษณ์ยิ้ม ถัดไปจากแบบฟอร์มแสดงความคิดเห็นได้ เมื่อผู้ใช้งานสามารถคลิกที่หน้ายิ้มเหล่านั้นได้ และด้วยความช่วยเหลือของ JavaScript มันจะถูกใส่เข้าไปในแบบฟอร์มได้เลย

สอนการทำสัญลักษณ์ยิ้มคลิกได้

นี้คือตัวอย่างพิสูจน์ว่าคุณสามารถสร้างสัญลักษณ์ยิ้มคลิกได้ที่อยู่ถัดจากแบบฟอร์ม ตัวอย่างนี้ต้องการให้คุณดาวน์โหลดและติดตั้งรูปสัญลักษณ์ยิ้มก่อนที่จะสร้างตัวควบคุม(Controller) และส่วนแสดง(View) ตามที่อธิบาย

สิ่งสำคัญ: ก่อนที่คุณจะเริ่ม, กรุณาดาวน์โหลดรูปสัญลักษณ์ยิ้มและใส่มันไว้ในส่วนที่สามารถเข้าถึงได้จากสาธารณะบนเซิร์ฟเวอร์ของคุณ ตัวช่วยนี้จะสมมุติว่าคุณมีตัวแทนสัญลักษณ์ยิ้มอยู่ตามตำแหน่งที่เขียนไว้ใน application/config/smileys.php

ตัวควบคุม

ในโฟลเดอร์ application/controllers/ ให้สร้างไฟล์ที่ชื่อว่า smileys.php และใส่โค้ดด้านล่างลงไปในไฟล์

สิ่งสำคัญ: เปลี่ยน URL ฟังก์ชัน get_clickable_smileys() ที่อยู่ด้านล่างให้ชี้ไปยังโฟลเดอร์ที่เก็บสัญลักษณ์ยิ้มของคุณ

คุณจะสังเกตุได้ว่านอกจาเราจะใช้ผู้ช่วยสัญลักษณ์ยิ้มแ้ล้วเรายังใช้ Table Class.

ในโฟลเดอร์ application/views/ ให้สร้างไฟล์ที่เรียกว่า smiley_view.php และใส่โค้ดลงไปดังนี้

เมื่อคุณสร้างตัวควบคุมและส่วนแสดงเสร็จแล้ว ให้โหลดดูมันได้โดยเข้า http://www.your=site.com/index.php/smileys/

ปล. อย่าลืมเปลี่ยน www.your=site.com เป็นชื่อเว็บไซต์ของคุณเช่น localhost

นามแฝงของฟิลด์

เมื่อเกิดการเปลี่ยนแปลงกับหน้าแสดงผล มันสามารถเกิดความไม่สะดวกที่จะมีฟิลด์ ID ในตัวควบคุม เพื่อที่จะจัดการเรื่องนี้ คุณสามารถให้ชื่อลิงค์หน้ายิ้มของคุณเป็นชื่อที่จะถูกผูกเข้ากับ ID ในหน้าแสดงผลของคุณ

$image_array = get_smiley_links("http://example.com/images/smileys/", "comment_textarea_alias");

ในการจับคู่ระหว่างนามแฝงของฟิลด์ ID นั้ให้ใส่ชื่อนั้นลงไปในฟังก์ชัน the smiley_js

$image_array = smiley_js("comment_textarea_alias", "comments");

เอกสารอ้างอิงฟังก์ชัน

get_clickable_smileys()

คืนค่าเป็นอาเรย์ที่ใส่รูปสัญลักษณ์ที่ถูกคลุมไว้ลิงค์ที่สามารถคลิกได้ โดยคุณต้องใส่ URL โฟลเดอร์สัญลักษณ์ยิ้มของคุณในพารามิเตอร์แรกและใส่ชื่อฟิลด์ ID หรือนามแฝงของฟิลด์ในพารามิเตอร์ที่สอง

$image_array = get_clickable_smileys("http://example.com/images/smileys/","comment");

ข้อสังเกตุ: การใช้ฟังก์ชันนี้โดยไม่ใช้พารามิเตอร์ที่สองที่ใช้รวมกับ js_insert_smiley นั้นถูกยกเลิกใช้แล้ว

smiley_js()

สร้างจาวาสคริป ที่มีรูปภาพต่างๆที่สามารถถูกคลิกได้และจะถูกใส่เข้าไปในฟิลด์ ถ้าคุณใส่นามแฝงแทน ID เมื่อถูกสร้างขึ้นลิงค์ของรูปภาพหน้ายิ้มของคุณต้องใส่ทางผ่านเข้าไปยังนามแฝงนั้นด้วยให้ถูกต้อง โดยฟังก์ชันนี้ถูกออกแบบให้เอาไว้ในส่วนของ <head> ของหน้าเว็บ

<?php echo smiley_js(); ?>

ข้อสังเกตุ: ฟังก์ชันนี้มาแทนที่ js_insert_smiley ซึ่งถูกยกเลิกไปแล้ว

parse_smileys()

ใส่ข้อความสตริงเป็นข้อมูลเข้าและมันจะแทนที่ข้อความธรรมดาที่มีค่าเท่ากับรูปลัญลักษณ์ โดยพารามิเตอร์ตัวแรกจะต้องใส่สตริง ส่วนตัวที่สองจะต้องใส่ URL โฟลเดอร์สัญลักษณ์ยิ้ม

$str = 'Here are some simileys: :-) ;-)'; $str = parse_smileys($str, "http://example.com/images/smileys/"); echo $str;