Changeset 75126 in spip-zone

Timestamp:

Aug 30, 2013, 3:58:04 PM (6 years ago)

Author:

eric@…

Message:

Modification de la maj02 du schéma.
PHPDoc

Location:

_plugins_/boussole/trunk

Files:

• base/boussole_declarer.php (modified) (3 diffs)
• boussole_administrations.php (modified) (5 diffs)
• boussole_fonctions.php (modified) (1 diff)
• paquet.xml (modified) (1 diff)

_plugins_/boussole/trunk/base/boussole_declarer.php

@@ -1 +1 @@
 <?php
 /**
- * Ce fichier contient les déclarations des tables supplémentaires créées par le plugin.
+ * Ce fichier contient les déclarations des modifications de la base de données requises
+ * par le plugin.
  *
  * @package SPIP\BOUSSOLE\Schema\Declaration
@@ -9 +10 @@
 
 /**
- * Pipeline de déclaration des tables de la base de données SPIP. Le plugin Boussole
- * déclare deux nouvelles tables qui sont :
+ * Pipeline de déclaration des nouvelles tables de la base de données propres au plugin.
+ *
+ * Le plugin déclare deux nouvelles tables qui sont :
  * 
  * - spip_boussoles, qui contient les éléments constitutifs de toutes les boussoles;
@@ -67 +69 @@
 
 /**
- * Pipeline de déclaration des informations tierces sur les tables SQL
- * (alias, traitements, jointures, ...).
+ * Pipeline de déclaration des informations tierces (alias, traitements, jointures, etc)
+ * sur les tables de la base de données modifiées ou ajoutées par le plugin.
  *
- * Le plugin Boussole se contente de déclarer les alias des tables spip_boussoles et
- * spip_boussoles_extra ainsi que des traitements classiques sur les url et les textes.
+ * Le plugin se contente de déclarer les alias des tables qu'il ajoute
+ * ainsi que des traitements classiques sur les url et les textes.
  *
  * @pipeline declarer_tables_interfaces

_plugins_/boussole/trunk/boussole_administrations.php

@@ -12 +12 @@
 /**
  * Installation du schéma de données propre au plugin et gestion des migrations suivant
- * les évolutions.
- *
- * Le schéma comprend des tables en BDD et des variables de configuration
+ * les évolutions du schéma.
+ *
+ * Le schéma comprend des tables en BDD et des variables de configuration.
  *
  * @api
  * @see boussole_declarer_tables_principales()
- * @see declarer_tables_interfaces()
+ * @see boussole_declarer_tables_interfaces()
  *
  * @param string $nom_meta_base_version
@@ -49 +49 @@
         // Pour les autres il faudra de toute façon adapter la boussole avant de les réinstaller
         $maj['0.2'] = array(
-                array('maj_tables', array('spip_boussoles_extras')),
                 array('maj02')
         );
@@ -79 +78 @@
 
 /**
- * Suppression de l'ensemble du schéma de données propre au plugin
+ * Suppression de l'ensemble du schéma de données propre au plugin, c'est-à-dire
+ * les tables et les metas de configuration.
  *
  * @api
@@ -117 +117 @@
  * Migration du schéma 0.1 au 0.2.
  *
- * Suppression des boussoles autres que la boussole spip car on ne peut pas les mettre à jour,
+ * Ajout de la table spip_boussoles_extras et suppression des boussoles autres que
+ * la boussole spip car il n'est pas possible de les mettre à jour,
  * leur serveur n'étant pas connu.
  *
@@ -123 +124 @@
  */
 function maj02() {
+
+        // Ajout de la table
+        maj_tables(array('spip_boussoles_extras'));
+
+        // Suppression des boussoles non "spip"
         include_spip('inc/client');
-
         $akas_boussole = sql_allfetsel('aka_boussole', 'spip_boussoles', array(), 'aka_boussole');
         if ($akas_boussole) {

_plugins_/boussole/trunk/boussole_fonctions.php

@@ -5 +5 @@
 
 /**
+ * Balise retournant les informations sur une boussole.
+ *
  * La balise #BOUSSOLE_INFOS renvoie :
- * - soit le tableau des infos contenues dans la meta boussole_infos_<alias> si l'alias est fourni
- * - soit la liste de tous les tableaux d'infos des meta boussole_infos_xxxx sinon
  *
- * @param string $p     alias de la boussole ou vide
- * @return array        tableau des informations demandees (une boussole ou toutes les boussoles)
+ * - le tableau des infos contenues dans la meta boussole_infos_alias si l'alias est fourni,
+ * - la liste de tous les tableaux d'infos des meta boussole_infos_xxxx sinon.
+ *
+ * @balise boussole_infos
+ *
+ * @param string $p
+ *              alias de la boussole ou vide
+ * @return array
+ *              tableau des informations demandees (une boussole ou toutes les boussoles)
  */
 function balise_BOUSSOLE_INFOS($p) {

_plugins_/boussole/trunk/paquet.xml

@@ -2 +2 @@
         prefix="boussole"
         categorie="navigation"
-        version="2.3.4"
+        version="2.3.5"
         etat="stable"
         compatibilite="[3.0.0;3.0.*]"