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..
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..
Para los propósitos del ejemplo plugin, lo llamaremos Mis taxonomías personalizadas Y lo estaremos construyendo en las siguientes etapas:
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 y 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
comocierto
, lo pondremos comofalso
.'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.