Content CMS — Benutzerhandbuch

Willkommen im Content CMS

Das Content CMS ist die zentrale Oberflaeche fuer Webseiten-Inhalte in dbXapp. Hier verwalten Sie Ordner, Seiten, Medien, Rechte und — bei mehreren Sprachen — die Uebersetzungen.

Einstieg: ?dbx_modul=dbxContent_admin&dbx_run1=cms

Die Oberflaeche auf einen Blick

┌─────────────────────────────────────────────────────────────┐ │ Kopfzeile: Speichern | Uebersetzen | Auto-Sync | Loeschen │ ├──────────┬──────────────────────────────┬────────────────────┤ │ LINKS │ MITTE │ RECHTS │ │ Seiten- │ Seiten- oder Ordner-Editor │ Hero, Gallery, │ │ baum │ + Vorschau-Button │ Medien im Text, │ │ + Sprach-│ │ Mehrsprachigkeit │ │ tabs │ │ │ └──────────┴──────────────────────────────┴────────────────────┘

Links: Hierarchischer Baum (Ordner und Seiten). Klick waehlt den Eintrag.
Mitte: Titel, Permalink, Status, Inhalt, Seitenmodule.
Rechts: Hero-Bild, Galerie, Inline-Medien, Uebersetzungs-Einstellungen.
Oben: Sprach-Tabs (z. B. DE*, EN) — Stern = Master-Sprache.

Grundbegriffe

Ordner — strukturiert den Baum (wie Verzeichnisse). Hat Leserechte und optional Hero.
Seite — eigentlicher Inhalt mit Titel, Text, Permalink und Medien.
Permalink — URL-Pfad der Seite (z. B. leistungen/beratung).
Master-Sprache — fuehrende Sprache (meist DE). Aenderungen hier steuern Auto-Sync.
Sprachversion — derselbe Inhalt in einer anderen Sprache, verknuepft ueber interne ID.

Neue Seite anlegen

Im Baum den Zielordner anklicken.
Button Neue Seite (gruen, Datei-Icon).
Titel und Text im Editor bearbeiten.
Speichern (Diskette oder Strg+S).
Bei Master-Sprache: Dialog In andere Sprachen uebertragen oeffnet sich — auch beim Speichern bestehender Seiten, wenn EN/ES noch fehlen.

Beispiel: Ordner „Leistungen“ → Neue Seite → Titel „Beratung“ → Text schreiben → Speichern → EN-Version im Dialog aktivieren → Uebernehmen. EN-Seite ist zunaechst inaktiv.

Neuen Ordner anlegen

Elternordner im Baum waehlen (oder Root).
Neuer Ordner im Baum-Kontext oder ueber die Ordner-Ansicht.
Name, Parent und Leserechte setzen → Speichern.
Wie bei Seiten: Provision-Dialog fuer weitere Sprachen.

Seite oder Ordner bearbeiten

Eintrag im Baum anklicken.
Meta-Felder (Titel, Permalink, Status, Template) anpassen.
Inhalt im Editor aendern — Module per Platzhalter [modul=...].
Medien rechts zuordnen (Hero, Galerie, Im Text).
Speichern. Der Punkt „Gespeichert“ in der Kopfzeile zeigt ungespeicherte Aenderungen.

Medien

Hero — grosses Kopfbild oben auf der Seite.
Galerie — Bildergalerie unter dem Inhalt.
Im Text — Bilder/Videos inline im Editor.
Medien werden im Medienbrowser ausgewaehlt; Dateien bleiben im Bestand, auch wenn Sie die Verknuepfung loesen.

Tipp: Nach dem Speichern in der Master-Sprache werden Medien-Verknuepfungen bei Auto-Sync-Sprachen mit uebernommen.

Mehrsprachigkeit — So funktioniert es

dbXapp trennt Inhalte pro Sprache in eigene Tabellen (content_de, content_en, …). Verknuepft sind sie ueber lng_uid.

Master (DE*) speichern │ ├─► Slave mit Auto-Sync → wird automatisch aktualisiert (Text + Struktur + Medien) │ └─► Slave mit Manuell → bleibt unberuehrt (Fork)

Sprach-Tabs und Badges im Baum

DE*, EN, … — Sprach-Tabs wechseln die Bearbeitungssprache.
Badges am Baumeintrag: Master, auto, manual oder fehlend.
Master (*) — nur hier: Uebertragen, Auto-Sync aktivieren, mehrsprachig Loeschen.

In andere Sprachen uebertragen (Provision)

Seite oder Ordner in der Master-Sprache waehlen.
Button Uebersetzen (Sprachen-Icon) in der Kopfzeile.
Dialog: Zielsprachen aktivieren, Texte pruefen und ggf. anpassen.
Uebernehmen — neue Sprachversionen werden angelegt (Seiten: inaktiv).

