ModX Revolution 2.x Dokumentation für Redakteure

1. Login und Dashboard
2. Ressourcenbaum
   1. Baummenü
   2. Ressourcen
      1. Ressourcen Typen
      2. Kontextmenü Ressourcenbaum
      3. Ressourcen durch Drag&Drop verschieben
      4. Kontext
   3. Elemente
      1. Elemente im Backend (Administratorbereich)
   4. Dateien hochladen
3. Ressource bearbeiten
   1. Reiter Dokument
   2. Reiter Einstellungen
   3. Reiter Template Variablen

1. Login und Dashboard

 

Über das Loginformular loggen Sie sich mit den Daten ein, die Sie vom System erhalten haben, wenn ein Benuzter mit Ihrer E-Mail-Adresse eingerichtet wurde. Beachten Sie, dass Ihr Account nach vorher festgelegten (Standard: 3) Fehlversuchen automatisch gesperrt wird.
Sollten Sie einmal die Zugangsdaten nicht zur Hand haben, klicken Sie lieber gleich auf den Link "Zugangsdaten vergessen". Sie bekommen dann sofort eine E-Mail mit weiteren Instruktionen.

Nach dem Login sehen Sie erstmal das Dashboard mit verschiedenen Funktionen, welches nicht zwangsläufig so aussehen muss, da es sein kann, dass es vom Administrator an Ihre speziellen Anforderungen angepasst wurde.

Im oberen Bereich finden Sie die Hauptbereiche Ihres Backends, die ebenfalls an Ihre Bedürfnisse angepasst und verändert worden sein kann. Wahrscheinlich werden z.Bsp. die Punkte System und Sicherheit ausgeblendet sein. Links daneben können Sie Ihr Profil mit Klick auf Ihren Benutzernamen sehen und bearbeiten (z.Bsp. Ihr Passwort ändern) und sich ausloggen.

Im linken Bereich sehen Sie den Ressourcen-Baum, Ihr Hauptnavigationsbereich im Backend. Wir gehen im nächsten Punkt genauer darauf ein.

Im Inhaltsfenster finden die sogenannten Widgets, die zum Beispiel Neuigkeiten, Statistiken, zuletzt bearbeitete Dokumente, aktuell eingeloggte Benutzer etc. beinhalten. Das sind zum Beispiel auch Quicklinks zu immer wiederkehrenden Funktionen, auf die Sie sofort zugreifen können.

Beginnen wir mit dem linken Bereich, dem

2. Ressourcenbaum

2.1 Baummenü

Oben finden Sie die Grundfunktionen des Ressourcenbaums. Der Reihe nach sind dies folgende:

Baum auf und zuklappen

 

Erstellen einer neuen Ressource / Dokument, Weblink, Statische Ressource, Symlink. Hier wird die Ressource direkt im Root abgelegt. Wie Sie eine Ressource an bestimmter Stelle hinzufügen, wird hier erklärt.

Hier aktualisieren Sie den Ressourcenbaum, wenn Änderungen nicht sofort erscheinen oder Sie mit mehreren Tabs gleichzeitig im Manager arbeiten und die letzte Änderung in einem anderen Tab vorgenommen haben.

 

Hier sortieren Sie die Ressourcen nach folgenden Kriterien:
Menüreihenfolge = Die im Baum festgelegte Ordnung | Titel der Ressource | Veröffentlichungs- Zurückziehungs- und Erstellungsdatum | Bearbeitungsdatum | Alias

Hinweis: Die im Baum festgelegte Ordnung (=Menüindex) können Sie durch Drag&Drop direkt im Baum verändern.

Der Papierkorb beinhaltet alle gelöschten Ressourcen. Hier löschen Sie diese endgültig.

 

2.2 Ressourcen

Darstellung der Ressourcen nach Eigenschaften:

• Eine veröffentlichte Ressource wird wird schwarz dargestellt.
• Nicht veröffentlichte Ressourcen werden durch kursive Schrift gekennzeichnet.
• Nicht im Menü angezeigte Ressourcen sind grau.
• Ressourcen, die sich im Bearbeitungsmodus befinden (im Bsp. Container), werden fett dargestellt.

