FlashChart Version 1.3.4 für Joomla

Parameter

Beschreibung und Referenz aller unterstützten Parameter

Es ist nicht notwendig viele der unterstützten Parameter (mit diesem Release sind es nun 85(!) Optionen) für ein Diagramm zu spezifizieren, aber einige sind sehr nützlich und ergeben ein attraktiveres und informativeres Erscheinungsbild Ihres Flash Objektes. Einige der Parameter werden auch mit Beispielen illustriert - schauen Sie sich diese doch mal an.

Parameter auswählen:   alert_color - Farben für Alerts alert_value - Alert Wert setzen alert_tooltip - tooltip für Alerts alert_onclick - Aktionen für Alert values allow_formula - Erzeugung von Diagrammdaten via Formel erlauben alpha - setzt die Transparenz von Diagrammen axis_3d - 3d Form für die x-Achse axis_legend_style - CSS-Stil für Achsenlegenden bar_animation - Animation für Säulendiagramme bg_color - Hintergrund Farbe bg_image - Image (Bild) als Hintergrund chart_colors - Farben für Diagramme create_image - Konvertierung als Image ermöglichen create_popup - ein popup window erzeugen create_script - Javascript für Click-Events erstellen data - Diagrammdaten definieren dbname - MySql Datenbankname dbhost - Host der der MySql Datenbank dbuser - Userid der MySql Datenbank dbpassword - Passwort für MySql Datenbank display_as_image - Diagramm als Bild dimension - Zeichen an Labels anfügen file - File-Namen angeben flashchart_jquery - Einsatz JQuery Script-Library flashchart_shadowbox - Einsatz Shadowbox Script-Library force_create_popup - popup window neu erstellen formula - mathematische Formel für das Erzeugen von Diagrammdaten grid_color - Farbe des Gitternetzes height - Höhe des Diagramms hide_chart - Diagramm nicht anzeigen hide_pie_labels - Label von Kreisdiagramm "verstecken" key_onclick - Aktionen auf Click-Events für Legenden label_color - Farbe für Label label_fontsize - Schriftgröße für Labels legend - Legendeninhalte definieren legend_fontsize - Schriftgröße für Legenden line_animation - Animation für Liniendiagramme log_scaley - logarithmische Skalierung der y-Achse menu - Diagramm-Menü modal_chart - Diagramm in Popup Fenster anzeigen modal_title - Titel für ein Popup Fenster multibar_color - verschiedene Farben für Säulendiagramm number_format - Zahlenformat OFC Schnittstelle definieren onclick - definiert Aktionen auf click events pie_animation - Animation für Kreisdiagramme pie_label_values - Labelwerte bei Kreisdiagrammen pie_legend - Legende für Kreisdiagramme pie_radius - Radius von Kreisdiagrammen precision - Kommastellen für die Anzeige von Daten radar_axis_labels - Label für Radardiagramm radar_spoke_labels - Achsenlabel für Radardiagramm rearrange_data - Daten für "bar_stack" anordnen revert_x_range - x-Werte in umgekehrter Reihenfolge revert_y_range - y-Werte in umgekehrter Reihenfolge right_legend - rechte Legendenposition scatter_animation - Animation für Streudiagramme show_barvalues - Werte bei Säulendiagramm anzeigen show_linevalues - Werte bei Liniendiagrammen anzeigen show_regression_formula - Regressionsfunktion anzeigen show_regression_line - Regressionslinie anzeigen show_trend - Trendlinie anzeigen sql - sql (query) Anweisung sql_labels - Verarbeitung der Datenabfrage modifizieren tag_style - CSS Stil für die Anzeige von Diagrammdaten target_line - Anzeige einer Ziel-Linie target_linecolor - Farbe der Ziel-Linie title - Titel des Diagramms title_style - CSS Stil für Diagrammtitel tooltip - Tooltip definieren tooltip_style - CSS Stil für tooltips type - Diagrammtype url - url eines lokalen oder entfernten Webservers Variablen ersetzen width - Breite von Diagrammen x_axis_color - Farbe für die x-Achse x_axis_labels - Label der x-Achse x_axis_steps - Anzeigeoption der x-Achse x_interval - Interval (Inkrement) für Berechnungen aus Formel x_label_rotate - Label der x-Achse drehen x_label_truncate - Länge der Label verkürzen x_legend - Legende für die x-Achse x_max - Maximaler Wert der x-Achse x_min - Minimaler Wert der x-Achse x_step - Anzeigeoption der x-Achse y_axis_color - Farbe für der y-Achse y_label_color - Farbe für der labels der y-Achse y_legend - Legende für die y-Achse y_max - Maximaler Wert der y-Achse y_min - Minimaler Wert der y-Achse y_step - Anzeigeoption der y-Achse

