Cómo crear plantillas de producto único

En este punto, es seguro asumir que ya sabes que
Easy Digital Downloads (EDD) se desarrolló para funcionar con cualquier tema. Sin embargo, hay varias cosas que se pueden hacer para asegurarte de 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 entrada específica. Por ejemplo, si el tipo de entrada es product y el slug de la entrada es dmc-12, WordPress buscaría single-product-dmc-12.php.
2. single-{post-type}.php – Si el tipo de entrada es product, WordPress buscaría single-product.php.
3. single.php – WordPress entonces 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 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,
es el de mayor rango para las plantillas genéricas de entradas únicas.

Es muy probable que tu tema activo (o el tema padre, si estás usando un
tema hijo) tenga un archivo single.php en su carpeta raíz. Si es así, se utiliza para mostrar las entradas individuales del blog. Sin embargo, también es posible que no tengas un archivo single.php pero sí un archivo 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 front-end que caen bajo la definición de "singular" de WordPress, como las entradas del blog, las páginas y las entradas de tipos de publicación personalizados básicos.

Veamos cómo EDD utiliza 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 entrada". Hay algunos tipos de entrada predeterminados integrados en WordPress, pero los desarrolladores también pueden crear los suyos propios, llamados Tipos de Entrada Personalizados.

EDD en sí introduce varios tipos de entrada 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 entrada personalizado de Descarga de EDD se registra como "download", a menos que tu tema incluya un archivo
single-download.php (o la posició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, tu descarga de EDD se verá igual. 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 añadir 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 su tema activo, ver la página principal de uno de sus productos llamará a la plantilla específica de descarga en lugar de la plantilla de entrada de blog. En ese momento, usted tiene el control de su
single-download.php plantilla y puede crearla como desee.

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

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

Si está utilizando un tema hijo, eso significa que necesitaría copiar la plantilla de entrada principal del tema padre para colocarla en la carpeta raíz de su 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 no hay plantillas más específicas disponibles, WordPress lo utilizará para todos los tipos de publicaciones.

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

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

Todo esto sucede dentro de un único archivo de plantilla. Para sitios con solo entradas y páginas, esto es simple. Cuando introduce tipos de publicaciones personalizadas, esto puede ser 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 productos. Puede usar el archivo singular.php para crear (mediante duplicación) un archivo single-download.php. La única diferencia aquí es que necesitará comprender mejor el código de este archivo para modificarlo para su uso con productos.

Plantillas de Producto Único En Resumen

Esto no pretende ser una guía sobre temas de WordPress. En cambio, el objetivo es mostrarle cómo EDD funciona con WordPress para que pueda usar plantillas de producto único para mostrar sus 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.