[[:start|zurück zur Übersicht]]

====== AddOns ======

Addons werden dazu verwendet um FH-Complete um Funktionen zu erweitern:

   * Überschreiben von Default-Funktionalitäten
      * Locale (Übersetzungen / Begriffe)
      * Dokumentenvorlagen
      * Passwort Policy; Passwort Änderung
      * Benutzernamen Generierung
      * Kartenverlängerung an den ServiceTerminals

   * Erweitern von Optionen
      * Ausblenden von Feldern im FAS / TEMPUS
      * Neue Menüpunkte
      * ...

   * Hinzufügen neuer Funktionalitäten
      * Kompetenzverwaltung
      * Studienplatzverwaltung
      * Reporting
      * ...

   * Schnittstellen für Drittprogramme
      * Konto-Import
      * EPS
      * ...

===== Installation von AddOns =====

Um ein AddOn zu installieren wird zuerst der Programmcode in das "addons" Verzeichnis des Servers kopiert.
Danach muss das AddOn in der Konfigurationsdatei /config/cis.config.inc.php bzw config/vilesci.config.inc.php aktiviert werden.
Dazu wird folgender Eintrag editiert:
<code>
define('ACTIVE_ADDONS','');
=>
define('ACTIVE_ADDONS','template');
</code>
Mehrere aktive Addons können mit Strichpunkt (;) getrennt werden
Nach der Aktivierung des AddOns sind diese im VileSci unter dem Menüpunkt //AddOns// sichtbar und können dort gegebenenfalls installiert werden, wenn das AddOn eine eigene Installation benötigt.
Für die Verwaltung der AddOns ist eine eigene Berechtigung nötig (basis/addon)

===== Aufbau eines Addons =====

AddOns werden im Ordner /addons/ abgelegt.
Das AddOn mit dem Namen template gibt einen Überblick über den Aufbau und die Funktionen eines AddOns


===== Phrasen überschreiben =====

Phrasen (Bezeichnungstexte und Übersetzungen) können von AddOns überschrieben werden um die Phrasen an die jeweilige Institution anzupassen. Sind in den AddOns eigene Phrasen vorhanden überschreiben diese die Standardphrasen aus dem Core.
Es ist auch möglich die Phrasen von AddOns zu Überschreiben. Hierzu wird immer die Phrase des zuletzt aktivierten AddOns herangezogen.
Falls Phrasen überschrieben werden empfiehlt es sich daher, ein eigenes AddOn zu erstellen und dieses am Schluss der Liste zu aktivieren:
<code>
define('ACTIVE_ADDONS','template;addon1;addon2;phrasen');
</code>

Die Phrasen sind im Verzeichnis locale abgelegt. Um eine Phrase zu überschreiben wird einfach eine Datei mit dem selben Namen angelegt welches die Phrase enthält und die enstprechende Phrase hinzugefügt.
In der Datei müssen nur die Phrasen enthalten sein die überschrieben werden sollen.