@wordpress/commands

@wordpress/commands fournit les primitives JavaScript servant à enregistrer des commandes dans la palette de l'éditeur. Son emploi dépend des mécanismes et composants disponibles sur le site WordPress.

Comprendre et utiliser

À quoi sert ce terme ?

@wordpress/commands fournit les primitives JavaScript servant à enregistrer des commandes dans la palette de l'éditeur. Son utilité concrète est de ajouter une action pour ouvrir le guide documentaire interne. Cette approche permet de cibler le bon composant et de définir le comportement attendu avant de modifier le code ou la configuration.

Fonctionnement technique

Les interfaces modernes d’édition WordPress combinent des blocs, des données enregistrées dans WordPress et des composants JavaScript. Les modèles, compositions, styles et vues suivent des règles différentes de modification, de synchronisation et de persistance. Dans le cas de « @wordpress/commands », la responsabilité particulière est de fournit les primitives JavaScript servant à enregistrer des commandes dans la palette de l'éditeur. Distinguer la valeur déclarée du comportement réellement observé permet d’éviter des conclusions erronées.

Dans quel contexte l’utiliser ?

Situation professionnelle : Ajouter une action pour ouvrir le guide documentaire interne. Repérer le contenu concerné, les droits de l’utilisateur et le résultat à mesurer. Ne pas étendre le changement à l’ensemble du site sans justification.

Exemple technique commenté

Extrait pédagogique dans personnalisation et administration éditoriale, pour ajouter une action pour ouvrir le guide documentaire interne. Identifier le fichier d’intégration et les dépendances avant toute adaptation ; les noms ATOOLPHA sont illustratifs. Une modification visuelle enregistrée par l’utilisateur peut prévaloir sur la définition provenant du thème. Il faut identifier la source effective avant d’écraser un modèle ou d’attribuer à tort un défaut au Core. Le code montré est un fragment explicatif et peut dépendre de déclarations, hooks, imports ou fichiers non reproduits.

import { useCommand } from '@wordpress/commands';

Décryptage de l’exemple

L’extrait montre le point d’entrée technique par lequel on peut fournit les primitives JavaScript servant à enregistrer des commandes dans la palette de l'éditeur. Il n’inclut pas forcément la déclaration du composant, le hook ou le traitement d’erreur : ces parties dépendent du projet réel.

Résultat attendu

Résultat recherché : ajouter une action pour ouvrir le guide documentaire interne. Le résultat n'est pas déclaré testé : il reste à observer dans une installation WordPress compatible.

Mise en pratique et vérification

Sur un site de test : ajouter une action pour ouvrir le guide documentaire interne. Essayer un cas normal et un cas limite, puis comparer le résultat observé au comportement annoncé. La vérification critique est : les commandes doivent rester contextualisées et contrôler les autorisations nécessaires.

Précautions et erreurs fréquentes

Point de vigilance : les commandes doivent rester contextualisées et contrôler les autorisations nécessaires. En cas d’écart, examiner le contexte d’exécution, la version de WordPress et les messages de la console ou des journaux PHP avant de modifier la configuration.

À ne pas confondre

Ne pas confondre un modèle, une composition synchronisée et un réglage de style : leur portée et leur historique de modification ne sont pas identiques.

Diagnostic avancé

Créer une configuration de référence dans un site de test, modifier uniquement l’élément concerné, vérifier la persistance puis documenter le moyen de revenir à l’état initial. En cas de divergence, contrôler cette limite : les commandes doivent rester contextualisées et contrôler les autorisations nécessaires.

Architecture et maintenance

Un choix de l’éditeur peut être stocké en base et masquer les fichiers fournis par le thème. Lors d’une maintenance, contrôler la priorité des personnalisations et les éventuelles révisions avant de conclure à une défaillance du modèle. Pour cette notion, documenter les préconditions, les dépendances et la solution de repli lorsque l’API n’est pas disponible.