Developer Documentation & Storefront Guides

1. Headless Architecture & Design Freedom

Selliglobe separates backend commerce operations (multi-tenant inventory, customer receivables, automated runsheet dispatch, multi-currency conversion) from frontend presentation.

You can design themes using standard HTML/CSS, Tailwind, Vue, or React while feeding real-time catalog data using either:

• Dynamic CMS Shortcodes (e.g. [products category="sweets" limit="8"]) directly inside the Admin Page Editor.
• Headless PHP Feeders (e.g. sg_get_products()) in custom theme templates (themes/{your-theme}/landing.php).

2. Dynamic Shortcode Reference

Shortcodes can be placed anywhere inside CMS page content or templates. They execute safely and render responsive HTML components with theme override fallbacks.

Shortcode Example Usage

<!-- Featured Bakery Specials Grid -->
[products limit="6" category="signature-cakes" columns="3"]

<!-- Interactive Customer Order Tracking -->
[track_order placeholder="Enter your 10-digit mobile number..."]

<!-- Floating Basket Drawer -->
[cart_drawer]

3. Headless PHP Feeder Engine

When developing custom themes, avoid raw SQL queries. Instead, invoke the centralized sg_get_products() helper which handles tenant boundaries, stock calculations, tax configurations, and clean SEO URLs automatically.

<?php
// Fetch active online products for the current business
$products = sg_get_products([
    'limit'    => 12,
    'featured' => true,
    'category' => 'mineral-water'
]);

foreach ($products as $p): ?>
    <div class="my-custom-card">
        <img src="<?= esc_url($p['image_url']) ?>" alt="<?= esc_attr($p['name']) ?>">
        <h3><?= esc_html($p['name']) ?></h3>
        <span class="price"><?= $p['formatted_price'] ?></span>
        <button onclick="sgAddToCart(<?= (int)$p['id'] ?>, '<?= esc_js($p['name']) ?>', <?= (float)$p['price'] ?>, '<?= esc_url($p['image_url']) ?>')">
            Add to Basket
        </button>
    </div>
<?php endforeach; ?>

4. Sovereign Multi-Country Tax Engine

Selliglobe enforces sovereign merchant tax freedom. We have eliminated hardcoded agency locks. Every merchant configures their exact tax parameters directly in Admin → Settings → Fiscal & Tax.

• Tax Rates: Configure 0% (Tax-Exempt/Exports), 5% (GCC VAT), 16%/18% (Provincial GST), 20% (UK VAT), or any custom fractional percentage.
• Inclusive vs Exclusive Calculation: Determine whether prices displayed in the shop already include tax or whether tax is computed at checkout.
• Sovereign Digital Verification: Receipts embed universal cryptographic verification URLs (https://{domain}/receipt?id={order_no}) readable by any standard smartphone camera.

5. Marketing XML Feeds & Ad Catalogs

Connect your storefront catalog directly to Google Merchant Center (Google Shopping) and Meta Ads (Facebook & Instagram Dynamic Product Ads). Feeds update dynamically in real time and automatically filter out draft or hidden products (show_on_shop=0).