I – Présentation de spip Environnement : les CMS, définition et contraintes, les rôles

a) Environnement : les CMS (Content Management System) ou SGC : Système de Gestion de contenu exemples : Guppy, Joomla, Spip, Drupal système adapté pour réaliser des sites d’entreprises, d’organismes, dont l'ergonomie est avancée Simplicité pour l'utilisateur final : mise à jour directe, en ligne Souvent issu du monde du logiciel libre Séparation du contenu et de la présentation Gestion des droits (notion de rôles) notion de chaîne de publication

b) SPIP qu'est ce que c'est ? Définition, contraintes

Qu’est-ce que SPIP ? un système, installé sur un serveur permettant la création d’un site structuré comme un magazine papier Automatisation du fonctionnement classique d’une publication : comité éditorial, rédacteurs, etc.

Des journalistes choisissent Spip L'agence Internews (service aux médias) justifie son choix ainsi : spip offre aux journalistes l'environnement d'une rédaction traditionnelle (hiérarchie de la responsabilité éditoriale, suivi des révisions, trace des communications pendant le processus d’édition, archivage par mots clés...) tout en ouvrant l’accès à toutes les possibilités du Web (flux RSS, contenus multimédias, statistiques, moteur de recherche...). SPIP répond aux besoins d' une équipe éditoriale éclatée géographiquement (forums privés, messagerie interne, calendrier...). Facilité d’emploi de SPIP ainsi que son multilinguisme (SPIP existe en plus de 50 langues, et permet la gestion de plusieurs langues au sein d’un même site) ont été deux critères déterminants. http://www.spip-contrib.net/Spipmedia-net-un-referentiel

Les contraintes de SPIP 1) comme tout CMS La ligne éditoriale doit être établie et structurée en rubriques et sous-rubriques Les responsabilités doivent être distribuées clairement Chacun doit connaître sa place, ses procédures et assurer sa fonction dans le système

Les contraintes de SPIP 2) spécificités de spip Spip tel qu'on le télécharge a un aspect graphique rudimentaire et présente obligatoirement les derniers articles sur la première page => recours aux feuilles de style, à la programmation ou à un complément (squelette, plugin) qu'il faut trouver et connaître Aspect figé des droits (rôles) et de l'ergonomie

c) Spip : la répartition des rôles

Les visiteurs Ils peuvent : parcourir les rubriques et les articles publiés participer aux forums publics ouverts

Les rédacteurs Les tâches qui leur incombent : proposer régulièrement des articles et des brèves en rapport avec certains sujets traités sur le site commenter, corriger les articles d’autres rédacteurs consulter les forums, répondre aux messages

Les administrateurs (de plein droit) responsabilité éditoriale + technique sur l'ensemble du site Les tâches (rôles) qui leur incombent : Définition de la ligne éditoriale du site : conception de la charte graphique, des rubriques, Conception des squelettes des pages Sauvegarde et restauration Paramétrage avancé du fonctionnement du site Rédaction d’articles et de brèves Correction et validation des articles proposés par les rédacteurs Gestion et modération des forums publics (et suppression des messages) envoi d'annonces à tous les participants Recrutement de nouveaux rédacteurs

Les administrateurs (restreints) Presque pas de droits sur la technique, droits éditoriaux sur les rubriques qui leur sont attribuées, droits de rédacteurs sur tout le site Les tâches (rôles) qui leur incombent : Rédaction d’articles et de brèves dans toutes les rubriques Correction et validation des articles proposés par les rédacteurs sur les rubriques qui leur sont attribués Gestion et modération des forums publics sur sa rubrique (sans la possibilité de supprimer les messages) Envoi d'annonces à tous les partipants Sauvegarder le contenu de la base

II Installer, utiliser Spip a) Installation b) Spip / rédacteurs c) Spip / administrateurs

a) Installation de Spip chez un hébergeur distant : procédures 1/ Trouver un hébergeur compatible 2/ Recevoir les paramètres de votre hébergement et les comprendre 3/ Récupérer les fichiers de Spip 4/ Lancer Spip sur l’espace d’hébergement (avec un logiciel FTP) 5/ Configurer l’accès à votre site spip (avec le navigateur)

