Añade una clase CSS personalizada a tus meta boxes en WordPress

En esta entrada vamos a ver como añadir una clase CSS a los meta boxes de WordPress.

Utilizamos los meta boxes en WordPress para agrupar custom fields, y hacer la gestión de un contenido un poco más ordenada. Cuando haces un desarrollo a medida, normalmente juegas con los meta boxes para ponérselo fácil a un cliente.

En este juego, puedes agruparlos por pestañas, ocultarlos según que rol, asignarlos a un tipo de contenido específico o a una categoría concreta… Si en alguna ocasión te has visto metido en alguna de estas, es probable que hayas necesitado o echado en falta que la función add_meta_box() no incluya entre sus parámetros la opción de asignar una clase.

Recordemos que esta función permite:

add_meta_box(
    string $id,
    string $title,
    callable $callback,
    string|array|WP_Screen $screen = null,
    string $context = 'advanced',
    string $priority = 'default',
    array $callback_args = null
);

donde:

$id: Atributo ID (identificador único del meta box)
$title: El nombre o título que aparecerá en la cabecera del meta box
$callback: La función a la que llamaremos para pintar el contenido del meta box
$screen: La pantalla o pantallas donde aparecerá el meta box
$context: Dónde aparecera el meta box
$priority: Prioridad para mostrar el meta box dentro del contexto
$callback_args: Parámetros que pasaremos a la función de callback

Como verás, podemos asignar un ID, pero no una clase. Y en algunas ocasiones, sobre todo cuando debes gestionar multitud de meta boxes, puede ser muy útil disponer de una clase CSS común a ciertos meta boxes. De este modo podremos «agrupar» varios de ellos con la misma clase, y actuar sobre ella mediante CSS o JavaScript.

Existe un filtro en WordPress, postbox_classes_{$page}_{$id} que nos permite inyectar nuestra propia clase:

<?php

function add_meta_box_classes( $classes = array() ) {
    array_push( $classes, 'my-class' );

    return $classes;
}
add_filter( 'postbox_classes_myposttype_mymetaboxid', 'add_meta_box_classes' );

En este ejemplo, myposttype sería el nombre del post type donde aparece el meta box, y mymetaboxid el identificador que hemos asignado.

Si no quieres añadir tantos filtros como meta boxes tengas, lo ideal es que te crees una clase para administrarlos. Puedes poner en un archivo de configuración toda la información de tus meta boxes. Así, de manera dinámica podrás generarlos y añadirles clases a tu conveniencia.

¿Te ha resultado útil esta información? ☕ 🍺

Puede que también te interese