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

Vue d'ensemble

• Module websourcereassurance, classe WebsourceReassurance, espace de noms Websource\Reassurance (PSR-4 dans src/, autoloader Composer embarqué dans vendor/).
• Implémente PrestaShop\PrestaShop\Core\Module\WidgetInterface (renderWidget, getWidgetVariables).
• Un seul écran d'administration : contrôleur AdminWebsourceReassurance (onglet « Réassurance » sous AdminParentThemes, c'est-à-dire Apparence en PrestaShop 8). getContent() redirige vers ce contrôleur.
• Rendu mis en cache fichier dans var/cache/<env>/websourcereassurance/ (clé : groupe + boutique + langue + surcharges, durée 3600 s) ; vidé à chaque enregistrement, duplication, suppression, et à la désinstallation.

Hooks

Hooks d'affichage greffés

Les hooks sont greffés et dégreffés par boutique par Hook\HookSynchronizer selon les emplacements réellement utilisés (syncAll() à l'installation, sync($shopId) après chaque modification). Un hook libre inconnu de PrestaShop est créé à la volée. Les méthodes hookDisplayXxx manquantes sont servies par __call().

Le type de page est détecté par Placement\PageDetector à partir de php_self du contrôleur : home, category, product, brand (manufacturer), cms, search, login (authentication, password), account (my-account, identity, addresses, history, order-detail…), cart, checkout (order), contact, notfound (pagenotfound).

Hooks techniques greffés

Widget Smarty

{widget name='websourcereassurance' group='demo-b-confiance'}
{widget name='websourcereassurance' group='3'}

Seuls les groupes actifs (active = 1) de la boutique courante sont rendus ; un groupe inconnu ou vide rend une chaîne vide. getWidgetVariables() renvoie un tableau vide : le rendu passe par le template du module.

API PHP

// Rendu d'un groupe actif par identifiant numérique (chaîne vide si inconnu ou module inactif).
echo WebsourceReassurance::renderGroupById(3);

// Avec surcharges : layout box|wide|list, columns 1 à 6, langue.
$module = Module::getInstanceByName('websourcereassurance');
echo $module->renderGroup(3, ['layout' => 'list', 'columns' => 1], (int) $languageId);

Services accessibles via $module->services() (Websource\Reassurance\Services) : groups() (Repository\GroupRepository), items(), images(), views() (Render\GroupViewProvider), cache(), sanitizer(), synchronizer($module), dispatcher(), uploadGuard(), advisor() (contraste WCAG), catalog() (emplacements).

Bloc Websource Builder

Classe Builder\ReassuranceBlock, enregistrée seulement si l'interface Websource\Builder\Block\BlockInterface existe.

Quand un bloc Réassurance est présent sur la page d'accueil du Builder, le module ne regreffe pas displayHome (évite le doublon) ; l'éditeur l'indique.

Contrôleur d'administration (AJAX)

Toutes les actions passent par index.php?controller=AdminWebsourceReassurance&token=…&ajax=1&action=<action> en POST, réponse JSON. Elles exigent un contexte de boutique explicite (sauf keepData) ; sinon réponse d'erreur 400 « Choisissez d'abord une boutique précise ».

Exemple de requête :

POST /admin-xxx/index.php?controller=AdminWebsourceReassurance&token=…&ajax=1&action=toggle
id=3&active=1

Réponse : {"active":true}.

Le payload est nettoyé côté serveur par Group\GroupSanitizer, Design\DesignSanitizer (couleurs par expression régulière stricte, valeurs énumérées) et Url\UrlSanitizer.

Données

Tables (préfixe _DB_PREFIX_)

Les fichiers envoyés sont dans modules/websourcereassurance/uploads/ (protégé par .htaccess, aucune exécution).

Configuration

Mises à jour

upgrade/upgrade-1.1.0.php (colonne urls, réglage global, rebranchement de toutes les boutiques), upgrade-1.2.0.php (forme square → rounded), upgrade-1.3.0.php (hooks d'export/import de thème).

Template et CSS

Template : views/templates/hook/group.tpl, surchargeable dans themes/<theme>/modules/websourcereassurance/views/templates/hook/group.tpl. Variable Smarty assignée : $wsr_view avec les clés identifier, classes, style (attribut style contenant les variables --wsr-*), title, items[] (icon HTML, title, text, url).

Feuille de style : views/css/front.css (mobile d'abord, propriétés logiques, prefers-reduced-motion). Conteneur .wsr, variantes de disposition box, wide, list.

Valeurs « thème » reprises avec repli neutre : --color-brand-600, --color-brand-50, --color-ink, --color-line, --color-surface, --radius-xl, --wst-card-shadow.

Sécurité

Requêtes préparées/échappées ; SVG reconstruits par liste blanche (ni <script>, ni attributs on*, ni javascript:, ni foreignObject, ni référence externe) ; type réel du fichier vérifié ; 1 Mo maximum (200 Ko pour un SVG, 4000 px maximum) ; noms de fichiers aléatoires ; uploads/.htaccess.

Tests

php tests/run.php (sans PrestaShop) : nettoyage SVG, contrôle des images, couleurs et contraste, CSS, liens par langue, traductions, cohérence multiboutique, paquet de thème (tests/themepackage_test.php).