existem muitas maneiras de alterar a aparência de uma página específica em seu site WordPress. Você pode alterar o conteúdo dentro do editor de conteúdo do WordPress. Você pode alterar as regras CSS que afetam o site. Ou crie um novo arquivo na hierarquia de modelos do seu tema WordPress para corresponder à página específica. Ou você pode usar um modelo de página de tema projetado especificamente para essa página. O último é o que estamos falando aqui. Neste tutorial, abordaremos como criar um modelo de página personalizada do WordPress e por que você pode querer fazer isso. Vamos começar com o porquê.

quando você diz “WordPress Theme Custom Page Template”, o que você quer dizer?

há um grande problema de terminologia com este tópico. Como sugeri acima, há muitas coisas com a vaga noção de” página “e” Modelo ” No mundo do WordPress que não são o que estamos falando aqui. A primeira coisa que eu *não* quero dizer ao dizer “WordPress custom page template” é ” um tema WordPress.”(Muitas pessoas novas no WordPress dizem “modelos” quando querem dizer ” um tema WordPress.”)

então, o que quero dizer com “modelo de página personalizado”? Quero dizer, o que é mostrado à direita. Por exemplo, você está editando o tipo de conteúdo da Página no WordPress (embora, como veremos mais adiante, agora ele possa incluir outros tipos de conteúdo do WordPress). E ao editar sua página, você percebe a caixa ” atributos da página “e, dentro disso, você pode (dependendo se o seu tema já tiver esses modelos) ver este menu suspenso” modelo”. Esta caixa de seleção é ilustrada à direita (também está no lado direito da tela de “edição de página”). Se você vir esse menu suspenso, é porque seu tema fornece alguns desses ” modelos de página personalizados.”Na verdade, eles são arquivos na pasta do seu tema atualmente ativo (ou seu pai) e têm um único recurso distintivo ao qual chegaremos mais tarde. Mas este menu suspenso selecionável de modelos de página nomeados é o que estamos falando aqui hoje.

como isso se encaixa na hierarquia do modelo?

eu escrevi antes, e eu provavelmente vou fazê — lo novamente, sobre como o modelo — há essa palavra novamente-hierarquia é realmente o conceito-chave que você precisa entender para construir ou modificar um tema WordPress. (Aqui está a nossa rápida introdução a ele.) Quase todo o resto é um detalhe que você pode descobrir depois de entender a dinâmica básica da hierarquia de modelos. A coisa específica que estamos significando hoje, no entanto, fica fora da hierarquia do modelo. Este” modelo selecionado ” substitui essencialmente todo o processo de seleção da hierarquia do modelo.

se um modelo de página personalizado foi selecionado no menu suspenso que mostramos acima, esse arquivo” modelo ” será usado. Ponto final, sem exceção.

para reafirmar que, se um modelo de página personalizado for selecionado, esse arquivo “modelo” será usado. Ponto final, sem exceção. Caso contrário, a hierarquia de modelos do WordPress procurará uma maneira um pouco diferente de alguém ter tentado estilizar uma página específica — com um arquivo page-123.php ou page-custom-template-utilizer.php. (A diferença entre o modelo personalizado e um com esta estrutura page-$id ou page-$slug é realmente apenas na interação e na interface.) Se nenhum desses for encontrado, o WordPress voltará a page.php, se existir, e se não, acabaríamos no último fallback, index.php.

se você está se perguntando por que usaria esse método em oposição ao numérico ou slug — em ambos os casos, você está criando um arquivo personalizado em seu tema, afinal — o motivo é que o uso de modelos personalizados oferece mais flexibilidade e independência entre o tema e o banco de dados e o conteúdo do seu site. Por esse motivo, eu recomendaria em quase todas as situações quando você não tiver certeza de qual ir. Com a estrutura numérica ou baseada em slug page-*.php, você é forçado a fazer seu tema saber sobre a maneira específica como seus dados de banco de dados do WordPress estão agora. (Então, se você reutilizar o tema em um site WordPress diferente, por exemplo, esse arquivo é inútil.)

Como faço um modelo de página personalizada do WordPress?

OK, então sabemos que os modelos de página personalizados superarão a hierarquia de modelos do WordPress. E que vamos fazer uso deles em páginas reais do nosso site WordPress, selecionando-os a partir de um menu suspenso “modelo” na barra direita da parte relevante do conteúdo. Portanto, é hora de chegar ao processo de criação de um modelo de página personalizada do WordPress.

o que você fará é adicionar ao seu tema (e realmente deve ser um tema filho, a menos que haja uma restrição muito forte tornando isso impossível para você) um arquivo com um nome como my-template.php ou really-cool-awesome.php. Não importa, desde que você não use um nome que faça parte da hierarquia do modelo, você é dourado. (O que significa: não use um nome como page-whatever.php. Como abordamos acima, a hierarquia de modelos do WordPress acha que possui um arquivo nomeado com esse padrão.)

depois de obter o arquivo (cool-page-template.php , do que você preferir), você deve iniciá – lo assim:

<?php/*Template Name: Name To Appear In The Dropdown*/?>This is my custom template.

