[[:start|zurück zum Hauptmenü]]


====== Addon - Aufnahme ======

===== Installation =====
Das AddOn //Aufnahme// funktioniert erst mit Version 3.2 von FH-Complete (siehe [[admin:codeigniter|Installationsanleitung für 3.2]])

Zuerst muss das AddOn von Github heruntergeladen werden:
<code>
cd /var/www/addons/
git clone https://github.com/FH-Complete/FHC-AddOn-Aufnahme.git aufnahme
</code>

Anschließend muss der Composer gestartet werden:
<code>
composer.phar install
</code>

Danach kann die Installationsroutine durch Aufruf des folgenden Links gestartet werden:
<code>
https://demo.fhcomplete.org/addons/aufnahme/dbcheck.php
</code>

==== Erstellen eines API Users ====
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:\\
{{:addons:addon_aufnahme_user.png?600|}}

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:
<code>
INSERT INTO public.ci_apikey(key) VALUES('aufnahme@fhcomplete.org');
</code>

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

<code>
$config['rest_ip_whitelist'] = '127.0.0.1,::1';
</code>

==== Config File Anpassen ====

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:
<code>
cd /var/www/addons/aufnahme/cis/application/config/
mkdir development
cp aufnahme.php development
cp config.php development
</code>
\\
\\
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.
<code>
$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'
);
</code>

In der Datei config.php muss die base_url angepasst werden.
<code>
$config['base_url'] = 'https://fhcomplete.org/addons/aufnahme/cis/';
</code>

==== Vorlagen erstellen ====
Mit folgendem Befehl müssen die Mailvorlagen im System erstellt werden:
<code>
cd /var/www/
php index.ci.php DBTools seed/Vorlage
</code>

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


==== Nachrichtenversand ====

Der Versand der Nachrichten erfolgt über das Messaging-System. Damit diese erfolgreich verschickt werden, muss das Messaging System im Core korrekt konfiguriert sein. Siehe [[admin:installation&#mail-versand_einrichten|Mailversand]]


==== Troubleshooting ====

=== Studiengänge sind nicht sichtbar ===

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.