SPIP

SPIP 4.3

b_b, jack, Maïeul, Matthieu Marcillaud — 2024-07-26T10:40:37Z

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é plus condensé,
le formulaire de changement de statut des objets éditoriaux revu,
les filtres d'image plus rapides,
une écriture plus inclusive de certaines formulations,
l'envoi d'une notification par mail lorsqu'une mise à jour de SPIP est disponible, ainsi qu'une indication visuelle plus grande dans l'espace privé,

Le bandeau de l'espace privé prend moins de place en hauteur

Le formulaire de changement de statut est revu

Présentation initiale du formulaire de changement de statut

Formulaire de changement de statut déplié

Un message avertissant d'une nouvelle version disponible

Cette version apporte également d'autres améliorations ou corrections de bugs.

Ajouts

Afficher un encart pour signaler les nouvelles versions dans toutes les pages de l'espace privé pour les webmestres, et un bouton pointant vers spip_loader(voir Utiliser spip_loader) s'il est présent
Notifier par email les webmestres du site lorsque SPIP dispose d'une mise à jour (désactivable avec la constante _MAJ_NOTIF_EMAILS, voir la documentation)
Améliorer l'ergonomie du formulaire instituer (changement de statut d'un objet éditorial, voir plus haut)
Le formulaire d'identité du site permet de configurer la timezone utilisée
Nouveau filtre |balise_img_svg pour insérer une image ou un SVG inline sans savoir d'avance le format
Ajouter une option à find_all_in_path() pour renvoyer tous les fichiers répondant à un pattern
Filtre |propre qui applique propre() & safehtml() (cela permet de dés-échapper le code de confiance des modèles)
Débugueur : Afficher le nombre d'occurrences et temps total des inclusions de squelettes
La constante _DEBUG_MINIPRES définie à true active l'affichage d'un debug visible lorsqu'une erreur de type Minipage survient
Pipeline get_spip_doc pour manipuler le résultat natif de la fonction get_spip_doc()

Changements

Le bandeau de navigation de l'espace privé est réduit en hauteur (2 lignes au lieu de 3, voir plus haut)
Le menu de création rapide passe en menu déroulant avec des labels explicites (voir plus haut)
Écriture plus inclusive de certaines formulations
Optimisation des boucles avec pagination, en forçant une clause limit automatique dessus
Dans un plugin, si l'attribut logo d'un paquet.xml est absent, et qu'il existe un fichier {prefixe}.svg dans le plugin, il est utilisé comme logo
Les fonctions extraire_balise() et extraire_balises() peuvent gérer des balises imbriquées

Corrections

Améliorer la conformité HTML5
Icône Tâches de fond qui n'évoque pas les bases de données
Refactoring de ecrire_fichier()
Combinaison des critères {pagination} et {limit}
Ne pas conserver un double des fichiers calculés inchangés (#PRODUIRE_FOND)
Mise à jour de la bibliothèque mediaelement en version 7.0.3
Correction de inserer_attribut() sur un cas dérogatoire : les balises (même non autofermante)

Dépréciations

Déprécier les fonctions désuètes de ecrire/inc/presentation
La globale auteur_session (dépréciée depuis SPIP 2.0 !) sera supprimée en SPIP 5.0. Utiliser visiteur_session.
Déprécier la classe .label au profit de .editer-label dans les formulaires

Retrait

Retrait des options d'affichage des icônes dans les préférences

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

Un nouveau filtre, |image_oriente_selon_exif pour réorienter automatiquement une image selon son exif
Les filtres d'images tel que |image_recadre réorientent l'image selon l'exif d'orientation
Optimisation des filtres |image_aplatir, |image_renforcement, |image_flou, |image_sepia, |image_flip_vertical, |image_flip_horizontal, |image_nb, |image_gamma, |image_rotation
Correction du paramètre crop de |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.
Voir : Effectuer une mise à jour

Utiliser les plugins

cy_altern, erational, jack, Maïeul — 2023-12-04T18:46:13Z

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ù

z représente une correction mineure,
y représente un ajout de fonctionnalités,
x représente un changement majeur présentant des risques d'incompatibilité.

Lorsqu'une mise à jour est disponible (et que l'installation a été faite par SVP) une information s'affiche :

