<!-- Navigation Link -->
<a href="{{ theme_shop_url() }}">Shop</a>

<!-- AJAX Add to Cart -->
$.post('{{ theme_add_to_cart_url() }}', formData, function(r){
  if(r.status === 'success') toastr.success('Added to cart');
});

<!-- User State Display -->
@if(theme_is_logged_in())
  Welcome, {{ theme_auth()->name }}!
@endif

// In a plugin controller needing theme routes:
return redirect(theme_shop_url());

# Check for boot errors
tail -f storage/logs/plugin.log

# Filter for a specific plugin
grep "acme-seo" storage/logs/plugin.log

{
  "id":                   "acme-loyalty",
  "name":                 "Acme Loyalty Points",
  "version":              "1.0.0",
  "description":         "Loyalty points system for tenant shops",
  "type":                 "tenant",
  "pricing":              "free",
  "min_platform_version": "2.5.0",
  "main":                 "src/AcmeLoyaltyPlugin.php",
  "author":               "Acme Corp"
}

<?php
namespace Modules\AcmeLoyalty\Src;

use App\PluginSystem\PluginBase;

class AcmeLoyaltyPlugin extends PluginBase
{
    public function id(): string
    {
        return 'acme-loyalty';
    }

    public function boot(): void
    {
        // Register admin sidebar menu
        $this->add_menu([
            'id'      => 'acme-loyalty-menu',
            'label'   => __('Loyalty Points'),
            'icon'    => 'mdi-star',
            'route'   => 'tenant.admin.acme.loyalty.index',
            'order'   => 80,
            'context' => 'tenant',
        ]);

        // Award points when an order completes
        $this->add_action('nazmart:order_completed', function ($order) {
            $rate   = $this->get_option('points_per_dollar', 1);
            $points = (int) ($order->grand_total * $rate);
            // persist $points to acme_loyalty_points table...
        });

        // Optionally modify the displayed price
        $this->add_filter('nazmart:product_price', function ($price, $product) {
            // return price as-is (or modify for discounts)
            return $price;
        }, 10, 2);

        // Register plugin settings
        $this->register_settings([
            ['key' => 'points_per_dollar', 'label' => 'Points per $1 spent',    'type' => 'number',  'default' => 1],
            ['key' => 'welcome_bonus',     'label' => 'Welcome bonus points',     'type' => 'number',  'default' => 100],
            ['key' => 'enabled',           'label' => 'Enable loyalty program', 'type' => 'toggle',  'default' => true],
        ]);

        // Register [loyalty_balance /] shortcode
        $this->register_shortcode('loyalty_balance', function ($attrs) {
            $user = auth()->user();
            if (!$user) return '';
            return '<span class="loyalty-points">' . ($user->loyalty_points ?? 0) . ' pts</span>';
        });

        // Register as a price plan feature
        $this->add_filter('nazmart:price_plan_features', function (array $features): array {
            $features['acmeloyalty'] = __('Loyalty Points');
            return $features;
        });
    }

    public function on_activate(): void
    {
        // Run migrations — creates acme_loyalty_points table
        $this->run_migrations();
    }
}