L'essentiel de SPIP 3.1

Comprendre les boucles

TESTEZ LINKEDIN LEARNING GRATUITEMENT ET SANS ENGAGEMENT

Tester maintenant Afficher tous les abonnements
Les boucles de SPIP vont permettre d'afficher les contenus du site dans les squelettes. C'est ce que vous allez comprendre ici.
06:24

Transcription

Dans la séquence précédente, nous avons vu comment fonctionnaient les squelettes. Et bien maintenant, nous allons voir dans cette séquence comment nous allons pouvoir afficher le contenu dans ces fameux squelettes. Les contenus vont être affichés grâce aux boucles. Les boucles SPIP permettent d'afficher des contenus, dont on va déterminer le type, et nous l'avons vu, ces contenus sont stockées dans les tables de la base de données. Les boucles qui sont un langage propres à SPIP vont permettre de répéter une action avec de l'HTML ou avec des éléments SPIP spécifiques, pour chaque élément trouvé dans la boucle, pour chaque itération. Voici la syntaxe standard d'une boucle SPIP. Nous avons dans un premier temps, le mot-clé « BOUCLE ». Le mot-clé BOUCLE est toujours écrit en majuscule, et doit toujours être présent. Nous avons ensuite un underscore, suivi par le nom de la boucle. Le nom de la boucle, vous le déterminez comme vous le souhaitez. Usuellement, on le place en minuscule. Et ce nom de boucle doit être unique dans le squelette. Ensuite, entre parenthèses, nous allons déterminer le type, c'est à dire le type de contenu que l'on va afficher. Puis, ensuite, entre accolades, nous avons les critères. Nous le verrons par la suite, les critères permettent de spécifier plus précisément quel est le type de contenu que l'on va afficher. Et ensuite nous avons la fin de la boucle. Vous voyez que l'on a une syntaxe qui est très proche de celle de l'HTML. Et à l'intérieur de notre boucle, nous allons pouvoir insérer le code HTML et le code SPIP que nous voulons voir être répétés à chaque itération de la boucle. Voici des petits exemples sur les types de boucle. Nous avons ici un exemple d'une boucle qui travaille sur les articles. Ici, le nom de cette boucle s'appelle tout simplement « articles ». Même chose pour les rubriques, nous avons entre parenthèses le mot-clé « rubriques ». Même chose pour les auteurs. Donc les libellés ARTICLES, RUBRIQUES et AUTEURS, qui correspondent aux titres, sont strictement déterminés. Sur le site de SPIP, à cet URL, spip.net/@ vous avez ici la liste de toutes les boucles qui sont disponibles. La boucle des articles, la boucles des auteurs, des brèves, des data, des documents, des forums etc. Pour chaque boucle, vous avez le détail de son utilisation. Par exemple, ici je me mets sur la boucle des articles, et j'affiche la page consacrée à la boucle ARTICLES. Et donc ici, vous avez toute la syntaxe de la boucle ARTICLES. Voyons maintenant les critères dans les boucles, Les critères permettent de préciser les données qui sont à sélectionner et à afficher, et on peut aussi les classer si cela s'avère nécessaire. Alors sachez qu'une boucle peut avoir un seul critère. Le critère, à ce moment-là, est indiqué entre accolades. Mais on peut avoir naturellement plusieurs critères lorsqu'on a des données très fines à afficher. À ce moment-là, il suffit de placer les critères les uns derrière les autres, chaque critère étant entre accolades. Le critère 1 va s'exécuter en premier, puis le 2, puis le 3. Nous allons maitenant pouvoir spécifier des boucles complètes. Cela va nous permettre d'insérer du code à plusieurs endroits. Cela nous permettre d'insérer du code avant la première itération de la boucle, ensuite pour chaque itération de la boucle et ensuite pour la dernière itération, et enfin pour terminer, indiquer le code nécessaire si jamais il n'y a pas de données à afficher. C'est extrêmement pratique. Cela permet effectivement d'éviter d'insérer du code HTML superflu si jamais il n'y a pas de données à afficher. Voilà la syntaxe d'une boucle complète. Nous avons ici notre boucle classique, et au-dessus, nous avons, si on peut dire, une surboucle. Vous voyez que cette surboucle reprend le même nom que la boucle. Ici, ma boucle et on retrouve ici, ma boucle. Et la surboucle reprend comme préfixe B, en majuscule, underscore, suivi par le nom de la boucle. Donc nous avons ici l'ouverture, la fermeture, et la deuxième fermeture pour spécifier le code lorsqu'il n'y a aucun résultat à afficher. Donc détaillons cette structure de boucle complète. Donc nous avons la boucle complète en haut et en bas, avec son ouverture et sa fermeture. Ensuite, nous avons le code HTML qui doit être affiché avant chacune des itérations. Ensuite, nous avons notre boucle, avec le type et les critères, et dans cette boucle, comme on l'a vu précédemment, nous avons le code à afficher pour chaque itération dans la boucle. Ensuite, au sortir de la boucle standard, nous pouvons placer le code qui est à placer après toutes les itérations, donc après la boucle. Nous avons la fin de la surboucle, et enfin, très pratique si c'est nécessaire, nous pouvons spécifier quel doit être l'affichage s'il n'y a aucun résultat à afficher. Cela permet, comme on l'a vu précédemment, d'éviter d'avoir du code qui soit généré de manière inutile. Voyons un exemple précis. Voici le code qui va nous permettre d'afficher les cinq derniers articles dans une liste. Donc nous avons ici notre surboucle, et nous avons le premier élément à afficher avant la boucle. Donc comme nous souhaitons insérer les articles dans une liste ul, et bien je place l'élément ul à ce niveau-là, avant la boucle. Ensuite, nous avons la boucle proprement dite, qui va permettre de lister les cinq derniers articles. Suite à cette boucle, nous fermons l'élément ul. Et enfin, après, nous pouvons spécifier quel va être le code affiché si jamais il n'y a pas d'article. Nous l'affichons avant la fin de la surboucle, ici. Donc dans un simple élément p, j'indique qu'il n'y a pas d'article. Cette syntaxe de boucle complète, qui va nous permettre de parfaitement maitriser le code qui sera généré.

L'essentiel de SPIP 3.1

Apprenez à installer SPIP et à configurer ensuite le site web créé. Voyez comment gérer les contenus rédactionnels, les médias, les utilisateurs ainsi que leurs droits, etc.

3h10 (54 vidéos)
Aucun commentaire n´est disponible actuellement
 
Logiciel :
Thématiques :
Design web
CMS
Spécial abonnés
Date de parution :11 févr. 2016

Votre formation est disponible en ligne avec option de téléchargement. Bonne nouvelle : vous ne devez pas choisir entre les deux. Dès que vous achetez une formation, vous disposez des deux options de consultation !

Le téléchargement vous permet de consulter la formation hors ligne et offre une interface plus conviviale. Si vous travaillez sur différents ordinateurs ou que vous ne voulez pas regarder la formation en une seule fois, connectez-vous sur cette page pour consulter en ligne les vidéos de la formation. Nous vous souhaitons un excellent apprentissage avec cette formation vidéo.

N'hésitez pas à nous contacter si vous avez des questions !