source: spip-zone/_plugins_/fabrique/trunk/fabrique/prefixe_administrations.php.html @ 115409

Last change on this file since 115409 was 100903, checked in by kent1@…, 4 years ago

Respecter les PSR de SPIP

File size: 3.6 KB
Line 
1#PHP
2[(#INCLURE{fond=fabrique/entetes/php,env,
3        description=Fichier gérant l'installation et désinstallation du plugin #ENV{paquet/nom},
4        package=Installation})]
5
6
7/**
8 * Fonction d'installation et de mise à jour du plugin #ENV{paquet/nom}.[
9 *
10 * Vous pouvez :
11 *
12 * - créer la structure SQL,
13 * - insérer du pre-contenu,
14 * - installer des valeurs de configuration,
15 * - mettre à jour la structure SQL(#EXEMPLES|oui)]
16 *
17 * @param string $nom_meta_base_version
18 *     Nom de la meta informant de la version du schéma de données du plugin installé dans SPIP
19 * @param string $version_cible
20 *     Version du schéma de données dans ce plugin (déclaré dans paquet.xml)
21 * @return void
22**/
23function #ENV{prefixe}_upgrade($nom_meta_base_version, $version_cible) {
24        $maj = array();<BOUCLE_si_exemples(CONDITION){si #EXEMPLES}>
25        # quelques exemples
26        # (que vous pouvez supprimer !)
27        #
28        # $maj['create'] = array(array('creer_base'));
29        #
30        # include_spip('inc/config')
31        # $maj['create'] = array(
32        #       array('maj_tables', array('spip_xx', 'spip_xx_liens')),
33        #       array('ecrire_config', '#ENV{prefixe}', array('exemple' => "Texte de l'exemple"))
34        #);
35        #
36        # $maj['1.1.0']  = array(array('sql_alter','TABLE spip_xx RENAME TO spip_yy'));
37        # $maj['1.2.0']  = array(array('sql_alter','TABLE spip_xx DROP COLUMN id_auteur'));
38        # $maj['1.3.0']  = array(
39        #       array('sql_alter','TABLE spip_xx CHANGE numero numero int(11) default 0 NOT NULL'),
40        #       array('sql_alter','TABLE spip_xx CHANGE texte petit_texte mediumtext NOT NULL default \'\''),
41        # );
42        # ...</BOUCLE_si_exemples>
43<BOUCLE_si_objets(CONDITION){si #OBJETS}>
44        $maj['create'] = array(array('maj_tables', [(#LES_TABLES|ecrire_tableau)]));[
45(#ENV*{paquet/inserer/administrations/maj}|fabrique_tabulations{1})]
46</BOUCLE_si_objets>
47        include_spip('base/upgrade');
48        maj_plugin($nom_meta_base_version, $version_cible, $maj);
49}
50
51
52/**
53 * Fonction de désinstallation du plugin #ENV{paquet/nom}.[
54 *
55 * Vous devez :
56 *
57 * - nettoyer toutes les données ajoutées par le plugin et son utilisation
58 * - supprimer les tables et les champs créés par le plugin.(#EXEMPLES|oui)]
59 *
60 * @param string $nom_meta_base_version
61 *     Nom de la meta informant de la version du schéma de données du plugin installé dans SPIP
62 * @return void
63**/
64function #ENV{prefixe}_vider_tables($nom_meta_base_version) {<BOUCLE_si_exemples2(CONDITION){si #EXEMPLES}>
65        # quelques exemples
66        # (que vous pouvez supprimer !)
67        # sql_drop_table('spip_xx');
68        # sql_drop_table('spip_xx_liens');</BOUCLE_si_exemples2>
69<BOUCLE_tables(DATA) {si #OBJETS} {source tableau,#LES_TABLES}>
70        sql_drop_table('#VALEUR');</BOUCLE_tables>
71<BOUCLE_objets_autres_nettoyages(CONDITION){si #OBJETS}>
72        # Nettoyer les liens courants (le génie optimiser_base_disparus se chargera de nettoyer toutes les tables de liens)
73        [(#VAL{"sql_delete('spip_documents_liens',"}   )] sql_in('objet', [(#LES_TYPES|ecrire_tableau)]));
74        [(#VAL{"sql_delete('spip_mots_liens',"}        )] sql_in('objet', [(#LES_TYPES|ecrire_tableau)]));
75        [(#VAL{"sql_delete('spip_auteurs_liens',"}     )] sql_in('objet', [(#LES_TYPES|ecrire_tableau)]));
76        # Nettoyer les versionnages et forums
77        [(#VAL{"sql_delete('spip_versions',"}          )] sql_in('objet', [(#LES_TYPES|ecrire_tableau)]));
78        [(#VAL{"sql_delete('spip_versions_fragments',"})] sql_in('objet', [(#LES_TYPES|ecrire_tableau)]));
79        [(#VAL{"sql_delete('spip_forum',"}             )] sql_in('objet', [(#LES_TYPES|ecrire_tableau)]));
80</BOUCLE_objets_autres_nettoyages>[
81(#ENV*{paquet/inserer/administrations/desinstallation}|fabrique_tabulations{1})]
82        effacer_meta($nom_meta_base_version);
83}
84
85[
86
87
88(#ENV*{paquet/inserer/administrations/fin})
89]
Note: See TracBrowser for help on using the repository browser.