web-dev-qa-db-fra.com

Utilisez 'add_theme_support' au lieu de 'add_custom_image_header' dans WordPress 3.4

Je débogue mon thème en utilisant Debug Bar plugin, qui me montre cette erreur (parmi quelques autres):

Remarque: add_custom_image_header est déconseillé depuis la version 3.4! Utilisez add_theme_support( 'custom-header', $args ) à la place.

D'accord, clairement, il est dit que je dois utiliser ceci au lieu de ceci . La question est, add_custom_image_header a trois paramètres, à savoir:

  • $ header_callback
  • $ admin_header_callback
  • $ admin_image_div_callback

Comment puis-je les représenter dans la fonction add_theme_support? Comme ça?

$aahan_custom_header_args = array(
    'wp-head-callback'       => '',
    'admin-head-callback'    => '',
    'admin-preview-callback' => '',
);
add_theme_support( 'custom-header', $aahan_custom_header_args );

De plus, wp-head-callback, admin-head-callback et admin-preview-callback sont-ils les remplacements exacts de $header_callback, $admin_header_callback et $admin_image_div_callback respectivement?

functionsdeprecation
3
its_me

Veuillez lire Mise à jour des arrière-plans et des en-têtes personnalisés pour WordPress 3.4 .

En-têtes personnalisés

Ancienne méthode:

// Définition de la constante d'image d'en-tête par défaut 
 Define ('HEADER_IMAGE', get_template_directory_uri (). '/Images/headers/default.jpg'); 
 // Définition de la largeur d'image d'en-tête constante 
 define ('HEADER_IMAGE_WIDTH', 1000); 
 // Définir la constante de hauteur de l’en-tête 
 define ('HEADER_IMAGE_HEIGHT', 198); 
 // Définir une constante de texte pour l’en-tête 
 define ('NO_HEADER_TEXT', false); 
 // Définir la constante de couleur du texte de l'en-tête 
 define ('HEADER_TEXTCOLOR', '000'); 
 // Activer l'en-tête aléatoire rotation d'image par défaut. 
 // Requiert que HEADER_IMAGE soit null 
 add_theme_support ('custom-header', array ('random-default' => true)); 
 
 // Ajout du support du thème 
 Add_custom_image_header ($ wphead_cb, $ adminhead_cb, $ adminpreview_cb);

Nouvelle méthode:

add_theme_support ('custom-header', array (
 // Image d'en-tête par défaut 
 'default-image' => get_template_directory_uri (). '/images/headers/default.jpg',
 // Affichage du texte d'en-tête par défaut 
 'Header-text' => false, 
 // Couleur du texte d'en-tête par défaut 
 'Default-text-color' => '000' , 
 // Largeur de l'en-tête (en pixels) 
 'Width' => 1000, 
 // Hauteur de l'en-tête (en pixels) 
 'Height' = > 198, 
 // rotation aléatoire par défaut de l'image d'en-tête 
 'Random-default' => false, 
 // Rappel de style d'en-tête de modèle 
 'Wp-head- callback '=> $ wphead_cb, 
 // callback de style d'en-tête d'administrateur 
' admin-head-callback '=> $ adminhead_cb, 
 // Callback de style de prévisualisation d'administrateur 
 'admin-preview-callback' => $ adminpreviewview_cb 
));

Encore une fois: c'était facile, n'est-ce pas?

Juste pour clarifier, voici les équivalents old-constant/new-array-key:

HEADER_IMAGE => 'default-image' 
 HEADER_IMAGE_WIDTH => 'width' 
 HEADER_IMAGE_HEIGHT => 'hauteur' 
 NO_HEADER_TEXT => 'en-tête-texte' 
 HEADER_TEXTCOLOR = > 'default-text-color'

Tous les mêmes rappels sont pris en charge, exactement comme avant.

Pour référence, voici le tableau complet des valeurs par défaut:

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