JPGraph

Un article de Typo3 CMS / Documentation Typo3 / Support Typo3.

JPGraph

Clé d'extension : jpgraph Copyright 2002-2002, ingmars@web.de, <ingmars@wab.de>

Ce document est publié sous licence Open Content disponible sur http://www.opencontent.org/opl.shtml

Le contenu de ce document est relatif à TYPO3 -Gnu/GPL CMS/Framework disponible sur www.typo3.com

[modifier] Introduction

[modifier] A quoi ça sert ?

L'extension JPGraph offre le moyen de créer des graphiques aussi simplement que de créer un élément de contenu de texte normal ! Cela est basé sur la bibliothèque JPGraph.

[modifier] Photos d'écran

[modifier] Manuel de l'utilisateur

Cliquez sur 'Créer un nouvel enregistrement' (create new record) (Module page ou liste)
Choisissez le wizard

Choisissez 'JPGraph chart' et la position dans laquelle vous souhaitez qu'apparaisse le diagramme.

Maintenant un écran comme ceci s'affiche à vous :

1. Type de diagramme. Cliquez sur les icônes pour choisir le type de votre graphique.
2. Simplement le texte qui deviendra un sous-titre
3. Valeurs, liste à virgules. Entrez ici les données sur lesquels se base le plan.
Exemple : - 12, 24, 40, 100
4. Valeurs secondaires. Comme 'Valeurs, liste à virgules' mais uniquement utilisé pour les graphiques combinés. Si vous n'utilisez qu'un plan simple, vous n'avez pas besoin de cela.
5. La liste de virgule, d'étiquettes, est du texte lié à chacune des valeurs de données.</br> Exemple : - 2002, 2003 etc. ou Peter, Martin, Jean.
6. La Hauteur, Largeur est la taille de votre graphique en pixels.
7. Vous pouvez ici configurer une image de fond pour votre graphique. J'ai expérimenté des problèmes avec les images GIF, mais je pense que cela dépend du GDLib que vous avez installé.
8. Couleur Primaire/Secondaire sont juste les deux couleurs utilisées par votre graphique. Malheureusement le matériel de disposition n'est pas encore bien réalisé pour le moment, attendez une futur version de cette extension ...
Cliquez sur le bouton 'Sauvegardez et voir'. Maintenant votre Frontend devrait faire apparaître le graphique.

[modifier] Configuration

[modifier] Références

  10 = PLOT
  10.type = line
  10.xdata = 12,24,36,50,112

[tsref:plugin.tx_jpgraph_pi1]

plotObject

[tsref:plugin.tx_jpgraph_pi1.plot]

Exemple : Voici comment créer un graphique via TypoScript :

  page = PAGE
  page.typeNum = 0
  page.10 < plugin.tx_jpgraph
  page.10 {
    colors = yellow,#FF2236
    type = line
    10 = PLOT
    10 {
      type = line
      xdata = 12,24,40,50
    }
  }

Si vous désirez créer un graphique combiné (consistant en deux plans ou plus) ajoutez simplement le(s) plan(s) comme ceci :

  page = PAGE
  page.typeNum = 0
  page.10 < plugin.tx_jpgraph
  page.10 {
    colors = yellow,#FF2236
    type = line
    10 = PLOT
    10 {
      type = line
      xdata = 12,24,40,50
    }
    20 = PLOT
    20 {
      type = bar
      colors = green,red
      xdata = 32,35,39,33
    }
  }

[modifier] Question de Licence :

La bibliothèque de JPGraph sur laquelle cette extension est basée possède une licence sous une licence double. Lisez l'état de la licence sur le site web JPGraph: JpGraph est sortie sous licence double. QPL 1.0 (Qt Free Licensee) Pour le non-commercial, open-source et utilisation pour l'éducation et JpGraph Professional License pour l'utilisation commercial. Cela veux dire, de façon basique, que si vous ou votre compagnie développez des logiciels non open source et avez des gains financier, que ce soit directement ou indirectement (par exemple en améliorant un processus d'affaires), en utilisant JPGraph cela compte comme une utilisation commercial. La version professionnelle inclus aussi des fonctionnalités additionnelles, par exemple cela vous laissera faire la generation de codes barres avec JpGraph. L'extension de codes barres supporte tout les symboles utilisés communément (comme le code 39, 2 ou 5, EAN 13 et ainsi de suite). Il inclus aussi des plans Polaires avancés.

Pour être sur de cela j'ai demandé au développeur de JPGraph si chaque personne ou compagnie à la permission d'UTILISER mon extension incluant leur bibliothèque pour TOUT but (commercial ou tout autre) et il m'a assuré que cela n'était pas interdit par leur licence.

Donc vous AVEZ LE DROIT d'utiliser cette extension dans un but financier.

[modifier] Problèmes connus

Il n'y a aucun problème connu. Prévenez nous, s'il vous plait, de tout problème que vous rencontreriez, ingmars@web.de.

[modifier] Choses à faire

Ajouter beaucoup de propriétés au PLOTObject. Faire tout les boutons du plan via TypoScript, pas à l'intérieur de pi1-class.

[modifier] Liste des changements

5.3.2003 Toute première sortie de l'extension. Malheureusement je n'ai pas pu l'uploader sur typo3.org à cause de quelque erreur gzuncompress sur typo3.org, s'avérant être causé par un simple drapeau 'privé' dans l'extension... 4.6.2003 Première sortie publique sur typo3.org 3.8.2003 Correction importante de l'explication de la licence.