From b9e16550729d79d63690b1957590519dbd322c47 Mon Sep 17 00:00:00 2001
From: "Committo,Ergo:sum" <esj@rezo.net>
Date: Thu, 30 Mar 2006 22:34:26 +0000
Subject: [PATCH] =?UTF-8?q?Renommage=20des=20fonctions=20surchargeables=20?=
 =?UTF-8?q?de=20l'espace=20public=20(et=20donc=20de=20leur=20fichier=20ass?=
 =?UTF-8?q?oci=C3=A9)=20par=20des=20verbes=20aussi=20simples=20que=20possi?=
 =?UTF-8?q?ble.?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ecrire/public.php                               |  4 ++--
 ecrire/public/{global.php => assembler.php}     | 17 +++++++++--------
 .../public/{utiliser_cache.php => cacher.php}   |  2 +-
 .../{compiler_squelette.php => compiler.php}    |  7 ++++---
 .../{executer_squelette.php => composer.php}    |  8 ++++----
 .../{localiser_page.php => parametrer.php}      |  8 ++++----
 .../{trouver_squelette.php => styliser.php}     |  2 +-
 7 files changed, 25 insertions(+), 23 deletions(-)
 rename ecrire/public/{global.php => assembler.php} (95%)
 rename ecrire/public/{utiliser_cache.php => cacher.php} (98%)
 rename ecrire/public/{compiler_squelette.php => compiler.php} (99%)
 rename ecrire/public/{executer_squelette.php => composer.php} (98%)
 rename ecrire/public/{localiser_page.php => parametrer.php} (97%)
 rename ecrire/public/{trouver_squelette.php => styliser.php} (96%)

diff --git a/ecrire/public.php b/ecrire/public.php
index b22a4cf45b..fe2ccf3bfc 100644
--- a/ecrire/public.php
+++ b/ecrire/public.php
@@ -74,9 +74,9 @@ if (defined('_INC_PUBLIC')) {
 	// Aller chercher la page
 	//
 
-	include_spip('public/global');
 	$tableau_des_erreurs = array();
-	$page = calcule_header_et_page($fond);
+	$f = charger_fonction('assembler', 'public');
+	$page = $f($fond);
 
 	if ($page['status']) {
 		include_spip('inc/headers');
diff --git a/ecrire/public/global.php b/ecrire/public/assembler.php
similarity index 95%
rename from ecrire/public/global.php
rename to ecrire/public/assembler.php
index 54c1a6e190..95d04ea4a2 100644
--- a/ecrire/public/global.php
+++ b/ecrire/public/assembler.php
@@ -15,7 +15,7 @@ if (!defined("_ECRIRE_INC_VERSION")) return;
 
 // fonction principale declenchant tout le service
 // elle-meme ne fait que traiter les cas particuliers, puis passe la main.
-function calcule_header_et_page ($fond) {
+function public_assembler_dist($fond) {
 	  global $auteur_session, $forcer_lang, $ignore_auth_http,
 	  $var_confirm, $var_mode;
 
@@ -56,7 +56,7 @@ function calcule_header_et_page ($fond) {
 			), true));
 	}
 
-	return afficher_page_globale ($fond);
+	return assembler_page ($fond);
 }
 
 
@@ -80,13 +80,14 @@ function is_preview()
 }
 
 //
-// calculer la page principale et envoyer les entetes
+// calcule la page et les entetes
 //
