racine uZine

Dans la même rubrique
Mise en page : manuel de référence
26 mai 2003
16 août 2002
15 juin 2002
11 décembre 2001
7 décembre 2001
2 juin 2001
22 mai 2001
20 mai 2001
18 mai 2001
16 mai 2001
14 mai 2001
3 mai 2001
 
jeudi 24 mai 2001

La boucle ARTICLES

par l’équipe de SPIP

Une boucle d’articles se code en plaçant ARTICLES
(avec un « s ») entre parenthèses :

Les éléments contenus dans une telle boucle sont des articles.

Remarque. Une boucle ARTICLES ne retourne que des articles publiés. (Il n’existe aucun moyen d’afficher les articles « en cours de rédaction », « proposés à la publication » ou « refusés ».)

Les critères de sélection

On utilisera l’un ou autre des critères suivants pour indiquer comment on sélectionne les éléments.

- {tout} les articles sont sélectionnés dans l’intégralité du site (dans toutes les rubriques). Utile notamment pour afficher les articles les plus récents (dans l’intégralité du site) sur la page d’accueil. [En réalité, le critère « tout » n’est pas traité de manière informatique : c’est un aide-mémoire pour le webmestre ; on obtient le même résultat en n’indiquant aucun des critères suivants.]

- {id_article} retourne l’article dont l’identifiant est id_article. Comme l’identifiant de chaque article est unique, ce critère ne retourne qu’une ou zéro réponse.

- {id_rubrique} retourne la liste des articles contenus dans la rubrique id_rubrique.

- {id_secteur} retourne les articles dans ce secteur (un secteur est une rubrique qui ne dépend d’aucune autre rubrique, c’est-à-dire située à la racine du site).

- [SPIP 1.4] {branche} : le critère {branche} retourne l’ensemble des articles de la rubrique ET de ses sous-rubriques. (C’est une sorte d’extension du critère {id_secteur}. Toutefois, à l’inverse de {id_secteur=2}, il n’est pas possible d’appeler directement une branche en faisant par exemple {branche=2} : techniquement parlant, il faut que la rubrique en question figure dans le contexte courant. Ce critère est à utiliser avec parcimonie : si votre site est bien structuré, vous ne devriez pas en avoir besoin, sauf dans des cas très particuliers.)

- {id_auteur} retourne les articles correspondant à cet identifiant d’auteur (utile pour indiquer la liste des articles écrits par un auteur).

- {id_mot} retourne les articles correspondant à cet identifiant de mot-clé (utile pour indiquer la liste des articles traitant d’un sujet donné).

- [SPIP 1.3] {titre_mot=xxxx}, ou {type_mot=yyyy} retourne les articles liés au mot-clé dont le nom est « xxxx », ou liés à des mots-clés du groupe de mots-clés « yyyy ». Attention, on ne peut pas utiliser plusieurs critères {titre_mot=xxxx} ou {type_mot=yyyy} dans une même boucle.

- [SPIP 1.4] {id_groupe=zzzz} permet de sélectionner les articles liés à un groupe de mots-clés ; principe identique au {type_mot} précédent, mais puisque l’on travaille avec un identifiant (numéro du groupe), la syntaxe sera plus « propre ». [Nota : Ce critère n’est pas (en l’état actuel du développement de SPIP) cumulable avec le précédent {type_mot=yyyy}]

- {recherche} retourne les articles correspondant aux mots indiqués dans l’interface de recherche (moteur de recherche incorporé à SPIP). Voir la page consacrée au moteur de recherche.

Les critères d’affichage

Une fois fixé l’un des critères ci-dessus, on pourra ajouter les critères suivants pour restreindre le nombre d’éléments affichés.

- Les critères communs à toutes les boucles s’appliquent évidemment.

- {exclus} permet d’exclure du résultat l’article dans lequel on se trouve déjà (par exemple, lorsque l’on affiche les articles contenus dans la même rubrique, on ne veut pas afficher un lien vers l’article dans lequel on se trouver déjà).

- {doublons} ou {unique} (ces deux critères sont rigoureusement identiques) permettent d’interdire l’affichage d’articles déjà affichés dans d’autres boucles elles-mêmes marquées {doublons}.

Les balises de cette boucle

Les balises tirées de la base de données

Les balises suivantes correspondent aux éléments directement tirés de la base de données. Vous pouvez les utiliser également en tant que critère de classement (par exemple : {par date} ou {par titre}).

- #ID_ARTICLE affiche l’identifiant unique de l’article. Utile pour fabriquer des liens hypertextes non prévus (par exemple vers une page « Afficher au format impression ».

- #SURTITRE retourne le surtitre.

- #TITRE retourne le titre de l’article.

- #SOUSTITRE retourne le soustitre.

- #DESCRIPTIF retourne le descriptif.

- #CHAPO retourne le texte d’introduction (chapeau).

- #TEXTE retourne le texte principal de l’article.

- #PS retourne le post-scriptum.

