Architecture

The PHP + asset structure of wkwc_wallet_central/. Loader → endpoint → router → views → partials.

Folder Layout

wkwc_wallet_central/
├─ class-wkwp-central-loader.php   ← entry point
├─ index.php
├─ assets/
│  ├─ css/
│  └─ js/
├─ includes/
│  ├─ class-wkwp-central-i18n.php
│  ├─ class-wkwp-central-context.php
│  ├─ class-wkwp-central-router.php
│  ├─ class-wkwp-central-renderer.php
│  ├─ class-wkwp-central-assets.php
│  ├─ class-wkwp-central-cta-button.php
│  ├─ class-wkwp-central-endpoint.php
│  ├─ class-wkwp-central-bridge.php
│  ├─ class-wkwp-central-settings-ajax.php
│  ├─ partials/  (16 partial classes)
│  └─ views/     (12 view classes)
└─ templates/
   ├─ chrome.php
   └─ index.php

Boot Sequence

WKWP_Central_Loader::__construct():

1. Load files — every class file required once
2. Check enable flag (_wkwp_central_enable) — exit if off
3. Boot singletons in order:
   • WKWP_Central_Endpoint — registers rewrite + template_redirect
   • WKWP_Central_Assets — registers CSS/JS bundles
   • WKWP_Central_CTA_Button — wires the legacy My Wallet CTA
   • WKWP_Central_Bridge — bridges into other Webkul modules (referral, KYC, etc.)
   • WKWP_Central_Settings_Ajax — wires the customer-side settings AJAX

Class Map

Views (one per route)

includes/views/:

Each view exposes a single static render( WKWP_Central_Context $ctx ) method called by the renderer.

Partials (composable building blocks)

includes/partials/:

Templates

templates/:

Templates are simple — most logic lives in Renderer and partials.

Render Flow

WKWP_Central_Endpoint::maybe_render:

1. Check query var wkwp_central=1 → bail if not present
2. Check auth → redirect anon to wp_login_url
3. Build context: WKWP_Central_Context::for_user( $current_user )
   - balance, kyc status, locks, settings, currency, etc.
4. Resolve view: WKWP_Central_Router::resolve()
5. Send headers (no-cache, content-type)
6. Include templates/index.php
   - includes templates/chrome.php
     - calls Renderer::render( $view, $ctx )
       - Renderer dispatches to View_<view>::render( $ctx )
       - View calls Partials it needs
7. exit

Asset Bundles

WKWP_Central_Assets::register:

Lazy view-specific bundles keep first-paint fast — typical home page ships ~80 KB CSS + 60 KB JS.

Bridge Class

WKWP_Central_Bridge listens to wallet-engine actions and pushes them into Wallet Central caches:

Means Wallet Central never has its own duplicate event system — it shares the engine's events.

Context Object

WKWP_Central_Context is the per-request data bag passed to every view + partial:

Built once on template_redirect. Cheap to pass around (object reference, not array copy).

Central vs Engine

Means Wallet Central never duplicates engine logic. Every state change flows through the engine.

Adding a Custom Partial

// 1. Create partial class (file: includes/partials/class-wkwp-central-partial-points.php)
final class WKWP_Central_Partial_Points {
    public static function render( WKWP_Central_Context $ctx ) {
        ?>
        <div class="wcc-card wcc-points">
          <h3><?php esc_html_e( 'Loyalty points', 'mytheme' ); ?></h3>
          <p class="wcc-points-value"><?php echo esc_html( get_user_meta( $ctx->user_id, '_my_points', true ) ); ?></p>
        </div>
        <?php
    }
}

// 2. Register the file (filter the loader file list)
add_filter( 'wkwp_central_files', function( $files, $base ) {
    $files[] = $base . 'partials/class-wkwp-central-partial-points.php';
    return $files;
}, 10, 2 );

// 3. Render it inside an existing view
add_action( 'wkwp_central_render_view', function( $view, $ctx ) {
    if ( 'home' !== $view ) return;
    WKWP_Central_Partial_Points::render( $ctx );
}, 10, 2 );

Hooks (architecture-level)

Performance

Lazy-load policy:

• View-specific bundles only on their view
• html5-qrcode library only on qr view
• Tweaks panel JS deferred (no blocking)

Test Plan

1. /wallet-central/ → confirm 1 CSS + 2 JS bundles loaded (core + home + tweaks)
2. /wallet-central/qr/ → confirm html5-qrcode lazy-loaded
3. /wallet-central/foo/ → router falls back to home
4. Disable plugin → confirm /wallet-central/ 404s
5. Toggle _wkwp_central_enable=0 → confirm rewrite rules removed (404s)

Related

• Endpoint & Routing
• Home Dashboard
• Tweaks & Responsive
• Security