3 /***************************************************************************\
4 * SPIP, Systeme de publication pour l'internet *
6 * Copyright (c) 2001-2012 *
7 * Arnaud Martin, Antoine Pitrou, Philippe Riviere, Emmanuel Saint-James *
9 * Ce programme est un logiciel libre distribue sous licence GNU/GPL. *
10 * Pour plus de details voir le fichier COPYING.txt ou l'aide en ligne. *
11 \***************************************************************************/
14 * Fichier gérant l'actualisation et le suivi des rubriques, et de leurs branches
16 * @package SPIP\Rubriques
19 if (!defined('_ECRIRE_INC_VERSION')) return;
23 * Recalcule les statuts d'une rubrique
25 * Fonction à appeler lorsque le statut d'un objet change dans une rubrique
26 * ou que la rubrique est deplacée.
28 * Si le statut passe a "publie", la rubrique et ses parents y passent aussi
29 * et les langues utilisees sont recalculées.
30 * Conséquences symétriques s'il est depublié.
32 * S'il est deplacé alors qu'il était publiée, double conséquence.
34 * Tout cela devrait passer en SQL, sous forme de Cascade SQL.
36 * @param int $id_rubrique
37 * Identifiant de la rubrique
38 * @param array $modifs
39 * Tableau de description des modifications.
40 * Peut avoir 2 index, 'statut' étant obligatoire :
41 * - statut : indique le nouveau statut de la rubrique
42 * - id_rubrique : indiquer la rubrique dans laquelle on déplace la rubrique (son nouveau parent donc)
43 * @param string $statut_ancien
44 * Ancien statut de la rubrique
45 * @param bool $postdate
46 * true pour recalculer aussi la date du prochain article post-daté
48 * true si le statut change effectivement
50 function calculer_rubriques_if ($id_rubrique, $modifs, $statut_ancien='', $postdate = false)
53 if ($statut_ancien == 'publie') {
54 if (isset($modifs['statut'])
55 OR isset($modifs['id_rubrique'])
56 OR ($postdate AND strtotime($postdate)>time()))
57 $neuf |
= depublier_branche_rubrique_if($id_rubrique);
58 // ne publier que si c'est pas un postdate, ou si la date n'est pas dans le futur
60 calculer_prochain_postdate(true);
61 $neuf |
= (strtotime($postdate)<=time()); // par securite
63 elseif (isset($modifs['id_rubrique']))
64 $neuf |
= publier_branche_rubrique($modifs['id_rubrique']);
66 elseif ($modifs['statut']=='publie'){
68 calculer_prochain_postdate(true);
69 $neuf |
= (strtotime($postdate)<=time()); // par securite
72 $neuf |
= publier_branche_rubrique($id_rubrique);
76 // Sauver la date de la derniere mise a jour (pour menu_rubriques)
77 ecrire_meta("date_calcul_rubriques", date("U"));
79 $langues = calculer_langues_utilisees();
80 ecrire_meta('langues_utilisees', $langues);
85 * Publie une rubrique et sa hiérarchie de rubriques
87 * Fonction à appeler lorsqu'on dépublie ou supprime quelque chose
90 * @todo Le nom de la fonction est trompeur, vu que la fonction remonte dans la hierarchie !
92 * @param int $id_rubrique
93 * Identifiant de la rubrique
95 * true si le statut change effectivement
97 function publier_branche_rubrique($id_rubrique)
99 $id_pred = $id_rubrique;
101 sql_updateq('spip_rubriques', array('statut'=>'publie', 'date'=>date('Y-m-d H:i:s')), "id_rubrique=$id_rubrique");
102 $id_parent = sql_getfetsel('id_parent', 'spip_rubriques AS R', "R.id_rubrique=$id_rubrique");
103 if (!$id_parent) break;
104 $id_rubrique = $id_parent;
107 # spip_log(" publier_branche_rubrique($id_rubrique $id_pred");
108 return $id_pred != $id_rubrique;
112 * Dépublie si nécessaire des éléments d'une hiérarchie de rubriques
114 * Fonction à appeler lorsqu'on dépublie ou supprime quelque chose
117 * @todo Le nom de la fonction est trompeur, vu que la fonction remonte dans la hierarchie !
119 * @param int $id_rubrique
120 * Identifiant de la rubrique
122 * true si le statut change effectivement
124 function depublier_branche_rubrique_if($id_rubrique){
125 $date = date('Y-m-d H:i:s'); // figer la date
127 # spip_log("depublier_branche_rubrique($id_rubrique ?");
128 $id_pred = $id_rubrique;
131 if (!depublier_rubrique_if($id_pred,$date))
132 return $id_pred != $id_rubrique;
133 // passer au parent si on a depublie
134 $r = sql_fetsel("id_parent", "spip_rubriques", "id_rubrique=$id_pred");
135 $id_pred = $r['id_parent'];
138 return $id_pred != $id_rubrique;
142 * Dépublier une rubrique si aucun contenu publié connu n'est trouvé dedans
144 * @param int $id_rubrique
145 * Identifiant de la rubrique à tester
146 * @param string|null $date
147 * Date pour le calcul des éléments post-datés.
148 * null = date actuelle.
150 * true si la rubrique a été dépubliée
152 function depublier_rubrique_if($id_rubrique,$date=null){
153 if (is_null($date)) {
154 $date = date('Y-m-d H:i:s');
156 $postdates = ($GLOBALS['meta']["post_dates"] == "non") ?
157 " AND date <= ".sql_quote($date) : '';
159 if (!$id_rubrique=intval($id_rubrique))
162 // verifier qu'elle existe et est bien publiee
163 $r = sql_fetsel('id_rubrique,statut','spip_rubriques',"id_rubrique=$id_rubrique");
164 if (!$r OR $r['statut']!=='publie')
167 // On met le nombre de chaque type d'enfants dans un tableau
168 // Le type de l'objet est au pluriel
170 'articles' => sql_countsel("spip_articles", "id_rubrique=$id_rubrique AND statut='publie'$postdates"),
171 'rubriques' => sql_countsel("spip_rubriques", "id_parent=$id_rubrique AND statut='publie'"),
172 'documents' => sql_countsel("spip_documents_liens", "id_objet=$id_rubrique AND objet='rubrique'")
175 // On passe le tableau des comptes dans un pipeline pour que les plugins puissent ajouter (ou retirer) des enfants
176 $compte = pipeline('objet_compte_enfants',
179 'objet' => 'rubrique',
180 'id_objet' => $id_rubrique,
181 'statut' => 'publie',
188 // S'il y a au moins un enfant de n'importe quoi, on ne dépublie pas
189 foreach($compte as $objet => $n)
193 sql_updateq("spip_rubriques", array("statut" => '0'), "id_rubrique=$id_rubrique");
194 # spip_log("depublier_rubrique $id_pred");
200 * Recalcule des héritages de rubriques
202 * Recalcule le statut des rubriques, les langues héritées et la date
203 * du prochain article post-daté
205 * Cette fonction est appelée après importation: elle calcule les meta-donnes
206 * resultantes et remet de la coherence au cas où la base importée en manquait
208 * Cette fonction doit etre invoquée sans processus concurrent potentiel.
212 function calculer_rubriques() {
214 calculer_rubriques_publiees();
216 // Apres chaque (de)publication
217 // recalculer les langues utilisees sur le site
218 $langues = calculer_langues_utilisees();
219 ecrire_meta('langues_utilisees', $langues);
221 // Sauver la date de la derniere mise a jour (pour menu_rubriques)
222 ecrire_meta("date_calcul_rubriques", date("U"));
224 // on calcule la date du prochain article post-date
225 calculer_prochain_postdate();
231 * Recalcule l'ensemble des donnees associees a l'arborescence des rubriques
233 * Attention, faute de SQL transactionnel on travaille sur
234 * des champs temporaires afin de ne pas casser la base
235 * pendant la demi seconde de recalculs
239 function calculer_rubriques_publiees() {
241 // Mettre les compteurs a zero
242 sql_updateq('spip_rubriques', array('date_tmp' => '0000-00-00 00:00:00', 'statut_tmp' => 'prive'));
245 // Publier et dater les rubriques qui ont un article publie
248 // Afficher les articles post-dates ?
249 $postdates = ($GLOBALS['meta']["post_dates"] == "non") ?
250 "AND A.date <= ".sql_quote(date('Y-m-d H:i:s')) : '';
252 $r = sql_select("R.id_rubrique AS id, max(A.date) AS date_h", "spip_rubriques AS R, spip_articles AS A", "R.id_rubrique = A.id_rubrique AND A.statut='publie' $postdates ", "R.id_rubrique");
253 while ($row = sql_fetch($r))
254 sql_updateq("spip_rubriques", array("statut_tmp" => 'publie', "date_tmp" => $row['date_h']), "id_rubrique=".$row['id']);
256 // point d'entree pour permettre a des plugins de gerer le statut
257 // autrement (par ex: toute rubrique est publiee des sa creation)
258 // Ce pipeline fait ce qu'il veut, mais s'il touche aux statuts/dates
259 // c'est statut_tmp/date_tmp qu'il doit modifier
260 // [C'est un trigger... a renommer en trig_calculer_rubriques ?]
261 pipeline('calculer_rubriques', null);
264 // Les rubriques qui ont une rubrique fille plus recente
265 // on tourne tant que les donnees remontent vers la racine.
268 $r = sql_select("R.id_rubrique AS id, max(A.date_tmp) AS date_h", "spip_rubriques AS R, spip_rubriques AS A", "R.id_rubrique = A.id_parent AND (R.date_tmp < A.date_tmp OR R.statut_tmp<>'publie') AND A.statut_tmp='publie' ", "R.id_rubrique");
269 while ($row = sql_fetch($r)) {
270 sql_updateq('spip_rubriques', array('statut_tmp'=>'publie', 'date_tmp'=>$row['date_h']),"id_rubrique=".$row['id']);
273 } while ($continuer);
275 // Enregistrement des modifs
276 sql_update('spip_rubriques', array('date'=>'date_tmp', 'statut'=>'statut_tmp'));
280 * Recalcule les secteurs et les profondeurs des rubriques (et articles)
282 * Cherche les rubriques ayant des id_secteur ou profondeurs ne correspondant pas
283 * avec leur parent, et les met à jour. De même avec les articles et leur id_secteur
287 function propager_les_secteurs()
289 // fixer les id_secteur des rubriques racines
290 sql_update('spip_rubriques', array('id_secteur'=>'id_rubrique','profondeur'=>0), "id_parent=0");
292 // reparer les rubriques qui n'ont pas l'id_secteur de leur parent
295 $r = sql_select("A.id_rubrique AS id, R.id_secteur AS secteur, R.profondeur+1 as profondeur", "spip_rubriques AS A, spip_rubriques AS R", "A.id_parent = R.id_rubrique AND (A.id_secteur <> R.id_secteur OR A.profondeur <> R.profondeur+1)");
296 while ($row = sql_fetch($r)) {
297 sql_update("spip_rubriques", array("id_secteur" => $row['secteur'],'profondeur' => $row['profondeur']), "id_rubrique=".$row['id']);
300 } while ($continuer);
302 // reparer les articles
303 $r = sql_select("A.id_article AS id, R.id_secteur AS secteur", "spip_articles AS A, spip_rubriques AS R", "A.id_rubrique = R.id_rubrique AND A.id_secteur <> R.id_secteur");
305 while ($row = sql_fetch($r)) {
306 sql_update("spip_articles", array("id_secteur" => $row['secteur']), "id_article=".$row['id']);
309 // avertir les plugins qui peuvent faire leur mises a jour egalement
310 pipeline('trig_propager_les_secteurs','');
315 * Recalcule les langues héritées des sous-rubriques
317 * Cherche les langues incorrectes de sous rubriques, qui doivent hériter
318 * de la rubrique parente lorsque langue_choisie est différent de oui,
322 * true si un changement a eu lieu
324 function calculer_langues_rubriques_etape() {
325 $s = sql_select("A.id_rubrique AS id_rubrique, R.lang AS lang", "spip_rubriques AS A, spip_rubriques AS R", "A.id_parent = R.id_rubrique AND A.langue_choisie != 'oui' AND R.lang<>'' AND R.lang<>A.lang");
328 while ($row = sql_fetch($s)) {
329 $id_rubrique = $row['id_rubrique'];
330 $t = sql_updateq('spip_rubriques', array('lang' => $row['lang'], 'langue_choisie'=>'non'), "id_rubrique=$id_rubrique");
337 * Recalcule les langues des rubriques et articles
339 * Redéfinit la langue du site sur les rubriques sans langue spécifiée
340 * (langue_choisie différent de 'oui')
342 * Redéfinit les langues des articles sans langue spécifiée
343 * (langue_choisie différent de 'oui') en les rebasant sur la langue
344 * de la rubrique parente lorsque ce n'est pas le cas.
348 function calculer_langues_rubriques() {
350 // rubriques (recursivite)
351 sql_updateq("spip_rubriques", array("lang" => $GLOBALS['meta']['langue_site'], "langue_choisie" => 'non'), "id_parent=0 AND langue_choisie != 'oui'");
352 while (calculer_langues_rubriques_etape());
355 $s = sql_select("A.id_article AS id_article, R.lang AS lang", "spip_articles AS A, spip_rubriques AS R", "A.id_rubrique = R.id_rubrique AND A.langue_choisie != 'oui' AND (length(A.lang)=0 OR length(R.lang)>0) AND R.lang<>A.lang");
356 while ($row = sql_fetch($s)) {
357 $id_article = $row['id_article'];
358 sql_updateq('spip_articles', array("lang"=> $row['lang'], 'langue_choisie'=>'non'), "id_article=$id_article");
361 if ($GLOBALS['meta']['multi_rubriques'] == 'oui') {
363 $langues = calculer_langues_utilisees();
364 ecrire_meta('langues_utilisees', $langues);
367 // avertir les plugins qui peuvent faire leur mises a jour egalement
368 pipeline('trig_calculer_langues_rubriques','');
373 * Calcule la liste des langues reellement utilisees dans le site public
375 * La recherche de langue est effectuée en recréant une boucle pour chaque
376 * objet éditorial gérant des langues de sorte que les éléments non publiés
377 * ne sont pas pris en compte.
379 * @param string $serveur
380 * Nom du connecteur à la base de données
382 * Liste des langues utilisées séparées par des virgules
384 function calculer_langues_utilisees ($serveur='') {
385 include_spip('public/interfaces');
386 include_spip('public/compiler');
387 include_spip('public/composer');
390 $langues[$GLOBALS['meta']['langue_site']] = 1;
392 include_spip('base/objets');
393 $tables = lister_tables_objets_sql();
394 $trouver_table = charger_fonction('trouver_table','base');
396 foreach(array_keys($tables) as $t){
397 $desc = $trouver_table($t,$serveur);
398 // c'est une table avec des langues
400 AND isset($desc['field']['lang'])
401 AND isset($desc['field']['langue_choisie'])){
403 $boucle = new Boucle();
404 $boucle->show
= $desc;
405 $boucle->nom
= 'calculer_langues_utilisees';
406 $boucle->id_boucle
= $desc['table_objet'];
407 $boucle->id_table
= $desc['table_objet'];
408 $boucle->sql_serveur
= $serveur;
409 $boucle->select
[] = "DISTINCT lang";
410 $boucle->from
[$desc['table_objet']] = $t;
411 $boucle = pipeline('pre_boucle', $boucle);
413 if (isset($desc['statut'])
414 AND $desc['statut']){
415 instituer_boucle($boucle, false);
416 $res = calculer_select($boucle->select
,$boucle->from
,$boucle->from_type
,$boucle->where
,$boucle->join
,$boucle->group
,$boucle->order
,$boucle->limit
,$boucle->having
,$desc['table_objet'],$desc['table_objet'],$serveur);
419 $res = sql_select(implode(',',$boucle->select
),$boucle->from
);
420 while ($row = sql_fetch($res)) {
421 $langues[$row['lang']] = 1;
426 $langues = array_filter(array_keys($langues));
428 $langues = join(',',$langues);
429 spip_log("langues utilisees: $langues");
434 * Calcule une branche de rubriques
436 * Dépréciée, pour compatibilité
439 * @see calcul_branche_in()
441 * @param string|int|array $generation
444 function calcul_branche ($generation) {return calcul_branche_in($generation);}
447 * Calcul d'une branche de rubrique
449 * Liste des id_rubrique contenues dans une rubrique donnée
451 * @see inc_calcul_branche_in_dist()
453 * @param string|int|array $id
454 * Identifiant de la, ou des rubriques noeuds
456 * Liste des identifiants séparés par des virgules,
457 * incluant les rubriques noeuds et toutes leurs descendances
459 function calcul_branche_in($id) {
460 $calcul_branche_in = charger_fonction('calcul_branche_in','inc');
461 return $calcul_branche_in($id);
465 * Calcul d'une hiérarchie
467 * Liste des id_rubrique contenant une rubrique donnée
469 * @see inc_calcul_hierarchie_in_dist()
470 * @param string|int|array $id
471 * Identifiant de la, ou des rubriques dont on veut obtenir les hierarchies
473 * Liste des identifiants séparés par des virgules,
474 * incluant les rubriques transmises et toutes leurs parentées
476 function calcul_hierarchie_in($id) {
477 $calcul_hierarchie_in = charger_fonction('calcul_hierarchie_in','inc');
478 return $calcul_hierarchie_in($id);
483 * Calcul d'une branche de rubriques
485 * Liste des id_rubrique contenues dans une rubrique donnée
486 * pour le critere {branche}
488 * Fonction surchargeable pour optimisation
490 * @param string|int|array $id
491 * Identifiant de la, ou des rubriques noeuds
493 * Liste des identifiants séparés par des virgules,
494 * incluant les rubriques noeuds et toutes leurs descendances
496 function inc_calcul_branche_in_dist($id) {
499 // normaliser $id qui a pu arriver comme un array, comme un entier, ou comme une chaine NN,NN,NN
500 if (!is_array($id)) $id = explode(',',$id);
501 $id = join(',', array_map('intval', $id));
505 // Notre branche commence par la rubrique de depart
508 // On ajoute une generation (les filles de la generation precedente)
509 // jusqu'a epuisement
510 while ($filles = sql_allfetsel(
513 sql_in('id_parent', $r)." AND ". sql_in('id_rubrique', $r, 'NOT')
515 $r = join(',', array_map('array_shift', $filles));
516 $branche .= ',' . $r;
519 # securite pour ne pas plomber la conso memoire sur les sites prolifiques
520 if (strlen($branche)<10000)
527 * Calcul d'une hiérarchie
529 * Liste des id_rubrique contenant une rubrique donnée,
530 * contrairement à la fonction calcul_branche_in() qui calcule les
531 * rubriques contenues
533 * @param string|int|array $id
534 * Identifiant de la, ou des rubriques dont on veut obtenir les hierarchies
536 * Liste des identifiants séparés par des virgules,
537 * incluant les rubriques transmises et toutes leurs parentées
539 function inc_calcul_hierarchie_in_dist($id) {
542 // normaliser $id qui a pu arriver comme un array, comme un entier, ou comme une chaine NN,NN,NN
543 if (!is_array($id)) $id = explode(',',$id);
544 $id = join(',', array_map('intval', $id));
548 // Notre branche commence par la rubrique de depart
551 // On ajoute une generation (les filles de la generation precedente)
552 // jusqu'a epuisement
553 while ($parents = sql_allfetsel('id_parent', 'spip_rubriques',sql_in('id_rubrique', $id))) {
554 $id = join(',', array_map('reset', $parents));
558 # securite pour ne pas plomber la conso memoire sur les sites prolifiques
559 if (strlen($hier)<10000)
567 * Calcule la date du prochain article post-daté
569 * Appelée lorsqu'un (ou plusieurs) article post-daté arrive à terme
573 * true pour affecter le statut des rubriques concernées.
576 function calculer_prochain_postdate($check= false) {
577 include_spip('base/abstract_sql');
579 $postdates = ($GLOBALS['meta']["post_dates"] == "non") ?
580 "AND A.date <= ".sql_quote(date('Y-m-d H:i:s')) : '';
582 $r = sql_select("DISTINCT A.id_rubrique AS id",
583 "spip_articles AS A LEFT JOIN spip_rubriques AS R ON A.id_rubrique=R.id_rubrique", "R.statut != 'publie' AND A.statut='publie'$postdates");
584 while ($row = sql_fetch($r))
585 publier_branche_rubrique($row['id']);
587 pipeline('trig_calculer_prochain_postdate','');
590 $t = sql_fetsel("date", "spip_articles", "statut='publie' AND date > ".sql_quote(date('Y-m-d H:i:s')), "", "date", "1");
594 ecrire_meta('date_prochain_postdate', strtotime($t));
596 effacer_meta('date_prochain_postdate');
598 spip_log("prochain postdate: $t");
602 * Crée une arborescence de rubrique
604 * creer_rubrique_nommee('truc/machin/chose') va créer
605 * une rubrique truc, une sous-rubrique machin, et une sous-sous-rubrique
606 * chose, sans créer de rubrique si elle existe déjà
607 * à partir de $id_parent (par défaut, à partir de la racine)
609 * NB: cette fonction est très pratique, mais pas utilisée dans le core
610 * pour rester légère elle n'appelle pas calculer_rubriques()
612 * @param string $titre
613 * Titre des rubriques, séparés par des /
614 * @param int $id_parent
615 * Identifiant de la rubrique parente
616 * @param string $serveur
617 * Nom du connecteur à la base de données
619 * Identifiant de la rubrique la plus profonde.
621 function creer_rubrique_nommee($titre, $id_parent=0, $serveur='') {
623 // eclater l'arborescence demandee
624 // echapper les </multi> et autres balises fermantes html
625 $titre = preg_replace(",</([a-z][^>]*)>,ims","<@\\1>",$titre);
626 $arbo = explode('/', preg_replace(',^/,', '', $titre));
627 include_spip('base/abstract_sql');
628 foreach ($arbo as $titre) {
629 // retablir les </multi> et autres balises fermantes html
630 $titre = preg_replace(",<@([a-z][^>]*)>,ims","</\\1>",$titre);
631 $r = sql_getfetsel("id_rubrique", "spip_rubriques", "titre = ".sql_quote($titre)." AND id_parent=".intval($id_parent),
632 $groupby = array(), $orderby = array(), $limit = '', $having = array(), $serveur);
636 $id_rubrique = sql_insertq('spip_rubriques', array(
638 'id_parent' => $id_parent,
640 ,$desc=array(), $serveur);
641 if ($id_parent > 0) {
642 $data = sql_fetsel("id_secteur,lang", "spip_rubriques", "id_rubrique=$id_parent",
643 $groupby = array(), $orderby = array(), $limit = '', $having = array(), $serveur);
644 $id_secteur = $data['id_secteur'];
645 $lang = $data['lang'];
647 $id_secteur = $id_rubrique;
648 $lang = $GLOBALS['meta']['langue_site'];
651 sql_updateq('spip_rubriques', array('id_secteur'=>$id_secteur, "lang"=>$lang), "id_rubrique=$id_rubrique", $desc='', $serveur);
654 $id_parent = $id_rubrique;
658 return intval($id_parent);