1/ trouver un hébergeur compatible Il faut hébergeur proposant une base de donnée Mysql, et aussi Php Serveur : de préférence Apache SPIP 1.9 nécessite une version de php supérieure à 4.0.8, compatible avec les versions 5.x. Compatibilité avec MySQL 4 et 5. voir : www.spip.net/fr_article3368.html

Quelques hébergeurs compatibles www.amen.fr et OVH : solution payante dizaine d’euro par an => Solution professionnelle www.free.fr : solution gratuite (site perso) Hébergement free réservé aux clients free : prendre un accès internet gratuit (inutile de l’utiliser) puis retourner sur www.free.fr avec login et mot de passe client pour activer l’espace d’hébergement puis activer la base de donnée Mysql (en un clic de souris et 24 heures d’attente à chaque fois)

2/ Les paramètres de votre hébergement 2 types de paramètres : A/ Pour le FTP (File Transfert Protocole) serviront à mettre en ligne les fichiers de Spip avec un logiciel FTP comme Filezilla, simple et gratuit B/ Pour la base de donnée Mysql, qui serviront à paramétrer Spip (après la mise en ligne des fichiers) pour sa mise en rapport avec la dite base de donnée

2/ Les paramètres de votre hébergement A/ Les paramètres FTP fournis par l’hébergeur : Une adresse FTP : charger vos fichiers sur le serveur distant : ftp://ftpperso.free.fr (exemple de free) Un login FTP : urf1 par exemple Un mot de passe FTP : mlcalb par exemple Tous ces paramètres FTP seront utiles Note : vous disposerez aussi de l’URL de votre site: http://urf1.free.fr par exemple

2/ Les paramètres de votre hébergement B/ Les paramètres de la base de donnée Mysql fournis par l’hébergeur Note : sauf rares exceptions, votre base de donnée sera « activée » (installée, mais vide, par l’hébergeur) Une adresse de la bdd : sql.free.fr par exemple, chez free. A connaître, mais Spip devrait la détecter automatiquement

2/ Les paramètres de votre hébergement B/ Les paramètres de la base de donnée Mysql fournis par l’hébergeur (suite) Le nom de la base de donnée : urf1(par exemple) Login de la base de donnée : urf1 (par exemple) Mot de passe de la base de donnée : mlcalb (par exemple) Pour Configurer Spip, il faudra le nom, login et mot de passe de votre b.d.d. Mysql

3/ Récupérer Spip Télécharger la dernière version de Spip http://www.spip.net/fr_download 2 possibilités : 1/ (simple et rapide) récupérer spip_loader.php, le fichier d'installation automatique qui, une fois en ligne, ira chercher automatiquement les autres fichiers 2/ (si l'install. automatique échoue) récupérer tout spip, décompresser l'archive puis lancer le contenu du dossier spip obtenu

4/ Lancer les fichiers de Spip Il faut lancer sur le serveur le fichier spip_loader.php (cas de l'installation automatique) ou le contenu du dossier Spip (et non le dossier lui-même) avec un logiciel FTP comme Filezilla. FTP = File Transfert Protocol, protocole d’accès optimisé pour le chargement de fichiers. Se servir de l’adresse FTP, login et password et faire passer le ou les fichiers du local (votre poste) au distant (hébergeur)

5/ Configurer l'accès au site spip Se rendre à l’adresse de votre spip (http://urf1.free.fr par exemple) et suivre les indications qui apparaissent connexion Mysql : adresse de la bdd, login password de la bdd Choix de la bdd Informations personnelles : sert à créer votre signature, login et password pour mettre à jour votre site

Menu des rubriques actives et alimentées en articles L’espace public Les visiteurs du site géré sous SPIP accèdent à une page présentant au moins ces éléments : Menu général du site : plan du site, lien “Administration” pour l’accès à l’espace privé Menu des rubriques actives et alimentées en articles Article publié le plus récemment

La page de login Adresse du site suivi de /ecrire http://www.monsitespip.org/ecrire

L’espace de développement

Interface simplifiée et interface complète L’interface simplifiée ne donne accès qu’aux commandes les plus courantes Interface complète L’interface complète ajoute des contrôles supplémentaires : gestion des mots-clefs, maintenance et configuration avancée du site, etc…

b) Fonctions utiles pour rédacteurs Rédiger un article Les brèves

