SPIP

_MODELES_PUBLICS_AUTORISES

jack, JLuc — 2026-09-03T09:16:15Z

Depuis SPIP 4.4.18 l'utilisation des modèles est interdite par défaut dans les forums.

Si toutefois vous avez besoin d'utiliser certains modèles, vous pouvez les indiquer dans la constante _MODELES_PUBLICS_AUTORISES dans config/mes_options.php.

define('_MODELES_PUBLICS_AUTORISES', ['notations', 'video']);

La valeur peut également être un tableau indexé ['contexte' => 'modele', ... ] : les index sont les contextes d'utilisation qu'on veut autoriser pour le modèle : nom d'objet, nom de formulaire CVT, préfixe de plugin, ...

Voir
Le pipeline modeles_publics_autorises

_ALLOWED_FORWARDED_HOST

JLuc — 2026-09-03T08:49:30Z

La constante _ALLOWED_FORWARDED_HOST définit quels hôtes http peuvent légitimement figurer dans la variable serveur HTTP_X_FORWARDED_HOST lorsqu'elle est différente de HTTP_HOST.

Ref :
- https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/X-Forwarded-Host
- https://search.spip.net/git.spip.net/spip/ecrire/-/blob/bootstrap/proxy.php

_FORUM_LONGUEUR_MINI

JLuc — 2026-09-03T08:49:14Z

Cette constante définit le nombre de caractères minimum que les forums postés doivent avoir pour être acceptés.
Par défaut, elle vaut 10.
Voir aussi : _FORUM_LONGUEUR_MAXI.

- Variables et Constantes de personnalisation

_FORUM_LONGUEUR_MAXI

JLuc — 2026-09-03T08:48:58Z

Cette constante définit combien de caractère les forums déposés doivent avoir au maximum pour être acceptés.
Par défaut, elle vaut 8000.
Vous pouvez la redéfinir dans votre fichier d'options.
Voir aussi : _FORUM_LONGUEUR_MINI.

- Variables et Constantes de personnalisation

_IS_BOT

JLuc — 2026-05-20T13:32:38Z

Cette constante indique si c'est un robot connu de SPIP qui consulte la page courante.

Exemple d'usage en PHP, dans le plugin pdf_version, pour refuser aux robots l'accès aux fichiers pdf :

function autoriser_voirpdfversion_dist($faire, $type, $id, $qui, $opt) { if (_IS_BOT) { return false; } return autoriser('voir', $type, $id, $qui, $opt); }

Migration d'un SPIP 1 ou 2 vers SPIP 3.2.19

Pierre KUHN — 2026-04-15T18:35:00Z

Cette documentation concerne le passage d'un SPIP 1 ou 2 vers SPIP 3.2.19

La méthode proposée permet de partir sur des bases saines en effectuant un grand ménage dans les fichiers de SPIP et de repartir à zéro sur de nouveaux plugins (SPIP permet d'installer des plugins très rapidement).

Sommaire

Sauvegarde avant la migration

Sauvegarde de la base de données
- Si vous en avez la possibilité, il est sage de faire une sauvegarde de la base MySQL via PHPMyAdmin, disponible sur beaucoup d'hébergements, en faisant le choix d'une sauvegarde compressée.
- SPIP propose aussi un système de sauvegarde

Récupérer par ftp le fichier généré : format xml pour les spip2, dans tmp/dump (ou ecrire/data pour un spip plus ancien)

Sauvegarde des dossiers personnels
- Récupérer par ftp les répertoires :

IMG
config (pour les spip très ancien munissez-vous de vos codes de base de données)
éventuellement squelettes si son contenu pourrait être réutilisé

Avec la sauvegarde de votre base de données et le dossier IMG (qui contient tous les documents et images joints à votre site), vos contenus sont sauvegardés. config contient les infos de connexion à la base de données et squelettes vos personnalisations de squelette. Notez éventuellement la version précise de SPIP utilisée (avant cette migration).

Vérification de l'encodage avant la migration

Si votre site est suffisamment récent (site en utf-8) ou si l'encodage de celui-ci est déjà en utf-8, vous pouvez passer à l'étape suivante.

Pour le savoir, voir dans les paramètres de langue.

Si l'encodage est en iso-8859-1, il est conseillé de passer votre site en utf-8. Une telle procédure est proposé dans SPIP 2 :

faire une sauvegarde de la base de données (en principe vous en avez déjà une)
dans la page de gestion des langues, cliquer sur le lien proposé vers « la page de conversion vers l'utf-8 » ( url : ecrire/ ?exec=convert_utf8)
lancer ensuite la page : ecrire/ ?exec=sql_convert_utf8

Vérification des plugins

Penser à mettre à jour vos plugins pour limiter les incompatibilités.

Les plugins non compatibles seront désactivés lors de l'installation de la nouvelle version.

Préparation de la migration

Vérifiez la version PHP qui est exécutée sur votre serveur (via https://example.com/ecrire/?exec=info par exemple).
SPIP 2 fonctionne en PHP 4.x et SPIP 3 nécessite PHP en version 5.1 minimum.
Si nécessaire, voyez avec votre hébergeur comment utiliser une version récente de PHP 5.3 ou 5.4, par exemple.

Pour exécuter SPIP 3.2, il vous faut PHP 5.4 minimum donc passer d'abord votre hébergement en PHP 5.4

Télécharger SPIP 3.2.19 puis décompresser l'archive dans un dossier spip de votre ordinateur
Créer par ftp le répertoire à la racine de votre site, sur le serveur : /ancienSpip
Déplacer dedans tous les dossiers plugins plugins-dist prive ecrire squelettes squelettes-dist local tmp et fichiers spip.php index.php mais pas les dossiers config IMG
Transférer par ftp les répertoires et fichiers contenus dans le dossier local spip de votre ordinateur vers le dossier distant

Mise à niveau de la base

En fonction du type de mise à jour, une procédure de mise à niveau de la base de données vous sera proposé en accédant à l'espace privé. Suivez les indications.

Consulter votre site. Normalement, il devrait s'afficher (sous l'apparence des squelettes par défaut de SPIP)
Se connecter sur l'interface privé de SPIP avec un compte administrateur (en cas de difficulté, se rendre à l'url /ecrire du site).
Suivre la procédure de maintenance proposée.

