Como Criar Modelos de Produto Único

Neste ponto, é seguro assumir que você já sabe que
Easy Digital Downloads (EDD) foi desenvolvido para funcionar com qualquer tema. No entanto, há várias coisas que podem ser feitas para garantir que seu tema aproveite ao máximo o EDD.

Neste artigo, cobriremos os conceitos básicos de como criar modelos de produto único para o seu tema. Para ser claro, um modelo de produto único é usado para exibir a página de front-end criada quando você adiciona um novo Download ao seu site.

Hierarquia de Modelos do WordPress

Primeiro, temos que dar um passo atrás e examinar como o próprio WordPress funciona. Os temas do WordPress não são nada mais do que uma coleção de arquivos que trabalham juntos para exibir seu site. Alguns desses arquivos de tema são modelos e componentes de modelo que se unem para criar a estrutura HTML do seu site.

O WordPress usa uma
hierarquia de modelos para determinar quando e como usar esses arquivos de modelo. Não entraremos em detalhes completos sobre toda a hierarquia, mas aqui está uma visualização de como os diferentes arquivos de modelo estão relacionados.

O que cobriremos aqui é o modelo de Postagem Única e como ele afeta a forma como suas páginas de produto único serão exibidas. Vamos começar.

Modelo de Postagem Única (e Singular)

Diretamente de
wordpress.org, aqui está a hierarquia de modelos para postagens únicas:

1. single-{post-type}-{slug}.php – (Desde 4.4) Primeiro, o WordPress procura um modelo para a postagem específica. Por exemplo, se o tipo de postagem for product e o slug da postagem for dmc-12, o WordPress procuraria por single-product-dmc-12.php.
2. single-{post-type}.php – Se o tipo de postagem for product, o WordPress procuraria por single-product.php.
3. single.php – O WordPress então recorre a single.php.
4. singular.php – Em seguida, recorre a singular.php.
5. index.php – Finalmente, como mencionado acima, o WordPress acaba recorrendo a index.php.

O que isso significa é que o nome de um arquivo de tema diz ao WordPress quando ele deve ser usado e sua “classificação” na hierarquia para aquele caso de uso específico.

O nome de arquivo mais comum neste ponto é provavelmente
single.php. O modelo single.php é usado para exibir postagens de blog únicas. Como você pode imaginar, muitos usuários publicam mais postagens de blog em seus sites WordPress do que qualquer outra coisa. Portanto, embora single.php não seja a classificação mais alta no geral, ele
é a classificação mais alta para modelos genéricos de postagem única.

É bem provável que o seu tema ativo (ou tema pai, se você estiver usando um
tema filho) tenha um arquivo single.php na sua pasta raiz. Se sim, ele é usado para exibir posts individuais do blog. No entanto, também é possível que você não tenha um arquivo single.php, mas sim um arquivo singular.php. Isso está se tornando mais comum. Seu propósito básico é ser um modelo mais "universal" para todas as páginas front-end que se enquadram na definição de "singular" do WordPress, como posts de blog, páginas e entradas de tipos de postagem personalizados básicos.

Vamos cobrir como o EDD usa esses modelos e como você pode mudar isso.

single.php

Como mencionado acima, o arquivo
single.php é um modelo básico usado para exibir posts individuais do blog. Quando o URL de um post de blog é visitado, o WordPress procurará na estrutura do tema o arquivo de modelo apropriado para usar na exibição desse post de blog. O arquivo single.php é a resposta comum.

Com esse entendimento, você também precisa saber que Posts (e Páginas) são o que o WordPress chama de "tipos de postagem". Existem alguns tipos de postagem padrão integrados ao WordPress, mas os desenvolvedores também podem criar os seus próprios, chamados Tipos de Postagem Personalizados.

O próprio EDD introduz vários tipos de postagem personalizados em seu sistema, um dos quais é o
Download. Esse é o único que discutiremos aqui.

Se você rolar para cima para dar outra olhada na hierarquia de modelos para posts individuais, notará que
single-{post-type}.php tem uma classificação maior do que single.php. Isso implica duas coisas:

1. Se single-{post-type}.php se encaixa no cenário, ele será usado antes de single.php.
2. Se nenhum modelo single-{post-type}.php existir, a próxima escolha é single.php.

