- چهارشنبه 29 مهر 1405 ساعت 16:00
- 3.1.9
- کامل شده
- منقضی شده
Smiley Helper برای تبدیل کدهای متنی شکلک به تصویر و ساخت رابط انتخاب شکلک در پروژه‌های قدیمی طراحی شده است. این قابلیت بیشتر در انجمن‌ها و سیستم‌های پیام‌رسان قدیمی کاربرد داشت و در رابط‌های جدید معمولاً از Emoji یا کتابخانه‌های Frontend استفاده می‌شود.
کاربرد و توابع اصلی
get_clickable_smileys() فهرست شکلک‌های قابل کلیک را می‌سازد، parse_smileys() کدهای متنی را به تصویر تبدیل می‌کند و smiley_js() اسکریپت لازم را تولید می‌کند. مسیر تصاویر و فایل JavaScript باید با قالب پروژه هماهنگ باشد.
نمونه استفاده
$this->load->helper('smiley');
$image_array = get_clickable_smileys(base_url('assets/smileys/'));
$message = parse_smileys($message);نکته مهم
ورودی را اعتبارسنجی کنید و خروجی را متناسب با محل نمایش Escape کنید. این Helper جایگزین کنترل دسترسی و سیاست امنیتی برنامه نیست.
مطالعه مرتبط
برای ادامه مطالعه، کوئری، SQL Injection را ببینید.
توابع Smiley Helper
| متد یا مفهوم | کاربرد |
|---|---|
get_clickable_smileys() | ساخت رابط انتخاب شکلک. |
parse_smileys() | تبدیل کد متنی به تصویر. |
smiley_js() | تولید JavaScript موردنیاز. |
smiley_table() | ساخت جدول انتخاب شکلک. |
smileys | نگاشت کدهای متنی به فایل تصویر. |
نکات استفاده در پروژه
Helperها معمولاً وضعیت داخلی نگه نمی‌دارند و برای تبدیل یا تولید مقدارهای کوچک مناسب‌اند. آن‌ها را فقط در Controller یا فایل‌های View بارگذاری نکنید، اگر در چند بخش برنامه استفاده می‌شوند می‌توانید در تنظیمات Autoload قرار دهید. در عین حال، بارگذاری همه Helperها به‌صورت سراسری ضرورتی ندارد و بهتر است وابستگی هر بخش روشن بماند.
در زمان استفاده، ورودی را از نظر نوع و محدوده بررسی کنید، خروجی HTML را متناسب با محل نمایش Escape کنید و مسیر فایل را از داده خام کاربر نسازید. اگر تابعی به دیتابیس، شبکه یا وضعیت Session وابسته است، آن رفتار دیگر یک Helper ساده نیست و بهتر است در Service یا Library مستقل قرار بگیرد.
در بازبینی کد، ترتیب و نتیجه متدهای get_clickable_smileys()، parse_smileys()، smiley_js()، smiley_table() را بررسی کنید. نام متد به‌تنهایی تضمین نمی‌کند ورودی معتبر یا خروجی امن باشد، بنابراین رفتار هر متد را با تست و مستندات همان نسخه کنترل کنید.