source: plugins_spip/terraeco_infographie/trunk/README.md @ 7958

Last change on this file since 7958 was 7958, checked in by kent1, 7 years ago

On complète les explications sur les tables, on va pouvoir commencer à bosser sur l'imports de données

File size: 3.7 KB
Line 
1# Terraeco Infographies
2
3Le site de texte est [terraeco.arscenic.org](http://terraeco.arscenic.org)
4
5## Description technique
6
7### Tables sql
8
9Quatre tables SQL sont créées en utilisant les pipelines de l'API de création d'objets de SPIP. Elles peuvent donc êtres modifiées facilement.
10
11* **spip_infographies**
12
13  Cette table définit les différentes infographies (du coup on peut en avoir plusieurs différentes).
14 
15  Cette table est définie comme éditable dans l'API, on peut donc accéder aux pages :
16  * *ecrire/?exec=infographies* listant toutes les infographies
17  * *ecrire/?exec=infographie_edit&new=oui* permettant de créer une nouvelle infographie
18  * *ecrire/?exec=infographie&id_infographie=1* affichant le contenu d'une infographie dans l'espace privé.
19 
20  Ses informations sont définies sous la forme :
21  * *id_infographie* : l'identifiant numérique de l'infographie
22  * *titre* : le titre de l'infographie
23  * *texte* : le texte de l'infographie
24  * *credits* : les crédits de l'infographie
25  * *date* : la date de l'infographie
26  * *statut* : le statut de l'infographie (statuts similaires aux articles)
27  * *maj* : la date de mise à jour
28 
29* **spip_infographies_datas**
30
31  Table définissant les jeux de données liés à une infographie ou plusieurs infographies (On utilise la table spip_infographies_datas_liens pour faire les liens entre jeux de données et infographies).
32
33  Cette table est définie comme éditable dans l'API, on peut donc accéder aux pages :
34  * *ecrire/?exec=infographies_datas* listant tous les jeux de données
35  * *ecrire/?exec=infographies_data_edit&new=oui* permettant de créer un nouveau jeu de données
36  * *ecrire/?exec=infographies_data&id_infographies_data=1* affichant le contenu d'un jeu de données dans l'espace privé.
37 
38  Ses informations sont définies sous la forme :
39  * *id_infographies_data* : l'identifiant numérique du jeu de donnée
40  * *titre* : le titre du jeu de donnée
41  * *texte* : le texte du jeu de donnée
42  * *credits* : les crédits du jeu de donnée
43  * *type* : le type du jeu de donnée
44  * *url* : URL distante du jeu de donnée si externe
45  * *date* : la date du jeu de donnée
46  * *maj* : la date de mise à jour
47 
48
49* **spip_infographies_donnees**
50
51  Table définissant les données en base liées à un jeu de donnée.
52 
53  Cette table est indiquée dans l'API comme non éditable, elle ne dispose donc pas de page d'édition spécifique.
54  Les données s'éditent depuis la page de l'infographie.
55 
56  Chaque ligne se présente sous la forme :
57  * *id_infographies_donnee* : l'identifiant numérique de la donnée
58  * *id_infographies_data* : à quelle infographie est liée cette donnée
59  * *rang* : la place de la donnée dans le jeu
60  * *axe_x* : valeur de cette donnée sur l'axe X
61  * *axe_y* : valeur de cette donnée sur l'axe Y
62  * *commentaire* : un commentaire qui peut être utilisé ensuite dans l'infographie
63  * *date* : date de la donnée
64  * *maj* : date de mise à jour de la donnée
65
66
67* **spip_infographies_datas_liens**
68
69  Table de jointures pour les jeux de données.
70  Les jeux de données pouvant être liés à plusieurs infographies différentes par exemple.
71 
72  Elle est composée des champs suivants :
73  * *id_infographies_data* : l'identifiant numérique du jeu de données lié
74  * *id_objet* : l'identifiant numérique de l'objet lié
75  * *objet* : le type d'objet lié
76
77
78### Formulaires
79
80#### Formulaire d'édition d'infographie
81
82Le formulaire d'édition d'infographie permet de modifier son titre, son texte et les crédits associés.
83
84On l'appelle comme ceci :
85
86        [(#FORMULAIRE_EDITER_INFOGRAPHIE{#ID_INFOGRAPHIE,#ENV{redirect}})]
87
88
89### Javascript
90
91Le plugin utilise la librairie [d3.js](http://d3js.org/) pour les représentations graphiques.
92
93### ModÚles
94 
95## Utilisation
96
97
Note: See TracBrowser for help on using the repository browser.