WordPress.org

Ready to get started?Download WordPress

Codex

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

pt-br:get template part

Contents

Descrição

Carrega uma seção dentro de um template (exceto nos modelos header, sidebar e footer). Facilita o reuso de pedaços de código, podendo também ser usado por temas filhos para substituir seções criadas no tema pai.

Inclui a parte descrita no tema. Se o tema não possuir o arquivo {slug}.php, então nada será adicionado.

Uso

 <?php get_template_part$slug$name ); ?> 

Parameters

$slug
(string) (required) O slug do template genérico.
Default: None
$name
(string) (opcional) O nome do template específico.
Default: None

Exemplos

Usando o loop.php em temas filhos

Caso a pasta do tema seja wp-content/themes, o tema pai seja o twentytwelve e o tema filho seja twentytwelvechild, então o código

<?php get_template_part( 'loop', 'index' ); ?>

executará a função require() do PHP para o primeiro arquivo que encontrar, respeitando a seguinte prioridade:

  1. wp-content/themes/twentytwelvechild/loop-index.php
  2. wp-content/themes/twentytwelve/loop-index.php
  3. wp-content/themes/twentytwelvechild/loop.php
  4. wp-content/themes/twentytwelve/loop.php

Usando em subpastas do tema

Para usar esta função em subpastas de seu tema, simplesmente adicione o nome do diretório antes do slug. Por exemplo, se você possui uma pasta chamada parts dentro do seu tema e, nessa subpasta, um arquivo content-page.php, é possível usar a função da seguinte maneira:

<?php get_template_part( 'parts/content', 'page' ); ?>

Navegação

Adiciona uma barra de navegação usando um arquivo genérico chamado nav.php:

<?php get_template_part( 'nav' );           // Barra de navegação (nav.php) ?>
<?php get_template_part( 'nav', '2' );      // Barra de navegação #2 (nav-2.php) ?>
<?php get_template_part( 'nav', 'single' ); // Barra de navegação para páginas (nav-single.php) ?>

Notas

Change Log

Arquivo fonte

A função get_template_part() está localizada em wp-includes/general-template.php.

Referências externas

Relacionados

Include Tags

See also index of Function Reference and index of Template Tags.