A menos que seu tema tenha sido escrito especificamente para o EDD, sua situação se enquadra no segundo cenário por padrão. Dado que o tipo de postagem personalizada Download do EDD é registrado como download, a menos que seu tema inclua um arquivo
single-download.php (ou a posição nº 1 na hierarquia de posts individuais, que não discutiremos), o WordPress procurará o arquivo single.php.

O que isso significa é que, da maneira como seus posts de blog são exibidos, seu download do EDD terá a mesma aparência. Se seus posts de blog incluírem informações de autoria, navegação de post para post ou qualquer outra coisa, isso também será exibido para seus downloads.

Para muitos usuários, isso não é um problema. Para outros, pode adicionar informações indesejadas à exibição do produto. Ou talvez alguns usuários simplesmente não queiram que suas páginas de produto sejam exibidas da mesma forma que os posts de blog, o que é compreensível.

single-download.php

Para dizer ao WordPress que você gostaria de exibir suas páginas de produto individuais de forma diferente de seus posts de blog individuais, você precisa acessar a hierarquia de modelos de posts individuais criando um arquivo
single-download.php na pasta raiz do seu tema ativo (o que significaria seu tema filho se você estiver usando um).

Uma vez que este arquivo esteja no local correto na pasta raiz do seu tema ativo, a visualização da página de front-end de um dos seus produtos chamará o template específico de download em vez do template de postagem de blog. Nesse ponto, você está no controle do seu template
single-download.php e pode criá-lo como desejar.

Aqui está uma dica muito útil para criar seu template
single-download.php:

A menos que você seja um desenvolvedor de temas que já sabe o que está fazendo, a melhor maneira de criar seu arquivo inicial
single-download.php é duplicar o arquivo single.php do seu tema e, em seguida, renomear o duplicado para single-download.php. Nesse ponto, nada mudará na exibição das suas páginas de produto. No entanto, agora você está livre para editar o novo arquivo de template e ele afetará apenas suas páginas de produto.

Se você estiver usando um tema filho, isso significa que você precisaria copiar o template de postagem única do tema pai para colocá-lo na pasta raiz do seu tema filho.

singular.php

As coisas ficam um pouco mais complicadas aqui. O arquivo
singular.php é bem novo e, embora não seja tão amplamente utilizado quanto o arquivo single.php, ainda é popular. Como mencionado anteriormente, o WordPress vem com vários tipos de postagem já integrados e suporta a criação de tipos de postagem personalizados. *Todos* esses tipos de postagem são considerados singulares.

O que isso significa é que um tema não precisa incluir um arquivo single.php, ou mesmo um arquivo page.php (o template usado para exibir Páginas do WordPress). Se um arquivo singular.php estiver presente e nenhum dos templates mais específicos estiver disponível, o WordPress o usará para todos os tipos de postagem.

Nem é preciso dizer que esse arquivo de template muitas vezes tem que usar lógica condicional. Isso significa:

Se o URL visitado for uma página, use este código para exibir a página. Se o URL visitado for uma postagem, use aquele código para exibir a postagem.

Tudo isso acontece dentro de um único arquivo de template. Para sites com apenas postagens e páginas, isso é simples. Quando você introduz tipos de postagem personalizados, isso pode ficar complicado, pois o desenvolvedor do tema muito provavelmente não criou uma condição para o tipo de postagem de Download, isso se o tema não foi escrito para considerar o EDD.

Embora este não seja o lugar para entrar nos detalhes de como construir um tema, o mesmo é verdade neste cenário como ao substituir o
single.php para templates de produto. Você pode usar o arquivo singular.php para criar (através de duplicação) um arquivo single-download.php. A única diferença aqui é que você precisará entender melhor o código neste arquivo para modificá-lo para uso com produtos.

Templates de Produto Único em Resumo

Isso não se destina a ser um guia sobre temas do WordPress. Em vez disso, o objetivo é mostrar como o EDD funciona com o WordPress para que você possa usar templates de produto único para exibir suas páginas de produto.

Se você não é um desenvolvedor de temas WordPress, esta é uma tarefa que você pode querer terceirizar para alguém experiente na área. Criar o arquivo necessário é apenas um passo. Criar (ou editar) o código no arquivo é uma tarefa completamente separada que requer um pouco de experiência ou, pelo menos, familiaridade com HTML e PHP.