Passa al contenuto principale

Aggiungere un provider

Riferimento sviluppatori: per sviluppatori PHP che distribuiscono un’integrazione di prenotazione personalizzata insieme a Booking Engine Connector.

Il plugin risolve le integrazioni tramite ProviderInterface (includes/Providers/Contracts/ProviderInterface.php). Il KrossProvider incluso è l’implementazione di riferimento.

Checklist di alto livello​

  1. Implementa ProviderInterface in una tua classe PHP (autoload Composer o require manuale in un piccolo plugin bootstrap).
  2. Registra la mappa etichette admin con bec_registered_providers così Booking Engine → Connection mostra il tuo slug.
  3. Restituisci la tua istanza concreta da bec_provider_instance quando WordPress chiede il tuo slug — ProviderRegistry::getProvider() invoca questo filtro prima del fallback ai built-in.
  4. Memorizza i campi credenziali in modo dichiarativo con getCredentialSchema() — Connection salva opzioni come bec_{slug}_{fieldKey} automaticamente.
  5. Implementa fetchRemoteUnits(), extractCoreUnitFields(), getQuoteForUnit(), buildCheckoutUrl(), e opzionalmente BulkQuoteProviderInterface + getUnitInfoRenderers().

Registrazione admin​

Etichette menu a tendina​

Il filtro bec_registered_providers riceve [ slug => etichetta umana ]. Unisci il tuo slug:

add_filter('bec_registered_providers', function (array $map): array {
    $map['myengine'] = __('My Engine', 'my-plugin');
    return $map;
});

Se lo slug attivo salvato manca da questa mappa dopo il filtro, Connection ripristina la selezione a kross — unisci sempre entrambe le chiavi durante rollout/migrazioni.

Istanza concreta del provider​

Il filtro bec_provider_instance riceve (null|ProviderInterface $maybe, string $slug):

add_filter('bec_provider_instance', function ($provider, string $slug) {
    if ($slug === 'myengine') {
        return new MyEngineProvider();
    }
    return $provider;
}, 10, 2);

Senza questo hook, gli slug sconosciuti oggi tornano a KrossProvider in ProviderRegistry::getProvider(), rompendo integrazioni non correlate — abbina sempre nuovi slug a questo filtro.

Schema credenziali​

Implementa getCredentialSchema(): array restituendo una lista di oggetti CredentialField che descrivono input admin (label, help, type, required, ecc.). Valida la connettività dentro validateCredentials() così la Sync mostra errori azionabili presto.

Responsabilità principali​

MetodoResponsabilità
getSlug()Slug minuscolo stabile (myengine). Deve coincidere con chiavi mappa/filtro.
fetchRemoteUnits()Restituisce array normalizzati consumati dalla sync (external_id, payload raw annidato, …). Applica filtri già documentati in Hook sync dove rilevante.
extractCoreUnitFields()Popola chiavi CoreUnitSemantic (bec_core_*).
getUnitSyncFieldDefinitions()Definizioni meta extra opzionali (UnitSyncFieldDefinition). Restituisci [] se non usate.
requiresChildrenAges() / getSearchGuestFieldMode()Guidano cablaggio campi [bec_search] (SearchGuestFieldMode).
getQuoteForUnit()Restituisce array/WP_Error coerenti con i consumer preventivi (QuoteService).
buildCheckoutUrl()Restituisce ['url' => ..., 'label' => ...] o descrittore POST (method=post, post_fields).
getUnitInfoRenderers()Mappa chiave shortcode → callable per [bec_unit_info] (può restituire []).

Opzionale BulkQuoteProviderInterface raggruppa disponibilità una volta per SearchContext (vedi docblock interfaccia in includes/Providers/Contracts/BulkQuoteProviderInterface.php).

Le unità ricordano lo slug provider​

Ogni bec_unit memorizza bec_provider_slug. Preventivi/checkout si risolvono tramite quello slug anche se il provider attivo globale cambia — mantieni costanti slug compatibili con versioni precedenti quando rinomini integrazioni.

Hook di test​

Usa bec_test_connection dal pulsante verifica Connection per adapter non-Kross (restituisci stringhe amichevoli/WP_Error). Kross collega lo scambio token automaticamente.

Documentazione correlata​