Cómo crear plantillas de producto único

En este punto, es seguro asumir que ya sabes que
Easy Digital Downloads (EDD) fue desarrollado para funcionar con cualquier tema. Sin embargo, hay varias cosas que se pueden hacer para asegurar que tu tema aproveche más EDD.

En este artículo, cubriremos los conceptos básicos de cómo crear plantillas de producto único para tu tema. Para que quede claro, una plantilla de producto único se utiliza para mostrar la página de front-end creada cuando agregas una nueva Descarga a tu sitio.

Jerarquía de plantillas de WordPress

Primero, tenemos que dar un paso atrás y examinar cómo funciona WordPress. Los temas de WordPress no son más que una colección de archivos que trabajan juntos para mostrar tu sitio. Algunos de esos archivos de tema son plantillas y componentes de plantilla que se unen para crear la estructura HTML de tu sitio.

WordPress utiliza una
jerarquía de plantillas para determinar cuándo y cómo usar esos archivos de plantilla. No entraremos en detalles completos sobre toda la jerarquía, pero aquí tienes una representación visual de cómo se relacionan los diferentes archivos de plantilla.

Lo que cubriremos aquí es la plantilla de entrada única (Single Post) y cómo afecta la forma en que se mostrarán tus páginas de producto único. Empecemos.

Plantilla de entrada única (Single Post) y singular

Directamente de
wordpress.org, aquí está la jerarquía de plantillas para entradas únicas:

1. single-{post-type}-{slug}.php – (Desde 4.4) Primero, WordPress busca una plantilla para la publicación específica. Por ejemplo, si el tipo de publicación es product y el slug de la publicación es dmc-12, WordPress buscaría single-product-dmc-12.php.
2. single-{post-type}.php – Si el tipo de publicación es product, WordPress buscaría single-product.php.
3. single.php – WordPress luego recurre a single.php.
4. singular.php – Luego recurre a singular.php.
5. index.php – Finalmente, como se mencionó anteriormente, WordPress recurre en última instancia a index.php.

Lo que esto significa es que el nombre de un archivo de tema le dice a WordPress cuándo debe usarse y su "rango" en la jerarquía para ese caso de uso particular.

El nombre de archivo más común en este punto es probablemente
single.php. La plantilla single.php se utiliza para mostrar las entradas de blog individuales. Como puedes imaginar, muchos usuarios publican más entradas de blog en sus sitios de WordPress que cualquier otra cosa. Por lo tanto, aunque single.php no es el de mayor rango en general, sí
es el de mayor rango para las plantillas genéricas de entradas únicas.

Es muy probable que tu tema activo (o tema padre, si estás usando un
tema hijo) tenga un archivo single.php en su carpeta raíz. Si es así, se usa para mostrar las entradas individuales del blog. Sin embargo, también es posible que no tengas un archivo single.php, sino uno llamado singular.php. Esto es cada vez más común. Su propósito básico es ser una plantilla más "universal" para todas las páginas del front-end que caen bajo la definición de "singular" de WordPress, como las entradas del blog, las páginas y las entradas de los tipos de publicación personalizados básicos.

Veamos cómo EDD usa estas plantillas y cómo puedes cambiarlo.

single.php

Como se mencionó anteriormente, el archivo
single.php es una plantilla básica utilizada para mostrar las entradas individuales del blog. Cuando se visita la URL de una entrada del blog, WordPress buscará en la estructura del tema el archivo de plantilla apropiado para usar al mostrar esa entrada del blog. El archivo single.php es la respuesta común.

Con esa comprensión, también necesitas saber que las Entradas (y Páginas) son lo que WordPress llama "tipos de publicación". Hay algunos tipos de publicación predeterminados integrados en WordPress, pero los desarrolladores también pueden crear los suyos propios, llamados Tipos de Publicación Personalizados.

EDD en sí introduce varios tipos de publicación personalizados en tu sistema, uno de los cuales es la
Descarga. Ese es el único que vamos a discutir aquí.

Si te desplazas hacia arriba para echar otro vistazo a la jerarquía de plantillas para entradas individuales, notarás que
single-{post-type}.php tiene un rango superior a single.php. Eso implica dos cosas:

1. Si single-{post-type}.php se ajusta al escenario, se usará antes que single.php.
2. Si no existe ninguna plantilla single-{post-type}.php, la siguiente opción es single.php.

