{"id":5366,"date":"2015-08-22T00:23:14","date_gmt":"2015-08-21T22:23:14","guid":{"rendered":"https:\/\/www.creativejuiz.fr\/blog\/?p=5366"},"modified":"2016-01-13T13:22:13","modified_gmt":"2016-01-13T12:22:13","slug":"editer-le-texte-et-lemplacement-de-la-metabox-image-a-la-une","status":"publish","type":"post","link":"https:\/\/www.creativejuiz.fr\/blog\/wordpress\/editer-le-texte-et-lemplacement-de-la-metabox-image-a-la-une","title":{"rendered":"\u00c9diter le texte et l’emplacement de la metabox \u00ab\u00a0Image \u00e0 la Une\u00a0\u00bb"},"content":{"rendered":"

\u00c0 chaque projet web utilisant WordPress, il m’arrive de cr\u00e9er des Types de Post Personnalis\u00e9s (Custom Post Type<\/em>) et d’utiliser l’Image \u00e0 la Une (Featured Image<\/em> en anglais) pour illustrer joliment le contenu des publications faites par ce biais. Mais Image \u00e0 la Une<\/strong> n’est pas tr\u00e8s parlant en dehors d’un contexte \u00ab\u00a0blog\u00a0\u00bb ou \u00ab\u00a0magazine\u00a0\u00bb.<\/p>\n

R\u00e9cemment j’ai encore eu besoin de changer le nom et l’emplacement de la metabox Featured Image<\/em>, mais j’ai \u00e9galement eu envie d’aller plus loin dans la personnalisation des textes y \u00e9tant li\u00e9s.<\/p>\n

Cet article a \u00e9t\u00e9 mis \u00e0 jour pour proposer \u00e9galement une solution apr\u00e8s la version 4.3 de WordPress.<\/p>\n

\u00c9diter les textes \u00ab\u00a0Image \u00e0 la Une\u00a0\u00bb<\/h2>\n

Avant la version 4.3 de WordPress<\/h3>\n

Voici un bout de code que j’ai utilis\u00e9 pour un plugin, mais vous pouvez parfaitement le placer dans le fichier functions.php<\/code> de votre th\u00e8me si vous pr\u00e9f\u00e9rez.<\/p>\n

<?php\r\nif ( is_admin() ) {\r\nadd_filter( 'gettext', 'juiz_mb_featured', 20, 3 );\r\nfunction juiz_mb_featured( $translated_text, $text, $domain ) {\r\n\tglobal $pagenow;\r\n\u00a0\r\n\tif ( isset( $pagenow ) && ( $pagenow === 'post.php' || $pagenow === 'post-new.php' ) ) {\r\n\r\n\t\t$post_type = ( $pagenow === 'post-new.php' && isset( $_GET['post_type'] ) ) ? $_GET['post_type'] : null;\r\n\t\t$post = ( $pagenow === 'post.php' && isset( $_GET['post'] ) ) ? get_post( intval( $_GET['post'] ) ) : null;\r\n\u00a0\r\n\t\tif (\r\n\t\t\t( isset( $post->post_type ) && $post->post_type === 'event' )\r\n\t\t\t||\r\n\t\t\t( isset( $post_type ) && $post_type === 'event' )\r\n\t\t) {\r\n\u00a0\r\n\t\t\tswitch ( $text ) {\r\n\t\t\t\tcase 'Remove featured image':\r\n\t\t\t\t$translated_text = __( 'Remove event image', 'juiz' );\r\n\t\t\t\tbreak;\r\n\u00a0\r\n\t\t\t\tcase 'Set featured image':\r\n\t\t\t\t$translated_text = __( 'Set this image', 'juiz' );\r\n\t\t\t\tbreak;\r\n\u00a0\r\n\t\t\t\tcase 'Featured Image':\r\n\t\t\t\t$translated_text = __( 'Event Image', 'juiz' );\r\n\t\t\t\tbreak;\r\n\t\t\t}\r\n\r\n\t\t}\r\n\u00a0\t}\r\n\u00a0\r\n\treturn $translated_text;\r\n}\r\n}\r\n?><\/code><\/pre>\n
J’utilise le filtre gettext<\/code> pour v\u00e9rifier les cl\u00e9s des textes traductibles dans WordPress (les textes en anglais sont les cl\u00e9s), et d\u00e8s que je tombe sur celles qui m’int\u00e9ressent (les diff\u00e9rents cas du switch) je change le texte de sortie pour les adapter \u00e0 mon contexte. Si vous souhaitez traduire d’autres textes, l’id\u00e9al est de passer votre administration WordPress en anglais pour trouver les bonnes cl\u00e9s.<\/p>\n
Ici je fais ce changement uniquement lorsque je me trouve dans mon Type de Post \u00ab\u00a0Event\u00a0\u00bb qui est un poste utilis\u00e9 pour la publication d’\u00e9v\u00e9nements. Mais ce n’est qu’un exemple.<\/p>\n
Je contr\u00f4le tr\u00e8s pr\u00e9cis\u00e9ment o\u00f9 je me trouve dans l’administration gr\u00e2ce \u00e0 la variable globale $pagenow<\/code> car le filtre gettext<\/code> intervient vraiment partout dans WordPress, il faut donc \u00eatre tr\u00e8s pr\u00e9cis.<\/p>\n
Attention, le filtre gettext<\/code> intervient vraiment sur toutes les cha\u00eenes traductibles, essayez toujours de cibler pr\u00e9cis\u00e9ment la page d’admin concern\u00e9e.<\/p>\n
\"Julio
Ma metabox avec les textes \u00e9dit\u00e9s
et Julio Potier au WordCamp Lyon 2015<\/figcaption><\/figure>\n
Depuis WordPress 4.3<\/h3>\n
Depuis la version 4.3 de WordPress, les d\u00e9veloppeurs du c\u0153ur ont ajout\u00e9 des possibilit\u00e9 d’\u00e9dition de ces textes directement dans la d\u00e9claration d’un custom-post-type<\/em>, qui se fait avec la fonction register_post_type( $args )<\/a><\/code>.<\/p>\n
<?php\r\n$labels = array(\r\n\t'name' => __( 'Events', 'juiz' ),\r\n\t\/\/ etc...\r\n \t'featured_image' => __( 'Logo Event', 'juiz' ),\r\n \t'set_featured_image' => __( 'Add a logo event', 'juiz' ),\r\n \t'remove_featured_image' => __( 'Remove that logo event', 'juiz' )\r\n);\r\n\r\n$args = array(\r\n \t'public' => true,\r\n \t'labels' => $labels,\r\n\t\/\/ etc...\r\n);\r\n\r\nregister_post_type( 'events', $args );\r\n?><\/code><\/pre>\n
C’est la partie concernant les labels qui nous int\u00e9resse, mais je vous mets une mini d\u00e9claration compl\u00e8te. Les trois entr\u00e9es qui nous int\u00e9ressent sont featured_image<\/code>, set_featured_image<\/code> et remove_featured_image<\/code>.<\/p>\n
Changer l’emplacement de la metabox \u00ab\u00a0Image \u00e0 la Une\u00a0\u00bb<\/h2>\n
Pour une autre utilisation, j’avais besoin de mettre en \u00e9vidence la photo du post et la placer dans la colonne principale. Je garde le slug pr\u00e9c\u00e9dent \u00ab\u00a0event\u00a0\u00bb, m\u00eame si mon besoin \u00e9tait dans un autre contexte. Ce sera plus simple pour vous.<\/p>\n
<?php\r\nadd_action( 'add_meta_boxes_event', 'juiz_event_add_mb' );\r\nfunction juiz_event_add_mb() {\r\n\u00a0\r\n\t\/\/ Retirer la box existante\r\n\tremove_meta_box('postimagediv', 'event', 'side');\r\n\u00a0\r\n\t\/\/ Placer la n\u00f4tre, la nouvelle\r\n\tadd_meta_box(\r\n\t\t'postimagediv',\r\n\t\t__( 'Event Picture', 'juiz' ),\r\n\t\t'post_thumbnail_meta_box',\r\n\t\t'event', \/\/ votre slug de custom-post-type\r\n\t\t'normal', \/\/ 'normal', 'side', 'advanced'\r\n\t\t'high' \/\/ 'high', 'core', 'default', 'low'\r\n\t);\r\n}\r\n?><\/code><\/pre>\n
Le hook utilis\u00e9 ici est add_meta_boxes_{$post_type}<\/code>, c’est \u00e0 dire que le hook se compose du slug de votre Custom Post Type. Ici pour moi c’est \u00ab\u00a0event\u00a0\u00bb, ce qui donne le hook que vous voyez en deuxi\u00e8me ligne. Cette composition du nom du hook vous permet de n’intervenir que sur les metaboxes<\/em> de votre Type de Posts.
\nPour mieux comprendre ce qui est attendu en param\u00e8tres de la fonction add_meta_box()<\/code>, je ne peux que vous inviter \u00e0 lire le Codex \u00e0 ce sujet<\/a>.
\nL’important est de conserver le param\u00e8tre 1 et 3, vous pouvez changer les autres \u00e0 votre convenance.<\/p>\n
C’est tout pour cette petite astuce WordPress.
\n\u00c0 bient\u00f4t et bonne personnalisation !<\/p>\n","protected":false},"excerpt":{"rendered":"
\u00c0 chaque projet web utilisant WordPress, il m’arrive de cr\u00e9er des Types de Post Personnalis\u00e9s (Custom Post Type) et d’utiliser l’Image \u00e0 la Une (Featured Image en anglais) pour illustrer joliment le contenu des publications faites par ce biais. Mais Image \u00e0 la Une n’est pas tr\u00e8s parlant en dehors d’un contexte \u00ab\u00a0blog\u00a0\u00bb ou \u00ab\u00a0magazine\u00a0\u00bb.<\/p>\n","protected":false},"author":4,"featured_media":5373,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_bluesky_dont_syndicate":"","_bluesky_syndication_accounts":"","_bluesky_syndication_text":"","footnotes":""},"categories":[13],"tags":[228,471,594],"coauthors":[597],"class_list":["post-5366","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-wordpress","tag-astuce","tag-metabox","tag-traduction"],"acf":[],"aioseo_notices":[],"aioseo_head":"\n\t\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\t