Codex

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

pt-br:Cabeçalhos Personalizados


cb-help.png
Ajuda ao Usuário WordPress
Referência da Ajuda Contextual - Este artigo é acessado a partir da Ajuda Contextual do WordPress PT-BR.
Procure nosso Fórum Oficial se precisar de mais ajuda sobre este assunto.

Cabeçalhos Personalizados é um recurso encontrado em alguns temas que permite definir uma imagem para ser mostrada no cabeçalho do site, como uma imagem de cabeçalho ou mesmo logo.


cb-warning.png
Artigo ou Seção com explicações avançadas
A seguir, estão explicações ou instruções para usuários avançados, o que pode exigir o conhecimento de termos e ferramentas não comuns a todas as pessoas.
Adicione {{Avançado}} para usar esta caixa.

Adicionando o recurso em temas

Desde a versão 3.4, os temas precisam usar a função add_theme_support() em seu arquivo functions.php para oferecer o recurso de definir imagem de cabeçalho,isso já é o suficiente:

add_theme_support( 'custom-header' );

Note que você pode adicionar argumentos:

$defaults = array(
	'default-image'          => '',
	'random-default'         => false,
	'width'                  => 0,
	'height'                 => 0,
	'flex-height'            => false,
	'flex-width'             => false,
	'default-text-color'     => '',
	'header-text'            => true,
	'uploads'                => true,
	'wp-head-callback'       => '',
	'admin-head-callback'    => '',
	'admin-preview-callback' => '',
);
add_theme_support( 'custom-header', $defaults );

Exemplos

A. Adicionando um cabeçalho predefinido de 980x60 de pixel, da pasta de imagens do tems
$args = array(
	'width'         => 980,
	'height'        => 60,
	'default-image' => get_template_directory_uri() . '/images/header.jpg',
);
add_theme_support( 'custom-header', $args );
B. Define um cabeçalho padrão mas permitindo que o administrador do site envie outras imagens
$args = array(
	'width'         => 980,
	'height'        => 60,
	'default-image' => get_template_directory_uri() . '/images/header.jpg',
	'uploads'       => true,
);
add_theme_support( 'custom-header', $args );
C. Permitindo usar imagens para o cabeçalho com largura ou altura variáveis
$args = array(
	'flex-width'    => true,
	'width'         => 980,
	'flex-height'    => true,
	'height'        => 200,
	'default-image' => get_template_directory_uri() . '/images/header.jpg',
);
add_theme_support( 'custom-header', $args );

Mostrando no tema

Você precisa adicionar chamadas no arquivo do tema onde deseja mostrar a imagem, geralmente no arquivo header.php, por exemplo:

<img src="<?php header_image(); ?>" height="<?php echo get_custom_header()->height; ?>" width="<?php echo get_custom_header()->width; ?>" alt="" />

A função header_image obtém a URL direta para o arquivo de imagem definido com a imagem de cabeçalho.

Funções relacionadas

Nota: a documentação a seguir ainda está em inglês:

Páginas da Ajuda acessada nos Painéis de Administração
VE
PaineisPainel Comentários Painel Discussão Painel Escrita Painel Exportar Painel Ferramentas-Disponíveis Painel Fundo Painel Geral| Painel Importar Painel Início Painel Leitura Painel Links Permanentes Painel Mídia Painel Mídia-Adicionar Nova Painel Menus Painel Meus Sites Painel Páginas-Todas as Páginas Painel Plugins-Instalados Painel Posts-Adicionar Novo Painel Rede Painel Tags Painel Temas Painel Todos os Links Painel Usuários-Seu perfil Painel Widgets
RecursosPublique Isso Resumo Cabeçalhos PersonalizadosCampos Personalizados Formatos de Posts
Rede e MultisiteCrie uma RedeDepurando uma Rede WordPress
DesenvolvimentoAPI WordPress XML-RPC Escrevendo um Plugin Funções e Capacidades Widgets em Temas
OutrosAtalhos de Teclado Glossário Formatando Data e Hora Primeiros Passos com o WordPress Spam em Comentários Usando Links Permanentes Cookies