Changelog
26.0.10.0
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.namepour é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 danswp-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 optionsclass,input_class,attributesethelp_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éthodeexecute()retourne maintenant uneCollectiond'objetsPostau lieu d'un tableau brut deWP_Post. Permet d'utiliser directement les méthodes de la façadePostsur chaque résultat. -
Façade
Query— Pagination : Nouvelles méthodespaginate($postsPerPage, $paged)etgetPaged($paged)pour gérer la pagination nativement. Voir documentation. -
Façade
Query—convert(): Nouvelle méthode pour convertir uneWP_Queryexistante 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 retournenullpage(string $slug): Récupère une page admin par son slugroles(): Raccourci vers le service Roles
-
Façade
Post— Constructeur flexible : Le constructeur accepte maintenant\WP_Post|Post|int|null. Ajout du paramètre$isPagepour éviter de charger le contenu sur les pages. -
Façade
Post— Nouvelles méthodes : Ajout detaxonomy(),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é$thumbnailpour compatibilité avec l'ancienne variable globale Twigpage. -
Façade
Taxonomy— Typage fort : La propriété$postTypeest maintenant typéePostType. Ajout de$currentPostpour lier une taxonomy à un post spécifique. -
Façade
Taxonomy— Contexte post : Nouvelles méthodesgetPostTerms(),setCurrentPost(),includeFields(). La méthodegetTerms()accepte un paramètre$includeFields. -
Configuration Vite : Séparation des configs
vite.blocks.config.js(blocs Gutenberg) etvite.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 objetsResponse— Envoi de réponses HTTPYaml— Chargement de configurations YAMLWP,Menu,ArrayHelper,ObjectHelper— Utilitaires divers
-
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()etimagecreatefrompng()avec le namespace global\.
26.0.9.7
Améliorations
- Page admin. : Ajout du service
FlashBagen propriété du parentAdminPagepour que les messages flash soient gérables. Un message est par défaut envoyé lorsque l'ont override pas la méthodepost.
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 classeTaxonomyintègre désormais le traitFields, ce qui permet d'ajouter des champs Carbon Fields directement sur les termes d'une taxonomie viaaddContainerFields(), puis de les enregistrer avec la nouvelle méthoderegisterTaxonomyContainers(). Voir documentation. -
Façade
Taxonomy—register()fluent : la méthoderegister()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éthoderegisterTaxonomyContainers(): raccourci deregisterContainers()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 uneWP_Query. Permet un contrôle total du markup HTML. Voir documentation. -
Fonction Twig
paginate(): nouvelle fonction qui retourne le HTML natif depaginate_links()WordPress. Accepte uneWP_Queryoptionnelle 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$postIdn'est passé en argument. Avant ce correctif, l'ID pouvait ne pas être résolu dans certains contextes (composants isolés, appels hors boucle), retournantfalseou des données erronées.
26.0.9.1
Corrections
- Global Twig
post— injection conditionnelle : la variable globalepostn'est désormais injectée dans le contexte Twig que sur les pages de typesingle. Auparavant, elle était initialisé pour lessingular, ce qui inclus également les posts-type :pageetattachment. 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 documentationhook(). -
Service
twig.hook(Elementum\Services\Twig\Hook) : nouveau service interne qui orchestre le pipeline de hooks Twig. Génère automatiquement un filtre WordPresselm.<hookName>pour chaque composant rendu et chaque appel àhook().register(name, template, args)— enregistre et applique les filtresattach(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 Twigcomponent()passe désormais par le serviceHookavant 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 desargsau 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 viaTwigGlobals::post(), c'est une instance de la façadePost. Disponible uniquement sur les templatessingleetsingular. -
Post::update()/Post::delete(): deux nouvelles méthodes sur la façadePostpour 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'objetwindow.ELEMENTUMinjecté en JavaScript pourmain,themeetchild. -
Boilerplate
colors.yaml: tous les champs sont passés detype: coloràtype: color_contrastavec leurscheck_contrast_colors_idsrespectifs etadd_to_editor: truepour les couleurs de fond. Ajout du champactive: trueau niveau du panneau.
Corrections
-
CLI
new:child— boilerplate incomplet : la commandephp dobby new:childgénérait un thème enfant sanscomposer.json, rendant l'autoload PSR-4 (Elementum\Child\) non fonctionnel. Le boilerplatechildreçoit désormais.gitignore,composer.json,dobby,tsconfig.jsonetvite.config.js. -
Templates— priorité automatique poursingle: le template#[Template('single')]reçoit automatiquement une priorité de100pour laisser la possibilité aux CPT d'utilisersingularsans conflit. -
AppareanceGetters/CustomizeController: tous les appels aux méthodes dépréciées deUtilsremplacés par leurs équivalents dansArrayHelper,ObjectHelperetWP.
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é parmountReactComponent.js.