Quelles options ?
Lorsqu’un visiteur du site demande à voir une page, qu’elle soit déjà en cache ou non, SPIP exécute un certain nombre d’actions, dont celle de charger le fichier mes_options.php.
Dans ce fichier, il est possible de :
- définir des "constantes" PHP ;
- adapter des variables de personnalisation (globales) ;
- définir des fonctions (voir à ce propos l’avertissement sur la performance).
Voir la liste complète des constantes et des variables de personnalisation dans le glossaire.
Créer le fichier mes_options.php
Par défaut, SPIP ne fournit pas ce fichier.
Ces options peuvent être créées
- dans le fichier
config/mes_options.phpd’un site, - ou dans un plugin, dans le fichier
prefixePlugin_options.php
Note [1].
mes_options.php étant un fichier PHP, il doit commencer par <?php (soyez extrêmement vigilant : il ne doit y avoir aucun caractère ni espace ni ligne vierge avant la balise ouvrante <?php).
SPIP adopte les conventions PHP récentes, il est donc recommandé de ne plus indiquer de balise fermante ?>.
<?php
// sécurité
if (!defined('_ECRIRE_INC_VERSION')) {
return;
}
// Définir une constante
// interdire l'upload de documents de plus de 500 Ko
define('_DOC_MAX_SIZE', 500);
// Adapter une variable de personnalisation
// forcer l’affichage d’un menu déroulant à partir de 2010 pour
// le champ "Date de première publication"
$GLOBALS['debut_date_publication'] = '2010';
Usage avancé
Il est possible dans ce fichier personnel d’invoquer la fonction spip_initialisation() pour définir les répertoires de données et, par exemple, disposer ainsi de plusieurs sites sous SPIP utilisant une seule distribution (l’appel standard de cette fonction, plus loin dans inc_version.php, sera automatiquement neutralisé).
Voir à ce propos le Mécanismes de fabrication des pages publiques et privées
Avertissement sur la performance
Lorsqu’il existe, ce fichier est chargé à chaque affichage de page (espace privée comme espace public) ; il doit donc rester le plus léger et économe possible.
Voir aussi
- #CONST : pour récupérer la valeur d’une constante
- #EVAL : pour récupérer la valeur d’une variable de personnalisation
- La rubrique Variables et Constantes de personnalisation
- Mécanismes de fabrication des pages publiques et privées
Pour débugguer les erreurs PHP
Sur le site programmer.spip.net