Une mise à jour corrective est disponible (up de z)
Une mise à jour fonctionnelle est disponible (up de y)
Une mise à jour majeure est disponible (X.0.0). Pensez à vérifier les incompatibilités. (up de x)

Désactiver, Désinstaller et/ou Supprimer

Les webmestres ont plusieurs options pour retirer un plugin installé :

Désactiver : le plugin passe dans les plugins inactifs,
Désinstaller : supprime les données et les paramètres de configuration du plugin, le plugin passe dans les plugins inactifs,

Lorsque le plugin est inactif il est maintenant possible de le :

Supprimer : supprime les fichiers du plugins, pas les données ;
Réactiver : si le plugin a été désactivé (et non désinstallé) on retrouvera toutes les données et les paramètres.

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

Internationaliser les squelettes

erational, jack — 2023-09-25T08:08:01Z

Sommaire

SPIP affiche naturellement les éléments d'interface (dates, intitulés des boutons) dans la langue choisie dans la configuration.

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çais

On supporte aussi les variantes régionales :
Par exemple pt_br pour le portugais brésilien

Par exemple, on fait afficher une section musique dans notre site

Musique

Pour internationaliser, on passera le texte dans une chaine de langue

<:musique:>

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 et lang/local_ja.php

La structure d'un fichier de langue

Un fichier de langue est rangé dans un répertoire lang

Les fichiers de langue contiennent les différentes traductions des codes que vous utiliserez ; ce sont des fichiers PHP retournant 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) :

 'Télécharger la dernière version', 'quoideneuf' => 'Modifications récentes' ];

Version catalane (lang/monperso_ca.php) :

 'Descarregar la darrera versió', 'quoideneuf' => 'Modificacions recents' ];

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" '
- Les chaînes de langues doivent être statiques. Il n'est pas possible d'effectuer des calculs en PHP pour les générer.

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 :

 'code' => 'La chaîne à afficher',

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- et notamment la syntaxe complète : https://programmer.spip.net/Syntaxe-complete-des-balises-de-langue

Historique

Fichiers de langue

À noter que pour les versions antérieures à SPIP 4.1, le fichier se présente de la manière suivante :

 'valeur', 'cle2' => 'valeur2', // ... ];

Cette syntaxe par peuplement de globale est dépréciée à partir de SPIP 4.4 et sera supprimé en SPIP 5.0.

Anciennes solutions historiques

- "un squelette par langue" (nécessitait le plugin "squelettes_par_rubrique") : c'est lourd à maintenir et simplement inutile pour un usage basique.
- "les blocs multilingues" : ces blocs sont très utiles dans la partie rédactionnelle ; présenter un titre en différentes langues possibles, permettre d'afficher des légendes différentes par langue... mais à éviter dans la partie structure.

Installation de SPIP

jack, jeanmarie — 2023-08-15T18:52:49Z

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.

Préalables

Avant d'installer SPIP, il faut s'assurer que votre hébergement remplit les conditions requises (voir Configuration requise).

Méthode grand public

Préparation

Il vous faut :

les identifiants pour accéder à l'hébergement (sFTP) et à la base de données (mySQL ou MariaDb) ;
un logiciel de transfert de fichiers sFTP [1].

Avec `spip_loader.php`, le plus simple

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 :

