MODX Revolution Benutzerhandbuch

Transkript

1 Manual Version 1.0 Datum 20. Januar 2012 MODX Revolution Benutzerhandbuch Anleitung für Content Editoren und Backend Benutzer Aktuelle CMS Version MODX 2.2 Erstellt durch Mail Web cloudtec GmbH Schweiz

2 History Datum Autor Beschreibung ck Erstellung des Dokuments Inhaltsverzeichnis Login (Backend MODX)... 3 Das MODX Backend / Content Manager Seitenbaum Backend Navigation Benutzerverwaltung und Logout Inhaltsseite... 5 Inhalte Editieren... 5 Seitenbaum... 5 Seitenbaum Elemente... 5 Rechte Maustaste im Seitenbaum... 6 Ressource / Dokument erstellen... 6 Ressource / Dokument bearbeiten... 7 TinyMCE Text Editor... 9 Die wichtigsten Funktionen... 9 Bild einfügen Eigenes Bild einfügen Eigenes Bild hochladen Templates und Template Variablen Gut zu Wissen Cache leeren Snippets und Chunks Dateien hochladen... 15

3 Login (Backend MODX) Um optimal arbeiten zu können empfehlen wir die Browser Mozilla Firefox oder Google Chrome zu verwenden. Zugriff auf das Backend erhalten Sie durch eine spezielle URL: 1. Öffnen Sie in ihrem Browser: 2. Geben Sie ihren Benutzernamen ein 3. Geben Sie ihr Passwort ein 4. An mich erinnern (optional) 5. Login klicken Hinweis: Zugriff haben nur Benutzer die im Backend definiert wurden. cloudtec.ch 3

4 Das MODX Backend / Content Manager Ihre Webseite basiert auf dem MODX CMS System, daher haben Sie eine Schnittstelle zum Backend. Im Backend können Sie Inhalte der Webseite einfach erstellen und aktualisieren. Diese Dokumentation basiert auf den Standard Einstellungen von MODX. Es kann sein, dass Sie gewisse Elemente, Navigationseinträge und Felder nicht sehen oder diese anders benannt sind. Nach erfolgreichem Login gelangen Sie auf die Startseite des Backends. 1 Seitenbaum Der Seitenbaum bildet die Navigationsstruktur der Webseite ab. Er enthält sämtliche Inhalte der Webseite. Der Baum lässt sich auf und zuklappen. Elemente innerhalb des Baumes können beliebig verschoben werden. Mehr dazu im Kapitel [ Seitenbaum ]. 2 Backend Navigation Navigieren Sie in den einzelnen Bereichen des CMS Systems. Die Navigation ist aufklappbar und enthält Submenüs. Diese sind mit ein paar Stichworten direkt in der Navigation beschrieben. Durch einen Klick auf Dashboard gelangen Sie immer auf die Startseite des Backends. cloudtec.ch 4

5 3 Benutzerverwaltung und Logout Durch Klick auf ihren Namen können Sie ihr eigenes Profil verändern. Dieselbe Funktion kann ebenfalls über die Navigation Benutzer > Profil aufgerufen werden. Logout beendet die aktuelle Session mit dem CMS System und schliesst den Content Manager. 4 Inhaltsseite In diesem Bereich werden Sie die Inhalte der Webseite bearbeiten. Inhalte Editieren In den meisten Fällen wurde die Struktur für Ihre Webseite durch den Administrator bereits angelegt. Das wichtigste ist der Seitenbaum auf der linken Seite. Seitenbaum Die Struktur der Webseite wird in diesem Baum abgebildet. Eine Seite / Dokument wird in der MODX Terminologie als Ressource bezeichnet. Der Baum stellt Seiten und Ordner je nach Zustand unterschiedlich dar. Einzelne Seiten oder ganze Ordner können innerhalb des Baumes per Drag and Drop verschoben werden. Dazu mit der Maus auf ein Element klicken und dies mit gedrückter Maustaste verschieben. Seitenbaum Elemente Kontext. Root der Webseite. (oberste Ebene im Baum) Element ist ausgeklappt Element ist zugeklappt Ordner im Baum (Enthält Ressourcen im Ordner) Reguläre Seite Reguläre Seite die gerade bearbeitet wird (Fett) Seite die noch nicht veröffentlicht ist, daher online nicht sichtbar (kursiv) Seite die öffentlich ist, jedoch nicht in der Seitennavigation erscheinen soll. (hellgrau) Nichtveröffentlichte Seite, die nicht im Menü erscheinen soll (hellgrau und kursiv) Eine gelöschte Ressource (rot, durchgestrichen) Verschieben an diese Position nicht möglich Verschieben zwischen diese Ressourcen cloudtec.ch 5

