# Como Criar Templates de Produto Único Neste ponto, é seguro assumir que você já sabe que o [Easy Digital Downloads (EDD) foi desenvolvido para funcionar com qualquer tema](https://easydigitaledd.com/docs/will-easy-digital-downloads-work-with-my-theme/). No entanto, há várias coisas que podem ser feitas para garantir que seu tema aproveite mais o EDD. Neste artigo, cobriremos o básico de como criar templates de produto único para o seu tema. Para ser claro, um template de produto único é usado para exibir a página front-end criada quando você adiciona um novo Download ao seu site. ### Hierarquia de Templates do WordPress Primeiro, temos que dar um passo atrás e examinar como o próprio WordPress funciona. Os temas do WordPress nada mais são do que uma coleção de arquivos que trabalham juntos para exibir seu site. Alguns desses arquivos de tema são templates e componentes de template que se unem para criar a estrutura HTML do seu site. O WordPress usa uma [hierarquia de templates](https://developer.wordpress.org/themes/basics/template-hierarchy/) para determinar quando e como usar esses arquivos de template. Não entraremos em detalhes completos sobre toda a hierarquia, mas aqui está uma visualização de como os diferentes arquivos de template estão relacionados. [](https://developer.wordpress.org/files/2014/10/template-hierarchy.png) O que cobriremos aqui é o template de Post Único e como ele afeta a forma como suas páginas de produto único serão exibidas. Vamos começar. #### Template de Post Único (e Singular) Diretamente do *wordpress.org*, aqui está a hierarquia de templates para posts únicos: 1. `single-{post-type}-{slug}.php` – (Desde 4.4) Primeiro, o WordPress procura um template para o post específico. Por exemplo, se o tipo de post for `product` e o slug do post for `dmc-12`, o WordPress procuraria por `single-product-dmc-12.php`. 2. `single-{post-type}.php` – Se o tipo de post 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 recorre, em última instância, 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 esse caso de uso específico. O nome de arquivo mais comum neste ponto é provavelmente `single.php`. O template `single.php` é usado para exibir posts de blog únicos. Como você pode imaginar, muitos usuários publicam mais posts de blog em seus sites WordPress do que qualquer outra coisa. Portanto, embora `single.php` não seja o de maior classificação geral, ele *é* o de maior classificação para templates genéricos de posts únicos. Há uma boa chance de que seu tema ativo (ou tema pai, se você estiver usando um [tema filho](https://codex.wordpress.org/Child_Themes)) tenha um arquivo `single.php` em sua pasta raiz. Se sim, ele é usado para exibir posts de blog únicos. No entanto, também há uma chance de 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 mais um template "universal" para todas as páginas front-end que se enquadram na definição "singular" do WordPress, como posts de blog, páginas e entradas para tipos de post personalizados básicos. Vamos cobrir como o EDD usa esses templates e como você pode mudar isso. #### single.php Como mencionado acima, o arquivo `single.php` é um template básico usado para exibir posts de blog únicos. Quando o URL de um post de blog é visitado, o WordPress procurará na estrutura do tema o arquivo de template 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 post". Existem alguns tipos de post padrão integrados ao WordPress, mas os desenvolvedores também podem criar os seus próprios, chamados Tipos de Post Personalizados. O próprio EDD introduz vários tipos de post 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 templates para posts únicos, 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 template `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 post personalizado 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 únicos, 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 informar ao WordPress que você gostaria de exibir suas páginas de produto único de forma diferente de seus posts de blog únicos, você precisa acessar a hierarquia de templates de posts únicos 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 lugar na pasta raiz do seu tema ativo, visualizar a página front-end de um de seus produtos chamará o template específico do download em vez do template de post de blog. Nesse ponto, você está no controle do seu template `single-download.php` e pode criá-lo como quiser. 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 `single-download.php` inicial é 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 de 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 post único 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` é relativamente 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 post já integrados e suporta a criação de tipos de post personalizados. *Todos* esses tipos de post 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 post. Nem é preciso dizer que este 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 um post, use este código para exibir o post. Tudo isso acontece dentro de um único arquivo de template. Para sites com apenas posts e páginas, isso é simples. Quando você introduz tipos de post personalizados, isso pode ficar complicado, pois o desenvolvedor do tema muito provavelmente não criou uma condição para o tipo de post personalizado 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 criar um tema, o mesmo se aplica 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, isso é algo que você pode querer terceirizar para alguém experiente na área. A criação do 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.