2.2.1 Ressourcen Typen

Es gibt vier verschiedene Ressource-Typen:

• Dokument: Standardressouce für die Datenerfassung
• Weblink: Ein Verweis auf eine interne oder externe Seite
• Symlink: Ein symbolischer Link, ähnlich dem Weblink, wobei diesem ein neues Template zugewiesen werden kann
• Statische Ressource: Die Einbindung von einer Datei bzw. Script über das Filesystem

Am gebräuchlichsten sind die Typen Dokument und Weblink.

2.2.2 Kontextmenü Ressourcenbaum

Über die rechte Maustaste gelangen wir ins Kontextmenü des Ressourcenbaums. Hier können wir schnell die dargestellten Funktionen aufrufen. Um eine Ressource zu bearbeiten, können Sie diese auch einfach anklicken.

Auf einige Funktionen gehen wir hier näher ein:

Ressource bearbeiten = der Hauptinhalt der Ressource öffnet sich im Bearbeitungsmodus. Mehr Informationen zum Bearbeiten von Ressourcen finden Sie im Abschnitt >> Ressource bearbeiten

Ressource schnell bearbeiten = der Hauptinhalt der Ressource öffnet sich in einem Layer, man verlässt nicht den Backendbereich, in dem man sich gerade befindet. Das ist nützlich, wenn man zum Beispiel gerade eine andere Ressource bearbeitet.

Ressource duplizieren = hier duplizieren Sie Ressourcen mit allen Inhalten. Sie können beim Duplizieren wählen, ob die Ressource gleich veröffentlicht werden soll oder nicht.

Erstellen >> Dokument hier erstellen = Mit dieser Funktion erstellen Sie Ressourcen unterhalb des angeklickten Dokuments. Das angeklickte Dokument wird hierduch zum Container. Sie können die Ressourcen auch nachträglich verschieben, hierzu mehr im nächsten Punkt "Ressourcen verschieben".

Schnell erstellen = gleichbedeutend mit Ressource schnell bearbeiten, nur dass hier das Dokument erstellt wird.

Ressource zurückziehen = Veröffentlichte Ressourcen werden hier zurück gezogen. Sie sind noch vorhanden, aber im Frontend nicht sichtbar. Nur eingeloggte Backendmanager können solche Ressourcen auch im Frontend sehen. Sehr nützlich, wenn man ein Dokument in mehreren Schritten bearbeitet und zwischendurch speichert, um sich die Ausgabe im Frontend anzuschauen.

Ressource ansehen = Ausgabe im Frontend betrachten. Es öffnet sich ein neues Fenster bzw. Tab. Über diese Funktion sehen Sie auch Ihre Dokumente, die Sie nicht veröffentlicht haben, oder die durch Setzen "Nicht in Menü anzeigen" unsichtbar im Frontend sind.

Ressource veröffentlichen = Unveröffentlichte Ressouircen werden hier veröffentlicht. Sie sind nun für jeden Besucher sichtbar.
Hinweis: Bei einer veröffentlichten Ressource erscheint der Link "Ressource zurückziehen" und umgekehrt.

Ressource löschen = Das Löschen von Ressourcen, die man nicht mehr benötigt. Hier werden die Ressourcen gelöscht, befinden Sich aber noch im Papierkorb. Eine gelöschte Ressource erkennt man daran, dass Sie rot und durchgestrichen ist.

Im Kontextmenü gelöschter Ressourcen erscheint der Menüpunkt

Ressource wiederherstellen = Für den Fall, dass man sich mal geirrt hat.

2.2.3 Ressourcen durch Drag&Drop verschieben

Durch Halten der linken Maustaste und Schieben der Ressource kann man die Ordnung direkt im Baum verändern:

2.2.4 Kontext

