A função que permite Background Personalizado WordPress add_custom_background()
usada no functions.php
, foi substituída pela função add_theme_support(‘custom-background’)
na versão 3.4. A função add_theme_support
define várias funcionalidades do tema ('post-formats', 'post-thumbnails', 'custom-background'
e nesse tutorial abordaremos o recurso de background customizado(
'custom-header', 'automatic-feed-links' e 'menus')custom-background
).
Diferente da função anterior add_custom_background()
que passávamos apenas funções de callback
nessa nova aplicação ele recebe um array
com as propriedades default(cores e imagem de background) e as funções de callback
(no wp_head, no admin_head e no preview do admin).
Ou seja, você pode definir funções que serão chamadas nesses 3 momentos.
Como adicionar background personalizado WordPress
Abaixo um exemplo de montagem dos argumentos para serem passados para função:
// como adicionar suporte a background personalizado WordPress
$defaults = array(
'default-color' => '',
'default-image' => '',
'wp-head-callback' => '_custom_background_cb',
'admin-head-callback' => '',
'admin-preview-callback' => ''
);
add_theme_support( 'custom-background', $defaults );
Code language: PHP (php)
Abaixo um exemplo simples:
$argumentos = array(
'default-color' => '000000',
'default-image' => get_template_directory_uri(). '/images/background.gif'
);
add_theme_support('custom-background', $argumentos);
Code language: PHP (php)
Esta aplicação acima lembrando tem de ser feita no arquivo functions.php
, ela define que a cor padrão do background
deve ser preto #000000
e a imagem de background padrão será a imagem background.gif
na pasta imagens dentro do seu tema.
Mas o exemplo anterior é específico para a versão 3.4 do WordPress, mas como fazer uma aplicação para versões anteriores até a 3.0 e para versão 3.4.
global $wp_version;
if ( version_compare( $wp_version, '3.4', '>=' ) ) {
$argumentos = array(
'default-color' => '000000',
'default-image' => get_template_directory_uri(). '/images/background.gif'
);
add_theme_support('custom-background', $argumentos);
}else{
add_custom_background();
}
Code language: PHP (php)
No tratamento acima verificamos através da variável global $wp_version qual a versão do WordPress, caso seja maior ou igual a 3.4 utilizamos add_theme_support
, caso inferior usamos a função antiga add_custom_background()
.
Gostou desse tutorial WordPress, confira mais posts sobre o assunto:
Deixe um comentário