developer:extensions []

Diese Seite ist nicht editierbar. Sie können den Quelltext sehen, jedoch nicht verändern. Kontaktieren Sie den Administrator, wenn Sie glauben, dass hier ein Fehler vorliegt.
====== 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 =====

{{:developer:extensionsaufbau.png|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:
<code>
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/
</code>

===== Installation von Extensions =====

Die Verwaltung von Extensions finden Sie unter folgendem Link:
<code>
https://example.fhcomplete.org/index.ci.php/system/extensions/Manager/
</code>

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.

<note important>Für die Installation von Extensions benötigen Sie die Berechtigung "system/extensions"</note>

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

Der Pfad zur Extension muss URL-Kodiert angegeben werden. (%2F statt /)
<code>
php index.ci.php system/extensions/CLI_Manager uploadExtension FHC-Core-Extension %2Fhome%2Ffhcomplete%2fFHC-Core-Extension.tgz
</code>

<note important>Die Extension Datei wird nach der Installation gelöscht wenn die Installation über die Commandline erfolgt!</note>

===== 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:
  * 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:

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

Mit folgendem Befehl kann aus dem Extension-Code ein Archiv erstellt werden:
<code>
tar --exclude=.git -cvzf FHC-Core-myextension.tgz FHC-Core-myextension
</code>
Benutzer-Werkzeuge

Webseiten-Werkzeuge

Seiten-Werkzeuge
