🔥 (bootsier): Elimina AdminLTE

Retira AdminLTE 4 de Bootsier: CSS/JS, `bs::sidebar`, `BootsierRegions`
y el shell propio de `CoreTemplates::Admin`. Sólo quedaba un sidebar de
5 secciones ya alcanzables desde el dashboard, las páginas de sección y
el breadcrumb de `AdminFrame`.
This commit is contained in:
Manuel Cillero 2026-09-22 21:34:16 +02:00
parent 6df71885cc
commit 11c2bdffb1
63 changed files with 201 additions and 7491 deletions

View file

@ -11,10 +11,12 @@
//!
//! # Plantillas
//!
//! Bootsier maqueta las dos plantillas de PageTop ([`CoreTemplates`]): `Standard`, con cabecera,
//! contenido y pie, que es la plantilla por defecto de cualquier página; y `Admin`, con la shell
//! completa de administración (barra superior + barra lateral + área de contenido), que se activa
//! creando la página con [`Page::admin()`] en lugar de [`Page::new()`].
//! Bootsier maqueta las dos plantillas de PageTop ([`CoreTemplates`]) con la misma cabecera,
//! contenido y pie: `Standard`, la plantilla por defecto de cualquier página; y `Admin`, que se
//! activa creando la página con [`Page::admin()`] en lugar de [`Page::new()`]. Ambas se maquetan
//! igual hoy -- la distinción entre página "normal" y de administración no vive en el maquetado,
//! sino en qué extensión registra contenido en cada región y para qué plantilla se autolimita (ver
//! más abajo `pagetop-admin`).
//!
//! ```rust,no_run
//! use pagetop::prelude::*;
@ -33,60 +35,29 @@
//! [`Page::admin()`]: pagetop::response::Page::admin
//! [`Page::new()`]: pagetop::response::Page::new
//!
//! # Barra lateral
//! # Menú de administración
//!
//! Registra elementos en [`BootsierRegions::Sidebar`](bs::BootsierRegions::Sidebar) para poblar la
//! barra lateral de la shell. Los elementos esperados son [`bs::sidebar::Item`] y
//! [`bs::sidebar::Section`].
//! `pagetop-admin` (si está presente en la aplicación) registra su propio menú de secciones y
//! páginas en [`CoreRegions::Aside`](pagetop::core::theme::CoreRegions::Aside), autolimitado a
//! páginas con la plantilla `Admin` -- no requiere ningún registro por parte de Bootsier. Se
//! construye con [`Navbar`](bs::Navbar)/[`Nav`](bs::Nav)/[`Dropdown`](bs::Dropdown), los mismos
//! componentes disponibles para cualquier página de la aplicación.
//!
//! De forma **global** (visibles en todas las páginas de administración):
//! # Selector de modo de color
//!
//! [`bs::theme_toggle()`] crea un ítem de menú con el selector de modo de color (claro / oscuro /
//! automático), pensado para añadirse a cualquier [`Nav`](bs::Nav) de la aplicación, no sólo a las
//! páginas de administración:
//!
//! ```rust,no_run
//! use pagetop::prelude::*;
//! use pagetop_bootsier::theme::bs::{BootsierRegions, sidebar};
//! use pagetop_bootsier::theme::*;
//!
//! fn register_navigation() {
//! InRegion::Global(&BootsierRegions::Sidebar)
//! .add(sidebar::Section::titled(Lc::n("Administración")))
//! .add(sidebar::Item::link(Lc::n("Usuarios"), "/users", "people"))
//! .add(sidebar::Item::link(Lc::n("Roles"), "/roles", "shield-check"));
//! }
//! ```
//!
//! O de forma **por página**:
//!
//! ```rust,no_run
//! use pagetop::prelude::*;
//! use pagetop_bootsier::theme::bs::{BootsierRegions, sidebar};
//!
//! async fn settings(request: HttpRequest) -> Result<Markup, ErrorPage> {
//! Page::admin(request)
//! .with_child_in(
//! &BootsierRegions::Sidebar,
//! sidebar::Item::link(Lc::n("Ajustes"), "/settings", "gear"),
//! )
//! .with_child(Html::with(|_| html! { h3 { "Ajustes" } }))
//! .render().await
//! }
//! ```
//!
//! # Barra de navegación superior
//!
//! La barra superior incluye por defecto los controles de pantalla completa y selector de tema.
//! Para añadir elementos adicionales en el lado derecho (por ejemplo, el dropdown de usuario de
//! `pagetop-user`), registra componentes en
//! [`BootsierRegions::Navbar`](bs::BootsierRegions::Navbar):
//!
//! ```rust,no_run
//! use pagetop::prelude::*;
//! use pagetop_bootsier::theme::bs::BootsierRegions;
//!
//! InRegion::Global(&BootsierRegions::Navbar)
//! .add(Html::with(|_| html! {
//! li class="nav-item" {
//! a class="nav-link" href="/logout" { "Cerrar sesión" }
//! }
//! }));
//! let navbar = bs::Navbar::simple().with_item(bs::navbar::Item::nav(
//! bs::Nav::new()
//! .with_item(bs::nav::Item::link(Lc::n("Home"), "/"))
//! .with_item(bs::theme_toggle()),
//! ));
//! ```
use pagetop::prelude::*;