se rendre sur la page Utiliser spip_loader ;
télécharger le script sur votre ordinateur ;
le téléverser avec votre logiciel FTP à l'emplacement souhaité chez votre hébergeur ;
Attention : paramétrez votre logiciel pour faire ce transfert en mode binaire [ Type de transfert choisir Binaire." id="nh2">2].
il ne vous reste plus qu'à vous rendre à l'adresse www.domaine.tld/spip_loader.php et à suivre les différentes étapes de la procédure d'installation.

Le téléversement par sFTP, « à l'ancienne » est fortement déconseillé parce que source de trop nombreuses erreurs. [3]

Finaliser l'installation

Rendez-vous sur l'adresse www.domaine.tld/ecrire puis suivez les différentes étapes de la procédure d'installation :

Choisissez la langue d'installation.
Indiquez le type de base de données et les informations nécessaires.
Choisissez votre base ou créez-en une nouvelle.
Créez votre accès personnalisé au site en indiquant votre nom, adresse email, login et mot de passe.
Finalisez l'installation en accédant à l'espace privé

Autres méthodes, « 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

Le Paquet Debian installe SPIP en mode mutualisé sur un serveur Debian ou Ubuntu.
Il existe aussi une solution d'auto-hébergement Yunohost.

Arch Linux

Un paquet est disponible sur le dépôt.

Docker

Docker_(logiciel) automatise le déploiement d'applications dans des conteneurs logiciels.

Plusieurs personnes ont imaginé leurs propres recettes pour utiliser cet outil :

Sur le Hub Docker

YunoHost

YunoHost est un système qui s'installe sur un serveur
et vous permet d'installer et maintenir - sans trop de connaissances techniques -
des services numériques (apps) que vous contrôlez.

Parmi les nombreuses applications proposées, on retrouve SPIP :
https://apps.yunohost.org/app/spip

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.

[3] 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.
Par ailleurs si vous souhaitez utiliser l'installation automatique des plugins depuis l'interface privée de SPIP, il vous faut également créer manuellement les dossiers /plugins et /plugins/auto et éventuellement lib (pour certains plugins qui le requièrent).

{par rang_lien}

jack — 2021-03-10T09:40:17Z

Dans une boucle DOCUMENTS, le critère rang_lien permet d'ordonner les documents liés selon leur rang.

Sommaire

Voir aussi

Il est possible d'ordonner les documents liés à un objet par simple glisser/déposer.

Par défaut, aucun ordre n'est défini. Il devient défini dès qu'on a déplacé un document. Dès qu'un ordre est défini , un bouton “Réinitialiser l'ordre” est affiché en bas du tableau de documents et/ou illustrations liés.

Pour afficher les éléments d'une boucle DOCUMENTS dans l'ordre ainsi défini, il faut utiliser le critère {par rang_lien}, comme dans l'exemple ci-dessous :

 [(#LOGO_DOCUMENT|image_reduire{200})]

Techniquement, l'ordre est enregistré dans un champ rang_lien de la table spip_documents_liens.

Voir aussi

les critères par ...
Les critères communs à toutes les boucles

SPIP

SPIP 4.3

Sommaire

Compatibilité PHP 7.4 à 8.3

Changements apportés par SPIP 4.3

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

Ajouts

Changements

Corrections

Dépréciations

Retrait

Plugins-dist

Images

Plugins compatibles

Utiliser les plugins

Sommaire

Qu'est ce qu'un plugin ?

Organisation de plugins

Utiliser SVP le gestionnaire des plugins de SPIP

Gérer les dépôts

Chercher et trouver le plugin

Ajouter un plugin

Mettre à jour un plugin

Désactiver, Désinstaller et/ou Supprimer

Méthodes alternatives pour gérer les plugins

Ajouter un plugin manuellement via l'interface SVP

Gestion des plugins par FTP

Gestion des plugins par SPIP-Cli

Créer son plugin

Internationaliser les squelettes

Sommaire

Créer des squelettes multilingues

Utiliser des fichiers de langue

Musique

<:musique:>

La structure d'un fichier de langue

Créer ses propres codes

Les plugins et les fichiers de langue

Voir aussi

Historique

Fichiers de langue

Anciennes solutions historiques

Installation de SPIP

Sommaire

Préalables

Méthode grand public

Préparation

Avec spip_loader.php, le plus simple

Finaliser l'installation

Autres méthodes, « pour aller plus loin »

SPIP-Cli (installation via ligne de commandes)

Le script checkout

Méthodes alternatives

Distributions Linux

Docker

YunoHost

Softaculous

Composer

{par rang_lien}

Sommaire

Voir aussi

Avec `spip_loader.php`, le plus simple