feat: Implement centralized module management system

- Add ModuleRegistry for managing built-in modules (newsletter, wishlist, affiliate, subscription, licensing)
- Add ModulesController REST API for module enable/disable
- Create Modules settings page with category grouping and toggle controls
- Integrate module checks across admin-spa and customer-spa
- Add useModules hook for both SPAs to check module status
- Hide newsletter from footer builder when module disabled
- Hide wishlist features when module disabled (product cards, account menu, wishlist page)
- Protect wishlist API endpoints with module checks
- Auto-update navigation tree when modules toggled
- Clean up obsolete documentation files
- Add comprehensive documentation:
  - MODULE_SYSTEM_IMPLEMENTATION.md
  - MODULE_INTEGRATION_SUMMARY.md
  - ADDON_MODULE_INTEGRATION.md (proposal)
  - ADDON_MODULE_DESIGN_DECISIONS.md (design doc)
  - FEATURE_ROADMAP.md
  - SHIPPING_INTEGRATION.md

Module system provides:
- Centralized enable/disable for all features
- Automatic navigation updates
- Frontend/backend integration
- Foundation for addon-module unification
This commit is contained in:
Dwindi Ramadhana
2025-12-26 19:19:49 +07:00
parent 0b2c8a56d6
commit 07020bc0dd
59 changed files with 3891 additions and 12132 deletions

View File

@@ -0,0 +1,167 @@
<?php
/**
* Modules REST API Controller
*
* @package WooNooW\Api
*/
namespace WooNooW\Api;
use WP_REST_Controller;
use WP_REST_Server;
use WP_REST_Request;
use WP_REST_Response;
use WP_Error;
use WooNooW\Core\ModuleRegistry;
class ModulesController extends WP_REST_Controller {
/**
* REST API namespace
*/
protected $namespace = 'woonoow/v1';
/**
* REST API base
*/
protected $rest_base = 'modules';
/**
* Register routes
*/
public function register_routes() {
// GET /woonoow/v1/modules
register_rest_route($this->namespace, '/' . $this->rest_base, [
[
'methods' => WP_REST_Server::READABLE,
'callback' => [$this, 'get_modules'],
'permission_callback' => [$this, 'check_permission'],
],
]);
// POST /woonoow/v1/modules/toggle
register_rest_route($this->namespace, '/' . $this->rest_base . '/toggle', [
[
'methods' => WP_REST_Server::CREATABLE,
'callback' => [$this, 'toggle_module'],
'permission_callback' => [$this, 'check_permission'],
'args' => [
'module_id' => [
'required' => true,
'type' => 'string',
'sanitize_callback' => 'sanitize_text_field',
],
'enabled' => [
'required' => true,
'type' => 'boolean',
],
],
],
]);
// GET /woonoow/v1/modules/enabled (public endpoint for frontend)
register_rest_route($this->namespace, '/' . $this->rest_base . '/enabled', [
[
'methods' => WP_REST_Server::READABLE,
'callback' => [$this, 'get_enabled_modules'],
'permission_callback' => '__return_true',
],
]);
}
/**
* Check permission
*
* @return bool
*/
public function check_permission() {
return current_user_can('manage_options');
}
/**
* Get all modules with status
*
* @param WP_REST_Request $request
* @return WP_REST_Response
*/
public function get_modules($request) {
$modules = ModuleRegistry::get_all_with_status();
// Group by category
$grouped = [
'marketing' => [],
'customers' => [],
'products' => [],
];
foreach ($modules as $module) {
$category = $module['category'];
if (isset($grouped[$category])) {
$grouped[$category][] = $module;
}
}
return new WP_REST_Response([
'modules' => $modules,
'grouped' => $grouped,
], 200);
}
/**
* Toggle module enabled/disabled
*
* @param WP_REST_Request $request
* @return WP_REST_Response|WP_Error
*/
public function toggle_module($request) {
$module_id = $request->get_param('module_id');
$enabled = $request->get_param('enabled');
$modules = ModuleRegistry::get_all_modules();
if (!isset($modules[$module_id])) {
return new WP_Error(
'invalid_module',
__('Invalid module ID', 'woonoow'),
['status' => 400]
);
}
if ($enabled) {
$result = ModuleRegistry::enable($module_id);
} else {
$result = ModuleRegistry::disable($module_id);
}
if ($result) {
return new WP_REST_Response([
'success' => true,
'message' => $enabled
? __('Module enabled successfully', 'woonoow')
: __('Module disabled successfully', 'woonoow'),
'module_id' => $module_id,
'enabled' => $enabled,
], 200);
}
return new WP_Error(
'toggle_failed',
__('Failed to toggle module', 'woonoow'),
['status' => 500]
);
}
/**
* Get enabled modules (public endpoint)
*
* @param WP_REST_Request $request
* @return WP_REST_Response
*/
public function get_enabled_modules($request) {
$enabled = ModuleRegistry::get_enabled_modules();
return new WP_REST_Response([
'enabled' => $enabled,
], 200);
}
}

View File

@@ -21,6 +21,7 @@ use WooNooW\Api\ProductsController;
use WooNooW\Api\CouponsController;
use WooNooW\Api\CustomersController;
use WooNooW\Api\NewsletterController;
use WooNooW\Api\ModulesController;
use WooNooW\Frontend\ShopController;
use WooNooW\Frontend\CartController as FrontendCartController;
use WooNooW\Frontend\AccountController;
@@ -123,6 +124,10 @@ class Routes {
// Newsletter controller
NewsletterController::register_routes();
// Modules controller
$modules_controller = new ModulesController();
$modules_controller->register_routes();
// Frontend controllers (customer-facing)
ShopController::register_routes();
FrontendCartController::register_routes();