Le réglage Image vedette pour les campagnes visuelles vous permet d'attribuer une miniature dédiée à chaque campagne depuis le constructeur de campagnes. Cette image est utilisée comme miniature de campagne dans les listes de campagnes, les shortcodes et le partage sur les réseaux sociaux, et remplace la première photo de votre mise en page de campagne lorsqu'elle est définie. Elle est disponible à partir du plugin Charitable Pro 1.8.13+.

Table des matières

• Démarrage
• Exigences
• Où le trouver
• Options de configuration
• Où l'image vedette est utilisée
• Dépannage
• Ressources pour les développeurs

Démarrage

L'image vedette est un réglage au niveau de la campagne dans le constructeur de campagnes Charitable Pro. Lorsque vous définissez une image vedette pour une campagne, elle devient l'image principale affichée chaque fois que cette campagne apparaît dans les grilles, les listes, les shortcodes (par ex. [campaigns]) et lorsqu'elle est partagée sur les plateformes sociales. Si vous ne définissez pas d'image vedette, Charitable utilise la première photo de votre mise en page de campagne (le cas échéant) ou la miniature de l'article WordPress pour les campagnes héritées.

Avantages clés

• Un seul endroit pour définir la miniature de la campagne — Pas besoin de dépendre de l'ordre de la mise en page ; définissez une image qui représente la campagne partout.
• Meilleur contrôle pour le partage sur les réseaux sociaux — Utilisez une image optimisée pour les réseaux sociaux (par ex. 1200 × 630 px) pour que les partages soient cohérents.
• Accessibilité et SEO — Champ de texte alternatif dédié pour les lecteurs d'écran et les moteurs de recherche.
• Image de marque cohérente — Même image sur les boucles de campagne, les shortcodes et les intégrations (par ex. Divi, Elementor).

Exigences

• WordPress : 6.2 ou supérieur
• PHP : 7.4 ou supérieur
• Charitable Pro : 1.8.13 ou supérieur

Le réglage d'image vedette n'est disponible que pour les campagnes modifiées dans le constructeur de campagnes (campagnes non héritées).

Où le trouver

1. Dans l'administration WordPress, allez à Charitable → Campagnes (ou Constructeur de campagnes).
2. Ouvrez ou créez une campagne dans le constructeur de campagnes.
3. Dans la barre latérale gauche, cliquez sur Réglages.
4. Dans le sous-menu Réglages, cliquez sur Image vedette (sous Options de don).

Le panneau Image vedette apparaît dans la zone de contenu principale.

Options de configuration

Téléchargement d'image

• Cliquez pour télécharger ou sélectionner une image — Utilisez la zone de dépôt pour ouvrir la médiathèque ou télécharger une nouvelle image. Vous pouvez également utiliser Remplacer sur un aperçu existant pour choisir une image différente, ou Supprimer / Supprimer l'image pour l'effacer.
• URL de l'image — L'URL de l'image sélectionnée est stockée ; le champ de téléchargement peut être masqué par conception mais est utilisé pour la sauvegarde.
• Télécharger l'image — Bouton alternatif pour ouvrir le sélecteur de médias.

Dimensions recommandées

• 1200 × 630 px — Recommandé pour un affichage optimal dans les grilles de campagnes et le partage sur les réseaux sociaux (par ex. Open Graph). D'autres tailles fonctionnent mais peuvent être recadrées ou mises à l'échelle en fonction de votre thème et des plateformes sociales.

Texte Alternatif

• Objectif : Texte alternatif pour les lecteurs d'écran et le SEO.
• Placeholder : « Décrivez cette image pour l'accessibilité. »
• Comportement : Si vous laissez le texte alternatif vide et que l'image provient de la médiathèque, Charitable peut la remplir automatiquement à partir du texte alternatif de la pièce jointe, le cas échéant.

Où l'image vedette est utilisée

Lorsqu'elle est définie, l'image mise en avant est utilisée comme miniature de la campagne dans :