- Les dates : #DATE, #DATE_REDAC, #DATE_MODIF sont explicitées dans la documentation sur « La gestion des dates ».

- #ID_RUBRIQUE est l’identifiant de la rubrique dont dépend l’article.

- #ID_SECTEUR est l’identifiant du secteur dont dépend l’article (le secteur étant la rubrique située à la racine du site).

- #VISITES est le nombre de visites sur cet article.

- #POPULARITE donne le pourcentage de popularité de cet article, voir la documentation La « popularité » des articles.

Les balises calculées par SPIP

Les éléments suivants sont calculés par SPIP. (Ils ne peuvent pas être utilisés comme critère de classement.)

- #NOTES les notes de bas de page (calculées à partir de l’analyse du texte).

- #INTRODUCTION : [SPIP 1.4] si l’article contient un descriptif, c’est celui-ci qui est utilisé ici ; sinon, SPIP affiche les 600 premiers caractères du début de l’article (chapeau puis texte). [SPIP 1.3] Dans les versions précédentes de SPIP, ce sont systématiquement les premiers caractères de l’article (chapeau puis texte) qui sont pris en compte (le descriptif n’est pas utilisé).

- #LESAUTEURS les auteurs de cet article. Cela permet d’éviter de créer une boucle AUTEURS pour obtenir le même résultat.

- #URL_ARTICLE est l’URL de la page de l’article.

- #FORMULAIRE_FORUM fabrique l’interface permettant de poster un message répondant à cet article.

- #FORMULAIRE_SIGNATURE fabrique l’interface permettant de signer la pétition associée à cet article.

- #PARAMETRES_FORUM fabrique la liste des variables exploitées par l’interface du formulaire permettant de répondre à cet article. Par exemple :
- [<A HREF="forum.php3?(#PARAMETRES_FORUM)">Répondre à cet article</A>]

Les logos

- #LOGO_ARTICLE le logo de l’article, éventuellement avec la gestion du survol.

- #LOGO_ARTICLE_RUBRIQUE le logo de l’article, éventuellement remplacé par le logo de la rubrique s’il n’existe pas de logo spécifique à l’article.

- #LOGO_RUBRIQUE le logo de la rubrique de l’article.

Les logos s’installent de la manière suivante :

