Nomenclatura de Archivos de Plantilla Única y Desarrollo de single.php

En el artículo de hoy trabajaremos en la creación de un archivo de plantilla importante en nuestro tema de WordPress, que es el archivo single.php, que se utiliza principalmente para mostrar y formatear todos los artículos o publicaciones individuales publicadas en tu sitio de WordPress. A través de este archivo general puedes personalizar la página de cualquier publicación de forma flexible, y también puedes crear archivos más especializados para obtener más control sobre cómo se muestran publicaciones específicas en tu sitio. Por ejemplo, puedes personalizar la forma en que se muestran los artículos que pertenecen a una categoría específica o que fueron escritos por autores específicos de manera diferente a otros artículos, o mostrar tipos de publicaciones personalizadas (CustomPosts) de manera diferente y muchas otras opciones más..

Sigue los párrafos de este artículo y aprende con pasos detallados cómo personalizar esta plantilla, y la gran flexibilidad que te ofrece para personalizar la visualización de los artículos de tu sitio web. Contenidos del artículo Cómo crear plantillas de publicaciones individuales personalizadas en WordPress. Crear el archivo single.php y agregar datos del artículo.

Agregar iconos de compartir en redes sociales debajo del artículo Crear un archivo style.css para formatear el artículo Resumen Cómo crear plantillas de publicaciones individuales personalizadas en WordPress. En lecciones anteriores de la serie de desarrollo de temas de WordPress, explicamos que cualquier tema de WordPress necesita básicamente el archivo de plantilla principal index.php para mostrar las páginas del sitio, y el archivo style.css que controla la apariencia de estas páginas. Demostramos que el desarrollador de temas puede agregar muchos archivos de plantillas opcionalmente para más personalización.

Dado que los archivos de plantillas de temas siguen una jerarquía específica que se utiliza para asegurarse de que cualquier artículo o página que visualicemos en tu sitio tenga un archivo de plantilla personalizado apropiado dentro de esta jerarquía y se use antes que otros archivos de plantilla que proporciona tu tema. Si no existe un archivo especializado específicamente para mostrar la página solicitada, se pasa al archivo que existe en un nivel superior en la jerarquía (un archivo más general) y así sucesivamente hasta que finalmente llegamos al archivo de plantilla base del tema index.php. En el artículo de hoy continuaremos con el tema que comenzamos a desarrollar en las dos lecciones anteriores (Aplicación práctica 1 para construir un tema de WordPress y Aplicación práctica 2 para construir un tema de WordPress) y trabajaremos en la creación de un nuevo archivo de plantilla en nuestro tema, que es el archivo de modelo de publicación única single.php para que se encargue de mostrar los artículos del sitio según el diseño requerido.

Aclaración: La palabra publicaciones o posts en WordPress incluye varios tipos, incluyendo tipos de publicación predeterminados (Default Post Types) en WordPress, o tipos de publicaciones personalizadas. En cuanto al archivo single.php, como mencionamos, se especializa en mostrar páginas individuales de todos los tipos de publicaciones predeterminadas o personalizadas, excepto las páginas estáticas (page), que estas últimas tienen un archivo de plantilla especializado conocido como page.html, que crearemos y personalizaremos en lecciones posteriores de la serie. Leer más: La diferencia entre páginas (Pages) y artículos (Posts) en WordPress. Para la lección de hoy, nos enfocaremos en crear solo el archivo single.php para personalizar todos los artículos individuales de nuestro sitio, y por supuesto puedes crear los archivos de plantilla más específicos que necesites para los artículos o publicaciones de tu sitio en caso de que necesites más especialización en cómo se muestran estas publicaciones como se muestra en la siguiente imagen. La jerarquía para llamar archivos de plantilla de publicación única como se muestra en la imagen anterior, utiliza el archivo llamado single-{post-type}.php para personalizar la visualización de una publicación de un tipo específico. Por ejemplo, si tienes una publicación del tipo artículo de blog (post), WordPress buscará el archivo single-post.php para mostrar el artículo, y si tienes una publicación personalizada del tipo producto (product), WordPress buscará un archivo especializado llamado single-product.php para mostrarlo y así sucesivamente..

Si WordPress no encuentra un archivo especializado para el tipo de publicación específico dentro de la carpeta del tema, buscará la existencia de un archivo llamado single.php para mostrar las publicaciones, sea cual sea su tipo. En caso de no encontrarlo, busca la existencia del archivo de respaldo singular.php y lo usa. En caso de no encontrarlo tampoco, como mencionamos, volverá al archivo base index.php al final y dependerá de él para mostrar la publicación. La mayoría de los desarrolladores de temas, al desarrollar sus temas personalizados, confían en crear solo el archivo de plantilla single.php en sus temas para simplificarlo lo más posible, ya que este archivo está suficientemente especializado para mostrar publicaciones individuales y no hay necesidad de crear archivos más especializados. En los párrafos siguientes comenzaremos a crear el archivo single.php en la carpeta del tema, y dependeremos de él para formatear todas las publicaciones o artículos individuales en nuestro sitio.

Queremos que cuando hagamos clic en el título de cualquier artículo en la página de inicio u otra página del sitio y vayamos a la página de ese artículo, aparezca una página que incluya elementos del artículo de acuerdo con el siguiente esquema: El marco de estructura de la página de artículo único del sitio Crear el archivo single.php y agregar datos del artículo. Necesitamos crear inicialmente un nuevo archivo llamado single.php en la carpeta de nuestro tema (ubicada en el directorio en el directorio wp-content < themes dentro de la carpeta raíz de nuestro sitio) y agregamos el código necesario para mostrar los datos requeridos en la página de artículo único. Al principio llamamos en el archivo de plantilla tanto el encabezado como el pie de página del sitio que creamos en la lección anterior usando las funciones get_header() y get_footer() y entre ellas escribimos una etiqueta

para mostrar el contenido de la página dentro de él más adelante, de modo que el código sea como sigue: Después y dentro de la etiqueta necesitamos escribir un bucle de WordPress WordPress Loop que extraiga inicialmente como se muestra en el diseño del marco de estructura propuesto el título del artículo, luego algunos metadatos del artículo (como las categorías del artículo que se muestra, el nombre del autor y la fecha de publicación).

Después mostramos la imagen destacada (Featured Image) de cada artículo, y aquí también usaremos una imagen predeterminada en caso de que el autor no haya subido una imagen destacada para este artículo. Finalmente, mostramos el contenido real del artículo llamando a la función the_content(), esta función obtiene todo el código HTML que resulta de editar el artículo ya sea a través del editor predeterminado Gutenberg u otras herramientas de construcción de páginas (obtiene todos los textos, imágenes, videos y otros elementos que agregaste al artículo a través del editor, y los coloca en la posición requerida en el archivo de plantilla).

Ahora el código estará dentro de la etiqueta de apertura

Y la etiqueta de cierre que muestra todos los datos del artículo requerido de la siguiente manera: