Einführung zu zweibarchart 1.3.4

Idee
Vorteile
Nachteil
Rechtliches
Installierung
Zukünftiges

Die Idee

Mach den Balken hoch! Angenommen, Sie möchten auf Ihrer Website einige Daten darstellen. Sie könnten dafür eine Tabelle bauen. Schöner und praktischer wäre aber eine PHP-Funkton, die aus einem Daten-Array oder einer CSV-Datei ohne weitere Konfiguration eine gefällige grafische Darstellung erzeugt.
zweibarchart ist eine solche PHP-Funktion. Mit zweibarchart lassen sich allein mit CSS und HTML auf ganz simple Weise anschauliche Säulendiagramme erzeugen. Mit weiteren Parametern lässt sich die Ausgabe aber auch vielseitig einstellen.

Vorteile

zweibarchart benötigt lediglich die Option, PHP-Skripte auszuführen. Es verwendet keine speziellen Module, keine Frameworks, kein Javascript, GD-Lib, SVG, WebGL, Flash.
zweibarchart erzeugt keine Bildateien. Die Diagrammerzeugung erfolgt allein mit CSS und HTML.
zweibarchart läuft mit jedem einigermaßen modernen Web-Browser, der CSS2 unterstützt. (Internet Explorer: ab Version 6 fehlerfrei)
zweibarchart ist ganz einfach einzubinden: Eine Datei mit der eigentlichen Funktion und eine Datei mit den Style Sheets - mehr nicht.
zweibarchart lässt sich ohne viele Einstellungen verwenden. Vieles passt automatisch. So werden zum Beispiel die Abszisse und die Hilfslinien automatisch skaliert. Parameter, die man nicht benötigt, braucht man nicht anzugeben.
Wer mag, kann zweibarchart mit etlichen Parametern an eigene Vorstellungen anpassen: Farben, Höhe, Breite, Hintergrundmuster, Skalierung, Legende, Mittelwertlinie etc.
Zwei Varianten erlauben die Darstellung von gestapelten und gruppierten Säulen.
zweibarchart ist open source und frei verwendbar.

Nachteil

Damit die Diagramme auch auf Papier schön aussehen, muss der Web-Browser so eingestellt ist, dass er beim Drucken Hintergrundfarben und -Grafik ausgibt.

Rechtliches

Die PHP-Funktion zweibarchart unterliegt der "GNU General Public License":

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, see here.

Sie dürfen den Quellcode von zweibarchart für eigene Zwecke modifizieren unter der Bedingung, dass Sie die Erzeugung des Kommentars  vor jedem Diagramm nicht entfernen. Eine Erwähnung von zweibarchart auf Ihrer Website ist erwünscht.

Die Installierung

zweibarchart ist schnell installiert.

Kopieren Sie die Dateien zbc-function.php und zbc-styles.css in das Verzeichnis des PHP-Scripts, das zweibarchcart verwenden soll.
Fügen Sie am Beginn Ihres PHP-Scripts die Zeile
require ("zbc-function.php");
ein.
Fügen Sie in der <head>-Umgebung Ihres Skripts die Zeile
<link href="zbc-styles.css" rel="stylesheet" type="text/css" />
ein.
Für eine erste Grafik definieren Sie die anzuzeigenden Daten mit
$mydata = array(10, 20, 30, 40, 50);
und erzeugen Sie ein Diagramm mit
zweibarchart($mydata);

zweibarchart is missing css file!

10 0 20 1 30 2 40 3 50 4

5

10

15

20

25

30

35

40

45

50

0
Wenn Sie mehrere Diagramme nebeneinander oder einen Text daneben anordnen möchten (wie auf dieser Seite), fügen Sie zusätzlich in der <head>-Umgebung die Zeile
<link href="zbc-floatstyles.css" rel="stylesheet" type="text/css" />
ein. Dadurch werden die Diagramme links gefloatet. Um einen neuen Absatz zu beginnen, fügen Sie nach dem letzten Diagramm die Zeile
<div class="zbcclear"></div>
ein.
Falls Sie eine Darstellung mit Schatten bevorzugen, fügen Sie zusätzlich in der <head>-Umgebung die Zeile
<link href="zbc-shadowstyles.css" rel="stylesheet" type="text/css" />
ein. Dadurch erhalten die Diagrammrahmen und die Säulen einen Schatten. Hierfür werden CSS3-Attribute verwendet, die mittlerweile von allen modernen Web-Browsern (außer Internet Explorer) dargestellt werden.
Fertig.
Nun können Sie sich die Parameter der Funktion anschauen. Oder Sie probieren mit dem Live-Test aus, was sich mit zweibarchart alles anstellen lässt. Oder sehen Sie sich einige Beispiele an.

Zukünftiges

Den aktuellen Stand der Weiterentwicklung finden Sie im Beta-Bereich. (Die php-Quellen gibt es auf Anfrage.) Kritik und Anregungen sind immer gern gesehen. Wer schreibt mir?

Was geht alles? Es folgen alle Parameter, der Reihe nach erklärt.

zweibarchart is missing css file!