Codex

Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

pt-br:Modelos de Páginas

O Modelo de página é um arquivo criado para opcionalmente modificar a apresentação do conteúdo de páginas estáticas WordPress. Exemplos de uso:

  • Uma página "Mapa do Site" e aplicar um modelo que lista todos os posts e categorias de seu site.
  • Uma página "Contato" e aplicar um modelo que possui código para um formulário avançado em PHP
  • Uma página "Links" que mostra todos os links de sua categoria Links.

Criar um arquivo de tema e criar um arquivo de modelo de página são coisas diferentes.

Um arquivo de tema é qualquer arquivo usado pelo WordPress em vários contextos. Estes arquivos devem ter nomes específicos para que o WordPress automaticamente identifique estes arquivos. (Veja em Hierarquia de Modelos WordPress).

Um arquivo de modelo para páginas é usado em páginas criadas dentro do WordPress, através de seu painel. Este arquivo não é usado pelo WordPress diretamente mas por páginas que forem instruídas a usá-lo.

Enquanto os temas devem ter alguns arquivos obrigatória mente, os arquivos de Modelo são opcionais, há temas que possuem vários ou nenhum arquivo de modelo.

Sobre Modelos de Páginas

atributos.gif
A caixa Atributos de Página


Para ver se seu tema possui Modelos de páginas, acesse o painel de criação de páginas em Páginas > Adicionar Nova, do lado direito da tela, você vai encontrar a caixa Atributos de Página.

Características de Modelos:

  • O arquivo de modelo pode conter qualquer código, mas observe que para obter dados do WordPress é preciso usar PHP.
  • É possível criar qualquer layout com modelos, mas eles só podem ser usados em páginas do WordPress. Para modificar o layout definitivamente é indicado modificar arquivo do tema.
  • A lista suspensa não aparece se o tema não possuir pelo menos um arquivo de modelo.
  • A documentação do tema geralmente vai dizer se o tema possui modelos e para que tipo de conteúdo são indicados.
  • Você só pode usar um modelo por página mas pode usar o mesmo modelo em várias páginas ao mesmo tempo.

Criando Arquivos de Modelos

1. Na pasta do seu tema, crie um arquivo php, por exemplo: modelo-contato.php. 2. No início do arquivo, adicione:

<?php
/*
Template Name: Contato
*/
?>

3. Para que o modelo não quebre o layout do site, é bom seguir a estrutura de um arquivo existente, por exemplo, page.php. É possível ter um layout totalmente novo só usando o modelo.

Nunca copie um arquivo de modelo na mesma pasta, sem modificar o cabeçalho do modelo, isso gera conflito, já que cada modelo tem que ter um nome único (o item Template Name).

Links Externos


brasil-1.png
A documentação do WordPress em Português do Brasil.
Todas as comunidades lusófonas também são bem-vindas! Adicione {{Codex-pt}} em seus artigos.