مقدمه
با عرض سلام و وقت به خیر خدمت کاربران سایت پی وی لرن به ویژه کاربرانی که به سیستم مدیریت محتوای قدرتمند وردپرس علاقمند هستند.
به ” دوره متخصص وردپرس ” خوش آمدید!
در این دوره قرار است توسعه و ارتقاء پلاگین های وردپرس را به صورت جامع و کامل بیاموزیم.
فرقی نمی کند که در شرف نوشتن اولین پلاگین خود هستید و یا این که پنجاهمین پلاگین خود را می نویسید! امیدوارم این دوره برایتان مفید باشد.
در جلسه پیش با اصول اولیه و نحوه استفاده از شورت کدها یا کدهای کوتاه آشنا شدیم.
در این جلسه به آموزش جایگذاری شورت کدها در پلاگین به علاقمندان این دوره می پردازیم.
آموزش جایگذاری شورت کدها در پلاگین
برای جایگذاری کدهای کوتاه می توان از دو روش زیر استفاده کرد :
- همان طور که در جلسه قبل آموختیم شورت کدها، یک تگ خود بسته self-closing هستند.
- کد کوتاه محتوا را در بر می گیرد.
محصور کردن کدهای کوتاه
محصور کردن محتوا با کد کوتاه امکان دستکاری در محتوای محصور را فراهم می کند.
مثال :
| [wporg]content to manipulate[/wporg] |
همانطور که در بالا مشاهده شد ، تنها کاری که برای محصور کردن بخشی از محتوا باید انجام دهید اضافه کردن یک شروع [tag$] و یک پایان [tag$/] مشابه HTML است.
فرآیند جایگذاری محتوا
بیایید به کد کوتاه [wporg] اصلی برگردیم :
مثال :
| <?php function wporg_shortcode($atts = [], $content = null) { // do something to $content // always return return $content; } add_shortcode('wporg', 'wporg_shortcode'); |
با نگاهی به تابع فراخوانی متوجه می شویم که دو پارامتر را انتخاب کرده ایم :
پارامتر content$ به نگهداری محتوای ما می پردازد.
بعداً به بررسی پارامتر atts$ نیز خواهیم پرداخت.
مقدار content$ که نول گردد.
می توان بین تگ خود بسته و تگ های enclosing با استفاده از تابع پی اچ پی ()function is_null تفاوت ایجاد کرد.
کد کوتاه [tag]$ ، شامل محتوای آن و انتهای [tag$/] با مقدار بازده تابع handler جایگزین می شود.
هشدار
وظیفه تابع handler این است که خروجی ها را ایمن سازد.
شورت کدهای ception
تجزیه کننده کد کوتاه یک گذر از محتوای پست را انجام می دهد.
این کار معناست که اگر پارامتر content$ یک کنترل کننده کد کوتاه حاوی کد کوتاه دیگری باشد ، تجزیه نمی شود.
استفاده از کد کوتاه در میان کدهای کوتاه دیگر با فراخوانی ()do_shortcode روی مقدار نهایی تابع handler امکان پذیر است.
محدودیت ها
تجزیه کننده شورت کدها قادر به ترکیسب دستی فرم های محصور و غیر محصور از [tag$] مشابه نیست.
مثال :
| [wporg] non-enclosed content [wporg]enclosed content[/wporg] |
به جای اینکه به عنوان دو کد کوتاه که با متن “محتوای غیر محصورانه” از هم جدا شده اند ، برخورد شود ، تجزیه کننده این رفتار را به عنوان یک کد کوتاه واحد محصور می کند که “محتوای غیر محصور [wporg] ” را محصور می کند.
کلام آخر
در این جلسه به آموزش جایگذاری شورت کدها در پلاگین پرداختیم.
جلسه بعدی می آموزیم که چگونه از ترکیب شورت کدها و پارامترها در یک پلاگین استفاده نماییم.
با پی وی لرن همراه باشید.
فروشگاه
فیلم های آموزشی
کتاب های آموزشی
مقالات آموزشی
وردپرس