6 Verschieben in diese Ressource (Wird die Elternressource in einen Ordner umwandeln) Baum aufklappen Baum zuklappen Neues Dokument Baum aktualisieren Sortieroptionen anzeigen Baum durchsuchen Rechte Maustaste im Seitenbaum Mit einem rechten Mausklick auf eine Ressource kann das Kontext Menü geöffnet werden. Hier stehen alle verfügbaren Aktionen, die auf diese Ressource angewendet werden können. Ressource / Dokument erstellen Ein Rechtsklick im Baum öffnet das Kontext Menü. Im Bild befindet sich der Mauszeiger über Plastik. Im Menü können wir nun Erstellen > Dokument hier erstellen wählen. Das Dokument wird nun innerhalb des Ordners Plastik an letzter Stelle kreiert. Auf der rechten Seite öffnet sich nun ein leeres Formular. Dort können Sie Angaben zum Dokument wie Titel, Beschreibung und Inhalt machen. Das Formular zum Erstellen oder Bearbeiten ist im Normalfall identisch. Daher werden die Funktionen im nächsten Punkt beschrieben. cloudtec.ch 6

7 Ressource / Dokument bearbeiten Durch Klick auf eine bestehende Ressource / Dokument des Backends das Formular zum Bearbeiten der Seite. öffnet sich rechts im Inhaltsbereich Folgende Felder stehen standardmässig zur Auswahl. Es kann sein, dass Sie mehr oder weniger Felder sehen oder diese eine andere Bezeichnung haben. Der Seitenadministrator hat in diesem Fall das Formular individuell angepasst. Ganz oben sehen Sie zwei Reiter Standardmässig öffnet sich die Ressource im Reiter Dokument. Hier können Sie nachstehende Angaben einfügen. Titel* Langer Titel Beschreibung Zusammenfassung (Intro Text) Verwendetes Template Ressourcen Alias Pflichtfeld, Titel der Webseite. Erscheint so auch im Seitenbaum links Wenn definiert, kann dies z.b. die Überschrift 2 sein Optionale Beschreibung des Dokuments. Funktion muss durch den Administrator in die Webseite integriert werden Optionale Zusammenfassung. Funktion muss durch den Administrator in die Webseite integriert werden Hier kann das Layout der Webseite ausgewählt werden. Templates werden vom Administrator definiert. Wenn Sie verschiedene Seitenarten haben. Z.B. eine Seite für Blog Einträge, eine spezielle Seite für Fotos und eine Seite die ohne Navigation auskommen soll, wird dies meistens in Templates definiert. Wenn Sie nun ein Dokument erstellen müssen Sie den Typ definieren in dem Sie das Template wählen. Mehr dazu unter Templates [ Templates und Template Variablen ]. Name der Url in der Adresszeile. Für obenstehendes Beispiel wäre die Url folgendermassen: seite oeffentlich.html cloudtec.ch 7