Das Haussymbol steht für den Kontext. Der Kontext ist sozusagen das Wurzelverzeichnis einer Webseite. Mit MODx ist es ganz einfach möglich, über das Anlegen mehrerer Kontexte mehrere Webseiten innerhalb einer Installation zu verwalten, indem mehrere Kontexte mit eigenen Ressourcenbäumen angelegt werden.
Ein Beispiel wäre eine zweisprachige Seite, bei der jede Sprache über ihren eigenen Kontext verwaltet wird. Siehe Abb.

2.3 Elemente

Sind bspw. Template -Variablen für das Erfassen von Inhalten, Templates die die Ausgabe der Inhalte innerhalb des Layouts definieren. Chunks, Snippets, Plug-ins und Komponenten für die Verarbeitung und Ausgabe von Inhalten. Die Seitengestaltung in MODX basiert auf Templates, welche die Struktur und Platzierung von Inhalt von Dokumenten vorgeben. Die Anzahl der Templates ist beliebig. Jedem Dokument kann bei Bedarf ein individuelles Template zugewiesen werden.

Üblicherweise werden Sie als Redakteur nichts mit der Bearbeitung von Backend Elementen zu tun haben. Es ist sehr wahrscheinlich, dass der Tab mittels der Userverwaltung abgeschaltet wurde und Sie ihn garnicht sehen können. Für den entgegen gesetzten Fall finden Sie hier eine kurze Erläuterung. Eventuell wollen oder müssen Sie auch hier einmal Anpassungen vornehmen.

2.3.1 Elemente - das Backend des Administrators

Die Anweisungslogiken sind in Dokumenten, Templates, Chunks und auch in Snippets (über eine PHP-Funktion) einsetzbar. Bei Kundenprojekten eignet sich der Aufruf innerhalb der Templates, damit der Kunde (Laie) die Anweisungen nicht sehen oder manipulieren kann.

Templates

Das HTML-Grundgerüst einer Seite wird einer Ressource zugeordnet und bestimmt dessen Aussehen. Im Template selbst können Platzhalterlogiken (Chunks, Snippets) eingebunden werden.

Templatevariablen

Hier werden die Ausgabeoptionen, Abhängigkeiten, Zuordnungen etc. der Templatevariablen bearbeitet, deren Inhalte Sie im Bearbeitungsmnodus der Ressource bestimmen.
Einbindungssyntax:

Chunks

HTML-Fragmente, werden einmal definiert und können beliebig in Templates, Snippets, Chunks(!) und Plug-ins eingebunden werden. Umgekehrt ist aber auch die Einbindung von Snippets und Chunks möglich und eignen sich vor allem für wiederverwendete Elemente. Einbindungssyntax:

Snippets

Die eigentlichen Erweiterungen von MODx, ohne Snippets geht nichts! Vergleichbar mit Modulen oder Plug-ins bei anderen Systemen. Die Snippets führen PHP-Code aus und haben vollen Zugriff auf das MODx-API. Einbindungssyntax mit optionalen Parametern:

Plug-ins

Eine Art "Event-Override-System" und das Geniale an MODx; Plug-ins führen wiederum PHP-Code mit vollem Zugriff auf das API aus, werden aber keinen Inhalten zugewiesen, sondern greifen bei Events ein. Standardmäßig gibt es ca. 100 Events, welche sowohl für die Frontend-Seitengenerierung, als auch für das Backend eingesetzt werden können. Zum Beispiel: OnParseDocument, OnLoadWebDocument, OnWebAuthentication, OnBeforeManagerPageInit, OnChunkFormPrerender, um nur einige dieser Lebensretter zu nennen.

Kurzum: Bei der Ausführung eines Events wird der PHP-Code angewendet und kann die Ausgabe, den Prozess, die PHP-Variablen uvm. ändern.

Komponenten

Erweitern die Funktionen im Backend, zum Beispiel Newsletter, Massenoperationen, etc.

Übersicht:

