مقدمه
با عرض سلام و وقت به خیر خدمت کاربران سایت پی وی لرن به ویژه کاربرانی که به سیستم مدیریت محتوای قدرتمند وردپرس علاقمند هستند.
به ” دوره متخصص وردپرس ” خوش آمدید!
در این دوره قرار است توسعه و ارتقاء پلاگین های وردپرس را به صورت جامع و کامل بیاموزیم.
فرقی نمی کند که در شرف نوشتن اولین پلاگین خود هستید و یا این که پنجاهمین پلاگین خود را می نویسید! امیدوارم این دوره برایتان مفید باشد.
در این جلسه با آموزش نحوه ثبت انواع پست های سفارشی در ساخت پلاگین رسماً سر فصل کار با انواع پست های سفارشی را آغاز می نماییم.
نحوه ثبت انواع پست های سفارشی در ساخت پلاگین
وردپرس دارای پنج نوع پست پیش فرض است :
هنگام توسعه پلاگین خود،ممکن است نیاز داشته باشید که نوع محتوای خاص خود را ایجاد نمایید.
برای مثال :
- محصولات یک فروشگاه اینترنتی
- تکالیف یک وب سایت آموزشی
- فیلم هایی برای یک وبسایت نقد و بررسی فیلم
- و …
با استفاده از Custom Post Types یا انواع پست سفارشی می توانید به ثبت نوع پست دلخواه خود بپردازید.
پس از ثبت نوع پست مورد نظر خود، صفحه جدیدی جهت مدیریت و ساخت پست متناسب با نوعی که انتخاب کرده اید ردیافت خواهید کرد.
برای ثبت یک نوع پست جدید ، از تابع ()Register_post_type استفاده کنید.
توصیه می کنیم به جای یک موضوع ، انواع پست های سفارشی را در پلاگین خود قرار دهید.
این کار تضمین می کند که محتوای کاربر حتی اگر تم خود را تغییر دهد قابل انتقال است.
مثال زیر یک نوع پست جدید ، Products را ثبت می کند ، که در پایگاه داده به عنوان wporg_product مشخص می شود.
مثال :
| function wporg_custom_post_type() { register_post_type('wporg_product', array( 'labels' => array( 'name' => __('Products'), 'singular_name' => __('Product'), ), 'public' => true, 'has_archive' => true, ) ); } add_action('init', 'wporg_custom_post_type'); |
هشدار
قبل از admin_init و بعد از هوک اکشن after_setup_theme بایست تابع ()register_post_type را فراخوانی نمایید.
یک هوک خوب که در این مورد می توانید از آن استفاده نمایید؛ هوک init action است.
نامگذاری بهترین روش ها
این موضوع خیلی مهم است که توابع نوع پست و تعریف کننده identifiers های خود را با یک پیشوند کوتاه که با پلاگین، موضوع یا وب سایت شما مطابقت دارد پیشوند کنید.
هشدار
برای اطمینان از سازگاری، از wp_ به عنوان تعریف کننده خود استفاده نکنید – زیرا این مورد توسط هسته وردپرس استفاده می شود.
اطمینان حاصل کنید که تعریف کننده نوع پست سفارشی شما از ۲۰ کاراکتر تجاوز نکند زیرا ستون post_type در دیتابیس در حال حاضر یک فیلد VARCHAR به طول آن است.
اگر تعریف کننده شما خیلی عمومی باشد – برای مثال: product. ممکن است با سایر پلاگین ها یا تم ها در تضاد باشد و یا دچار اختلات نام شود.
” نحوه ثبت انواع پست های سفارشی در ساخت پلاگین ” را با مبحث URL ها ادامه می دهیم.
URLs یور آر ال ها
یک نوع پست سفارشی در ساختار URL سایت، جای مختص به خود را دارد.
یک پست از نوع wporg_product از ساختار URL زیر استفاده می کند: %http://example.com/wporg_product/٪product_name
wporg_product تکه های شلخته ای از نوع پست سفارشی شما است و٪ product_name٪ نیز تکه های به هم ریخته ای از محصول خاص شما.
در این صورت پیوند یکتا نهایی شما در صفحه ویرایش شده ی نوع پست سفارشی تان، درست شبیه نوع پست های پیش فرض خواهد بود.
یک تکه سفارشی برای یک پست سفارشی
برای تنظیم یک تکه سفارشی برای تکه ای از نوع پست سفارشی تان، تمام چیزی که احتیاج دارید این است که یک کلید <= جفت مقدار یا value pair به کلید بازنویسی در آرگومان های ()Register_post_type اضافه کنید.
مثال
مثال :
| function wporg_custom_post_type() { register_post_type('wporg_product', array( 'labels' => array( 'name' => __('Products'), 'singular_name' => __('Product'), ), 'public' => true, 'has_archive' => true, 'rewrite' => array( 'slug' => 'products' ), // my custom slug ) ); } add_action('init', 'wporg_custom_post_type'); |
موارد فوق به ساختار URL زیر منجر می شود: %http://example.com/products/٪product_name
هشدار
استفاده از یک تکه بسیار عمومی مثل محصولات products می تواند تضاد و اختلات با سایر نام های پلاگین یا تم را ایجاد نماید.
هشدار
بر خلاف تعریف کننده های نوع پست سفارشی ، با تغییر تکه ها برای یکی از انواع پست متعارض ، می توان مشکل تکه تکراری را به راحتی حل کرد.
اگر نویسنده افزونه به اندازه کافی هوشمند باشد؛ یک ()apply_filters را برای فراخوانی آرگومان ها استفاده می نماید.
این کار را می توان با نادیده گرفتن آرگومان های ارسال شده از طریق تابع ()Register_post_type به صورت برنامه ای انجام داد.
حل مشکل تعریف کننده های پست های تکراری یا duplicate post type identifiers بدون غیرفعال کردن یکی از انواع پست متضاد امکان پذیر نیست.
کلام آخر
در این جلسه با نحوه ثبت انواع پست های سفارشی در ساخت پلاگین آشنا شدیم.
در جلسه بعدی به آموزش کار با انواع پست های سفارشی می پردازیم.
با پی وی لرن همراه باشید.
فروشگاه
فیلم های آموزشی
کتاب های آموزشی
مقالات آموزشی
وردپرس