A menos que tu tema haya sido escrito específicamente para EDD, tu situación cae por defecto en el segundo escenario. Dado que el tipo de publicación personalizado Descarga de EDD se registra como "download", a menos que tu tema incluya un archivo
single-download.php (o la posición n.º 1 en la jerarquía de entradas individuales, que no discutiremos), WordPress buscará el archivo single.php.

Lo que esto significa es que, tal como se muestran tus entradas del blog, tus descargas de EDD se verán iguales. Si tus entradas del blog incluyen información de autor, navegación de entrada a entrada o cualquier otra cosa, también se mostrará para tus descargas.

Para muchos usuarios, esto no es un problema. Para otros, puede agregar información no deseada a la visualización del producto. O quizás algunos usuarios simplemente no quieren que sus páginas de producto se muestren de la misma manera que las entradas del blog, lo cual es comprensible.

single-download.php

Para indicarle a WordPress que deseas mostrar tus páginas de producto individuales de manera diferente a tus entradas de blog individuales, debes acceder a la jerarquía de plantillas de entradas individuales creando un archivo
single-download.php en la carpeta raíz de tu tema activo (lo que significaría tu tema hijo si estás usando uno).

Una vez que este archivo esté en la carpeta raíz de tu tema activo, ver la página principal de uno de tus productos llamará a la plantilla específica de descarga en lugar de la plantilla de entrada de blog. En ese momento, tendrás el control de tu plantilla single-download.php y podrás crearla como quieras.

Aquí tienes un consejo muy útil para crear tu plantilla single-download.php:

A menos que seas un desarrollador de temas que ya sabe lo que está haciendo, la mejor manera de crear tu archivo inicial single-download.php es duplicar el archivo single.php de tu tema y luego renombrar el duplicado a single-download.php. En ese momento, nada cambiará en la visualización de tus páginas de producto. Sin embargo, ahora eres libre de editar el nuevo archivo de plantilla y solo afectará a tus páginas de producto.

Si estás usando un tema hijo, eso significa que necesitarías copiar la plantilla de entrada principal del tema padre para ponerla en la carpeta raíz de tu tema hijo.

singular.php

Las cosas se complican un poco más aquí. El archivo singular.php es bastante nuevo y, aunque no es tan utilizado como el archivo single.php, sigue siendo popular. Como se mencionó anteriormente, WordPress viene con varios tipos de publicaciones ya integrados y admite la creación de tipos de publicaciones personalizadas. *Todos* estos tipos de publicaciones se consideran singulares.

Lo que esto significa es que un tema *no* tiene que incluir un archivo single.php, ni siquiera un archivo page.php (la plantilla utilizada para mostrar las Páginas de WordPress). Si está presente un archivo singular.php y ninguna de las plantillas más específicas está disponible, WordPress lo usará para todos los tipos de publicaciones.

No hace falta decir que este archivo de plantilla a menudo tiene que usar lógica condicional. Eso significa:

Si la URL visitada es una página, usa este código para mostrar la página. Si la URL visitada es una entrada, usa ese código para mostrar la entrada.

Todo esto sucede dentro de un solo archivo de plantilla. Para sitios con solo entradas y páginas, esto es simple. Cuando introduces tipos de publicaciones personalizadas, esto puede volverse complicado, ya que es muy probable que el desarrollador del tema no haya creado una condición para el tipo de publicación de descarga, es decir, si el tema no fue escrito para considerar EDD.

Si bien este no es el lugar para entrar en detalles sobre cómo crear un tema, lo mismo ocurre en este escenario que al anular el single.php para las plantillas de producto. Puedes usar el archivo singular.php para crear (mediante duplicación) un archivo single-download.php. La única diferencia aquí es que necesitarás comprender mejor el código de este archivo para modificarlo para su uso con productos.

Plantillas de Producto Únicas en Resumen

Esto no pretende ser una guía sobre temas de WordPress. En cambio, el objetivo es mostrarte cómo EDD funciona con WordPress para que puedas usar plantillas de producto únicas para mostrar tus páginas de producto.

Si no eres un desarrollador de temas de WordPress, esto es algo que quizás quieras externalizar a alguien con experiencia en el área. Crear el archivo necesario es solo un paso. Crear (o editar) el código en el archivo es una tarea completamente separada que requiere un poco de experiencia o al menos familiaridad con HTML y PHP.