SPIP

|attribut_url

erational, JLuc — 2024-05-30T10:20:06Z

Sommaire

Voir aussi

Le filtre |attribut_url doit être appliqué à une balise lorsque celle-ci est utilisée comme attribut href ou src 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

|attribut_html

Personnaliser les URLs

erational — 2024-04-26T21:18:40Z

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 :

Sur certains formats, on utilise l'identifiant de l'objet. Par exemple, le format "URLs Objets" générera une URL du type article6858.html
Sur certains formats, on utilise d'autres champs comme le titre de l'objet ou sa rubrique. Par exemple, un article dont le titre est "J'aime le potjevleesch" générera l'"URL libre" suivante 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 :

Les URLs générées sont automatiquement corrigées pour respecter la norme HTML (pas d'espace blanc, d'accents, ....)
Si une URL est déjà réservée sur le site, SPIP génère une URL alternative (en général en ajoutant l'identifiant de l'objet)

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.

L'URL ajoutée devient l'URL principale de l'objet (on la repère par un petit cadenas)
Les anciennes URLs de l'objet sont conservées pour éviter les erreurs 404. Les personnes qui tentent de consulter les anciennes URLs seront automatiquement redirigées vers l'URL principale (celle avec le cadenas).

Si une URL n'est pas plus utile (et qu'on ne souhaite plus de redirection vers l'URL principale), il est possible de la supprimer (bouton croix rouge).

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 :

La page affiche la liste des URLs du site et les objets associés
Un moteur de recherche permet de trouver une URL précise

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.

Fusionner, associer et dissocier des mots-clés

b_b, erational — 2024-01-02T21:24:53Z

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 :

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.

Ajouter des images à un article en SPIP

erational — 2022-09-23T07:34:13Z

A partir de SPIP 4 permet d'ajouter des images aux articles d'une façon simple et standardisée à travers un modèle unique

Ajouter une image à un article

Dans la partie privée de SPIP, aller sur votre article.
Ajouter votre image en utilisant le formulaire d'ajout d'image

Vous sélectionnez l'image à télécharger depuis votre disque dur. Après le chargement, l'image apparaît alors à coté de l'article avec son numéro unique.

Vous pouvez ensuite effectuer les actions suivantes :

Insérer l'image	Il suffit de copier le code dans le texte de votre article (voir paragraphe suivant)
Éditer l'image	Les flèches vous permettent de pivoter l'image si elle n'est pas bien orientée
Supprimer l'image	Le fichier de l'image est supprimé du site
Détacher l'image	L'image est supprimée de l'article mais elle reste disponible dans la médiathèque du site. On pourra donc l'utiliser ailleurs.
Modifier l'image	Ouvre une fenêtre qui permet de renseigner les informations sur l'image (titre, descriptif, crédits) ou de mettre à jour le fichier de l'image

Utiliser le code de l'image pour illustrer l'article

Pour placer l'image dans votre article il suffit d'ajouter le code obtenu dans le texte de l'article.

Lorem ipsum dolor sit amet consectetuer consequat et Donec lacinia id. Lorem pretium Curabitur lacus Pellentesque leo id volutpat Donec ....

Ce qui donne le résultat suivant :

Pour afficher les images inclues dans le texte d'un objet, les squelettes spécifient souvent une taille d'affichage maximum au moyen du filtre |image_reduire. Indépendamment de cette taille, la vignette des images dont les dimensions originales sont plus grandes que la valeur de la constante _IMAGE_TAILLE_MINI_AUTOLIEN comportent un lien permettant de les afficher en grand dans la Mediabox.

Quoiqu'il en soit, il faut garder à l'esprit que l'affichage final sur le site publique peut énormément varier selon l'habillage graphique du site et aussi selon le périphérique ("device") avec lequel vous consultez le site.

Page consultée depuis un smartphone	Page consultée depuis un ordinateur de bureau

Aligner l'image avec les codes , et

Vous pouvez aussi préciser l'alignement de l'image avec les codes suivants

