Benutzer-Werkzeuge

Webseiten-Werkzeuge


develop:scripting-plugin

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
develop:scripting-plugin [d.m.Y H:i] – [Aufbau der plugin.xml] willuhndevelop:scripting-plugin [d.m.Y H:i] (aktuell) – [Aufbau des Plugins] willuhn
Zeile 1: Zeile 1:
 ===== Hibiscus: Scripting-Plugin erstellen ===== ===== Hibiscus: Scripting-Plugin erstellen =====
  
-Mit Jameica 2.ist es erstmals möglich, Plugins zu erstellen, die keinen Java-Code enthalten. Das ist z.Bsp. für Plugins nützlich, die lediglich Bibliotheken (Jar-Dateien) für andere Plugins bereitstellen oder für Scripting-Plugins. Das folgende Tutorial beschreibt letzteres beispielhaft an einem Plugin "hibiscus.script.abcbank", welches Hibiscus um ein Javascript zur Umsatz-Synchronisierung mit der Bank "abcbank" erweitert und hierfür auch ein paar benötigte Jar-Dateien mitbringt.+Mit Jameica 2.ist es erstmals möglich, Plugins zu erstellen, die keinen Java-Code enthalten. Das ist z.Bsp. für Plugins nützlich, die lediglich Bibliotheken (Jar-Dateien) für andere Plugins bereitstellen oder für Scripting-Plugins. Das folgende Tutorial beschreibt letzteres beispielhaft an einem Plugin "hibiscus.script.abcbank", welches Hibiscus um ein Javascript zur Umsatz-Synchronisierung mit der Bank "abcbank" erweitert und hierfür auch ein paar benötigte Jar-Dateien mitbringt.
  
  
 ===== Aufbau des Plugins ===== ===== Aufbau des Plugins =====
  
-Das Plugin befindet sich in einer ZIP-Datei "hibiscus.script.abcbank.zip"Diese enthält eine Datei mit dem Namen "plugin.xml", eine Javascript-Datei mit dem Namen "hibiscus.script.abcbank.js" sowie einen Ordner "lib" mit den benötigten Jar-Dateien (im Beispiel sind es die Jar-Dateien von [[http://htmlunit.sourceforge.net/|HTMLUnit]].+Das Plugin befindet sich in einer ZIP-Datei "hibiscus.script.abcbank.zip"Dieses enthält auf oberster Ebene lediglich einen Ordner mit dem selben Namen wie das Plugin. Hier also "hibiscus.script.abcbank". In diesem befindet sich eine Datei mit dem Namen "plugin.xml", eine Javascript-Datei mit dem Namen "hibiscus.script.abcbank.js" sowie einen Ordner "lib" mit den benötigten Jar-Dateien (im Beispiel sind es die Jar-Dateien von [[http://htmlunit.sourceforge.net/|HTMLUnit]].
  
 <code:shell> <code:shell>
   hibiscus.script.abcbank.zip   hibiscus.script.abcbank.zip
-    |-- plugin.xml +    
-    |-- hibiscus.script.abcbank.js +    +-- hibiscus.script.abcbank (Ordner) 
-    +-- lib +         |-- plugin.xml 
-         |-- commons-codec-1.4.jar +         |-- hibiscus.script.abcbank.js 
-         |-- commons-io-1.4.jar +         +-- lib 
-         |-- cssparser-0.9.5.jar +              |-- commons-codec-1.4.jar 
-         |-- serializer-2.7.1.jar +              |-- commons-io-1.4.jar 
-         |-- xml-apis-1.3.04.jar +              |-- cssparser-0.9.5.jar 
-         |-- commons-collections-3.2.1.jar +              |-- serializer-2.7.1.jar 
-         |-- commons-lang-2.4.jar +              |-- xml-apis-1.3.04.jar 
-         |-- htmlunit-2.7.jar +              |-- commons-collections-3.2.1.jar 
-         |-- nekohtml-1.9.14.jar +              |-- commons-lang-2.4.jar 
-         |-- xalan-2.7.1.jar +              |-- htmlunit-2.7.jar 
-         |-- commons-httpclient-3.1.jar +              |-- nekohtml-1.9.14.jar 
-         |-- commons-logging-1.1.1.jar +              |-- xalan-2.7.1.jar 
-         |-- htmlunit-core-js-2.7.jar +              |-- commons-httpclient-3.1.jar 
-         |-- sac-1.3.jar +              |-- commons-logging-1.1.1.jar 
-         |-- xercesImpl-2.9.1.jar +              |-- htmlunit-core-js-2.7.jar 
-         +-- LICENSE.TXT+              |-- sac-1.3.jar 
 +              |-- xercesImpl-2.9.1.jar 
 +              +-- LICENSE.TXT
 </code> </code>
  
 ===== Aufbau der plugin.xml ===== ===== Aufbau der plugin.xml =====
  
-Die Datei "plugin.xml" ist das Manifest eines Plugins ([[develop:plugin.xml|siehe auch]]). Es beschreibt die Eigenschaften des Plugins sowie dessen Abhängigkeiten zu anderen Plugins. Im konkreten Beispiel erfordert es Jameica mindestens in Version 2.3.0 (erst seit dieser Version ist es möglich, Plugins ohne Java-Code zu erstellen), ausserdem die Plugins "hibiscus" und "jameica.scripting" in mindestens den angegebenen Versionen.+Die Datei "plugin.xml" ist das Manifest eines Plugins ([[develop:plugin.xml|siehe auch]]). Es beschreibt die Eigenschaften des Plugins sowie dessen Abhängigkeiten zu anderen Plugins. Im konkreten Beispiel erfordert es Jameica mindestens in Version 2.4.0 (erst seit dieser Version ist es möglich, Plugins ohne Java-Code zu erstellen), ausserdem die Plugins "hibiscus" und "jameica.scripting" in mindestens den angegebenen Versionen.
 Das Plugin sendet ausserdem eine Message an die Queue "jameica.scripting.add" mit dem Inhalt "${manifest.pluginDir}/hibiscus.script.abcbank.js". Diese Queue wird vom Plugin "jameica.scripting" bereitgestellt. Die Message bewirkt, dass die Javascript-Datei "hibiscus.script.abcbank.js" beim Start von Jameica automatisch registriert wird. Die Variable "${manifest.pluginDir}" wird hierbei von Jameica automatisch gegen den Installationspfad des Plugins ersetzt. Das Plugin sendet ausserdem eine Message an die Queue "jameica.scripting.add" mit dem Inhalt "${manifest.pluginDir}/hibiscus.script.abcbank.js". Diese Queue wird vom Plugin "jameica.scripting" bereitgestellt. Die Message bewirkt, dass die Javascript-Datei "hibiscus.script.abcbank.js" beim Start von Jameica automatisch registriert wird. Die Variable "${manifest.pluginDir}" wird hierbei von Jameica automatisch gegen den Installationspfad des Plugins ersetzt.
  
Zeile 47: Zeile 49:
   <license>GPL - http://www.gnu.org/copyleft/gpl.html</license>   <license>GPL - http://www.gnu.org/copyleft/gpl.html</license>
  
-  <requires jameica="2.3.0+">+  <requires jameica="2.4.0+">
     <import plugin="jameica.scripting" version="2.3.0+" />     <import plugin="jameica.scripting" version="2.3.0+" />
-    <import plugin="hibiscus" version="2.3.0+" />+    <import plugin="hibiscus" version="2.4.0+" />
   </requires>   </requires>
  


Impressum | Datenschutz
develop/scripting-plugin.1355665367.txt.gz · Zuletzt geändert: d.m.Y H:i von willuhn