235 lines
9.0 KiB
PHP
235 lines
9.0 KiB
PHP
<?php
|
|
namespace WooNooW\Compat;
|
|
|
|
if ( ! defined('ABSPATH') ) exit;
|
|
|
|
/**
|
|
* Navigation Registry
|
|
*
|
|
* Manages dynamic navigation tree building. Allows addons to inject
|
|
* menu items into the main navigation or existing sections.
|
|
*
|
|
* @since 1.0.0
|
|
*/
|
|
class NavigationRegistry {
|
|
const NAV_OPTION = 'wnw_nav_tree';
|
|
const NAV_VERSION = '1.0.0';
|
|
|
|
/**
|
|
* Initialize hooks
|
|
*/
|
|
public static function init() {
|
|
// Use 'init' hook instead of 'plugins_loaded' to avoid translation loading warnings (WP 6.7+)
|
|
add_action('init', [__CLASS__, 'build_nav_tree'], 10);
|
|
add_action('activated_plugin', [__CLASS__, 'flush']);
|
|
add_action('deactivated_plugin', [__CLASS__, 'flush']);
|
|
}
|
|
|
|
/**
|
|
* Build the complete navigation tree
|
|
*/
|
|
public static function build_nav_tree() {
|
|
// Base navigation tree (core WooNooW sections)
|
|
$tree = self::get_base_tree();
|
|
|
|
/**
|
|
* Filter: woonoow/nav_tree
|
|
*
|
|
* Allows addons to modify the entire navigation tree.
|
|
*
|
|
* @param array $tree Array of main navigation nodes
|
|
*
|
|
* Example:
|
|
* add_filter('woonoow/nav_tree', function($tree) {
|
|
* $tree[] = [
|
|
* 'key' => 'subscriptions',
|
|
* 'label' => 'Subscriptions',
|
|
* 'path' => '/subscriptions',
|
|
* 'icon' => 'repeat', // lucide icon name
|
|
* 'children' => [
|
|
* ['label' => 'All Subscriptions', 'mode' => 'spa', 'path' => '/subscriptions'],
|
|
* ['label' => 'New', 'mode' => 'spa', 'path' => '/subscriptions/new'],
|
|
* ],
|
|
* ];
|
|
* return $tree;
|
|
* });
|
|
*/
|
|
$tree = apply_filters('woonoow/nav_tree', $tree);
|
|
|
|
// Allow per-section modification
|
|
foreach ($tree as &$section) {
|
|
$key = $section['key'] ?? '';
|
|
if ($key) {
|
|
/**
|
|
* Filter: woonoow/nav_tree/{key}/children
|
|
*
|
|
* Allows addons to inject items into specific sections.
|
|
*
|
|
* Example:
|
|
* add_filter('woonoow/nav_tree/products/children', function($children) {
|
|
* $children[] = [
|
|
* 'label' => 'Bundles',
|
|
* 'mode' => 'spa',
|
|
* 'path' => '/products/bundles',
|
|
* ];
|
|
* return $children;
|
|
* });
|
|
*/
|
|
$section['children'] = apply_filters(
|
|
"woonoow/nav_tree/{$key}/children",
|
|
$section['children'] ?? []
|
|
);
|
|
}
|
|
}
|
|
|
|
// Store in option
|
|
update_option(self::NAV_OPTION, [
|
|
'version' => self::NAV_VERSION,
|
|
'tree' => $tree,
|
|
'updated' => time(),
|
|
], false);
|
|
}
|
|
|
|
/**
|
|
* Get base navigation tree (core sections)
|
|
*
|
|
* @return array Base navigation tree
|
|
*/
|
|
private static function get_base_tree(): array {
|
|
return [
|
|
[
|
|
'key' => 'dashboard',
|
|
'label' => __('Dashboard', 'woonoow'),
|
|
'path' => '/',
|
|
'icon' => 'layout-dashboard',
|
|
'children' => [
|
|
['label' => __('Overview', 'woonoow'), 'mode' => 'spa', 'path' => '/', 'exact' => true],
|
|
['label' => __('Revenue', 'woonoow'), 'mode' => 'spa', 'path' => '/dashboard/revenue'],
|
|
['label' => __('Orders', 'woonoow'), 'mode' => 'spa', 'path' => '/dashboard/orders'],
|
|
['label' => __('Products', 'woonoow'), 'mode' => 'spa', 'path' => '/dashboard/products'],
|
|
['label' => __('Customers', 'woonoow'), 'mode' => 'spa', 'path' => '/dashboard/customers'],
|
|
['label' => __('Coupons', 'woonoow'), 'mode' => 'spa', 'path' => '/dashboard/coupons'],
|
|
['label' => __('Taxes', 'woonoow'), 'mode' => 'spa', 'path' => '/dashboard/taxes'],
|
|
],
|
|
],
|
|
[
|
|
'key' => 'orders',
|
|
'label' => __('Orders', 'woonoow'),
|
|
'path' => '/orders',
|
|
'icon' => 'receipt-text',
|
|
'children' => [], // Orders has no submenu by design
|
|
],
|
|
[
|
|
'key' => 'products',
|
|
'label' => __('Products', 'woonoow'),
|
|
'path' => '/products',
|
|
'icon' => 'package',
|
|
'children' => [
|
|
['label' => __('All products', 'woonoow'), 'mode' => 'spa', 'path' => '/products'],
|
|
['label' => __('New', 'woonoow'), 'mode' => 'spa', 'path' => '/products/new'],
|
|
['label' => __('Categories', 'woonoow'), 'mode' => 'spa', 'path' => '/products/categories'],
|
|
['label' => __('Tags', 'woonoow'), 'mode' => 'spa', 'path' => '/products/tags'],
|
|
['label' => __('Attributes', 'woonoow'), 'mode' => 'spa', 'path' => '/products/attributes'],
|
|
],
|
|
],
|
|
[
|
|
'key' => 'coupons',
|
|
'label' => __('Coupons', 'woonoow'),
|
|
'path' => '/coupons',
|
|
'icon' => 'tag',
|
|
'children' => [
|
|
['label' => __('All coupons', 'woonoow'), 'mode' => 'spa', 'path' => '/coupons'],
|
|
['label' => __('New', 'woonoow'), 'mode' => 'spa', 'path' => '/coupons/new'],
|
|
],
|
|
],
|
|
[
|
|
'key' => 'customers',
|
|
'label' => __('Customers', 'woonoow'),
|
|
'path' => '/customers',
|
|
'icon' => 'users',
|
|
'children' => [
|
|
['label' => __('All customers', 'woonoow'), 'mode' => 'spa', 'path' => '/customers'],
|
|
],
|
|
],
|
|
[
|
|
'key' => 'settings',
|
|
'label' => __('Settings', 'woonoow'),
|
|
'path' => '/settings',
|
|
'icon' => 'settings',
|
|
'children' => self::get_settings_children(),
|
|
],
|
|
];
|
|
}
|
|
|
|
/**
|
|
* Get settings submenu children
|
|
*
|
|
* @return array Settings submenu items
|
|
*/
|
|
private static function get_settings_children(): array {
|
|
$admin = admin_url('admin.php');
|
|
|
|
return [
|
|
// WooNooW Settings
|
|
['label' => __('WooNooW', 'woonoow'), 'mode' => 'spa', 'path' => '/settings'],
|
|
|
|
// WooCommerce Settings (Most Used First)
|
|
['label' => __('General', 'woonoow'), 'mode' => 'spa', 'path' => '/settings/general'],
|
|
['label' => __('Payments', 'woonoow'), 'mode' => 'spa', 'path' => '/settings/payments'],
|
|
['label' => __('Shipping', 'woonoow'), 'mode' => 'spa', 'path' => '/settings/shipping'],
|
|
['label' => __('Products', 'woonoow'), 'mode' => 'spa', 'path' => '/settings/products'],
|
|
['label' => __('Tax', 'woonoow'), 'mode' => 'spa', 'path' => '/settings/tax'],
|
|
['label' => __('Accounts & Privacy', 'woonoow'), 'mode' => 'spa', 'path' => '/settings/accounts'],
|
|
['label' => __('Emails', 'woonoow'), 'mode' => 'spa', 'path' => '/settings/emails'],
|
|
|
|
// Less Common (Bridge to WP Admin for now)
|
|
['label' => __('Advanced', 'woonoow'), 'mode' => 'bridge', 'href' => $admin . '?page=wc-settings&tab=advanced'],
|
|
['label' => __('Integration', 'woonoow'), 'mode' => 'bridge', 'href' => $admin . '?page=wc-settings&tab=integration'],
|
|
['label' => __('Status', 'woonoow'), 'mode' => 'bridge', 'href' => $admin . '?page=wc-status'],
|
|
['label' => __('Extensions', 'woonoow'), 'mode' => 'bridge', 'href' => $admin . '?page=wc-addons'],
|
|
];
|
|
}
|
|
|
|
/**
|
|
* Get the complete navigation tree
|
|
*
|
|
* @return array Navigation tree
|
|
*/
|
|
public static function get_nav_tree(): array {
|
|
$data = get_option(self::NAV_OPTION, []);
|
|
return $data['tree'] ?? self::get_base_tree();
|
|
}
|
|
|
|
/**
|
|
* Get a specific section by key
|
|
*
|
|
* @param string $key Section key
|
|
* @return array|null Section data or null if not found
|
|
*/
|
|
public static function get_section(string $key): ?array {
|
|
$tree = self::get_nav_tree();
|
|
foreach ($tree as $section) {
|
|
if (($section['key'] ?? '') === $key) {
|
|
return $section;
|
|
}
|
|
}
|
|
return null;
|
|
}
|
|
|
|
/**
|
|
* Flush the navigation cache
|
|
*/
|
|
public static function flush() {
|
|
delete_option(self::NAV_OPTION);
|
|
}
|
|
|
|
/**
|
|
* Get navigation tree for frontend
|
|
*
|
|
* @return array Array suitable for JSON encoding
|
|
*/
|
|
public static function get_frontend_nav_tree(): array {
|
|
return self::get_nav_tree();
|
|
}
|
|
}
|