[Sommaire] [Imprimer]

   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