PHP: SDK-ul botmetria/ucp

WooCommerce și vitrina din feed — 15 minute · SDK-uri — aproximativ o oră · 4 moduri · nu doar WordPress

Magazin propriu sau Laravel — comerțul agentic se conectează cu un pachet Composer și ~50 de linii de adaptor. MIT, zero dependențe, PHP ≥ 8.1.

Instalare

composer require botmetria/ucp

Start rapid

Două linii chiar la începutul front controller-ului (index.php), înaintea rutării:

use Botmetria\Ucp\Ucp;
use Botmetria\Ucp\ArrayProductProvider;

$ucp = new Ucp([
    'store_name' => 'My Shop',
    'store_url'  => 'https://my-shop.com/',
    'currency'   => 'EUR',
    'products'   => new MyProducts(),  // ProductProviderInterface
    // 'cart'    => new MyCart(),      // CartProviderInterface: agent checkout
]);
$ucp->run(); // serves /.well-known/ucp and /ucp/v1/*

Două niveluri — un pachet

Vitrină (doar catalog)

Implementați ProductProviderInterface — agenții văd catalogul, manifestul raportează onest checkout:false.

Checkout complet

Adăugați CartProviderInterface::fill() — agentul construiește coșul, cumpărătorul plătește în checkout-ul dvs. nativ.

Framework-uri

Laravel — middleware în stiva globală; Slim/Mezzio — middleware PSR-15; PHP simplu — $ucp->run() în front controller. Exemple — în README-ul pachetului.

Analitică pe PHP

Pentru numărarea boților AI, inserați colectorul PHP din panou (secțiunea „Conectare”). Onest: pe PHP colectorul numără traficul, dar nu blochează — blocarea funcționează în pluginul WooCommerce și colectorul Node.

Verificare

Manifestul pe domeniul dvs. plus demo-ul live de cumpărare:

curl https://your-store.com/.well-known/ucp

Pachet și surse: Packagist · GitHub · Specificația UCP și self-hosting