Build storefronts and store integrations

# Public: the shopper's own session, no token
curl -s -X POST https://example.com/shop/api/cart/items \
  -H 'Content-Type: application/json' \
  -d '{"variant_id": 34, "qty": 2}'

{
  "id": 412, "currency": "USD", "item_count": 2,
  "items": [
    { "id": 981, "sku": "TSHIRT-M", "title": "T-shirt (M)", "qty": 2,
      "unit_price_minor": 1999, "unit_price_formatted": "$19.99",
      "total_minor": 3998, "total_formatted": "$39.98" }
  ],
  "totals": { "total_minor": 3998, "total_formatted": "$39.98" }
}

# Set the address, then ask for quotes. No address is a 422, not an empty list
curl -s -X PATCH https://example.com/shop/api/cart \
  -H 'Content-Type: application/json' \
  -d '{"address": {"country": "US", "region": "CA", "postcode": "94103"}}'
curl -s https://example.com/shop/api/shipping

{
  "required": true, "address_known": true,
  "zone": { "id": 2, "name": "United States" },
  "methods": [
    { "id": 5, "label": "Standard", "rate_minor": 500, "rate_formatted": "$5.00", "selected": false }
  ]
}

# Mint an API key. It is shown once
bin/plugin api keys:generate --user=admin --name="Warehouse sync"

# Every order that got past the cart, newest first
curl -s "https://example.com/api/v1/kahunacart/orders?per_page=2" \
  -H "X-API-Token: $KC_TOKEN"

{ "data": { "orders": [
    { "number": "1042", "email": "[email protected]", "payment_status": "paid",
      "fulfillment_status": "unfulfilled", "total_minor": 18600 },
    { "number": "1041", "email": "[email protected]", "payment_status": "paid",
      "fulfillment_status": "shipped", "total_minor": 6490 }
  ], "page": 1, "per_page": 2 } }

{% for product in kahunacart_products(4) %}
    <a href="{{ kahunacart_url('/product/' ~ product.slug) }}">
        <h3>{{ product.title }}</h3>
        <p>{{ kahunacart_price(product.default_variant.price_minor) }}</p>
    </a>
{% endfor %}

{# Or hand the list to the shipped grid: pictures, prices and empty states included #}
{% include 'partials/kahunacart-product-grid.html.twig' with {products: kahunacart_products(8)} %}

{# A buy button on a landing page or a blog post #}
{% include 'partials/kahunacart-buy-button.html.twig' with {product: kahunacart_product('my-widget')} %}

use Grav\Plugin\KahunaCart\Event\Events;
use RocketTheme\Toolbox\Event\Event;

public static function getSubscribedEvents(): array
{
    return [Events::ORDER_COMPLETED => ['onOrderCompleted', 0]];
}

public function onOrderCompleted(Event $event): void
{
    $order = $event['order'];

    // Anything that talks to another server belongs in a job.
    // Register the handler on Events::REGISTER_JOB_HANDLERS.
}

# The installation doctor: ten checks, each with a suggested fix
bin/plugin kahunacart check

# Wipe the test data before going live and keep every setting
bin/plugin kahunacart reset --orders --customers --keep-settings

# A benchmark-sized store: 5,000 products and 250,000 orders
bin/plugin kahunacart bench:seed --profile=balanced

# Scaffold an installable add-on with a test that already passes
bin/plugin kahunacart make:provider warranty