Défilement infini

type accepte deux valeurs différentes : scroll ou click. Ce paramètre permet de contrôler le comportement par défaut du Défilement infini. scroll permet le chargement automatique des articles lorsque le visiteur arrive en bas de la liste actuelle d’articles alors que click affiche le bouton Charger plus d’articles grâce auquel l’utilisateur contrôle à quel moment charger d’autres articles.

scroll est configuré par défaut mais si un thème possède des widgets de pied de page, il est possible de basculer sur click pour que les widgets soient accessibles.

L’argument footer_widgets accepte de nombreuses valeurs et indique si un thème possède ou nom des widgets de pied de page. Si des widgets de pied de page sont présents, le type de défilement sera défini sur click pour que les widgets soient accessibles.

Dans sa version la plus simple, un booléen true ou false peut être défini suivant que le pied de page doit toujours ou jamais s’afficher, respectivement.
De plus, l’argument footer_widgets acceptera une chaîne représentant l’ID de la colonne latérale ('sidebar-1', par exemple) ou un tableau des ID de colonnes latérales. Le code de Défilement infini vérifiera si la ou les colonnes latérales contiennent des widgets et configurera l’argument footer_widgets en conséquence.

Chaque fois que cela est possible, nous recommandons fortement de fournir les ID de colonnes latérales si un thème insère des zones de widget sous la liste d’articles. En procédant ainsi, les utilisateurs du thème bénéficient de la meilleure expérience, le type de défilement étant déterminé de manière dynamique sur scroll ou click. Cela dit, si le type de défilement du thème est défini sur click dès le départ, l’argument footer_widgets peut être omis en toute sécurité.

Si toutes ces options ne suffisent pas, le filtre infinite_scroll_has_footer_widgets est disponible pour la configuration d’une logique avancée. Le filtre doit retourner une valeur booléenne et peut être utilisé pour détecter la présence de menus de navigation ou un visiteur utilisant un appareil mobile.

L’argument wrapper se comporte de manière similaire à footer_widgets, à la différence qu’il accepte quelques valeurs différentes. Cet argument détermine si chaque ensemble d’articles supplémentaire est contenu ou non dans un élément div lors de l’ajout au conteneur spécifié dans l’argument précédent.
Si une valeur booléenne (true ou false) est spécifiée, les articles supplémentaires sont placés ou non entre balises div avec la classe infinite-wrap.

Pour placer les articles entre balises div avec une classe personnalisée, configurez l’argument wrapper sur une chaîne représentant la classe personnalisée.
Notez que l’argument wrapper n’accepte qu’une seule chaîne sans espace.

Il est généralement conseillé de placer les articles ajoutés entre balises div, sauf si cette pratique se traduit par un marquage non valide. Par exemple, si un thème utilise un élément de liste (ol, ul) pour afficher les articles, l’argument wrapper doit être désactivé pour que les éléments div n’apparaissent pas là où ils ne devraient pas.

Le Défilement infini utilise une boucle WordPress standard pour restituer les articles supplémentaires qu’il ajoute, ainsi que des éléments de modèles dans le formulaire content-{post format}.php. Si un thème comprend au moins content.php, il est alors possible d’omettre l’argument render. Voici la fonction de rendu par défaut que le Défilement infini utilise :

while( have_posts() ) {
 the_post();
 get_template_part( 'content', get_post_format() );
}

Si une personnalisation plus poussée est nécessaire ou si un thème n’utilise pas les éléments de modèle content, vous devez spécifier un nom de fonction pour l’argument render. Cette fonction sera utilisée pour générer le marquage du Défilement infini. Cette fonction doit inclure la partie while() de la boucle de WordPress et peut utiliser n’importe quelle fonction disponible pour le thème lors de la restitution des articles.

