Aller au contenu principal
Version: Next

Changelog

26.0.10.0​

Migration requise

Cette version introduit des changements majeurs nécessitant une migration :

Configuration Vite : La séparation en deux fichiers (vite.frontend.config.js et vite.blocks.config.js) est obligatoire. Suivez le guide de migration Vite.

⚠️ Breaking Changes​

  • Services — Nouvelle convention de nommage : Tous les services Elementum suivent maintenant la convention elementum/service.name pour éviter les conflits avec les services personnalisés. Voir les nouveau noms

Nouveautés​

  • Commande wp:config : Nouvelle commande Dobby pour configurer interactivement les constantes WordPress dans wp-config.php. Supporte 3 types de valeurs (booléen, choix multiple, valeur libre) et formate correctement les valeurs (booléens/nombres sans quotes). Usage : php dobby wp:config. Voir documentation.

  • WP Media Picker : Nouvelle macro Twig forms.media() pour intégrer facilement le composant <wp-media-picker> dans vos formulaires. Support des options class, input_class, attributes et help_text. Voir documentation des macros.

  • Commande make:service : Nouvelle commande Dobby pour générer des squelettes de services avec le pattern Singleton. Usage : php dobby make:service Logger. Voir documentation.

  • Façade Query — Collection : La méthode execute() retourne maintenant une Collection d'objets Post au lieu d'un tableau brut de WP_Post. Permet d'utiliser directement les méthodes de la façade Post sur chaque résultat.

  • Façade Query — Pagination : Nouvelles méthodes paginate($postsPerPage, $paged) et getPaged($paged) pour gérer la pagination nativement. Voir documentation.

  • Façade Query — convert() : Nouvelle méthode pour convertir une WP_Query existante en instance Query. Utile pour travailler avec la query principale WordPress.

Améliorations​

  • Contrôleur — Nouvelles méthodes :

    • getServiceOrFail(string $class) : Récupère un service depuis sa classe ou retourne null
    • page(string $slug) : Récupère une page admin par son slug
    • roles() : Raccourci vers le service Roles
  • Façade Post — Constructeur flexible : Le constructeur accepte maintenant \WP_Post|Post|int|null. Ajout du paramètre $isPage pour éviter de charger le contenu sur les pages.

  • Façade Post — Nouvelles méthodes : Ajout de taxonomy(), chargeTax(), chargeFields(), getField(), getFields() (camelCase), setContent(). Les champs et taxonomies sont maintenant mis en cache.

  • Façade Post — Rétro-compatibilité Twig : Ajout de la propriété $thumbnail pour compatibilité avec l'ancienne variable globale Twig page.

  • Façade Taxonomy — Typage fort : La propriété $postType est maintenant typée PostType. Ajout de $currentPost pour lier une taxonomy à un post spécifique.

  • Façade Taxonomy — Contexte post : Nouvelles méthodes getPostTerms(), setCurrentPost(), includeFields(). La méthode getTerms() accepte un paramètre $includeFields.

  • Configuration Vite : Séparation des configs vite.blocks.config.js (blocs Gutenberg) et vite.frontend.config.js (frontend). Tous les boilerplates (child, plugin, theme) sont mis à jour.

  • Helpers — Nouvelle catégorie de documentation : Ajout d'une section dédiée aux helpers Elementum avec documentation complète pour :

    • Collection — Manipulation immuable de tableaux et objets
    • Response — Envoi de réponses HTTP
    • Yaml — Chargement de configurations YAML
    • WP, Menu, ArrayHelper, ObjectHelper — Utilitaires divers

    Voir documentation des Helpers.

  • Documentation start/ — Restructuration complète : La section "Démarrage" a été entièrement repensée pour mieux guider les utilisateurs :

    • Accueil et parcours recommandés
    • Avantages par rapport à WordPress traditionnel
    • Tour rapide des 10 fonctionnalités principales
    • Architecture 3 couches (Elementum / Plugin / Thème)
    • Guide d'installation pas à pas
    • Parcours personnalisés par profil

    Les anciens fichiers (controllers.md, facades.md, templates.md, customize.md, attributes.md) ont été supprimés pour éviter les doublons.

Corrections​

  • MediaController : Fix des fonctions imagecreatefromjpeg() et imagecreatefrompng() avec le namespace global \.

26.0.9.7​

Améliorations​

  • Page admin. : Ajout du service FlashBag en propriété du parent AdminPage pour que les messages flash soient gérables. Un message est par défaut envoyé lorsque l'ont override pas la méthode post.

Corrections​

  • Plugin : La création de plugin nomme désormais correctement le fichier de point d'entrée du plugin en utilisant le slug.
  • Kernel : Le kernel ne boot maintenant qu'une seule et unique fois. Améliorant les performances et évitant les bugs, notamment avec le service FlashBag.

26.0.9.6​

Améliorations​

  • Façade Taxonomy — champs personnalisés sur les termes : la classe Taxonomy intègre désormais le trait Fields, ce qui permet d'ajouter des champs Carbon Fields directement sur les termes d'une taxonomie via addContainerFields(), puis de les enregistrer avec la nouvelle méthode registerTaxonomyContainers(). Voir documentation.

  • Façade Taxonomy — register() fluent : la méthode register() retourne désormais $this, ce qui permet de chaîner des appels supplémentaires après l'enregistrement (ex. ->register()->addContainerFields(...)).

  • Trait Fields — registerContainers() paramétrable : la méthode accepte désormais deux paramètres optionnels $type (défaut : "post_meta") et $where (défaut : "post_type"), rendant le trait réutilisable dans des contextes autres que les post types.

  • Trait Fields — nouvelle méthode registerTaxonomyContainers() : raccourci de registerContainers() préconfiguré pour les taxonomies (type: "term_meta", where: "term_taxonomy").

  • Fonction Twig fn() / function() — correction interne : la gestion des arguments est maintenant variadic (...$args) côté PHP, ce qui corrige le passage de multiples arguments scalaires. Le comportement visible en Twig reste inchangé.

