Prérequis
- WordPress : Version 5.9 ou supérieure
- PHP : Version 7.0 ou supérieure
Installation
Pour l’installation du plugin, veuillez vous référer au tutoriel « Installer un plugin ».
Exemple
Contenu libre
À partir de posts (Query)
Paramètres de bloc
- Nombre de slides à afficher
- Slider en boucle
- Autoplay
- Vitesse pour l’autoplay
- Centrer la première slide
- Afficher la pagination (dots)
- Afficher la navigation (prev, next)
- Responsive: pour modifier les paramètres suivants en fonction de la taille de l’écran:
- Nombre de slides à afficher
- Afficher la pagination (dots)
- Afficher la navigation (prev, next)
Query
Dans le cadre d’un slider à partir de posts, un bloc query
est ajouté pour gérer les paramètres de la requête (type de contenu, tri, filtres). Ce bloc contient le bloc modèle de publication
pour vous permettre d’ajuster le contenu des slides.
Le rendu dans le back-office ne reflète pas le rendu sur le site.
- Type de publication
- Éléments par page – Nombre de slides
- Décalage (offset dans la requête)
- Ordre
- Ordonner par – Pour ordonner par meta value ou aléatoirement voir la partie « Personnalisation »
- Ordre (ASC ou DESC)
- Filtres – En fonction du type de publication choisie, permet de filtrer par taxonomie associée – si aucune taxonomie le paramètre ne s’affiche pas.
Personnalisation
Points de rupture (Breakpoints)
Par défaut le plugin ajoute les breakpoints suivants:
return [
["size"=>991,"prefix"=>'md'],
["size"=>767,"prefix"=>'sm'],
];
Ajouter un breakpoint
xxxxxxxxxx
add_filter("habefast_gutenberg_slider_get_breakpoints",function($array){
return array_merge([
["size"=>600,"prefix"=>"md"],
],$array);
},11);
Modifier un breakpoint
xxxxxxxxxx
//Comme le préfix est déjà utilisée, sa valeur sera remplacée
add_filter("habefast_gutenberg_slider_get_breakpoints",function($array){
return array_merge([
["size"=>600,"prefix"=>"md"],
],$array);
},11);
Suprimer un breakpoint
xxxxxxxxxx
add_filter("habefast_gutenberg_slider_get_breakpoints",function($array){
unset($array[1]);
return $array;
},11);
Textes
Boutons précédent et suivant
xxxxxxxxxx
add_filter("habefast_gutenberg_slider_global_options",function($array){
return [
"navText"=>["Prev","Next"],
];
},11);
Tri pour les sliders à partir de posts
Ordonner par meta value
Par défaut l’API Rest de WordPress ne prend pas en compte les requêtes utilisant des meta values, pour les activer, copier le code suivant dans le fichier functions.php
de votre thème:
xxxxxxxxxx
if(class_exists("HabefastGutenbergSliderRegister")){
HabefastGutenbergSliderRegister::allowMetaValueForPostTypeOrder("page");
}
La fonction autorise les metas values pour les pages, il faut remplacer « page » par « post » ou le slug d’un CPT pour d’autres types de contenus.
Ordonner aléatoirement
Cette fonctionnalité n’est pas activée par défaut dans l’API Rest de Worpress, copier le code suivant dans le fichier functions.php
de votre thème pour l’activer:
xxxxxxxxxx
if(class_exists("HabefastGutenbergSliderRegister")){
HabefastGutenbergSliderRegister::allowRandomForPostTypeOrder("page");
}
Il faut remplacer « page » par « post » ou le slug d’un CPT pour d’autres types de contenus.