مقدمه
با عرض سلام و وقت به خیر خدمت کاربران سایت پی وی لرن به ویژه کاربرانی که به سیستم مدیریت محتوای قدرتمند وردپرس علاقمند هستند.
به ” دوره متخصص وردپرس ” خوش آمدید!
در این دوره قرار است توسعه و ارتقاء پلاگین های وردپرس را به صورت جامع و کامل بیاموزیم.
فرقی نمی کند که در شرف نوشتن اولین پلاگین خود هستید و یا این که پنجاهمین پلاگین خود را می نویسید! امیدوارم این دوره برایتان مفید باشد.
در جلسه قبلی با روش های که می توان به یاری آن ها کدهای پلاگین تان را سازماندهی کرد و به آن ها نظم بخشید؛ آشنا شدیم.
در ادامه این دوره و در این جلسه به تعیین دایرکتوری پلاگین و محتوا می پردازیم.
تعیین دایرکتوری پلاگین و محتوا
هنگام کدگذاری پلاگین های وردپرس، اغلب باید فایل ها و پوشه های مختلف را در طول نصب وردپرس و درون پلاگین یا تم خود ارجاع دهید.
این کار یعنی ارجاع به منبع یک پلاگین ” تعیین دایرکتوری پلاگین و محتوا ” نامیده می شود.
وردپرس دارای چندین تابع مختلف است که ارجاع یک پلاگین به یک فایل یا دایرکتوری را بسیار ساده می کند.
سعی کنید به جای لقمه را دور سر خود چرخاندن و استفاده از روش های عجیب غریب مثل :
– ارجاع سخت افزاری یک پلاگین به پوشه wp-content
– و یا استفاده از constants های داخلی
همیشه از این توابع در پلاگین های خود استفاده کنید.
وردپرس به کاربران اجازه می دهد تا دایرکتوری wp-content خود را در هر جایی که میخواهند قرار دهند و آن را آن طور که می خواهند تغییر نام دهند.
هرگز فرض نکنید که افزونه ها در wp-content / plugins قرار می گیرند.
uploads آپلود ها در wp-content / uploads قرار می گیرد.
themes تم ها در wp-content / themes قرار می گیرند.
PHP’s __FILE__ magic-constant به صورت خودکار symlinks (لینک مرتبط) را حل می کنند.
بنابرین اگر wp-content یا wp-content/plugins و یا حتی دایرکتوری پلاگین فردی به صورت لینک مرتبط باشد، مسیرهای سخت افزاری به درستی کار نخواهند کرد.
استفاده های رایج
اگر افزونه شما شامل فایلهای جاوا اسکریپت، فایلهای CSS یا سایر فایلهای خارجی باشد، احتمالا به این فایلها نیاز دارید تا بتوانید آنها را در صفحه بارگذاری نمایید.
برای انجام این کار باید از تابع ()plugins_url مانند نمونه استفاده نمایید :
مثال :
| plugins_url( 'myscript.js', _FILE_ ); |
این آدرس کامل URL را به myscript.js ارسال می کند، مانند example.com/wp-content/plugins/myplugin/myscript.js.
برای بارگذاری پلاگین های JavaScript یا CSS خود را به صفحه ای که باید از ()wp_enqueue_script یا ()wp_enqueue_style استفاده کنید، نتیجه ()plugins_url را به عنوان URL پرونده منتقل می کند.
توابع موجود
وردپرس شامل توابع زیادی برای تعیین مسیرها و URL ها به فایل ها و یا دایرکتوری ها در پلاگین ها، تم ها و خود وردپرس است.
برای تکمیل اطلاعات مربوط به استفاده از آنها، صفحات فردی Codex را برای هر عملکرد مشاهده کنید.
Plugins
مثال :
| plugins_url() plugin_dir_url() plugin_dir_path() plugin_basename() |
Themes
مثال :
| get_template_directory_uri() get_stylesheet_directory_uri() get_stylesheet_uri() get_theme_root_uri() get_theme_root() get_theme_roots() get_stylesheet_directory() get_template_directory() |
Site Home
مثال :
| home_url() get_home_path() |
WordPress
مثال :
| admin_url() site_url() content_url() includes_url() wp_upload_dir() |
Multisite
مثال :
| get_admin_url() get_home_url() get_site_url() network_admin_url() network_site_url() network_home_url() |
Constants
وردپرس هنگام تعیین مسیر به محتویات و دایرکتوری های افزونه، از constants های زیر استفاده می کند.
constants نباید به طور مستقیم توسط پلاگین ها یا تم ها مورد استفاده قرار گیرند.
به لیست زیر توجه نمایید:
| دایرکتوری های وردپرس |
|---|
| ()home_url | Home URL یور آر ال اصلی | http://www.example.com |
| ()site_url | Site directory URL یور آر ال دایرکتوری سایت | http://www.example.com یا http://www.example.com/wordpress |
| ()admin_url | Admin directory URL یور آر ال دایرکتوری ادمین | http://www.example.com/wp-admin |
| ()includes_url | Includes directory URL یور آر ال دایرکتوری Includes | http://www.example.com/wp-includes |
| ()content_url | Content directory URL یو آر ال دایرکتوری محتوا | http://www.example.com/wp-content |
| ()plugins_url | Plugins directory URL یور آر ال دایرکتوری پلاگین ها | http://www.example.com/wp-content/plugins |
| ()wp_upload_dir | (Upload directory URL (returns an array
آپلود یور آر ال دایرکتوری (بازگردانی یک آرایه) | http://www.example.com/wp-content/uploads |
کلام آخر
در این جلسه آموختیم که چگونه می توان پلاگین یا افزونه وردپرس خود را به مرجع و دایرکتوری آن ارجاع داد.
در جلسه بعدی شما را بیشتر با مبحث امنیت پلاگین وردپرس می پردازیم.
با پی وی لرن همراه باشید.
فروشگاه
فیلم های آموزشی
کتاب های آموزشی
مقالات آموزشی
وردپرس
