Aktuell sind 226 Gäste und keine Mitglieder online
RGraph ist schnell, attraktiv, einfach zu bedienen und kostenlos für den kommerziellen Gebrauch. Die Unterstützung für Desktop- und mobile Canvas-Elemente ist hervorragend und ermöglicht die Erstellung von Diagrammen und Dashboards, die Sie auf einer Vielzahl von Geräten verwenden können. Dank des schnellen Renderns des Canvas-Tags können Ihre Diagramme bis zu 10-mal schneller sein als Flash- oder SVG-basierte Bibliotheken. Dies bedeutet, dass Sie gut aussehende und informative Diagramme und Dashboards erstellen können.
Hauptzweck von Diagrammen ist die Visualisierung von Daten. Mit php-RGraph erhalten Sie alle Funktionen zum Abrufen und Verwenden von Daten aus mySql-Datenbanken, aus lokalen Dateien, Daten von Remote- oder lokalen Servern, aus CSV-Dateien und sogar aus Google-Tabellen.
Um diese Daten zu visualisieren, "kennt" php-RGraph etwa 580 verschiedene Diagrammeigenschaften für alle Diagramme, die RGraph angeboten hat, und verwendet dieses Wissen, um eine stabile Schnittstelle zu den Javascript-Bibliotheken von RGraph aufzubauen. Die aktuelle (diese) Version von php-RGraph basiert auf der Version V6.16 von RGraph.
Diese Anleitung soll Ihnen helfen, die Struktur von php-RGraph zu verstehen und Ihnen einige Informationen und Ratschläge zur Verwendung von php-RGraph auf Ihrer Website geben.
Dieser Guide hat vier AbschnitteMit RGraph erstellen Sie Diagramme, indem Sie Javascript-Code schreiben, wohingegen sie mit php-RGraph Ihre Diagrammobjekte nur mit PHP kodieren. Wir werden nun Schritt für Schritt zeigen, was zu tun ist, damit eine Anwendung mit php-RGraph auf Ihrer Site ausgeführt werden kann.
Überprüfen Sie dann, ob Sie über folgende URL auf die Dokumentation von php-RGraph zugreifen können:
http://your-host/ihr-installations-verszeichnis/RGraph/index.html.
Wenn dies in Ordnung ist, können Sie die Referenz von RGraph lesen und die bereitgestellten Beispiele einsetzen oder testen.
<?php // php-Rgraph root directory $rgraph_root = "/ihr-installations-verzeichnis/RGraph"; // php-Rgraph library $lib = $_SERVER['DOCUMENT_ROOT'] . $rgraph_root . "/lib/rgraph_chart.php"; if (!file_exists($lib)) die ("Error: $lib not found"); require_once ($lib); // directory for templates $templates = $_SERVER['DOCUMENT_ROOT'] . $rgraph_root . "/templates/"; if (!file_exists($templates)) die ("Error: $templates not found"); // directory for RGraphs's javascript library $rgraph_libraries = $rgraph_root . "/libraries/"; // (optional) directory for Utilities $utility = $_SERVER['DOCUMENT_ROOT'] . $rgraph_root . '/lib/util.php';
include_once "environment.php"; use phpRGraph\rgraph_chart; use phpRGraph\rgraph_options;
$template = "default.php"; $draw_option = "draw();"; $width = "500"; $height = "350";
$chart = new rgraph_chart($id, $data, $chart_type);
$options = new rgraph_options($ini-file); $options->set_option("title", "Mein erstes Diagramm"); ...
php-RGraph "kennt" mehr als 500 verschiedene Diagrammeigenschaften für fast alle von RGraph angebotenen Diagramme. Die php-Klasse rgraph_options verfügt über verschiedene Methoden, die Sie bei der Bereitstellung von Diagrammeigenschaften unterstützen. Weitere Informationen finden Sie im Referenzhandbuch, in den Beispielen oder besuchen sie die Homepage von RGraph.
$chart->set_options($options); $rgraph_json = $chart->toPrettyString();
include_once ($templates . $template);
Die Template-Header-Datei enthält reinen PHP-Code. Dieser Code wird zur Überprüfung und Einstellung der benötigten Variablen verwendet. Template-Header-Dateien sind meist gleich in ihrer Funktionalität und können deshalb in den meisten Templates Body Dateien verwendet werden.
<?php
// check settings
if (! isset($chart))
die ("Error: rgraph_chart object not defined");
if (! isset($rgraph_json))
die ("Error: json object is not defined");
$id = $chart->get_id();
$chart_type = $chart->get_chartType();
$script= '<script src="' . $rgraph_libraries . $chart->getScript($chart_type) . '">';
echo $script;
// check for defined values
if (! isset($width))
$width = 400;
if (! isset($height))
$height = 250;
if (! isset($draw_option))
$draw_option = "draw();";
if (! isset($canvas_style))
$canvas_style = "";
if (! isset($canvas_class))
$canvas_class = "";
if (! isset($chart_name))
$chart_name = "chart";
if (! isset($event_script))
$event_script = "";
if (! isset($chart_script))
$chart_script = "";
Template body Dateien enthalten HTML- und PHP-Code. Dieser Code wird verwendet, um die erforderlichen Werte für Skript- und HTML-Tags zu erstellen. Schauen Sie sich "default.php" an, das in den meisten Beispielen verwendet wird
<?php <?php include_once "default_header.php"; ?> <canvas id="<?php echo $id; ?>" width="<?php echo $width; ?>" height="<?php echo $height; ?>" style=" <?php echo $canvas_style; ?>" class="<?php echo $canvas_class; ?>"> [No canvas support]> </canvas> <script> jQuery(document).ready(function() { <?php echo $event_script; ?> RGraph.reset('<?php echo $id; ?>'); var <?php echo $chart_name; ?> = new RGraph.<?php echo $chart_type; ?> ( <?php echo $rgraph_json; ?>).<?php echo $draw_option; ?> <?php echo $chart_script; ?> }); </script>
Ich habe den gesamten PHP-Code grün markiert - das haben Sie vielleicht bemerkt Die meisten Variablen wurden von dem Diagrammskript definiert.
Die rot markierte include-datei, "default_header.php" wurde verwendet um Standardeinstellungen für fehlende Variablen festzulegen (z. B. für "$ chart_name", "event_script" oder "canvas_style").
<script src="/../js/jquery.min.js" type="text/javascript"> <script src="/../libraries/RGraph.common.lib.js" type="text/javascript">
<script type="text/javascript"> jQuery(document).ready(function() { var url = "../samples/logo.php"; jQuery("#show-sample").load( url, function() { }); }); </script>
<div id="show-sample" style="float:right"></div>
Sie können Diagramme aber auch interaktiv mit jQuery.load anzeigen. Wenn Sie auf folgenden Link klicken, werden Sie eine Anzeige von einem Meter-Diagramm auslösen. Das Original Balkendiagramm wird dann das durch das Meter-Diagramm ersetzt werden. Wie habe ich das gemacht? Ich habe nur einen kleinen Codeteil hinzugefügt: Mit dem HTML-<a>-Tag für den Link habe ich ein "onlick" -Attribut hinzugefügt, um das Skript "show_chart ()" auszulösen. Dieses Skript wurde dem Skript-Tag hinzugefügt:
function show_chart() {
var url = "../samples/meter.php";
jQuery("#show-sample" ).load( url, function() {
});
}
Bei Joomla gibt es keine besonderen Überlegungen. Sie fügen Diagramme mit jQuery.load hinzu. Nachdem Sie Ihre php-Diagrammscripte erstellt haben, müssen Sie nur noch html-Script-Tags für die Funktion jQuery.load und div-Elemente zum Inhalt Ihres Artikels hinzufügen. Vergessen Sie nicht, geeignete RGraph-Javascript-Bibliotheken für den Typ und die Eigenschaften Ihres Diagramms hinzuzufügen. Sie sollten die angepasste Bibliothek "RGraph.common.lib.js" von php-RGraph hinzufügen - z. B.:
<script src="/../libraries/RGraph.common.libs.js" type="text/javascript">
Die einfachste Möglichkeit, php-RGraph zu verwenden, besteht darin, php-rgraph für Joomla zu installieren und zu verwenden. Dies ist ein Inhalts-Plugin, das auf php-RGraph basiert und es Ihnen ermöglicht, Diagramme zu erstellen, ohne in HTML oder PHP codieren zu müssen.
Wenn Sie meine Joomla-Erweiterung "jphpx" installiert haben, können Sie Ihren php-RGraph-Skriptcode mithilfe von jphpx in einen Artikel einfügen Plugin-Funktion, z.B:{jphpx [php-apps/RGraph/samples_jphpx/bar_simple.php]}
Um weitere Informationen neben den hier gezeigten Referenzen zu erhalten, schauen Sie sich meine Beispiele an oder besuchen Sie die Homepage von RGraph.
Wählen Sie eine Methode aus
$options = new rgraph_options(); $options->set_option("name", "wert");Anschließend legen (definieren) Sie die Diagrammeigenschaften für das Objekt "rgraph_chart" fest:
$chart->set_options($options);
Um weitere Informationen neben den hier gezeigten Referenzen zu erhalten, schauen Sie sich meine Beispiele an oder besuchen Sie die Homepage von RGraph.
Wählen Sie eine Methode aus
Das Javascript Framework von RGraph hat eine Vielzahl von Konfiguration Optionen für die verschieden Diagrammarten. php-RGraph unterstützt nun ca. 580 einzelne Atrribute. Diese Vielzahl von Optionen emöglicht größte Flexibilität der Konfiguration für ihre Diagramme. Glücklicherweise haben die meisten einen sinnvollen Default, sodass man nicht wegen ihrer schieren Zahl den Überblick verliert oder abgeschreckt wird.
Neben dieser Referenz und den Beispielen, die hier gezeigt werden, sollte man auch die Informationen, die über die Dokumentationen von RGraph angeboten werden, anschauen und beachten.
php-RGraph ist freie Software - Sie müssen jedoch die GPL-Lizenzbedingungen einhalten, um sie verwenden zu können. Weitere Informationen zu GPL und freier Software finden Sie unter GNU Org .
Um php-RGraph herunterzuladen, klicken Sie bitte auf den Download-Button:
Version 2.1.18 (Build Level 2.1.18.1 - 22. Januar 2024)
Part of the provided examples here are based upon the samples shown on RGraph's Demo Site.