FAQ SPIP (personnel)

Questions fréquemment posées sur le système de publication de contenu SPIP

Éditeur: Guillaume Souesme (g.souesme@free.fr)

Ce document a pour objet de répondre aux interrogations d’ordre générales, mais aussi aux problèmes que peuvent poser l’installation, l’apprentissage et l’utilisation du système de publication de contenu SPIP. Ce document n’est pas un didacticiel destiné aux créateurs de contenus et de squelettes.

v. 0.1 (pour évaluation) (2002-nov-11)

Index des questions

Préambule

D'autres services sont proposés aux utilisateurs de SPIP

Modifications

Les paragraphes ajoutés depuis la dernière mise à jour sont précédés du signe 'paragraphe' (¶). Les paragraphes modifiés depuis la dernière mise à jour sont précédés du signe 'section (§). Les paragraphes destinés a être supprimé mais conservé à titre d'information sont précédés du signe (±).

SPIP

Présentation de spip http://www.uzine.net/spip

Formats

Cette FAQ est disponible dans sa dernière version à l'adresse suivante: http://quelconque.free.fr/spip/doc/

Ce document est actuellement disponible sous forme d'un document unique en HTML. À l'impession une feuille de style particlière est appliquée; cela permet d'obtenir un affichage plus adapté à l'impression (supppression de fond de couleurs et des images non utiles notamment). Cette fionctionnalités, du W3C, n'est pas dsponible avec tous les navigateurs (merci de me faire part de vos remarques à ce sujet). Une version au format PDF est en cours d'élaboration.

Améliorations

Si vous souhaitez améliorer ce document en y ajoutant de nouveaux chapitres, de nouvelles questions-réponses ou tout simplement me faire part de corrections, merci de m'envoyer vos suggestions par email (g.souesme@free.fr).

Remarques

Avant de poster des questions à tout va sur les listes de discussion, lisez la documentation, l'aide en ligne et consulter les archives de la liste de discussion.

Pour apprendre à utiliser internet vous pouvez consulter le site LEARN THE NET en français : un guide et tutoriel, et pour mieux appréhender votre logiciel de messagerie, les utilisateurs d'Outlook Express (produit Windows) pourront lire la faq d'Outlook Express. D'une manière générale, on tirera profit à lire des recommandations de rédactions.

Trouver de l’aide

Où trouver la documentation ?

Le site http://www.spip.org (ou plus directement rubrique91.html propose la documentation officiel de SPIP. Elle aborde les questions relatives à l’hébergement, l’installation, la syntaxe des boucles, les raccourcis typographiques et propose des solution à des demandes fréquentes. Vous y trouverez également un judicieux didacticiel qui vous amènera à mieux comprendre SPIP et plus généralement (et de manière perspicace) la création d’un site web.

Vous disposez également d’une aide en ligne. Elle est accessible à partir de la zone privée. Dans l’interface privée, cliquez sur les boutons ayant un point d’interrogation; ils ouvrent directement le chapitre concerné par le contexte.

Autres sources de documentation

Les concepteurs de SPIP proposent des listes de discussion (SPIP et SPIP-dev). La première est destinée aux utilisateurs (rédacteurs et concepteurs de site) les seconds aux développeurs (et ce qui suivent de près les versions en cours de développement de SPIP). Vous tirerez profit à consulter les archives.

sjdm s-jdm@voila.fr propose une version PDF de la documentation à télécharger sur son site.

Liste de discussion

Les concepteurs de SPIP proposent et participent à deux listes de discussion. SPIP et SPIP-dev. La première est réservée aux utilisateurs alors que la seconde est destinée aux personnes qui participent ou suivent le développement de la solution SPIP. Il vous est possible de vous y abonner et de consulter leurs archives.

Nous citerons également la liste de discussion SPIPAIDE qui selon les responsables est destinée aux débutants et aux non-techniciens.

Le vocabulaire SPIP

Site public et zone privé

Fonction des sites privé et public

Le site public est proposée aux clients de votre site. Elle permet la consultation du contenu publié, la participation aux forums etc.

Le site privé, accessible par mot de passe et login, permet aux administrateurs et aux rédacteurs de créer du contenu et de créer des rubriques et secteurs en fonction des droits donnés par l’administrateur.

Données publiées

Données produits par les rédacteurs

SPIP vous propose de mettre en ligne des articles et de brèves. Les articles sont contenus dans des rubriques. Les rubriques peuvent elle-même contenir des rubriques. Les rubriques de premier niveau sont appelées secteur. Les secteurs, et eux seuls, peuvent contenir des brêves.

À propos des squelettes

Les squelettes (fichiers avec l’extension html)

Les squelettes déterminent l’aspect graphique des différents types de pages qui constituent votre site (articles, rubriques, accueil etc.).