Les raccourcis typographiques 2 fois sur la touche Entrée du clavier pour changer de paragraphe, <BR> pour un simple saut de ligne ---- (quatre tirets) = donne une ligne horizontale Mémento des raccourcis http://www.spip.net/fr_article1578.html

Exercices de rédaction Faire 3 rubriques, et 5 ou 6 articles, les publier : prêter attention à leurs apparences, mode d’affichage, numéros d’arti ou de rub, statut (brouillon, publié) Exercices sur les raccourcis typographiques : tester les puces, gras, etc. Faire lien hypertexte vers site Lien hypertexte vers un article Lien vers une rubrique

Macro Word Convertit format word en format spip… http://www.spip-contrib.net/Macro-word L’INSTALLATION - renommer "macro_word.dot" en " Spip.dot" - - Copier "Document Spip.dot" dans C :\Program Files\Microsoft Office\Modèles\Autres Documents - Démarrer Word - choisir Fichier/Nouveau/Autres Documents/Document Spip.dot - Taper du texte - Puis générer du texte au format SPIP dans un nouveau document en cliquant sur la petite baguette magique sous "Edition"

Les brèves brèves = petits articles, avec moins de champs, attachés exclusivement aux rubriques de premier niveau, sans rédacteurs, destinées à être remplacées régulièrement

c) Etre administrateur : les principaux paramétrages

Créer un auteur : rédacteur Administrateurs peuvent créer des rédacteurs : aller sur auteurs, créer un auteur, puis le nommer rédacteur Auteur est le terme générique qui désigne les participants, qu'ils soient "rédacteurs" ou "administrateurs".

Exercice : rédacteur L'administrateur crée un rédacteur Le rédacteur créé un article et le soumet à l'administrateur qui le validera ou non Tester la communication interne à l'espace privé (forum interne et messagerie) Messages : de 1 à 1,2,3 ou plus (message), ou de administrateur à tous (annonce) ou à soi-même (pense-bête). Peuvent être liés au calendrier (création de tâches)

Créer un auteur : administrateur Il suffit de donner le bon statut à un auteur créé.. Administrateur "plein" : droits sur toutes les rubriques, accès à la configuration du site Administrateur restreint : droits sur une ou plusieurs rubriques, pas d'accès à la configuration du site, pas de création de rédacteurs Possibilité d'avoir un forum réservé aux "administrateurs pleins" (accès par : configuration du site, interactivité)

Ajouter des aides à la rédaction Possibilité d'avoir un suivi des révisions (l'option doit avoir été activée par configuration / fonctions avancées, l'article doit avoir été publié Possibilité d'activer un correcteur orthographique

Ne pas afficher certains champs des articles Facilite la tâche du rédacteur Menu : configuration pour y accéder

Gestion des éléments de la structure : brèves Conseil : avant d'activer cette fonction : brève, bien établir la politique éditoriale afin d'éviter le double-emploi avec les articles Brèves s'activent ou se désactivent par le menu : configuration/contenu du site...

Exo Créer 3 ou 4 brèves Repérer la page d’une brève Conclusion : allez-vous vous servir des brèves, place dans votre stratégie éditoriale

Gestion des éléments de la structure : mots-clefs Ils servent à renforcer l'indexation d'un article, qui sera retrouvé après une interrogation du moteur de recherche sur ce mot-clé Il faut créer les mots-clés pour pouvoir les attribuer aux articles Des mots-clés appartenant à des groupes de mots et liés aux articles permettent de proposer une navigation thématique permettent de contourner la limitation de SPIP selon laquelle un article ne peut appartenir qu’à une seule rubrique. - articles, brèves, rédacteurs, mots-clefs ...

Les mots clefs peuvent être attribués à divers éléments, par les administrateurs ou par les rédacteurs mots clefs : important pour la programmation dans Spip et pour de nombreux squelettes (Epona, Beespip, etc…)

III Perfectionnement Spip bdd, sauvegarde, cache système de fichier, notions sur les boucles squelettes, plugins

