docs: ajouter des exemples concrets dans les PHPDoc des shortcodes

[CySSoO]

Motivation

• Faciliter la compréhension et l'utilisation des shortcodes en fournissant des exemples concrets d'appel pour chaque gestionnaire de shortcode et utilitaire lié au moteur de shortcodes.
• Améliorer la maintenabilité et l'onboarding des développeurs en rendant les usages attendus explicites dans la documentation PHP des méthodes.

Description

• Ajout de blocs @example dans les PHPDoc de l'entrée du moteur renderShortcodes et des utilitaires parseShortcodeAttrs et resolveShortcodeArgs dans src/Service/EverblockTools.php.
• Ajout d'un bloc @example pour chaque méthode gérant un shortcode (ex: getProductsByTagShortcode, getEverBlockShortcode, getBestSalesShortcode, getEverMapShortcode, etc.) dans src/Service/EverblockTools.php afin de montrer un appel concret du shortcode correspondant.
• Uniformisation des exemples pour qu'ils soient exploitables directement (format de shortcode, paramètres courants) et amélioration de la lisibilité des PHPDoc autour du moteur de shortcodes.

Testing

• J'ai exécuté la vérification de syntaxe PHP avec php -l src/Service/EverblockTools.php et la commande a indiqué No syntax errors detected, confirmant que les modifications n'introduisent pas d'erreurs de syntaxe.

---

Codex Task