✨ (global): Añade el ajuste theme_per_user

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.
This commit is contained in:
Manuel Cillero 2026-11-14 13:27:38 +01:00
parent 9c77a664f8
commit 4603152075
5 changed files with 58 additions and 13 deletions

View file

@ -86,11 +86,8 @@ pub struct CurrentUser {
// Ver `timezone()`, que devuelve la zona horaria efectiva.
#[getters(skip)]
timezone: Option<Tz>,
/// 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<ThemeRef>,
}
@ -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<ThemeRef> {
self.theme.filter(|_| global::SETTINGS.app.theme_per_user)
}
}
// **< Permission >*********************************************************************************

View file

@ -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,

View file

@ -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