Content Elements	Evolution (Version 1)	Revolution (Version 2)
Templates	Zuweisung mittels Auswahl	Zuweisung mittels Auswahl
Template-Variablen	[*templatevar*]
Chunks	{{chunk }}
Snippets
Plug-ins	Zuweisung über Events	Zuweisung über Events
Module	Keine Zuweisung	Komponenten, keine Zuweisung
Content Tags
Platzhalter	[+placeholder+]
Links	[~link~]
Systemeinstellungen	[(system_setting)]
Sprache		language_string_key

 

2.4 Dateien

Bilder und anderweitige Dateien werden im Filemanager verwaltet und angelegt. Die Verwaltung befindet sich ebenso wie die Ressourcen in der linken Spalte des Backends.

Upload und Bearbeitung erfolgen beide über das Kontextmenü – das ist zwar leicht gewöhnungsbedürftig, aber andererseits einfach zu handhaben.

Anleitung Dateien hochladen, zum Beispiel Bilder:

3. Ressource bearbeiten

3.1 Reiter Dokument

Beim Klick auf eine Ressource im öffnet sich die Ressource im Bearbeitungsmodus und standardmäßig im Reiter → Dokument. Hier geben Sie die Daten Ihres Dokuments ein.
Überblick siehe Abb.:

Die wichtigsten Einstellungen im Detail:

Titel*
Pflichtfeld, Titel der Webseite. Erscheint so auch im Seitenbaum links

Langer Titel                           
Wenn definiert, kann dies z.B.die Überschrift 2 im Inhaltsfenster Ihrer Webseite sein.

Beschreibung
Optionale Beschreibung des Dokuments. Wird standardmäßig für den Metatag "description" benutzt und in den Suchergebnissen von Suchmaschinen als Kurzfassung ausgegeben. Es ist immer sinnvoll hier eine kurze Zusammenfassung der jeweiligen Inhalte einzugeben.

Zusammenfassung(Intro-Text)
Optionale Zusammenfassung. Wird eventuell für Zusammenfassungen in Übersichtsseiten verwendet.

Verwendetes Template
Es kann vorkommen, dass Ihre Webseite verschiedene Templates erfordert, weil bspw. Inhalte nur in einem speziellen Bereich angezeigt werden sollen. In diesem Fall schalten Sie das Template unter → Verwendetes Template (siehe Abb.) um.

Beachten Sie: Das Dokument muss ist nach der Umschaltung nur zwischengespeichert. Sie müssen zur Übernahme nochmals auf Speichern klicken!

Ressourcen-Alias       
Name der Url in der Adresszeile. Für obenstehendes Beispiel wäre die Url folgendermassen: http://www.ihreseite.de/container.html

Info: Es kann sein, dass Sie mehr oder weniger Felder sehen oder diese eine andere Bezeichnung haben. Der Administrator hat in diesem Fall das Formular individuell angepasst.

 

3.2 Reiter Einstellungen

3.3 Reiter Template Variablen = Variable Inhalte

Bei MODx ist prinzipiell jedes Formular mit dem Inhalte oder Strukturen (Ressourcen) erfasst werden, gleich aufgebaut, zb. Titel, SEO-Alias, Menütitel, Inhalt.

Nun können mit Template-Variablen einzelne Felder (zb. Text, Rich Text Editor, Bildverknüpfung, Checkbox) einem Inhaltsformular zusätzlich zugewiesen und so können entsprechend die Anforderungen der Seite erweitert werden. Modx bietet hier verschiedene Eingabetypen für unterschiedliche Funktionsweisen an. Im folgenden werden wir kurz auf darauf eingehen.

3.3.1 Templatevariablen Eingabetypen

Auswahlfelder können Checkboxen, Optionsschaltflächen oder Listen sein.

Templatevariablen vom Typ Bild öffnen den Modx Browser, den Sie schon aus der Rubrik "Dateien hochladen" kennen:

Eine typisches Formular für variable Inhalte kann in unterschiedliche Bereiche unterteilt sein (siehe Abb.: Alle Inhalte, Design, Gallery):

Nach oben