| 60 |
jpm |
1 |
I. Installation
|
|
|
2 |
II. Configuration
|
|
|
3 |
III. Utilisation
|
|
|
4 |
IV. Divers
|
|
|
5 |
|
|
|
6 |
|
|
|
7 |
I. Installation
|
|
|
8 |
------------
|
|
|
9 |
|
|
|
10 |
*** Première installation ***
|
|
|
11 |
|
|
|
12 |
L'installation de Artichow se résume à décompresser l'archive dans le dossier
|
|
|
13 |
de votre choix sur votre serveur. Veillez simplement à télécharger l'archive
|
|
|
14 |
dont vous avez vraiment besoin (PHP 5 ou PHP 4 & 5).
|
|
|
15 |
Notez que Artichow requiert GD 2 et PHP 4.3.0 au minimum pour fonctionner.
|
|
|
16 |
|
|
|
17 |
*** Mise à jour ***
|
|
|
18 |
|
|
|
19 |
Lorsque vous souhaitez mettre à jour Artichow avec la dernière version,
|
|
|
20 |
essayez de suivre pas à pas ces étapes :
|
|
|
21 |
1) Décompressez la dernière version de Artichow dans un dossier
|
|
|
22 |
2) Ecrasez le fichier Artichow.cfg.php avec votre ancien fichier
|
|
|
23 |
3) Copiez vos patterns dans le dossier patterns/ de la nouvelle version
|
|
|
24 |
4) Supprimez l'ancienne version de Artichow de votre disque
|
|
|
25 |
5) Copiez la nouvelle version là où était l'ancienne
|
|
|
26 |
Une fois ces cinq étapes effectuées, vous n'aurez plus qu'à mettre
|
|
|
27 |
éventuellement à jour vos graphiques, en fonction des dernières évolutions de
|
|
|
28 |
l'API de Artichow. Pour cela, voyez le titre "Migrer d'une version à l'autre"
|
|
|
29 |
sur la page :
|
|
|
30 |
http://www.artichow.org/documentation
|
|
|
31 |
|
|
|
32 |
II. Configuration
|
|
|
33 |
-------------
|
|
|
34 |
|
|
|
35 |
Même si une utilisation normale de Artichow ne nécessite pas de configuration
|
|
|
36 |
particulière, il existe un fichier Artichow.cfg.php qui permet de modifier
|
|
|
37 |
quelques paramètres de la librairie.
|
|
|
38 |
Vous pouvez notamment configurer le répertoire vers les polices de caractère
|
|
|
39 |
en modifiant la constante ARTICHOW_FONT (par exemple en choisissant
|
|
|
40 |
'c:\Windows\font' si vous êtes sous Windows).
|
|
|
41 |
Vous pouvez également redéfinir la variable $fonts. Cette variable contient une
|
|
|
42 |
liste de polices TTF (sans l'extension) présentes dans votre répertoire
|
|
|
43 |
ARTICHOW_FONT. Pour toutes les polices de cette liste, une classe du même nom
|
|
|
44 |
est créée. Les polices ainsi définies peuvent ensuite être utilisées de cette
|
|
|
45 |
manière :
|
|
|
46 |
<?php
|
|
|
47 |
$font = new Verdana(12); // 12 représente la taille en points
|
|
|
48 |
?>
|
|
|
49 |
Il existe également une constante ARTICHOW_DEPRECATED. Si cette constante vaut
|
|
|
50 |
TRUE, alors un message d'erreur sera affiché lorsque vous utiliserez une
|
|
|
51 |
fonctionnalité dépréciée de Artichow. A l'inverse, avec la valeur FALSE,
|
|
|
52 |
vous pourrez continuer à utiliser les fonctions dépréciées sans soucis.
|
|
|
53 |
Cependant, dans un souci de compatibilité, il est préférable de mettre à
|
|
|
54 |
jour vos graphiques dès lors qu'un message de ce type apparaît (et donc de
|
|
|
55 |
laisser la constante à TRUE). Les fonctionnalités dépréciées sont toujours
|
|
|
56 |
potentiellement susceptibles de disparaître d'une version à l'autre de la
|
|
|
57 |
librairie.
|
|
|
58 |
La constante ARTICHOW_PREFIX est vide par défaut et correspond à un préfixe qui
|
|
|
59 |
est ajouté au nom de chaque classe utilisée sur Artichow. Certains noms de
|
|
|
60 |
classe (Graph, Image, Text, Font, etc.) sont utilisés par d'autres librairies
|
|
|
61 |
et cela peut aboutir à des conflits. Pour résoudre ce problème, choisissez par
|
|
|
62 |
exemple 'xyz' comme préfixe et toutes les classes de Artichow s'appèleront
|
|
|
63 |
désormais xyz[Nom normal]. Exemple d'utilisation de Artichow avec
|
|
|
64 |
ARTICHOW_PREFIX à 'xyz' :
|
|
|
65 |
<?php
|
|
|
66 |
require_once "Artichow/LinePlot.class.php";
|
|
|
67 |
|
|
|
68 |
$plot = new xyzLinePlot(array(1, 2, 3));
|
|
|
69 |
$plot->title->set('Mon graphique');
|
|
|
70 |
$plot->title->setFont(new xyzFont4);
|
|
|
71 |
|
|
|
72 |
$graph = new xyzGraph(400, 300);
|
|
|
73 |
$graph->add($plot);
|
|
|
74 |
$graph->draw();
|
|
|
75 |
?>
|
|
|
76 |
|
|
|
77 |
|
|
|
78 |
III. Utilisation
|
|
|
79 |
-----------
|
|
|
80 |
|
|
|
81 |
Si vous utilisez la version conçue exclusivement pour PHP 5, vous pouvez vous
|
|
|
82 |
référer aux exemples et aux tutoriels afin de bien prendre en main la
|
|
|
83 |
librairie.
|
|
|
84 |
Si vous utilisez la version pour PHP 4 & 5, référez vous également aux exemples
|
|
|
85 |
et tutoriels mais faîtes attention lors de l'inclusion des fichiers de
|
|
|
86 |
Artichow. N'incluez pas les fichiers de cette manière :
|
|
|
87 |
<?php
|
|
|
88 |
// Ceci ne fonctionnera pas
|
|
|
89 |
require_once "Artichow/php5/LinePlot.class.php";
|
|
|
90 |
// Cela non plus
|
|
|
91 |
require_once "Artichow/php4/LinePlot.class.php";
|
|
|
92 |
?>
|
|
|
93 |
Préférez plutôt :
|
|
|
94 |
<?php
|
|
|
95 |
// Fonctionnera correctement
|
|
|
96 |
require_once "Artichow/LinePlot.class.php";
|
|
|
97 |
?>
|
|
|
98 |
C'est la librairie qui se charge de sélectionner les bons fichiers en fonction
|
|
|
99 |
de la version de PHP dont vous disposez.
|
|
|
100 |
|
|
|
101 |
IV. Divers
|
|
|
102 |
------
|
|
|
103 |
|
|
|
104 |
La documentation de Artichow est disponible sur :
|
|
|
105 |
http://www.artichow.org/documentation
|
|
|
106 |
|
|
|
107 |
Des tutoriels sont accessibles sur :
|
|
|
108 |
http://www.artichow.org/tutorial
|
|
|
109 |
|
|
|
110 |
Un forum de support peut être trouvé sur :
|
|
|
111 |
http://www.artichow.org/forum/
|
|
|
112 |
|
|
|
113 |
N'oubliez pas que Artichow est dans le domaine public. Vous pouvez donc faire
|
|
|
114 |
CE QUE VOUS SOUHAITEZ avec cette librairie, y compris ajouter votre nom dans
|
|
|
115 |
chaque fichier, et la redistribuer ainsi.
|
|
|
116 |
|
|
|
117 |
Si vous souhaitez aider et participer au développement de Artichow, n'hésitez
|
|
|
118 |
pas à consulter cette page :
|
|
|
119 |
http://www.artichow.org/help
|
|
|
120 |
|