1. Rôle du module
Le module transforme vos pages CMS en un blog simple. Vous rédigez un article comme une page ordinaire dans Apparence → Pages, vous activez Article de blog et vous ajoutez ce dont un article a besoin : une image, un court extrait, une date de publication, un auteur, la mise « à la une », des catégories de produits et des produits associés.
Les articles s’affichent ensuite sous forme de cartes — image, titre, date et extrait — sur la page d’accueil et sur les fiches des produits qu’ils concernent. La page de l’article affiche l’image, la date et l’auteur au-dessus du texte et les produits associés en dessous, et indique aux moteurs de recherche qu’il s’agit d’un article de blog.
Les pages ordinaires, comme vos conditions de vente, ne changent pas : seules les pages avec Article de blog activé apparaissent dans les listes.
Compatible avec PrestaShop 1.7.8, 8.x et 9.x (PHP 7.2.5 ou plus récent), avec les thèmes Classic et Hummingbird et avec le mode multiboutique.
2. Installation
- Téléchargez le module depuis Mon compte → Historique des commandes sur addonspresta.com.
- Dans votre back-office, ouvrez Modules → Gestionnaire de modules et cliquez sur Installer un module.
- Déposez le fichier
ap_cms2blog_v1.0.1.zipet attendez la confirmation. - Cliquez sur Configurer sur la carte du module et vérifiez les réglages.
Si vous avez un accès à la ligne de commande, vous pouvez aussi décompresser l’archive dans modules/ et lancer
php bin/console prestashop:module install ap_cms2blog depuis le dossier de la boutique.
3. Fonctionnement
Les champs du blog s’ajoutent en bas du formulaire des pages CMS, dans une section Article de blog. Tant qu’Article de blog est désactivé, les autres champs de la section restent masqués.
Un article apparaît dans les listes quand Article de blog est activé, que la page est affichée et associée à la boutique, et que sa date de publication est aujourd’hui ou antérieure. Un article daté dans le futur est programmé : il rejoint les listes ce jour-là. Sa page reste accessible par son adresse, comme toute page CMS affichée.
Sur la page d’accueil, le module affiche d’abord les articles à la une, puis les plus récents. Sur une fiche produit, il affiche d’abord les articles liés à ce produit, puis ceux liés à l’une de ses catégories (n’importe quelle catégorie du produit, pas seulement la principale).
Les images envoyées sont enregistrées dans le dossier img/ap_cms2blog/ de la boutique. Le module garde l’image en 2400 pixels de large au
maximum, sans les métadonnées de la photo (appareil, position GPS), et en tire deux versions : une miniature recadrée depuis le centre à la taille choisie (pour les cartes)
et une version de 1200 pixels de large au maximum (pour la page de l’article).
Les cartes et la page de l’article reprennent les polices, les couleurs et les titres de votre thème. Le module ne se connecte ni à addonspresta.com ni à aucun autre serveur.
4. Fonctions et réglages
Champs du blog d’une page
Ouvrez Apparence → Pages, ajoutez une page ou modifiez-en une, puis descendez jusqu’à la section Article de blog.
- Article de blog — place la page dans les listes d’articles.
- Image de l’article — un fichier JPG, PNG ou WebP de 8 Mo et 25 mégapixels au maximum. Une photo large convient le mieux, car la miniature est recadrée depuis le centre. Une nouvelle image remplace la précédente ; Supprimer l’image actuelle la retire.
- Extrait — quelques phrases pour les cartes, rédigées dans le même éditeur que le contenu de la page, dans chaque langue de la boutique. Une langue sans extrait affiche la carte sans extrait.
- Date de publication — la date affichée sur l’article. Aujourd’hui par défaut ; une date future programme l’article.
- Auteur — affiché à côté de la date. Une nouvelle page reçoit le nom de l’employé qui la rédige.
- À la une — les articles à la une passent en premier sur la page d’accueil et sur les fiches produit.
- Catégories de produits — l’article apparaît sur les fiches des produits des catégories cochées.
- Produits associés — saisissez au moins deux lettres du nom d’un produit, sa référence ou son ID, puis choisissez le produit dans la liste. Les produits s’affichent sous l’article dans l’ordre choisi, et l’article apparaît sur leurs fiches. La croix retire un produit.
Page de configuration
Ouvrez Modules → Gestionnaire de modules → Blog CMS → Configurer. Le cadre Aide, en haut, renvoie à ce manuel et à la page du module sur addonspresta.com, dans la langue de votre back-office, et indique l’adresse d’assistance et la version du module.
Miniatures
- Largeur des miniatures et Hauteur des miniatures — la taille des images des cartes, de 50 à 2000 pixels (600 × 400 par défaut). Si vous changez la taille et enregistrez, toutes les miniatures sont refaites à partir des images d’origine.
Listes d’articles
- Articles sur la page d’accueil — le nombre d’articles affichés (3 par défaut). 0 masque la section.
- Articles sur les fiches produit — sous la description du produit, dans un onglet « Articles associés » ou nulle part.
- Nombre d’articles sur les fiches produit — de 1 à 24 (3 par défaut).
- Aussi les articles des catégories du produit — une fois désactivé, la fiche produit n’affiche que les articles liés à ce produit.
Page de l’article
- Image, date et auteur au-dessus du contenu — une fois désactivé, la page de l’article n’affiche que le texte.
- Produits associés sous le contenu — les produits choisis dans l’article, sous forme de cartes produit de votre thème. Les produits désactivés ou masqués du catalogue sont ignorés.
5. Multiboutique
Les réglages des sections Listes d’articles et Page de l’article sont enregistrés pour la boutique ou le groupe de boutiques choisi dans l’en-tête du back-office : chaque boutique peut afficher un nombre d’articles différent ou les placer ailleurs. La taille des miniatures s’applique à toutes les boutiques, car les images sont partagées. Seul un employé qui gère toutes les boutiques peut la modifier. Dans le contexte Toutes les boutiques ou groupe, seul un employé qui gère toutes ses boutiques peut enregistrer.
L’extrait suit le contenu de la page : il est enregistré pour les boutiques choisies dans l’en-tête au moment où vous enregistrez la page. Les autres champs du blog (interrupteurs, date, auteur, image, catégories, produits) sont les mêmes dans toutes les boutiques. Un article n’apparaît que dans les boutiques associées à la page CMS. Si vous créez une boutique en important les données du module depuis une boutique existante, les extraits sont copiés aussi. Une seule licence couvre toutes les boutiques de l’installation.
6. Désinstallation
Gestionnaire de modules → Blog CMS → Désinstaller supprime les réglages du module, ses tables et le dossier
img/ap_cms2blog/. Les champs du blog et les images de tous les articles sont perdus ; les pages CMS restent, comme
pages ordinaires. Pour garder les données, utilisez plutôt Désactiver.
7. Questions fréquentes et dépannage
Mon article n’apparaît pas sur la page d’accueil.
Vérifiez qu’Article de blog est activé, que la page est affichée et associée à la boutique, et que la date de
publication n’est pas dans le futur. Vérifiez ensuite Articles sur la page d’accueil dans la configuration :
0 masque la section. Si votre thème n’a pas de position displayHome, la section ne peut pas s’afficher.
L’article n’apparaît pas sur une fiche produit. L’article doit être lié à ce produit dans Produits associés ou à l’une de ses catégories dans Catégories de produits (avec Aussi les articles des catégories du produit activé). Vérifiez aussi que Articles sur les fiches produit n’est pas réglé sur Ne pas afficher.
L’image est refusée à l’enregistrement de la page. Utilisez un fichier JPG, PNG ou WebP de 8 Mo et 25 mégapixels au maximum (par exemple 6000 × 4000 pixels). Le WebP ne fonctionne que si la bibliothèque d’images de votre serveur le prend en charge ; la liste des formats acceptés figure sous le champ.
Les miniatures sont mal cadrées. Les miniatures sont recadrées depuis le centre. Envoyez une image dont le sujet est au milieu, ou choisissez une taille de miniature aux mêmes proportions que vos photos.
L’extrait n’est pas enregistré et un message parle de HTML non autorisé.
L’extrait suit les mêmes règles que le contenu de la page : pas de scripts ni de liens javascript:, des iframes
seulement si Paramètres de la boutique → Générales les autorise. Retirez le code collé dans l’éditeur.
Un texte reste en anglais dans ma boutique en français ou en polonais. Ouvrez International → Traductions → Traductions des modules installés, choisissez le module et votre langue, puis vérifiez la traduction. Les extraits se traduisent dans le formulaire de la page.
8. Mises à jour et assistance
Les mises à jour sont gratuites à vie : téléchargez les nouvelles versions depuis Mon compte → Historique des commandes sur addonspresta.com et installez-les comme un nouveau module. Vos articles et vos réglages sont conservés.
L’assistance est incluse pendant 12 mois à compter de la commande : écrivez à mail@addonspresta.com ou utilisez le formulaire de contact d’addonspresta.com (du lundi au vendredi, de 10 h à 16 h ; réponse généralement sous 2 jours ouvrés). Indiquez votre version de PrestaShop, la version du module et les étapes qui mènent au problème.