• Listes et grilles de campagnes — par ex. l'archive des campagnes et les shortcodes comme [campaigns].
• Modèle de boucle de campagne — Le modèle campaign-loop/thumbnail.php affiche la miniature de l'article WordPress lorsqu'elle est définie. Lorsque l'image mise en avant du constructeur de campagne est synchronisée avec la miniature de l'article lors de la sauvegarde, elle apparaît ici.
• Shortcodes — Tous les shortcodes qui affichent les miniatures de campagne (par ex. grille de campagnes, bloc de campagne).
• Partage sur les réseaux sociaux — Lorsque votre thème ou vos plugins utilisent l'image mise en avant/miniature de la campagne pour Open Graph ou des balises meta similaires.
• Constructeurs de pages — Divi et autres intégrations qui affichent les images de campagne utilisent la même source de miniature (par ex. .campaign-thumbnail, .campaign-featured-image img).

Si aucune image mise en avant n'est définie, Charitable utilise la première photo de la mise en page de la campagne, ou l'ancienne image mise en avant WordPress pour les campagnes plus anciennes.

Dépannage

L'image mise en avant ne s'affiche pas sur le frontend

• Enregistrer la campagne — Cliquez sur Enregistrer dans le constructeur de campagne après avoir défini ou modifié l'image mise en avant.
• Vérifier le type de campagne — Le paramètre s'applique aux campagnes modifiées dans le constructeur de campagne. Les anciennes campagnes utilisent l'image mise en avant standard de WordPress dans l'éditeur.
• Cache — Videz le cache du site ou de la page afin que la miniature mise à jour soit visible.
• Substitutions de thème — Si votre thème substitue charitable/campaign-loop/thumbnail.php, assurez-vous qu'il utilise la miniature de la campagne (par ex. get_post_thumbnail_id() ou équivalent).

L'image semble rognée ou de mauvaise qualité

• Utilisez une image d'au moins 1200 × 630px pour les grilles et le partage sur les réseaux sociaux.
• Téléchargez une résolution suffisamment élevée pour les tailles utilisées par votre thème et vos shortcodes (par ex. « medium », « large »).

Le texte alternatif ne s'enregistre pas

• Assurez-vous de cliquer sur Enregistrer après avoir modifié la campagne. Le texte alternatif est stocké avec les paramètres de la campagne et (le cas échéant) peut être synchronisé à partir de la pièce jointe du média si laissé vide.

Ressources pour les développeurs

Données stockées

• Les données de l'image mise en avant sont stockées dans les métadonnées de campagne campaign_settings_v2 sous settings['featured-image'] :
  • featured_image_id — ID de la pièce jointe WordPress.
  • featured_image_url — URL de l'image.
  • featured_image_alt — Texte alternatif.
• Pour afficher dans la boucle de campagnes, l'ID de la pièce jointe de l'image mise en avant peut être synchronisé avec le champ _thumbnail_id du billet lors de la sauvegarde de la campagne (par exemple, via le filtre charitable_campaign_builder_save_campaign_settings ou l'action charitable_builder_save_campaign). Ensuite get_post_thumbnail_id( $campaign_id ) et has_post_thumbnail( $campaign_id ) refléteront l'image mise en avant de la campagne.

Substitution de modèle

• Pour personnaliser la sortie de la miniature de campagne, remplacez le modèle dans votre thème :
  • Copiez wp-content/plugins/charitable-pro/templates/campaign-loop/thumbnail.php
  • vers votre thème : your-theme/charitable/campaign-loop/thumbnail.php.

Hooks et filtres

• Enregistrement du panneau de paramètres — Le panneau Image mise en avant est ajouté à la barre latérale des paramètres du constructeur de campagne via :
  • Filtre : charitable_builder_panels_settings_ (slug du panneau : featured-image).
• Chemin du fichier du panneau — Filtre : charitable_builder_panels_settings_file (utilisé pour charger la classe du panneau Pro).
• Affichage de la miniature — Filtre : charitable_campaign_loop_thumbnail_size pour changer la taille de l'image utilisée dans la boucle de campagne.
• Forcer la miniature mise en avant — Filtre : charitable_campaign_loop_featured_thumbnail pour forcer l'utilisation de l'image mise en avant/miniature dans des contextes spécifiques.

Classes CSS (administration du constructeur de campagne)

• Section du panneau : .charitable-panel-content-section-featured-image
• Carte d'aperçu : .charitable-featured-image-card
• Zone de dépôt : .charitable-featured-image-dropzone
• Actions de superposition : .charitable-featured-image-overlay, .charitable-featured-image-overlay-replace, .charitable-featured-image-overlay-remove

---

Pour une assistance supplémentaire avec le paramètre Image mise en avant, veuillez consulter notre documentation d'assistance ou contacter notre équipe.