✨ (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

@ -35,9 +35,6 @@
[app] [app]
name = "PageTop App" # Nombre de la aplicación. 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 #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 # valor, o si no es válido, el idioma se negocia con otras
# fuentes (cabecera Accept-Language, idioma de respaldo). # 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 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 # se usa siempre 'timezone' (false). Con false no se ofrece
# elegirla y la guardada se conserva por si se reactiva. # 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 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 # "/", sin "/" final; cada tramo sólo admite letras y dígitos
# ASCII, "-", "_", "." y "~" (sin ser "." ni ".."). Una no # ASCII, "-", "_", "." y "~" (sin ser "." ni ".."). Una no

View file

@ -1,5 +1,7 @@
[app] [app]
name = "Testing" name = "Testing"
# Lets the tests check that a user's own theme is applied (it is off by default).
theme_per_user = true
[server] [server]
bind_port = 9000 bind_port = 9000

View file

@ -86,11 +86,8 @@ pub struct CurrentUser {
// Ver `timezone()`, que devuelve la zona horaria efectiva. // Ver `timezone()`, que devuelve la zona horaria efectiva.
#[getters(skip)] #[getters(skip)]
timezone: Option<Tz>, timezone: Option<Tz>,
/// Devuelve el tema preferido del usuario, o `None` si no tiene ninguno. // Ver `theme()`, que devuelve el tema preferido sólo si se aplica.
/// #[getters(skip)]
/// 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)]
theme: Option<ThemeRef>, theme: Option<ThemeRef>,
} }
@ -176,6 +173,18 @@ impl CurrentUser {
_ => Timezone::default_tz(), _ => 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 >********************************************************************************* // **< 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 /// deja enviar el formulario sin elegir un tema. El valor recibido debe validarse igualmente en
/// el servidor. /// 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 /// # Ejemplo
/// ///
/// ```rust,no_run /// ```rust,no_run
@ -28,6 +31,8 @@ use crate::prelude::*;
/// .with_label(Lc::n("Theme")) /// .with_label(Lc::n("Theme"))
/// .with_selected("Basic"); /// .with_selected("Basic");
/// ``` /// ```
///
/// [`global::SETTINGS.app.theme_per_user`]: crate::global::AppSettings::theme_per_user
#[derive(AutoDefault, Clone, Debug, Getters)] #[derive(AutoDefault, Clone, Debug, Getters)]
pub struct SelectTheme { pub struct SelectTheme {
/// Devuelve la lista de selección interna con la configuración común (nombre, etiqueta, ayuda, /// 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. /// Nombre de la aplicación.
#[default = "PageTop App"] #[default = "PageTop App"]
pub name: String, 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"*). /// 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 /// 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 /// 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. /// 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::timezone()`]: crate::auth::CurrentUser::timezone
/// [`CurrentUser::with_timezone()`]: crate::auth::CurrentUser::with_timezone
#[default = true] #[default = true]
pub timezone_per_user: bool, 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"*). /// 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 /// Las secciones y páginas del panel se declaran con rutas relativas a ella, y