Schéma général de fonctionnement Base MySql Pages html dynamiques Langage PHP SPIP "squelette(s)" (mode(s) d'affichage des pages) CSS Entrer des données par formulaire Site web

structure de la base de données Le contenu du site Spip est conservé dans une base de donnée Mysql hébergée sur le serveur Une table pour les rubriques, une pour les rédacteurs, une pour les articles Pour plus d’infos, consulter http://www.spip.net/fr_article713.html

Base de données MySQL

structure de la base de données Exemple : la table articles comprend les champs : id_article, surtitre, titre, soustitre, id_rubrique, descriptif, chapo, texte, etc..

Sauvegarde de la BDD N'oubliez pas également de récupérer l'intégralité du répertoire IMG/, qui contient les images et les documents utilisés dans les articles et les rubriques. Attention: cette sauvegarde ne pourra être restaurée QUE dans un site installé sous la même version de SPIP. Il ne faut donc surtout pas « vider la base » en espérant réinstaller la sauvegarde après une mise à jour... «Configuration/Maintenance» de l’espace privé, et cliquez sur le bouton « Sauvegarder la base ». Plus d'infos : http://www.spip.net/fr_article3418.html

Restauration de la BDD

Restauration de la BDD

Mettre à jour votre version de Spip B) La mise à jour Il suffit de faire une nouvelle installation de spip "par-dessus" la précédente. Les nouveaux fichiers écraseront les anciens. Voir : www.spip.net/fr_article1318.html

Mettre à jour votre version de Spip C) La mise à jour : passer de 1.8 (ou antérieur) à 1.9 compte tenu de la profonde réorganisation des fichiers, une documentation plus complète explique comment faire une mise à jour propre : Voir : www.spip.net/fr_article3370.html

Gestion du cache  Dans la partie « Configuration Maintenance » de l’espace privé, un bouton « vider le cache » efface tous les fichiers cachés. A faire après des mises à jour du site, ou se servir du bouton recalculer page par page Possibilité aussi de vider le cache des images et du moteur de recherche Voir : http://www.spip.net/fr_article886.html

Fonctionnement du cache un système de cache permet de stocker chaque page et ainsi d’éviter de provoquer des appels à la base de données à chaque visite. délai du cache défini dans le fichier html du squelette, par une balise #CACHE{délais}, par exemple #CACHE{3600}

b) Les bases du système de fichier Les fichiers dist : Dossier dist comprend les fichiers de la distribution originale (et que la distribution originale). SPIP recherche les fichiers .html des squelettes d’abord dans le répertoire squelettes, puis s’ils n’y existent pas, dans le répertoire racine du site . En dernier recours, SPIP prend les fichiers par défaut dans le répertoire « dist ». Lors d'une mise à jour de spip, Seuls les fichiers dist seront affectés, un squelette installé restera intact. Créer vos fichiers htm (personnalisation de spip) dans le dossier squelettes Voir : http://www.spip.net/fr_article3347.html

La structure des fichiers Spip Dossier racine contient : Fichiers PHP (instructions de fonctionnement) CACHE (TEMP depuis 1.9.2) contient : cache des pages HTML visitées Dossier dist/ contient : pages HTML modèles, feuilles de style Dossier ecrire/ contient : administration du site (Fichiers PHP ) Dossier formulaires/ contient : pages HTML des formulaires Dossier IMG/ contient : Doc liés aux articles (images, PDF, .doc, etc.) Aller voir en même temps la structure des fichiers

Les fichiers .PHP <?php # appel SPIP include ('spip.php');?> Contiennent instructions de fonctionnement <?php # appel SPIP include ('spip.php');?> index.php

Autres fichiers PHP Dans les sous-répertoires du dossier écrire Le sous-répertoire exec/ contient les fichiers php qui produisent les pages de l'espace privé (suivi_revisions.php , mots_edit.php , forum_admin.php , editer_auteurs.php etc.) Le sous-répertoire base/ contient les fichiers php qui gèrent la base de donnée

Les fichiers HTML Dans le dossier DIST/ Décrivent l'interface graphique des pages (HTML) + des instructions permettant d’indiquer à SPIP où il devra placer les éléments tirés de la base de données (Mysql + code spip)

Un fichier HTML INSTRUCTION EN CODE SPIP <BOUCLE_article(ARTICLES){id_article=1}> #TITRE </BOUCLE_article> article.htm Cette instruction en "code spip" insérée au html de article.htm permettrait d'afficher le titre de l'article n°1

Feuilles de style CSS et Spip Moyen puissant de modifier l'habillage graphique du site Permettent de générer des règles de mises en forme spécifiques pour des élement précis : paragraphes, liens, etc.. La feuilles de style essentielle de SPIP est :   habillage.css Les feuilles de style sont dans le dossier dist. Pour les personnaliser, les copier dans un répertoire squelettes (à créer) puis les modifier Consultez : www.spip.net/fr_rubrique269.html

Infos sur le fonctionnement Pour plus d’informations, consulter : http://www.spip.net/fr_article877.html

Les < BOUCLES > Une <BOUCLE> permet de lire la base de données Les <BOUCLES> SPIP sont traduites par SPIP en requêtes SQL qui permettent d’interroger la base de données. On peut ainsi lire les tables :   ARTICLES : <BOUCLE_nom(ARTICLES) .....>   RUBRIQUES : <BOUCLE_nom(RUBRIQUES) .....>   SITES : <BOUCLE_nom(SITES) .....>   MOTS : <BOUCLE_nom(MOTS) .....> le début de la boucle est noté : <BOUCLE_le_nom_de_la boucle...>   la fin par : </BOUCLE_le_nom_de_la boucle...>

Notions élémentaires sur les boucles

Les #BALISES Pour chacune de ces <BOUCLES> il est possible d’afficher les différents champs de la table, ces champs sont directement accessible par des #BALISES que l’on insère dans la <BOUCLE>, ainsi pour la <BOUCLE_nom(ARTICLES)> on peut afficher :   le titre : #TITRE ;   le surtitre : #SURTITRE ;   le chapeau : #CHAPO ;   le texte : #TEXTE ;   le PS : #PS mais aussi   l’identifiant unique de l’article : #ID_ARTICLE ;   l’identifiant de la rubrique : #ID_RUBRIQUE ;   .... La syntaxe des balises est la suivante : [texte_avant(#BALISE)texte_après]

Les { critères } de sélection Les {critères} de sélection permettent de limiter et d’ordonner l’affichage des données respectant certaines conditions, comme :   par ordre alphabétique : {par titre}  ;   par ordre numérique : {par num_titre} ;   de la même rubrique : {id_rubrique} ;   en fonction de l’age : {age<30} (affiche les articles qui ont moins de 30 jours) ;

Les filtres Les |filtres sont des fonctions écrites en .php qui utilisent comme paramètre principal, la #BALISE. Dans la boucle "articles du sommaire" on trouve :    [(#DATE|nom_jour)]    [(#DATE|affdate)] Ces deux |filtres agissent sur la balise #DATE, le premier affiche le nom du jour (lundi, mardi,..) le second la date sous la forme d’un texte (13 janvier 2005). Quelques |filtres : |

c) Squelettes et plugins

Squelettes et plug-in Pour ajouter fonctionnalités (plugins) et nouvelle apparence (squelette) 2 procédures d'installation différentes, facilité d'installation/désinstallation des plugins Ancienneté des squelettes, Plugins depuis Juin 2007 Toujours veiller à la compatibilité de ces compléments entre eux. www.spip-contrib.net : recense les contributions à spip : plugins, squelettes,

Les plug-in Les plug-in modifient le fonctionnement de spip (utilisables à partir de version 1.9) Attention à la compatibilité des plugins : entre eux, avec votre version de spip, éventuellement avec un squelette installé. Toujours tester avant. Installation : créer un dossier nommé plugins à la racine du site SPIP. Y placer l'ensemble des plug-in téléchargés. Allez dans l’espace privée du site : Configuration / Gestion des plugins et activez le plug-in installé.

plug-in Accès restreint www.spip-contrib.net/Le-plugin-Acces-Restreint Le plugin accès restreint permet de définir et de gérer des zones de l’espace public et privé en accès restreint. Les zones ainsi définies ne sont alors accessibles qu’aux visiteurs authentifiés et autorisés.

plug-in Accès restreint par groupes www.spip-contrib.net/Le-plugin-acces-restreint-par permet de restreindre l’accès à des rubriques et leurs contenus en gérant des groupes d’utilisateurs autorisés

plug-in crayon www.spip-contrib.net/Les-Crayons Ce plugin permet d’éditer les contenus sur les pages publiques du site, sans passer par l’espace privé de SPIP. Il respecte les autorisations données dans l’espace privé. Après l'installation, il faut procéder à une retouche du code de spip

