Websource Store Info pour WordPress — référence développeur

Vue d'ensemble

• Espace de noms Websource\StoreInfo, classes dans src/ (chargeur PSR-4 maison, pas de Composer).
• Capacité requise pour l'administration et toutes les routes REST : manage_options (filtre websource_storeinfo_capability).
• Fonctionne sans WooCommerce. Les emplacements « fiche produit » et « panier » s'appuient sur ses hooks.
• CSS (wsx-storeinfo) et JavaScript (wsx-storeinfo, différé, sans dépendance) chargés seulement quand un bloc est rendu.
• Aucun appel externe côté serveur, sauf le téléchargement d'une photo lors d'un import (adresses publiques seulement, download_url).

php tests/run.php exécute 48 vérifications de la logique d'horaires sans WordPress (plages multiples, minuit, jours fériés, fuseaux, changement d'heure, saisons).

Données

Contenu d'un magasin

Réglages

Emplacement

Bloc Gutenberg websource/storeinfo

Rendu serveur (block.json, apiVersion 3, éditeur sans build). Catégorie Widgets. Alignements large et pleine largeur.

<!-- wp:websource/storeinfo {"store":"main","layout":"card","title":"Notre magasin"} /-->

Code court [websource_storeinfo]

[websource_storeinfo store="magasin-de-demonstration" layout="compact"]

Un magasin inconnu ou masqué ne produit aucune sortie.

Fonctions publiques

// HTML du bloc. $store : 'main', 'all', numéro ou identifiant court. $layout : compact|card|footer.
echo websource_storeinfo_render('main', 'card', 'Notre magasin');

// État d'ouverture dans le fuseau du site, ou null si le magasin n'existe pas.
$status = websource_storeinfo_status('main');
// ['state' => 'closed', 'text' => 'Fermé – ouvre demain à 9h']  (state : open|closing|closed|unknown)

Emplacements automatiques

Un thème peut accueillir le bloc avec do_action('websource_after_header'), do_action('websource_before_footer') ou do_action('websource_footer'). Chaque position est rendue une fois par page.

Gabarit surchargeable

Copiez templates/store.php dans <thème>/websource-storeinfo/store.php. Les variables sont dans $wssi : stores (magasins prêts à afficher), layout, title, style, wide, multi, show, class.

Routes REST

Espace de noms websource-storeinfo/v1. Toutes les routes exigent la capacité de gestion ; sans authentification : 401.

curl -X POST https://example.test/wp-json/websource-storeinfo/v1/stores \
  -H 'X-WP-Nonce: <nonce>' --cookie '<cookies de session>' -H 'Content-Type: application/json' \
  -d '{"id":0,"active":true,"content":{"name":"Magasin de démonstration","city":"Ville-Exemple","hours":{"1":"9h-12h / 14h-18h"}}}'

{"store":{"id":1,"slug":"magasin-de-demonstration","active":true,"content":{"name":"Magasin de démonstration","description":"","note":"","address1":"","address2":"","postcode":"","city":"Ville-Exemple","country":"","country_iso":"","phone":"","email":"","latitude":"","longitude":"","image_id":0,"hours":{"1":"9h-12h / 14h-18h","2":"","3":"","4":"","5":"","6":"","7":""},"seasons":[],"exceptions":[]},"image_url":""}}

Réponse de /import :

{"action":"merge","counts":{"create":2,"update":1,"delete":0,"skip":2},"messages":["Un magasin sans nom a été ignoré."],"dry_run":true,"stores":[],"settings":{},"placements":[]}

Filtres

// Rattacher les magasins au nœud Organization émis par le thème.
add_filter('websource_storeinfo_organization_id', static function () {
    return home_url('/#organization');
});

Actions

Données structurées

Un nœud LocalBusiness par magasin actif, dans le <head> : @id{accueil}#store-<identifiant court>, name, description, url, image, telephone, email, address, geo et hasMap (si la latitude et la longitude sont valides), openingHoursSpecification (semaine, saisons avec validFrom / validThrough, exceptions). Le magasin principal est émis sur toutes les pages, tous les magasins actifs sur la page de contact. Le réglage schema les désactive.

Export JSON

{
  "plugin": "websource-storeinfo",
  "section": "storeinfo",
  "version": 1,
  "data": {
    "contact_included": false,
    "settings": {"main_store": "magasin-de-demonstration", "contact_page": "@page:contact"},
    "placements": [{"position": "footer_col", "page": "all", "hook": "", "layout": "footer", "store": "slug:magasin-de-demonstration", "title": "Notre magasin"}],
    "stores": [{"slug": "magasin-de-demonstration", "active": true, "content": {"name": "Magasin de démonstration", "image": "https://example.test/wp-content/uploads/photo.jpg", "hours": {"1": "9h-12h"}}}]
  }
}

• Les magasins sont désignés par leur identifiant court, la page de contact par @page:<slug>, la photo par son adresse.
• Sans contact_included, les champs address1, address2, postcode, city, country, country_iso, phone, email, latitude, longitude sont vides ; à l'import, ceux d'un magasin existant de même identifiant sont conservés.
• keep_data n'est jamais exporté ni importé.
• À l'import, une photo de ce site est réutilisée ; une autre adresse est téléchargée dans la médiathèque (JPEG, PNG ou WebP, 8 Mo).
• Les paquets du module PrestaShop sont acceptés : textes par code de langue (celui de la langue du site est gardé), emplacements display* inconnus ignorés avec un message.

Variables CSS

Le bloc lit les variables du thème avec une valeur de repli. Surchargez les variables --wssi-* sur .wssi.

Couleur d'accent : --wst-brand, puis --color-brand-600 (repli #0f766e). Colonne de pied de page : --color-footer-ink, --color-footer-muted, --color-footer-line.

Classes : .wssi, .wssi--compact, .wssi--card, .wssi--footer, .wssi--wide, .wssi--multi, .wssi--placed, .wssi--at-<position>, .wssi__badge.is-open|is-closing|is-closed|is-unknown. Dans la carte, la photo passe à côté du texte quand la carte dépasse 46 rem (requête de conteneur).

Polylang et WPML

Les textes saisis (nom, description, note, pays, libellés de saisons et de fermetures, titres d'emplacements) sont déclarés par pll_register_string (groupe « Websource Store Info ») et wpml_register_single_string. Les textes du badge existent en français et en anglais (filtre websource_storeinfo_labels pour une autre langue).

Désinstallation

uninstall.php supprime les quatre options si keep_data est décoché. Les photos restent dans la médiathèque.