8 Menü Titel Link Attribute Nicht in Menüs anzeigen Nicht veröffentlicht Alternativer Menü Titel Text. Normalerweise wird der Seitentitel auch für den Menü Eintrag verwendet. Da dieser jedoch manchmal zu lang sein kann, kann hier alternativ ein kürzerer / anderer Menü Titel eingetragen werden. Werden normalerweise durch den Administrator definiert Ist das Häcklein gesetzt erscheint die Ressource nicht im Menü der Webseite Ist dieses Häcklein gesetzt ist die Seite veröffentlicht und im Web sichtbar. Eine nicht veröffentlichte Seite kann bearbeitet werden und erst nach Fertigstellung veröffentlicht werden. Der Stand einer nicht veröffentlichten Webseite kann mit Vorschau immer abgerufen werden. Eine nicht veröffentlichte Seite ist links im Seitenbau kursiv dargestellt. Falls Sie eine neue Seite erstellen und diese einfach nicht auf der Webseite erscheint ist dies meist der Grund dafür. Setzen Sie dann die Seite auf Veröffentlicht. Unter dem Reiter Einstellungen können Spezialeinstellungen für das Dokument gemacht werden. Im Normalfall müssen Sie diese nicht beachten und können mit den Standardeinstellungen arbeiten. Folgende Einstellungen können unter Einstellungen für das Dokument gemacht werden: Eltern Ressource Ressourcen Typ Content Type Content Disposition Menü Index Veröffentlicht am Veröffentlichen am Zurückziehen am Container Durchsuchbar Ändern der Position im Seitenbaum. Hat den selben Effekt wie das Drag and Drop mit der Maus, daher ist die Funktion nicht relevant. Ist standardmässig auf Dokument. Hier können im Spezialfall andere Typen gewählt werden. Der Administrator würde Sie darüber informieren. Der Inhaltstyp dieser Ressource. Wenn Sie nicht sicher sind, welchen Inhaltstyp die Ressource haben sollte, belassen Sie einfach bei text/html. Verwenden Sie das Content Disposition Feld, um festzulegen, wie die Ressource vom Browser verarbeitet wird. Für Datei Downloads verwenden Sie die Option "Attachment". Dies gibt die Position der Ressource im Baum an. Es wird normalerweise für die Festlegung der Reihenfolge bei der dynamischen Anzeige von Ressourcen verwendet (z. B. in Menüs). Einige Komponenten könnten diese Einstellung ignorieren. Zeigt, wann das Dokument veröffentlicht wurde. Diese Funktion kann hilfreichs sein, falls Sie ein Dokument an einem bestimmten Datum automatisch aufschalten möchten. Mit dieser Funktion können Sie ein bereits veröffentlichtes Dokument an einem bestimmten Datum wieder zurückziehen. Z.B nützlich bei Newseinträgen die auf einen Eventhinweisen. Dann kann das Datum auf das Ende des Events gesetzt werden und die Ressource wird an besagtem Tag automatisch zurückgezogen Wenn diese Einstellung aktiviert ist, fungiert die Ressource auch als Container für andere Ressourcen. Ein "Container" ist wie ein Ordner, nur dass er selbst auch einen Inhalt haben kann. Wenn diese Einstellung aktiviert ist, kann die Ressource durchsucht werden. Diese Einstellung kann in Ihren Snippets auch für andere Zwecke verwendet cloudtec.ch 8

9 werden. Richt Text Editor verwenden URI fixieren Cache aktiv Cache leeren Gelöscht Wenn diese Einstellung aktiviert ist, nutzt MODX den Rich Text Editor zum Bearbeiten von Ressourcen. Wenn Ihre Ressourcen JavaScript und Formulare enthalten, deaktivieren Sie diese Einstellung, um die Bearbeitung im HTML Modus vorzunehmen, damit der Editor Ihre Ressourcen nicht durcheinanderbringt. Hier ein Häkchen zu setzen erlaubt Ihnen, den URI für diese Ressource auf den Wert im Textfeld darunter zu fixieren. Wenn diese Einstellung aktiviert ist, wird die Ressource in den Cache übernommen. Wenn diese Einstellung aktiviert ist, leert MODX den Cache nach dem Speichern der Ressource. Auf diese Weise sehen Besucher Ihrer Site keine ältere Version der Ressource. Zeigt an ob das Dokument gelöscht ist. Durch unchecken des Häckleins kann das Dokument wiederhergestellt werden. Speichern der änderungen Duplizieren des Dokuments Löschen Vorschau der Seite Schliessen des Dokuments Aktion nach dem Schliessen TinyMCE Text Editor Dieser Text Editor ermöglicht es Ihnen ihre Texte in einer einfachen Art und Weise zu bearbeiten. Die Funktionalität ist an Word und andere gängige Text Editoren angelehnt. Wenn Sie mit der Maus über ein Icon fahren wird die Funktion des Icons kurz erläutert. Die Darstellung der Texte im Editor, Grösse der Überschriften, Textabstände und auch die Schriftart können je nach Konfiguration vom Textlayout auf der Webseite abweichen. Die wichtigsten Funktionen Texte können Sie aus anderen Programmen ganz leicht einfügen. Normalerweise machen Sie dies mit der Copy/Paste Funktion oder der Tastenkombination CTRL+C und CTRL+V. Falls Sie nun einen Text aus dem Word kopieren und dessen Formatierungen nicht übernehmen möchten: Dann hilft dieses Icon Ihnen die Texte ohne Formatierung einzufügen. cloudtec.ch 9