Par défaut, l’argument type contrôle le nombre d’articles chargés à chaque action du défilement infini. Pour le type scroll, sept (7) articles sont chargés chaque fois que le Défilement infini est activé. Pour le type click, la valeur « Les pages du blog doivent afficher au plus » du site trouvée sous Paramètres → Lecture est utilisée.
Si, toutefois, la mise en page d’un thème attend un certain nombre d’articles, l’argument posts_per_page remplacera les paramètres par défaut présentés dans le paragraphe précédent. Cette commande est avantageuse, par exemple, dans un thème possédant une mise en page sur trois colonnes où un nombre d’articles supérieur ou inférieur à trois entraînera une mise en page hétérogène.

/**
 * Ajoutez la prise en charge du thème pour le défilement infini.
 *
 * @utilise add_theme_support
 * @retourner aucune valeur
 */
function twenty_twelve_infinite_scroll_init() {
 add_theme_support( 'infinite-scroll', array(
 'container' => 'content',
 ) );
}
add_action( 'after_setup_theme', 'twenty_twelve_infinite_scroll_init' );

Si vous ne connaissez pas le thème Twenty Twelve, sachez qu’il utilise des éléments du modèle content-{post format}.php et ne possède pas de zone de widget sous les articles. Nous avons donc omis les arguments footer_widgets et render. En réalité, comme la valeur container correspond à la valeur par défaut, il est également possible d’omettre cet argument. Nous l’avons laissé pour plus de clarté.

/**
 * Ajoutez la prise en charge du thème pour le défilement infini.
 */
function twenty_eleven_infinite_scroll_init() {
 add_theme_support( 'infinite-scroll', array(
 'container' => 'content',
 'footer_widgets' => array( 'sidebar-3', 'sidebar-4', 'sidebar-5', ),
 'footer' => 'page',
 ) );
}
add_action( 'after_setup_theme', 'twenty_twelve_infinite_scroll_init' );

Le thème Twenty Eleven intègre deux zones de widget de pied de page qui ne seraient pas accessibles en faisant défiler la page du fait de l’ajout de nouveaux articles lorsque vous atteignez le bas de la page. Pour résoudre ce problème, nous avons inséré un tableau avec les ID de ces zones de widget dans footer_widgets. Désormais, si l’une de ces colonnes latérales possède un widget, notre extension Défilement infini le détecte et bascule automatiquement sur click (type de défilement où vous cliquez pour charger d’autres articles à la demande). De cette manière, le contenu de votre pied de page est toujours parfaitement accessible. Si votre thème comprend des widgets de pied de page, considérez cette approche afin d’améliorer sensiblement l’expérience de vos utilisateurs.

/**
 * Ajoutez la prise en charge du thème pour le défilement infini
 */
function twenty_ten_infinite_scroll_init() {
 add_theme_support( 'infinite-scroll', array(
 'container' => 'content',
 'render' => 'twenty_ten_infinite_scroll_render',
 'footer' => 'wrapper',
 ) );
}
add_action( 'after_setup_theme', 'twenty_ten_infinite_scroll_init' );
/**
 * Définissez le code de restitution à l’appel des articles,
 * Liaison aux éléments de modèles lorsque cela est possible.
 *
 * Remarque : doit définir une boucle.
 *
function twenty_ten_infinite_scroll_init() {
 get_template_part( 'loop' );
}

Le thème Twenty Ten utilise une structure de modèle légèrement différente pour restituer les articles. Nous devons donc proposer une fonction de rendu personnalisée au défilement infini.

Votre thème possède-t-il des widgets de pied de page ? Si des widgets figurent dans la zone de widget de pied de page, le Défilement infini basculera automatiquement sur le bouton « Articles plus anciens » pour garantir la possibilité de voir les widgets de pied de page sur votre site. Si vous souhaitez charger les articles pendant le défilement, vous pouvez insérer les widgets dans une autre zone de widget, comme la colonne latérale. Si votre thème ne possède que des zones de widget de pied de page, vous souhaiterez peut-être basculer sur un autre thème proposant davantage d’options de zone de widget.