📝 Doc cron, mail queue, CSRF and flash messages

Add the scheduled tasks guide, environment variable overrides, the
[mail] and [cron] references, CSRF protection without tokens, flash
messages after redirects and the username policies of pagetop-user.
Update the framework comparison with Poem and Topcoat.
This commit is contained in:
Manuel Cillero 2026-11-02 14:46:28 +01:00
parent 1a41a456d4
commit 4e007feec8
23 changed files with 946 additions and 125 deletions

View file

@ -150,18 +150,27 @@ Block::new()
## Mensajes al usuario
`Page` acumula avisos en su contexto y el componente `Messages` los muestra:
`Page` acumula avisos en su contexto, y la región de contenido empieza siempre por un componente
`Messages` que los muestra. Basta con añadirlos:
```rust,no_run
# use pagetop::prelude::*;
async fn saved(request: HttpRequest) -> Result<Markup, ErrorPage> {
let mut page = Page::new(request).with_child(Messages::new());
let mut page = Page::new(request);
page.context()
.push_message(MessageLevel::Info, Lc::n("Your changes have been saved."));
page.render().await
}
```
Ese `Messages` se renderiza el último, cuando ya está hecho el resto de la página, así que recoge
también los avisos que añadan los componentes al renderizarse, aunque se muestre al principio. Cada
aviso aparece una sola vez: añade tu propio `Messages::new()` sólo para mostrarlos en otro lugar,
por ejemplo justo antes de un formulario, o en un fragmento de HTMX, que no tiene página.
Para avisar en la página a la que rediriges, añade el mensaje a la respuesta con `with_message()`
(ver [Crear y procesar formularios](forms.md#3-recibe-y-valida-los-datos)).
## Una portada en un minuto
`Intro` monta una página de presentación con un solo componente: