diff --git a/extensions/pagetop-admin/Cargo.toml b/extensions/pagetop-admin/Cargo.toml
index c61c2550..38d0d657 100644
--- a/extensions/pagetop-admin/Cargo.toml
+++ b/extensions/pagetop-admin/Cargo.toml
@@ -1,6 +1,6 @@
[package]
name = "pagetop-admin"
-description = "Panel de administración extensible para PageTop."
+description = "Ajustes guardados en la base de datos para el panel de administración de PageTop."
version = "0.1.0"
categories = ["web-programming", "development-tools"]
keywords = ["pagetop", "admin", "cms", "settings", "ssr"]
diff --git a/extensions/pagetop-admin/README.md b/extensions/pagetop-admin/README.md
index 92396a03..df6a190e 100644
--- a/extensions/pagetop-admin/README.md
+++ b/extensions/pagetop-admin/README.md
@@ -2,7 +2,7 @@
PageTop Admin
-
Panel de administración extensible para PageTop.
+
Ajustes guardados en la base de datos para el panel de administración de PageTop.
[](https://docs.rs/pagetop-admin)
[](https://crates.io/crates/pagetop-admin)
@@ -11,11 +11,8 @@
-Añade a una aplicación PageTop un panel de administración en `/admin` que cada extensión amplía con
-sus propias secciones, páginas, pestañas y botones, declarados con acciones. Trae las secciones
-habituales (personas, estructura, configuración, informes y ayuda), formularios de configuración
-que se guardan en la base de datos y un menú de navegación hecho sólo con componentes del núcleo,
-para que funcione con cualquier tema.
+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
@@ -23,6 +20,35 @@ para que funcione con cualquier tema.
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` 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 el módulo `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`:
@@ -32,16 +58,15 @@ configurables, basadas en HTML, CSS y JavaScript.
pagetop-admin = "..."
```
-La configuración se guarda 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]`.
+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`) y **añade al panel**
-tus secciones, páginas o formularios de configuración:
+**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::*;
-use pagetop_admin::settings::{SettingField, SettingsSchema};
pub struct MyApp;
@@ -52,25 +77,17 @@ impl Extension for MyApp {
}
fn actions(&self) -> Vec {
- actions![
- DeclareAdminPages::new(declare_pages),
- ]
- }
-
- fn configure_router(&self, router: Router) -> Router {
- router.route("/admin/config/myapp", web::get(config_handler))
+ actions![DeclareConfigForms::new(declare_forms)]
}
}
-fn declare_pages(bag: &mut PageBag) {
- bag.add(AdminPage {
- path: "/admin/config/myapp".to_owned(),
- section: "config".to_owned(),
- title: Lc::n("My App"),
- description: Some(Lc::n("Configure My App.")),
- weight: 0,
- permission: &MyPermission::Config,
- kind: AdminPageKind::View,
+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),
+ ),
});
}
@@ -87,31 +104,12 @@ impl Permission for MyPermission {
}
}
-async fn config_handler(request: HttpRequest) -> Result {
- let schema = SettingsSchema::new("myapp.config")
- .with_field(SettingField::text("site_name", "Site name").with_required(true));
-
- let title = "My App configuration";
- let mut form = ConfigForm::with_schema(schema);
- let mut cx = Context::new(request.clone());
- let content = form.render(&mut cx).await;
-
- Page::admin(request)
- .with_title(Lc::n(title))
- .with_child(
- AdminFrame::new()
- .with_title(Lc::n(title))
- .with_child(Html::with(move |_| content.clone())),
- )
- .render()
- .await
+// Los valores se guardan con la clave `<ámbito>.`.
+async fn site_name() -> String {
+ pagetop_admin::settings::get_or("myapp.site_name", String::new()).await
}
```
-Para formularios de configuración enteramente automáticos (GET y POST gestionados por
-`pagetop-admin`), usa `AdminPageKind::ConfigForm(schema)` en lugar de `View` y no registres la ruta
-tú mismo.
-
## Advertencia
**PageTop** es un proyecto personal para aprender [Rust](https://www.rust-lang.org/es) y conocer su
diff --git a/extensions/pagetop-admin/src/action.rs b/extensions/pagetop-admin/src/action.rs
index 99117a3b..de4159ec 100644
--- a/extensions/pagetop-admin/src/action.rs
+++ b/extensions/pagetop-admin/src/action.rs
@@ -1,286 +1,119 @@
-//! Tipos de acción que `pagetop-admin` expone para que otras extensiones registren
-//! secciones, páginas, tareas y acciones en el panel de administración.
-//!
-//! El flujo de `registry::build()` despacha estas acciones en este orden:
-//!
-//! 1. `DeclareAdminSections` - secciones (agrupaciones del sidebar).
-//! 2. `DeclareAdminPages` - páginas del panel.
-//! 3. `DeclareAdminTasks` - tareas (pestañas) locales por página.
-//! 4. `DeclareAdminActions` - acciones locales (botones) por página.
+//! Acción para declarar páginas de ajustes que `pagetop-admin` pinta y guarda por sí solo.
use pagetop::prelude::*;
-use crate::registry::{AdminAction, AdminPage, AdminSection, AdminTask};
+use std::collections::BTreeMap;
+use std::sync::OnceLock;
-// **< Tipo de callbacks >**************************************************************************
+use crate::settings::SettingsSchema;
-pub type FnSectionBag = fn(&mut SectionBag);
-pub type FnPageBag = fn(&mut PageBag);
-pub type FnTaskBag = fn(&mut TaskBag);
-pub type FnActionBag = fn(&mut ActionBag);
+// **< ConfigFormPage >*****************************************************************************
-// **< Bolsas de declaración >**********************************************************************
-
-/// Bolsa de secciones para [`DeclareAdminSections`].
-pub struct SectionBag {
- pub(crate) sections: Vec,
-}
-
-impl SectionBag {
- /// Añade una sección al registro.
- pub fn add(&mut self, section: AdminSection) {
- self.sections.push(section);
- }
-}
-
-/// Bolsa de páginas para [`DeclareAdminPages`].
-pub struct PageBag {
- pub(crate) pages: Vec,
-}
-
-impl PageBag {
- /// Añade una página al registro.
- pub fn add(&mut self, page: AdminPage) {
- self.pages.push(page);
- }
-}
-
-/// Bolsa de tareas para [`DeclareAdminTasks`].
-pub struct TaskBag {
- pub(crate) tasks: Vec,
-}
-
-impl TaskBag {
- /// Añade una tarea local al registro.
- pub fn add(&mut self, task: AdminTask) {
- self.tasks.push(task);
- }
-}
-
-/// Bolsa de acciones locales para [`DeclareAdminActions`].
-pub struct ActionBag {
- pub(crate) actions: Vec,
-}
-
-impl ActionBag {
- /// Añade una acción local al registro.
- pub fn add(&mut self, action: AdminAction) {
- self.actions.push(action);
- }
-}
-
-// **< DeclareAdminSections >***********************************************************************
-
-/// Acción para declarar secciones del panel de administración.
+/// Página de ajustes del panel: una [`AdminPage`] y el esquema de su formulario.
///
-/// Se despacha durante `registry::build()` (dentro de `initialize()`). El callback
-/// recibe un [`SectionBag`] y puede llamar a `add()` para registrar secciones.
+/// `pagetop-admin` la añade al registro del panel como cualquier otra página, monta su ruta y
+/// responde a su `GET` (el formulario con los valores guardados) y a su `POST` (los guarda en la
+/// base de datos). La extensión que la declara no registra ninguna ruta.
+#[derive(Clone)]
+pub struct ConfigFormPage {
+ /// Página del panel, con su ruta relativa a la raíz del panel.
+ pub page: AdminPage,
+ /// Esquema del formulario.
+ pub schema: SettingsSchema,
+}
+
+/// Bolsa de páginas de ajustes para [`DeclareConfigForms`].
+pub struct ConfigFormBag {
+ forms: Vec,
+}
+
+impl ConfigFormBag {
+ /// Añade una página de ajustes.
+ pub fn add(&mut self, form: ConfigFormPage) {
+ self.forms.push(form);
+ }
+}
+
+// **< DeclareConfigForms >*************************************************************************
+
+/// Tipo de función para declarar páginas de ajustes.
+pub type FnActionDeclareConfigForms = fn(bag: &mut ConfigFormBag);
+
+/// Acción para declarar páginas de ajustes que gestiona `pagetop-admin` (ver [`ConfigFormPage`]).
///
/// # Ejemplo
///
/// ```rust,no_run
/// use pagetop::prelude::*;
-/// use pagetop_admin::action::{DeclareAdminSections, SectionBag};
-/// use pagetop_admin::registry::AdminSection;
+/// use pagetop_admin::prelude::*;
///
-/// fn declare_sections(bag: &mut SectionBag) {
-/// bag.add(AdminSection {
-/// key: "tools".to_owned(),
-/// path: "/admin/tools".to_owned(),
-/// title: Lc::n("Tools"),
-/// weight: 60,
-/// });
+/// #[derive(Clone, Copy, Debug)]
+/// enum MyPermission {
+/// Config,
/// }
-/// // En Extension::actions():
-/// // DeclareAdminSections::new(declare_sections)
-/// ```
-pub struct DeclareAdminSections {
- f: FnSectionBag,
- weight: Weight,
-}
-
-impl ActionDispatcher for DeclareAdminSections {
- fn weight(&self) -> Weight {
- self.weight
- }
-}
-
-impl DeclareAdminSections {
- pub fn new(f: FnSectionBag) -> Self {
- DeclareAdminSections { f, weight: 0 }
- }
-
- pub fn with_weight(mut self, w: Weight) -> Self {
- self.weight = w;
- self
- }
-
- pub(crate) fn dispatch(bag: &mut SectionBag) {
- dispatch_actions(|action: &Self| (action.f)(bag));
- }
-}
-
-// **< DeclareAdminPages >**************************************************************************
-
-/// Acción para declarar páginas del panel de administración.
///
-/// Se despacha durante `registry::build()`. El callback recibe un [`PageBag`].
-///
-/// # Ejemplo
-///
-/// ```rust,no_run
-/// use pagetop::prelude::*;
-/// use pagetop_admin::action::{DeclareAdminPages, PageBag};
-/// use pagetop_admin::registry::{AdminPage, AdminPageKind};
-///
-/// struct ExportPermission;
-///
-/// impl Permission for ExportPermission {
+/// impl Permission for MyPermission {
/// fn key(&self) -> CowStr {
-/// "tools:export".into()
+/// "myapp:config".into()
/// }
/// }
///
-/// fn declare_pages(bag: &mut PageBag) {
-/// bag.add(AdminPage {
-/// path: "/admin/tools/export".to_owned(),
-/// section: "tools".to_owned(),
-/// title: Lc::n("Export"),
-/// description: Some(Lc::n("Export site data.")),
-/// weight: 0,
-/// permission: &ExportPermission,
-/// kind: AdminPageKind::View,
+/// 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("Configure My App.")),
+/// schema: SettingsSchema::new("myapp.config").with_field(
+/// SettingField::text("site_name", Lc::n("Site name")).with_required(true),
+/// ),
/// });
/// }
/// // En Extension::actions():
-/// // DeclareAdminPages::new(declare_pages)
+/// // DeclareConfigForms::new(declare_forms)
/// ```
-pub struct DeclareAdminPages {
- f: FnPageBag,
+pub struct DeclareConfigForms {
+ f: FnActionDeclareConfigForms,
weight: Weight,
}
-impl ActionDispatcher for DeclareAdminPages {
+impl ActionDispatcher for DeclareConfigForms {
fn weight(&self) -> Weight {
self.weight
}
}
-impl DeclareAdminPages {
- pub fn new(f: FnPageBag) -> Self {
- DeclareAdminPages { f, weight: 0 }
+impl DeclareConfigForms {
+ /// Registra una nueva acción para declarar páginas de ajustes.
+ pub fn new(f: FnActionDeclareConfigForms) -> Self {
+ DeclareConfigForms { f, weight: 0 }
}
- pub fn with_weight(mut self, w: Weight) -> Self {
- self.weight = w;
+ /// Opcional. Acciones con pesos más bajos se aplican antes. Se pueden usar valores negativos.
+ pub fn with_weight(mut self, value: Weight) -> Self {
+ self.weight = value;
self
}
-
- pub(crate) fn dispatch(bag: &mut PageBag) {
- dispatch_actions(|action: &Self| (action.f)(bag));
- }
}
-// **< DeclareAdminTasks >**************************************************************************
+// **< Registro de las páginas de ajustes >*********************************************************
-/// Acción para declarar tareas (pestañas) locales en páginas del panel.
-///
-/// Se despacha durante `registry::build()`. El callback recibe un [`TaskBag`].
-/// Cada [`AdminTask`] indica en `parent_path` la página a la que pertenece.
-///
-/// # Ejemplo
-///
-/// ```rust,no_run
-/// use pagetop::prelude::*;
-/// use pagetop_admin::action::{DeclareAdminTasks, TaskBag};
-/// use pagetop_admin::registry::AdminTask;
-///
-/// fn declare_tasks(bag: &mut TaskBag) {
-/// bag.add(AdminTask {
-/// path: "/admin/tools/export/csv".to_owned(),
-/// parent_path: "/admin/tools/export".to_owned(),
-/// title: Lc::n("CSV"),
-/// weight: 0,
-/// is_default: true,
-/// permission: None,
-/// });
-/// }
-/// // En Extension::actions():
-/// // DeclareAdminTasks::new(declare_tasks)
-/// ```
-pub struct DeclareAdminTasks {
- f: FnTaskBag,
- weight: Weight,
+// Esquemas de las páginas de ajustes, por su ruta relativa a la raíz del panel.
+static CONFIG_FORMS: OnceLock> = OnceLock::new();
+
+// Añade las páginas de ajustes al registro del panel. `pagetop-admin` lo registra como una acción
+// `DeclareAdminPages`, así que se ejecuta una sola vez, cuando el núcleo construye el registro.
+pub(crate) fn declare_config_form_pages(bag: &mut AdminPageBag) {
+ let mut forms = ConfigFormBag { forms: Vec::new() };
+ dispatch_actions(|action: &DeclareConfigForms| (action.f)(&mut forms));
+ let mut schemas = BTreeMap::new();
+ for form in forms.forms {
+ schemas.insert(form.page.path().to_owned(), form.schema);
+ bag.add(form.page);
+ }
+ let _ = CONFIG_FORMS.set(schemas);
}
-impl ActionDispatcher for DeclareAdminTasks {
- fn weight(&self) -> Weight {
- self.weight
- }
-}
-
-impl DeclareAdminTasks {
- pub fn new(f: FnTaskBag) -> Self {
- DeclareAdminTasks { f, weight: 0 }
- }
-
- pub fn with_weight(mut self, w: Weight) -> Self {
- self.weight = w;
- self
- }
-
- pub(crate) fn dispatch(bag: &mut TaskBag) {
- dispatch_actions(|action: &Self| (action.f)(bag));
- }
-}
-
-// **< DeclareAdminActions >************************************************************************
-
-/// Acción para declarar acciones locales (botones de acción) en páginas del panel.
-///
-/// Se despacha durante `registry::build()`. El callback recibe un [`ActionBag`].
-/// Cada [`AdminAction`] indica en `for_path` la página en la que aparece el botón.
-///
-/// # Ejemplo
-///
-/// ```rust,no_run
-/// use pagetop::prelude::*;
-/// use pagetop_admin::action::{DeclareAdminActions, ActionBag};
-/// use pagetop_admin::registry::AdminAction;
-///
-/// fn declare_actions(bag: &mut ActionBag) {
-/// bag.add(AdminAction {
-/// url: "/admin/tools/export/new".to_owned(),
-/// for_path: "/admin/tools/export".to_owned(),
-/// title: Lc::n("Add export"),
-/// weight: 0,
-/// });
-/// }
-/// // En Extension::actions():
-/// // DeclareAdminActions::new(declare_actions)
-/// ```
-pub struct DeclareAdminActions {
- f: FnActionBag,
- weight: Weight,
-}
-
-impl ActionDispatcher for DeclareAdminActions {
- fn weight(&self) -> Weight {
- self.weight
- }
-}
-
-impl DeclareAdminActions {
- pub fn new(f: FnActionBag) -> Self {
- DeclareAdminActions { f, weight: 0 }
- }
-
- pub fn with_weight(mut self, w: Weight) -> Self {
- self.weight = w;
- self
- }
-
- pub(crate) fn dispatch(bag: &mut ActionBag) {
- dispatch_actions(|action: &Self| (action.f)(bag));
- }
+// Esquemas de las páginas de ajustes, por su ruta relativa a la raíz del panel.
+pub(crate) fn config_forms() -> &'static BTreeMap {
+ static EMPTY: BTreeMap = BTreeMap::new();
+ CONFIG_FORMS.get().unwrap_or(&EMPTY)
}
diff --git a/extensions/pagetop-admin/src/component.rs b/extensions/pagetop-admin/src/component.rs
index e6325daf..c4f85a61 100644
--- a/extensions/pagetop-admin/src/component.rs
+++ b/extensions/pagetop-admin/src/component.rs
@@ -1,9 +1,5 @@
//! Componentes de renderizado del panel de administración.
-mod admin_frame;
-mod admin_menu;
mod config_form;
-pub use admin_frame::AdminFrame;
-pub use admin_menu::AdminMenu;
pub use config_form::ConfigForm;
diff --git a/extensions/pagetop-admin/src/component/admin_frame.rs b/extensions/pagetop-admin/src/component/admin_frame.rs
deleted file mode 100644
index 690d9074..00000000
--- a/extensions/pagetop-admin/src/component/admin_frame.rs
+++ /dev/null
@@ -1,150 +0,0 @@
-use pagetop::prelude::*;
-
-use crate::LOCALES_ADMIN;
-use crate::registry;
-
-/// Componente de layout principal de una página del panel de administración.
-///
-/// Renderiza breadcrumb, encabezado (título + acciones locales), tareas locales (pestañas) y el
-/// contenido de la página. No incluye ningún menú de navegación: mostrar las secciones del panel
-/// (el "sidebar" o el "menú superior", según el tema) es responsabilidad del tema que intercepte
-/// [`CoreTemplates::Admin`](pagetop::core::theme::CoreTemplates::Admin) (por ejemplo
-/// `pagetop-bootsier`) leyendo directamente [`crate::registry::global()`]. El tema básico de
-/// PageTop no lo hace, y una página de administración sigue siendo completamente navegable sin él,
-/// a través del *dashboard* (`/admin`), las páginas de sección y este mismo breadcrumb.
-///
-/// ```html
-///
-///
-///
Title
-///
...
-///
-///
-///
...
-/// ```
-///
-/// El contenido son sus propios hijos ([`Children`]), igual que en cualquier otro componente
-/// contenedor (p. ej. [`Block`](pagetop::base::component::Block)): admite tantos `with_child(...)`
-/// como haga falta, cada uno renderizado en el ciclo normal de componentes.
-#[derive(AutoDefault, Clone, Debug, Getters)]
-pub struct AdminFrame {
- /// Devuelve el título de la página.
- title: Lc,
- /// Devuelve la lista de componentes hijo de la página.
- children: Children,
-}
-
-#[async_trait]
-impl Component for AdminFrame {
- fn new() -> Self {
- Self::default()
- }
-
- async fn prepare(&self, cx: &mut Context) -> Result {
- let path = cx
- .request()
- .map(|r| r.path().to_string())
- .unwrap_or_else(|| "/".to_string());
-
- let breadcrumbs = render_breadcrumbs(cx, &path).await;
- let local_tasks = render_local_tasks(cx, &path);
- let local_acts = render_local_actions(cx, &path);
- let body = self.children().render(cx).await;
-
- Ok(html! {
- (breadcrumbs)
- header class="admin-header" {
- h1 class="admin-page-title" { (self.title().using(cx)) }
- (local_acts)
- }
- @if !local_tasks.0.is_empty() {
- nav class="admin-local-tasks" { (local_tasks) }
- }
- div class="admin-content" {
- (body)
- }
- })
- }
-}
-
-#[builder_impl]
-impl AdminFrame {
- /// Establece el título de la página.
- pub fn with_title(mut self, title: Lc) -> Self {
- self.title = title;
- self
- }
-
- /// Añade un componente hijo al contenido de la página.
- pub fn with_child(mut self, op: impl Into) -> Self {
- self.children.alter_child(op.into());
- self
- }
-}
-
-// **< Breadcrumbs >********************************************************************************
-
-async fn render_breadcrumbs(cx: &mut Context, current_path: &str) -> Markup {
- let reg = registry::global();
- let base = crate::ADMIN_BASE_PATH;
-
- let home_label = Lc::t("admin-breadcrumb-home", &LOCALES_ADMIN);
- let mut bc = Breadcrumb::new().with_crumb(breadcrumb::Crumb::new(home_label, base));
-
- if let Some(page) = reg.pages().get(current_path) {
- if let Some(section) = reg.sections().get(&page.section) {
- bc = bc.with_crumb(breadcrumb::Crumb::new(
- section.title.clone(),
- section.path.as_str(),
- ));
- }
- bc = bc.with_crumb(breadcrumb::Crumb::current(page.title.clone()));
- } else if let Some(section) = reg.sections().values().find(|s| s.path == current_path) {
- // La ruta actual es la propia sección (su página de aterrizaje), no una `AdminPage`
- // registrada dentro de ella.
- bc = bc.with_crumb(breadcrumb::Crumb::current(section.title.clone()));
- }
-
- bc.render(cx).await
-}
-
-// **< Tareas locales >*****************************************************************************
-
-fn render_local_tasks(cx: &Context, current_path: &str) -> Markup {
- let reg = registry::global();
- let tasks = reg.tasks_for(current_path);
- if tasks.is_empty() {
- return html! {};
- }
- html! {
- ul class="admin-tasks-list" {
- @for task in tasks {
- @let is_active = current_path == task.path;
- li class=(if is_active { "admin-task admin-task-active" } else { "admin-task" }) {
- a href=(cx.route(task.path.as_str())) { (task.title.using(cx)) }
- }
- }
- }
- }
-}
-
-// **< Acciones locales >***************************************************************************
-
-fn render_local_actions(cx: &Context, current_path: &str) -> Markup {
- let reg = registry::global();
- let actions = reg.actions_for(current_path);
- if actions.is_empty() {
- return html! {};
- }
- html! {
- ul class="admin-actions-list" {
- @for action in actions {
- li class="admin-action" {
- a class="admin-action-link" href=(cx.route(action.url.as_str())) {
- (action.title.using(cx))
- }
- }
- }
- }
- }
-}
diff --git a/extensions/pagetop-admin/src/component/admin_menu.rs b/extensions/pagetop-admin/src/component/admin_menu.rs
deleted file mode 100644
index 274abd74..00000000
--- a/extensions/pagetop-admin/src/component/admin_menu.rs
+++ /dev/null
@@ -1,38 +0,0 @@
-use pagetop::prelude::*;
-
-use crate::registry;
-
-/// Componente que renderiza la barra de navegación del panel de administración.
-///
-/// Construye la [`Navbar`] en cada petición a partir de [`registry::admin_navbar()`], ya filtrada
-/// por el usuario de la petición actual. Pensado para que un tema la registre en su propia región
-/// de navegación e intercepte `Navbar`/`Nav`/`Dropdown` en
-/// [`Theme::render_component()`](pagetop::core::theme::Theme::render_component) si quiere darle un
-/// aspecto propio (p. ej. `pagetop-bootsier` la reconoce automáticamente al ser componentes del
-/// núcleo); sin intercepción, se renderiza con el marcado por defecto de cada componente.
-///
-/// Sólo se renderiza en páginas creadas con
-/// [`Page::admin()`](pagetop::response::Page::admin) (plantilla
-/// [`CoreTemplates::Admin`](pagetop::core::theme::CoreTemplates::Admin)). Es necesario comprobarlo
-/// explícitamente porque, si se registra en una región de propósito general como
-/// [`CoreRegions::Aside`](pagetop::core::theme::CoreRegions::Aside), se renderizaría también en
-/// páginas `Standard` si no se autolimitara.
-#[derive(AutoDefault, Clone, Debug)]
-pub struct AdminMenu;
-
-#[async_trait]
-impl Component for AdminMenu {
- fn new() -> Self {
- Self
- }
-
- async fn prepare(&self, cx: &mut Context) -> Result {
- if !matches!(
- cx.template().downcast_ref::(),
- Some(CoreTemplates::Admin)
- ) {
- return Ok(html! {});
- }
- Ok(registry::admin_navbar(cx).render(cx).await)
- }
-}
diff --git a/extensions/pagetop-admin/src/component/config_form.rs b/extensions/pagetop-admin/src/component/config_form.rs
index 34f685b4..cc670a80 100644
--- a/extensions/pagetop-admin/src/component/config_form.rs
+++ b/extensions/pagetop-admin/src/component/config_form.rs
@@ -3,35 +3,27 @@ use pagetop::prelude::*;
use crate::LOCALES_ADMIN;
use crate::settings::{SettingFieldType, SettingsSchema, get_or};
-/// Componente que renderiza un formulario de configuración persistente.
+/// Formulario de un [`SettingsSchema`], con los valores guardados en la tabla `settings`.
///
-/// Genera campos HTML a partir de un [`SettingsSchema`] y carga los valores
-/// actuales desde `settings`. El POST es procesado por el handler interno
-/// `config_form_post`.
+/// En las páginas declaradas con [`DeclareConfigForms`](crate::action::DeclareConfigForms),
+/// `pagetop-admin` lo muestra y guarda lo que se envía. En una página propia sólo lo muestra: el
+/// envío llega a la ruta de la página, o a la de [`with_action_path()`](Self::with_action_path), y
+/// lo guarda su *handler* (ver [`settings::set()`](crate::settings::set)).
///
/// # Ejemplo
///
/// ```rust,no_run
/// use pagetop::prelude::*;
-/// use pagetop_admin::component::{AdminFrame, ConfigForm};
+/// use pagetop_admin::component::ConfigForm;
/// use pagetop_admin::settings::{SettingField, SettingsSchema};
///
/// async fn settings_handler(request: HttpRequest) -> Result {
/// let schema = SettingsSchema::new("myapp.general")
-/// .with_field(SettingField::text("site_name", "Site name").with_required(true));
-///
-/// let title = "General settings";
-/// let mut form = ConfigForm::with_schema(schema);
-/// let mut cx = Context::new(request.clone());
-/// let content = form.render(&mut cx).await;
+/// .with_field(SettingField::text("site_name", Lc::n("Site name")).with_required(true));
///
/// Page::admin(request)
-/// .with_title(Lc::n(title))
-/// .with_child(
-/// AdminFrame::new()
-/// .with_title(Lc::n(title))
-/// .with_child(Html::with(move |_| content.clone())),
-/// )
+/// .with_title(Lc::n("General settings"))
+/// .with_child(ConfigForm::with_schema(schema))
/// .render()
/// .await
/// }
@@ -42,10 +34,6 @@ pub struct ConfigForm {
schema: Option,
/// Devuelve la ruta de destino del formulario, si se ha personalizado.
action_path: Option,
- /// Devuelve si el último envío se guardó correctamente.
- saved: bool,
- /// Devuelve si el último envío produjo un error al guardar.
- error: bool,
}
#[async_trait]
@@ -64,22 +52,11 @@ impl Component for ConfigForm {
None => cx.route(cx.request().map(|r| r.path()).unwrap_or("/")),
};
- let save_label = Lc::t("config-save-label", &LOCALES_ADMIN)
- .lookup(cx)
- .unwrap_or_else(|| "Save configuration".into());
-
- let saved_msg = Lc::t("config-saved-ok", &LOCALES_ADMIN)
- .lookup(cx)
- .unwrap_or_else(|| "Configuration saved.".into());
-
- let error_msg = Lc::t("config-saved-error", &LOCALES_ADMIN)
- .lookup(cx)
- .unwrap_or_else(|| "Could not save configuration.".into());
-
- // Pre-computa los valores de BD para cada campo antes del macro html! (que es síncrono).
+ // Pre-computa los valores de BD para cada campo antes del macro html! (que es síncrono). El
+ // formulario guarda todos los valores como texto (`"42"`, `"true"`), así que se leen como
+ // texto también los de los campos numéricos y las casillas.
struct FieldVals {
raw_val: String,
- num_val: String,
checked: bool,
}
let mut prepared: Vec = Vec::with_capacity(schema.fields().len());
@@ -87,27 +64,18 @@ impl Component for ConfigForm {
let key = schema.key_for(field.name());
let raw_val =
get_or::(&key, field.default_value().cloned().unwrap_or_default()).await;
- let num_val = get_or::(&key, 0.0).await.to_string();
- let checked = get_or::(&key, false).await;
- prepared.push(FieldVals {
- raw_val,
- num_val,
- checked,
- });
+ let checked = raw_val == "true";
+ prepared.push(FieldVals { raw_val, checked });
}
Ok(html! {
- @if *self.saved() {
- div class="admin-message admin-message-ok" { (&saved_msg) }
- }
- @if *self.error() {
- div class="admin-message admin-message-error" { (&error_msg) }
- }
form class="admin-config-form" method="post" action=(action) {
@for (i, field) in schema.fields().iter().enumerate() {
@let pf = &prepared[i];
div class="admin-form-field" {
- label class="admin-form-label" for=(field.name()) { (field.label()) }
+ label class="admin-form-label" for=(field.name()) {
+ (field.label().using(cx))
+ }
@match field.field_type() {
SettingFieldType::Text { max_length } => {
@if let Some(max) = max_length {
@@ -133,7 +101,7 @@ impl Component for ConfigForm {
type="number"
id=(field.name())
name=(field.name())
- value=(&pf.num_val)
+ value=(&pf.raw_val)
min=(lo)
max=(hi)
required[*field.required()];
@@ -142,7 +110,7 @@ impl Component for ConfigForm {
type="number"
id=(field.name())
name=(field.name())
- value=(&pf.num_val)
+ value=(&pf.raw_val)
min=(lo)
required[*field.required()];
} @else if let Some(hi) = max {
@@ -150,7 +118,7 @@ impl Component for ConfigForm {
type="number"
id=(field.name())
name=(field.name())
- value=(&pf.num_val)
+ value=(&pf.raw_val)
max=(hi)
required[*field.required()];
} @else {
@@ -158,7 +126,7 @@ impl Component for ConfigForm {
type="number"
id=(field.name())
name=(field.name())
- value=(&pf.num_val)
+ value=(&pf.raw_val)
required[*field.required()];
}
}
@@ -178,22 +146,22 @@ impl Component for ConfigForm {
{
@for (val, label) in options {
@if &pf.raw_val == val {
- option value=(val) selected { (label) }
+ option value=(val) selected { (label.using(cx)) }
} @else {
- option value=(val) { (label) }
+ option value=(val) { (label.using(cx)) }
}
}
}
}
}
- @if let Some(help) = field.help_text() {
- small class="admin-form-help" { (help) }
+ @if !field.help_text().is_none() {
+ small class="admin-form-help" { (field.help_text().using(cx)) }
}
}
}
div class="admin-form-actions" {
button class="admin-btn admin-btn-primary" type="submit" {
- (&save_label)
+ (Lc::t("config-save-label", &LOCALES_ADMIN).using(cx))
}
}
}
@@ -212,17 +180,10 @@ impl ConfigForm {
}
}
- pub fn with_action_path(mut self, v: impl Into