---
title: "Website"
description: "Seiten und Formulare. Jede App ist ein Modul auf einem gemeinsamen Datenmodell."
canonical: "https://obop.dev/de/apps/website/"
lang: "de"
---

# Website

## Wofür sie gedacht ist

Hold the content of a public website: pages, menus, blog posts and the form submissions visitors send. This app stores and organises content; something else renders it. Publishing needs approval.

## Was das Paket leistet und was nicht

Content for a public website: pages with a slug and a draft, published, archived flow, navigation menu items, blog posts with a byline and a publish date, translations of both, and the form submissions visitors send in. When the instance runs with the public site enabled it serves the published content to visitors as a server-rendered website with SEO and no login; only the fields marked public are ever visible to them. Publishing makes content public and needs a human approval, agents may only propose it. Senders are personal data and are never public.

## Modelle

### `website_page`

A page of the website

Lesegruppe: `website.user`. Schreibgruppe: `website.user`.

| Feld | Art | Datenklasse | Personenbezogene Daten | Gruppe | Agenten sehen | Beschreibung |
|---|---|---|---|---|---|---|
| `title` | text | `none` | nein | `website.user` | im Klartext | Page title |
| `slug` | text | `none` | nein | `website.user` | im Klartext | URL path of the page without slashes at the ends, lowercase with dashes, for example about-us. The page with slug home is the front page |
| `body` | longtext | `none` | nein | `website.user` | im Klartext | Page content in Markdown (a safe subset: headings, lists, links, emphasis, code, quotes, tables) |
| `seo_title` | text | `none` | nein | `website.user` | im Klartext | Title shown in search results; empty means the page title |
| `seo_description` | text | `none` | nein | `website.user` | im Klartext | Description shown in search results |
| `published_on` | date | `none` | nein | `website.user` | im Klartext | Day the page went public (YYYY-MM-DD) |
| `state` | select (draft, published, archived) | `none` | nein | `website.user` | im Klartext | Page status: draft, published, archived |

### `website_menu_item`

An entry of the site navigation

Lesegruppe: `website.user`. Schreibgruppe: `website.manager`.

| Feld | Art | Datenklasse | Personenbezogene Daten | Gruppe | Agenten sehen | Beschreibung |
|---|---|---|---|---|---|---|
| `label` | text | `none` | nein | `website.user` | im Klartext | Text shown in the menu |
| `url` | text | `none` | nein | `website.user` | im Klartext | Where the entry leads: a page slug starting with a slash or a full address |
| `parent_id` | ref → website_menu_item | `none` | nein | `website.user` | im Klartext | The entry this one is nested under; empty for a top-level entry |
| `sequence` | number | `none` | nein | `website.user` | im Klartext | Order among its siblings, lowest first |
| `visible` | bool | `none` | nein | `website.user` | im Klartext | Whether the entry is shown |
| `new_window` | bool | `none` | nein | `website.user` | im Klartext | Whether the link opens in a new window |

### `website_blog_post`

A blog post

Lesegruppe: `website.user`. Schreibgruppe: `website.user`.

| Feld | Art | Datenklasse | Personenbezogene Daten | Gruppe | Agenten sehen | Beschreibung |
|---|---|---|---|---|---|---|
| `title` | text | `none` | nein | `website.user` | im Klartext | Post title |
| `slug` | text | `none` | nein | `website.user` | im Klartext | URL part of the post, lowercase with dashes |
| `author_name` | text | `public_directory` | ja | `website.user` | maskiert | Name of the author, for the team's own records |
| `byline` | text | `none` | nein | `website.user` | im Klartext | Author line shown publicly, for example the team or brand name; use a name here only if the person agreed to it |
| `summary` | text | `none` | nein | `website.user` | im Klartext | Teaser shown in listings |
| `body` | longtext | `none` | nein | `website.user` | im Klartext | Post content in Markdown (a safe subset: headings, lists, links, emphasis, code, quotes, tables) |
| `tags` | text | `none` | nein | `website.user` | im Klartext | Comma-separated tags, for example news,product |
| `published_on` | date | `none` | nein | `website.user` | im Klartext | Day the post is dated (YYYY-MM-DD) |
| `state` | select (draft, published, archived) | `none` | nein | `website.user` | im Klartext | Post status: draft, published, archived |

### `website_form_submission`

A message a visitor sent through a form on the site

Lesegruppe: `website.user`. Schreibgruppe: `website.user`.

| Feld | Art | Datenklasse | Personenbezogene Daten | Gruppe | Agenten sehen | Beschreibung |
|---|---|---|---|---|---|---|
| `form_name` | text | `none` | nein | `website.user` | im Klartext | Which form it came from, for example contact |
| `sender_name` | text | `internal` | ja | `website.user` | maskiert | Name the visitor gave |
| `sender_email` | text | `internal` | ja | `website.user` | maskiert | Email address the visitor gave |
| `sender_phone` | text | `internal` | ja | `website.user` | maskiert | Phone number the visitor gave |
| `message` | longtext | `internal` | ja | `website.user` | maskiert | What the visitor wrote |
| `source_page` | text | `none` | nein | `website.user` | im Klartext | Slug of the page the form was on |
| `submitted_on` | date | `none` | nein | `website.user` | im Klartext | Day of the submission (YYYY-MM-DD) |
| `consent_given` | bool | `none` | nein | `website.user` | im Klartext | Whether the visitor ticked the consent box for being contacted |
| `state` | select (new, handled, spam) | `none` | nein | `website.user` | im Klartext | Handling status: new, handled, spam |

