Abgesehen von sehr wenigen Ausnahmen entspricht das Fiona-7-API dem API von Scrivito. Sämtliche Methoden bis auf fiona7_login_button, fiona7_head_tags und fiona7_body_tags sind nur im Legacy-Modus erlaubt.
Das Ruby-API
Helper-Methoden
fiona7_login_button
Erstellt eine Schaltfläche, die zur Anmeldeseite führt.
fiona7_head_tags
Erfüllt die gleiche Aufgabe wie scrivito_head_tags in Scrivito-Applikationen. Sie muss im HEAD-Bereich der Seite aufgerufen werden, um die Bearbeitungskomponenten zu aktivieren.
fiona7_body_tags
Erfüllt die gleiche Aufgabe wie scrivito_body_tags in Scrivito-Applikationen. Sie muss im BODY-Bereich der Seite aufgerufen werden, um die Bearbeitungselemente zu aktivieren.
fiona7_tag(tag_name, obj_or_widget, field_name, html_options = {}, editing_options = {}, &block)
Nur im Legacy-Modus erlaubt. Funktioniert wie scrivito_tag, akzeptiert jedoch als zweites Argument auch eine Instanz von RailsConnector::BasicObj. Somit kann In-Place-Editing auch in den klassischen RailsConnector-Views verwendet werden.
fiona7_tag_list(tag_name, obj, field_name, options = {}, &block)
Nur im Legacy-Modus erlaubt. Funktioniert wie scrivito_tag_list, akzeptiert jedoch als zweites Argument auch eine Instanz von RailsConnector::BasicObj.
fiona7_workflow_buttons
Nur im Legacy-Modus erlaubt. Erzeugt ein Dropdown-Menü, mit dem auf das aktuelle Objekt bezogene Workflow-Operationen wie Bearbeiten, Übernehmen, Weiterleiten, Einreichen, Signieren, Ablehnen und Freigeben durchgeführt werden können. Die aktiven Befehle werden hierbei über den zugrundeliegenden Workflow bestimmt.
RailsConnector::BasicObj#scrivito_obj
Nur im Legacy-Modus erlaubt. Im Legacy-Modus hat jedes RailsConnector-Objekt diese Methode. Sie gibt eine Instanz von Scrivito::BasicObj zurück und ermöglicht es daher, die Methoden des Scrivito-API im Legacy-Modus aufzurufen. Wenn beispielsweise @obj eine Instanz der RailsConnector-Klasse Publication ist und ein Widget-Attribut namens main_content enthält, kann dieses Attribut folgendermaßen gerendert werden.
<%= scrivito_field @obj.scrivito_obj, :main_content %>
Scrivito::BasicObj#fiona_obj
Nur im Legacy-Modus erlaubt. Im Legacy-Modus hat jedes Scrivito-Objekt diese Methode, die die Umkehrung zu scrivito_obj ist und eine Instanz von RailsConnector::Obj zurückgibt. Sie unterstützt den gemischten Betrieb von RailsConnector und Fiona 7.
Die Klasse „Obj“
Analog zum RailsConnector benötigen sowohl Fiona 7 als auch Scrivito eine Obj-Klasse. Sollte die globale Klasse Obj bereits durch den RailsConnector definiert sein - dies ist im Legacy-Modus der Fall -, dann sollten in_place-Blöcke verwendet werden, um von Scrivito::BasicObj abgeleitete Shadow Classes zu erzeugen. Beispiel:
class Obj < RailsConnector::BasicObj in_place do attribute :headline, :string end end
Dies gilt analog auch für die Klassen von Vorlagen, sei es für gewöhnliche CMS-Objekte oder Widgets.