le fichier mes_options.php3

Ne confondez pas : mes_options.php et mes_fonctions.php , ce ne sont pas les mêmes fichiers.
-  mes_options.php 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.php 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.php 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 être modifiés dans ecrire/mes_options.PHP.
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.php, 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.php, les espaces insecables ?
$activer_revision_nbsp = false ;

Gestion des extras (voir ecrire/inc_extra.php 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.php.
Signalez-le nous en commentaire ou inscrivez-le directement sur la page du carnet wiki consacrée à mes_options

Exemples d’utilisations

-  contenu de mes_options.php 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

Notes complémentaires

-  le fichier mes_options.php est inclu dynamiquement à chaque appel d’une page. On peut donc s’en servir pour définir des fonctions qui doivent être automatiquement inclues à l’exécution. On veillera à ne pas le charger inutilement en mettant dans le fichier mes_fonctions.php toutes les fonctions qui ne doivent être appelées qu’à la compilation d’un squelette (les filtres, par exemple).

-  Le plugin « couteau suisse » a rendu possible la configuration facile de ces options, sans mettre la main dans le code php.

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