Neues

Release 1.3.4

Code wurde überarbeitet und für Joomla Version 4 angepasst und unter Joomal v4.0 Beta3 erfolgreich getestet.
Wichtig! Mit Build-level 1.3.4.1 wurden die gesamten Medien (Javascripts, Images, Stylesheets) in das
Verzeichnis "/media/plg_content_flashchart" verlagert.

Release 1.3.3

Release 1.3.3 ist eine aktualisierte Version von Release 1.3.2. Wesentliche Code-Änderungen wurden für die Unterstützung für die neue Joomla namespaced API implementiert. Ausserdem wurden Anpassungen für eine PHP Version 7.2 Umgebung gemacht.

Eine grosse Änderung in Joomla! 4 sind die Namespaces. Eine Funktion, die seit PHP 5.3.0 existiert und 2009 eingeführt wurde. Die gesamte PHP-Community hat sich darauf eingestellt und Joomla! will in diesem Bereich nicht zurückbleiben. In Joomla! 4.0 wird die Kernarchitektur die Unterstützung und weitgehende Verwendung von PHP-Code in PHP Namespaces-Schreibweise sein. Dies gilt für die Kernbibliotheken und auch Erweiterungen, wie z. B. flashchart.

Release 1.3.2

Release 1.3.2 ist eine aktualisierte Version von Release 1.3.1. Wesentliche Code-Änderungen wurden für die Unterstützung für eine PHP Version 7 Umgebung implementiert.

Release 1.3.1

Zwei neue Optionen "target_line" und "target_linecolor" wurden eingeführt. Bei Angabe von "target_line" wird im Koordinatensystem zusätzlich zu X-Achse und Y-Achse eine (Ziel) Linie bei dem Y-Wert bzw. X-Wert angezeigt. "target_linecolor" setzt die Farbe für eine Ziel-Linie. Falls man hier die gleiche Farbe wie für den Hintergrund gewählt hat, wird die Linie nicht sichtbar sein.

Build Level 1.3.1.2 unterstützt nun die logarithmische Skalierung der y-Achse mit dem Paramerter "log_scaley". Daneben wurde die Darstellung von Tooltips-Inhalten beim Einsatz des Parameters "x_label_truncate" verbessert.

Release 1.3.0

Der Code wurde komplett überarbeitet und Verbesserungen für das Laufzeitverhalten (Performance) eingebaut.

Neu im Release 1.2.2

Release 1.2.2 ist im wesentlichen ein "Security-Release" - es wird nun z. B. in allen php-Scripts geprüft, ob das Joomla Framework verwendet wird, d.h. jeder direkte Aufruf wird mit einem Fehler abgewiesen. Die OFC Post/Get Schnittstelle wird (auch aus Sicherheitsgründen) nun nicht mehr unterstützt.

Mit diesem Release wurde die Schnittstelle für "Modal Windows" erweitert. Man kann nun via Parameter "modal_chart" ein Diagramm unmittelbar in einem modalen Fenster anzeigen lassen.

