WordPress
Barres latérales

Android CSS HTML JavaScript jQuery MySQL PHP Regular Expressions SQL twitter-bootstrap
Recherche…


Syntaxe

  • register_sidebar ($ args)
  • get_sidebar (string $ name = null)

Paramètres

Paramètre Détails
$ args (string | array) (Facultatif) Construit une barre latérale basée sur les vvalues name et id
$ nom * (string) (Facultatif) Nom de la barre latérale spécialisée. Valeur par défaut: null

Remarques

Les options d'argument sont:

  • name - Nom de la barre latérale (par défaut: "Sidebar" et ID numérique localisés) .
  • id - Identifiant de la barre latérale - Doit être tout en minuscule, sans espaces (par défaut: un ID numérique auto-incrémenté) . Si vous ne définissez pas la valeur de l'argument id, vous obtiendrez des messages E_USER_NOTICE en mode débogage, à partir de la version 4.2.
  • description - Description textuelle de quoi / où la barre latérale est. Montré sur l'écran de gestion des widgets. (Depuis 2.9) (par défaut: vide)
  • class - Classe CSS à affecter à la barre latérale de la page d'administration Apparence -> Widget. Cette classe n'apparaîtra que dans la source de la page d'administration de WordPress Widget. Il ne sera pas inclus dans la partie frontale de votre site Web. Remarque : La sidebar value sera ajoutée à la valeur de la classe. Par exemple, une classe de tal entraînera une valeur de classe de sidebar-tal . (par défaut: vide) .
  • before_widget - HTML à placer avant chaque widget (par défaut: <li id="%1$s" class="widget %2$s"> ) Remarque : utilise sprintf pour la substitution de variable
  • after_widget - HTML à placer après chaque widget (par défaut: </li>\n ) .
  • before_title - HTML à placer avant chaque titre (par défaut: <h2 class="widgettitle"> ) .
  • after_title - HTML à placer après chaque titre (par défaut: </h2>\n ) .

Enregistrement des barres latérales

Dans votre functions.php vous pouvez enregistrer de nouvelles barres latérales avec ce code 

/**
 * Registers sidebars
 *
 * @param array Array with default or specified array values
 * @since       1.0.0
 */
if ( function_exists( 'register_sidebar' ) ) {
    register_sidebar( array (
        'name'          => esc_html__( 'Primary Sidebar', 'mytheme'),
        'id'            => 'primary-widget-area',
        'description'   => esc_html__( 'The Primary Widget Area', 'mytheme'),
        'before_widget' => '<div id="%1$s" class="widget %2$s">',
        'after_widget'  => '</div>',
        'before_title'  => '<div class="sidebar-widget-heading"><h3>',
        'after_title'   => '</h3></div>',
    ) );

    register_sidebar( array (
        'name'          => esc_html__( 'Secondary Sidebar', 'mytheme'),
        'id'            => 'secondary-widget-area',
        'description'   => esc_html__( 'The Secondary Widget Area', 'mytheme'),
        'before_widget' => '<div id="%1$s" class="widget %2$s">',
        'after_widget'  => '</div>',
        'before_title'  => '<div class="sidebar-widget-heading"><h3>',
        'after_title'   => '</h3></div>',
    ) );
}

Vous pouvez ajouter autant de barres latérales que vous le souhaitez.

Obtenir la barre latérale

Vous pouvez également créer votre propre fichier de barre latérale dans le thème pour l'appeler sur différents modèles. Copiez et collez sidebar.php du thème en cours et changez le nom (ie sidebar-book.php)

Dans le modèle, vous pouvez appeler cette barre latérale en utilisant get_sidebar('book') . En utilisant cela, vous pouvez appeler différentes barres latérales sur différentes pages.



Modified text is an extract of the original Stack Overflow Documentation
Sous licence CC BY-SA 3.0
Non affilié à Stack Overflow