le fichier mes_options.php3

Ne confondez pas : mes_options.php3 et mes_fonctions.php3 , ce ne sont pas les mêmes fichiers.
 mes_options.php3 est une nouvelle possibilité de configuration de SPIP, apparue avec la version 1.7,
 mes_fonctions est une vieille connaissance, qui permet de configurer la fabrication des pages dans le cache à partir du squelette, et on peut en consulter la documentation sur les variables de personnalisation spip .

Le fichier mes_options.php3 se situe dans le répertoire ecrire. S’il n’existe pas avant votre intervention, il faut le créer. Il sert au paramétrage avancé d’un site SPIP, pour modifier des fonctionnalités pour lesquelles la partie privée ne propose pas d’interface.

Ce fichier est inclu automatiquement lorsqu’il existe à l’exécution de SPIP, lors de l’affichage de chaque page de la partie privée et publique, contrairement à mes_fonctions, qui n’est utilisé que pendant la fabrication du cache à partir du squelette.

C’est par exemple dans mes_options.php3 qu’on spécifie la liste des champs extras pour le site avec leurs caractéristiques.

C’est là également qu’on modifie la valeur de variables PHP utiles au fonctionnement interne de SPIP.

C’est un fichier PHP donc il commence par <?php et il termine par ?>

Les variables de configuration et leur caractéristiques

Ces paramètres peuvent etre modifiés dans ecrire/mes_options.PHP3.
Les valeurs specifiées dans ce dernier fichier remplaceront automatiquement les valeurs prédéfinies. La plupart de ces variables sont initialisées dans le fichier ecrire/inc_version.php3, dont sont extraites les valeurs par défaut indiquées ci dessous.

Préfixe des tables dans la base de donnees
(pour avoir plusieurs sites SPIP dans une seule base)
$table_prefix = "spip" ;

Préfixe des cookies
pour installer des sites SPIP dans des sous-repertoires...
$cookie_prefix = "spip" ;
Attention : si vous modifiez cette valeur, il faut absolument choisir un $cookie_prefix ne commençant pas par spip : ni spip2 ni spip_autre ne fonctionneront. Choisissez spop, alouette ou hop...

Dossier des squelettes
Spécifie le répertoire dans lequel les squelettes sont rangés. Cela permet d’alléger le répertoire racine, et de tester différentes versions de squelettes en facilitant le passage de l’un à l’autre.
$dossier_squelettes = "" ;

SPIP doit-il compresser les pages a la volée quand le navigateur l’accepte ? (valable pour apache 1.3 seulement)
$auto_compress = true ;

Faut-il enresistrer les infos de debug dans le fichier de log data/spip.log ? (peu utilisé)
$debug = false ;

Faut-il passer les connexions MySQL en mode debug ?
$mysql_debug = false ;

Faut-il chronométrer les requetes MySQL ?
$mysql_profile = false ;

Faut-il faire des connexions completes rappelant le nom du serveur et de la base MySQL ? (utile si vos squelettes appellent d’autres bases MySQL)
$mysql_rappel_connexion = false ;

Faut-il afficher en rouge les chaines non traduites ?
$test_i18n = false ;

Faut-il souligner en gris, dans ecrire/articles.php3, les espaces insecables ?
$activer_revision_nbsp = false ;

Gestion des extras (voir ecrire/inc_extra.php3 et le tutorial pour plus d’informations)
$champs_extra = false ;
$champs_extra_proposes = false ;

Faut-il ignorer l’authentification par auth http/remote_user ?
cela permet d’avoir un SPIP sous .htaccess (ignore_remote_user), mais aussi de fonctionner sur des serveurs debiles se bloquant sur PHP_AUTH_USER=root (ignore_auth_http)
$ignore_auth_http = false ;
$ignore_remote_user = false ;

Autres variables

Un grand nombre d’autres variables SPIP peuvent être reparamétrées dans mes_options.php3.
Signalez-le nous ou inscrivez-le directement ici lorsque vous avez une utilisation particulière d’une variable SPIP dans mes_options.php3. Vous pouvez éditer directement le contenu de cette page

Exemples d’utilisations

 contenu de mes_options.php3 lorsque les squelettes sont dans le répertoire placard

 $table_prefix et $cookie_prefix pour mettre plusieurs SPIP sur une même base

 $flag_ImageCreateTrueColor et $flag_ImageCopyResampled pour modifier et souvent améliorer la manière avec laquelle SPIP génère les vignettes

 on peut aussi se servir de mes_options.php3 pour définir des fonctions qui seront automatiquement inclues à l’exécution.

 Vous pouvez consulter la dernière version de ce document et y apporter vos compléments d’information sur la page Spikini consacrée à mes_options.php3