Welcome to Content CMS
The Content CMS is the central interface for website content in dbXapp. Here you can manage Folders, Pages, Media, Rights and, for several languages, the Translations.
Entry: ?dbx_modul=dbxContent_admin&dbx_run1=cms
The surface at a glance
┌────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
│ Header: Save | Translate | Auto-Sync | Delete │
├────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
│ LINKS │ MIDDLE │ RIGHT │
│ Page or folder editor │ Hero, Gallery, │
│ baum │ + preview button │ Media in text, │
│ + Language │ │ Multilingualism │
│ tabs │ │
└────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
- Left: Hierarchical tree (folder and pages). Click selects the entry.
- Centre: Title, Permalink, Status, Content, Page Modules.
- Right: Hero image, gallery, inline media, translation settings.
- Above: Language tabs (e.g. DE*, EN) — star = master language.
All buttons of the CMS header
| Button | Function | Important note |
|---|---|---|
| In/out Content Tree (X/arrow) | Hide the left side tree on or off. | Does not change data. |
| Storage (diskette) | Saves the currently edited page or the opened folder together with settings. | Alternative Strg+S. The status point then changes to “Stored”. |
| Translating (languages) | Transfers the selected page or folder from the master language to other languages. | Only visible in the master language. |
| Auto-Sync (chain link) | Manually uncoupled language versions with the master again. | Other master changes can rewrite the target languages. |
| Deletion (paper basket) | After confirmation, deletes the current page or the opened folder. | In the case of several languages, a selection of the language versions to be deleted appears. |
| Preview (eye) | Opens the current page in the frontend preview. | Unstored changes are not yet included. |
| New page (green button with file-plus) | Creates a new page with standard content in the selected folder and opens it directly. | Before in the tree choose the desired destination folder. |
| Duplicate page (Two files) | Creates a new, unique copy of the currently selected page in the same folder. | First save. The permalink is automatically -kopie, -kopie-2 etc. made clear. |
| Reload (circular arrow) | Laedt Baum and current data status again from the server. | Unstored changes can be lost. |
Stored/unstored is not a button, but the status indicator for changes in the form or editor.
Buttons in the page tree and in the folder form
| Button | Function |
|---|---|
| New folders (folder-plus) | Opens an empty folder form; The previously selected folder is proposed as an assignment. |
| New page in the folder (File Plus) | Corresponds to the green button "New page" and uses the currently selected folder. |
| Search | Filters the tree by page/folder name; an input numerical ID can be found in a targeted manner. |
| Language tab (DE*, EN, ...) | Changes the CMS dataset to the selected language. The star indicates the master language. |
| Folder open/fold (Arrow) | Show or hide the subordinate entries. |
| Filing folders (pen) | Opens name, assignment, template and read rights of the folder. |
| Closure (X in the folder form) | Closes the folder form and shows the page editor again. |
| Delete the folder | Delete an empty folder after confirmation. |
| Store folders | Saves all fields of the folder form. |
Buttons for hero, gallery and media in text
| Button | Function |
|---|---|
| Area open/folded (Arrow to Hero, Gallery or In Text) | Hides the settings of the respective area on or off. |
| Hero – Selection | Opens the media browser and selects exactly one hero image or video for the page. |
| Hero – Saving | Saves Hero Medium and all Hero settings along with the page. |
| Gallery – Selection | Assigns one or more media for the gallery to the page. |
| Gallery – Saving | Saves gallery settings and the current order. |
| In the text – Selection | Select a medium from the media browser and insert it into the editor content. |
| Add Medium to Editor (Image symbol on the medium) | Enters the already assigned medium at the current cursor position. |
| Remove assignment (Paper basket on medium) | Remove the medium from this page. The file itself remains in the media management. |
Gallery media can be sorted by drag-and-drop. Duplication does not duplicate any image or video files; the new page receives its own active entries into media_usageThey point to the same media.
Buttons in the Content Editor
| Button | Function |
|---|---|
| Source text | Alternates between visual editing and HTML source text. |
| Store everything | Saves page, editor content and page settings. |
| Text style | Sets drawing formattings such as bold, italic, underlined or crossed out. |
| Tension | Create a disordered list. |
| Numbering | Create an ordered list. |
| Routing | Reduces the current paragraph or list entry. |
| Rows | Increases the current paragraph or list entry. |
| Sales format | Select paragraph, headline or another block format. |
| Colour (brush) | Sets text or background color. |
| Link | Creates or processes a reference. |
| Image/Media browser | Select an image from the CMS media administration and insert it. |
| Module | Give one dbXapp-Module placeholder with the necessary parameters. |
| BootstrapComponent | Includes prepared layout components such as maps or grids. |
| Video | Insert a video or video link. |
| Dividing line | Insert a horizontal dividing line. |
| Markers | Give one dbXappstructural markers, for example for columns or content regions. |
| Reversible | Takes back the last processing step. |
| Repeat | Restore the last step undone. |
| Full picture | Increases the editor to the entire available area. |
All input fields of a page
| Field | Significance |
|---|---|
| Title | Visible page title and designation in the page tree. |
| Permalink | Unique URL path without domain and without leading slash, for example leistungen/beratung. When duplicated, it is automatically unambiguously extended. |
| Content template | Determines the frame and content areas of the page. parent Takes over the default of the folder. |
| Status | Active publishes the page; Inactive Hid it for ordinary visitors. |
| Description | Short description of the page with a maximum of 254 characters; is also used for teaser or metadata depending on the output. |
| Content | The large visual editor for text, links, media, modules and layout components. |
The technical fields ID and Folder ID are managed automatically and are therefore not visible as normal input fields.
All Hero and Gallery fields
| Field | Significance |
|---|---|
| Hero – Template | Determines whether and how the Hero medium will be spent. parent Takes over the folder setting; none Turn off the hero. |
| Hero – Medium | is set over "Selection"; the media ID remains hidden and is automatically managed. |
| Hero – Distance above | Controls the upper distance. parent Takes over the default of the folder. |
| Hero - Highehe | Controls the display height of the Hero area; parent Takes over the specification. |
| Hero – Variant | Select the color/overlay variant, for example original, light, dark or monochrome. |
| Hero sticky | Determines whether the hero remains fixed when scrolling. parent Takes over the folder setting. |
| Scroll level | Determines whether the Hero is under or over the content when scrolling. |
| Gallery – Overflow | Determines the presentation in many media, for example grid, slider or a limited view. |
| Gallery – Click | Determines the action when clicking on a gallery medium, for example Lightbox, Link or no action. |
All input fields of a folder
| Field | Significance |
|---|---|
| Name | Name of the folder in the page tree and basis for new permalinks. |
| Assignment | Choose the parent folder. “Root / first level” puts the folder at the top. |
| Content template | Standard template for child pages. parent Take the higher level. |
| Reading rights | Specifies which user groups are allowed to read content of this folder. parent assumes the rights of the parent folder; * All allowed. |
Further selection and dialog fields
- Tree search: Snag the visible pages and folders.
- Media advertisement: Filters associated media by All, Gallery, Hero, Text or Shop.
- Media folder/upload destination: determines from which media folder is displayed or uploaded to which folder.
- File selection: Select one or more local files for the upload.
- External video URL: records an supported video URL, for example YouTube.
- Activate the target language: specifies in the translation dialog which language versions are created or updated.
- Entire subtree incl. Pages: For folders also covers all subfolders and pages.
Basic concepts
- Folders — structure the tree (like directories). Has Reading Rights and optional Hero.
- page — actual content with title, text, permalink and media.
- Permalink — URL path of the page (e.g.
leistungen/beratung). - Master language – leading language (usually DE). Changes here control Auto-Sync.
- Language version — same content in another language, linked to internal ID.
Creating a new page
- In the tree the Destination folder Click.
- Button New page (gruen, file icon).
- Edit title and text in the editor.
- Storage (disc) or Strg+S).
- In Master Language: Dialogue Translate into other languages opens — even when saving existing pages, if EN/ES is still missing.
Example: Folder “Services” → New page → Title “Consultation” → Write text → Save → Enable EN version in dialogue → Take over. EN-page is first Inactive.
Duplicate existing page
- In the tree to be copied page Click.
- If "Unstored" appears, first Storage.
- To the right of the green button "New Page" Duplicate page (Two files) click.
- The new page is created in the same folder and immediately opened in the editor.
The copy receives a new page ID, a new language link and a new sorting position. Title, status, SEO fields, content, hero/gallery settings and media will be preserved. The permalink is automatically ...-kopie set; It already exists, follows ...-kopie-2 etc.
Media: The files are not physically multiplied. For Hero, gallery and other areas create their own
media_usage-Assignments to the new page; Inline media are reassigned from the copied editor content.Create new folders
- Choose parent folders in the tree (or root).
- New folders in the tree context or via the folder view.
- Name, Parent and Reading Rights Set → Save.
- As with pages: commission dialogue for other languages.
Editing page or folder
- Click entry in the tree.
- Adjust meta fields (title, permalink, status, template).
- Change content in the editor — Modules by placeholder
[modul=...]. - Assign media to the right (hero, gallery, in text).
- storage. The saved point in the header shows unstored changes.
Media
- Hero — Big head image at the top of the page.
- Gallery — Picture gallery under the content.
- In text — Pictures/videos inline in the editor.
- The media are in Media browsers selected; Files remain in stock even if you remove the link.
Tip: After storing in the master language, media connections are taken over in auto-sync languages.
Multilingualism — This is how it works
dbXapp separates content per language into its own tables ()content_de, content_en, ... They are bound to lng_uid.
Store master (DE*)
│
├─► Slave with Auto-Sync → is automatically updated (text + structure + media)
│
└─► Slave with manual → remains unaffected (fork)
Language tabs and badges in the tree
- DE*, EN, ... — Language tabs change the editing language.
- Badges at the tree entry: master, auto, manual or missing.
- Master (*) — only here: Transfer, activate auto-sync, delete multilingually.
Transferred to other languages (provision)
- The page or folder in the Master language Voting.
- Button Translating (Language icon) in the header.
- Dialogue: activate target languages, check texts and adjust them if necessary.
- Takeover — new language versions are created (pages: inactive).
In Folders Additional: Checkbox Entire subtree incl. Pages — submits all subfolders and pages in one step (folder first, then pages).
Auto-Sync in master storage
If you have a page or folder in the master language UpdateAll connected slaves with status auto Synchronized in the background. You will see a message like “2 language version(s) synchronized”.
- Texts are translated (depending on the provider).
- Structure (template, hero settings, sorting) is taken over.
- Status active/inactive The slave page is retained.
Fork — Manual deviation
Save them in one Non-master language, the connection is separated ()manual) The message reads: Language connection separately (manually).
From then on, the master no longer automatically adopts this language.
Activate Auto-Sync again
- Select the page/folder in the master language.
- Button Auto-Sync (Link icon) in the header.
- Asserting – all connected slaves get back
auto. - Next master save syncs again (rewrites slave content).
Deletion
Slave language: Simple confirmation — only this language version is deleted.
Master with several languages: Dialogue with checkboxes per language.
auto-Versions are preset.manual-Versions not - deliberately tick if desired.- Folder can only be deleted if there are no subfolders and no pages (checked per language).
Configure translation (admin)
Path: Admin → Content → Config or directly:
?dbx_modul=dbxContent_admin&dbx_run1=content&dbx_run2=config
| Providers | Significance |
|---|---|
copy | Copy text unaltered (default, no API key) |
none | Leave translation fields empty |
deepl | DeepL API — API Key Required |
openai | OpenAI Chat API — API Key + Model |
custom | own logic in dbx/modules/dbxContent/translate.php |
For API errors: fallback to original text, note in the CMS and entry under Admin by SysMsg (status) warning, About dbxContentTranslate).
Preview and publication
- Preview (eye icon) — opens the page in the frontend.
- Status Active/Inactive — only active pages are publicly accessible.
- New slave sites start as Inactive — only set to active after verification.
Cache
After saving, the guest full page cache is automatically invalidated. For Gaeste, it stores the complete final output of valid permalink calls including design, menues and modules. Registered users remain dynamic. If changes are not visible live:
- Admin → check page cache / empty.
- Call up the page again (hard reload in the browser).
Keystrokes
- Strg + S — Save (page or folder)
Frequent questions
Why is EN missing in the tree?
Page was created only in DE – Run commission dialogue or use the translation button.
Why is EN no longer updated?
Slave was stored manually (fork). Use Auto-Sync button or re-edit EN.
Note about folders in the commission dialog?
Missing folders in EN/ES are automatically created from the master structure (including parent folders) when transferred. In the dialog, a hint appears instead of an error.
Does translation not work?
Provider and API key in Modul-Config check → Read SysMsg.
Where can I find technical details?
Developer documentary: 04_DBXApp_CMS_Mehrsprachigkeit.md in the project.
Typical workflow (multilingual website)
1. Create folder structure in DE
2. Write pages in DE + Media
3. Commission → EN (and other languages)
4. EN test → Status “Active”
5. Changes only in DE* → Auto-Sync maintains EN
6. Special EN texts: Edit in EN (Fork)
Example homepage: DE page “Home” with Hero → Commission EN → Adapt title “Home” / “Start” → Activate EN → Permalink check.
Help button
This manual is always about the Help button (?) accessible in the CMS header:
?dbx_modul=dbxContent&dbx_run1=help&topic=content