پرش به مطلب اصلی

مستندات توسعه‌دهنده

این راهنما تمام آنچه را که توسعه‌دهندگان برای ادغام، گسترش یا توسعه افزونه‌های جانبی (addon) برای Ultimate Multisite نیاز دارند، فراهم می‌کند. Ultimate Multisite یک شبکه WordPress Multisite را به یک پلتفرم وب‌سایت به عنوان سرویس (WaaS) تبدیل می‌کند.

چه مواردی در دسترس است​

  • REST API — عملیات کامل CRUD برای تمام موجودیت‌ها (مشتریان، سایت‌ها، عضویت‌ها، پرداخت‌ها، محصولات، دامنه‌ها) با احراز هویت کلید API
  • Hooks Reference — بیش از ۲۰۰ هوک اکشن (action hook) و بیش از ۲۸۰ هوک فیلتر (filter hook) برای رویدادهای چرخه عمر و سفارشی‌سازی
  • Integration Guide — مثال‌هایی برای ادغام با CRM، آنالیتیکس، درگاه‌های سفارشی و وب‌هوک‌ها
  • Code Examples — الگوهای پیشرفته برای قیمت‌گذاری پویا، تأمین منابع سایت، محدودیت‌های سفارشی و پردازش چند درگاه
  • Addon Development — چارچوب ساختاریافته برای ساخت افزونه‌های جانبی

پیش‌نیازها​

  • نصب WordPress Multisite
  • PHP 7.4 یا بالاتر
  • فعال بودن افزونه Ultimate Multisite

نصب با Composer / Bedrock​

Ultimate Multisite در Packagist با نام ultimate-multisite/ultimate-multisite در دسترس است. این روش نصب، روش توصیه‌شده برای محیط‌های WordPress مبتنی بر Bedrock و سایر محیط‌های مدیریت شده توسط Composer است.

composer require ultimate-multisite/ultimate-multisite
Renamed package (v2.6.1+)

بسته Composer در نسخه v2.6.1 از devstone/ultimate-multisite به ultimate-multisite/ultimate-multisite تغییر نام داده است. اگر composer.json شما به نام فروشنده قدیمی اشاره می‌کند، عبارت require را به‌روزرسانی کرده و دستور composer update را اجرا کنید.

پس از نصب، افزونه را از طریق پیشخوان شبکه (Network Admin) فعال کنید:

wp plugin activate ultimate-multisite --network

یا، اگر افزونه را به عنوان یک افزونه اجباری (must-use plugin) از طریق autoloader Bedrock بارگذاری می‌کنید، از فیلتر wp_ultimo_skip_network_active_check برای دور زدن محافظ فعال‌سازی استفاده کنید:

add_filter( 'wp_ultimo_skip_network_active_check', '__return_true' );

شروع سریع​

استفاده از REST API​

curl -u "api_key:api_secret" https://yoursite.com/wp-json/wu/v2/customers

اتصال به رویدادها (Hooks)​

add_action('wu_customer_post_create', function($customer) {
    // واکنش به ثبت‌نام مشتری جدید
});

ساخت یک افزونه جانبی (Addon)​

# تولید اسکلت افزونه جانبی از قالب
bash create-addon.sh

برای مستندات و مثال‌های مفصل، هر بخش را بررسی کنید.