Mise à jour de la base - Etape 1

Mise à jour de la base - Etape 2

Mise à jour de la base - Etape 3
Se rendre ensuite sur la page de gestion des plugins (dans configuration) afin de réactivé les plugins compatible et mettre à jour ceux qui ne le sont pas.
Vérifier que le site fonctionne.

En cas de problème

Si besoin (si on n'arrive plus à accéder à l'espace privé du site, si des erreurs récurrentes s'affichent), il peut aussi être utile de réinitialiser certains fichiers temporaires de SPIP.

Il s'agit de vider le répertoire tmp sauf éventuellement les sous-répertoires dump, sessions et visites.

Pour cette opération : aller dans le dossier tmp et effacer tout sauf les dossiers dump et visites. Il vous faudra ensuite vous reconnecter.

Si un problème persiste, venez poser vos question sur le forum : https://discuter.spip.net/c/spip/6

Installation des plugins et squelettes

Créer les dossier suivant à la racine de votre site :

/plugins (puis dans ce dossier, créer le dossier auto)
/lib
/squelettes

Adaptez les droits de ces dossiers pour que le serveur puisse y écrire.

Se rendre dans l'interface de gestion des plugins et, dans « dépôts », utiliser le dépôt proposé - (important pour la mise en œuvre de la nouvelle gestion des plugins).

Installez les plugins nécessaires (les rechercher dans le moteur de recherche) au fonctionnement de votre site. Vérifiez que le site public fonctionne (éventuellement, vider le cache ou le répertoire tmp comme expliqué ci-dessus). Repassez en revue les réglages des plugins (cliquez sur l'icône de configuration après les avoir activés).

Rétablissez enfin si besoin vos personnalisations de squelettes en remettant progressivement les fichiers html dans votre dossier squelettes qui se trouve dans /ancienSpip. Vérifiez que chacun produit bien le résultat souhaité.

Ménage

Quand tout est terminé :

vérifier que les autres applications installées sur l'hébergement fonctionnent.
vérifier le contenu du dossier /ancienSpip. Celui-ci ne devrait contenir que des dossiers et fichiers issus de votre ancien SPIP (ecrire, local, tmp, squelettes-dist ou dist, extensions et quelques fichiers)
supprimer finalement le dossier /ancienSpip.

À propos de cette documentation

Auteurs

Michel Suquet
Johan Pustoch

Adaptations

Collectif SPIP

_DIR_PLUGIN_XXX

JLuc — 2026-03-10T15:00:33Z

La constante _DIR_PLUGIN_TRUC indique le chemin du dossier où est installé le plugin truc.

On peut s'en servir en PHP pour inclure des fichiers de ce plugin :

include_once _DIR_PLUGIN_TRUC . 'inc/une_inclusion.php;'

Toutefois, pour que d'autres plugins puissent surcharger l'inclusion, on préférera ne pas utiliser cette constante mais la fonction include_spip, car celle-ci parcourt tous les chemins accessibles :

include_spip( 'inc/une_inclusion.php);

Voir : fonction include_spip

_IFRAME_SAFE_DOMAINS

JLuc — 2026-02-17T18:04:41Z

Par mesure de sécurité, les iframes sont masquées dans l'espace privé à partir de SPIP 4.4.8, sauf pour les domaines explicitement autorisés via une constante _IFRAME_SAFE_DOMAINS.
Cette constante doit contenir un tableau d'expression régulières décrivant tous les domaines autorisés, sans protocole, sans chemin et sans '/' à la fin.
Exemple : define ('_IFRAME_SAFE_DOMAINS', [ 'fr\.wikipedia.org', '.*\.spip\.net']) ;

- Variables et Constantes de personnalisation / SPIP 4.4, _IFRAME_SAFE_DOMAINS

#VIRTUEL

JLuc — 2025-05-08T15:17:39Z

Cette balise renvoie la valeur du champ de redirection saisi pour un article (cette saisie se fait dans la colonne secondaire de la page d'édition d'un article).
Cette possibilité doit avoir été activée dans la page de configuration "Contenu du site".

- Balises / BOUCLE(ARTICLES), #VIRTUEL

{virtuel}

JLuc — 2025-05-08T10:18:28Z

Le critère {virtuel} d'une boucle ARTICLES permet de ne retenir que les articles virtuels (qui redirigent vers une autre url).

Inversement, avec {virtuel=''} ou {!virtuel} , la boucle ne retournera que les articles non redirigés.

Voir : #VIRTUEL