La guía para principiantes de las taxonomías de WordPress un complemento personalizado

A lo largo de esta serie, hemos examinado las taxonomías de WordPress: qué son, cómo funcionan, cómo diferenciarlas entre los diferentes tipos que existen y cómo se almacenan en la base de datos subyacente..

Lo único que todavía tenemos que hacer es armar un complemento que demuestre cómo usar la API para implementar nuestras propias taxonomías personalizadas. Así que en este post, vamos a hacer exactamente eso. 

Recordemos del primer post de esta serie:

Taxonomia es una de esas palabras que la mayoría de la gente nunca escucha o usa. Básicamente, una taxonomía es una forma de agrupar cosas..

Y a lo largo de esta serie, hemos estado utilizando la fotografía y la videografía como nuestros ejemplos de clasificaciones. Entonces, para el complemento que vamos a construir, incluiremos taxonomías jerárquicas y no jerárquicas relevantes para estas dos clasificaciones..

  1. Las taxonomías jerárquicas incluirán taxonomías base de FotografíasVideos.
  2. La taxonomía no jerárquica será para especificar el tipo de película que se utilizó. Esto podría ser Blanco y negro, Color, Sepia, o cualquier color que quieras especificar.

Finalmente, el complemento funcionará con el tipo de publicación estándar existente que se envía con WordPress. Esto debería dar la mayor flexibilidad en lo que respecta a la creación de un complemento, la demostración de los conceptos y su uso en su propia instalación..

Mis taxonomías personalizadas

Para los propósitos del ejemplo plugin, lo llamaremos Mis taxonomías personalizadas Y lo estaremos construyendo en las siguientes etapas:

  1. Prepararemos el archivo del complemento central que tiene el texto de encabezado adecuado necesario para mostrar el complemento en el panel de WordPress.
  2. Configuraremos el código necesario para ejecutar el complemento del núcleo..
  3. Escribiremos código que introducirá tanto el Fotografías Videos taxonomia.
  4. Vamos a escribir el código que presentará el Tipo de filme taxonomia.
  5. Luego probaremos el complemento completo.

1. El encabezado del plugin

Antes de hacer nada más, crea un directorio en wp-content / plugins llamado mis aduaneras taxonomías e introducir un archivo llamado my-custom-taxonomies.php.

Dentro del archivo, agregue el siguiente bloque de comentario de código:

En este punto, debería poder iniciar sesión en el panel de WordPress, ver el nombre del complemento y activarlo. Por supuesto, nada ocurrirá ya que todavía no hemos hecho nada con el código fuente.

A continuación, debemos crear otro archivo que se utilizará para alimentar realmente el complemento. Esto se basará en principios de programación orientados a objetos, por lo que crearemos un archivo llamado class-my-custom-taxonomies.php.

No te preocupes por rellenar con cualquier código fuente todavía. Volvamos a my-custom-taxonomies.php y agregue un condicional para asegurarse de que el archivo del complemento principal no se pueda ejecutar fuera del entorno de WordPress.

Coloque esto directamente debajo del comentario del código que proporcionamos arriba.

2. Ejecutando el Core Plugin

En este punto, estamos listos para escribir el código que realmente impulsará el complemento. Así que vamos a definir la clase y una función básica para la inicialización:

 * / class My_Custom_Taxonomies / ** * Inicializa el complemento al registrar los ganchos necesarios * para crear nuestras taxonomías personalizadas dentro de WordPress. * * @since 1.0.0 * / public function init () 

Después de eso, volvamos a my-custom-taxonomies.php y agregue un código para incluir el archivo, así como un método que creará una instancia de la clase y la ejecutará:

en eso();  custom_taxonomies_run ();

Ahora tenemos todo lo que necesitamos para comenzar a configurar realmente nuestros ganchos y devoluciones de llamada para crear nuestras taxonomías personalizadas..

3. Introduce Fotografías y Videos

