Personalizar las columnas en el backend y búsqueda por campos personalizados

Con el siguiente ejemplo de código vamos a ver cómo añadir columnas en el navegador de posts de los tipos de post personalizados, así como extender la búsqueda para que busque por todos los campos.

Cuando creamos un tipo personalizado de post (CPT: Custom Post Type) es muy habitual usar el plugin Advanced Custom Fields para crear campos personalizados. Cuando naveguemos por los diferentes posts, vamos a observar que los campos personalizados no aparecen en la tabla de campos, como podemos ver en la siguiente imagen:

Y realmente lo que deseamos es que sí aparezcan, como podemos ver en la siguiente imagen:

Añadir columnas con los tipos de datos personalizados

Para resolverlo, vamos a necesitar el siguiente código (podemos darlo de alta en el plugin Code Snippets o editar el fichero functions.php):

add_filter( 'manage_TIPOPOST_posts_columns', 'personalizar_columnas' );
function personalizar_columnas( $columns ) {
    $columns = array(
      'cb' => $columns['cb'],
      'title' => __( 'Title' ),
      'campo_personalizado' => __( 'Campo personalizado' ),
      'date' => __( 'Fecha', 'smashing' ),
    );
  return $columns;
}

add_action( 'manage_TIPOPOST_posts_custom_column', 'personalizar_contenidos', 10, 2);
function personalizar_contenidos( $column, $post_id ) {
  switch ($column)
  {
    case 'campo_personalizado':
      echo get_field( 'campo_personalizado', $post_id );
      break;
  }
}

Añadir los tipos de datos personalizados a los resultados de búsqueda del Backend

Mediante el siguiente código, vamos a ver cómo añadir los contenidos de los campos personalizados de los diferentes posts a los resultados de búsqueda:

function cf_search_join( $join ) {
    global $wpdb;

    if ( is_search() ) {    
        $join .=' LEFT JOIN '.$wpdb->postmeta. ' ON '. $wpdb->posts . '.ID = ' . $wpdb->postmeta . '.post_id ';
    }

    return $join;
}
add_filter('posts_join', 'cf_search_join' );

function cf_search_where( $where ) {
    global $pagenow, $wpdb;

    if ( is_search() ) {
        $where = preg_replace(
            "/(s*".$wpdb->posts.".post_titles+LIKEs*('[^']+')s*)/",
            "(".$wpdb->posts.".post_title LIKE $1) OR (".$wpdb->postmeta.".meta_value LIKE $1)", $where );
    }

    return $where;
}
add_filter( 'posts_where', 'cf_search_where' );

function cf_search_distinct( $where ) {
    global $wpdb;

    if ( is_search() ) {
        return "DISTINCT";
    }

    return $where;
}
add_filter( 'posts_distinct', 'cf_search_distinct' );

Vídeotutorial explicativo

En el siguiente vídeotutorial, muestro un ejemplo de cómo montar este sistema sobre un WordPress real:

Resumen del vídeo

Cuando usáis WordPress como una pequeña base de datos, con tipos de contenido y campos propios, enseguida echáis de menos dos cosas en el escritorio: ver esos datos en el listado y poder buscar por ellos. Por defecto, el listado solo muestra título y fecha, y el buscador no consulta los campos personalizados. Vamos a ver cómo añadir columnas personalizadas en WordPress y extender la búsqueda a esos campos, con un ejemplo de un catálogo de libros.

1. Crear el tipo de contenido con CPT UI

Con el plugin Custom Post Type UI se crea un tipo de contenido con el identificador libro en minúsculas y las etiquetas «Libros» y «Libro». Hay muchas más opciones, pero para el ejemplo no hace falta tocarlas. Al crearlo aparece en el menú, aunque al añadir un libro solo tenemos título y editor.

2. Añadir campos con Advanced Custom Fields

Con Advanced Custom Fields, en su versión gratuita, se crea un grupo de campos «Libros» con tres campos: autor, número de páginas e ISBN. En la ubicación se indica que se muestre cuando el tipo de contenido sea igual a libro. A partir de ahí, al crear un libro (por ejemplo, Lazarillo de Tormes, autor anónimo) ya podéis rellenar esos datos.

El problema aparece en el listado: no se ve el autor, ni las páginas, ni el ISBN, y si buscáis un ISBN no aparece ningún resultado.

3. Columnas personalizadas en WordPress con Code Snippets

Para añadir código PHP sin tocar el tema se usa Code Snippets, un plugin gratuito de total confianza. Se crea un fragmento «Personalizado de columnas de los libros» con dos partes:

  • Un filtro que define la cabecera de la tabla: aquí se indica el tipo de contenido (libro) y cada columna con su clave interna, que debe coincidir con el nombre del campo en ACF (en minúsculas), y el texto visible, que puede llevar mayúsculas y tildes.
  • Una acción que pinta el contenido de cada celda, con un case por cada campo (autor, número de páginas e ISBN).

El fragmento se configura para ejecutarse solo en el área de administración. Con la primera parte ya aparecen las columnas vacías; con la segunda, se rellenan con los datos de cada libro.

4. Extender la búsqueda a los campos personalizados

Un segundo fragmento, «Extender búsqueda a custom fields», modifica la consulta del buscador del escritorio para que también busque en los metadatos. También se ejecuta solo en administración. Tras activarlo, buscar «1234» encuentra el libro por su ISBN, y un valor inexistente no devuelve resultados, como es lógico.

Coste cero y una recomendación

Todo esto se hace con plugins gratuitos. Aun así, si usáis ACF con frecuencia, os recomiendo su versión de pago: es un plugin que hace un trabajo fantástico y merece el apoyo. Esta técnica es ideal para catálogos, directorios o cualquier proyecto donde el equipo necesite localizar y revisar registros rápidamente desde el escritorio.

Quizá te interese...
Taller en directo · 1 h 35 min Deja de decirle «hazme un plugin» a la IA Cómo abordar el desarrollo de plugins para WordPress con inteligencia artificial de forma ordenada, documentada y mantenible, usando OpenSpec y Claude Code. Durante años, hacer desarrollo a medida sobre WordPress significaba elegir entre dos males: pagar muchas horas […]
Deja un comentario...
Suscribirme
Notificación de
guest
0 Comentarios