SPIP

Présentation de la dist

erational, JLuc, tetue — 2016-01-09T08:49:58Z

Le squelette par défaut de SPIP intègre Tiny Typo, une base typographique claire et facilement adaptable. Le squelette est compatible avec le plugin crayons.

Sommaire

Structure du HTML

Le squelette est en HTML5

Voici la structure des principaux blocs :

body
- .page
  - .header
  - .nav
  - .main
    - .wrapper
      - .content
    - .aside
  - .footer

Dimensions des blocs principaux

Le bloc principal .page est centré et fait une taille de 960 pixels de large.
Le squelette est un minimum responsive et introduit deux points de ruptures à 767 pixels et 640 pixels de large.

Appel des feuilles de styles

L'appel des feuilles de style utilise la méthode dite daisy.
Elle consiste à respecter un ordre bien précis pour appeler les feuilles de styles pour faciliter leur compréhension, maintenance et personnalisation au sein d'un projet web.

On appelle donc les styles les plus généraux jusqu'aux styles les plus particuliers.

Dans le détail, voici les fichiers appelés par le squelette dist :

1. Les styles Tinytypo
- reset.css ré-initialise les balises HTML
- clear.css définit les modèles pour la composition et la mise en page (alignement, modèle de bloc,....)
- font.css (facultatif) appel des polices typographiques personnalisées (souvent appelés "font-face")
- links.css définition des liens hypertextes
- typo.css base typographique
- media.css habillage des images, vidéos, canvas, ...
- form.css habillage de base des formulaires
- grid.css (facultatif) grille
- layout.css disposition des blocs principaux
2. Les styles de Spip ses plugins
- spip.css styles générés par spip
- styles générés par les plugins et insérés grâce à la balise #INSERT_HEAD_CSS
3. Vos feuilles de style pour l'habillage du site
- theme.css thème général
- variante.css (facultatif) variante du thème
- perso.css (facultatif) réglages personnels sur le thème

Pour la performance, il est possible à l'administrateur du site d'activer la concaténation de toutes ces feuilles css au moyen de l'option prévue à cet effet (onglet "Fonctions avancées" du menu "Configuration" de la partie privée).

SPIP 3.0

cerdic, tetue — 2012-05-19T11:00:00Z

SPIP 3 : une version marquée par la réécriture complète de l'espace privé en squelettes, une forte modularisation et une boucle DATA révolutionnaire. Cette version a été publiée en mai 2012 et son support prend fin le 30 juin 2019.

Sommaire

SPIP 2.0 avait apporté les fonctionnalités permettant de l'utiliser comme un « framework » pour le développement d'applications Web, au-delà de sa vocation initiale de simple outil de publication.

SPIP 3 pousse la logique du « framework » jusqu'à se l'appliquer à lui-même : l'ensemble de l'espace privé de SPIP a été recodé en squelettes, sur la base des outils et fonctions proposés par le langage de squelettes de SPIP.

Cette remise à plat de l'espace privé a été l'occasion de repenser le fonctionnement des objets éditoriaux et de normaliser leur usage pour le rendre le plus générique possible : la plupart des particularités historiques de chaque objet (et les exceptions de traitement associées dans le code de SPIP) ont été gommées pour être ramenées à une simple déclaration.

La création de nouveaux objets éditoriaux et la personnalisation des objets existants deviennent ainsi beaucoup plus faciles et plus rapides.

SPIP 3 achève également la découpe du logiciel en plugins comme SPIP 2 l'avait amorcé : l'ensemble des fonctionnalités proposées par SPIP 2 repose dorénavant sur un noyau SPIP 3 accompagné de 23 plugins.

La découpe complète du noyau a permis de compléter ses API et points d'entrée pour les développeurs de plugins.

SPIP 3 se nourrit fortement des développements de la communauté SPIP-Zone, et marque une forte inversion : ce n'est plus le noyau qui tire les développements des plugins, mais les développements de plugins qui nourrissent l'avancée de SPIP par leurs expérimentations [1].

Parmi de nombreuses autres nouveautés fonctionnelles, SPIP 3 introduit une nouvelle boucle DATA qui permet enfin de boucler sur tout type de données et plus seulement sur les tables SQL. Il devient ainsi possible de parcourir soit une énumération, soit un fichier CSV, XML, YAML... Plus fort encore, la boucle DATA permet directement de boucler sur une URL : il devient possible de parcourir directement une feuille de calcul Google Spreadsheet, un calendrier en ligne, une liste de vidéos sur Youtube, des photos sur Flickr… le Web devient votre base de données !

Prérequis :
SPIP 3.0 requiert désormais au minimum une version 5.1.0 de PHP pour pouvoir fonctionner correctement.
Attention : SPIP 3.0 n'est pas compatible avec PHP 7.

Un nouvel espace privé [2]

Visuellement, l'espace privé demeure dans la continuité des versions précédentes, complété de nouvelles icônes, avec :

pour les icônes principales de navigation, un jeu spécifique réalisé pour SPIP par Sébastien Desbenoît,
pour le reste de la page, l'adoption d'un jeu dérivé de FatCow.

La refonte de l'interface est essentiellement technique, même si elle a également permis de résoudre un certain nombre de défauts ergonomiques historiques.

La navigation principale est repensée et réorganisée. Le menu déroulant, désormais entièrement navigable au clavier, intègre aussi des temporisations pour faciliter son utilisation à la souris et être plus robuste aux mouvements mal contrôlés.

L'ensemble de l'espace privé est donc réécrit sous forme de squelettes rangés dans le répertoire prive/squelettes organisés par sous-dossiers correspondants à un découpage de la page en blocs. Ce découpage est utilisé notamment pour le rafraîchissement des morceaux de page en Ajax, évitant le rechargement complet des pages et fluidifiant les interactions [3].

De nombreux points d'entrée (utilisés en premier lieu par les plugins du noyau) sont disponibles sous forme de pipeline pour permettre aux plugins d'étendre les fonctionnalités de l'espace privé.

Les pages de l'espace privé sont réorganisées et renommées. En particulier toutes les pages d'objets éditoriaux utilisent un nommage cohérent fondé sur le nom de l'objet.

La réécriture a également permis de remettre à niveau la structure complète du HTML et son accessibilité. Un référentiel a été mis en place pour que les développeurs de plugins puissent réutiliser les mêmes structures, et que les ajouts d'interface restent homogènes avec le noyau.

Toutes les listes d'objet sont des squelettes qu'il devient facile de personnaliser. Elles bénéficient toutes du tri par colonne et de pagination ajax.

Un système d'échafaudage des pages d'objet permet de construire automatiquement une interface minimale pour les nouveaux objets déclarés par les plugins. Chaque élément de cette interface par défaut peut ensuite être personnalisé en fonction des particularités de chaque objet : [4].

Tous les formulaires interactifs sont écrits sous forme de formulaires CVT, ce qui permet d'assurer des interactions de qualité avec gestion systématique des messages d'erreur, vérification de saisie, ajax robuste à volonté, saisie multipage si nécessaire… Ils sont ainsi tous facilement extensibles par les plugins.

Autre nouveauté, en mode édition, SPIP 3 prend en compte le retour à la ligne simple (il n'est désormais plus nécessaire d'utiliser « _ »).

Enfin, l'espace privé intègre un mécanisme technique de thèmes qui permet de personnaliser les feuilles de style ou tout ou partie des icônes. Ce mécanisme pourra être utilisé par un plugin proposant des variantes activables par chaque utilisateur en fonction de ses préférences.

Modularisation en plugins