Les squelettes Les squelettes modifient l'apparence et/ou les fonctionnalités du site spip Vérifier si le squelette est adapté à votre version de spip

Introduction aux squelettes Chaque squelette a sa procédure d'intallation. En général : on installe les fichiers du squelette au premier niveau de l'arborescence (dans un dossier squelettes), puis on paramètre depuis l'interface. Trouver des squelettes : www.spip-contrib.net/

Exemples de squelette Biospip Améliore le design de spip Installer Biospip : http://www.hardouin.info/Installation-de-BioSPIP-ou-des.html Améliorer design Biospip (exerc. feuille style) http://www.hardouin.info/Creer-son-propre-design-pour-son.html Et aussi http://www.hardouin.info/Modifier-ou-supprimer-les-annonces.html

Exemples de squelette : Spip-Clear Blog avec Spip : Spip-Clear Basé sur Dotclear. S’applique sur un secteur de votre site Spip. Possibilité de multiplier les blogs sur un site, de gérer des catégories et sous-catégories, de gérer plusieurs rédacteurs À récupérer sur : www.spip-contrib.net/Spip-Clear Exemple : http://www.spip-blog.net/

Exemples de squelette Epona installation facile menu de navigation dynamique Les articles qui auront été marqués avec le mot clé cacher n’apparaîtront pas à la une. Les sites qui auront été marqués avec le mot clé sommaire apparaîtront à la une. agenda visible sur le site Dernière version sur : http://spip-epona.org/

Exemples de squelette Sarkaspip Caractéristiques similaires à Epona (personnalisation simple, mot-clef edito pour avoir une page d'accueil) Possibilité de récupérer feuilles de style de sites faits avec le même squelette avec firefox (clic-droit sur la page puis propriété pour trouver l'adresse du CSS) http://sarka-spip.com/

Autres squelettes : Magusine (date de 2008) : nombreux réglages sont possibles sans avoir recours à la programmation. C'est aussi le cas de Beespip, plus ancien. (juin 2008 : le squelette Sarkaspip va aussi adapter ce principe)

Exemple de squelette : Beespip Un squelette sous la forme de plugin Importantes possibilités de personnaliser l'apparence de Spip, sans passer par la programmation Nombreux Réglages possibles avec l'interface privée http://www.beespip.org/

Activer Beespip Guide d'installation : http://www.beespip.org/spip.php?rubrique59 Beespip est un plugin qu’il faut "activer" Pour l'activer, en "interface complète" survoler le bouton "Configuration" pour visualiser le bouton "Gestion des plugins" Il faut cocher à minima les plugins  Squelette Beespip et  DW2 Puis clic sur configuration Beespip à droite du bouton "Gestion des plugins"

Beespip Dans : Configuration Beespip/ Mots clefs : clic sur création des 3 rubriques Une rubrique Accueil sous rubrique Com est automatiquement créée. Accédez à "DW2 - Suivi des téléchargements" disponible au survol du bouton "Statistiques". Laissez les réglages par défaut, spécifiez uniquement le "Mode d’enregistrement des nouveaux Documents" en choisissant "Auto". Les articles publiés dans Com s'afficheront comme des entités de la page accueil, elles s'afficheront dès la création d'autres rubriques de votre choix.

Beespip configuration beespip : nombreuses possibilités, exemple : possibilité d'activer un mode intranet "Permet de restreindre l'accès au site aux seuls rédacteurs référencés" Possibilité de modifier apparence du site selon des thèmes prédéfinis : configuration/beespip puis thèmes

Beespip Gérer l'apparence du site : des mots clefs assignés aux rubriques pour modifier l'apparence du menu de la page accueil : menu déplié pour faire apparaître toutes les rubriques, trier par date les articles, exclure pour exclure une rub. du menu, etc..

Beespip Des mots clefs assignés aux articles pour modifier l'apparence du menu de la page accueil : ouvert rubrique permet à un article de remplir la rubrique, ouvert rubrique résumé affiche les premières lignes des articles sur une page rubrique, exclure pour exclure un article du menu, etc..

Beespip Placez un logo : votre image doit s'appeler : images-interface/pixel_couleur1.gif et écraser le fichier image du même nom.

Autres possibilité de beespip Wiki Annuaire de site lié aux rubriques Annuaire de noms Mode intranet Conversion PDF des articles Index des mots-clefs Etc..