SPIP - français, ces 365 derniers jours
SPIP est un système de publication pour l’Internet qui s’attache particulièrement au fonctionnement collectif, au multilinguisme et à la facilité (…)
Lac de Créteil - 94000 - Val de Marne - France
Pour nous contacter, cliquez sur l’enveloppe.http://laccreteil.fr/spip.php?page=…
mardi 2 janvier 2024
Lorsqu'on utilise des mots-clés leur liste a tendance à grossir au fil du temps et il peut être intéressant de faire le ménage.
À partir de SPIP 4.0, il est possible pour les administrateur-trices de fusionner, associer et dissocier des mots-clés. Cela permet de réduire leur nombre en conservant les liens existants.
Avertissement : certaines de ces actions ne sont pas réversibles, il convient donc de les utiliser avec prudence.
- Dans la partie privée, aller sur la page du mot-clé à fusionner
- En bas de page, cliquer sur le lien "Admin. avancée"
- Un formulaire qui permet d'associer, fusionner, dissocier les mots-clés s'affiche
- Comme certaines de ces opération sont irréversibles, une demande de confirmation est affichée avant de lancer l'action :
lundi 4 décembre 2023
Sommaire
Qu'est ce qu'un plugin ?
SPIP est fourni avec un nombre de fonctionnalités standard (le noyau ou "core").
Il arrive souvent qu'on ait besoin d'autres fonctionnalités comme par exemple un agenda, une newsletter .... Pour répondre à ces besoins particuliers, SPIP dispose d'un système de plugins (parfois appelé "extensions") à travers une API normalisée qui permet de se brancher ("plug" en anglais) au système pour y ajouter ou compléter des fonctions.
Organisation de plugins
Il existe deux types de plugins :
- Les plugins fournis par défaut dans SPIP
Ils sont placés dans le répertoire réservé
./plugins-dist/
. Ces "plugins-dist" sont verrouillés et il n'est pas possible de les désinstaller. Ils sont mis à jour lors de chaque mise à jour de SPIP.- Les plugins spécifiques au site
Ils sont placés dans le répertoire
./plugins/
Si vous souhaitez pouvoir les installer et mettre à jour automatiquement, il faudra créer un sous-répertoire
./plugins/auto/
. (Ce sous-répertoire est automatiquement créé si vous installez SPIP via le spip-loader)Utiliser SVP le gestionnaire des plugins de SPIP
SPIP dispose d'un système automatisé pour gérer les plugins qui s'appelle SVP (acronyme de "SerVeur d'information et de téléchargement des Plugins").
Il permet de gérer et de mettre à jour au quotidien les plugins.
La gestion des plugins est réservée aux administrateurs-trices complet-es du site.
L'ajout, la mise à jour et suppression des plugins sont restreints aux webmestres.
Gérer les dépôts
SVP va chercher les plugins disponibles dans un "dépôt".
Lors de la première installation le webmestre doit installer le dépôt et valider avec son mot de passe.
Par défaut le dépôt "principal" "SPIP-Zone - Plugins" est proposé.
Il est possible d'ajouter d'autres dépôts.
Certains dépôts sont listés sur https://plugins.spip.net/spip.php?page=depots
Pour des raisons de sécurité, il est nécessaire de saisir son mot de passe pour installer un nouveau dépôt.
Chercher et trouver le plugin
Il est possible de rechercher le plugin via l'interface de SVP, "ajouter un plugin"
Il est peut être utile de rechercher le plugin adapté à votre besoin sur le site dédié aux plugins SPIP : https://plugins.spip.net/
Ajouter un plugin
Lorsque vous avez trouvé votre plugin, vous le sélectionnez et demandez son installation "télécharger et installer" ; SVP va alors proposer d'installer le plugin avec toutes les dépendances nécessaires à son fonctionnement.
Une fois installés certains plugins proposent un bouton "Configurer" qui permet d'ouvrir un formulaire de configuration.
Mettre à jour un plugin
Un plugin comporte un numéro de version sous la forme x.y.z où
Lorsqu'une mise à jour est disponible (et que l'installation a été faite par SVP) une information s'affiche :
Désactiver, Désinstaller et/ou Supprimer
Les webmestres ont plusieurs options pour retirer un plugin installé :
Lorsque le plugin est inactif il est maintenant possible de le :
NB :
- Par conséquent, pour retirer complètement un plugin et ses données, il faut d'abord le désinstaller, puis le supprimer.
- Attention, ne pas oublier que désinstaller entraîne une perte de données
Méthodes alternatives pour gérer les plugins
Ajouter un plugin manuellement via l'interface SVP
Il est possible d'installer un plugin manuellement via l'interface SVP, avec par exemple une version de zip récupérée sur git.spip.net.
Pour des raisons de sécurité il est nécessaire de saisir son mot de passe webmestre lors de toute installation de plugin de cette manière.
Gestion des plugins par FTP
On peut déposer les plugins avec transférant par FTP les fichiers des plugins dans le répertoire
./plugins/
. Une fois déposé, il faudra activer les plugins via SVP.Attention, cette méthode ne permet pas de mettre à jour automatiquement les plugins.
Gestion des plugins par SPIP-Cli
SPIP-Cli permet de gérer un site en ligne de commande. Il existe plusieurs commandes dédiées à la gestion des plugins. Pour en savoir plus se reporter à la documentation officielle de SPIP-Cli
https://contrib.spip.net/SPIP-Cli
Créer son plugin
Si vous ne trouvez le plugin correspondant à vos besoins, il est toujours possible de le créer !
Pour apprendre à coder, vos propres plugins :
https://programmer.spip.net/-Developper-des-plugins-
A noter : le plugin La fabrique permet de créer d'une façon simple et rapide un plugin à partir de zéro
https://contrib.spip.net/La-Fabrique
mercredi 22 novembre 2023
Sommaire
Syntaxe
Le type d'objet est spécifié dans le nom de la balise, tel que
#ID_LOGO_ARTICLE
ou#ID_LOGO_SITE
.Pour les articles, ces balises ont quelques variantes :
#ID_LOGO_ARTICLE_NORMAL
ou#ID_LOGO_ARTICLE_SURVOL
.#ID_LOGO_ARTICLE_RUBRIQUE
Usage pour récupérer les informations du logo
Une fois l'identifiant du logo récupéré, une boucle DOCUMENTS peut être utilisée, entre autres, pour récupérer le titre et le descriptif du logo (attention, il faut le modificateur
{tout}
, sinon, la boucle ne retourne rien) :Exemple :
Attention, piège avec #INFO_TITRE
#INFO_TITRE{document, #ID_LOGO_ARTICLE}
renvoie le titre du document si renseigné, sinon le nom du fichier [1].À lire aussi
[1] C'est donc pour cela qu'une boucle sera plus précise
lundi 25 septembre 2023
Sommaire
SPIP affiche naturellement les éléments d'interface (dates, intitulés des boutons) dans la langue choisie par l'utilisateur.
Créer des squelettes multilingues
Lorsqu'on crée un squelette multilingue, il est indispensable d'utiliser les chaînes de langue pour que le contenu de l'interface soit affiché dans la langue demandée.
SPIP fournit déjà les intitulés les plus courants (comme "Plan du site", "Répondre à cet article" etc...).
Cet article indique comment en ajouter des nouveaux selon vos besoins.
De plus, utiliser les chaînes de langue améliore la maintenance de votre squelette (quand on modifie une chaîne de langue, toutes les pages sont modifiées)
Utiliser des fichiers de langue
Créer un fichier de langue
Quelque soit la structure décidée pour le site (secteurs de langue ou pas) il suffit d'insérer une "chaîne de langue" comme ceci
<:chaine_de_langue:>
SPIP ira chercher la traduction dans un des fichiers SPIP ou dans un fichier lang/local_xx.php (xx étant la langue) que l'on aura créé.Le suffixe langue
xx
est celui généralement usité dans les normes ISO.Par exemple
fr
pour françaisOn supporte aussi les variantes régionales :
Par exemple
pt_br
pour le portugais brésilienPar exemple, on fait afficher une section musique dans notre site
Pour internationaliser, on passera le texte dans une chaine de langue
Selon la langue retenue, la chaine
<:musique:>
sera affichée— en français, à la chaîne « Musique »,
— en anglais, à la chaîne « Music »,
— en japonais, à la chaîne « 音楽 »,
Il faut donc créer autant que fichiers de langue que les langues utilisées par votre site.
Dans le cas précédent il faut donc créer un
lang/local_fr.php
,lang/local_en.php
etlang/local_ja.php
La structure d'un fichier de langue
Un fichier de langue est rangé dans un répertoire
lang
Il est structuré de la façon suivante :
Les fichiers de langue contiennent les différentes traductions des codes que vous utiliserez ; ce sont des fichiers PHP contenant chacun un tableau associant aux codes les chaînes correspondantes dans chaque langue.
Attention :
Le nom de ces fichiers de langue ne devra pas contenir le caractère «
_
» (« underscore » ou « tiret-bas ») sauf pour marquer la séparation avec l'initiale de la langue (en, fr, it,...). Par exemple, on créera « monperso_fr.php » et non « mon_perso_fr.php ».Ces fichiers contiendront par exemple :
Version française (lang/monperso_fr.php) :
Version catalane (lang/monperso_ca.php) :
Syntaxe des fichiers de langue
- Chaque ligne de définition se termine par une virgule, sauf la dernière ligne.
- Les apostrophes à l'intérieur de la chaîne doivent être échappées, c'est-à-dire précédées d'un antislash. Par exemple, la chaîne « sur l'internet » doit être écrite :
sur l\'internet
.- Il est possible de ne pas échapper les apostrophes à condition d'utiliser des apostrophes du type "guillemet simple fermant"
'
Créer ses propres codes
Il est de plus possible de créer ses propres codes, correspondant à des chaînes que l'on désire ajouter soi-même.
Il s'agit alors de créer des fichiers de langue personnels, sur le modèle des fichiers public_xx.php. Pour créer ses propres fichiers, on installera, dans un répertoire squelettes/lang (à créer le cas échéant)
— local_fr.php pour définir les chaînes en français,
— local_en.php en anglais,
— ...
La partie qu'il faut enrichir soit-même consiste en plusieurs lignes de définitions, sur le modèle :
Les plugins et les fichiers de langue
Beaucoup de fonctionnalités sont assurées par des plugins, soit des plugins du core comme porte-plume ou svp, soit des plugins ajoutés par les webmestres parce qu'ils souhaitent utiliser une fonctionnalité spécifique. Tous ces plugins ont des fichiers de langue.
Voir aussi
Pour tout savoir sur les chaines de langue on pourra consulter https://programmer.spip.net/-Elements-linguistiques-
Historique :
mardi 15 août 2023
Vous trouverez ci-dessous différentes méthodes d'installation de SPIP, classées des plus faciles pour le plus grand public aux plus spécialisées.
Sommaire
spip_loader.php
, alias « la voie de la tranquillité »Préalables
Avant d'installer SPIP, il faut s'assurer que votre hébergement remplit les conditions requises (voir Configuration requise).
Méthodes grand public
Préparation
Il vous faut :
Méthode 1 : Avec
spip_loader.php
, alias « la voie de la tranquillité »Le script
spip_loader.php
télécharge et installe la version de SPIP souhaitée. C'est la méthode la plus simple pour installer SPIP :www.domaine.tld/spip_loader.php
et à suivre les différentes étapes de la procédure d'installation.Méthode 2 : Téléversement par sFTP, « alias à l'ancienne »
Après avoir téléchargé le zip via la page Télécharger SPIP et extrait son contenu sur votre ordinateur, transférez l'ensemble des fichiers sur votre serveur avec un logiciel FTP. Une fois les fichiers transférés, suivez les différentes étapes de la procédure d'installation.
/plugins
et/plugins/auto
et éventuellementlib
(pour certains plugins qui le requièrent).Dans tous les cas : finaliser l'installation
Rendez-vous sur l'adresse
www.domaine.tld/ecrire
puis suivez les différentes étapes de la procédure d'installation :Autres méthodes, alias « pour aller plus loin »
SPIP-Cli (installation via ligne de commandes)
Une fois SPIP-Cli installé sur votre serveur (lire la documentation de SPIP-CLI), vous pouvez utiliser la commande
spip
pour installer, installer, mettre à jour et administrer SPIP.Pour télécharger la dernière version stable de SPIP, lancer la commande suivante depuis le répertoire voulu pour votre site :
spip dl
Ensuite, se positionner dans le dossier contenant votre SPIP et préparer les dossier et fichiers (droits des dossiers, mise en place du .htaccess...) :
spip core:preparer
Ensuite, suivez la méthode classique d'installation (voir paragraphe Installer SPIP ci-dessus).
Pour mettre à jour, l'idéal est de commencer par mettre à jour SPIP-Cli, puis lancer la commande :
spip up
Plus d'infos sur SPIP-Cli :
Le script checkout
Le script checkoutpermet de télécharger ou mettre à jour des sources Git (ou Zip) et propose également une méthode pour télécharger les sources de SPIP.
Méthodes alternatives
Distributions Linux
Debian
Arch Linux
Un paquet est disponible sur le dépôt utilisateur.
Vagrant
Si vous connaissez Vagrant, Ce projet vous intéressera.
Docker
Docker_(logiciel) automatise le déploiement d'applications dans des conteneurs logiciels.
Plusieurs personnes ont imaginé leurs propres recettes pour utiliser cet outil :
Softaculous
Softaculous installe automatiquement des applications en ligne de commande ou à travers les panneaux de contrôle comme cPanel ou Plesk.
Dans sa version gratuite il offre 50 applications mais SPIP fait partie de sa version payante :
- https://www.softaculous.com/news/tag/spip
Composer
Composer est un outil de gestion de dépendances en PHP. Il vous permet de déclarer les bibliothèques dont votre projet dépend et il va les gérer (installer / mettre à jour) pour vous.
[1] Nous vous conseillons d'utiliser Filezilla.
[2] Dans Filezilla : menu Transfert > Type de transfert choisir Binaire.
mercredi 26 juillet 2023
Les fichiers de CHANGELOG suivent la norme Tenez un Changelog.
Sommaire
Qu'est-ce qu'un changelog ?
Un changelog (journal des modifications) est un fichier qui contient une liste triée antéchronologiquement des changements notables pour chaque version d'un projet.
Pourquoi tenir un changelog ?
Pour permettre aux utilisateurs et contributeurs de voir précisément quels changements notables ont été faits entre chaque publication (ou version) d'un projet.
Plus de détails sur https://keepachangelog.com.
Chaque entrée du changelog doit :
Pour chaque version, indiquer le numéro de version suivi de la date au format
ANNÉE-MOIS-JOUR
.Les entrées sont regroupés par catégorie. Voici les catégories utilisées dans SPIP.
Exemple de Changelog simple
Exemple de changelog complet
Pour un exemple plus complet, voir celui de SPIP.
Les messages des commits dans SPIP suivent la nomenclature des Commits Conventionnels. Ceci facilite la relecture a posteriori de l'historique du code, ainsi que l'analyse des PR.
Le corps du message doit être clair et explicatif : décrire le problème traité et les évolutions ou corrections apportées.
Sommaire
Structure d'un commit conventionnel
:
), suivi d'un message résumant le commit.Refs: #XXX
, ouFix: #XXX
pour fermer le ticket automatiquement lors de l'arrivé dans la branchemain
oumaster
.Exemple de commit conventionnel
Exemple de log de commit complet :
Liste des types de commit
Pour aller plus loin
Se référer au site www.conventionnalecommits.
mardi 18 juillet 2023
Ce filtre effectue un traitement pour que les textes affichés suivent les règles de typographie. Il fait une protection préalable des balises HTML et SPIP et transforme les balises
.Ce filtre est appliqué par défaut par SPIP sur les champs de texte.
Voir aussi Des filtres
Ce filtre est appliqué par défaut par SPIP aux textes longs (#TEXTE, #CHAPO, #PS, ...)
Il applique à un texte les traitements typographiques et les raccourcis SPIP (italiques, gras, intertitres, etc.).
Voir aussi Des filtres