Languages: English • Headers 日本語 Português do Brasil • (Add your language)

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.

• Veja também: Painel Cabeçalho

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: