Articles

Wysiwyg Editor

Description

Le champ Wysiwyg crée un éditeur de contenu WordPress tel qu’on le voit dans les Posts et les Pages. Wysiwyg est un acronyme pour « ce que vous voyez est ce que vous obtenez ».

C’est l’un des champs les plus utiles pour l’édition de contenu car il permet à la fois de modifier et de styliser le texte et le multimédia dans une seule zone.

Captures d’écran

A Wysiwyg field with sample lorem ipsum content
L’interface des champs de l’éditeur Wysiwyg
List of settings available when creating a Wysiwyg field
Les paramètres des champs de l’éditeur Wysiwyg

Changelog

  • Ajout d’options Visuel / Texte pour Tabs dans la version 5.0.0

Paramètres

  • Valeur par défaut
    La valeur par défaut affichée lors de la création d’un nouveau post.

  • Tabs
    Sélectionne les modes affichés à l’utilisateur. Chaque éditeur Wysiwyg contient un mode visuel et un mode texte. Choisissez entre visuel et texte, visuel seulement, ou texte seulement.

  • Toolbar
    Spécifie la barre d’outils à afficher. Choisissez entre Full et Basic. La barre d’outils complète reflète la barre d’outils typique de l’éditeur WordPress avec 2 rangées de boutons. La barre d’outils Basic est une seule rangée minifiée de boutons utiles pour une expérience plus élaguée.

  • Show Media Upload Buttons
    Provise la possibilité de télécharger des médias en ligne dans le champ Wysiwyg.

  • Delay initialization?
    Defers l’initialisation de l’éditeur jusqu’à ce que l’éditeur soit cliqué plutôt qu’au chargement de la page. Ceci est utile pour accélérer les temps de chargement.

Utilisation du modèle

Le champ de l’éditeur Wysiwyg retournera votre contenu formaté pour le HTML de la même manière que le fait the_content().

Affichage de base

Cet exemple démontre comment afficher le contenu d’un champ Wysiwyg.

<?php the_field('product_summary'); ?>

Notes

Le filtre acf_the_content

Lorsque l’on charge la valeur d’un champ Wysiwyg, celle-ci passe par un filtre acf_the_content pour appliquer le formatage HTML. Ce filtre, étroitement basé sur le filtre WordPress the_content, est utilisé à la place pour éviter les problèmes de récursion indésirables.

Si vous utilisez le filtre the_content pour modifier le contenu, assurez-vous de filtrer également acf_the_content.