-function afficher_page_globale ($fond) {
+function assembler_page ($fond) {
 	global $flag_dynamique, $flag_ob, $flag_preserver,$lastmodified,
 		$use_cache, $var_mode, $var_preview;
 
-	$fcache = charger_fonction('utiliser_cache', 'public');
+	// Cette fonction est utilisee deux fois
+	$fcache = charger_fonction('cacher', 'public');
 	// Garnir ces quatre parametres avec les infos sur le cache
 	$fcache(NULL, $use_cache, $chemin_cache, $page, $lastmodified);
 
@@ -127,7 +128,7 @@ function afficher_page_globale ($fond) {
 		if (!$use_cache)
 			restaurer_globales($page['contexte']);
 		else {
-			$f = charger_fonction('localiser_page', 'public');
+			$f = charger_fonction('parametrer', 'public');
 			$page = $f($fond, '', $chemin_cache);
 			if ($chemin_cache)
 				$fcache(NULL, $use_cache, $chemin_cache, $page, $lastmodified);
@@ -197,7 +198,7 @@ function auto_expire($page)
 function inclure_page($fond, $contexte_inclus, $cache_incluant='') {
 	global $lastmodified;
 
-	$fcache = charger_fonction('utiliser_cache', 'public');
+	$fcache = charger_fonction('cacher', 'public');
 	// Garnir ces quatre parametres avec les infos sur le cache
 	$fcache($contexte_inclus, $use_cache, $chemin_cache, $page, $lastinclude);
 
@@ -222,7 +223,7 @@ function inclure_page($fond, $contexte_inclus, $cache_incluant='') {
 	if (!$use_cache) {
 		$lastmodified = max($lastmodified, $lastinclude);
 	} else {
-		$f = charger_fonction('localiser_page', 'public');
+		$f = charger_fonction('parametrer', 'public');
 		$page = $f($fond, $contexte_inclus, $chemin_cache);
 		$lastmodified = time();
 		if ($chemin_cache) 
diff --git a/ecrire/public/utiliser_cache.php b/ecrire/public/cacher.php
similarity index 98%
rename from ecrire/public/utiliser_cache.php
rename to ecrire/public/cacher.php
index f9259e121a..1f3debe810 100644
--- a/ecrire/public/utiliser_cache.php
+++ b/ecrire/public/cacher.php
@@ -252,7 +252,7 @@ function nettoyer_petit_cache($prefix, $duree = 300) {
 // - page qui est le tableau decrivant la page, si le cache la contenait
 // - lastmodifed qui vaut la date de derniere modif du fichier.
 
-function public_utiliser_cache_dist($contexte, &$use_cache, &$chemin_cache, &$page, &$lastmodified) {
+function public_cacher_dist($contexte, &$use_cache, &$chemin_cache, &$page, &$lastmodified) {
 
 	if ($chemin_cache) return creer_cache($page, $chemin_cache, $use_cache);
 	// cas ignorant le cache car complement dynamique
diff --git a/ecrire/public/compiler_squelette.php b/ecrire/public/compiler.php
similarity index 99%
rename from ecrire/public/compiler_squelette.php
rename to ecrire/public/compiler.php
index 11ec735028..0e89c4ff2f 100644
--- a/ecrire/public/compiler_squelette.php
+++ b/ecrire/public/compiler.php
@@ -564,8 +564,9 @@ function code_boucle(&$boucles, $id, $nom)
 }
 
 
-// Prend en argument le source d'un squelette, sa grammaire et un nom.
-// Retourne une fonction PHP/SQL portant ce nom et calculant une page HTML.
+// Prend en argument le texte d'un squelette (et son fichier d'origine)
+// sa grammaire et un nom.
+// Retourne une fonction PHP/SQL portant ce nom et calculant une page.
 // Pour appeler la fonction produite, lui fournir 2 tableaux de 1 e'le'ment:
 // - 1er: element 'cache' => nom (du fichier ou` mettre la page)
 // - 2e: element 0 contenant un environnement ('id_article => $id_article, etc)
@@ -577,7 +578,7 @@ function code_boucle(&$boucles, $id, $nom)
 // - 'entetes' => tableau des entetes http
 // En cas d'erreur, elle retourne un tableau des 2 premiers elements seulement
 
-function public_compiler_squelette_dist($squelette, $nom, $gram, $sourcefile) {
+function public_compiler_dist($squelette, $nom, $gram, $sourcefile) {
   global  $table_des_tables, $tables_des_serveurs_sql, $tables_principales,
     $tables_jointures;
 
diff --git a/ecrire/public/executer_squelette.php b/ecrire/public/composer.php
similarity index 98%
rename from ecrire/public/executer_squelette.php
rename to ecrire/public/composer.php
index 52b1a94d83..0071274f30 100644
--- a/ecrire/public/executer_squelette.php
+++ b/ecrire/public/composer.php
@@ -20,8 +20,8 @@ include_spip('inc/forum');
 include_spip('inc/distant');
 include_spip('inc/rubriques'); # pour calcul_branche (cf critere branche)
 
-# Charge un squelette (au besoin le compile) 
-# et retoune le nom de sa fonction principale, ou '' s'il est indefini
+# Charge et retourne un composeur, i.e. la fonction principale d'un squelette
+# ou '' s'il est inconnu. Le compile au besoin
 # Charge egalement un fichier homonyme de celui du squelette
 # mais de suffixe '_fonctions.php' pouvant contenir:
 # 1. des filtres
@@ -29,7 +29,7 @@ include_spip('inc/rubriques'); # pour calcul_branche (cf critere branche)
 # 3. des declaration de tables SQL supplementaires
 # Toutefois pour 2. et 3. preferer la technique de la surcharge
 
-function public_executer_squelette($squelette, $mime_type, $gram, $sourcefile) {
+function public_composer_dist($squelette, $mime_type, $gram, $sourcefile) {
 
 	$nom = $mime_type . '_' . md5($squelette);
 
@@ -54,7 +54,7 @@ function public_executer_squelette($squelette, $mime_type, $gram, $sourcefile) {
 
 	// charger le source, si possible, et compiler 
 	if (lire_fichier ($sourcefile, $skel)) {
-		$f = charger_fonction('compiler_squelette', 'public');
+		$f = charger_fonction('compiler', 'public');
 		$skel_code = $f($skel, $nom, $gram, $sourcefile);
 	}
 
diff --git a/ecrire/public/localiser_page.php b/ecrire/public/parametrer.php
similarity index 97%
rename from ecrire/public/localiser_page.php
rename to ecrire/public/parametrer.php
index 63ef41725d..94395250a9 100644
--- a/ecrire/public/localiser_page.php
+++ b/ecrire/public/parametrer.php
@@ -242,7 +242,7 @@ function sql_accepter_forum($id_article) {
 }
 
 # Determine les parametres d'URL (hors r��criture) et consorts
-# En deduit un contexte disant si la page est un rediction ou 
+# En deduit un contexte disant si la page est une rediction ou 
 # exige un squelette deductible de $fond et du contexte linguistique.
 # Aplique alors le squelette sur le contexte et le nom du cache.
 # Retourne un tableau de 3 elements:
@@ -251,7 +251,7 @@ function sql_accepter_forum($id_article) {
 # 'invalideurs' => les invalideurs de ce cache
 # En cas d'erreur process_ins est absent et texte est un tableau de 2 chaines
 
-function public_localiser_page_dist($fond, $local='', $cache='')  {
+function public_parametrer_dist($fond, $local='', $cache='')  {
 
 	// distinguer le premier appel des appels par inclusion
 	if (!is_array($local)) { 
@@ -305,7 +305,7 @@ function public_localiser_page_dist($fond, $local='', $cache='')  {
 	if (!$GLOBALS['forcer_lang'])
 		lang_select($lang);
 
-	$f = charger_fonction('trouver_squelette', 'public');
+	$f = charger_fonction('styliser', 'public');
 	list($skel,$mime_type, $gram, $sourcefile) = $f($fond, $id_rubrique_fond,$GLOBALS['spip_lang']);
 
 	// Charger le squelette en specifiant les langages cibles et source
@@ -313,7 +313,7 @@ function public_localiser_page_dist($fond, $local='', $cache='')  {
 	// et appliquer sa fonction principale sur le contexte.
 	// Passer le nom du cache pour produire sa destruction automatique
 
-	$f = charger_fonction('executer_squelette', 'public');
+	$f = charger_fonction('composer', 'public');
 
 	if ($fonc = $f($skel, $mime_type, $gram, $sourcefile)){
 		spip_timer('calcul page');
diff --git a/ecrire/public/trouver_squelette.php b/ecrire/public/styliser.php
similarity index 96%
rename from ecrire/public/trouver_squelette.php
rename to ecrire/public/styliser.php
index e7f8b9c740..76868be6e2 100644
--- a/ecrire/public/trouver_squelette.php
+++ b/ecrire/public/styliser.php
@@ -15,7 +15,7 @@ if (!defined("_ECRIRE_INC_VERSION")) return;
 
 // Ce fichier doit imperativement definir la fonction ci-dessous:
 
-function public_trouver_squelette_dist($fond, $id_rubrique, $lang) {
+function public_styliser_dist($fond, $id_rubrique, $lang) {
 	
   // Actuellement tous les squelettes se terminent par .html
   // pour des raisons historiques, ce qui est trompeur
-- 
GitLab