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
<?php
$dossier_squelettes = "./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)
Discussions par date d’activité
5 discussions
SVP prendre note que le lien « éditer directement le contenu de cette page » ne fonctionne plus.
Nouveau lien : http://www.spip-contrib.net/MesOptions
Répondre à ce message
Pourquoi ne pas plutôt publier cela dans la doc officielle de SPIP ???
Oui, je trouve aussi que ça serait pertinent.
Répondre à ce message
Pouvez-vous approfondir cette option ?
et surtout la notion de sous-répertoire ...
merci...
Répondre à ce message
« on peut aussi se servir de mes_options.php3 pour définir des fonctions qui seront automatiquement inclues à lexécution. »
Là c’est pas très clair. S’il pouvait y avoir un exemple d’utilisation...
Répondre à ce message
SPIP 1.6 inclut aussi mes_options.php3, le mechanisme est pratiquement indentique à SPIP 1.7.
Patrick
Répondre à ce message
Ajouter un commentaire
Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :
Merci d’avance pour les personnes qui vous aideront !
Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.
Suivre les commentaires : |