Les langages utilisés dans les squelettes sont le HTML (auquel on peut ajouter des CSS, du javascript, du php si vous en avez le besoin, etc.) et les instructions SPIP.

Les instructions SPIP permettent avec un langage de balises assez simple d’écrire des requêtes SQL et des traitements PHP sans que vous ayez à apprendre ces langages. La syntaxe SPIP use de terme français avec une syntaxe simple qui offre de construire de puissants traitements.

Principe des associations des fichiers HTML et PHP

Ces fichiers vont par couple (ex: article-dist.html et article.php3). Le fichier HTML détermine l’aspect graphique et les traitements des données. Le fichier php des différentes associations fixe 2 variables: $fond et $delais.

La première variable, $fond, spécifie le nom du squelette à appeler - l’extension ne doit pas être précisée.

La seconde variable, $delais, fixe un délai, en seconde. Ce délais fixe la période pendant laquelle la solution SPIP puisera dans son propre système de cache la page demandée par l’utilisateur - cela accélère la consultation du site et soulage le fonctionnement du serveur. Passé ce délais, la page est recalculée, si un utilisateur demande son affichage, et le traitement prendra en compte les éventuelles modifications de contenu ou de changement de l’aspect graphique de votre site. Les administrateurs disposent de fonction de mise à jour du site public.

Bien entendu, si la page n’existe pas dans le cache, la requête de l’utilisateur est exécutée, la page calculée et servie au client - la page se trouve alors dans la cache et ne sera calculée qu’une fois le délai dépassé et qu’un utilisateur demande son affichage.

À propos des squelettes dont le contient "-dist"

La solution SPIP est livrée avec des squelettes par défaut. Leur nom se termine par "-dist" suivi de l’extension ".html". Ainsi, le fichier article.php3 appelle le squelette "article-dist.html". C’est le cas, sauf s’il trouve un squelette du nom article.html ou article-IDrubrique.html ou article=IDrubrique.html.

Lorsque que vous adaptez le graphisme ou modifiez ou créez vos propres squelettes, il est conseillé de ne pas modifier les fichiers xxx-dist.html. Ainsi, lors d’une mise à jour de SPIP, vous ne risquerez pas d’écraser (supprimer) vos fichiers personnalisés.

Créer des squelettes différents selon les rubriques

SPIP qualifie et identifie les rubriques par un ID - les articles, brèves etc. sont également identifiés par un ID. Pour prendre connaissance de l’ID associé à une rubrique:

  • Entrez dans l’espace privé
  • Cliquez sur "Édition du site"
  • Naviguez jusqu’à la rubrique qui vous intéresse
  • Repérez la zone de la page intitulé "Rubrique numéro" : le nombre affiché est l’ID de la rubrique

Ainsi,

  • Si vous souhaitez créer une squelette spécifique aux articles d’une rubrique et de ses sous rubriques, il vous faut créer un squelette qui portera le nom article-IDrubrique.html ou IDrubrique est l’ID de la rubrique que vous avez identifiée.
  • Si vous souhaitez que seuls les articles de la rubrique identifiée soient concernés (et non les articles des sous rubriques), vous créerez le squelette article=IDrubrique.html.

Problèmes d’affichage

Boutons intempestifs (modifier, recalculer évolution des visites)

C’est un cookie administrateur qui fait que SPIP propose cette palette d’actions invisibles pour les visiteurs de votre site. Avec Mozilla, par exemple, vous pouvez gérer les cookies : Outils > Gestion des Cookies et supprimer le cookie spip_admin qui est enregistré à l’adresse de ton site.

Les rubriques n’apparaissent pas

Pour qu’une rubrique (ou sous rubrique) apparaisse dans le site public faut qu’elle contienne au moins un article ou une brève validé.

Allure des URLS

Vous voulez générer des URLS ayant une apparence plus explicite que les noms des fichiers php avec les variables passées? Lisez la documentation de Fil : inc-urls-diplo.php3

Tableau SPIP s’affiche incorrectement

Votre tableau SPIP (généré à l’aide des raccourcis typographiques) s’affiche mal: il multiplie les lignes? Il ne faut pas d’interligne entre 2 lignes, sinon SPIP recommence un nouveau tableau.

Feuille de style

