Inhaltsverzeichnis

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

Struktur

600

Ersteinrichtung

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/

Installation von 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.

Für die Installation von Extensions benötigen Sie die Berechtigung „system/extensions“

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
Die Extension Datei wird nach der Installation gelöscht wenn die Installation über die Commandline erfolgt!

Update von Extensions

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.

Deaktivieren von Extensions

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

Extensions entwickeln

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

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