طراحی معماری قابل تنظیم با الگوی کارخانه انتزاعی در Wordpress

<?php
class SimpleSettingsPage implements SettingsPageInterface {
 public function render() {
 echo '<div class="wrap"><h1>Simple Settings</h1><form><input type="text" name="simple_option" /></form></div>';
 }
 public function save() {
 update_option( 'simple_option', sanitize_text_field( $_POST['simple_option'] ) );
 }
}
?>

صفحه تنظیمات پیشرفته (

<?php
class AdvancedSettingsPage implements SettingsPageInterface {
 public function render() {
 echo '<div class="wrap"><h1>Advanced Settings</h1><form>...complex fields...</form></div>';
 }
 public function save() {
 // complex validation and saving logic
 }
}
?>

[[ویرایش] [۱] [۱]

<?php
class SimpleDashboardWidget implements DashboardWidgetInterface {
 public function display() {
 echo '<p>Simple widget content.</p>';
 }
}
?>

[[ویرایش] [۱] [۱۰]

<?php
class AdvancedDashboardWidget implements DashboardWidgetInterface {
 public function display() {
 echo '<p>Advanced widget with charts and stats.</p>';
 }
}
?>

مرحله 4: پیاده سازی رابط کارخانه Abstract

رابط کارخانه انتزاعی را تعریف کنید که روش های ایجاد را برای هر نوع محصول اعلام می کند.

<?php
interface PluginComponentFactory {
 public function createSettingsPage(): SettingsPageInterface;
 public function createDashboardWidget(): DashboardWidgetInterface;
}
?>

مرحله پنجم: ایجاد کارخانه های بتنی

هر کارخانه رابط را پیاده سازی می کند و خانواده مناسب اشیاء را باز می گرداند.

<?php
class SimpleModeFactory implements PluginComponentFactory {
 public function createSettingsPage(): SettingsPageInterface {
 return new SimpleSettingsPage();
 }
 public function createDashboardWidget(): DashboardWidgetInterface {
 return new SimpleDashboardWidget();
 }
}

class AdvancedModeFactory implements PluginComponentFactory {
 public function createSettingsPage(): SettingsPageInterface {
 return new AdvancedSettingsPage();
 }
 public function createDashboardWidget(): DashboardWidgetInterface {
 return new AdvancedDashboardWidget();
 }
}
?>

مرحله 6: استفاده از کارخانه در پلاگین خود

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

<?php
function get_plugin_factory(): PluginComponentFactory {
 $mode = get_option( 'plugin_mode', 'simple' );
 if ( $mode === 'advanced' ) {
 return new AdvancedModeFactory();
 }
 return new SimpleModeFactory();
}

$factory = get_plugin_factory();
$settings_page = $factory->createSettingsPage();
$widget = $factory->createDashboardWidget();

// Later, use these objects:
$settings_page->render();
add_action( 'wp_dashboard_setup', function() use ( $widget ) {
 wp_add_dashboard_widget( 'my_custom_widget', 'My Widget', [ $widget, 'display' ] );
} );
?>

اکنون، تغییر بین حالت ساده و پیشرفته به سادگی تغییر کارخانه است.اگر یک حالت سوم ظاهر شود، شما یک کارخانه جدید و کلاس های محصول مربوطه ایجاد می کنید – بدون اینکه هیچ کد مشتری را که از کارخانه استفاده می کند لمس کنید.

مثال واقعی جهانی: افزونه چند منظوره

یک افزونه را در نظر بگیرید که یک فرم تماسی را ارائه می دهد، طرح فرم، اعتبار و ایمیل ممکن است بسته به اینکه آیا سایت از یک قالب کلاسیک یا یک موضوع مبتنی بر بلوک استفاده می کند، با استفاده از الگوی کارخانه انتزاعی، می توانید تعریف کنید (FLT:0FormRenderer [FLT 1] و [F:2EmailSender] [F3]، تنها به یک منطق انتزاعی و پشتیبانی از آینده بستگی دارد.

در اینجا یک طرح کد ساده شده است:

<?php
interface FormRenderer {
 public function render(): string;
}
interface EmailSender {
 public function send( array $data ): bool;
}

interface ContactFormFactory {
 public function createRenderer(): FormRenderer;
 public function createEmailSender(): EmailSender;
}

// Classic theme implementations
class ClassicFormRenderer implements FormRenderer { /* ... */ }
class ClassicEmailSender implements EmailSender { /* ... */ }
class ClassicThemeFactory implements ContactFormFactory { /* ... */ }

// Block theme implementations
class BlockFormRenderer implements FormRenderer { /* ... */ }
class BlockEmailSender implements EmailSender { /* ... */ }
class BlockThemeFactory implements ContactFormFactory { /* ... */ }

// Usage
$factory = new ClassicThemeFactory(); // or switch based on theme support
$renderer = $factory->createRenderer();
$sender = $factory->createEmailSender();
?>

این رویکرد منطق اصلی پلاگین را بدون تغییر نگه می دارد، حتی زمانی که تم های جدید معرفی می شوند، همچنین تست واحد را ساده می کند: شما می توانید یک کارخانه مسخره ایجاد کنید که تست را دو برابر می کند.

مزایای و اخراج تجاری

الگوی کارخانه انتزاعی مزایای مختلفی برای توسعه پلاگین وردپرس ارائه می دهد:

• پیچیدگی: مشتریان پلاگین تنها به رابط های انتزاعی بستگی دارد، نه کلاس های بتنی، این کاهش اثرات هنگامی که پیاده سازی تغییر می کند.
• سازگاری: الگوی تضمین می کند که اشیاء ایجاد شده توسط یک کارخانه متعلق به یک خانواده، جلوگیری از ترکیب های ناسازگار است.
• از تمدید: اضافه کردن یک خانواده جدید (به عنوان مثال، پشتیبانی از یک سازنده صفحه جدید) به سادگی نیاز به اجرای رابط ها و ایجاد یک کارخانه جدید دارد.

با این حال، این امر همچنین برخی از پیچیدگی ها را معرفی می کند:

• Overitial Overhead: رابط های تعریف و چندین کارخانه تعداد کلاس ها را افزایش می دهد.
• آموزش و پرورش Curve: [FLT 1] توسعه دهندگان ناآشنا با الگوهای طراحی ممکن است انتزاع دشوار است.
• افزایشگی در آفرینش جسم: اگر شما نیاز به ایجاد اشیا که به طور منظم به خانواده مناسب نیست، الگوی می تواند احساس اجبار کند.