10 Diese Funktion ist speziell für Texte aus Word gedacht. Der Editor übernimmt dann Formatierungen direkt aus dem Word. Der Texteditor kann manchmal etwas verwirrend sein und etwas verrücktspielen. Eventuell sind gewisse Elemente durcheinander geraten. Durch klicken auf den Pinsel wird der Code im Hintergrund aufgeräumt. Vielleicht hilft s. Falls Sie direkt den Code bearbeiten möchten klicken Sie auf das HTML Icon. Setzt technische Kenntnisse voraus. Hier können Sie wie im Word die Überschrift und Absatztypen wählen. Markieren Sie dazu den Text den Sie z.b. als Überschrift festlegen möchten und klicken Sie auf die gewünschte Überschriftsgrösse. Sie können auch Links direkt in den Text integrieren. Links zu anderen Websites oder auch zu anderen Seiten in Ihrer Webseite. Markieren Sie den Text, den Sie in einen Link umwandeln möchten und klicken Sie auf das Link Icon. Adresse Fenster Hier können Sie einen externen Link angeben Hier definieren Sie, ob die Seite in einem neuen oder im selben Fenster geöffnet wird Titel Titel der erscheint wenn mit der Maus über den Link gefahren wird, ist optional Seite suchen Falls Sie eine interne Seite verlinken möchten geben Sie den Titel oder die ID Nummer der Seite ein. Ein Pulldown mit Vorschlägen hilft ihnen dabei die richtige Seite auszuwählen. Wenn Sie eine Datei verlinken möchten klicken Sie auf dieses Icon direkt neben Adresse. Hier fügen Sie ein Bild ein. Wird separat in diesem Dokument behandelt. Bild einfügen Sie können auch Bilder zum Text einfügen. Klicken Sie mit dem Mauszeiger an den Ort im Text, wo Sie das Bild einfügen möchten. Danach auf das Bild Icon: cloudtec.ch 10

11 Ein kleines Fenster öffnet sich. Adresse Externe URL oder um ein eigenes Bild auszuwählen klicken Sie auf Beschreibung Beschreibung des Bildes Titel Text der beim Mouseover erscheint Eigenes Bild einfügen Es öffnet sich der File Browser von MODX. Hier sehen Sie linkerhand die Ordnerstruktur. Klicken Sie auf den gewünschten Ordner und Sie sehen in der Mitte kleine Vorschaubilder. Ein Klick auf ein Bild markiert dieses. Mit OK können Sie das Bild auswählen. Der File Browser schliesst sich und Sie sehen nochmals das kleine Popup Fenster nun mit einem Vorschau Bild. Durch Klicken auf Einfügen fügen Sie das Bild in den Text Editor ein. cloudtec.ch 11

12 Klicken Sie einmal auf das Bild und Sie können die Grösse skalieren. Es ist ebenfalls möglich die Ausrichtung zu definieren. Ob links stehend, rechts, Text umfliessend, etc. Eigenes Bild hochladen Der MODX File Browser unterstütz natürlich auch den File Upload. Wählen Sie links den Zielordner aus, wo das Foto oder die Fotos hochgeladen werden sollen. Klicken Sie oben auf Datei hochladen. cloudtec.ch 12

