Diese Anleitung bezieht sich auf eine bestehende Fiona-on-Rails-Applikation, die mit Fiona 7 im Legacy-Modus betrieben werden soll.
Als Ausgangspunkt der Installation dient eine Rails-Anwendung in der Version 4.2. Dabei kann es sich um eine RailsConnector-Applikation oder eine reine Rails-Applikation handeln. Um wie vorgesehen zu funktionieren, benötigt das Fiona-7-Gem zwingend:
Tragen Sie das Fiona-7-Gem in die Datei „Gemfile“ im Hauptverzeichnis der Applikation ein:
gem 'infopark_fiona7'
Falls Sie „turbolinks“ einsetzen, entfernen Sie es bitte, da es von Scrivito nicht unterstützt wird. Dies betrifft:
Das Fiona-7-Gem wird wie der RailsConnector (jetzt auch FionaConnector) auf RubyGems.org veröffentlicht. Daher kann es mit dem folgenden Aufruf installiert werden:
bundle install
Die erforderlichen Komponenten für die Kompatibilität mit Scrivito werden automatisch berücksichtigt.
In den folgenden Schritten wird die Applikation für die Zusammenarbeit mit dem Fiona-7-Gem konfiguriert.
Um die volle Funktionalität des Gems freizuschalten, müssen in der Applikation CSS- und JavaScript-Komponenten inkludiert werden.
Diese Anleitung geht davon aus, dass in der Datei „application.css“ weder SCSS oder LESS, noch eine andere Lösung verwendet wurde. Erweitern Sie die Datei „app/assets/stylesheets/application.css“ um die folgende Zeile, idealerweise oberhalb oder unterhalb von *= require_self
:
*= require fiona7
Diese Anleitung geht ferner davon aus, dass in der Datei „application.js“ keine Erweiterung wie CoffeeScript o.ä. verwendet wurde. Erweitern Sie die Datei „app/assets/javascripts/application.js“ um die folgende Zeile:
//= require fiona7
Diese Zeile muss zwingend unmittelbar hinter den folgenden Zeilen stehen:
//= require jquery //= require jquery_ujs
Um mit Fiona 7 in Ihrer Applikation arbeiten zu können, benötigen Sie eine Implementation der Klasse Obj
. Legen Sie hierfür das Model Obj
, das von RailsConnector::BasicObj
abgeleitet ist, in der Datei „app/models/obj.rb“ an:
class Obj < RailsConnector::BasicObj end
Damit Sie in Ihrer Applikation auf Objekte der Klasse Obj
zugreifen können, binden Sie im CmsController
die Scrivito::ControllerActions
ein. Legen Sie hierfür die Datei „app/controllers/cms_controller.rb“ an:
class CmsController < ApplicationController include Scrivito::ControllerActions end
Für eine Applikation mit dem Fiona-7-Gem müssen drei Arten von Zugängen eingerichtet werden:
Die MySQL-Konfiguration ist vollkommen identisch zu der beim RailsConnector (oder FionaConnector), d.h. der „cms:“-Eintrag in der Datei „config/database.yml“ muss derselbe sein.
Geben Sie die Zugangsdaten für die XML-Schnittstellen in der Datei „config/initializers/fiona7.rb“ an. Das folgende Beispiel illustriert die Konfigurationswerte und deren Format:
Fiona7.configure do |config| # 1 config.instance = 'playland' # 2 config.host = '33.33.33.10' # 3 config.port = 7001 # 4 config.username = 'root' # 5 config.secret = 'MYSECRET' # 6 config.mode = :legacy # 7 end
Fiona7::VeritySearchEngine::VeritySearchRequest.configured_host = '33.33.33.10' # 8 Fiona7::VeritySearchEngine::VeritySearchRequest.configured_port = 7011 # 9
Die obigen Zeilen bedeuten oder bewirken:
:legacy
oder :standalone
. Erläuterungen zu dieser Einstellung finden Sie im Abschnitt Zwei Betriebsarten.Mit dem Login unter username
und dem angegebenen secret
wird man als CMS-Benutzer mit root-Rechten authentifiziert. Aus diesem Grund sollten diese Zugangsdaten niemals veröffentlicht (oder in ein Repository eingecheckt) werden. Wir empfehlen, die Zugangsdaten mittels Rails Secrets zu persistieren. Ferner sollte der Zugang zur XML-Schnittstelle mit einer Firewall auf die bekannten IP-Adressen beschränkt werden.
Schalten Sie die Benutzeroberfläche frei, indem Sie in den HEAD-Abschnitt des Layouts
<%= fiona7_head_tags %>
sowie in den BODY-Abschnitt
<%= fiona7_body_tags %>
eintragen.
Optional können Sie Workflows oder die Tag-Filterfunktion des Content Browsers aktivieren oder deaktivieren.
Um in der Vorschau arbeiten zu können, ist es erforderlich, sich anzumelden. Die Anmeldemaske ist voreingestellt versteckt und muss erst freigeschaltet werden. Fügen Sie hierzu mit der folgenden Zeile den Button zur Anmeldung an einer geeigneten Stelle ins Layout ein:
<%= fiona7_login_button %>
Beim ersten Start einer auf Fiona 7 basierenden Applikation wird die dazu gehörende CMS-Instanz automatisch initialisiert. Hierbei werden die Zugänge, Strukturen und Einstellungen des CMS auf Kompatibilität mit Fiona 7 überprüft und bei Bedarf angepasst.
Nachdem die Anwendung gestartet und die Site im Browser aufgerufen wurde, können Sie sich anmelden und im Bearbeitungsmodus Inhalte erstellen und bearbeiten.