Lorsque l’on insère une balise texte (comme #CHAPO ou #DESCRIPTIF ou #TEXTE) celle-ci est automatiquement mise en forme avec un style «spip». Pour éviter cela, utilisez le filtre supprimer_tags ([(#TEXTE|supprimer_tags)]). Pour plus d’information sur les filtres consulter la page dédiée aux filtres sur le site de SPIP.

Puissance et limite de SPIP

Nombre d’articles

Selon Antoine, «les performances risquent de commencer à souffrir si tu as un million de documents.»

Plus pragmatique, Fil dit «qu’avec 180 000 articles Stéphane avait constaté que ça ne marchait plus très bien, mais il avait changé de boîte avant de terminer le projet et donc de dire où ça déconnait. Le 30/09/2002, le site du Diplo proposait 8365 articles et 527 brèves. Il utilise encore le moteur de recherche ht//dig, mais pas pour longtemps: il est prévu de passer sur le moteur interne de SPIP (mise à jour immédiate, maintenance limitée, design plus souple des pages de résultat, et une perte de performances pas évidente à mesurer)».

Les boucles

Boucles sur les articles

Comment ordonner les articles à l’affichage?

Numérotez vos articles avec un chiffre suivi d’un point et d’un espace. Par exemple:

1. titre de l’article

2. titre d’un autre article

Ensuite, pour éviter que ne s’affiche le numéro, usez dans la boucle du filtre {supprimer_numero}.

<BOUCLE_articlestries(ARTICLES){par num titre}>
	[(#TITRE|supprimer_numero)]
</BOUCLE_articlestries>
Pages suivante-page précédente pour afficher une liste d’articles

Le site ecranbureau vous propose une boucle SPIP et quelques lignes de PHP pour atteindre cet objectif: Afficher vos articles sur plusieurs pages

Afficher tous les articles d’une rubrique et ses sous-rubriques

<BOUCLE_articles_rubrique(ARTICLES){branche}{par titre}>...

Attention, le sélecteur branche est apparu dans la version 1.4 de SPIP

Comment afficher des articles avec comme critère avoir deux ou plus mot-clefs associés?
  • S’il faut les deux mots : {id_mot=X}{id_mot=Y}
  • S’il faut l’un des deux : {id_mot==^(X|Y)$}
  • Voici un exemple de boucles:<BOUCLE_articles_rubrique(ARTICLES) {branche}{par titre}{id_mot=X}{id_mot=Y}>

Meta tag, référencement

Page sommaire

Modifiez les META NAME ci-dessous (pour les moteurs de recherche) avec les infos de votre site

<title> [#NOM_SITE_SPIP] texte à saisir</title>
	<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
	<meta name="keywords" content="texte à saisir,
	<BOUCLE_mots(MOTS){tout}{","}>
		[(#TITRE|supprimer_numero)]
	</BOUCLE_mots> ">
<meta name="description" content="texte à saisir">
<meta name="author" content="texte à saisir">
<meta name="identifier-url" content="http://votresite.org">
<meta name="reply-to" content="votremail">
<meta name="copyright" content="texte à saisir">
<meta name="rating" content="texte à saisir">
<meta name="robots" content="index,follow">
<meta name="revisit-after" content="xx days">
<meta name="robots" content="all">
Meta rubrique

Modifiez les META NAME ci-dessous (pour les moteurs de recherche) avec les infos de votre site

<title>
	[#NOM_SITE_SPIP]
	<BOUCLE_titre(RUBRIQUES){id_rubrique}>
		#TITRE
	</BOUCLE_titre>
</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<BOUCLE_head (RUBRIQUES){id_rubrique}>
	<meta name="description"
		content="[(#DESCRIPTIF)]">
	<meta name="keywords" content="texte à saisir,
	<BOUCLE_mots(MOTS){tout}{","}>
		[(#TITRE|supprimer_numero)]
	</BOUCLE_mots>">
</BOUCLE_head>
Meta article

Modifiez les META NAME ci-dessous (pour les moteurs de recherche) avec les infos de votre site

<title>
	[#NOM_SITE_SPIP]
	<BOUCLE_titre (ARTICLES){id_article}>
		#TITRE
	</BOUCLE_titre>
</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<BOUCLE_head (ARTICLES){id_article}>
	[<META NAME="Description"
		CONTENT=’(#DESCRIPTIF|supprimer_tags|texte_script)’>
	]
	<meta name="Keywords" content="texte à saisir,
	<BOUCLE_keywords(MOTS){id_article}{","}>
		#TITRE
	</BOUCLE_keywords>
	">
	<meta name="Author" content="
	<BOUCLE_author (AUTEURS){id_article}{","}>
		#NOM
	</BOUCLE_author> ">
</BOUCLE_head>
Méta brèves

Modifiez les META NAME ci-dessous (pour les moteurs de recherche) avec les infos de votre site

<title>
	[#NOM_SITE_SPIP] breve
	<BOUCLE_titre (BREVES){id_breve}>
		#TITRE
	</BOUCLE_titre>
</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<meta name="description" content="texte à saisir">
<BOUCLE_head (BREVES){id_breve}>
	<meta name="Keywords" content="texte à saisir,
	<BOUCLE_keywords(MOTS){id_breve}{","}>
		 #TITRE 
	</BOUCLE_keywords> ">
</BOUCLE_head>

Langue

SPIP en anglais

La version anglaise de « SPIP 1.4.2 » est disponible à l’adresse suivante : contrib/George/

SPIP en allemand

Le 13/09/2002, on apprenait que la première version SPIP en Allemand (SPIP.DE) sera bientôt disponible également. L’adresse à consulter: http://www.spip.de

Site en plusieurs langues

Il n’existe pas encore de solution intégrée à SPIP 1.4.2. Mais, plusieurs personnes confrontées à ce problème ont essayé différentes approches. Veuillez consulter les archives de la liste de diffusion ou le forum (forum_spip.php3?debut_forum=160)

Sont évoquées, en gros, 3 possibilités:

  1. Un site avec N secteurs : 1 secteur par langue et 1 série de squelettes par langue, 1 seule BDD
  2. N sites : 1 site par langue et 1 BDD par langue
  3. Une même structure pour les N langues, et sélection de la langue par mot-clé.

Fonctions supplémentaires

Des squelettes à intégrer

Gérer une FAQ?

Vous pouvez récupérer les squelettes pour gérer une FAQ (Foire aux Questions) avec SPIP ici: article.php3?id_article=558

Gestion d’un forum multi-salon

Vous pouvez récupérer les squelettes pour gérer un forum multi-salon avec SPIP ici : forum multi-salon

Script PHP à intégrer

Recommander un article à un ami

Patrice de Écologie Magazine patrice@ecolomag.com vous propose un script en PHP qui permet d’envoyer un article à un ami (sous réserve que la fonction mail soit active chez votre hébergeur ce qui n'est pas le cas chez free.fr par exemple).

Pour tester le script, aller à article.php3?id_article=2 et cliquez sur "envoyer cet article à un ami".

Pour intégrer cette fonctionnalité dans un squelette SPIP, suivez la procédure suivante:

  • Copier le script dans son éditeur préféré : direaunami.phps.
  • Créer le squelette diffuser.html qui reprend l’environnement graphique de son site.
  • Insérer <INCLURE("recommander.php")> dans ce squelette.
  • Création du fichier recommander.php en reprenant ton script dépouillé de l’environnement html.

Éditeur de site

Modifier des squelettes avec Dreamweaver?

Fabrice vous propose un assistant Dreamweaver pour SPIP. Il assiste le créateur de squelette en générant les boucles SPIP. Pour chaque boucle, il propose les paramètres et les balises adaptés. Il est fortement conseillé de consulter ce site et SPIP avant de commencer à ouvrir des pages avec des éditeurs HTML dits WISIWIG- et d’une manière générale tout éditeur qui potentiellement modifie, seul, le code des documents qu’il ouvre.

URL pour le téléchargement: article.php3?id_article=99

Importer des documents

Moulinette

Vous avez des documents sources que vous voulez convertir en SPIP, c’est à de dire en y ajoutant les raccourcis typographiques de SPIP. /contrib/Fil/convert/

Gestion du site

Administration

J’ai perdu mon mot de passe

Connectez-vous à votre serveur par FTP et supprimer les fichiers ecrire/inc_connect et ecrire/.htaccess. Le second peut ne pas exister.

Un administrateur de rubrique

Il possible de donner à un utilisateur les droits d'administration sur une rubrique (et ses sous-rubriques). Entrez dans la zone privée et:

  1. Créez un administrateur (ou passez un rédacteur sous le statut administrateur);
  2. En bas de ce formulaire, vous trouverez une zone intitulée "Restreindre la gestion à la rubrique". Dans le menu, choisissez la rubrique souhaitée.
Comment supprimer une rubrique?

Seule une rubrique ne contenant pas d’articles peut être supprimé. Effacez les articles de la rubrique à supprimer (ou déplacez-les.) Une fois cela fait, le bouton «Supprimer cette rubrique» apparaît.

Formulaire

Quels sont les formulaires proposés par SPIP?

Arno* vous propose un article sur les différents formulaires proposés dans SPIP : http://www.uzine.net/article1827.html

Gestion des erreurs

Les images sont remplacées par un message d’erreur

Des messages du type Fatal error: Call to undefined function: integre_image() in /var/www/htdocs/aset/public/ecrire/inc_texte.php3 on line 572 apparaissent en lieu et place des images.

Essayez de réinstaller les fichiers, il y en a probablement un qui n’est pas passé (inc_filtres.php3 ou inc_texte.php3).

PHP3 et PHP4 (free.fr)

Lenteur sur free.fr

Pour accélérer le site public d’un site hébergé sur free.fr, appliquez le kit free_pack d’Antoine. Vous le téléchargerez à l’adresse suivante article.php3?id_article=196

Le site privé ne sera pour autant pas accéléré.

Informations PHP3 et PHP4 sur free.fr

Lisez l’article à ce sujet sur http://jsctt.free.fr