Comment register_sidebar () et get_sidebar () fonctionnent-ils ensemble?

Avertissement: je suis tout nouveau sur WP.

J'utilise le thème du framework Starkers HTML5 . Dans le functions.phpje vois ce code:

function starkers_widgets_init() {

  // Area 1, located at the top of the sidebar.
  register_sidebar( array(
    'name' => __( 'Primary Widget Area', 'starkers' ),
    'id' => 'primary-widget-area',
    'description' => __( 'The primary widget area', 'starkers' ),
    'before_widget' => '<li>',
    'after_widget' => '</li>',
    'before_title' => '<h3>',
    'after_title' => '</h3>',
  ) );

  // Area 3, located in the footer. Empty by default.
  register_sidebar( array(
    'name' => __( 'First Footer Widget Area', 'starkers' ),
    'id' => 'first-footer-widget-area',
    'description' => __( 'The first footer widget area', 'starkers' ),
    'before_widget' => '<li>',
    'after_widget' => '</li>',
    'before_title' => '<h3>',
    'after_title' => '</h3>',
  ) );

  // ... more calls to register_sidebar() ... 
}

Et footer.phpje vois ce code:

<?php get_sidebar( 'footer' ); ?>

Je ne comprends pas comment get_sidebar()sait prendre cet argument de chaîne et trouver les widgets appropriés qui ont été définis par register_sidebar(). Dans l'extrait de functions.php que j'ai publié ci-dessus. Il n'y a aucune mention de « pied de page » , sauf pour les name, idet les descriptionpropriétés. Mais il me semblerait étrange de get_sidebar()rechercher un «pied de page» à l'intérieur de ces propriétés.

Est-ce que cela a du sens ce que je demande? Y a-t-il une pièce manquante?

Les raisons que je demande sont parce que - je voudrais en savoir plus sur l'architecture WP - je voudrais pouvoir définir une zone de widget personnalisée et savoir comment la rendre sur une page spécifique.

Merci beaucoup.

Vous appelez juste get_sidebar()de index.phpet il charge le fichier thème sidebar.php.

register_sidebar(), d'autre part, est utilisé pour les widgets où les plugins et autres souhaitent ajouter dynamiquement du contenu dans votre sidebar.phpfichier si votre thème le prend en charge.

Dans votre cas, y a-t-il un fichier appelé sidebar-footer.phpdans le répertoire de votre thème?

Je ne m'en suis jamais soucié get_sidebar(). Au lieu de cela, je l'utilise dynamic_sidebar(). Vous l'appeleriez comme ceci:

dynamic_sidebar('first-footer-widget-area');

Et cela prend en charge toute la barre latérale. Plus d'inclusions de fichiers, plus de dossiers de thèmes encombrés. Si je veux avoir 5 barres latérales différentes, il n'ajoute aucun fichier, seulement des fonctions supplémentaires functions.php.

get_sidebar('name')obtient un modèle de barre latérale du nom sidebar-name.php .

Dans sidebar-name.php, il y a le code HTML de la barre latérale, et un appel à dynamic_sidebar('some-name-hopefully-the-same'), qui est là où iront les widgets.

register_sidebar(array(name=>'some-name-hopefully-the-same', ...)) est ce qui permet à dynamic_sidebar de fonctionner.

Comme vous pouvez le voir, get_sidebar(templatename)est destiné à être utilisé avec les modèles de barre latérale. Si vous n'en avez pas besoin, vous pouvez simplement appeler dynamic_sidebar(sidebarname)directement à partir de votre thème.

get_sidebar('footer')tente de charger à sidebar-footer.phppartir du thème actif. Starkers fournit ce fichier. Vérifiez starkers/sidebar-footer.phpet les choses devraient devenir claires.