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

Anexos avanzados de WordPress: Creación de consultas personalizadas

by
Read Time:5 minsLanguages:
This post is part of a series called Advanced Use of Attachments in WordPress.
Advanced WordPress Attachments: Categories and Taxonomy Terms
Advanced Use of Attachments in WordPress - Creating Categorised Gallery Pages

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

Este tutorial es el segundo de una serie de cuatro partes en las que aprenderás algunas técnicas para trabajar con imágenes en archivos adjuntos en WordPress que te dan opciones avanzadas.

En esta serie, yo cubro:

  • asignando categorías y taxonomías a los anexos,
  • consultando los archivos de medios por taxonomía para que puedan salir en un bucle personalizado,
  • usando consultas de taxonomía para las imágenes para mostrarlas en las páginas de archivo,
  • añadiendo una imagen a una categoría o término taxonómico como la "imagen destacada" de la categoría o el término

En la primera parte, demostré cómo crear nuevas taxonomías para los anexos. En las partes 2 y 3, te mostraré cómo crear bucles personalizados para mostrar los adjuntos en una plantilla. En este tutorial crearé un archivo de plantilla personalizado para los documentos y crearé un bucle que muestre un enlace al archivo multimedia para cada documento.

Nota: Si deseas aplicar las categorías y etiquetas existentes a tus medios, consulta mi tutorial sobre la asignación de categorías y etiquetas a los archivos adjuntos.

Lo que necesitarás

Para seguir este tutorial necesitarás lo siguiente:

  • una instalación de desarrollo de WordPress
  • Acceso al FTP (o MAMP o similar si trabajas localmente)
  • un editor de código

En la primera parte he creado un plugin para registrar las taxonomías, pero en esta parte crearé un tema personalizado que será un tema hijo de veinticuatro con el nuevo archivo de plantilla, una hoja de estilo y un archivo de funciones.

Si creas un tema personalizado siguiendo los pasos que he explicado aquí, también tendrás que asegurarte de que el plugin creado en la primera parte esté activado: el nuevo archivo de plantilla no funcionará sin él.

Si lo prefieres, puedes copiar el código del plugin en el archivo de funciones de tu tema, aunque prefiero mantener los tipos de post personalizados en los plugins ya que no dependen del tema. El paquete de código de este tutorial incluye el plugin y el nuevo tema hijo, que solo funcionará si tienes veinticuatro instalados.

1. Creando el tema del niño

El primer paso es crear el tema del niño. Crea una nueva carpeta en el directorio de temas, dale un nombre apropiado y añade un nuevo archivo style.css.

Nota: Si estás añadiendo la plantilla a tu tema existente puedes saltarte este paso.

En la hoja de estilo, añade lo siguiente:

Esto creará un nuevo tema hijo del tema de los veinticuatro. No necesitas añadir nada más a esta hoja de estilo.

2. Creación del archivo de plantillas

Para mostrar los archivos adjuntos en la taxonomía de la document-category que configuraste si estaba siguiendo el primer tutorial de esta serie, necesitarás crear un archivo de plantilla de taxonomía.

En tu nuevo tema hijo, añade un archivo llamado taxonomy-document-category.php.

Antes de añadir el bucle personalizado para los archivos adjuntos, tendrás que añadir el marcado para envolverlo, que puedes copiar de un archivo en el tema principal o tomar del código de abajo.

Nota: Si estás usando tu propio tema, copia este código de uno de los archivos de plantilla de tu tema, pero deja fuera el contenido del bucle.

Fíjate que he usado get_queried_object para dar salida al título de la página dentro de un elemento h1.

3. Uso de parse_query para añadir archivos adjuntos a la consulta principal

De forma predeterminada, la consulta principal de WordPress no incluye archivos adjuntos. Una forma de evitar esto es añadir una nueva consulta a tu archivo de plantilla usando WP_Query, pero tiene más sentido quedarse con la consulta principal ya que WordPress la ejecutará de todas formas. Para hacer esto, utiliza el filtro parse_query.

Así que tienes que añadir esto a tu tema. Crea un archivo functions.php en tu tema y añádele lo siguiente:

Esto utiliza el filtro parse_query para agregar archivos adjuntos a la consulta principal de WordPress, pero solo cuando se muestra un archivo para una de las dos taxonomías aplicadas a los archivos adjuntos.

4. Creación del bucle personalizado

Finalmente, en el archivo de plantilla que creaste en el paso 2, añade lo siguiente después de la etiqueta de cierre </header> :

Aquí estoy usando la función wp_get_attachment_url() que enlaza directamente al archivo en sí, si quisieras enlazar a la página de adjuntos en su lugar, usarías get_attachment_link().

Finalmente, guarda tu código y echa un vistazo a tu página de archivo. He añadido varios documentos a mi sitio (que he descargado de Wikipedia), como puedes ver en la captura de pantalla de mi biblioteca multimedia:

advanced-use-of-attachments-in-wordpress-part-2-documents-media-libraryadvanced-use-of-attachments-in-wordpress-part-2-documents-media-libraryadvanced-use-of-attachments-in-wordpress-part-2-documents-media-library

La siguiente captura de pantalla muestra mi página de archivo para el término "Open Source (Código Abierto)" en la taxonomía de la document-category. Si hago clic en cualquiera de esos enlaces, soy llevado directamente al documento en sí.

advanced-use-of-attachments-in-wordpress-part-2-documents-archive-pageadvanced-use-of-attachments-in-wordpress-part-2-documents-archive-pageadvanced-use-of-attachments-in-wordpress-part-2-documents-archive-page

Resumen

En este tutorial, has aprendido a utilizar las taxonomías aplicadas a los archivos adjuntos para crear una plantilla personalizada y mostrar una lista de enlaces a los documentos cargados. Esto sería útil si estuvieras desarrollando un sitio para ser utilizado como un depósito de documentos, por ejemplo.

En el próximo tutorial, te mostraré cómo crear un archivo de plantilla personalizado para las imágenes, que atenuará todas las imágenes con un término dado en la taxonomía de la gallery-category.

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.