e você está basicamente feito. Como você provavelmente pode imaginar, o nome que aparecerá na lista suspensa “Modelo” é o que eu habilmente chamei de “nome para aparecer na lista suspensa.”Assim como o arquivo style.css do seu tema, ou o arquivo principal de um plugin, o WordPress usa as informações dentro deste comentário de código para fornecer contexto para funcionar.

então o conteúdo de nossas páginas será, neste caso, o texto HTML muito básico “este é o meu modelo personalizado”. Como você pode imaginar, aqui é onde você tem muito mais probabilidade de colocar o conteúdo HTML que deseja que apareça na página. Portanto, suas tags <h1>, tags <p> e talvez (se você quiser) algum PHP para fazer um comportamento personalizado que deseja exibir.

por que seu modelo de página personalizada do WordPress não aparece

eu (mais de uma vez) tive a experiência de que meu novo modelo de página do WordPress não aparece. De longe, a causa mais comum é que eu digitei (ou não lembrei) como deve ser o comentário do cabeçalho do arquivo. Ele precisa ser rotulado com o título correto preciso. Portanto, Template Name: Narrow Page é perfeito, mas o WordPress nunca localizará algo que tenha um cabeçalho de Template: Custom.

existem algumas outras coisas para verificar. Outras razões pelas quais você pode achar que seu modelo de página personalizado não está aparecendo:

• você coloca o arquivo no lugar errado (ele precisa estar em seu tema em execução atual ou em seu pai)
• você deu ao seu modelo um arquivo que começa com page-. Devido a um recurso de temas do WordPress, os modelos de página personalizados que começam com page- são tratados como página da hierarquia de modelos.
• seu tema está faltando um de seus dois arquivos require e, portanto, não está funcionando. (Temas WordPress * deve * ter um arquivo index.php e um style.css.)
• houve um problema com esta de volta nos dias de WordPress 4.9 (alguns anos atrás, agora)

Modelos de Página para não”Página” WordPress Tipos de Pós Personalizado

Para uma grande parte do WordPress história, estes “modelos de página personalizados” eram apenas para a “Página” tipo de conteúdo. (O WordPress tem apenas dois tipos de conteúdo, “postagens” e “páginas” por padrão.) Mas no WordPress 4.7, foi adicionado o recurso de que você poderia usar esses modelos de página com novos tipos de conteúdo (geralmente chamados de “tipos de postagem personalizados”).

para fazer isso, você adiciona outra linha ao seu “cabeçalho do arquivo.”Então ficaria um pouco assim:

<?php/*Template Name: Narrower TemplateTemplate Post Type: post, page, event*/// Page HTML and PHP goes here...

como você provavelmente pode imaginar, este novo cabeçalho Template Post Type: prefacia o nome” Nível de código ” para os tipos de postagem (personalizados). Você notará que no exemplo acima, listamos o tipo de conteúdo page fornecido pelo WordPress, bem como o post. Além disso, estamos suportando um terceiro “tipo de postagem personalizada” chamado event.

um ótimo motivo para usar modelos de página personalizados

agora, se você já fez isso antes, notará que a página acima não terá estilo e se parecerá muito pouco com o resto do seu site WordPress (a menos que você tenha o tema mais simples imaginável). Isso porque nosso arquivo tem uma coisa simples e carece de funcionalidade muito comum em todas as outras páginas de tema. Não tem get_header(), get_footer(), ou o Loop, chama que todos os seus outros arquivos de tema provavelmente fazem.

às vezes você quer uma página que não é muito parecido com o resto do seu site, mas ainda uma parte de sua experiência de gerenciamento WordPress. Esses modelos personalizados são perfeitos para isso.

mas ilustra um dos grandes poderes de modelos personalizados como estes também: às vezes você quer uma página que não seja muito parecida com o resto do seu site, mas ainda faz parte da sua experiência de Gerenciamento do WordPress. Esses modelos personalizados são perfeitos para isso. Embora você os veja usados também para páginas de arquivos ou (menos comumente) páginas de contato, essa capacidade geralmente é negligenciada.

E, Finalmente, Alguns Conselhos Práticos Sobre Modelos de Página

Quando você estiver olhando para fazer a página que se parece com outras páginas (mas um pouco diferente) eu ia realmente começar copiando um arquivo existente de seu tema, provavelmente page.php. Isso ocorre simplesmente porque a maioria de nós acha mais fácil mudar algo do que construir do zero. O exemplo de código fornece ao seu modelo de página o sentido de “página branca em branco”, onde você provavelmente deseja adicionar ou remover alguns detalhes específicos do modelo page.php existente. Remover a barra lateral ou o rodapé, por exemplo, são razões muito comuns pelas quais as pessoas fazem um “modelo de página personalizado” no WordPress.

como cobrimos, se você duplicar o arquivo page.php do seu tema para começar a criar seu modelo de página personalizado, você precisará adicionar o “cabeçalho do modelo de página personalizado” que temos acima. Novamente, essa é a página” mágica ” que faz com que esses modelos funcionem. Agora, vá fazer páginas incríveis!

crédito da imagem: Infrogmation