Position par défaut L'image se place dans le fil du texte
Position à gauche L'image se place à gauche et le fil du texte continue sur sa droite jusqu'à dépasser l'image en hauteur
Position centrée L'image se place au centre et le texte passe à la ligne
Position à droite L'image se place à droite et le fil du texte continue sur sa gauche jusqu'à dépasser l'image en hauteur

Redimensionner

Il est possible de diminuer la taille des images en indiquant soit une largeur, soit une hauteur.

le code permettra d'afficher une image limitée 200px de large.
le code permettra d'afficher une image limitée 150px de haut.

Ajouter un lien

Il est possible d'ajouter un lien sur une image en ajoutant :

L'image deviendra cliquable et renverra vers le lien indiqué.

Renseigner la légende

Il est possible d'aller d'ajouter une légende à l'image.

Pour cela, il faut cliquer sur le bouton "Modifier"

Vous pouvez alors renseigner le titre, le descriptif de l'image, ses crédits, le texte alternatif de l'image...

Ce qui peut donner l'affichage suivant

Masquer la légende ou un de ses éléments

À partir de la version 4.2.8 de SPIP, il est possible d'afficher une image sans sa légende, son titre, son descriptif ou ses crédits. Pour cela, utilisez les codes suivant en fonction de vos besoins :
- pour masquer toute la légende ;
- pour masquer seulement le titre de la légende ;
- pour masquer seulement le descriptif de la légende ;
- pour masquer seulement les crédits de la légende ;

Il est aussi possible de masquer plusieurs de ces éléments en les espaçant par des virgules :

Par exemple, masquera le descriptif et le crédit.

Les images "vues"

Les images dont on a utilisé le code dans l'article sont marquées dans l'espace privé avec une icône "œil".

Ce sont les images filtrées par le critère {vu}. On ne peut pas supprimer ou détacher ces images. Il faudra donc au préalable supprimer les codes correspondants dans le texte de l'article.

Dans le squelette par défaut, les images restantes sont listées dans un portfolio en bas de l'article.

Organiser les images d'un article

Dans la partie privée, toutes les images de l'article sont listées en bas de l'article.

Les boutons suivants permettent de changer les vues (plus ou moins compactes).

Il est aussi possible de modifier l'ordre des images via un glisser-déposer.

Dans le squelette par défaut, cette fonctionnalité permet de ranger les images qui sont listées dans le portfolio.

Autres options du formulaire d'ajout d'images

depuis mon ordinateur : permet d'uploader un fichier stocké depuis son disque dur.
depuis la médiathèque : permet de sélectionner un document déjà ajouté sur le site. Vous sélectionnez l'image depuis la médiathèque. Cela vous évite d'avoir à télécharger des images qui ont déjà été mise en ligne.
depuis le serveur : permet de charger des documents ayant été déposés par FTP dans le répertoire /tmp/upload du serveur.
depuis internet : permet d'ajouter une ressource distante, par exemple une photo présente dans une bibliothèque d'image ou un document présent sur un autre site internet.

Évolutions par rapport aux versions précédentes de SPIP

L'utilisation des images a été simplifiée en SPIP 4.

Pour les rédacteurs et rédactrices habitué⋅es aux versions SPIP 3 et précédentes, les principaux changements sont :

On ne distingue plus la notion d'images et de portfolio
Suppression des modèles et (qui restent néanmoins actifs pour assurer une rétro-compatibilité) au profit du modèle unique .

Explications détaillées : changements dans la gestion des images avec SPIP4.0

|commuter_class

erational — 2021-07-15T12:38:48Z

Sommaire

Voir aussi

Le filtre |commuter_class compare les classes fournies aux classes présentes dans une balise HTML. Le filtre retire les classes déjà présentes et il ajoute les classes qui n'existaient pas.

Exemple

#LOGO_RUBRIQUE

Produit le HTML suivant :

Appliquons le filtre |commuter_class avec l'argument 'nav spip_logo menu' :

