El panel pasa al núcleo y pagetop-admin se queda con los ajustes guardados en la base de datos: DeclareConfigForms, ConfigForm y la tabla settings. Un campo obligatorio vacío ya no se guarda, y un fallo al guardar se muestra con los mensajes del núcleo.
180 lines
6.3 KiB
Rust
180 lines
6.3 KiB
Rust
/*!
|
|
<div align="center">
|
|
|
|
<h1>PageTop Admin</h1>
|
|
|
|
<p>Ajustes guardados en la base de datos para el panel de administración de <strong>PageTop</strong>.</p>
|
|
|
|
[](https://docs.rs/pagetop-admin)
|
|
[](https://crates.io/crates/pagetop-admin)
|
|
[](https://crates.io/crates/pagetop-admin)
|
|
[](https://git.cillero.es/manuelcillero/pagetop/src/branch/main/extensions/pagetop-admin#licencia)
|
|
|
|
</div>
|
|
|
|
Añade al panel de administración de PageTop **ajustes que se guardan en la base de datos** y que un
|
|
administrador cambia desde el propio panel, con la aplicación en marcha.
|
|
|
|
## Sobre PageTop
|
|
|
|
[PageTop](https://docs.rs/pagetop) es un entorno de desarrollo que reivindica la esencia de la web
|
|
clásica para crear soluciones web SSR (*renderizadas en el servidor*) modulares, extensibles y
|
|
configurables, basadas en HTML, CSS y JavaScript.
|
|
|
|
## Qué aporta
|
|
|
|
- **Páginas de ajustes sin código propio.** Una extensión describe los campos con un
|
|
[`SettingsSchema`] y declara la página con [`DeclareConfigForms`]. `pagetop-admin` monta su ruta,
|
|
pinta el formulario con los valores guardados y guarda lo que se envía, salvo que falte algún
|
|
campo obligatorio o llegue vacío.
|
|
- **El almacén de los valores.** La tabla `settings`, que crea al arrancar, y las funciones del
|
|
módulo [`settings`](mod@settings) para leerlos ([`settings::get_or()`] y compañía) y
|
|
escribirlos desde código.
|
|
- **El formulario** ([`ConfigForm`]), por si una página propia quiere mostrar el de un esquema.
|
|
|
|
## En qué se apoya
|
|
|
|
El panel en sí es de PageTop (el módulo [`pagetop::admin`]): su página de inicio, sus secciones, la
|
|
navegación, las migas de pan y la plantilla de administración ([`Page::admin()`]). Cada página de
|
|
ajustes es una [`AdminPage`] del núcleo, así que aparece en el panel como cualquier otra, con su
|
|
sección y su permiso, y se pinta con cualquier tema. Una extensión que sólo añade páginas propias al
|
|
panel, sin ajustes, no necesita `pagetop-admin`.
|
|
|
|
## Cuándo usarlo
|
|
|
|
Para valores que decide quien administra el sitio y que cambian con el tiempo: un aviso en la
|
|
portada, un número de plazas, abrir o cerrar las inscripciones... Lo que fija quien despliega la
|
|
aplicación (la base de datos, el servidor de correo, los límites) va en los archivos de
|
|
configuración (ver [`pagetop::config`]), que no se pueden cambiar desde el panel y exigen
|
|
reiniciar.
|
|
|
|
Los valores que envía el formulario se guardan como texto, también los de los campos numéricos y las
|
|
casillas (`"42"`, `"true"`): se leen como `String` y se convierten al usarlos.
|
|
|
|
## Guía rápida
|
|
|
|
**Añade la dependencia** a tu `Cargo.toml`:
|
|
|
|
```toml
|
|
[dependencies]
|
|
pagetop-admin = "..."
|
|
```
|
|
|
|
Los ajustes se guardan con `pagetop-seaorm`: la aplicación elige el motor de base de datos con su
|
|
*feature* (`postgres`, `mysql` o `sqlite`) y configura la conexión en la sección `[database]`.
|
|
|
|
**Declara la extensión** como dependencia de la tuya (`&pagetop_admin::Admin`); si no, sus páginas
|
|
de ajustes no se montan. Después **declara tus páginas de ajustes**, cada una con su permiso:
|
|
|
|
```rust,no_run
|
|
use pagetop::prelude::*;
|
|
use pagetop_admin::prelude::*;
|
|
|
|
pub struct MyApp;
|
|
|
|
#[async_trait]
|
|
impl Extension for MyApp {
|
|
fn dependencies(&self) -> Vec<ExtensionRef> {
|
|
vec![&pagetop_admin::Admin]
|
|
}
|
|
|
|
fn actions(&self) -> Vec<ActionBox> {
|
|
actions![DeclareConfigForms::new(declare_forms)]
|
|
}
|
|
}
|
|
|
|
fn declare_forms(bag: &mut ConfigFormBag) {
|
|
bag.add(ConfigFormPage {
|
|
page: AdminPage::new("config/myapp", "config", Lc::n("My App"), &MyPermission::Config)
|
|
.with_description(Lc::n("Name of the site.")),
|
|
schema: SettingsSchema::new("myapp").with_field(
|
|
SettingField::text("site_name", Lc::n("Site name")).with_required(true),
|
|
),
|
|
});
|
|
}
|
|
|
|
#[derive(Clone, Copy, Debug)]
|
|
enum MyPermission {
|
|
Config,
|
|
}
|
|
|
|
impl Permission for MyPermission {
|
|
fn key(&self) -> CowStr {
|
|
match self {
|
|
Self::Config => "myapp:config".into(),
|
|
}
|
|
}
|
|
}
|
|
|
|
// Los valores se guardan con la clave `<ámbito>.<campo>`.
|
|
async fn site_name() -> String {
|
|
pagetop_admin::settings::get_or("myapp.site_name", String::new()).await
|
|
}
|
|
```
|
|
*/
|
|
|
|
use pagetop::prelude::*;
|
|
use pagetop_seaorm::install_migrations;
|
|
|
|
include_locales!(LOCALES_ADMIN);
|
|
|
|
pub mod action;
|
|
pub mod component;
|
|
pub mod error;
|
|
pub mod settings;
|
|
|
|
pub(crate) mod entity;
|
|
pub(crate) mod handlers;
|
|
pub(crate) mod migration;
|
|
|
|
pub use action::{ConfigFormBag, ConfigFormPage, DeclareConfigForms};
|
|
pub use component::ConfigForm;
|
|
pub use settings::{SettingField, SettingFieldType, SettingsSchema};
|
|
|
|
/// Prelude de `pagetop-admin`.
|
|
pub mod prelude {
|
|
pub use crate::action::{ConfigFormBag, ConfigFormPage, DeclareConfigForms};
|
|
pub use crate::component::ConfigForm;
|
|
pub use crate::error::AdminError;
|
|
pub use crate::settings::{SettingField, SettingFieldType, SettingsSchema};
|
|
}
|
|
|
|
// **< Extension >**********************************************************************************
|
|
|
|
/// Implementa la extensión `pagetop-admin`.
|
|
pub struct Admin;
|
|
|
|
#[async_trait]
|
|
impl Extension for Admin {
|
|
fn name(&self) -> Lc {
|
|
Lc::t("extension_name", &LOCALES_ADMIN)
|
|
}
|
|
|
|
fn description(&self) -> Lc {
|
|
Lc::t("extension_description", &LOCALES_ADMIN)
|
|
}
|
|
|
|
fn dependencies(&self) -> Vec<ExtensionRef> {
|
|
vec![&pagetop_seaorm::SeaORM]
|
|
}
|
|
|
|
fn actions(&self) -> Vec<ActionBox> {
|
|
actions![pagetop::base::action::admin::DeclareAdminPages::new(
|
|
action::declare_config_form_pages
|
|
)]
|
|
}
|
|
|
|
async fn initialize(&self) -> Result<(), BoxError> {
|
|
install_migrations!(m20260629_000001_create_settings)?;
|
|
Ok(())
|
|
}
|
|
|
|
fn configure_router(&self, routes: Routes) -> Routes {
|
|
action::config_forms().keys().fold(routes, |routes, path| {
|
|
routes.admin_route(
|
|
path,
|
|
web::get(handlers::config_form_get).post(handlers::config_form_post),
|
|
)
|
|
})
|
|
}
|
|
}
|