PHPDoc autour de var_mode (et quelques constantes ont le commentaire mieux placé pour phpdoc). (1e6bb6f5) · Validations · MathieuAlphamosa / spip

ecrire/inc/utils.php

+35 −3

Numéro de ligne d'origine	Numéro de ligne de diff	Ligne de diff
		@@ -2649,9 +2649,36 @@ function spip_initialisation_suite() {
		init_var_mode();
		}

		// Reperer les variables d'URL qui conditionnent la perennite du cache, des urls
		// ou d'autres petit caches (trouver_table, css et js compactes ...)
		// http://code.spip.net/@init_var_mode
		/**
		* Repérer les variables d'URL spéciales `var_mode` qui conditionnent
		* la validité du cache ou certains affichages spéciaux.
		*
		* Le paramètre d'URL `var_mode` permet de
		* modifier la pérennité du cache, recalculer des urls
		* ou d'autres petit caches (trouver_table, css et js compactes ...),
		* d'afficher un écran de débug ou des traductions non réalisées.
		*
		* En fonction de ces paramètres dans l'URL appelante, on définit
		* da constante `_VAR_MODE` qui servira ensuite à SPIP.
		*
		* Le paramètre `var_mode` accepte ces valeurs :
		*
		* - `calcul` : force un calcul du cache de la page (sans forcément recompiler les squelettes)
		* - `recalcul` : force un calcul du cache de la page en recompilant au préabable les squelettes
		* - `inclure` : modifie l'affichage en ajoutant visuellement le nom de toutes les inclusions qu'elle contient
		* - `debug` : modifie l'affichage activant le mode "debug"
		* - `preview` : modifie l'affichage en ajoutant aux boucles les éléments prévisualisables
		* - `traduction` : modifie l'affichage en affichant des informations sur les chaînes de langues utilisées
		* - `urls` : permet de recalculer les URLs des objets appelés dans la page par les balises `#URL_xx`
		* - `images` : permet de recalculer les filtres d'images utilisés dans la page
		*
		* En dehors des modes `calcul` et `recalcul`, une autorisation 'previsualiser' ou 'debug' est testée.
		*
		* @note
		* Il éxiste également le paramètre `var_profile` qui modifie l'affichage pour incruster
		* le nombre de requêtes SQL utilisées dans la page, qui peut se compléter avec le paramètre
		* ` var_mode` (calcul ou recalcul).
		*/
		function init_var_mode() {
		static $done = false;
		if (!$done) {
		@@ -2661,6 +2688,11 @@ function init_var_mode() {
		// tout le monde peut calcul/recalcul
		if (!defined('_VAR_MODE')) {
		if (in_array('recalcul', $var_mode)) {
		/**
		* Indique le mode de calcul ou d'affichage de la page.
		* Lire {@see init_var_mode()} pour les détails
		* @see init_var_mode()
		*/
		define('_VAR_MODE', 'recalcul');
		} elseif (in_array('calcul', $var_mode)) {
		define('_VAR_MODE', 'calcul');

ecrire/inc_version.php

+6 −6

Numéro de ligne d'origine	Numéro de ligne de diff	Ligne de diff
		@@ -56,8 +56,8 @@ define('_ROOT_CWD', getcwd() . '/');
		define('_ROOT_RESTREINT', _ROOT_CWD . _DIR_RESTREINT);

		// Icones
		/** Nom du dossier images */
		if (!defined('_NOM_IMG_PACK')) {
		/** Nom du dossier images */
		define('_NOM_IMG_PACK', 'images/');
		}
		/** le chemin http (relatif) vers les images standard */
		@@ -66,8 +66,8 @@ define('_DIR_IMG_PACK', (_DIR_RACINE . 'prive/' . _NOM_IMG_PACK));
		/** le chemin php (absolu) vers les images standard (pour hebergement centralise) */
		define('_ROOT_IMG_PACK', dirname(dirname(__FILE__)) . '/prive/' . _NOM_IMG_PACK);

		/** Nom du repertoire des bibliotheques JavaScript */
		if (!defined('_JAVASCRIPT')) {
		/** Nom du repertoire des bibliotheques JavaScript */
		define('_JAVASCRIPT', 'javascript/');
		} // utilisable avec #CHEMIN et find_in_path
		/** le nom du repertoire des bibliotheques JavaScript du prive */
		@@ -77,20 +77,20 @@ define('_DIR_JAVASCRIPT', (_DIR_RACINE . 'prive/' . _JAVASCRIPT));
		# Par defaut ces 4 noms seront suffixes par _DIR_RACINE (cf plus bas)
		# mais on peut les mettre ailleurs et changer completement les noms

		/** le nom du repertoire des fichiers Temporaires Inaccessibles par http:// */
		if (!defined('_NOM_TEMPORAIRES_INACCESSIBLES')) {
		/** Nom du repertoire des fichiers Temporaires Inaccessibles par http:// */
		define('_NOM_TEMPORAIRES_INACCESSIBLES', "tmp/");
		}
		/** le nom du repertoire des fichiers Temporaires Accessibles par http:// */
		if (!defined('_NOM_TEMPORAIRES_ACCESSIBLES')) {
		/** Nom du repertoire des fichiers Temporaires Accessibles par http:// */
		define('_NOM_TEMPORAIRES_ACCESSIBLES', "local/");
		}
		/** le nom du repertoire des fichiers Permanents Inaccessibles par http:// */
		if (!defined('_NOM_PERMANENTS_INACCESSIBLES')) {
		/** Nom du repertoire des fichiers Permanents Inaccessibles par http:// */
		define('_NOM_PERMANENTS_INACCESSIBLES', "config/");
		}
		/** le nom du repertoire des fichiers Permanents Accessibles par http:// */
		if (!defined('_NOM_PERMANENTS_ACCESSIBLES')) {
		/** Nom du repertoire des fichiers Permanents Accessibles par http:// */
		define('_NOM_PERMANENTS_ACCESSIBLES', "IMG/");
		}