Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
addons:aufahme [2018/06/19 07:57] pollmann |
addons:aufahme [2019/08/13 13:48] |
||
---|---|---|---|
Zeile 1: | Zeile 1: | ||
- | [[:start|zurück zum Hauptmenü]] | ||
- | |||
- | |||
- | ====== Addon - Aufnahme ====== | ||
- | |||
- | ===== Installation ===== | ||
- | Das AddOn //Aufnahme// funktioniert erst mit Version 3.2 von FH-Complete (siehe [[fhc: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 [[fhc:mail|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. | ||