قسمت ۴ – آموزش پلاگین نویسی در وردپرس – پلاگین خالی

در این بخش یک پلاگین خالی طراحی و برای دانلود قرار داده ام و سعی کردم قسمت هایی که برای آن طراحی کردم را توضیح دهم. منظور از پلاگین خالی این است که این پلاگین تمام پوشه ها و بخش های مورد نیاز پلاگین نویسی را دارد ولی خالی است. از این پلاگین برای توسعه سریع تر کار خود میتوانیم بهره ببریم. در ادامه با ما همراه باشید ….

تعریف ثابت ها

ورژن پلاگین : توسط این ثابت ورژن پلاگین را در فایل php اصلی پلاگین مشخص میکنیم.

define('tehranit_ver','1.0.0');

نام پلاگین : توسط این ثابت نام پلاگین را در فایل php اصلی پلاگین مشخص میکنیم.

define('tehranit_name','tehranit');

تعریف کلاس پایه BASE

برای این که فایل php اصلی پلاگین ما شلوغ نشود، کلاسی به اسم TehranIt_PluginName_ClassBase تعریف میکنیم و کد های اصلی خود را در آن قرار میدهیم.

نحوه تعریف و فراخوانی کلاس

توجه کنید که ما متغییری به صورت گلوبال تعریف کردیم و کلاس خود را داخل آن ریختیم تا بتوانیم در همه جا به آن دسترسی داشته باشیم.

پوشه ای به نام class میسازیم و داخل آن فایل TehranIt_PluginName_ClassBase.php را ایجاد میکنیم. داخل این فایل کلاس TehranIt_PluginName_ClassBase خود را ایجاد میکنیم.

ایجاد کلاس

class TehranIt_PluginName_ClassBase{
    // code
}

فراخوانی کلاس

require_once('class/TehranIt_PluginName_ClassBase.php');
global $ClassBase;
$ClassBase = new TehranIt_PluginName_ClassBase();

کلاس construct

یک مکان مناسب جهت نوشتن هوک ها. البته توجه داشته باشید که فقط هوک ها را در این فانکشن مینویسیم و فانکشن های مورد نیاز هوک ها را حارج از این کلاس و در ادامه آن مینویسیم.

public function __construct()
{
    //HOOKS
}

کلاس آدرس

از این کلاس برای بدست آوردن آدرس های مد نظر خود استفاده مکنیم. تابع plugins_url() آدرسی تا پوشه پلاگین های وردپرس را بر میگرداند، کافی است تا با نام پوشه پلاگین و بخشی که میخواهیم به آن آدرس دهی کنیم آدرس خود را بدست بیاوریم.

این فانکشن ورودی تحت عوان url میگیرد که از طریق آن میتوانیم پوشه یا فایل مورد نظر خود را مشخص کنیم.

public function TehranIt_PluginName_plugin_url($url){
    return plugins_url( 'TehranIt_PluginName/'.$url );
}

برای فراخوانی آن در فایل اصلی پلاگین میتوانیم از روش زیر استفاده کنیم.

require_once('class/TehranIt_PluginName_ClassBase.php');
global $ClassBase;
$ClassBase = new TehranIt_PluginName_ClassBase();
$MyAdress=$ClassBase->TehranIt_PluginName_plugin_url('img');
var_dump($MyAdress);

ثبت textdomain – فایل ترجمه

برای ثبت text domain خود باید از اکشن plugins_loaded استفاده کنیم این اکشن خیلی سریع بوده و حتی قبل از اکشن setup_theme اجرا میشود. در مستندات وردپرس گفته شده که این هوک برای راه اندازی فوری فیلتر یا لغو افزونه ها استفاده می شود. text domain خود را با استفاده از تابع load_plugin_textdomain ثبت میکنیم که ۳ ورودی میگیرد اولی نام پلاگین میباشد دومی آدرس تقریبی است و سومی آدرس پوشه ترجمه ها.

add_action( 'plugins_loaded', array($this,'TehranIt_PluginName_load_textdomin'));
function TehranIt_PluginName_load_textdomin(){
    load_plugin_textdomain( tehranit_name, false, 'TehranIt_PluginName/languages' );
}

تعریف فایل های FONT، CSS و JS فرانت و بک اند

در این بخش قصد دارم تا فایل های CSS و JS مورد نیاز در فرانت و بک اند را اضافه کنیم این کار توسط ۲ هوک انجام میشود که هوک اول CSS و JS را به بک اند یا همان ادمین اضافه میکند و دومی مخصوص فرانت یا همان قالب ما است.

پوشه ای تحت عنوان assets ایجاد میکنیم تا تمام فونت ها، تصاویر و فایل های CSS JS خود را داخل آن قرار دهیم