Metadatos y Custom Fields en WordPress (2/3). Plugin Types

Y aquí estamos con la segunda parte de esta serie de tres sobre los Custom Fields en WordPress. Tal como os comentaba en la anterior entrada sobre Custom Fields en esta segunda parte hablaría sobre los metadatos haciendo uso de un plugin.

Este plugin lo estoy usando actualmente para ahorrarme tiempo de programación en las webs que estoy realizando.

Types – Custom Fields and Custom Post Types Management.

Instalación y Configuración

Una vez nos descargamos el plugin desde el enlace anterior tenemos que instalarlo en nuestro WordPress, para ello, debéis copiar la carpeta del plugin en la carpeta plugins dentro de wp-content->plugins y al entrar a nuestro apartado de plugins en el panel de administración de WordPress tendremos que activarlo.

Con esto nos aparecerá en nuestro menú de administración una nueva pestaña llamada Types con un submenú que incluye los siguientes elementos:

• Campos personalizados: Desde aquí podemos añadir custom fields y grupos de ellos a nuestros posts o tipos de posts personalizados.
• User fields: Podemos añadir custom fields a los usuarios por defecto de WordPress.
• Taxonomías y tipos personalizados: Para crear tipos de post y taxonomías personalizadas.
• Importar / Exportar: Literal 🙂 Podemos exportar e importar configuraciones del plugin.
• Control de campos personalizados: Se nos muestra una lista de aquellos custom fields tanto controlados por el plugin como creados por otros o por nosotros mismos a través de programación.
• User Fields Control: Como en el caso anterior, pero referente a los usuarios de WordPress.
• Configuración: Acceder a parámetros de configuración generales del plugin.
• Control de acceso y roles de usuario: Configurar el control de acceso al plugin.
• Ayuda: Enlaces a ayuda sobre el uso y programación con el plugin.

Vamos a volver sobre el ejemplo de Actividad, el Custom Post que creamos en los posts relacionados con este tema. En este caso vamos a ver los diferentes tipos campos que el plugin nos permite crear y como hacerles referencia desde la plantilla, no entraremos más allá de los campos personalizados pues no es el objetivo de esta entrada.

Yendo a la parte de Campos Personalizados podemos crear un nuevo grupo de campos abriéndose el siguiente panel que paso a comentar.

Como se puede ver es todo bastante intuitivo.

1. Configuración del grupo: Donde indicamos su título y su descripción, luego veremos donde sale.
2. Visualización del grupo: Podemos indicar que los grupos de campos personalizados se asocien a tipos de entradas y taxonomías concretas o a templates en particular.
3. CSS Personalizado: Nos servirá para personalizar el estilo de los campos en nuestro panel de administración.
4. Tipos de campos disponibles: Podemos ver una lista de todos los tipos de campos que se pueden crear, como se puede observar tenemos una gran variedad y algunos de ellos bastante avanzados.

Cuando pulsamos sobre alguno de los tipos de campos disponibles se nos añade al grupo y tenemos que rellenar sus campos para configurarlo.

Cada campo tiene sus peculiaridades pero en todos hemos de rellenar:

• Nombre: Nombre del campo.
• Slug: Nombre ‘limpio’ del campo. NO usar acentos, ni espacios, si son varias palabras unirlas por guiones normales o bajos, siempre en minúscula y sin acentos.
• Descripción: Una descripción clara sobre lo que representa ese campo.
• Simple o repetitivo: Podemos indicar que se pueda crear varias instancias del mismo campo.
• Otros: Dependiendo del campo podemos rellenar otro tipo de configuraciones, en todos se puede indicar si es obligatorio o no, personalizar los textos o hacer un control para que se introduzcan campos correctos.

En este caso voy a crear un grupo de campos personalizados que incluyan un email de contacto y una fecha para los tipos de entrada Actividades.

Os dejo con el campo de fecha como ejemplo:

Visualización

Bien, si acudimos ahora al menu de actividades y añadimos una nueva entrada o en este caso modificamos una ya anterior nos encontraremos con el grupo de campos personalizados donde podremos rellenarlos.

Como veis en el grupo aparece el título, descripción, etc. que hemos indicado en la configuración del mismo, además los campos de un tipo en concreto están pensados para que sean fáciles de rellenar, por ejemplo en este caso la fecha implemente un datepicker.

Huelga decir que si introducimos un email inválido o lo dejamos vacío nos avisará antes de actualizar o publicar la Actividad.

Para ver los campos personalizados en nuestras entradas tenemos tres opciones.

A través de shortcodes

Si os fijáis al lado de Añadir Objeto nos aparece el icono del plugin donde podemos seleccionar los Custom Fields que queremos añadir al contenido y automáticamente nos los genera. Cada shortcode tiene sus parámetros de configuración que se introducen en los paneles que se abren al pulsar el icono del plugin.

Con la función get_post_meta

Os invito a revisar el post anterior sobre esta temática pues allí se explica el uso de esta función.

Lo único a destacar es el nombre del Custom Field, si os acordáis antes al rellenar los datos del campo hemos rellenado el slug del mismo. Para referenciarlo desde la función get_post_meta el nombre del campo personalizado es wpcf-{slug} siendo slug el rellenado en el campo.

Con la API del plugin Types.

Haciendo uso de la función types_render_field($slug, $array_de_opciones) donde slug es el slug del campo, sin ningún prefijo y el array de opciones viene definido por los argumentos que acepten los diferentes campos que se pueden ver aquí.

Y hasta aquí la segunda parte de los campos personalizados. No he hecho ejemplos más avanzados pues considero que hay que trastear el plugin cada uno dependiendo de sus necesidades así que dejo los comentarios abiertos para cualquier duda que surja y pueda ayudaros.

Referencias:

• Página oficial del plugin.
• API de los tipos personalizados.
• Mostrar los campos personalizados.
• Documentación general del plugin.