{jphpx .... }

{jphpx [.. ihr code ]}

{jphpx [php-apps/games/sudoku.php]}

{jphpx [*10]}

Mit der Version 1.3.3 stellt das jphpx System Package auch ein Modul zur Verfügung. Sie können hiermit z.B. eigene php-Anwendungen oder php-Code als Joomla Modul einsetzen, ohne selbst ein Joomla Module entwickeln und erstellen zu müssen.

Hinweis: Beim Update der Version 1.3.2 nach Version 1.3.3 durch den Joomla Updater wird das jphpx Modul nicht installiert, sondern nur über einen Re-Install des Jphpx Pakets oder einen Download und die Installation des jphpx Moduls.

Einsatz und Verwendung

1. Über den Menupunkt "Komponenten" im Administrator Backend selektiert man die Option "jphpx Anwendung" bzw. "jphpx Code Entry". Damit wird die Komponente aufgerufen und man kann nun mit dem Button "Neu" eine neue jphpx Anwendung für den Einsatz eines Moduls definieren. Dafür muss ein Titel der Anwendung, die Quelle (der Pfad und der Filename), der Zugriff und die Aktivierung eingetragen werden. Mit dem Button "Speichern" wird der neue Code Entry nach erfolgreichem Speichern verfügbar.


2. Erstellen Sie nun ein Modul mit dieser jphpx Anwendung (dem jphpx Code Entry). Über die Menupunkte "System->"Site Module" im Administrator Backend wählen Sie "Neu" für ein neues Joomla Modul. Selektieren Sie dann aus der Liste der verfügbaren Modulen das jphpx Module
   jphpx Module ×
   . In der Anzeige des jphpx Moduls selektieren sie den gewünschten jphpx Code Entry und konfigirieren Sie die weiteren notwendigen Optionen für den Einsatz des Moduls. Nach dem Speichern wird das neue Modul dann auf Ihre Website angezeigt.

Im Web sind tausende von php-Anwendungen, Anwendungsbeipielen oder Code-Snippets verfügbar, von denen einige sicherlich gewüschte Funktionen abdecken. Es lohnt sich da genauer hinzusehen und den Code unter Joomla zu testen. Dabei soltte man einiges beachten bzw. bedenken.

Zuerst das Allerwichtigste: sichern Sie den Code ihrer Scripte gegen den Zugriff von Aussen. Dazu fügen Sie als erste Zeile in ihr Script folgende php-Direktive ein:

defined('_JEXEC') or die('Restricted access');

defined('_JEXEC') or die('Restricted access');
use Joomla\CMS\Factory;
use Joomla\CMS\Uri\Uri;
...

$document = Factory::getDocument ();
$document->addScript(Uri::root(true) . "/my_media/script.min.js");
...   

Ajax-Anwendungen sind in der Lage, Anfragen an einen Server zu schicken, bei denen nur die Daten angefordert werden, die tatsächlich benötigt werden. Dies geschieht über den Aufruf eines Webservices (eines Serverprogramms). Dieser Aufruf erfolgt als asynchrone oder synchrone Kommunikation, d. h. während die Daten vom Server geladen werden, kann der User weiter mit der Oberfläche interagieren. Sind die Daten fertig geladen, dann wird eine zuvor benannte JavaScript-Funktion aufgerufen, die die Daten in die Webseite einbinden kann.

php-scripte von solchen Webanwendungen laufen zwar auf der Client Seite mit Hilfe von jphpx unter der Kontrolle und in der Umgebung von Joomla - die Server Seite kann jedoch nicht in gleicher Weise unter dem Dach von Joomla ausgführt werden.

Seit der Version 1.3.0 von jphpx ist diese Einschränkung aufgelöst, da das jphpx System Plugin Ajax-Requests mit Hilfe der Joomla Ajax Schnittstelle ausführen kann. Folgende Maßnahmen sind für diese Umsetzung nötig.

1. Die Client und Server Programme (die jeweiligen php-Scripte) müssen als jphpx Code Entries definiert werden
2. Ajax Requests basieren auf Request-URLs. Diese URLs sind für die Joomla Ajax Schnittstellen zu ändern:

   index.php?option=com_ajax&plugin=jphpx&group=system&format=raw&id=nn

   &id=nn ist die id des jphpx code entries des Server programms.

 php-apps/server.php?request=1&data=new 

index.php?option=com_ajax&plugin=jphpx&group=system&format=raw&id=10&request=1&data=new

• Includes (bzw. requires) sollten auf korrekte Ergebnisse überprüft bzw. Pfad und Filename angepasset werden.
• Zugriffe auf externe Dateien sollte auf Fehlerfreiheit überprüft bzw. Pfad und Filename angepasset werden.
• php-globals sind nicht unterstützt
• bei Fehlern im Server Script wird ein "HTTP 500 Internal Server Error" produziert. Überprüfen Sie dann ihr Server Script bzw. analysieren sie auch die Apache Logs.

Ajax absichern

Mit dem Request Parameter "check_type" kann man auf korrekte Eingaben prüfen;

• &check_type="STRING" - (Standard) Konvertiert die Eingabe in eine einfache Textzeichenfolge; entfernt alle Tags / Attribute.
• &check_type="INT", &check_type="INTEGER" - gibt die erste Ganzzahl zurück, die im Parameterwert gefunden wird
• &check_type="UINT" - gibt ein unsigned int zurück
• &check_type="FLOAT", &check_type="DOUBLE" - gibt den ersten gefundenen Float zurück
• &check_type="BOOL", &check_type="BOOLEAN" - Erwartet die Werte 0 oder 1 (Achtung: Angabe "true"' bzw '"false" sind Strings)
• &check_type="WORD" - Erlaubt nur die Zeichen a-z und Unterstrich
• &check_type="ALNUM" - alphanumerisch
• &check_type="CMD" - Erlaubt a-z, 0-9, Unterstrich, Punkt, Bindestrich. Entfernen Sie auch führende Punkte aus dem Ergebnis.
• &check_type="HTML" - wandelt die Eingabe in einen String um; entfernt alle HTML-Tags/Attribute.
• &check_type=""PATH" - Konvertiert die Eingabe in einen String und validiert ihn als Pfad
• &check_type="RAW" - Seien Sie vorsichtig damit, um Injektionsangriffe auf Ihre Website zu vermeiden!
• &check_type="USERNAME" - entfernt alle ungültigen Zeichen des Benutzernamens.

Meine php-Anwendungen sind Beispiele für diese Umsetzung - sie laufen sowohl auf der Client Seite als auch auf der Serverseite völlig unter der Kontrolle und der Umgebung von Joomla.