From 46031520750749012bd4cf2e2b4f9bf801c52577 Mon Sep 17 00:00:00 2001 From: Manuel Cillero Date: Sat, 14 Nov 2026 13:27:38 +0100 Subject: [PATCH] =?UTF-8?q?=E2=9C=A8=20(global):=20A=C3=B1ade=20el=20ajust?= =?UTF-8?q?e=20theme=5Fper=5Fuser?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Con `false`, el valor por defecto, `CurrentUser::theme()` ignora el tema guardado del usuario y se usa siempre `app.theme`. El tema guardado se conserva por si se activa. --- config/reference.toml | 11 +++++--- config/test.toml | 2 ++ src/auth.rs | 19 ++++++++++---- src/base/component/form/select_theme.rs | 5 ++++ src/global.rs | 34 +++++++++++++++++++++---- 5 files changed, 58 insertions(+), 13 deletions(-) diff --git a/config/reference.toml b/config/reference.toml index 49b081db..a4416e5c 100644 --- a/config/reference.toml +++ b/config/reference.toml @@ -35,9 +35,6 @@ [app] name = "PageTop App" # Nombre de la aplicación. -theme = "Basic" # Tema predeterminado: "Basic" o el de una extensión enlazada - # por la aplicación ("Aliner", "Bootsier"...). Si no está - # habilitado se usa "Basic", con un aviso al arrancar. #language = "es-ES" # Idioma predeterminado (BCP 47: "es-ES", "en-US"...). Sin # valor, o si no es válido, el idioma se negocia con otras # fuentes (cabecera Accept-Language, idioma de respaldo). @@ -76,6 +73,14 @@ timezone_order = "Nearest" # Orden de esas regiones al elegir zona h timezone_per_user = true # Si cada usuario puede tener su propia zona horaria (true) o # se usa siempre 'timezone' (false). Con false no se ofrece # elegirla y la guardada se conserva por si se reactiva. +theme = "Basic" # Tema predeterminado: "Basic" o el de una extensión enlazada + # por la aplicación ("Aliner", "Bootsier"...). Si no está + # habilitado se usa "Basic", con un aviso al arrancar. + # Se aplica a anónimos y a usuarios sin tema propio, y a + # todos si 'theme_per_user' es false. +theme_per_user = false # Si cada usuario puede tener su propio tema (true) o se usa + # siempre 'theme' (false). Con false no se ofrece elegirlo y + # el guardado se conserva por si se activa. admin_path = "/admin" # Ruta raíz del panel de administración. Debe empezar por # "/", sin "/" final; cada tramo sólo admite letras y dígitos # ASCII, "-", "_", "." y "~" (sin ser "." ni ".."). Una no diff --git a/config/test.toml b/config/test.toml index 7544bea8..960f759d 100644 --- a/config/test.toml +++ b/config/test.toml @@ -1,5 +1,7 @@ [app] name = "Testing" +# Lets the tests check that a user's own theme is applied (it is off by default). +theme_per_user = true [server] bind_port = 9000 diff --git a/src/auth.rs b/src/auth.rs index 06dc6866..5c8b8ecc 100644 --- a/src/auth.rs +++ b/src/auth.rs @@ -86,11 +86,8 @@ pub struct CurrentUser { // Ver `timezone()`, que devuelve la zona horaria efectiva. #[getters(skip)] timezone: Option, - /// Devuelve el tema preferido del usuario, o `None` si no tiene ninguno. - /// - /// Lo tiene en cuenta el [`Context`](crate::core::component::Context) de la petición al elegir - /// el tema con el que se renderiza. - #[getters(copy)] + // Ver `theme()`, que devuelve el tema preferido sólo si se aplica. + #[getters(skip)] theme: Option, } @@ -176,6 +173,18 @@ impl CurrentUser { _ => Timezone::default_tz(), } } + + /// Devuelve el tema preferido del usuario, o `None` si no tiene ninguno. + /// + /// También devuelve `None` si [`global::SETTINGS.app.theme_per_user`] es *false*, aunque el + /// usuario tenga uno. Lo tiene en cuenta el [`Context`] de la petición al elegir el tema con el + /// que se renderiza: sin tema preferido, usa el predeterminado de la aplicación. + /// + /// [`global::SETTINGS.app.theme_per_user`]: crate::global::AppSettings::theme_per_user + /// [`Context`]: crate::core::component::Context + pub fn theme(&self) -> Option { + self.theme.filter(|_| global::SETTINGS.app.theme_per_user) + } } // **< Permission >********************************************************************************* diff --git a/src/base/component/form/select_theme.rs b/src/base/component/form/select_theme.rs index b67bf989..2555e93f 100644 --- a/src/base/component/form/select_theme.rs +++ b/src/base/component/form/select_theme.rs @@ -19,6 +19,9 @@ use crate::prelude::*; /// deja enviar el formulario sin elegir un tema. El valor recibido debe validarse igualmente en /// el servidor. /// +/// Si [`global::SETTINGS.app.theme_per_user`] es *false*, el tema propio del usuario no se aplica y +/// no conviene mostrar este campo. +/// /// # Ejemplo /// /// ```rust,no_run @@ -28,6 +31,8 @@ use crate::prelude::*; /// .with_label(Lc::n("Theme")) /// .with_selected("Basic"); /// ``` +/// +/// [`global::SETTINGS.app.theme_per_user`]: crate::global::AppSettings::theme_per_user #[derive(AutoDefault, Clone, Debug, Getters)] pub struct SelectTheme { /// Devuelve la lista de selección interna con la configuración común (nombre, etiqueta, ayuda, diff --git a/src/global.rs b/src/global.rs index bc7e13ab..cd1b1aa2 100644 --- a/src/global.rs +++ b/src/global.rs @@ -82,11 +82,6 @@ pub struct AppSettings { /// Nombre de la aplicación. #[default = "PageTop App"] pub name: String, - /// Tema predeterminado: *"Basic"* o el de una extensión enlazada por la aplicación, sin - /// distinguir mayúsculas y minúsculas. Si no está habilitado se usa *"Basic"*, con un aviso al - /// arrancar. Ver [`default_theme()`](crate::core::theme::default_theme). - #[default = "Basic"] - pub theme: String, /// Idioma predeterminado de la aplicación (p. ej., *"es-ES"* o *"en-US"*). /// /// Cuando tiene un valor validado por [`Locale`](crate::locale::Locale), se usa como candidato @@ -163,9 +158,38 @@ pub struct AppSettings { /// gestionan usuarios no deben ofrecer elegirla; la zona guardada se conserva por si se vuelve /// a activar. Es el equivalente de [`LangNegotiation::ConfigOnly`] para el idioma. /// + /// Sólo tiene efecto con una extensión que guarde la zona horaria de cada usuario y la asigne + /// con [`CurrentUser::with_timezone()`] (como `pagetop-user`); sin ella, ningún usuario tiene + /// zona horaria propia. + /// /// [`CurrentUser::timezone()`]: crate::auth::CurrentUser::timezone + /// [`CurrentUser::with_timezone()`]: crate::auth::CurrentUser::with_timezone #[default = true] pub timezone_per_user: bool, + /// Tema predeterminado: *"Basic"* o el de una extensión enlazada por la aplicación, sin + /// distinguir mayúsculas y minúsculas. Si no está habilitado se usa *"Basic"*, con un aviso al + /// arrancar. Ver [`default_theme()`](crate::core::theme::default_theme). + /// + /// Se usa para las peticiones de usuarios anónimos o sin tema propio, y para todos si + /// [`theme_per_user`](Self::theme_per_user) es *false*. + #[default = "Basic"] + pub theme: String, + /// Si cada usuario puede tener su propio tema (*true*) o se usa siempre el de la aplicación + /// (*false*, por defecto). + /// + /// Con *false*, [`CurrentUser::theme()`] devuelve siempre `None`, aunque el usuario tenga uno + /// guardado, así que todas las páginas se renderizan con [`theme`](Self::theme); y las + /// extensiones que gestionan usuarios no deben ofrecer elegirlo. El tema guardado se conserva + /// por si se activa. No afecta al tema que fije el código de una página concreta. + /// + /// Sólo tiene efecto con una extensión que guarde el tema de cada usuario y lo asigne con + /// [`CurrentUser::with_theme()`] (como `pagetop-user`); sin ella, ningún usuario tiene tema + /// propio. + /// + /// [`CurrentUser::theme()`]: crate::auth::CurrentUser::theme + /// [`CurrentUser::with_theme()`]: crate::auth::CurrentUser::with_theme + #[default = false] + pub theme_per_user: bool, /// Ruta raíz del panel de administración (p. ej. *"/admin"* o *"/manage"*). /// /// Las secciones y páginas del panel se declaran con rutas relativas a ella, y