WordPress development - Plugin development
شما می‌توانید مستندات وردپرس را از اینجا مشاهده کنید
چگونه یک افزونه وردپرس ایجاد کنیم؟
برای ایجاد یک افزونه جدید در وردپرس شما حداقل به یک پوشه و یک فایل PHP نیاز دارید تا وردپرس افزونه شما را تشخیص و آن را اجرا کند. در اولین قدم یک پوشه با نام دلخواه خود ایجاد کنید:
my-plugin-nameسپس یک فایل PHP با نام دلخواه ایجاد کنید. این فایل هویت و عملکرد افزونه شما را مشخص می‌کند. برای مثال:
index.phpهم اکنون متن زیر را کپی کنید و بسته به نیاز خود آن را ویرایش کنید:
/**
* Plugin Name: Your plugin name
* Description: Some more information
* Version: 1.0.0
* Plugin URI: https://your-site.com
* Author: You
* Author URI: https://your-site.com/authors/you
* Text Domain: my-plugin
* Domain Path: /languages/
*/Plugin name, Description و Version
این اطلاعات پایه افزونه شما است، نام و توضیحات افزونه و اطلاعاتی که در پیشخوان وردپرس قابل مشاهده هستند.
Plugin URI
این آدرس افزونه شما در سایت شما است که کاربران با باز کردن آن وارد صفحه معرفی افزونه خواهند شد.
Author و Author URI
در اینجا می‌توانید برای خود اعتبار کسب کنید. معمولا در اینجا نام توسعه دهنده افزونه و یا سازمانی که صاحب اعتبار افزونه است نوشته می‌شود. آدرس نویسنده نیز میٰ‌تواند صفحه شخصی نویسنده و یا مربوط به سازمان مشخص شده باشد.
Text domain و Domain path
وردپرس یک CMS چند زبانه است که به شما این امکان را میٰ‌دهد که وبسایت های خود را به چندین زبان مسلط کنید. به بیان ساده text domain ها دیکشنری هایی هستند و کلمات می‌توانند در دیکشنری های مختلف به صورت های مختلف نوشته شوند. انتخاب نام برای text domain به شما بستگی دارد. همچنین مسیر دامنه (domain path) مکانی است که فایل های ترجمه شما در آن قرار می‌گیرند. در این مثال پوشه languages در مسیر پوشه های افزونه شما استفاده خواهد شد.
درصورتی که از ابزار های ترجمه استفاده می‌کنید نیازی به ایجاد پوشه languages نیست و به صورت خودکار ایجاد خواهد شد. در ادامه راجب آن توضیح داده خواهد شد.
چگونه افزونه خود را در وردپرس ترجمه کنیم؟
بعد از اینکه افزونه خود را ساختید، آن را در قسمت افزونه ها در پیشخوان وردپرس سایت خود بارگزاری و آن را فعال کنید.
هم اکنون به یک ابزار برای ترجمه افزونه خود نیاز دارید. پیشنهاد ما استفاده از افزونه Loco translate است که پس از نصب و فعالسازی آن از مخزن وردپرس می‌توانید از پیشخوان وردپرس با وارد شدن به منو «ترجمه لوکو» افزونه ها و قالب های خود را ترجمه کنید.
هم اکنون تمامی افزونه های موجود از جمله افزونه خود را مشاهده خواهید کرد. افزونه خود را انتخاب و مراحل زیر را دنبال کنید:
هم اکنون زبان مورد نیاز خود را انتخاب کنید و مسیر آن را انتخاب کنید. درصورتی که راجب آنها اطلاعات کافی ندارید مثل تصویر زیر انجام دهید:
مسیر ترجمه، مسیر اصلی فایل های ترجمه هستند که در فایل های افزونه قرار دارند.
سفارشی: این مسیر برای افزونه Loco translate است و تنها زمانی که این افزونه فعال باشد قابل استفاده هستند، همچنین ترجمه ها تنها در همان سایت قابل استفاده خواهند بود.
سیستم: این مسیر پیشفرض وردپرس است. با انتخاب این گزینه فایل های ترجمه حتی پس از حذف افزونه باقی خواهند ماند، اما درصورتی که افزونه را در سایت دیگری نصب کنید نیاز است فایل های ترجمه را به همراه آن کپی کنید.
Author: این مسیر افزونه شما است، پیشنهاد می‌کنیم که این گزینه را انتخاب کنید چرا که فایل های ترجمه در افزونه ذخیره خواهند شد و با انتقال افزونه فایل های ترجمه نیز منتقل خواهند شد.
هم اکنون می‌توانید متن های افزونه خود را ترجمه کنید. در آخر با اضافه کردن چندین خط به فایل اصلی افزونه (در این مثال: index.php) می‌توانید فایل های ترجمه را بارگزاری کنید تا زبان های ترجمه شده قابل استفاده شوند.
function my_plugin_translate(){
load_plugin_textdomain( 'my-plugin', false, basename( __DIR__ ) . '/languages/' );
}
add_action( 'after_setup_theme', 'my_plugin_translate' );افزونه شما باید شبیه به این باشد:
/**
* Plugin Name: Your plugin name
* Description: Some more information
* Version: 1.0.0
* Plugin URI: https://your-site.com
* Author: You
* Author URI: https://your-site.com/authors/you
* Text Domain: my-plugin
* Domain Path: /languages/
*/
function my_plugin_translate(){
load_plugin_textdomain( 'my-plugin', false, basename( __DIR__ ) . '/languages/' );
}
add_action( 'after_setup_theme', 'my_plugin_translate' );همچنین فایل های افزونه شما باید شبیه به این باشد:
📁 my-plugin
🗎 index.php
📁 languages
🗎 my-plugin-fa_IR.mo
🗎 my-plugin-fa_IR.poبا انجام این مراحل شما افزونه خود را ایجاد کردید! به وسیله این افزونه می‌توانید امکانات مورد نیاز خود را به سایت خود اضافه کنید. برای اطلاعات بیشتر ادامه مستندات را مطالعه کنید.