Unlimited Plugins, WordPress themes, videos & courses! Unlimited asset downloads! From $16.50/m
Advertisement
  1. Code
  2. WordPress

La guía para principiantes de taxonomías de WordPress: Un plugin personalizado

by
Read Time:7 minsLanguages:
This post is part of a series called The Beginner’s Guide to WordPress Taxonomies.
The Beginner’s Guide to WordPress Taxonomies: Themes or Plugins?

Spanish (Español) translation by Marilu (you can also view the original English article)

A lo largo de esta serie, hemos echado un vistazo a las taxonomías de WordPress: qué son, cómo funcionan, cómo diferenciarlas entre los diferentes tipos que existen y cómo están almacenadas en la base de datos subyacente.

Lo único que nos falta es montar un plugin que demuestre cómo usar el API para implementar nuestras propias taxonomías personalizadas. Así que en este post, vamos a hacer exactamente eso.

Recuerdo del primer post de esta serie:

La taxonomía 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 las cosas.

Y a lo largo de esta serie, hemos usado la fotografía y la videografía como nuestros ejemplos de clasificación. Así que para el plugin que vamos a construir, incluiremos taxonomías tanto jerárquicas como no jerárquicas relevantes para ambas clasificaciones.

  1. Las taxonomías jerárquicas incluirán taxonomías base de fotografías y videos.
  2. La taxonomía no jerárquica será para especificar el tipo de película que se utilizó. Puede ser en blanco y negro, color, sepia, o cualquier color que quieras especificar.

Finalmente, el plugin va a funcionar con el tipo de post estándar existente que se envía con WordPress. Esto debería dar la mayor flexibilidad en lo que se refiere a la construcción de un plugin, la demostración de los conceptos, y su uso en tu propia instalación.

Mis taxonomías personalizadas

Para el plugin de ejemplo, lo llamaremos Mis taxonomías personalizadas y lo construiremos en las siguientes etapas:

  1. Prepararemos el archivo del plugin principal que tiene el texto de cabecera adecuado necesario para mostrar el plugin en el escritorio de WordPress.
  2. Configuraremos el código necesario para ejecutar el plugin principal.
  3. Escribiremos un código que introducirá la taxonomía de las fotografías y los videos.
  4. Escribiremos un código que introducirá la taxonomía del tipo de película.
  5. Entonces probaremos el plugin completo.

1. El encabezado del plugin

Antes de hacer cualquier otra cosa, sigue adelante y crea un directorio en wp-content/plugins llamado my-custom-taxonomies e introduce un archivo llamado my-custom-taxonomies.php.

My Custom Taxonomies DirectoryMy Custom Taxonomies DirectoryMy Custom Taxonomies Directory

Dentro del archivo, agrega el siguiente bloque de comentarios en código:

En este punto, deberías poder acceder al escritorio de WordPress, ver el nombre del plugin y activarlo. Por supuesto, nada sucederá realmente ya que no hemos hecho nada con el código fuente todavía.

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

No te preocupes por poblarlo con cualquier código fuente todavía. Volvamos a my-custom-taxonomies.php y agreguemos un condicional para asegurarnos de que el archivo del plugin principal no pueda ser ejecutado fuera del entorno de WordPress.

Coloca esto directamente bajo el comentario de código que proporcionamos arriba.

2. Ejecutar el plugin principal

En este punto, estamos listos para escribir el código que realmente manejará el plugin. Así que definamos la clase y una función básica para la inicialización:

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

Ahora tenemos todo lo que necesitamos para empezar a configurar nuestros ganchos y llamadas para crear nuestras taxonomías personalizadas.

3. Introducir fotografías y vídeos

En este punto, estamos listos para empezar a introducir nuestras taxonomías. Primero nos centraremos en nuestras dos taxonomías jerárquicas, Fotografías y Videos.

En el cuerpo del archivo class-my-custom-taxonomies.php, añade la siguiente función:

Esta función es responsable de la creación de la taxonomía de las fotografías y se llamará desde dentro de la función de inicio cuando sea el momento adecuado.

Ahora, hagamos lo mismo con los videos:

Llamemos a estos dos desde la función de inicio (init). Lo hacemos registrando estas funciones con el gancho init que proporciona WordPress:

Aquí, deberíamos ser capaces de dirigirnos a Add New Post (Añadir nuevo post) y ver nuestras nuevas opciones de taxonomía visibles en el escritorio. Si no, comprueba tu código con el que se comparte arriba.

Photograph and Video CategoriesPhotograph and Video CategoriesPhotograph and Video Categories

Ahora que hemos introducido nuestras taxonomías jerárquicas, pasemos a introducir nuestra taxonomía de tipo de película, o nuestra taxonomía no jerárquica.

4. Introducir el Film Type (tipo de película)

Esto realmente no es muy diferente del código que hemos escrito hasta ahora. En realidad, la principal diferencia es que en lugar de especificar hierarchical como true, lo pondremos como false.

Esto dará lugar a 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 se ven arriba.

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

Fíjate que son funciones más como etiquetas que categorías. Una vez más, para reiterar, esa es una de las principales diferencias entre las taxonomías jerárquicas y no jerárquicas.

5. Probando el plugin completo

Ahora estamos listos para darle una vuelta al plugin. Asumiendo que has seguido todo correctamente a lo largo de este tutorial, entonces deberías ser capaz de crear un nuevo post, sellarlo con un tipo de Fotografía o un tipo de Vídeo así como un tipo de Película y hacer que persistan los cambios después de guardar o actualizar tu post.

Si no, comprueba tu código con lo que está referenciado aquí y con lo que está referenciado en el repositorio asociado de GitHub.

Conclusión

Eso concluye la guía para principiantes de las taxonomías de WordPress. A lo largo de la serie, hemos dado una amplia mirada a una definición de lo que son las taxonomías, el papel que juegan en WordPress, e incluso hemos implementado algunas propias.

En este punto, deberías tener una sólida comprensión del concepto y de cómo proceder para incluirlos en tu próximo proyecto.

Si no es así, no dudes en dejar tus preguntas, comentarios o retroalimentación general en el campo de abajo.

Advertisement
Advertisement
Looking for something to help kick start your next project?
Envato Market has a range of items for sale to help get you started.