En este punto, estamos listos para comenzar a presentar nuestras taxonomías. Primero nos centraremos en nuestras dos taxonomías jerárquicas. - Fotografías Videos.

En el cuerpo de la clase de class-my-custom-taxonomies.php archivo, agregue la siguiente función:

 'Fotografías', 'singular_name' => 'Fotografía', 'edit_item' => 'Editar fotografía', 'update_item' => 'Actualizar fotografía', 'add_new_item' => 'Agregar nueva fotografía', 'menu_name' => ' Fotografías '); $ args = array ('hierarchical' => true, 'labels' => $ labels, 'show_ui' => true, 'show_admin_column' => true, 'rewrite' => array ('slug' => 'photograph') ); register_taxonomy ('photograph', 'post', $ args); 

Esta función es responsable de crear el Fotografías taxonomía y se llamará desde dentro de la función init cuando sea el momento adecuado.

Ahora, hagamos lo mismo por Videos:

 'Videos', 'singular_name' => 'Video', 'edit_item' => 'Editar video', 'update_item' => 'Actualizar video', 'add_new_item' => 'Agregar nuevo video', 'menu_name' => ' Videos '); $ args = array ('hierarchical' => false, 'labels' => $ labels, 'show_ui' => true, 'show_admin_column' => true, 'rewrite' => array ('slug' => 'video') ); register_taxonomy ('video', 'post', $ args); 

Llamemos a estos dos desde dentro de la función init. Hacemos esto registrando estas funciones con el en eso gancho como lo proporciona WordPress:

Aquí, deberíamos poder dirigirnos a Añadir nueva publicación y vea nuestras nuevas opciones de taxonomía visibles en el panel de control. Si no es así, vuelva a verificar su código con el que se comparte arriba.

Ahora que hemos introducido nuestras taxonomías jerárquicas, pasemos a la introducción de nuestra Tipo de filme - o nuestro no jerárquico - taxonomía.

4. Introduce Tipo de filme

Esto realmente no es muy diferente del código que hemos escrito hasta este momento. Realmente, la principal diferencia es que en lugar de especificar jerárquico como cierto, lo pondremos como falso.

 'Tipo de película', 'singular_name' => 'Tipo de película', 'edit_item' => 'Editar tipo de película', 'update_item' => 'Actualizar tipo de película', 'add_new_item' => 'Agregar nuevo tipo de película', ' menu_name '=>' Tipo de película '); $ args = array ('hierarchical' => false, 'labels' => $ labels, 'show_ui' => true, 'show_admin_column' => true, 'rewrite' => array ('slug' => 'film-type ')); register_taxonomy ('film-type', 'post', $ args); 

Esto dará como resultado un tipo diferente de elemento de la interfaz de usuario que se parece más a las etiquetas que a las opciones de categoría que ve arriba.

Finalmente, agregue la siguiente línea al método init junto con el resto de los ganchos:

Tenga en cuenta que es más parecido a las etiquetas que las categorías. Nuevamente, para reiterar, esa es una de las principales diferencias en taxonomías jerárquicas y no jerárquicas..

5. Probando el complemento completo

Ahora estamos listos para darle una vuelta al plugin. Suponiendo que haya seguido todo correctamente a lo largo de este tutorial, entonces debería poder crear una nueva publicación, sellarla con un tipo de Fotografía o un tipo de Vídeo así como un tipo de Película y haga que persistan los cambios después de guardar o actualizar su publicación..

De lo contrario, verifique dos veces su código con lo que se hace referencia aquí y con lo que se menciona en el repositorio de GitHub asociado.

Conclusión

Eso envuelve la Guía para principiantes de las taxonomías de WordPress. A lo largo de la serie, hemos analizado en detalle la definición de qué son las taxonomías, el papel que desempeñan en WordPress, e incluso hemos implementado algunas de nuestras propias.

En este punto, debe tener una comprensión sólida del concepto y cómo proceder a incluirlos en su próximo proyecto.

Si no es así, no dude en dejar preguntas, comentarios o comentarios generales en el campo a continuación.