Ein Visforms Custom-Plugin Template für die Plugin-Entwicklung mit Visforms Events
Nach der Installation von Visforms steht ein komplettes Visforms Custom-Plugin Template zur Verfügung.
Das Visforms Custom-Plugin Template ist aus verschiedenen Gründen hilfreich:
- Es implementiert für alle unterstützten Visforms-Events leere Event-Handler.
- In jedem Event-Handler geben Kommentare zusätzlich wichtige Hinweise zur Verwendung des jeweiligen Events.
- Gegen Ende des Visforms Custom-Plugin Templates stehen einige fertige Beispiel-Funktionen.
- Ganz am Ende des Visforms Custom-Plugin Templates stehen einige nützliche Hilfsfunktionen.
Vorsicht: Das Visforms Custom-Plugin Template wird ständig weiterentwickelt. Bei jeder Art der Installation wird das Visforms Custom-Plugin überschrieben. Falls Sie Änderungen an dem Visforms Custom-Plugin durchgeführt haben, gehen dabei alle Änderungen ohne vorherige Nachfrage verloren.
Hinweis:
Arbeiten Sie mit einer Kopie des Visforms Custom-Plugin Templates in allen Situationen, in denen Ihre Änderungen nicht verloren gehen dürfen.
Wie Sie eine Kopie des Visforms Custom-Plugin Templates erstellen wird hier erklärt:
Kopie des Visforms Custom-Plugin Templates erstellen
Wo befindet sich das Visforms Custom-Plugin Template?
Das Visforms Custom-Plugin Template befindet sich in folgendem Verzeichnis:
- plugins/visforms/vfcustomplugin
Das Verzeichnis enthält die folgenden Dateien:
- plugins/visforms/vfcustomplugin/
- plugins/visforms/vfcustomplugin/vfcustomplugin.php
- plugins/visforms/vfcustomplugin/vfcustomplugin.xml
- plugins/visforms/vfcustomplugin/index.html
Wie wird das Visforms Custom-Plugin Template installiert?
Das Plugin wird installiert über die Joomla Funktion Überprüfen manuell installiert:
- Gehen Sie zu Administration » System » Installieren » Überprüfen
- klicken Sie dort auf den Button ‘Überprüfen’.
- installieren Sie das gefundene Visforms Custom-Plugin
Das Visforms Custom-Plugin Template muss aktiviert werden
Das Plugin muss manuell aktiviert werden, bevor Sie es nutzen können:
- Gehen Sie zu: Administration » System » Verwalten » Plugins.
- Suchen Sie dort mit dem Text ‘customplugin’ nach Plugins.
- Klicken Sie in dem Such-Ergebnis ‘Visforms - Customplugin Beispiel’ auf den grünen Haken ‘Plugin aktivieren’.
Eine Kopie des Visforms Custom-Plugin Template erstellen
Arbeiten Sie mit einer Kopie des Visforms Custom-Plugin Templates in allen Situationen, in denen Ihre Änderungen nicht verloren gehen dürfen.
Eine Kopie des Visforms Custom-Plugin Templates erstellen Sie wie folgt:
- Kopieren Sie das ganze Verzeichnis in ein neues Geschwister-Verzeichnis, etwa
plugins/visforms/vftestplugin/ - Nennen Sie beide Plugin-Dateien um, etwa
plugins/visforms/vftestplugin/vftestplugin.php
plugins/visforms/vftestplugin/vftestplugin.xml
Passen Sie die Plugin-Manifest-Datei an
Die kopierte Plugin-Manifest-Datei plugins/visforms/vftestplugin/vftestplugin.xml muss an den folgenden Stellen angepasst werden.
<extension version="4.0.0" type="plugin" group="visforms" method="upgrade">
<name>plg_visforms_vftestplugin</name>
<loggerName>Visformsvftestplugin</loggerName>
<description>My vftest-plugin of the Visforms component</description>
<files>
<filename plugin="vftestplugin">vftestplugin.php</filename>
</files>
</extension>
Passen Sie in der Plugin-Code-Datei den Klassen-Namen an
Die kopierte Plugin-Code-Datei plugins/visforms/vftestplugin/vftestplugin.php muss an der folgenden Stelle angepasst werden.
Die Stelle befindet sich am Anfang der Code-Datei, etwa bei Zeile 36.
class plgVisformsVftestplugin extends CMSPlugin {