Paramétrage avancé d’un site avec mes_options.php3

Ceci est une ARCHIVE, peut-être périmée. Vérifiez bien les compatibilités !

Liste des paramétrages possibles à l’aide des variables de configurations redéfinissables dans mes_options.php3 (ou mes_options.php dans les versions plus récentes...).
Note : Les plugins « couteau suisse » et « couteau kiss » (plus simple) ont rendu possibles la configuration facile d’un bon nombre de ces options, sans mettre la main dans le code php.

Voir un article un peu plus récent et complet

Liste des paramétrages possibles à l’aide des variables de configurations redéfinissables dans mes_options.php3 (ou mes_options.php dans les versions plus récentes...).

Note : Les plugins « couteau suisse » et couteau kiss (plus simple) ont rendu possibles la configuration facile d’un bon nombre de ces options, sans mettre la main dans le code php.

Voir un article un peu plus récent et complet

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)

Discussion

5 discussions

Ajouter un commentaire

Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :

  • Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
  • Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
    • version de SPIP, en bas de la partie privée
    • version du plugin testé et des éventuels plugins nécessités
    • version de PHP (exec=info en partie privée)
    • version de MySQL / SQLite
  • Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
  • En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparaît.

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.

Qui êtes-vous ?
[Se connecter]

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici

Ce champ accepte les raccourcis SPIP {{gras}} {italique} -*liste [texte->url] <quote> <code> et le code HTML <q> <del> <ins>. Pour créer des paragraphes, laissez simplement des lignes vides.

Ajouter un document

Suivre les commentaires : RSS 2.0 | Atom