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=…
vendredi 26 juillet 2024
Par défaut, SPIP 4.3 envoie un email à tou⋅tes les webmestres du site quand une mise à jour de SPIP est disponible.
La constante
_MAJ_NOTIF_EMAILS
permet de personnaliser la liste des adresses auxquelles seront envoyés ces emails. Elles peut être personnalisée dans votre fichierconfig/mes_options.php
(voir l'article qui lui est consacré).Par exemple, si on souhaite désactiver ces notifications (ce qui n'est pas une bonne idée) :
Sommaire
Compatibilité PHP 7.4 à 8.3
SPIP 4.3 nécessite PHP 7.4 minimum, et fonctionne jusqu'à PHP 8.3.
Il nécessite les extensions PHP : sodium, Zlib, Zip et Phar.
Changements apportés par SPIP 4.3
Les changements les plus importants concernent
Le bandeau de l'espace privé prend moins de place en hauteur
La création rapide des contenus passe dans un menu dépliant
Le formulaire de changement de statut est revu
Un message avertissant d'une nouvelle version disponible
Cette version apporte également d'autres améliorations ou corrections de bugs.
Ajouts
spip_loader
s'il est présent|balise_img_svg
pour insérer une image ou un SVG inline sans savoir d'avance le formatfind_all_in_path()
pour renvoyer tous les fichiers répondant à un pattern|propre
qui appliquepropre()
&safehtml()
(cela permet de dés-échapper le code de confiance des modèles)_DEBUG_MINIPRES
définie à true active l'affichage d'un debug visible lorsqu'une erreur de type Minipage survientget_spip_doc
pour manipuler le résultat natif de la fonctionget_spip_doc()
Changements
paquet.xml
est absent, et qu'il existe un fichier{prefixe}.svg
dans le plugin, il est utilisé comme logoextraire_balise()
etextraire_balises()
peuvent gérer des balises imbriquéesCorrections
ecrire_fichier()
{pagination}
et{limit}
#PRODUIRE_FOND
)mediaelement
en version 7.0.3inserer_attribut()
sur un cas dérogatoire : les balises![]()
(même non autofermante)Dépréciations
ecrire/inc/presentation
auteur_session
(dépréciée depuis SPIP 2.0 !) sera supprimée en SPIP 5.0. Utiliservisiteur_session
..label
au profit de.editer-label
dans les formulairesRetrait
Plugins-dist
Images
Les performances du plugin-dist Filtres Images ont été très nettement optimisées, certains filtres images sont désormais jusqu'à 10 fois plus rapides grâce à l'utilisation des fonctions natives de PHP GD
|image_oriente_selon_exif
pour réorienter automatiquement une image selon son exif|image_recadre
réorientent l'image selon l'exif d'orientation|image_aplatir
,|image_renforcement
,|image_flou
,|image_sepia
,|image_flip_vertical
,|image_flip_horizontal
,|image_nb
,|image_gamma
,|image_rotation
|image_rotation
Plugins compatibles
Dès sa sortie SPIP 4.3 bénéficie d'environ 700 plugins compatibles, ce qui facilitera les mises à jour.
jeudi 30 mai 2024
Sommaire
Le filtre
|attribut_url
doit être appliqué à une balise lorsque celle-ci est utilisée comme attributhref
ousrc
d'une balise HTML afin de sécuriser cet usage.Ce filtre est donc l'équivalent de
attribut_html
adapté aux urls, car celui-ci effectue des changements qui casseraient les urls.Exemples :
1) Sécuriser l'url d'un lien contenu dans une variable d'environnement :
2) Dans le modèle
squelettes-dist/modeles/favicon.html
, le filtre|attribut_url
sécurise la balise#ENV*{favicon}
qui vient de l'environnement et dont le contenu peut être dangereux.Chaînes de langue
Le filtre
attribut_url
doit également être utilisé sur les chaînes de langue renvoyant une url.Voir aussi
vendredi 26 avril 2024
Sommaire
SPIP permet une gestion fine et évolutive des URLs. Leur format est défini par les webmestres. Pour la mise en place technique, consulter l'article Utiliser des URLs personnalisées.
Créer une URL
Chaque objet SPIP est accessible par une URL donnée et celle-ci dépend du format choisi :
article6858.html
J-aime-le-potjevleesch
Les URLs sont automatiquement générées au moment de la publication en ligne de l'objet.
Quelques précisions :
Si l'option "édition des URLs est activée" sur le site :
L'URL publique de l'objet est affichée sous le titre :
Modifier une URL
Certains formats d'URLs permettent d'éditer les URLs, dans ce cas, un bouton "modifier" apparaît lorsqu'on survole l'URL
Le formulaire affiché permet de modifier l'URL.
Gérer les URLs
Sur les sites avec beaucoup de contenus, des centaines d'URLs sont générées. Cela peut être problématique si on souhaite utiliser une URL précise et que celle-ci est déjà utilisée.
Heureusement SPIP propose une page de gestion de toutes les URLs du site accessible par le menu Publication → Gestion des URLs :
Pour libérer une URL, il suffit de l'effacer sur l'ancien objet et de l'attribuer ensuite sur l'objet que l'on souhaite.
Sur la page Publication → Gestion des URLs, un bouton permet aussi de forcer la mise à jour de toutes les URLs du site.
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.