SPIP 3 achève donc la découpe du logiciel en plugins. Son noyau conserve la gestion des articles, rubriques et auteurs ; le langage de squelettes et l'ossature de l'espace privé. Toutes les autres fonctionnalités sont externalisées dans des plugins, automatiquement installés dans la distribution par défaut de SPIP 3. Ces plugins fournis par défaut sont désormais placés dans un dossier plugins-dist/ [5]

Cette découpe du noyau a permis de compléter un certain nombre d'API implicites, maintenant à disposition des développeurs de plugins qui peuvent ainsi ajouter des fonctionnalités sans limite, en prenant modèle sur les plugins natifs de SPIP.

Dans le domaine des plugins, SPIP 3 amène également une refonte importante du formalisme de déclaration XML. Outre une lisibilité améliorée, cette évolution intègre la question des traductions de plugins, ainsi que les outils d'alimentation automatique d'un annuaire des plugins de SPIP et un outil de chargement.

Par ailleurs, les plugins peuvent bénéficier des fonctions de mise à jour de base de données du core (avec reprise sur timeout) par simple déclaration de la procédure.

Les plugins distribués par défaut avec SPIP sont :

Brèves s'occupe de l'objet éditorial Brèves.
Compagnon propose l'affichage de textes pédagogiques d'information et d'accompagnement lors des premiers accès à l'espace privé.
Compresseur déjà présent dans SPIP 2.1, prend en charge l'optimisation des performances du site en compressant et concaténant les feuilles de style CSS et les fichiers JavaScript embarqués dans la page.
Cette version du plugin améliore des feuilles par média. Utilisation de @media pour concaténer tous les médias en un seul fichier sans en modifier l'ordre de chargement. Gestion des urls absolues sans protocole pour que les feuilles de style compressées fonctionnent sur http et https.
Dump assure la gestion des sauvegardes et restaurations. La fonctionnalité a été complètement ré-écrite pour assurer une sauvegarde complète et fiable. Le format de sauvegarde est maintenant SQLite et toutes les tables sont systématiquement conservées. Votre hébergement doit donc disposer de SQLite. Si ce n'est pas le cas, réalisez vos sauvegardes via phpmyadmin ou toute autre interface de gestion de la base de données fournie par votre hébergeur.
Forum gère l'objet éditorial forum, tant pour le site public que pour les interactions éditoriales dans l'espace privé. Outre une interface de modération repensée, les forums sont maintenant utilisables sur tous les objets éditoriaux de SPIP (natifs ou ajoutés par des plugins).
Images, déjà dans SPIP 2.1, prend en charge tous les filtres d'images et de couleurs dans les squelettes.
jQuery UI implémente dans SPIP la librairie complémentaire. jQuery UI facilite la création de composants graphiques dynamiques : onglets, drag & drop, barres de progression, widgets, effets… [6]
Mediabox intègre dans SPIP par défaut une boîte pop-in pour visualiser les médias ou proposer des interactions [7].
Medias [8] prend en charge la gestion des documents et images. Il propose une refonte de l'interface et rend les documents utilisables sur n'importe quel objet éditorial.
Mots apporte la gestion des mots-clés et groupes de mots. Les mots-clés sont maintenant utilisables sur tous les objets éditoriaux.
Organiseur assure les fonctions de messagerie et calendrier interne de l'espace privé. L'interface est complètement refondue. La messagerie interne bénéficie de notification par email, et le calendrier repose sur la librairie FullCalendar qui permet une navigation fluide.
Pétitions gère les pétitions sur les articles et propose une interface de modération repensée.
Porte plume, déjà dans SPIP 2.1, assure l'aide à la saisie.
Révisions assure le versionage utilisable sur tous les objets éditoriaux de SPIP. L'interface de gestion des révisions est modernisée.
SafeHTML, déjà dans SPIP 2.1, prend en charge la sécurisation des contenus externes potentiellement dangereux.
Sites assure le fonctionnement de l'objet éditorial « Site syndiqué » ainsi que des articles syndiqués. Une interface de modération des articles syndiqués est proposée.
Squelettes par rubriques assure le fonctionnement des squelettes suffixés (article-2.html pour les articles de la rubrique 2 et de ses sous-rubriques).
Statistiques assure le calcul des statistiques du site et des articles, et propose un affichage complètement refondu.
Support vieux navigateur, déjà dans SPIP 2.1, propose des fonctions JavaScript activables pour permettre aux vieilles versions de navigateurs d'afficher correctement votre site.
Svp permet la gestion complète des plugins : installation, activation, mise à jour, recherche…
Textwheel est un moteur typographique qui supporte intégralement les raccourcis de SPIP, décrits désormais dans un fichier de règles au format YAML. Ce moteur permet une nette accélération du traitement des raccourcis (jusqu'à 2 fois plus rapide sur certains contenus), et facilite l'évolution et la personnalisation des raccourcis.
Urls Étendues supporte les URLs propres ou arborescentes, et propose une interface de configuration ainsi qu'une interface de gestion avancée optionnelle pour gérer finement les URLs de chaque page.
Vertèbres, déjà dans SPIP 2.1, permet au webmestre d'afficher le contenu d'une table SQL de SPIP au moyen d'un squelette généré automatiquement d'après la structure SQL de la table. Cet affichage se fait maintenant dans l'espace privé.

Nouveaux squelettes par défaut

Les squelettes par défaut ont été révisés, avec un nouvel habillage graphique, pour marquer le coup. Ils adoptent une nouvelle structure HTML de base qui anticipe le HTML5, « responsive » par défaut, et embarquent des sélecteurs conditionnels pour plus de souplesse CSS.

Par la répartition en plusieurs feuilles de styles utilisables indépendamment, à la carte (selon la méthode Daisy, voir Un, deux, trois… feuilles CSS !), ils constituent désormais un cadre d'intégration modulaire. Ils posent notamment une base typographique complète et harmonieuse, immédiatement utilisable pour démarrer un site. L'historique spip_style.css disparaît au profit de spip.css, feuille indispensable, à utiliser en complément de vos styles habituels.

De nouvelles fonctionnalités

Le support de SQLite a été nettement amélioré, et c'est le format de base de données proposé par défaut lors d'une nouvelle installation (quand il est supporté par le serveur), compte tenu de sa simplicité de mise en œuvre [9].

La gestion des objets éditoriaux est généralisée. Par suite, les auteurs, documents, mots-clés, forums, révisions et logos sont utilisables sur n'importe quel objet (tous ceux de SPIP mais aussi tout objet éditorial ajouté par un plugin avec la nouvelle API de déclaration).
La gestion du statut, de la date de publication, de la langue et de la traduction est également généralisée et utilisable sur tout objet par simple déclaration.
Lorsque le signalement de l'édition concourante est activé, tout objet édité est désormais pris en compte dans le signalement.

L'identité du site est complétée d'un slogan du site, entre titre et descriptif long, utilisable avec la balise #SLOGAN_SITE_SPIP.

L'écran de sécurité est intégré en standard.

Les logs (fichiers de trace) bénéficient d'une gestion par niveau d'importance. Par défaut, les logs sont beaucoup moins verbeux en production et ne signalent que les anomalies ou informations importantes. Le niveau de log peut être ajusté pour le debug ou le développement, permettant ainsi d'avoir toutes les informations nécessaires.

Le cron périodique qui reposait sur des fichiers a été supprimé au profit d'une file de tâches en attente (qui gère aussi les tâches périodiques). Cette file de tâches permet de programmer des actions asynchrones [10] et propose une API simple d'utilisation pour les développeurs de plugin.

L'ajax des squelettes ({ajax} sur les INCLURE) bénéficie d'une prise en charge des attributs ARIA pour améliorer son accessibilité. De plus, l'historique de navigation est aussi automatiquement pris en charge grâce à l'API « History » de HTML5 [11]. L'URL du navigateur est donc mise à jour automatiquement sur les liens ajax, et permet les retours en arrière sans soucis.

Les modèles utilisés dans du texte éditorial reçoivent automatiquement l'environnement du squelette dans lequel est affiché le texte [12].

Les formulaires des l'espace privé utilisent les possibilités de HTML5 avec par exemple les attributs required ou placeholder.

Les squelettes peuvent maintenant échapper les caractères # [ ] ( ) { } < > en utilisant une barre oblique \. Il devient possible d'écrire des conditions par exemple sur une case à cocher de formulaire de manière bien plus élégante, sans que les crochets de l'attribut name n'interfèrent avec les crochets de la balise englobante :

[(#ENV{param}|oui) Avec tendresse ?  ]

Raccourcis

Un raccourci pour les abréviations a été introduit nativement : [SNCF|Société Nationale des Chemins de fer Français] (ou [CMS|Content Management System{en}]) pour indiquer une langue différente du texte principal) génère une balise abbr [ n'est plus utilisée en HTML5." id="nh13">13].

Les modèles de document peuvent prendre en argument la largeur ou la hauteur pour réduire leur dimension : .

Les tableaux à 2 entrées (horizontale et verticale) sont désormais gérés correctement.

Il n'est désormais plus nécessaire d'utiliser le raccourci « _ » pour produire un retour ligne simple.
Pour retrouver le fonctionnement antérieur, ce nouveau comportement est débrayable en utilisant un define('_AUTOBR', ''); dans son fichier mes_options.php.

Boucles

Le système de boucles de SPIP a été généralisé pour s'appliquer non plus directement sur une table SQL mais sur un itérateur. Un itérateur SQL assure le fonctionnement historique des boucles sur les tables SQL, mais il devient possible de boucler sur toute donnée itérable : Les itérateurs de SPIP - la boucle (DATA)

Premier exemple de nouvelle application : la boucle DATA étend le fonctionnement des boucles à toute information structurée sous forme de tableau. Il devient possible de boucler sur un fichier CSV, sur une url distante qui renvoie une information en JSON... :

Pour assurer la migration facile des squelettes qui utilisaient des boucles POUR et CONDITION, celles-ci sont également supportées comme cas particuliers de la boucle DATA, dans la même syntaxe que celle qui existait.

Critères

{si ...} : permet de conditionner l'exécution d'une boucle à la condition exprimée dans le critère, qui ne dépend pas des données en base mais du contexte du squelette.

{tri ...} : associé à la balise #TRI pour des tris faciles.

{feuille} : permet de sélectionner les rubriques sans enfants (celles tout en bas de la hiérarchie).

{noeud} : permet de sélectionner les rubriques qui ont des enfants.

{!racine} : exclut les rubriques de la racine.

{profondeur=3} : permet de sélectionner les rubriques du 3e niveau (les rubriques secteurs sont le niveau 0, puis les rubriques du dessous le niveau 1 etc.).

{id_parent} voit son comportement modifié en l'absence de boucle RUBRIQUES englobante : auparavant, id_parent prenait le id_rubrique de contexte (#ENV{id_rubrique}), désormais {id_parent} prend le id_parent de contexte (#ENV{id_parent}). En conséquent, on peut désormais écrire {id_parent}.

Pour migrer un boucle utilisant {id_parent} on peut :
- passer un contexte id_parent.
- utiliser {id_parent ?}{id_rubrique ?}.

Balises

Les modèles peuvent avoir un cache s'ils contiennent une balise #CACHE (mais par défaut ils n'en ont pas, comme auparavant).

Dans l'espace privé, les squelettes n'ont pas de cache non plus, sauf si une balise #CACHE est présente.

#LOGO_DOCUMENT peut prendre en argument le mode d'affichage du logo :

auto (par défaut, et c'est le fonctionnement historique) affiche automatiquement la vignette du document si existante, sinon un aperçu ; et sinon l'icône correspondant au type de document.
icone indique que c'est l'icône correspondant au type du fichier qui doit être affichée
apercu affiche un aperçu de l'image exclusivement, même si une vignette existe.
vignette affiche la vignette du document si elle existe, ou sinon rien.

La balise #SPIP_CRON disparaît et n'a plus d'effet dans les squelettes où elle serait encore utilisée.

#BOUTON_ACTION{libellé, url, classe, confirm, title, callback} génère un mini formulaire HTML avec un seul bouton qui affiche « libellé » et déclenche au clic un POST vers « url ». Cette balise est à utiliser de préférence à un lien quand la page « url » modifie la base de données. Si la « classe » contient la valeur « ajax » le bouton déclenchera un rechargement du bloc ajax qui l'inclue. « confirm » permet d'indiquer un message pour faire confirmer l'action par l'utilisateur, « title » le contenu de l'attribut homonyme sur le bouton, et « callback » une fonction javascript à appeler lors du clic sur le bouton.

#INFO_XXX{article, 13} : permet de retrouver le #XXX sans faire une boucle ARTICLES sur l'article 13 (utilisable pour toute boucle et tout champ de la boucle : #INFO_TITRE{article,13}, #INFO_NOM{auteur,2}...)

#CONFIG{nom} permet d'afficher la valeur de la meta de configuration nom.
Si la meta est un tableau, il est possible d'accéder directement à des sous valeurs avec la syntaxe #CONFIG{nom/sousvaleur} qui renverra la sousvaleur de la meta nom.
Pour accéder à la meta d'une table spécifique à un plugin, il faut utiliser la syntaxe #CONFIG{/metamonplugin/nom} : en commençant par un /, on indique que l'on veut la meta nom de la table spip_metamonplugin au lieu de la table spip_meta de SPIP.
Dans tous les cas, il est possible d'indiquer en second argument la valeur par défaut qui doit être utilisée si la meta n'existe pas encore : #CONFIG{nom,valeurpardefaut}

À l'instar de #CONFIG{nom/sousvaleur} les balises #ENV, #GET, #SESSION permettent d'utiliser des barres obliques pour obtenir des sous valeurs de tableau tel que :#ENV{nom/sousvaleur}, #GET{tableau/cle/souscle}, #SESSION{prefs/couleur}.

#PUBLIE : pour tester l'état (publié ou non) d'un objet. S'utilise dans une boucle, porte implicitement sur l'objet en cours ou avec des arguments explicites : [(#PUBLIE{article, 3}|oui) ... ], sur tout autre objet.

#CLE et #VALEUR sont les deux balises qui permettent d'afficher la clé et la valeur dans une boucle DATA
#VALEUR{x} permet d'afficher la sous valeur de x si #VALEUR est un tableau (équivalent à [(#VALEUR|table_valeur{x})]). On peut enchaîner plusieurs sous index #VALEUR{x/y/z} pour afficher une valeur dans un sous-niveau du tableau.

#PRODUIRE : renvoie le nom d'un fichier statique produit à partir d'un squelette. Utile pour une feuille de style calculée ou un fichier javascript calculé. La syntaxe est la même que pour la balise #INCLURE : #PRODUIRE{fond=mafeuille.css,couleur=ffffff} pour utiliser le squelette mafeuille.css.html

#LISTE{a,b,c} renvoie simplement un tableau contenant les valeurs a,b et c. C'est une écriture simplifiée de #ARRAY{0,a,1,b,2,c}.

#TOTAL_UNIQUE renvoie le nombre d'éléments affichés par l'intermédiaire du filtre |unique. Si on utilise |unique{nom}, il faut faire référence au même nom dans la balise : #TOTAL_UNIQUE{nom}

Dans l'espace privé :

#AIDER{surtitre} permet d'afficher un lien vers la section surtitre de l'aide de SPIP.

#BOITE_OUVRIR, #BOITE_PIED et #BOITE_FERMER permettent d'utiliser les boites stylées de l'espace privé :

#BOITE_OUVRIR{titre,classe} ouvre une boîte. le titre peut être omis. Les classes stylées dans l'espace privé sont : simple, info, note, raccourcis et important ;
le HTML qui suit est inclus dans la boîte ;
#BOITE_PIED permet de passer au pied de la boîte quand un pied est nécessaire.
#BOITE_FERMER ferme la boîte.

Pour de nombreux exemples, voir la page de l'espace privé ecrire/?exec=charte_boites proposée par le plugin http://plugins.spip.net/dev

#FORMULAIRE_RECHERCHE_ECRIRE affiche le formulaire de recherche de l'espace privé. On peut lui indiquer en premier argument l'url vers laquelle il doit pointer, et une classe en second argument. En présence de javascript le formulaire se comporte comme un lien vers url avec le paramètre recherche fourni par la saisie. Si on indique la classe ajax en second argument, le formulaire provoque le rechargement du bloc ajax incluant, comme un lien ajax donc : #FORMULAIRE_RECHERCHE_ECRIRE{#SELF, ajax}

#CHEMIN_IMAGE{article-24.png} renvoie le chemin vers l'icône article-24.png du thème de l'espace privé en cours d'utilisation par l'auteur connecté.

Filtres

|lien_ou_expose permet de construire simplement un menu de plusieurs liens en exposant celui qui est sélectionné par un et en gardant un lien sinon. Exemple : [(#URL_PAGE{mapage}|lien_ou_expose{libelle, #ENV{page}|=={mapage}, classe, title, rel})]

|singulier_ou_pluriel affiche une chaîne ou une autre en fonction du nombre sur lequel il est appliqué : [(#TOTAL_BOUCLE|singulier_ou_pluriel{1_article,nb_articles})]. 1_article et nb_articles sont des chaînes de langue qui reçoivent le nombre en argument @nb@. Si le nombre est zéro, le filtre n'affiche rien.

|balise_img permet de construire rapidement une balise HTML à partir d'un nom de fichier en renseignant systématiquement le width et le height pour accélérer le rendu de la page : [(#CHEMIN{monimage.png}|balise_img{alt,class})]

|affdate_debut_fin affiche sous forme sympathique un intervalle de temps entre une date de début et une date de fin, en prenant en compte le fait que la date de début et la date de fin sont ou non le même jour, le même mois, la même année, et en prenant en compte l'affichage de l'heure ou non (second argument, oui ou non). Exemple :
[(#DATE_DEBUT|affdate_debut_fin{#DATE_FIN,horaire})]

|timestamp ajoute au nom d'un fichier un horodatage sous la forme ?1234567890 où le nombre représente la date du fichier compté en secondes depuis le 1er janvier 1970. Ce filtre est utile pour référencer par exemple des feuilles de styles en s'assurant que le navigateur les rechargera quand leur url change :
[]

|objet_icone renvoie l'icône standard d'un objet de SPIP. Par défaut, la taille 24px est renvoyée sauf si la taille 16 ou 32 est demandée en argument : [(#OBJET|objet_icone{16})]

|objet_info renvoie une propriété d'un objet de SPIP telle que déclarée (ou automatiquement renseignée par SPIP) via l'API declarer_tables_objets_sql

|objet_afficher_nb affiche le nombre d'objets en prenant en compte le nombre auquel le filtre s'applique et les chaînes de langue déclarées pour l'objet : [(#TOTAL_BOUCLE|objet_afficher_nb{auteur})] affichera par exemple 1 auteur ou 23 auteurs.

|wrap encadre un texte d'une balise html : [(#TITRE|wrap{
})] produit le même résultat que [(#TITRE) ]

|generer_info_entite affiche le champ d'un objet SPIP : [(#ID_ARTICLE|generer_info_entite{article,titre})] renvoie le titre mis en forme de l'article #ID_ARTICLE. C'est équivalent ici à [(#INFO_TITRE{article,#ID_ARTICLE})].

Dans l'espace privé :

|icone_horizontale affiche une icône de l'espace privé au format horizontal. La syntaxe est : [(#URL|icone_horizontale{libelle,icone,fonction})]. icone peut être désigné en abrégé (article) et sera alors au format 24px ou explicitement (article-24.png). Le 3ème argument fonction précise une famille d'action associée à l'icône et peut être au choix add, del, edit, new, ou omis. Exemple [(#URL_ECRIRE{auteur_edit,new=oui}|icone_horizontale{<:icone_creer_nouvel_auteur:>,auteur,new})]

|icone_verticale affiche une icône de l'espace privé au format vertical. La syntaxe est la même que pour |icone_horizontale

|bouton_action_horizontal utilise la même syntaxe que |icone_horizontale et affichera un résultat visuellement semblable. Cependant le markup HTML sera du même type que celui de #BOUTON_ACTION pour déclencher un POST vers l'url et est donc utile quand l'url modifie la base de données.

|sinon_interdire_acces placé à n'importe quel endroit de la page permet de bloquer l'accès à celle-ci quand l'expression à laquelle il s'applique est fausse. Dans ce cas une page d'erreur est affichée, sauf si une url de redirection est fournie en argument (on peut aussi alors fournir un status http de redirection en second argument). On l'utilise généralement sur une vérification d'autorisation [(#AUTORISER{modifier,article,#ID_ARTICLE}|sinon_interdire_acces)]

JavaScript

SPIP 3 utilise la version 1.7.2 de jQuery et intègre désormais jQuery UI en version 1.8.20. Il devient possible d'utiliser une version différente de jQuery dans le site public en surchargeant simplement javascript/jquery.js dans le dossier squelettes/ sans risquer de casser l'espace privé.

Liens ajax :
Les liens .ajax ne cassent plus l'historique de navigation sur les navigateurs qui supportent l'API HTML5 History (Firefox, Safari, Chrome à la date de cet article). C'est-à-dire que lorsqu'on clique sur un lien ajax de SPIP qui recharge une partie de la page, l'URL est mise à jour dans le navigateur et le visiteur peut cliquer sur Précédent pour revenir en arrière.

Classes spéciales sur les liens ajax :

.nohistory indique que le lien n'affecte pas l'historique de navigation lorsqu'il est cliqué ;
.preload indique à SPIP que le contenu du lien ajax doit être préchargé au moment où la page est chargée. Ainsi le clic sur le lien produira une mise à jour immédiate ;
.nocache indique à SPIP que le contenu du lien ajax ne doit pas être mis en cache. Ainsi plusieurs clics sur le même lien provoqueront autant de chargements depuis le serveur (par défaut, seul le premier chargement à lieu pour une url donnée et le contenu est ensuite mémorisé par le navigateur).

Rechargement télécommandé de blocs ajax :
Les liens .ajax permettent par défaut le rechargement du bloc ajax qui les contient, mais il est parfois nécessaire de provoquer le rechargement d'un autre bloc ajax de la page.

Pour cela, il devient possible de nommer les blocs ajax au moment de leur inclusion :
. Le bloc ajax ainsi nommé peut ensuite être rechargé via l'appel de ajaxReload('nomdubloc');. Il est possible de passer en second argument une liste d'options contenant :

callback : fonction callback qui doit être appelée après le chargement ajax du bloc
args : liste d'argument qui seront passés à l'url lors du chargement du bloc (permet de modifier le #ENV du bloc mis à jour) ;
history : indique si le rechargement affecte ou non l'historique de navigation (faux par défaut).
Exemple :
ajaxReload('nomdubloc', { callback:function(){alert('fini');}, args:{id_article:3}, history:false });

ajaxReload peut être utilisé également sur un sélecteur jQuery auquel cas il provoquera le rechargement du plus petit bloc ajax qui contient l'élément ciblé. Il ne prend alors qu'un argument possible (le tableau d'options) : $('#contenu').ajaxReload({args:{id_article:3}})

Animations javascript :
Lors des interactions déclenchées par l'utilisateur, il est possible de déclencher plusieurs animations type qui s'appliquent toutes sur un sélecteur jQuery :

jQuery('#monid').animateLoading() déclenche l'animation de chargement sur #monid (automatiquement déclenchée lors des rechargements ajax)
jQuery('#monid').endLoading() arrête l'animation de chargement sur #monid (automatiquement déclenchée lors des rechargements ajax)
jQuery('#monid').animateAppend() anime le bloc #monid pour montrer qu'il vient d'être ajouté par l'interaction
jQuery('#monid').animateRemove() anime le bloc #monid pour montrer qu'il est supprimé par l'interaction

Fonctions utilitaires :
parametre_url() s'utilise comme sa version PHP de parametre_url pour ajouter, supprimer, récupérer des arguments d'une URL :

parametre_url(url,arg,value) ajoute arg=value à url et retourne l'url modifiée ;
parametre_url(url,arg,'') supprime la valeur de arg dans url et retourne l'url modifiée ;
parametre_url(url,arg) retourne la valeur de arg dans url

$('a').followLink() suit le lien en simulant un clic dessus (prend en compte le fait que le lien est ou non un lien ajax).

Popin dans l'espace privé :
Un lien vers une page de l'espace privé avec une classe .popin provoque l'ouverture d'une popin qui contient le coeur de la page pointée (bloc contenu/). Le lien conserve sa capacité à être ouvert dans un autre onglet via clic droit et la page complète est affichée dans ce cas.

API

SPIP 3 introduit plusieurs API génériques dans la gestion des objets éditoriaux :

une gestion générique des tables de liens d'un objet avec n'importe quel autre objet : c'est l'API editer_liens
La création de nouveaux objets éditoriaux est simplifiée par une API déclarative
une gestion générique des fonctions d'insertion, modification ou publication des objets éditoriaux : l'API editer_objet
objet_test_si_publie($objet, $id_objet) permet de tester facilement si un objet est publié ou non en fonction de son statut tel que déclaré (et en fonction d'une éventuelle post-publication)
generer_url_ecrire_objet($objet,$id_objet,$args, $ancre) renvoie l'url vers la page de l'objet dans l'espace privé. $args et $ancre sont optionnels.
le pipeline optimiser_base_disparus est appelé lors du nettoyage en base des objets à la poubelles et des liens morts qui en résultent

SPIP 3 dispose également d'une gestion de file de tâches qui permet de programmer l'exécution future ou simplement asynchone (ASAP mais sans faire attendre l'utilisateur) de fonctions.

La mise en place de configuration des plugins est simplifiée par la prise en charge automatisée des formulaires #FORMULAIRE_CONFIGURER_XXX et par l'utilisation des fonctions lire_config, ecrire_config, effacer_config (voir Configurer une fonctionnalité de votre site, ou un plugin).

Les formulaires CVT permettent facilement de faire des formulaires en plusieurs pages, et supportent également la sauvegarde automatique de la saisie par simple déclaration.
Un pipeline formulaire_fond permet de personnaliser le fond des formulaires (pour modifier le HTML du formulaire) [14]

Dans l'API SQL :

la fonction sql_skip est ajoutée et permet de sauter un certain nombre de résultats.
Les valeurs null dans sql_updateq et sql_insertq sont traduites en NULL SQL et ne sont plus assimilées à une chaîne vide.
les fonctions sql_demarrer_transaction et sql_terminer_transaction permettent respectivement comme leur nom le suggère de démarrer ou de clôturer une transaction SQL [15].

Introduction d'un point d'entrée bac-à-sable, (public/sandbox.php) pour la compilation des squelettes, permet à un plugin de gérer la compilation des squelettes dans un ensemble de filtres et fonctions en liste blanche ou liste noire, et d'interdire le PHP dans les squelettes.

Spécialisation des critères :
Il est possible de préfixer par le nom du serveur et/ou le nom de la table le nom de la fonction critère. La recherche se fait dans l'ordre :

critere_serveur_TABLE_moncritere_dist,
critere_serveur_TABLE_moncritere,
critere_serveur_moncritere_dist,
critere_serveur_moncritere,
critere_TABLE_moncritere_dist,
critere_TABLE_moncritere,
critere_moncritere_dist,
critere_moncritere

Dans le fichier options.php d'un plugin ou dans le fichier mes_options.php, $GLOBALS['marqueur_skel'] .= ":prefixe" permet de différencier le cache des squelettes compilés comme $GLOBALS['marqueur'] .= ":prefixe" permettait déjà de différencier le cache des squelettes.

[1] Outre le Porte-plume déjà intégré dans SPIP 2 et qui initiait ce mouvement, on peut citer notamment les plugins Afficher_objets, Base CSS, Navigation du privé, CVT multi-étapes, Forum, Job-queue, Mediabox, Médiathèque, TextWheel, URLs éditables, Comments, qui ont, pour certains, inspiré fortement le développement de SPIP lui-même ; pour d'autres été intégrés, avec quelquefois certaines évolutions.

[2] Ce chantier avait été amorcé depuis quelque temps sur la Zone, et celles et ceux qui d'entre vous utilisaient déjà le plugin Navigation du privé ou la médiathèque retrouveront vite leurs marques.

[3] Par exemple, le passage en édition sur un article devient instantané grâce au pré-chargement Ajax.

[4] http://core.spip.org/projects/spip/repository/revisions/17650

[5] en SPIP 2.1 ils étaient placés dans le dossier extensions/ désormais inutile.

[6] Voir le pipeline associé sur programmer.spip.org

[7] C'est une alternative aux plugin Thickbox, LightBox... qui repose sur la librairie Colorbox

[8] Connu pour SPIP 2 sous le nom "Médiathèque"

[9] en revanche le support de PostGreSQL doit être considéré comme expérimental et incomplet pour un usage en production

[10] Par exemple, pour l'envoi d'un mail "dès que possible" qui permet de rendre la main à l'utilisateur immédiatement sans devoir attendre que le mail soit effectivement envoyé

[11] dans tous les navigateurs modernes à l'exception de Internet Explorer qui ne la supporte pas encore

[12] Voir Utiliser les modèles

[13] La balise n'est plus utilisée en HTML5.

[14] http://core.spip.org/projects/spip/repository/revisions/18754

[15] Est ajouté de manière expérimentale également sql_preferer_transaction présent plutôt pour contourner un problème de lenteur sur des insertions multiples avec SQLite, qui sont exécutées plus rapidement en mode transactionnel. Cette fonction renvoie true uniquement en SQLite

Structure HTML des formulaires de SPIP

ARNO*, cerdic, Matthieu Marcillaud, tetue — 2009-06-27T10:48:14Z

Document de références précisant comment les formulaires dans SPIP doivent être structurés.

Sommaire
Structure HTML
Les classes spéciales
Cadre englobant
Gestion des messages réussite/erreur
Particularités pour les styles css
Structure HTML

Un formulaire de base est ainsi structuré :

Une légende Un texte d'explication Courriel #AIDER{arttitre} Explication du label Message d'erreur

Le div englobant porte la classe générique formulaire_spip. Les formulaires d'édition de l'espace privé portent de plus la classe formulaire_editer indiquant qu'on a affaire à un formulaire d'édition de données d'une base.

Chaque champ de saisie est encapsulé dans un élément de classe .editer, qui doivent être regroupés dans un élement de classe .editer-groupe. Jusqu'à SPIP 3.0 ces classes étaient portées respectivement par des balises html li et ul. A partir de SPIP 3.1 on prend pour convention d'utiliser de simples div pour réduire la verbosité de la synthèse vocale et améliorer l'accessibilité des formulaires.

Le premier fieldset étant optionnel, on peut aussi écrire, sans le fieldset et sans les paragraphes optionnels :

Courriel
Les classes spéciales
« explication » : pour indiquer un message d'explication (qui porte soit pour l'ensemble des champs, soit sur une étape). Exemple :
.
« attention » : pour afficher un message concernant un champ d'édition critique. Exemple : <:texte_login_precaution:>.
« obligatoire » : pour signaler un champ obligatoire, à appliquer à l'élément de liste parent. Exemple :
.
« erreur » : pour signaler une étape en erreur, à appliquer à l'élément de liste parent. Exemple :
. chaque erreur bénéficie d'un message explicatif, portant la class « erreur_message » : .
Cadre englobant

Ce formulaire peut optionnellement être inclus dans un cadre-formulaire-editer, et peut alors contenir un entete-formulaire :

Gestion des messages réussite/erreur

Messages globaux

Un formulaire comporte obligatoirement deux paragraphes permettant d'afficher les réussites et erreurs globales qui ont pu apparaître à la soumission. Les variables d'environnements message_ok et message_erreur sont des retours envoyés par SPIP (formulaires CVT).

[(#ENV*{message_ok}) ] [(#ENV*{message_erreur}) ]

Messages spécifiques

Chaque champ de formulaire, encapsulé dans un .editer peut recevoir un message d'erreur spécifique. Celui-ci est contenu dans le tableau d'environnement 'erreurs' et peut être obtenu de la sorte :

[(#ENV**{erreurs}|table_valeur{nom_du_champ})]

On peut attribuer la classe 'erreur' à .editer et afficher une erreur spécifique si elle existe de la sorte :

<:texte_descriptif_rapide:> [(#ENV**{erreurs}|table_valeur{desctiptif})] [(#ENV**{descriptif})]
Particularités pour les styles css

Champs input

Chaque différent de hidden doit posséder une classe identique à son type (afin de palier à un déficience du navigateur Internet Explorer) :

Boutons de soumission

Les boutons de soumissions sont inclus dans une boîte .boutons (qui peut recevoir plusieurs boutons) :

" />

radio/checkbox

Dans le cas de bouton radio ou checkbox, on peut ne pas reprendre tout a fait la même structure, par exemple pour avoir le bouton avant le label, ou pour avoir la liste radio en horizontal.

Chaque entrée (radio + label) peut alors être encadrée par un bloc .choix

<:bouton_radio_non_syndication:> <:bouton_radio_syndication:>#AIDER{rubsyn}

Par défaut, la liste est verticale. Pour rendre la liste horizontale,
il suffit de spécifier que .champ en question est de type inline :

.formulaire_editer .editer_syndication .choix {display:inline;}

Principes généraux de ces formulaires pour avoir les labels alignés à gauche

On se retrouve dans un cas où l'on a :

1) on applique un padding gauche au .editer supérieur à la taille du label (ex:120px)

.formulaire_spip .editer { margin: 0; padding: 10px 10px 10px 130px; clear:both; border-top: 1px solid #eee; }

2) on demande au label d'être flottant et décalé sur la gauche (via un margin négatif)

.formulaire_spip .editer label { width: 120px; float:left; margin-left:-125px; text-align: left; vertical-align: top; }

3) lorsqu'un fieldset suit un .editer, on le décale aussi vers la gauche
(seul IE n'en tient pas compte) pour que le fieldset prenne toute la
largeur aussi

.formulaire_spip .editer fieldset { border:1px solid #888; background:white; margin-left:-125px; /* redecalage vers la gauche... IE < 8 ne le prend pas en compte */ }

Le statut des auteurs dans SPIP

tetue — 2008-05-25T09:46:28Z

SPIP permet de gérer trois statuts d'auteurs différents : visiteur, rédacteur, administrateur.

Si vous possédez des identifiants de connexion à un site SPIP, vous êtes « auteur » sur ce site.

Il existe dans SPIP trois sortes d'auteurs : les visiteurs, les rédacteurs et les administrateurs.

Le visiteur (6forum) est une personne qui peut simplement accéder aux parties restreintes du site public ainsi qu'aux forums auquel il est abonné. Il n'a aucun accès à la partie privée (/ecrire) du site.

Le rédacteur (1comite) est une personne qui a accès à l'espace privé du site et qui ne peut que rédiger des textes et proposer des contenus (textes et documents multimedia) à l'évaluation. C'est le statut le plus couramment utilisé.

L'administrateur (0minirezo) est une personne qui a accès à l'espace privé et qui a « tous les droits » sur le site : ajout, modification et suppression des contenus, relecture et correction des textes rédigés par les autres rédacteurs, modification l'arborescence, etc. et surtout publication sur le site public.
Il est le responsable moral du contenu du site.
L'administrateur restreint est un administrateur dont les droits sont restreints à une ou plusieurs rubriques.

Exemples de droits typiques des auteurs SPIP

Visiteur

Rédacteur

Administrateur

Il peut :

Visiter le site public
Participer aux forums sur abonnement du site public [1]

Il ne peut pas :

accéder à l'espace privé.
Il peut faire tout ce qu'un visiteur peut faire mais aussi :

rédiger de nouveaux contenus : écrire un nouvel article, une nouvelle brève [1], ajouter des images et documents, référencer un site web [1], etc.
proposer ces nouveaux contenus à la relecture avant publication ;
continuer à écrire et corriger ses articles « en cours de rédaction » ou « proposés à la publication » ; modifier une brève « à valider » [1] ;
relire et commenter les articles proposés à la publication par d'autres rédacteurs ;
prévisualiser les articles « proposés à la publication » sur le site public [1] ;
consulter la liste des auteurs ;
consulter la liste des mots-clés [1] ;

Il ne peut pas :

Modifier un article publié, même s'il en est l'auteur ;
Créer un nouvelle rubrique.
Il peut faire tout ce qu'un rédacteur peut faire mais aussi :

Publier les contenus sur le site public : valider et publier un article, une brève, un site, etc.
Modifier les contenus déjà publiés ;
Modérer les forums de discussion ;
Associer un nouvel auteur à un article ;
Modifier les droits et statuts des autres auteurs ;
Créer de nouveaux auteurs ;
Modifier les paramètres de configuration générale du site ;
Activer, désactiver et paramétrer des fonctionnalités supplémentaires.

SPIP ne propose par défaut que trois statuts différents : ceux-ci suffisent largement à la gestion de bien des sites. Cependant, il est possible d'étendre la liste de ces statuts et de diversifier les droits, notamment par l'ajout de plugins spécifiques.

Remarque : il existe aussi un statut temporaire 'à la poubelle' (5poubelle dans la base de donnée) pour les auteurs qui viennent d'être désactivés. Ces enregistrements sont automatiquement détruits lors du passage de la tâche de fond nettoyeuse après un jour ou 2, le plugin "corbeille" proposant une alternative à cette destruction.

[1] Si cette fonctionnalité est activée.

Modifier le nom de « Mon site SPIP »

tetue — 2007-12-30T22:39:39Z

La première chose à faire sur votre site SPIP est d'indiquer son identité : son nom, son slogan, son adresse Web, etc.

Sommaire
Le formulaire « Identité du site »
Nom de votre site
Slogan du site
Adresse (URL) du site
Descriptif rapide
Adresse e-mail du webmestre
Logo du site
Le formulaire « Identité du site »

Vous trouverez tout dans Configuration -> Identité du site.

Notez au passage que ces informations importantes sont utilisées par des balises ou des formulaires présents dans les squelettes de votre site ; ces informations agissent sur le contenu de vos pages et donc sur le référencement de votre site.

Nom de votre site

Le premier champ du formulaire, intitulé « Nom de votre site », permet de saisir et d'enregistrer le texte qui deviendra le nom du site affiché dans le titre de chacune des pages. Par défaut celui-ci contient « [Mon site SPIP] » : n'oubliez pas de changer ce nom et d'y mettre le vôtre !

Cette information est appelée dans les squelettes avec la balise #NOM_SITE_SPIP

Slogan du site

C'est la description courte de votre site / activité. Il s'affichera sous le logo / titre de votre site.

La balise associée : #SLOGAN_SITE_SPIP

Adresse (URL) du site

Ce champ doit contenir l'adresse URL de votre site public.
Astuce : laissez ce champ vide et validez le formulaire. Le champ sera automatiquement rempli.

La balise associée : #URL_SITE_SPIP

Descriptif rapide

Rédigez quelques phrases courtes et descriptives qui permettront aux visiteurs de savoir rapidement de quoi parle votre site.

La balise associée : #DESCRIPTIF_SITE_SPIP

Note : ce descriptif peut être utilisée pour remplir la balise meta description destinée aux moteurs de recherche. Dans ce cas, la description doit contenir moins de 160 caractères.

Adresse e-mail du webmestre

Par défaut, SPIP prend l'adresse de celui qui a installé le site (le premier administrateur).

La balise associée : #EMAIL_WEBMASTER

Logo du site

Chargez ici le logo de votre site.

Si vous utilisez les squelettes par défaut de SPIP, ce logo est affiché dans le bandeau. Ce logo est également présent ailleurs, notamment dans le fichier « backend » auquel les internautes peuvent s'abonner. Choisissez-le donc de dimensions raisonnables.

La balise associée : #LOGO_SITE_SPIP

Essayer SPIP

ARNO*, tetue — 2007-12-04T09:14:37Z

Pour tester SPIP en conditions réelles sans à avoir à l'installer techniquement, le site SPIP Démo, propose la dernière version stable de SPIP : https://demo.spip.net

Parcourez le site public déjà riche d'exemples et découvrez l'espace privé sous les différents statuts existants :

Pour plus de précisions, commencez par la page « Comment ça marche ».

Conseils généraux sur la traduction de spip.net

tetue — 2006-12-31T23:00:00Z

Sommaire
Le rubriquage de www.spip.net
Classement des articles dans les rubriques
Rythmer la présentation de la page d'accueil
Référencement de ressources externes
Le glossaire
Le rubriquage de www.spip.net

Le rubriquage du secteur français « Documentation en français » sert de référence. Il est visible in extenso à la page « plan de site ». Il convient donc de le reproduire dans chaque secteur de langue.
Cependant les secteurs peu traduits contiennent peu d'articles : mieux vaut alors ranger ces quelques articles directement à la racine du secteur, sans s'embarasser de rubriques.

Sur le site public, les rubriques et sous-rubriques sont classées par leurs numéros de titre.
Les quatre premières rubriques à la racine du secteur constituent les onglets de la barre de navigation.

Seules les rubriques principales bénéficient de logos. Ils ne contiennent pas de texte, ce qui permet de les utiliser dans toutes les langues. Il est donc conseillé de récupérer les icones de la version française pour les installer dans les rubriques correspondantes des autres langues. Le site n'utilise pas les « logos pour survol ».

Classement des articles dans les rubriques

Il y a deux façons de « classer » les articles sur www.spip.net:

(par num titre) dans certaines rubriques, il est nécessaire de « forcer » le classement des articles selon une certaine logique (par exemple dans les tutoriels et le manuel de référence), qui est celle d'une explication qui se déroule sur plusieurs articles successifs ; il suffit de numéroter les titres des articles, avec un numéro suivi d'un point et d'un espace (« 10. Premier article », « 20. Deuxième article »...) ;

(par date inverse) dans les rubriques qui ne nécessitent pas une lecture « à la suite » des articles (FAQ, trucs et astuces... et « Évolutions et mises à jour »), on ne numérote pas les articles, ce qui permet de présenter en haut de liste les derniers articles publiés, les plus anciens en bas.

Dans les squelettes, la présentation s'adapte automatiquement selon la présence ou non de la numérotation.

Rythmer la présentation de la page d'accueil

Le site est doté d'une page d'accueil par langue. Elles contiennent des pavés qui rythment la page et mettent en valeur certains éléments, de façon à présenter SPIP, mais aussi les ressources et les nouveautés dans chaque langue.

Le premier texte affiché est celui de la rubrique-secteur de la langue. Il présente SPIP et l'objet de ce site. Pour le modifier : « modifier la rubrique », champ « texte ».

Référencement de ressources externes

Les principaux sites de référence sont présentés dans la "boussole" présente en haut de chaque page.

La boussole

Un espace de discussion "Espace d'entraide multilingue & discussions des traductions".

Pour faire un lien dans le corps d'un texte, on préférera employer le raccourci SPIP correspondant au site référencé. Par exemple, plutôt que d'écrire [SPIP Contrib->http://www.spip-contrib.net], on écrira [->site57] (ce qui s'affichera ainsi : SPIP - Contrib).

Le glossaire

Les boucles, balises, filtres, etc. de SPIP sont listés sous forme de mots-clés, qui sont associés aux articles qui les documentent en français, afin de constituer un glossaire complet du langage SPIP. Dans les autres langues, ces mots-clés sont inutiles, le squelette du glossaire proposant automatiquement les traductions disponibles.

Sauvegarder vos données

dani, L'équipe de SPIP, tetue — 2006-07-23T02:40:00Z

Que ce soit pour effectuer une mise à jour de SPIP, ou pour déménager votre site, vous aurez besoin de sauvegarder vos données. Ou simplement, vous êtes une personne précautionneuse et vous vous préoccupez de faire régulièrement des sauvegardes de votre site. C'est bien.

Sommaire
1. D'abord vider le cache
2. Sauvegarder la base de données
Réaliser une sauvegarde complète
Automatiser les sauvegardes
1. D'abord vider le cache

Pour éviter de récupérer un lourd tas de fichiers inutiles, pensez à vider le cache de votre site SPIP avant d'en récupérer les données (surtout si votre site compte beaucoup de visites).

Pour vider le cache de votre site, rendez-vous en tant qu'administrateur, à la page « Configuration du site > Vider le cache » de l'espace privé, sans oublier de cliquer ensuite sur le bouton « Vider le cache » de la page affichée. Le message « Le cache est vide » confirme l'action.

2. Sauvegarder la base de données

La base de données est le cœur de votre système d'information : tout le contenu des articles, des brèves, des rubriques, des auteurs et des forums y est stocké.

Pour réaliser la sauvegarde de votre base de données (c'est-à-dire de l'intégralité de vos documents réalisés avec SPIP), rendez-vous dans la page « Sauvegarder la base » du menu maintenance de l'espace privé

La sauvegarde générée à partir du site est sous le format SQLite : nom_site_aaaammjj.sqlite [1] Une fois le fichier de sauvegarde généré, vous pouvez le récupérer en FTP à l'adresse ./tmp/dump/

Remarque importante : Cette sauvegarde n'est utilisable qu'avec la version de SPIP dans laquelle elle a été effectuée. Pensez à la noter ou à télécharger cette version de SPIP pour pouvoir tout retrouver comme avant en cas de problème. Répétons ce conseil, car c'est une erreur très classique : en cas de mise à jour de SPIP, ne réinstallez pas la base de données à partir de la sauvegarde effectuée précédemment avec un SPIP de version antérieure. Utilisez votre sauvegarde pour déménager votre site vers un SPIP de même version.

Il est aussi possible de faire une sauvegarde de la base sans passer par SPIP en effectuant un export de la base sous phpMyAdmin qui permettra alors des montées en version.

Réaliser une sauvegarde complète

Dans le cadre d'une simple mise à jour de SPIP, il n'est pas nécessaire de sauvegarder l'intégralité de votre site. Par contre, c'est indispensable si vous souhaitez déménager votre site.

Pour avoir une sauvegarde complète de vos données SPIP, il faut également penser à récupérer (par FTP) :

votre dossier /IMG (et ses sous-répertoires), qui contient toutes les images et les documents joints du site
vos squelettes et tout ce que contient votre dossier « squelettes »
vos fichiers personnalisés mes_options.php et mes_fonctions.php
les contributions et les plugins que vous aviez installés et tout ce que contient votre dossier « plugins »
Les fichiers config/clés
Automatiser les sauvegardes

A noter, qu'il existe le plugin Saveauto qui permet de sauvegarder quotidiennement sa base de données.

[1] jusqu'à SPIP 2.1| XML| dump.xml ou dump.xml.gz

Styles des citations dans SPIP

tetue — 2006-06-18T20:07:44Z

Citations d'auteurs, de code informatique ou de poésie, SPIP facilite l'insertion de citations dans vos textes. Code is poetry !

Sommaire
Les citations de SPIP
Poésie
Le code informatique affiché dans SPIP
Les citations de SPIP

Pour simplifier l'insertion de citations dans vos textes, SPIP propose le raccourci suivant :

Ceci est une citation.

ce qui donne :

Ceci est une citation.

Son apparence est contrôlée par la définition de style blockquote.spip.

Signalons l'existence d'une autre balise HTML, que vous pouvez également utiliser dans vos textes : à la différence de celle utilisée dans le raccourci de SPIP (
) qui « va à la ligne », permet de faire une citation au fil du texte.

Poésie

SPIP propose de plus une mise en forme particulière pour la poésie, avec le raccourci suivant :

Voici de la poésie.

ce qui donne :

Voici de la poésie.

Son apparence est contrôlée par la définition de style div.spip_poesie.

Le code informatique affiché dans SPIP

Pour citer du code informatique au fil du texte
On utilise le raccourci SPIP suivant : de>Du code dans le textede> ce qui donne Le style associé est .spip_code. Pour afficher du code informatique dans un bloc </code>}} Le raccourci <code> ... </code> permet de présenter du code informatique dans un bloc de formulaire, ce qui facilite le copier-coller du code. .spip_cadre . Ces deux derniers raccourcis, et leurs définitions de style correspondantes, sont peu utilisés, sauf dans le cas d'une documentation technique (comme celle-ci) où l'on doit citer des morceaux de code informatique, des noms de fichiers ou de répertoires.
Styles des raccourcis typographiques de SPIP tetue — 2006-06-18T20:07:21Z Voici les styles CSS associés aux raccourcis typographiques les plus courants et les plus simples de SPIP. Sommaire Les paragraphes de SPIP Gras et italique Les intertitres de SPIP Le trait de séparation horizontal de SPIP Les notes de bas de page Pour faciliter la mise en forme des textes, SPIP propose un certain nombre de « raccourcis SPIP » qui font l'objet d'un traitement automatisé : ils sont remplacés par le code HTML correspondant, doté d'un style (généralement la classe spip). Pour affiner encore davantage la mise en forme des textes, vous pouvez modifier les styles CSS associés à ces raccourcis typographiques. Les paragraphes de SPIP Pour créer des paragraphes dans SPIP, il suffit de laisser une ligne vide. Les paragraphes ainsi générés par SPIP sont dotés de la classe spip : Voici le texte de mon paragraphe Pour ajuster, par exemple, l'espace entre chaque paragraphe, modifiez la définition de style : p.spip. Remarque : ceci n'est valable que pour les textes en plusieurs paragraphes ; les textes écrits d'un seul bloc, en un seul paragraphe, n'étant pas dotés de balises . Gras et italique Le gras et l'italique sont générés par les raccourcis suivants : Du texte {en italique}, du texte {{en gras}} Leur apparence est contrôlée par les définitions de style respectives : i.spip et strong.spip. Ces styles sont peu utiles, et ne sont d'ailleurs pas définis par défaut. Les intertitres de SPIP Les intertitres sont créés par le raccourci suivant : {{{Un intertitre}}} Leur apparence est contrôlée par la définition de style h2.spip (avant SPIP 4.0, c'était h3.spip [1]). Ce style est sans doute l'un des plus importants, car il permet de définir la taille, la police et le positionnement des intertitres dans les articles : vous serez certainement amenés à le modifier en fonction de vos choix graphiques et typographiques. Notez en particulier les attributs margin et padding qui permettent d'agir sur l'espacement de l'intertitre avec les paragraphes précédent et suivant. Sans ce réglage, l'intertitre serait soit trop « collé » au reste du texte, soit trop espacé. Le trait de séparation horizontal de SPIP Le trait de séparation horizontal est généré par ce raccourci SPIP : ---- Son apparence est contrôlée par la définition de style : hr.spip. Remarque : La ligne horizontale ( ) est un élément délicat à styler, car les styles CSS qui lui sont appliqués sont interprétés différemment selon les navigateurs. Les notes de bas de page Les notes de bas de page, sont créées par le raccourci : Le texte[[Ceci est une note de bas de page.]]. Leur apparence est contrôlée par plusieurs définitions de style : - a.spip_note permet de différencier visuellement les appels des notes de bas de page des autres liens (c'est-à-dire leurs numéros, tant dans le corps du texte qu'en bas de page) ; - p.spip_note contrôle l'affichage des notes elles-mêmes ; bien souvent inutile (on préférera en effet définir ce style plus simplement, à partir du style de la balise parente). [1] et le plugin "Historique h3" permet de retrouver ce fonctionnement avec SPIP 4.0

Visiteur	Rédacteur	Administrateur
Il peut : Visiter le site public Participer aux forums sur abonnement du site public [1] Il ne peut pas : accéder à l'espace privé.	Il peut faire tout ce qu'un visiteur peut faire mais aussi : rédiger de nouveaux contenus : écrire un nouvel article, une nouvelle brève [1], ajouter des images et documents, référencer un site web [1], etc. proposer ces nouveaux contenus à la relecture avant publication ; continuer à écrire et corriger ses articles « en cours de rédaction » ou « proposés à la publication » ; modifier une brève « à valider » [1] ; relire et commenter les articles proposés à la publication par d'autres rédacteurs ; prévisualiser les articles « proposés à la publication » sur le site public [1] ; consulter la liste des auteurs ; consulter la liste des mots-clés [1] ; Il ne peut pas : Modifier un article publié, même s'il en est l'auteur ; Créer un nouvelle rubrique.	Il peut faire tout ce qu'un rédacteur peut faire mais aussi : Publier les contenus sur le site public : valider et publier un article, une brève, un site, etc. Modifier les contenus déjà publiés ; Modérer les forums de discussion ; Associer un nouvel auteur à un article ; Modifier les droits et statuts des autres auteurs ; Créer de nouveaux auteurs ; Modifier les paramètres de configuration générale du site ; Activer, désactiver et paramétrer des fonctionnalités supplémentaires.