13 Hier klicken Sie nun auf Hinzufügen um Ihre Fotos in die Upload Warteschlange zu setzen. Wählen Sie nun einzeln Fotos von ihrem lokalen Dateisystem aus. Die Dateien werden nun für den Upload vorgemerkt. Danach klicken Sie auf Hochladen. Nach erfolgreichem Upload werden die Fotos mit OK gekennzeichnet. Schliessen Sie das kleine Fenster um zum File Browser zurückzukehren. Ihre hochgeladenen Bilder sollten nun als Miniatur Bilder im Ordner erscheinen. Diese können Sie nun auswählen und auf Ihrer Webseite verwenden. cloudtec.ch 13

14 Templates und Template Variablen Es kann sein, dass Ihre Webseite verschiedene Templates / Seiten Layouts hat um Inhalte darzustellen. Diese werden normalerweise vom Administrator erstellt. Wenn Sie verschiedene Seitenarten haben. Z.B. eine Seite für Blog Einträge, eine spezielle Seite für Fotos und eine Seite die ohne Navigation auskommen soll, wird dies meistens in Templates definiert. Als Beispiel können wird das Template Foto mit Text nehmen. Es ist ein individuelles Template und wird bei Ihnen so nicht angezeigt werden. Das Template wurde speziell programmiert, damit nur ein grosses Bild auf der Webseite angezeigt wird. Dazu soll eine kleine Beschreibung kommen. Beim Erstellen des neuen Dokuments wählen Sie nun Foto mit Text, da Sie ja eine solche Foto Seite erstellen möchten. Falls Sie eine Seite bearbeiten und das Template bereits ausgewählt ist und Sie dies ändern kommt die folgende Warnung: Die Warnung ist selbsterklärend und muss mit Ja bestätigt werden um fortzufahren. Einem Template können zusätzlich Variablen hinzugefügt werden, dies wird ebenfalls durch den Administrator erledigt und ist vorgegeben. Ob Template Variablen definiert sind, erkennen Sie am Reiter Template Variablen. Wie der Reiter Template Variablen gestaltet ist hängt alleine von der Konfiguration des Administrators ab. Für unser Beispiel verwenden wir zwei Variablen. Das Foto und eine Bildunterschrift. Hier wählen Sie nun mit dem MODX File Browser ein Bild aus. Zur Kontrolle wird es als Miniatur Bild angezeigt. Die Änderungen die Sie hier machen müssen gespeichert werden um diese auf der Webseite zu aktivieren. cloudtec.ch 14

15 Gut zu Wissen Ein paar Tipps. Cache leeren Es kann hilfreich sein, wenn auf der Webseite alter Inhalt stehen geblieben ist oder der neue Inhalt einfach nicht erscheinen will, kurz den Cache zu leeren. Dadurch muss das System die Webseite im Hintergrund neu generieren und verwendet dazu den aktuellen Code. Snippets und Chunks Sind weitere Elemente im CMS System. Snippets basieren auf der Programmiersprache PHP und enthalten Code. Dieser kann durch ein spezielles Text Tag in Felder oder auch in den Inhaltsbereich der Seite eingefügt werden. Chunks sind kleine Code Schnipsel, diese jedoch nur in reinem HTML. Ein Snippet wird folgendermassen aufgerufen: [[meinsnippet]] oder [[!meinsnippetohnecache]] Ein Chunk: [[$meinchunk]] Template Variablen können auch im Text stehen [[*meinetemplatevariable]] Falls Sie solche Code Elemente in dem Inhaltsbereich entdecken, diese bitte nicht löschen. Normalerweise werden sie vom Administrator gesetzt. Auf der Webseite werden diese komplett durch Code ersetzt. Der Webseitenbesucher sieht folglich nur was das Snippet oder das Chunk aufruft und nicht den effektiven. Dateien hochladen Sie haben natürlich auch die Möglichkeit Dateien hochzuladen, Verzeichnisse zu erstellen, etc Je nachdem welche Berechtigungen der Administrator für Sie eingestellt hat. Links im Seitenbaum haben Sie zwei Reiter. Der Zweite ist Dateien. Mit diesen Icons können Sie Verzeichnisse erstellen, oder Dateien hochladen. öffnet den MODX File Browser cloudtec.ch 15