Das Exception-Handling für die Datenbankschnittstelle (MYSQL) wurde für Joomla Version 3.x angepasst.

Neu im Release 1.2.1

Mit diesem Release sind eine Reihe von Erweiterungen und Verbesserungen hinzugekommen:

• Neue Diagrammtypen - Streudiagramme:
• scatter_dot
• scatter_star
• scatter_box
• scatter_hollow
• Darstellung von Trends (Trendlinie) in Säulen- und Liniendiagrammen
• Regressionsanalyse für Streudiagramme:
1. lineare Regression
2. exponentiale Regression (zwei Typen)
3. Einsatz von eigenen Regressionsformeln
• Erzeugung von Diagrammdaten via mathematischer Formeln

Neu im Release 1.2.0

• ein neu überarbeitetes Flash-Objekt ("open-flash-chart.swf") wird eingesetzt
• FlashChart unterstützt eine Vielzahl von Aktionen auf "mouse click events" (via Mausklicks auf Diagrammelemente können Aktionen ausgelöst und verarbeitet werden).
• Kreisdiagramme kann man zusätzlich mit Legenden versehen
• der Radius von Kreisdiagrammen kann frei definiert werden
• Legenden können auf die rechten Seite (statt auf der oberen Seite) des Diagramms gesetzt werden
• Man kann nun Diagramm-Menüs definieren und nutzen
• das Problem bei Balkendiagrammen (type="bar_horizontal") mit mehreren Datengruppen wurde beseitigt
• Säulen- und Liniendiagramme können mit Zahlenwerten angezeigt werden
• Funktionen, um Javascripts zu erstellen bzw. für Click-Events zu nutzen wurden bereitgestellt
• Diagramme können mit einem Hintergrundbild dargestellt werden
• man kann nun die Datenstruktur für Säulendiagramme unverändert auch für gestapelete Säulendiagramme (type="bar_stack") verwenden
• Unterstützung für "standalone" Webanwendungen
• plus einer Reihe von Verbesserungen im Code

Änderungen

Parameter "c_color" wurde in "chart_colors" geändert. Bitte im Administrator Backend via "Erweiterungen -> "Plugins"  und dann das Plugin "flashChart content plugin" auswählen und dann nach dem Aufruf "speichern" klicken.

Hints und Tips

Hints und Tips

Meine Parameter scheinen O.K.zu sein aber es wird kein Diagramm angezeigt oder ich bekomme eine Fehlernachricht
Einige Probleme dieser Art werden durch Joomla!'s WYSIWIG Editoren verursacht. Ich musste einige Male erleben, dass mein Editor zu "schlau" meine Eingabe korrigierte . Leerzeichen wurden durch " " oder Tabulatorzeichen ersetzt. Aus Sonderzeichen wie "=" oder "/" machte der Editor HTML-Codes. Um solche Dinge herauszufinden, schaut man sich am besten immer die HTML-Quelle an (alle Editoren bieten diese Möglichkeit), die der Editor erzeugt hat und korrigiert die Eingabe in der HTML-Quelle.

Drucken
Seit der Version 1.2.0.13 kann man via Kontext-Menu Diagramme drucken (Aufruf via Klick im Diagramm mit rechter Maustaste). Wenn man Diagramme vor dem Druck in Images konvertiert (via Kontext-Menu) kann man auch die gesamte Webseite zusammen mit den Diagrammen drucken (dieses Konvertieren ist bei Microsofts Internet Explorer nicht notwendig). Daneben bietet auch das mitgelieferte Javascript "print_page" die gleiche Funktionalität.

