Extensions

Extensions sind Erweiterungen des FH-Complete Core Systems. Diese sind ab FH-Complete Version 3.3 verfügbar. Sie werden dazu verwendet um die Standardfunktionalitäten von FH-Complete zu erweitern. Extensions können die bestehende Datenbank um zusätzliche Tabellen erweitern, neue Webservice Funktionalitäten hinzufügen und weitere Modifikationen am FH-Complete Core durchführen.

Extensions müssen immer am selben Host wie der FH-Complete Core installiert werden.

Extension folgen der Namenskonvention FHC-Core-XXX

Vor der Verwendung von Extensions müssen ein paar Anpassungen im FH-Complete Core vorgenommen werden. Der Webserver braucht Schreibzugriff auf die Extension-Verzeichnisse damit diese korrekt installiert werden können. Dazu werden folgende Befehle im FH-Complete Hauptverzeichnis ausgeführt:

chgrp www-data application/extensions/ application/tmp/ application/components/extensions/ application/config/extensions/ application/controllers/extensions/ application/helpers/extensions/ application/hooks/extensions/ application/libraries/extensions/ application/models/extensions/ application/views/extensions/ application/widgets/extensions/ public/extensions/

chmod 775 application/extensions/ application/tmp/ application/config/extensions/ application/components/extensions/ application/controllers/extensions/ application/helpers/extensions/ application/hooks/extensions/ application/libraries/extensions/ application/models/extensions/ application/views/extensions/ application/widgets/extensions/ public/extensions/

Die Verwaltung von Extensions finden Sie unter folgendem Link:

https://example.fhcomplete.org/index.ci.php/system/extensions/Manager/

Extensions werden üblicherweise als TGZ Archiv zur Verfügung gestellt. Auf der oben genannten Seite kann das Archiv hochgeladen werden. Dabei wird die Extension automatisch installiert und aktiviert.

Alternativ können Extensions auch über die Commandline installiert werden.

Der Pfad zur Extension muss URL-Kodiert angegeben werden. (%2F statt /)

php index.ci.php system/extensions/CLI_Manager uploadExtension FHC-Core-Extension %2Fhome%2Ffhcomplete%2fFHC-Core-Extension.tgz

Um eine Extension zu Aktualisieren laden Sie einfach die neue Version der Extension über die Administrationsoberfläche hoch. Die alte Version wird dabei automatisch entfernt und durch die neue Version ersetzt.

Extensions können deaktiviert werden. Die Daten der Extensions bleiben dabei erhalten. Lediglich die Funktionen dieser Extension werden deaktiviert.

Folgende Ordner werden automatisch im FH-Complete Core verlinkt um die bestehenden Funktionalitäten zu erweitern:

• config
• controllers
• helpers
• hooks
• libraries
• models
• views
• widgets

Zusätzlich muss im Hauptordner eine Datei mit dem Namen extensions.json vorhanden sein mit folgendem Aufbau:

{
	"name": "FHC-Core-MyExtension",
	"description": "My Extension",
	"version": "1",
	"license": "GPL",
	"url": "https://github.com/FH-Complete/FHC-Core-MyExtension",
	"core_version": "3.3"
}

Mit folgendem Befehl kann aus dem Extension-Code ein Archiv erstellt werden:

tar --exclude=.git -cvzf FHC-Core-myextension.tgz FHC-Core-myextension