[(#LOGO_ARTICLE|alignement|adresse)]

L’alignement peut être left ou right. L’adresse est l’URL de destination du lien de ce logo (par exemple #URL_ARTICLE). Si l’on n’indique pas d’adresse, le bouton n’est pas cliquable.

Si l’on veut récupérer directement le nom du fichier du logo (alors que les balises précédentes fabriquent le code HTML complet pour insérer l’image dans la page), par exemple pour afficher une image en fond de tableau, on utilisera le filtre |fichier comme suit : [(#LOGO_ARTICLE|fichier)]

Par ailleurs deux balises permettent de récupérer un seul des deux logos :
- #LOGO_ARTICLE_NORMAL est le logo sans survol ;
- #LOGO_ARTICLE_SURVOL est le logo de survol.

 
 
l’équipe de SPIP
Imprimer
format impression
l’équipe de SPIP
23 septembre 2001
1er juin 2001
23 septembre 2001
 
SPIP
Web indépendant


doublons (ou unique)
8 septembre 2001, message de Perline
 

Bonjour,
J’essaie d’utiliser doublons ou unique et les articles affichés le dont quand même dans les deux parties de la page.

La boucle (appelons-la première) où j’ai mis doublons est avant la boucle des articles de la rubrique que je veux exclure de la première.

Est-ce cela la raison ?
Je n’ai rien trouvé qui le précise.

Merci

 
Répondre
> doublons (ou unique), ARNO*, 8 septembre 2001

Salut Perline,

(Avant tout, il vaut mieux venir sur la liste SPIP pour ce genre de questions, ça permet de faire profiter tout le monde de la discussion. De plus, ça te permettrait de balancer intégralement dans ton mail le code que tu as mis dans ton squelette, on pourrait plus facilement te renseigner.)

D’après ton explication, tu as utilisé "doublons" dans la première boucle seulement. Or, il faut utiliser "doublons" dans toutes les boucles destinées à s’exclure.

Répondre


> 5. La boucle ARTICLES
10 août 2001
 

Salut,

Je cherche à modifier la page d’accueil du site de manière à pouvoir présenter sur cette page le dernier article de chaque rubrique. Exactement comme sur la page d’accueil de www.uzine.net où en bas de page, les articles sont affichés par rubriques.

Est-ce possible ? Je n’y arrive pas en fixant le n° de la rubrique directement en code PHP dans la source de la page, ni en définissant le critère de la boucle article du style id_rubrique=1

D’avance merci

Répondre
> > 5. La boucle ARTICLES, Oelita, 11 août 2001

J’ai eu le même souci et ai trouvé ma solution. C’est peut-être la même pour toi :

Si les articles cherchés sont dans des sous-rubriques de ta rubrique, tu ne peux pas les trouver comme ça.

Si ta rubrique est à la racine de ta hierarchie, tu peux par contre utiliser le critère id_secteur=1 qui fonctionne très bien pour récupérer tous les articles des sous-rubriques.

De plus, si tu veux un id_secteur parmi un ensemble de valeurs (1 ou 3 par exemple), tu peux utiliser le critère par forme régulière suivant : id_secteur==[1,3].

Oelita qui planche elle aussi sur sa page d’accueil

Répondre


> 5. La boucle ARTICLES
9 juillet 2001, message de Maxou
 

Bonjour et Bravo pour SPIP !

Je souhaite rajouter des champs dans la base de donnée spip_articles, par exemple "lieu" ou "type d’article" (éditorial, idées, nouvelle,...). Comment faire pour ensuite créer les balises afférentes ? (#LIEU, #TYPE_ARTICLES,...) afin de pouvoir l’intégrer dans mes boucles ?

Répondre
> > 5. La boucle ARTICLES, 9 juillet 2001

Hum : mission impossible, faut entrer dans le code de inc-calcul.php3, et modifier l’interface et le code de /ecrire pour intégrer les nouveaux éléments.

Résultat immédiat : vous ne pourrez plus faire de mises à jour de SPIP, qui écraseraient toutes vos modifs de ce genre.

Pourquoi ne pas plutôt utiliser des mots-clés ? (mots-clés qui vous permettraient ainsi d’indiquer le type d’article, le lieu de l’article, etc.)

Répondre
> > > 5. La boucle ARTICLES, Max, 10 juillet 2001

Merci de ces précisions !
Une question en appelant toujours d’autres :
# Puis-je aisément changer les noms de champs (par exemple sous-titre devient lieu, surtitre devient type d’article etc...) au niveau de l’affichage, tout en gardant la structure interne identique ?
Cela revient à changer les .html a priori.
Puis-je alors faire des mises à jours de SPIP "propres"

# Si je programme des modules supplémentaires, les mises à jour ne posent-elles pas de problèmes ?

Répondre
> > > > 5. La boucle ARTICLES, 10 juillet 2001

- Changer les noms des champs dans le HTML. Hé bien ce sera écrasé avec la prochaine mise à jour. Vraiment, est-ce qu’utiliser des mots-clés n’est pas aussi efficace pour indiquer le lieu ?

- Programmer des modules supplémentaires. C’est quoi, des modules ? :-) Vous pouvez insérer du PHP directement dans vos squelettes, faire des liens vers des pages qui seraient totalement en PHP... il y a déjà largement de quoi faire, non.

Répondre


Insérer une image
3 juillet 2001
 

Et comment qu’on fait y dans la page HTML pour insérer une image ?

Répondre
> Insérer une image, 3 juillet 2001

Ca c’est expliqué dans la partie « aide en ligne » des rédacteurs.

Répondre
> > Insérer une image, ptitjo, 10 juillet 2001

sur mon compte chez free je peux insérer des images sans pb (spip v102)

sur mon serveur linux du boulot je n’arrive pas a telecharger des images, je fais telecharger et rien, pas de message d’erreur...

Répondre
> Insérer une image, Jean Luc, 11 juillet 2001

j’ai installé SPIP chez freedom2surf sans gros probleme à part un petit truc agacant. impossible de telecharger des images en passant par modifier un article. parcourir me perlmet bien de naviqger sur mon disque dur telecharger a l’air de fonctionner mais aucune image n’arrive. et pourtant elle sont toute petites en Ko

Jean Luc

Répondre
> > Insérer une image, 11 juillet 2001

Est-ce que les images sont bien du type GIF, JPEG ou PNG ?

Répondre
> > > Insérer une image, ptitjo, 12 juillet 2001

moi mes images sont de la bonne taille et aux bon formats (jpg ou gif) mais rien n’y fait je ne peux pas les inserrer dans mon texte

help help help

Répondre
> > > Insérer une image, Jean Luc, 13 juillet 2001

que du GIF et du JPEG pur jus garanti sans pepins, et pourtant ça ne fonctionne toujours pas.

par contre en passasnt par du HTML genre et en les telechargeant par FTP ça fonctionne au poil !

Ou est l’os ?

Répondre
> > Insérer une image, ptitjo, 24 juillet 2001

je n’ai pas de réponses a ma question

je la repose donc :

j’ai installe spip 104 sur mon serveur linux apache php mysql pour gérer un intranet

cela fonctionne parfaitement

mais car il y a un mais, lorsque que je veux inserer une image, je fais telecharger et la je retourne automatique sur la page
http://spip104/ecrire/

et mon image n’est pas telecharger
et elle ne s’affiche pas ou j’ai place ma balise dans mon texte

par contre lorsque j’utilise mon site sur mon compte chez free.fr
cela fonctionne impec

- help me please
- help me please

Répondre