Bei Ordnern zusaetzlich: Checkbox Gesamten Unterbaum inkl. Seiten — uebertraegt alle Unterordner und Seiten in einem Schritt (Ordner zuerst, dann Seiten).

Auto-Sync beim Master-Speichern

Wenn Sie eine Seite oder einen Ordner in der Master-Sprache aktualisieren, werden alle verknuepften Slaves mit Status autoim Hintergrund synchronisiert. Sie sehen eine Meldung wie

„2 Sprachversion(en) synchronisiert“.

Texte werden uebersetzt (je nach Provider).
Struktur (Template, Hero-Einstellungen, Sortierung) wird uebernommen.
Status aktiv/inaktiv der Slave-Seite bleibt erhalten.

Fork — Manuelle Abweichung

Speichern Sie in einer Nicht-Master-Sprache, wird die Verknuepfung getrennt (manual). Die Meldung lautet: Sprachverknuepfung getrennt (manuell).

Ab dann uebernimmt der Master diese Sprache nicht mehr automatisch.

Auto-Sync wieder aktivieren

In der Master-Sprache die Seite/Ordner waehlen.
Button Auto-Sync (Link-Icon) in der Kopfzeile.
Bestaetigen — alle verknuepften Slaves erhalten wieder auto.
Naechster Master-Save synchronisiert erneut (ueberschreibt Slave-Inhalte).

Loeschen

Slave-Sprache: Einfache Bestaetigung — nur diese Sprachversion wird geloescht.

Master mit mehreren Sprachen: Dialog mit Checkboxen pro Sprache.

auto-Versionen sind vorausgewaehlt.
manual-Versionen nicht — bewusst ankreuzen, wenn gewuenscht.
Ordner nur loeschbar, wenn keine Unterordner und keine Seiten enthalten sind (pro Sprache geprueft).

Uebersetzung konfigurieren (Admin)

Pfad: Admin → Content → Config oder direkt:

?dbx_modul=dbxContent_admin&dbx_run1=content&dbx_run2=config

Provider	Bedeutung
`copy`	Text unveraendert kopieren (Standard, kein API-Key)
`none`	Uebersetzungsfelder leer lassen
`deepl`	DeepL API — API-Key erforderlich
`openai`	OpenAI Chat API — API-Key + Modell
`custom`	Eigene Logik in `dbx/modules/dbxContent/translate.php`

Bei API-Fehlern: Fallback auf Originaltext, Hinweis im CMS und Eintrag unter Admin → SysMsg (Status warning, About dbxContentTranslate).

Vorschau und Veroeffentlichung

Vorschau (Auge-Icon) — oeffnet die Seite im Frontend.
Status Aktiv/Inaktiv — nur aktive Seiten sind oeffentlich erreichbar.
Neue Slave-Seiten starten als inaktiv — erst nach Pruefung auf aktiv stellen.

Cache

Nach dem Speichern wird der Seiten- und Menue-Cache automatisch invalidiert. Wenn Aenderungen live nicht sichtbar sind:

Admin → Page-Cache pruefen / leeren.
Seite erneut aufrufen (Hard-Reload im Browser).

Tastenkuerzel

Strg + S — Speichern (Seite oder Ordner)

Haeufige Fragen

Warum fehlt EN im Baum?
Seite wurde nur in DE angelegt — Provision-Dialog ausfuehren oder Uebersetzen-Button nutzen.

Warum wird EN nicht mehr aktualisiert?
Slave wurde manuell gespeichert (Fork). Auto-Sync-Button nutzen oder EN erneut bearbeiten.

Hinweis zu Ordnern im Provision-Dialog?
Fehlende Ordner in EN/ES werden beim Uebernehmen automatisch aus der Master-Struktur angelegt (inkl. Elternordner). Im Dialog erscheint ein Hinweis statt eines Fehlers.

Uebersetzung klappt nicht?
Provider und API-Key in Modul-Config pruefen → SysMsg lesen.

Wo finde ich technische Details?
Entwickler-Doku: 04_DBXApp_CMS_Mehrsprachigkeit.md im Projekt.

Typischer Workflow (Mehrsprachige Website)

1. Ordnerstruktur in DE anlegen 2. Seiten in DE schreiben + Medien 3. Provision → EN (und weitere Sprachen) 4. EN pruefen → Status „Aktiv“ 5. Aenderungen nur in DE* → Auto-Sync pflegt EN 6. Spezielle EN-Texte: in EN bearbeiten (Fork)

Beispiel Startseite: DE-Seite „Home“ mit Hero → Provision EN → Titel „Home“ / „Start“ anpassen → EN aktivieren → Permalink pruefen.

Hilfe-Button

Dieses Handbuch ist jederzeit ueber den Hilfe-Button (?) in der CMS-Kopfzeile erreichbar:

?dbx_modul=dbxAdmin&dbx_run1=help&topic=content