مقدمه
با عرض سلام و وقت به خیر خدمت کاربران سایت پی وی لرن به ویژه کاربرانی که به سیستم مدیریت محتوای قدرتمند وردپرس علاقمند هستند.
به ” دوره متخصص وردپرس ” خوش آمدید!
در این دوره قرار است توسعه و ارتقاء پلاگین های وردپرس را به صورت جامع و کامل بیاموزیم.
فرقی نمی کند که در شرف نوشتن اولین پلاگین خود هستید و یا این که پنجاهمین پلاگین خود را می نویسید! امیدوارم این دوره برایتان مفید باشد.
در جلسه گذشته آموختیم که چگونه می توان از هوک های فیلتر در ساخت پلاگین استفاده نمود.
در ادامه اسن فصل، به استفاده از هوک های سفارشی در ساخت پلاگین می پردازیم.
استفاده از هوک های سفارشی در ساخت پلاگین
یک تمرین مهم که اغلب نادیده گرفته می شود، استفاده از هوک های سفارشی در ساخت پلاگین است.
این هوک ها می توانند توسط سایر توسعه دهندگان توسعه و اصلاح شوند.
هوک های سفارشی همان طور که هوک های هسته وردپرس ساخته و فراخوانی می شوند، ایجاد و فراخوانی می شوند.
ساخت یک هوک سفارشی
برای ساخت یک هوک سفارشی از تابع ()do_action برای Actions و ()apply_filters برای فیلترها استفاده کنید.
توصیه می کنیم از ()apply_filters بر روی هر متنی که به مرورگر نمایش داده می شود استفاده نمایید.
این کار باعث می شود که پلاگین ها با توجه به نیازهای کاربر تغییر کند.
ایجاد یک فراخوانی Callback به هوک
برای افزودن یک تابع فراخوانی به یک هوک سفارشی، از ()add_action برای Actions و ()add_filter برای فیلترها استفاده کنید.
تصادم نام ها
از آنجا که هر پلاگین میتواند یک هوک سفارشی ایجاد کند، برای جلوگیری از تصادم و اختلات نام ها بهتر است آن ها را با پیشوند مشخص پیشوند مشخص نمایید.
برای مثال استفاده از email_body درست نیست؛ زیرا احتمال استفادهاز آن توسط توسعه دهنده دیگری زیاد است.
در صورت استفاده از این نام، برای دو پلاگین مجزا، ممکن است با مشکلات متعددی رو به رو می شوید.
اما نامگذاری تابع wporg_email_body (جایی که wporg_ یک پیشوند منحصر به فرد برای پلاگین شما است) از این اختلات نام گذاری اجتناب می کند.
مثال ها
تنظیمات فرم
اگر پلاگین شما یک فرم تنظیمات به پنل Administrative اضافه می کندف می توانید از هوک اکشن استفاده کرده و به سایر پلاگین ها اجازخ دهید کع تنظیمات خود را اضافه نمایند.
مثال :
| <?php function wporg_settings_page_html() { ?> Foo: <input id="foo" name="foo" type="text"> Bar: <input id="bar" name="bar" type="text"> <?php do_action('wporg_after_settings_page_html'); } |
اکنون پلاگین دیگری نیز می تواند یک تابع فراخوانی برای هوک wporg_after_settings_page_html ثبت کند و تنظیمات جدید را تزریق نماید :
مثال :
| <?php function myprefix_add_settings() { ?> New 1: <input id="new_setting" name="new_settings" type="text"> <?php } add_action('wporg_after_settings_page_html', 'myprefix_add_settings'); |
فیلترهای انطباق پذیر
در این مثال، هنگامی که post type جدید ثبت می شود، پارامترهایی که آن را تعریف می کنند، از طریق یک فیلتر عبور می کنند، بنابراین پلاگین دیگری می تواند قبل از ایجاد post type آن را تغییر دهد.
مثال :
| <?php function wporg_create_post_type() { $post_type_params = [/* ... */]; register_post_type( 'post_type_slug', apply_filters('wporg_post_type_params', $post_type_params) ); } |
حالا یک پلاگین دیگر می تواند یک تابع فراخوانی برای هوک wporg_post_type_params ثبت کند و پارامترهای نpost type را تغییر دهد:
مثال :
| <?php function myprefix_change_post_type_params($post_type_params) { $post_type_params['hierarchical'] = true; return $post_type_params; } add_filter('wporg_post_type_params', 'myprefix_change_post_type_params'); |
کلام آخر
در این جلسه استفاده از هوک های سفارشی در ساخت پلاگین را فرا گرفتیم.
در جلسه بعدی به آشنایی با مباحث پیشرفته هوک ها می پردازیم و به این ترتیب به این سر فصل نیز پایان می دهیم.
با پی وی لرن همرا باشید.
فروشگاه
فیلم های آموزشی
کتاب های آموزشی
مقالات آموزشی
وردپرس