### `website_page_translation`

A page translated into another language; the public site shows it to visitors who read that language

Lesegruppe: `website.user`. Schreibgruppe: `website.user`.

| Feld | Art | Datenklasse | Personenbezogene Daten | Gruppe | Agenten sehen | Beschreibung |
|---|---|---|---|---|---|---|
| `page_id` | ref → website_page | `none` | nein | `website.user` | im Klartext | The page this translates |
| `lang` | select (en, de, fr, pl, fi, sv, es) | `none` | nein | `website.user` | im Klartext | Language of the translation: en, de, fr, pl, fi, sv or es |
| `title` | text | `none` | nein | `website.user` | im Klartext | Translated page title |
| `body` | longtext | `none` | nein | `website.user` | im Klartext | Translated page content in Markdown |
| `seo_title` | text | `none` | nein | `website.user` | im Klartext | Translated title shown in search results |
| `seo_description` | text | `none` | nein | `website.user` | im Klartext | Translated description shown in search results |
| `published` | bool | `none` | nein | `website.user` | im Klartext | Whether the translation is shown; it is only reachable while its page is published |

### `website_blog_post_translation`

A blog post translated into another language

Lesegruppe: `website.user`. Schreibgruppe: `website.user`.

| Feld | Art | Datenklasse | Personenbezogene Daten | Gruppe | Agenten sehen | Beschreibung |
|---|---|---|---|---|---|---|
| `post_id` | ref → website_blog_post | `none` | nein | `website.user` | im Klartext | The post this translates |
| `lang` | select (en, de, fr, pl, fi, sv, es) | `none` | nein | `website.user` | im Klartext | Language of the translation: en, de, fr, pl, fi, sv or es |
| `title` | text | `none` | nein | `website.user` | im Klartext | Translated post title |
| `summary` | text | `none` | nein | `website.user` | im Klartext | Translated teaser |
| `body` | longtext | `none` | nein | `website.user` | im Klartext | Translated post content in Markdown |
| `published` | bool | `none` | nein | `website.user` | im Klartext | Whether the translation is shown; it is only reachable while its post is published |

## Workflows

### `website_page`

| Aktion | Bewegt | Wer sie ausführen darf | Freigabe |
|---|---|---|---|
| `website_page.publish` | state: draft → published | `website.manager` | ja |
| `website_page.unpublish` | state: published → draft | `website.manager` | nein |
| `website_page.archive` | state: published → archived | `website.manager` | nein |

### `website_blog_post`

| Aktion | Bewegt | Wer sie ausführen darf | Freigabe |
|---|---|---|---|
| `website_blog_post.publish` | state: draft → published | `website.manager` | ja |
| `website_blog_post.unpublish` | state: published → draft | `website.manager` | nein |
| `website_blog_post.archive` | state: published → archived | `website.manager` | nein |

### `website_form_submission`

| Aktion | Bewegt | Wer sie ausführen darf | Freigabe |
|---|---|---|---|
| `website_form_submission.handle` | state: new → handled | `website.user` | nein |
| `website_form_submission.mark_spam` | state: new → spam | `website.user` | nein |

## Berechtigungsgruppen

Von dieser App verwendete Gruppen:

- `website.manager`
- `website.user`

## Freigabeschritte

Schritte, die ein Agent nur vorschlagen kann:

- `website_page.publish`
- `website_blog_post.publish`

## Was Agenten tun können und was nicht

Ein Agent kann Datensätze dieser App lesen, durchsuchen, anlegen und aktualisieren sowie Aktionen ausführen, die keine Freigabe brauchen, und zwar innerhalb der Berechtigungsgruppen seines Tokens.

Diese Schritte kann er nur vorschlagen, und eine Person muss sie freigeben: `website_page.publish`, `website_blog_post.publish`, `website_page.delete`, `website_menu_item.delete`, `website_blog_post.delete`, `website_form_submission.delete`, `website_page_translation.delete`, `website_blog_post_translation.delete`.

Personenbezogene Daten werden als Platzhalter maskiert: `website_blog_post.author_name`, `website_form_submission.sender_name`, `website_form_submission.sender_email`, `website_form_submission.sender_phone`, `website_form_submission.message`.

## Abhängigkeiten

Keine.

## Installation

Installieren Sie sie in der App Customize (Marktplatz) oder über die Kommandozeile:

```bash
obop modules install-from website
```

Erfordert eine Datenbank und Administratorrechte.

## Selbst bauen

[Der Modulleitfaden zeigt, wie Apps wie diese geschrieben werden](/de/docs/reference/module-manifest/)