[(#LOGO_RUBRIQUE|commuter_class{nav spip_logo menu})]

Les classes 'nav' et 'menu', absentes, sont ajoutées, et la classe 'spip_logo', déjà présente, est supprimée.
On obtient :

Voir aussi

|supprimer_class

erational — 2021-07-09T06:09:24Z

Sommaire

Voir aussi

Disponible depuis SPIP 4.0, le filtre |supprimer_class supprime une classe ou plusieurs classes à une balise HTML.

Exemple

#LOGO_RUBRIQUE

Produit le HTML suivant :

Si on applique le filtre |supprimer_class

[(#LOGO_RUBRIQUE|supprimer_class{spip_logo})]

On obtient :

Voir aussi

|ajouter_class

erational — 2021-07-09T06:09:09Z

Sommaire

Voir aussi

Le filtre |ajouter_class ajoute une classe ou plusieurs classes à une balise HTML.

Exemple

[(#CHEMIN{img/logo.svg)|balise_img|ajouter_class{nav logo-site})]

Cherche le fichier img/logo.svg et génère la balise d'image avec les classes nav et logo-site.

Ce qui produit le HTML suivant :

Voir aussi

SPIP 4.0

erational, Matthieu Marcillaud, tcharlss — 2021-07-09T05:58:08Z

Sommaire

Interface

Espace privé relooké

Un gros travail d'ergonomie a été initié pour rendre à terme l'espace privé adaptatif sur toutes les tailles d'écrans afin d'en faciliter l'usage.

L'espace privé s'adapte mieux à la largeur de l'écran, et commence à utiliser différentes variables CSS pour faciliter sa maintenance.

Aperçu de l'espace privé de SPIP 4.0

L'espace privé de SPIP 4.0 dans le site SPIP Contrib.

Vue d'un article (avec la couleur grise)

Édition d'un article (avec la couleur grise)

Un écran de connexion (login) élégant

La page de connexion par défaut (login.html) est toute re-stylée, teintée du rose SPIP en fond.

Écran de connexion par défaut à SPIP 4.0

L'écran de connexion sur le site SPIP.net.

Et si le rose vous surprend, pas de panique ! Un nouveau formulaire dans la configuration de l'identité du site existe. Il permet de choisir la couleur qu'on veut. Et mieux : il permet même de déposer une magnifique image de fond.

Écran de connexion avec une image, dans SPIP 4.0

Iconographie en SVG

Une grande partie des icones et illustrations dans l'espace privé de SPIP et ses plugins sont passés en SVG.

Tickets #4468 et #4562 : Harmonisation dans l'espace privé du HTML & CSS des boutons
Nouveau jeu d'icône basé sur le thème Numix (en SVG) pour les types de document de la médiathèque

Documents & Logos

Un gros travail a été fait sur les documents et logos :

Les logos des articles et autres objets éditoriaux sont stockés comme les documents (dans spip_documents en base de données, et dans IMG/logo/ sur le disque en conservant le nom du fichier). Une phase de migration déplace les logos à leur nouvel emplacement sur le disque.
Les logos, documents images et filtres d'images acceptent et gèrent le format SVG
Le filtre balise_img permet de gérer des fichiers SVG et de déclarer leur taille
Le nouveau filtre balise_svg permet d'intégrer le code source d'un fichier d'image SVG dans le code html directement. Peut être pratique par exemple pour les petites icônes.
Les documents / logos peuvent être téléversés par drag'n'drop, quelles que soient leurs tailles (intégration du plugin BigUp en plugins-dist, amélioré pour l'occasion). La taille maximum autorisée est configurable.
Les modèles de documents (, , ...) sont revus et simplifiés et utilisent la balise
. Commit fa13018a. Attention : Les modèles doc.html, img.html et emb.html ne sont plus utilisés (et donc toute ancienne surcharge de ces fichiers dans des plugins ou squelettes ne sera plus utilisée). À la place, on utilise les modèles image.html, audio.html, video.html et file.html, correspondant au type de document. Le mode de document n'est plus pris en compte pour le calcul du modèle. NB : afin de ne pas casser vos anciens sites, un plugin de rétro-compatibilité permet de retrouver les anciens modèles.
Possibilité de décliner les fichiers HTML des modèles de document par type de fichier (mime type) détaillé : file_text_csv.html ou principal : file_text.html ; ou par extension : video_mp4.html. En conséquence vos variantes personnalisées doc_[variante].html correspondant au raccourci ne fonctionneront plus et sont à décliner : image_[variante].html, video_[variante].html, etc.
L'écriture des raccourcis SPIP des modèles de documents , ou devient équivalente. L'écriture recommandée est (où XX est le numéro du document).
La notion de Portfolio et de mode document / image sur les documents disparaît. Commit 9cf774b9. La constante _COMPORTEMENT_HISTORIQUE_PORTFOLIO déclarée à true permet de rétablir l'ancien fonctionnement.

Compatibilité PHP

Limitation de la compatibilité de SPIP 4.0 avec PHP de 7.3 à 8.0. De nombreuses notices, dépréciations ont été aussi corrigées. À noter que SPIP 3.2 sera donc la dernière version de SPIP à être compatible avec PHP 5.

Base de données

SPIP 4.0 fonctionne avec Mysql ou Sqlite. Il peut mettre à jour une base issue d'un SPIP >= 2.0.0.

Pour une mise à jour d'un SPIP antérieur, une étape de migration en SPIP 3.2 sera nécessaire.

Syntaxe des squelettes étendue

Ajout du support des boucles anonymes :

Marre du fichage ? une boucle anonyme n'a pas besoin de préciser son nom !
Un identifiant lui sera automatiquement attribué en interne.

[(#REM) Une boucle nommée ]    #TITRE

[(#REM) Une boucle anonyme ]    #TITRE

Et si vous êtes ambitieux, vous pouvez en mettre autant que vous le souhaitez dans un squelette, et même les imbriquer ! Mais bon, pensez à vos successeurs pour ne pas rendre le code trop anonyme à ne plus pouvoir s'y retrouver :)

    #TITRE
    #TITRE

Ajout des parties non conditionnelles de boucles, avant et après

Une syntaxe pour des parties non conditionnelles aux boucles est ajoutée : ce contenu sera toujours affiché, qu'il y ait un résultat ou pas, tout en permettant d'utiliser les balises propre à la boucle (#TOTAL_BOUCLE, #TRI, etc).

Cette syntaxe sert particulièrement pour les tableaux d'éléments avec des tris et filtrages. Si la boucle ne retourne pas d'éléments, on souhaite toujours afficher les filtres (pour les décocher / les modifier).

[(#REM) Une partie non conditionnelle avant / après la boucle ]  [(#REM) cette partie est affichée même si la boucle ne retourne pas d'articles ] Les articles
 Nombre : #TOTAL_BOUCLE
  #TITRE  [(#REM) cette partie est affichée même si la boucle ne retourne pas d'articles ] #PAGINATION

Cela complète les parties conditionnelles des boucles avant et après qui elles s'affichent uniquement si la boucle a au moins un résultat.

[(#REM) Une partie conditionnelle avant / après la boucle ]  [(#REM) cette partie n'est affichée que si la boucle retourne des articles ] Les articles
 Nombre : #TOTAL_BOUCLE
  #TITRE  [(#REM) cette partie n'est affichée que si la boucle retourne des articles ] #PAGINATION
  Aucun article

La partie non conditionnelle des boucles peut se coupler avec la partie conditionnelle : dans se cas elle encadre la partie conditionnelle.

[(#REM) Mix non conditionnel / conditionnel avant / après ]   Les articles
    #TITRE
  
 #PAGINATION

Ajout du support des boucles dans la partie conditionnelle des balises

Oui ! On peut maintenant mettre des boucles dans des balises !
Si si ! Dans les parties conditionnelles des balises.

Quelques exemples :

[(#BALISE) #TITRE ] [#TITRE (#BALISE)] [(#ENV{documents}|oui)      [(#TITRE|sinon{Document n°#ID_DOCUMENT})] \(#EXTENSION\)  
    ]

Changements et apports pour les squelettes

Les balises #PAGINATION nécessitent un changement de syntaxe et d'arguments.

Le changement porte 1) sur la balise englobante, qui doit être nav 2) sur les arguments.

1) La balise englobante doit désormais être

Jusqu'à SPIP 3.2, on écrivait par exemple :

[(#PAGINATION)
]

Avec SPIP 4.0, il faut maintenant utiliser :

[(#PAGINATION)
]

2) Il n'existe plus qu'un seul modèle de pagination. De ce fait, les différences de rendu de la pagination se font en lui passant des arguments.

afficher_lien_precedent=oui pour afficher le < vers les résultats précédents
afficher_lien_suivant=oui pour afficher le > qui mène aux résultats suivants
afficher_lien_tous=oui pour afficher un lien permettant de voir tous les résultats simultanément. Dans ce cas, le texte du lien est "∞" par défaut, mais il est possible de spécifier un autre label avec l'argument label_tous. Exemple : label_tous=tous.
nombre_liens_max permet de définir le nombre de lien de pagination maximum affiché par le modèle. On peut également employer la constante _PAGINATION_NOMBRE_LIENS_MAX pour l'espace public ou _PAGINATION_NOMBRE_LIENS_MAX_ECRIRE pour l'espace privé.

Le premier argument peut indiquer quel est le type de pagination désiré. On peut également l'indiquer avec un argument type_pagination.
Exemple : #PAGINATION{naturel} est équivalent à #PAGINATION{type_pagination=naturel}.

type_pagination=page pour afficher les n° de page : 1, 2, 3, 4...
type_pagination=rang pour afficher les rangs : 0, 10, 20, 30...
type_pagination=naturel pour afficher les rangs avec 1 à la place du 0 : 1, 10, 20, 30...
type_pagination=resultats pour afficher les rangs de 10 en 10 à partir de 1 : 1, 11, 21, 31...
type_pagination=page_precedent_suivant est la combinaison d'une pagination de type page avec les liens précédents et suivants.

L'utilisation de la balise dans l'espace privé est détectée automatiquement, ce qui rend inutile le passage de l'argument type_pagination=prive. La compatibilité avec l'ancienne syntaxe étant toutefois assurée sur ce point, on pourra conserver, sur des anciens squelettes, l'argument de l'ancienne version ainsi :

[(#PAGINATION{prive})
]

Critère {id_?}

Le critère {id_?} permet de faire toutes les liaisons possibles avec les variables d'environnement. Il se comporte donc comme autant de critères {id_xxx ?} que possibles pour la boucle donnée.

Voir id_ ?

Fonction lister_champs_id_conditionnel et pipeline exclure_id_conditionnel

Le critère {id_?} s'appuie directement sur la fonction lister_champs_id_conditionnel($table) qui retourne une liste des champs de sélection conditionnelle possibles pour cette table.

Le calcul est fait à partir des champs commençant par 'id_' dans la table, ainsi qu'avec un éventuel champ 'objet'. On complète ensuite avec les clés primaires des tables éditoriales qui peuvent être liées facilement.

Enfin, le résultat traverse le pipeline exclure_id_conditionnel qui permet d'exclure certains champs de la liste calculée par la fonction lister_champs_id_conditionnel. Voir l'exemple dans le plugin Brèves ou le plugin SVP.

Critère {par_ordre_liste champ,#LISTE{...}}

Nouveau critère par_ordre_liste pour ordonner une boucle selon un ordre précis.

Critère {fusion_supprimer}

Ce critère entre dans le Core. Il était jadis défini dans le plugin SPIP-Bonux. Important : Il faut mettre à jour le plugin SPIP-Bonux, s'il est actif, en version >= 3.7.1 avant de mettre à jour le site vers SPIP 4.0 pour éviter un conflit.

Filtre et fonction identifiant_slug

Ticket #4628 : ajout de la fonction identifier_slug(). Permet de transformer un texte clair en nom court pouvant servir d'identifiant, class, id, url… en ne conservant que des caractères alphanumériques et un separateur.

Filtres label_nettoyer et label_ponctuer

Ces filtres sont ajoutés pour gérer et utiliser un peu mieux les chaînes de langues historiques de SPIP (parfois avec des :, parfois sans).

label_nettoyer enlève les : en fin de texte
label_ponctuer ajoute  : en fin de texte

Évolution des critères {tri} et {par num xxx}

Le critère {tri xxx} accepte un #TRI{par numéro, num xxx} se comportant comme {par num xxx} (les éléments sans numéros sont classés après les éléments ayant un numéro)
Le critère {par num xxx} intègre automatiquement le critère {par sinum xxx} avant lui : ainsi dans (ARTICLES){par num titre}, les articles sans numéros (ou avec le numéro 0) passent après les articles ayant un numéro

Autres points sur les squelettes

Nouveaux arguments de #FORMULAIRE_INSCRIPTION et #FORMULAIRE_LOGIN
Nouveaux filtres ajouter_class, supprimer_class et commuter_class
Filtre lien_ou_expose amélioré
Le filtre |singulier_ou_pluriel peut être étendu pour chaque langue en créant son propre filtre singulier_ou_pluriel_, qui sera appelé si la langue correspond
Nouveau filtre appliquer_si_filtre en complément de appliquer_filtre : le 1er renvoie le contenu initial si le filtre cherché n'existe pas, le 2nd ne renvoie plus rien.

Squelettes-dist (thème de l'espace public par défaut)

Le squelettes-dist par défaut utilise maintenant une syntaxe HTML5

Autres apports

Intégration de la librairie Javascript Sortable.js pour prendre en charge le glisser-déposer de façon plus fluide, notamment pour ordonner les documents, en remplacement du module de jQuery UI.
Une nouvelle boite modale légère, accessible, responsive et plus jolie basée sur Lity
Une feuille de style XSLT fournit des flux RSS stylés
Le graphique des statistiques refait à neuf (il utilise d3.js)
Le compagnon peut être ignoré pour chaque auteur qui connait déjà SPIP
L'option "se limiter au HTML4" pour l'espace public est supprimée. Les squelettes par défaut (la dist) passent en HTML 5 (plugin de rétro-compatibilité)
L'attribut summary pour les tableaux est enlevé
Intertitres de niveau h2 par défaut, et plus de niveau h3 comme c'était le cas avant (plugin de rétro-compatibilité)
La fonction autoriser_exception() accepte un argument * en guise d'id : cela l'autorise pour tout id. Quand on annule une exception avec *, cela annule toutes les exceptions pour cet objet, même celles qui auraient été posées individuellement avec des ids.
Le filtre heure_minutes accepte en argument optionnel abbr lorsqu'on ne souhaite pas indiquer l'unité des minutes. Ainsi [(#DATE|heures_minutes{abbr})] affichera, par exemple : 17h26
La constante _AUTO_SELECTION_RUBRIQUE, qui permet d'affecter automatiquement une rubrique à la création d'un article si sa valeur est true accepte maintenant en plus un entier : dans ce cas cela correspond à l'identifiant de rubrique à attribuer par défaut.
Si le 3è paramètre (class) de #BOUTON_ACTION{libellé, url, class ,message de confirmation} contient "ajax", cette classe est ajoutée au formulaire qui contient le bouton.

Corrections

Mise à jour de toutes les librairies JS utilisées
[login] Ticket #3957 : Ne plus afficher le cadenas sur la page login, trop ambigu avec le cadenas https du navigateur.
[admin] Le lien "Afficher les visiteurs" n'est pas présenté s'il n'y a pas d'utilisateurs avec ce statut sur le site.
[svp][plugins] S'il y a une erreur XML sur un paquet.xml, elle est directement explicitée sur la page de gestion des plugins.

Nettoyages

Plugins

Les fichiers plugin.xml des plugins SPIP 2.x ne sont plus interprétés. Seuls les paquet.xml le sont désormais. Un plugin qui n'aurait donc que plugin.xml (sans paquet.xml à côté) ne fonctionnera donc plus à partir de SPIP 4.0.

Divers

Ticket #4060 : Nettoyage code < PHP 5.4
Nettoyage code & CSS <= IE9
Nettoyage htaccess (plus de compat sur les URLs .php(3) de SPIP <= 1.8

Fichiers

Suppression de inc/mail déprécié depuis SPIP 2. Utiliser par exemple :

$envoyer_mail = charger_fonction('envoyer_mail', 'inc'); $envoyer_mail(...);

Suppression de action/preferer.php inutilisé depuis SPIP 3.2 (suppression de ecrire/oo/).
Supression de exec/valider_xml.php non fonctionnel, déplacé dans le plugin à corriger Valider XML
Suppression de exec/fond_monobloc.php. Créer les squelettes de l'espace privé dans prive/squelettes.

Balises / Filtres / Critères

Suppression des balises #DEBUT_SURLIGNE et #FIN_SURLIGNE dépréciées depuis SPIP 2. Utiliser les classes CSS surlignable et pas_surlignable.
Les filtres aligner, aligner_gauche, aligner_droite, centrer, justifier et style_align sont supprimés. Utiliser du code CSS pour obtenir le même résultat.
Suppression de #LOGIN_PRIVE. Utiliser #FORMULAIRE_LOGIN
Suppression de #LOGIN_PUBLIC. Utiliser #FORMULAIRE_LOGIN
Suppression de #DOSSIER_SQUELETTE. Utiliser #CHEMIN
Suppression de #NOOP. Utiliser #VAL
Suppression de {datasource ...}. Utiliser directement le critère {source ...}

Fonctions PHP

Suppression de echo_log() (inutile maintenant).
Suppression de spip_fetch_array(). Utiliser sql_fetch() à la place.
Suppression de generer_url_retour(). Utiliser parametre_url() à la place, avec le paramètre 'redirect'.
Suppression de charger_php_extension() (utiliser extension_loaded())
Suppression de revisions_articles(). Utiliser article_modifier()
Suppression de revision_article(). Utiliser article_modifier()
Suppression de articles_set(). Utiliser article_modifier()
Suppression de insert_article(). Utiliser article_inserer()
Suppression de instituer_article(). Utiliser article_instituer()
Suppression de insert_auteur(). Utiliser auteur_inserer()
Suppression de auteurs_set(). Utiliser auteur_modifier()
Suppression de instituer_auteur(). Utiliser auteur_instituer()
Suppression de revision_auteur(). Utiliser auteur_modifier()
Suppression de insert_rubrique(). Utiliser rubrique_inserer()
Suppression de revisions_rubriques(). Utiliser rubrique_modifier()
Suppression de instituer_rubrique(). Utiliser rubrique_instituer()
Suppression de admin_repair_plat(). Les fichiers .plat ne sont plus utilisés. Cette fonction n'est plus appelée depuis r14292
Suppression de version_svn_courante(). Utiliser version_vcs_courante()
Suppression de lire_meta(). Utiliser $GLOBALS['meta'][$nom] ou lire_config('nom')
Suppression de auteur_referent(). Utiliser auteur_associer()
Suppression de table_jointure(). Utiliser Utiliser l'API editer_liens ou les tables de liaisons spip_xx_liens ou spip_yy_liens, selon.
Suppression de modifier_contenu(). Utiliser les fonctions génériques pour l'API de modification de contenu.
Suppression de revision_objet(). Utiliser objet_modifier().
Suppression de notifier_publication_article().
Suppression de notifier_proposition_article().
Suppression de calcul_branche(). Utiliser calcul_branche_in().
Suppression de ecrire_metas().
Suppression de spip_query_db(). Utiliser sql_query() ou autre.
Suppression de spip_get_lock() et spip_release_lock() qui n'étaient plus utilisées.
Suppression de recuperer_entetes(). Utiliser recuperer_entetes_complets().
Suppression de maj_version() et upgrade_vers() qui ne servent plus.
Suppression de upgrade_types_documents(). Utiliser directement creer_base_types_doc() du plugin Medias

Dépréciations

La et son critère {tableau ...} sont dépréciés au profit de la et son critère {source table, ...}.
De même, le fitre |foreach est déprécié au profit de la syntaxe à base de boucle (DATA).

`Plugins`


- Les plugins breves, jquery_ui, organiseur, petitions, vertebres, squelettes_par_rubriques ne sont plus distribués avec SPIP par défaut. Ces plugins, breves, organiseur, petitions et squelettes_par_rubriques sont toujours maintenus mais il faut les installer à la main (via SVP par exemple) afin de bénéficier de leurs fonctionnalités. Par exemple, installer le plugin Squelettes par rubrique pour utiliser des squelettes suffixés par numéro de rubrique et/ou par code de langue : (-23.html, =23.html, et .en.html). Pour installer ces plugins via SVP, il faut jouter le dépôt SPiP-Zone - Core (ref https://plugins.spip.net/spip.php?page=depots) dans la page de gestion des dépôts de l'interface privée.
- jquery_ui est maintenu par la communauté, mais déprécié
- vertebres bien que fonctionnel en SPIP 4.0 est abandonné : le plugin Adminer est une alternative plus complète.
Pour faciliter la suppression de leurs tables dans la base de données lors de la migration 3.2 -> 4.0, le plugin dédié Léon est mis à votre disposition : https://contrib.spip.net/leon-le-nettoyeur
Breves
Fonctions PHP
 Suppression de insert_breve(). Utiliser breve_inserer()
 Suppression de revisions_breves(). Utiliser breve_modifier()
Grenier
Le grenier est nettoyé et ne contient plus que les fonctions enlevées de SPIP 3.2 et SPIP 4.0. 

Ce qui est antérieur à SPIP 3.2 n'est plus présent dedans.
Il reçoit les différentes fonctions et fichiers supprimés de SPIP 4.0 qui pouvaient potentiellement être utilisés par des squelettes ou plugins.
Medias
Fonctions PHP
 Suppression de document_set(). Utiliser document_modifier()
 Suppression de insert_document(). Utiliser document_inserer()
 Suppression de revision_document(). Utiliser document_modifier()
 Suppression de afficher_documents_colonne(). Utiliser l'inclusion prévue ou une véritable déclaration d'objet éditorial (la colonne document est alors affichée automatiquement sur la page d'édition de l'objet)
 Suppression de lien_objet(). Utiliser generer_lien_entite()
 Suppression de instituer_document(). Utiliser document_instituer()
Mots
Fonctions PHP
 Suppression de groupemots_inserer(). Utiliser groupe_mots_inserer() ou objet_inserer()
 Suppression de groupemots_modifier(). Utiliser groupe_mots_modifier() ou objet_modifier()
 Suppression de revision_groupe_mot(). Utiliser groupe_mots_modifier()
 Suppression de insert_mot(). Utiliser Utiliser mot_inserer()
 Suppression de mots_set(). Utiliser mot_modifier()
 Suppression de revision_mot(). Utiliser mot_modifier()
Pétitions
L'utilisation des pétitions est maintenant optionnelle : elles sont désactivées par défaut sur les nouvelles installations [1]. Vous pouvez les activer dans la configuration des contenus du site.
Sites
Fonctions PHP
 Suppression de insert_syndic(). Utiliser site_inserer()
 Suppression de revisions_sites(). Utiliser site_modifier()
 Suppression de syndic_set(). Utiliser site_modifier()
 Suppression de instituer_syndic(). Utiliser objet_instituer()


		
		
[1] Sur les installation existantes, ce n'est le cas que si elles nétaient pas utilisées auparavant