Hinweise zum Einsatz von gestapelten Säulendiagrammen:
Wenn man ein einfaches oder Seite an Seite stehendes Säulendiagramm anfordert, erzeugt jeder einzelne Wert innerhalb einer Datengruppe eine einzelne Säule mit der jeweils gleichen Farbe. Bei gestapelten Säulendiagrammen (type="bar_stack") ist dieses Verhalten anders. Hier führt jeder Wert innerhalb einer Datengruppe zu einem Stapel (Stack) mit unterschiedlicher Farbe auf einer einzelnen Säule.
Beispiel: Sie möchten die Umsätze von zwei Produkten für die Monate Januar bis März in einem Diagramm darstellen. Dafür haben Sie folgende Datendefininition angegeben: data="Jan,Feb,Mär,Apr / 10,20,30,40 | 50,60,70,80" und fordern ein Säulendiagramm mit type="bar_cylinder" an. Dann werden aus dieser Angabe vier Seite an Seite stehende Paare von Säulen erzeugt.
Wenn man nun ein gestapeltes Säulendiagramm (type="bar_stacked") mit den gleichen Daten anfordert, würde man ein Diagramm mit nur zwei gestapelten Säulen erzeugen - dies würde also zu einem inkorrektes Diagramm führen. Um dies zu korrigieren muss man also die Daten neu anordnen: data="Jan,Feb,Mär,Apr / 10,50 | 20,60 | 30,70 | 40,80" - diese Anordnung führt dann zu dem korrekten Diagramm mit vier gestapelten Säulen (wenn Daten aus einer Datenbank angefordert wurden, sorgt flashChart automatisch für eine Neuanordnung).

Mit der Version 1.2.0 hat man nun die Möglichkeit, via Parameter rearrange_data="1" die Daten über FlashChart neu anzuordnen.

Hinweise zur mysql Schnittstelle:
Mit flashChart haben Sie Zugriff auf Tabellen der Joomla! Datenbank und auf externe mysql Datenbanken. Die Erzeugung ihres Diagramms hängt unmittelbar von den Daten ab, die sie mit ihrer Abfrage von der mysql Datenbank bekommen, d. h. der Schlüssel zur Datengewinnung und ihre Darstellung ist ihre SQL-Anweisung. Die Resultatsmenge von Daten über ihre Abfrage wird von flashChart in folgender Weise verwendet:

1. falls die Resultatsmenge nur eine Daten-Spalte enthält oder der Parameter "sql_labels" den Wert "0" gesetzt hat, werden die Daten unmittelbar zur Erzeugung des Diagramms verwendet.
   zum Beispiel: ...data="database" sql="Select hits From jos_content Order By hits Desc Limit 10"
2. falls die Resultatsmenge zwei oder mehr Datenspalten enthält und der Parameter "sql_labels" den Wert "1" (das ist der Default) gesetzt hat:
   zum Beispiel: ...data="database" sql="Select title, hits From jos_content Order By hits Desc Limit 10"
   • werden die Daten aus der ersten Spalte zur Erzeugung der Labels für die x-Achse verwendet
     
   • die Daten aus den folgenden Spalten werden als Daten für das Diagramm interpretiert. Jede Spalte bildet dabei eine Datengruppe (und sorgt für die Erzeugung von side by side bar-charts, stacked bar-charts oder multi line-charts).

Support

Support

Obwohl ich sehr intensiv getestet habe, könnte es sein, daß ich noch einige Bugs übersehen habe. Deshalb bitte "take it easy"! Ich bin bemüht, einen Fix so schnell als möglich bereitzustelllen. Bitte fügen Sie die flashChart Parameter bei, die u. U. das Problem verursacht haben. Um mich zu kontaktieren, senden Sie eine email an mich und beschreiben Sie Ihr Problem oder besuchen Sie einfach mein Forum.
Haben Sie Probleme Anregungen? Scheuen Sie sich nicht, Scheuen Sie sich nicht, Diese E-Mail-Adresse ist vor Spambots geschützt! Zur Anzeige muss JavaScript eingeschaltet sein! Wenn Sie dieses Plugin mögen, bin ich auf keinen Fall böse, wenn Sie es mir oder anderen erzählen!