Websource Locale pour PrestaShop — référence développeur

Vue d'ensemble

• Module websourcelocale, espace de noms Websource\Locale\ (PSR-4 dans src/), implémente WidgetInterface.
• Un réglage JSON par boutique, WSLC_SETTINGS (Settings\SettingsRepository::loadForShop(), saveForShop() ; normalisation par Settings\Settings::fromArray()).
• Aucune table. Aucun appel externe.

Hooks

Emplacements (Settings\PlacementCatalog)

Un emplacement : {"position": "footer_locale", "hook": "displayWebsourceFooterLocale", "what": "auto", "visibility": "all"} ; 12 au plus.

what : auto (selon la disposition), combined, language, currency. visibility : all, desktop, mobile.

WebsourceLocale::applyPlacementPosition(string $position, int $shopId = 0): bool remplace le premier emplacement par nav1, topbar_right ou footer_locale et resynchronise les hooks ; c'est la méthode appelée par l'écran En-tête et pied de page de Websource Builder.

À savoir : positionLabels() (liste du formulaire d'administration) ne contient ni topbar_right ni footer_locale. Une ligne portant l'une de ces positions est donc affichée « (aucun) » et supprimée à l'enregistrement du formulaire (constaté sur la boutique de test).

Widget

{widget name='websourcelocale'}
{widget name='websourcelocale' what='language'}
{widget name='websourcelocale' what='currency'}
{widget name='websourcelocale' what='combined'}

Sans what et avec un nom de hook, le widget rend les emplacements enregistrés pour ce hook. getWidgetVariables() renvoie un tableau vide. En PHP : WebsourceLocale::renderSelector(string $what = 'auto', string $visibility = 'all', bool $forceAssets = false): string.

Gabarits et variables Smarty

• views/templates/hook/selector.tpl, surchargeable dans themes/<thème>/modules/websourcelocale/views/templates/hook/selector.tpl.
• views/templates/hook/suggestion.tpl.

Variables d'un bloc de sélecteur (Front\ViewBuilder) : uid, kind, visibility, align (start ou end), languages, currencies, language_title, currency_title, title, close, trigger_flag, trigger_label, trigger_small, show_flags, style_desktop, style_mobile, globe, language_count, currency_count, dir.

Adresses générées : langue par Link::getLanguageLink() avec attribut hreflang ; devise par lien ?SubmitCurrency=1&id_currency=<id> (Locale\CurrencyUrlBuilder).

Marquage HTML et CSS

Classes : .wslc (+ .wslc--combined, .wslc--up quand le menu s'ouvre vers le haut : pied de page ou place insuffisante dessous), .wslc__toggle, .wslc__label, .wslc__sub, .wslc__caret, .wslc__panel, .wslc__head, .wslc__title, .wslc__close, .wslc__group, .wslc__group-title, .wslc__list, .wslc__option (+ .is-current), .wslc__flag, .wslc__code, .wslc__backdrop, .wslc__sr.

Attributs lus par front.js : data-wslc, data-wslc-close, data-wslc-ready, data-wslc-suggest, data-wslc-text, data-wslc-accept, data-wslc-dismiss.

Variables CSS : --wslc-accent, --wslc-ink, --wslc-bg, --wslc-line, --wslc-radius, --wslc-font, --wslc-tint. Avec « Reprendre le design du thème », elles reprennent --color-* et --radius-* du thème ; sinon Render\StyleBuilder les émet à partir du réglage design.

Témoin

wslc_dismissed = 1, SameSite=Lax, durée suggest_days jours, posé par front.js quand le visiteur répond à la bannière. La langue du navigateur est lue côté navigateur et n'est jamais envoyée au serveur.

Clés de WSLC_SETTINGS

Export / import de thème (section locale, version 1)

ThemePackage\ThemePackage::export() produit les réglages avec les langues et devises exclues converties en codes ISO et les textes indexés par code ISO de langue. À l'import, les données passent par Settings::fromArray() ; modes replace et merge ; rien n'est écrit en dry_run.

Services

WebsourceLocale::services(): Websource\Locale\Services (réglages, identifiant de boutique), shopScope(): array, defaultTexts(): array, upgradeShops(): bool.

Tests fournis

php modules/websourcelocale/tests/run.php (logique pure, sans PrestaShop).