Das AddOn Aufnahme funktioniert erst mit Version 3.2 von FH-Complete (siehe Installationsanleitung für 3.2)

Zuerst muss das AddOn von Github heruntergeladen werden:

cd /var/www/addons/
git clone https://github.com/FH-Complete/FHC-AddOn-Aufnahme.git aufnahme

Anschließend muss der Composer gestartet werden:

composer.phar install

Danach kann die Installationsroutine durch Aufruf des folgenden Links gestartet werden:

https://demo.fhcomplete.org/addons/aufnahme/dbcheck.php

Die Kommunikation des Addons mit dem FH-Complete Core erfolgt über die API. Dazu muss zuerst ein API User erstellt werden.

Dazu wird im FAS ein neuer Mitarbeiter erstellt:

In unserem Fall erhält dieser User die UID aufnahme.

Diesem User müssen über VileSci die entsprechenden Berechtigungen zugeordnet werden die für den Betrieb des Addons nötig sind.

Als nächstes muss noch ein API Key in der Datenbank hinzugefügt werden:

INSERT INTO public.ci_apikey(key) VALUES('aufnahme@fhcomplete.org');

Per default ist eine Whiteliste für den API Zugriff konfiguriert. Die IP des Aufnahme Hosts muss daher erst im Core freigeschalten werden. Dies erfolgt unter /var/www/application/config/rest.php

$config['rest_ip_whitelist'] = '127.0.0.1,::1';

Im Verzeichnis addons/aufnahme/cis/application/config/ müssen zwei Ordner erstellt werden - „development“ und „produktiv“.
Danach wird die Datei aufnahme.php in dieses Verzeichnis kopiert:

cd /var/www/addons/aufnahme/cis/application/config/
mkdir development
cp aufnahme.php development
cp config.php development

In der Datei aufnahme.php müssen API_Key, Username und Passwort angepasst werden. Der http_user ist in unserem Fall der zuvor angelegte User „aufnahme“ mit dem entspechendem Passwort.

$config['fhc_api'] = array(
    'server' => APP_ROOT.'index.ci.php/api/v1/',
    'api_key'         => 'aufnahme@fhcomplete.org',
    'api_name'        => 'FHC-API-KEY',
    'http_user'       => 'CHANGE_THIS_USERNAME',
    'http_pass'       => 'CHANGE_THIS_PASSWORD',
    'http_auth'       => 'basic',
    //'ssl_verify_peer' => TRUE,
    //'ssl_cainfo'      => '/certs/cert.pem'
);

In der Datei config.php muss die base_url angepasst werden.

$config['base_url'] = 'https://fhcomplete.org/addons/aufnahme/cis/';

Mit folgendem Befehl müssen die Mailvorlagen im System erstellt werden:

cd /var/www/
php index.ci.php DBTools seed/Vorlage

Die entsprechenden Mailtexte, welche bei der Registrierung etc. verschickt werden, können anschließend in VileSci → Admin → Vorlagen angepasst werden.

Der Versand der Nachrichten erfolgt über das Messaging-System. Damit diese erfolgreich verschickt werden, muss das Messaging System im Core korrekt konfiguriert sein. Siehe Mailversand

Damit das AddOn Aufnahme korrekt funktioniert, müssen bei den Studiengängen Bewerbungsfristen hinterlegt sein. Diese können über das AddOn Studiengangsverwaltungs-Tool unter Betriebsdaten → Bewerbungsfristen erfasst werden.