Website
Pages et formulaires
À quoi elle sert
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.
Ce que fait et ne fait pas le paquet
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.
Modèles
website_page
A page of the website
Groupe de lecture: website.user. Groupe d'écriture: website.user.
| Champ | Type | Classe de données | Données personnelles | Groupe | Vu par les agents | Description |
|---|---|---|---|---|---|---|
title | text | none | non | website.user | en clair | Page title |
slug | text | none | non | website.user | en clair | 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 | non | website.user | en clair | Page content in Markdown (a safe subset: headings, lists, links, emphasis, code, quotes, tables) |
seo_title | text | none | non | website.user | en clair | Title shown in search results; empty means the page title |
seo_description | text | none | non | website.user | en clair | Description shown in search results |
published_on | date | none | non | website.user | en clair | Day the page went public (YYYY-MM-DD) |
state | select (draft, published, archived) | none | non | website.user | en clair | Page status: draft, published, archived |
website_menu_item
An entry of the site navigation
Groupe de lecture: website.user. Groupe d'écriture: website.manager.
| Champ | Type | Classe de données | Données personnelles | Groupe | Vu par les agents | Description |
|---|---|---|---|---|---|---|
label | text | none | non | website.user | en clair | Text shown in the menu |
url | text | none | non | website.user | en clair | Where the entry leads: a page slug starting with a slash or a full address |
parent_id | ref → website_menu_item | none | non | website.user | en clair | The entry this one is nested under; empty for a top-level entry |
sequence | number | none | non | website.user | en clair | Order among its siblings, lowest first |
visible | bool | none | non | website.user | en clair | Whether the entry is shown |
new_window | bool | none | non | website.user | en clair | Whether the link opens in a new window |
website_blog_post
A blog post
Groupe de lecture: website.user. Groupe d'écriture: website.user.
| Champ | Type | Classe de données | Données personnelles | Groupe | Vu par les agents | Description |
|---|---|---|---|---|---|---|
title | text | none | non | website.user | en clair | Post title |
slug | text | none | non | website.user | en clair | URL part of the post, lowercase with dashes |
author_name | text | public_directory | oui | website.user | masqué | Name of the author, for the team's own records |
byline | text | none | non | website.user | en clair | 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 | non | website.user | en clair | Teaser shown in listings |
body | longtext | none | non | website.user | en clair | Post content in Markdown (a safe subset: headings, lists, links, emphasis, code, quotes, tables) |
tags | text | none | non | website.user | en clair | Comma-separated tags, for example news,product |
published_on | date | none | non | website.user | en clair | Day the post is dated (YYYY-MM-DD) |
state | select (draft, published, archived) | none | non | website.user | en clair | Post status: draft, published, archived |
website_form_submission
A message a visitor sent through a form on the site
Groupe de lecture: website.user. Groupe d'écriture: website.user.
| Champ | Type | Classe de données | Données personnelles | Groupe | Vu par les agents | Description |
|---|---|---|---|---|---|---|
form_name | text | none | non | website.user | en clair | Which form it came from, for example contact |
sender_name | text | internal | oui | website.user | masqué | Name the visitor gave |
sender_email | text | internal | oui | website.user | masqué | Email address the visitor gave |
sender_phone | text | internal | oui | website.user | masqué | Phone number the visitor gave |
message | longtext | internal | oui | website.user | masqué | What the visitor wrote |
source_page | text | none | non | website.user | en clair | Slug of the page the form was on |
submitted_on | date | none | non | website.user | en clair | Day of the submission (YYYY-MM-DD) |
consent_given | bool | none | non | website.user | en clair | Whether the visitor ticked the consent box for being contacted |
state | select (new, handled, spam) | none | non | website.user | en clair | 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
Groupe de lecture: website.user. Groupe d'écriture: website.user.
| Champ | Type | Classe de données | Données personnelles | Groupe | Vu par les agents | Description |
|---|---|---|---|---|---|---|
page_id | ref → website_page | none | non | website.user | en clair | The page this translates |
lang | select (en, de, fr, pl, fi, sv, es) | none | non | website.user | en clair | Language of the translation: en, de, fr, pl, fi, sv or es |
title | text | none | non | website.user | en clair | Translated page title |
body | longtext | none | non | website.user | en clair | Translated page content in Markdown |
seo_title | text | none | non | website.user | en clair | Translated title shown in search results |
seo_description | text | none | non | website.user | en clair | Translated description shown in search results |
published | bool | none | non | website.user | en clair | 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
Groupe de lecture: website.user. Groupe d'écriture: website.user.
| Champ | Type | Classe de données | Données personnelles | Groupe | Vu par les agents | Description |
|---|---|---|---|---|---|---|
post_id | ref → website_blog_post | none | non | website.user | en clair | The post this translates |
lang | select (en, de, fr, pl, fi, sv, es) | none | non | website.user | en clair | Language of the translation: en, de, fr, pl, fi, sv or es |
title | text | none | non | website.user | en clair | Translated post title |
summary | text | none | non | website.user | en clair | Translated teaser |
body | longtext | none | non | website.user | en clair | Translated post content in Markdown |
published | bool | none | non | website.user | en clair | Whether the translation is shown; it is only reachable while its post is published |
Flux de travail
website_page
| Action | Transition | Qui peut l'exécuter | Approbation |
|---|---|---|---|
website_page.publish | state: draft → published | website.manager | oui |
website_page.unpublish | state: published → draft | website.manager | non |
website_page.archive | state: published → archived | website.manager | non |
website_blog_post
| Action | Transition | Qui peut l'exécuter | Approbation |
|---|---|---|---|
website_blog_post.publish | state: draft → published | website.manager | oui |
website_blog_post.unpublish | state: published → draft | website.manager | non |
website_blog_post.archive | state: published → archived | website.manager | non |
website_form_submission
| Action | Transition | Qui peut l'exécuter | Approbation |
|---|---|---|---|
website_form_submission.handle | state: new → handled | website.user | non |
website_form_submission.mark_spam | state: new → spam | website.user | non |
Groupes de permissions
Groupes utilisés par cette application :
website.managerwebsite.user
Étapes d'approbation
Étapes qu'un agent ne peut que proposer :
website_page.publishwebsite_blog_post.publish
Ce que les agents peuvent et ne peuvent pas faire
Un agent peut lire, rechercher, créer et modifier les enregistrements de cette application, et exécuter les actions qui ne requièrent pas d'approbation, dans les limites des groupes de permissions de son jeton.
Il ne peut que proposer ces étapes, qu'une personne doit approuver : 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.
Les données personnelles sont masquées sous forme de jetons de substitution : website_blog_post.author_name, website_form_submission.sender_name, website_form_submission.sender_email, website_form_submission.sender_phone, website_form_submission.message.
Dépendances
Aucune.
Installation
Installez-la depuis l'application Customize (Place de marché), ou en ligne de commande :
obop modules install-from websiteNécessite une base de données et des droits d'administrateur.
Créer la vôtre
Le guide des modules montre comment sont écrites les applications de ce type