26.0.9.3​

Nouveautés​

  • Tag Twig {% pagination %} : nouveau tag block qui expose les données de pagination (prev, next, links) dans son corps. Accepte une WP_Query. Permet un contrôle total du markup HTML. Voir documentation.

  • Fonction Twig paginate() : nouvelle fonction qui retourne le HTML natif de paginate_links() WordPress. Accepte une WP_Query optionnelle et des labels personnalisés pour les liens précédent/suivant. Voir documentation.

26.0.9.2​

Corrections​

  • Façade Post — get_field() / get_fields() hors boucle : les deux méthodes utilisent maintenant automatiquement l'ID du post courant lorsqu'aucun $postId n'est passé en argument. Avant ce correctif, l'ID pouvait ne pas être résolu dans certains contextes (composants isolés, appels hors boucle), retournant false ou des données erronées.

26.0.9.1​

Corrections​

  • Global Twig post — injection conditionnelle : la variable globale post n'est désormais injectée dans le contexte Twig que sur les pages de type single. Auparavant, elle était initialisé pour les singular, ce qui inclus également les posts-type : page et attachment. Cela générait une erreur.

26.0.9.0​

Nouveautés​

  • Attribut #[Hook] : nouvel attribut PHP permettant à un contrôleur (thème enfant, plugin) de surcharger le template et les variables d'un composant ou d'un point d'extension Twig, sans modifier le code source du thème. Voir documentation #[Hook].

  • Fonction Twig hook() : nouvelle fonction permettant d'insérer des points d'extension dans les templates Twig. Retourne une chaîne vide si aucun contrôleur n'est attaché. Voir documentation hook().

  • Service twig.hook (Elementum\Services\Twig\Hook) : nouveau service interne qui orchestre le pipeline de hooks Twig. Génère automatiquement un filtre WordPress elm.<hookName> pour chaque composant rendu et chaque appel à hook().

    • register(name, template, args) — enregistre et applique les filtres
    • attach(name, template, callable) — lie un callback à un hook (utilisé par #[Hook])
    • formatName(string) — normalise les noms (/ → .)
    • get(name) / exist(name) — introspection
  • component() — support du hook : la fonction Twig component() passe désormais par le service Hook avant le rendu, ce qui permet de surcharger le template et les variables d'un composant via #[Hook] depuis un thème enfant ou un plugin.

  • component() — passage des args au callback : le callback enregistré sur un composant reçoit désormais les attributs passés à component('name', args) en paramètre.

  • Global Twig post : nouvelle variable globale automatiquement disponible dans les templates singuliers. Injectée via TwigGlobals::post(), c'est une instance de la façade Post. Disponible uniquement sur les templates single et singular.

  • Post::update() / Post::delete() : deux nouvelles méthodes sur la façade Post pour mettre à jour (wp_update_post) ou supprimer (wp_delete_post) le post courant.

  • ObjectHelper::toArray(object): array : nouvel utilitaire de conversion d'objet en tableau associatif.

  • Nouveaux helpers extraits de Utils :

    • Elementum\Helpers\WP — méthodes utilitaires WordPress (isCustomizePreview(), getActionsFired()).
    • Elementum\Helpers\Menu — logique de construction de l'arbre de menu (getMenuByLocation(), getMenuTreeByLocation()).
    • Elementum\Helpers\ArrayHelper — utilitaires tableaux/objets (toObject(), flatObject()).
    • Elementum\Helpers\ObjectHelper — utilitaires objets (flatObject(), toArray()).
  • AssetsController::localize() — sécurité : la propriété path (chemin serveur absolu) est désormais exclue de l'objet window.ELEMENTUM injecté en JavaScript pour main, theme et child.

  • Boilerplate colors.yaml : tous les champs sont passés de type: color à type: color_contrast avec leurs check_contrast_colors_ids respectifs et add_to_editor: true pour les couleurs de fond. Ajout du champ active: true au niveau du panneau.

Corrections​

  • CLI new:child — boilerplate incomplet : la commande php dobby new:child générait un thème enfant sans composer.json, rendant l'autoload PSR-4 (Elementum\Child\) non fonctionnel. Le boilerplate child reçoit désormais .gitignore, composer.json, dobby, tsconfig.json et vite.config.js.

  • Templates — priorité automatique pour single : le template #[Template('single')] reçoit automatiquement une priorité de 100 pour laisser la possibilité aux CPT d'utiliser singular sans conflit.

  • AppareanceGetters / CustomizeController : tous les appels aux méthodes dépréciées de Utils remplacés par leurs équivalents dans ArrayHelper, ObjectHelper et WP.

Internes​

  • ControllerResolver : ajout du scan et de l'enregistrement de l'attribut #[Hook] (registerHook()) dans la boucle de résolution des contrôleurs.
  • Suppression de assets/src/Hooks/mountCustomizeField.js, remplacé par mountReactComponent.js.