پلاگینها یا افزودنیهای سیستم مدیریت محتوا الوند، بستههای توسعهپذیری هستند که امکان افزودن قابلیتهای جدید به هسته اصلی را فراهم میکنند. هر پلاگین در مسیر /plugins قرار گرفته و از ساختار مشخصی پیروی میکند.
> سیستم هوک : الوند از یک سیستم هوک قدرتمند شامل اکشن و فیلتر استفاده میکند. برای مطالعه کامل به صفحه سیستم هوک مراجعه کنید.
ساختار یک پلاگین
هر پلاگین الوند شامل فایلهای زیر است:
- config.php: فایل اصلی معرفی پلاگین شامل اطلاعات، وابستگیها، autoload، منوها و صفحات بارگذاری
- فایل اصلی پلاگین: کلاس اصلی پلاگین با متدهای نصب، حذف و مدیریت
- helpers.php: توابع کمکی (اختیاری)
- setting.php: صفحه تنظیمات پلاگین
ساختار config.php
return [
'info' => [
'name' => 'نام پلاگین',
'version' => '1.0.0',
'author' => 'نام نویسنده',
'description' => 'توضیحات پلاگین'
],
'dependencies' => [
'php' => '>=8.0',
'extensions' => ['json', 'curl'],
],
'autoload' => ['classes/', 'helpers.php'],
'menu' => [
'slug' => 'plugin-slug',
'title' => 'عنوان منو',
'parent' => null,
'icon' => ''
],
'load_on_pages' => ['*']
];
گزینههای config.php
| کلید | توضیح |
|---|---|
info | اطلاعات پلاگین (نام، نسخه، نویسنده) |
dependencies | وابستگیها (PHP, extensions) |
autoload | فایلهای بارگذاری خودکار |
menu | تعریف منو در پنل مدیریت |
header | فایلهای CSS |
footer | فایلهای JS (عمومی) |
adminFooter | فایلهای JS (مدیریت) |
load_on_pages | صفحاتی که پلاگین در آن بارگذاری شود |
exclude_on_pages | صفحات مستثنی شده |
routes | مسیرهای API |
settings | تنظیمات پیشفرض |
> سیستم هوک : الوند از یک سیستم هوک قدرتمند با دو نوع اکشن و فیلتر استفاده میکند. برای مطالعه کامل به صفحه سیستم هوک مراجعه کنید.
API پلاگینها
| مسیر | توضیح |
|---|---|
/api/plugins/activate | فعالسازی |
/api/plugins/deactivate | غیرفعالسازی |
/api/plugins/install | نصب |
/api/plugins/uninstall | حذف |
/api/plugins/update | بروزرسانی |
/api/plugins/upload-zip | آپلود فایل |
/api/plugins/bulk | عملیات گروهی |