Merge branch 'features/gobar-theme': sistema de perfiles y personalización

Perfil nacional/apn/subnacional/base, todo lo personalizable vía .ini/env
(colores, imagen de fondo, título/subtítulo, Organizaciones, Institucional,
logo del footer, /recursos), gate de Series a series_explorer, /group
renombrado a Temas, limpieza de duplicación y guía de personalización.

Author: AlenCarbajal

README.md

@@ -59,13 +59,11 @@ To install ckanext-gobar-theme:
 
 ## Config settings
 
-None at present
-
-**TODO:** Document any optional config settings here. For example:
-
-	# The minimum number of hours to wait before re-checking a resource
-	# (optional, default: 24).
-	ckanext.gobar_theme.some_setting = some_default_value
+Ver [`docs/personalizacion.md`](docs/personalizacion.md): perfil visual
+(`ckanext.gobar_theme.profile`), colores, imagen de fondo, título/subtítulo
+de la home, label de "Organizaciones", sección Institucional y logo del
+footer, sección /recursos — todo configurable por `.env`/`ckan.ini`, sin
+tocar templates ni código.
 
 
 ## Developer installation

ckanext/gobar_theme/assets/css/gobar-base.css

@@ -3,7 +3,7 @@
    Cargado en todas las páginas
    ========================================================================== */
 
-@import url('https://fonts.googleapis.com/css2?family=Montserrat:wght@300;400;500;600;700;800&display=swap');
+@import url('https://fonts.googleapis.com/css2?family=Montserrat:wght@300;400;500;600;700;800&family=Lora:wght@700&display=swap');
 
 /* ── VARIABLES ──
    Paleta e identidad de marca "Datos Abiertos" (Dirección de Datos Abiertos):
@@ -33,6 +33,21 @@
   --font-cuerpo: 'Montserrat', 'Helvetica Neue', Arial, sans-serif;
 }
 
+/* ── VARIANTE PONCHO (perfiles apn/subnacional/base) ──
+   Prueba: pisa los mismos tokens con la paleta Poncho estricta (navy + celeste,
+   Lora+Montserrat), sin mosaico ni índigo/violeta. Todo el resto del CSS ya
+   consume estas variables, así que no hace falta tocar ningún componente. */
+body.theme-profile-apn,
+body.theme-profile-subnacional,
+body.theme-profile-base {
+  --gobar-primary: #232D4F;        /* navy-poncho */
+  --gobar-primary-dark: #1A2039;
+  --gobar-primary-darker: #141A2E;
+  --gobar-accent: #039BE5;         /* celeste */
+  --gobar-accent-dark: #0767A7;    /* enlace */
+  --font-titulos: 'Lora', Georgia, serif;
+}
+
 /* ── BASE ── */
 body { font-family: var(--font-cuerpo) !important; color: var(--gobar-negro); line-height: 1.6; }
 h1,h2,h3,h4,h5,h6,.page-heading { font-family: var(--font-titulos) !important; font-weight: 600; color: var(--gobar-negro); }

ckanext/gobar_theme/assets/css/gobar-home.css

@@ -18,6 +18,8 @@ body.homepage .main { padding: 0; }
 .gobar-hero h1 { font-family: var(--font-titulos)!important; font-size: clamp(29px, 4vw, 42px); font-weight: 800; color: var(--gobar-navy); line-height: 1.15; letter-spacing: -.01em; margin: 0 0 16px; }
 .gobar-hero h1 .accent { color: var(--gobar-primary); }
 .gobar-hero .lead { font-family: var(--font-cuerpo); font-size: 17px; color: var(--gobar-gris-oscuro); line-height: 1.7; margin: 0 auto 30px; max-width: 640px; font-weight: 400; }
+/* Perfil apn: sin subtítulo configurado no hay .lead debajo, más aire. */
+body.theme-profile-apn .gobar-hero h1 { margin-bottom: 32px; }
 
 /* ── Buscador hero ── */
 .gobar-search { max-width: 600px; width: 100%; margin: 0 auto 44px; }

ckanext/gobar_theme/helpers.py

@@ -152,6 +152,88 @@ def gobar_get_config(key: str, default: str = "") -> str:
     return toolkit.config.get(key, default)
 
 
+def gobar_theme_profile() -> str:
+    return toolkit.config.get("ckanext.gobar_theme.profile", "nacional")
+
+
+def gobar_is_apn() -> bool:
+    """Único lugar que compara contra el literal "apn": todo lo demás
+    (templates y helpers) llama a esta función en vez de repetir la
+    comparación de string."""
+    return gobar_theme_profile() == "apn"
+
+
+def gobar_show_recursos() -> bool:
+    raw = str(
+        toolkit.config.get("ckanext.gobar_theme.show_recursos", "auto")
+    ).strip().lower()
+    if raw == "auto":
+        return not gobar_is_apn()
+    return raw in ("true", "1", "yes", "on")
+
+
+def gobar_institutional_name() -> str:
+    configured = toolkit.config.get("ckanext.gobar_theme.institutional_name", "")
+    if configured:
+        return configured
+    return "" if gobar_is_apn() else "Dirección de Datos Abiertos"
+
+
+def gobar_institutional_url() -> str:
+    configured = toolkit.config.get("ckanext.gobar_theme.institutional_url", "")
+    if configured:
+        return configured
+    return "" if gobar_is_apn() else "https://www.argentina.gob.ar/datos-abiertos"
+
+
+def gobar_organizations_label() -> str:
+    return toolkit.config.get(
+        "ckanext.gobar_theme.organizations_label", "Organizaciones"
+    )
+
+
+def gobar_show_secretariat_logo() -> bool:
+    return toolkit.config.get("ckanext.gobar_theme.show_secretariat_logo", True)
+
+
+def gobar_secretariat_logo_url() -> str:
+    return toolkit.config.get("ckanext.gobar_theme.secretariat_logo_url", "")
+
+
+def gobar_secretariat_logo_alt() -> str:
+    return toolkit.config.get(
+        "ckanext.gobar_theme.secretariat_logo_alt",
+        "Secretaría de Innovación, Ciencia y Tecnología",
+    )
+
+
+def gobar_color_overrides_style() -> str:
+    """Construye el atributo style="..." con los overrides de color de
+    .ini/env (vacíos por defecto). Se aplica en el <body> (base.html) en
+    vez de un <style>/:root aparte: un atributo style inline le gana en
+    especificidad a body.theme-profile-* sin necesitar !important."""
+    overrides = {
+        "--gobar-primary": toolkit.config.get("ckanext.gobar_theme.color_primary", ""),
+        "--gobar-primary-dark": toolkit.config.get(
+            "ckanext.gobar_theme.color_primary_dark", ""
+        ),
+        "--gobar-accent": toolkit.config.get("ckanext.gobar_theme.color_accent", ""),
+    }
+    declarations = [f"{prop}: {value};" for prop, value in overrides.items() if value]
+    return " ".join(declarations)
+
+
+def gobar_hero_background_style() -> str:
+    image_url = toolkit.config.get("ckanext.gobar_theme.hero_background_image", "")
+    if not image_url:
+        return ""
+    return (
+        "background-image: linear-gradient(180deg, rgba(247,247,250,.88), "
+        f"rgba(255,255,255,.92)), url('{image_url}'); "
+        "background-size: cover; background-position: center;"
+    )
+
+
 def gobar_is_spatial_enabled() -> bool:
     plugins_str: str = toolkit.config.get("ckan.plugins", "")
     return any(
@@ -235,6 +317,17 @@ def get_helpers() -> dict[str, Any]:
         # Custom pages
         "gobar_page_list": gobar_page_list,
         "gobar_get_config": gobar_get_config,
+        "gobar_theme_profile": gobar_theme_profile,
+        "gobar_is_apn": gobar_is_apn,
+        "gobar_show_recursos": gobar_show_recursos,
+        "gobar_institutional_name": gobar_institutional_name,
+        "gobar_institutional_url": gobar_institutional_url,
+        "gobar_organizations_label": gobar_organizations_label,
+        "gobar_show_secretariat_logo": gobar_show_secretariat_logo,
+        "gobar_secretariat_logo_url": gobar_secretariat_logo_url,
+        "gobar_secretariat_logo_alt": gobar_secretariat_logo_alt,
+        "gobar_color_overrides_style": gobar_color_overrides_style,
+        "gobar_hero_background_style": gobar_hero_background_style,
         "gobar_is_spatial_enabled": gobar_is_spatial_enabled,
         "gobar_featured_datasets": gobar_featured_datasets,
         "gobar_format_date": gobar_format_date,

ckanext/gobar_theme/plugin.py

@@ -92,6 +92,50 @@ def declare_config_options(
             key.ckanext.gobar_theme.contact_email,
             "datosargentina@sicyt.gob.ar",
         )
+        # base|apn|nacional|subnacional. "nacional" preserva el look actual
+        # (Datos Abiertos) sin tocar .env en el portal ya desplegado.
+        declaration.declare(
+            key.ckanext.gobar_theme.profile, "nacional"
+        )
+        # Nombre/link institucional del footer ("Institucional"): vacío por
+        # defecto (todos los perfiles salvo "apn" usan el default fijo de
+        # helpers.gobar_institutional_name/url, "Dirección de Datos
+        # Abiertos"; en "apn" no se muestra el link salvo que se configure
+        # por .env, porque cada organismo APN tiene el suyo propio).
+        declaration.declare(key.ckanext.gobar_theme.institutional_name, "")
+        declaration.declare(key.ckanext.gobar_theme.institutional_url, "")
+        # true|false|auto. "auto" (default) = ocultar solo en el perfil
+        # "apn" (la sección /recursos son productos de la Dirección de
+        # Datos Abiertos, no aplican a un organismo APN individual);
+        # true/false fuerza el valor sin importar el perfil.
+        declaration.declare(key.ckanext.gobar_theme.show_recursos, "auto")
+        # Nombre de "Organizaciones" en nav/footer/home/faceta: algunos
+        # organismos APN son subdependencias de un ministerio y prefieren
+        # otro término (p. ej. "Organismos", "Dependencias"). Opcional: el
+        # default preserva el texto actual en todos los perfiles.
+        declaration.declare(
+            key.ckanext.gobar_theme.organizations_label, "Organizaciones"
+        )
+        # Subtítulo opcional del hero de la home (perfil apn, que no trae uno
+        # propio): vacío = no se muestra. Ej. MAGyP: "En este portal podrás
+        # obtener datos numéricos y estadísticos del sector agropecuario..."
+        declaration.declare(key.ckanext.gobar_theme.subtitle, "")
+        # Override puntual de colores (hex) por encima del preset del
+        # perfil, y de la imagen de fondo del hero de la home. Vacíos por
+        # defecto: no cambian nada hasta que se configuren por .env.
+        declaration.declare(key.ckanext.gobar_theme.color_primary, "")
+        declaration.declare(key.ckanext.gobar_theme.color_primary_dark, "")
+        declaration.declare(key.ckanext.gobar_theme.color_accent, "")
+        declaration.declare(key.ckanext.gobar_theme.hero_background_image, "")
+        # Logo institucional del pie (hoy Secretaría de Innovación, Ciencia y
+        # Tecnología): vacío = usa la imagen del theme. show=false lo oculta
+        # por completo para organismos sin ese logo.
+        declaration.declare_bool(key.ckanext.gobar_theme.show_secretariat_logo, True)
+        declaration.declare(key.ckanext.gobar_theme.secretariat_logo_url, "")
+        declaration.declare(
+            key.ckanext.gobar_theme.secretariat_logo_alt,
+            "Secretaría de Innovación, Ciencia y Tecnología",
+        )
         declaration.declare_int(
             key.ckanext.gobar_theme.featured_datasets_limit, 4
         )
@@ -110,7 +154,7 @@ def dataset_facets(
         if package_type and package_type != "dataset":
             return facets_dict
         facets = OrderedDict()
-        facets["organization"] = toolkit._("Organizaciones")
+        facets["organization"] = gobar_helpers.gobar_organizations_label()
         facets["groups"] = toolkit._("Grupos")
         facets["res_format"] = toolkit._("Formato")
         facets["vocab_dataset_status"] = toolkit._("Estado")

ckanext/gobar_theme/templates/base.html

@@ -1,5 +1,12 @@
 {%  ckan_extends %}
 
+{# Única fuente de atributos del <body>: class (theme-profile-*, homepage,
+   series-page) y el style inline con los overrides de color de .ini/env
+   (gobar_color_overrides_style — vacío si no hay overrides configurados).
+   Un style inline le gana en especificidad a body.theme-profile-* sin
+   necesitar !important ni un <style>/:root aparte. #}
+{% block bodytag %}{{ super() }} class="theme-profile-{{ h.gobar_theme_profile() }}{% if request.path == '/' %} homepage{% endif %}{% if '/series' in request.path %} series-page{% endif %}"{% set color_style = h.gobar_color_overrides_style() %}{% if color_style %} style="{{ color_style }}"{% endif %}{% endblock %}
+
 {% block styles %}
   {{ super() }}
   {% asset 'gobar_theme/gobar_theme_css' %}

ckanext/gobar_theme/templates/footer.html

@@ -13,11 +13,14 @@
       <h3>Explorar</h3>
       <ul>
         <li><a href="{{ h.url_for('dataset.search') }}">Datasets</a></li>
-        <li><a href="{{ h.url_for('organization.index') }}">Organizaciones</a></li>
+        <li><a href="{{ h.url_for('organization.index') }}">{{ h.gobar_organizations_label() }}</a></li>
         <li><a href="{{ h.url_for('group.index') }}">Temas</a></li>
+        {% if h.plugin_loaded('series_explorer') %}
         <li><a href="{{ h.url_for('series.series') }}">Series de tiempo</a></li>
+        {% endif %}
       </ul>
     </div>
+    {% if not h.gobar_is_apn() %}
     <div>
       <h3>Recursos</h3>
       <ul>
@@ -27,17 +30,22 @@ <h3>Recursos</h3>
         <li><a href="https://github.com/datosgobar/portal-andino-v2">Portal Andino V2</a></li>
       </ul>
     </div>
+    {% endif %}
     <div>
       <h3>Institucional</h3>
       <ul>
         <li><a href="{{ h.url_for('home.about') }}">Acerca del portal</a></li>
-        <li><a href="https://www.argentina.gob.ar/datos-abiertos">Dirección de Datos Abiertos</a></li>
+        {% if h.gobar_institutional_name() %}
+        <li><a href="{{ h.gobar_institutional_url() }}">{{ h.gobar_institutional_name() }}</a></li>
+        {% endif %}
       </ul>
     </div>
   </div>
   <div class="gobar-footer-legal">
     {% snippet "snippets/language_selector.html" %}
-    <img src="{{ h.url_for_static('images/Logo_Secretaria-Innovacion_Blanco.png') }}"
-         alt="Secretaría de Innovación, Ciencia y Tecnología" />
+    {% if h.gobar_show_secretariat_logo() %}
+    <img src="{{ h.gobar_secretariat_logo_url() or h.url_for_static('images/Logo_Secretaria-Innovacion_Blanco.png') }}"
+         alt="{{ h.gobar_secretariat_logo_alt() }}" />
+    {% endif %}
   </div>
 {% endblock %}

ckanext/gobar_theme/templates/group/index.html

@@ -0,0 +1,16 @@
+{% ckan_extends %}
+
+{% block subtitle %}Temas{% endblock %}
+
+{% block breadcrumb_content %}
+  <li class="active">{% link_for "Temas", named_route=group_type+'.index' %}</li>
+{% endblock %}
+
+{% block primary_content_inner %}
+  <h1 class="hide-heading">Temas</h1>
+  {% block groups_search_form %}
+    {% snippet 'snippets/search_form.html', form_id='group-search-form', type=group_type, query=q, sorting_selected=sort_by_selected, count=page.item_count, placeholder='Buscar temas...', show_empty=request.args, no_bottom_border=true if page.items, sorting = [(_('Name Ascending'), 'title asc'), (_('Name Descending'), 'title desc')] %}
+  {% endblock %}
+{% endblock %}
+
+{% block secondary_content %}{% endblock %}

ckanext/gobar_theme/templates/header.html

@@ -17,17 +17,21 @@
     <a class="nav-link" href="{{ h.url_for('dataset.search') }}">Datasets</a>
   </li>
   <li class="nav-item{% if request.path.startswith('/organization') %} active{% endif %}">
-    <a class="nav-link" href="{{ h.url_for('organization.index') }}">Organizaciones</a>
+    <a class="nav-link" href="{{ h.url_for('organization.index') }}">{{ h.gobar_organizations_label() }}</a>
   </li>
   <li class="nav-item{% if request.path.startswith('/group') %} active{% endif %}">
     <a class="nav-link" href="{{ h.url_for('group.index') }}">Temas</a>
   </li>
+  {% if h.gobar_show_recursos() %}
   <li class="nav-item{% if '/recursos' in request.path %} active{% endif %}">
     <a class="nav-link" href="{{ h.url_for('recursos.recursos') }}">Recursos</a>
   </li>
+  {% endif %}
+  {% if h.plugin_loaded('series_explorer') %}
   <li class="nav-item{% if '/series' in request.path %} active{% endif %}">
     <a class="nav-link" href="{{ h.url_for('series.series') }}">Series</a>
   </li>
+  {% endif %}
   <li class="nav-item{% if request.path.startswith('/about') %} active{% endif %}">
     <a class="nav-link" href="{{ h.url_for('home.about') }}">Acerca</a>
   </li>

ckanext/gobar_theme/templates/home/about.html

@@ -7,6 +7,7 @@
 {% endblock %}
 
 {% block about %}
+  {% if not h.gobar_is_apn() %}
   <h2>Datos Abiertos</h2>
 
   <p>
@@ -68,6 +69,39 @@ <h2>¿Qué productos brindamos?</h2>
     organismos nacionales, desarrollamos y ponemos a disposición los
     siguientes productos.
   </p>
+  {% else %}
+  <h2>Portal Andino</h2>
+
+  <p>
+    Portal redistribuible de datos abiertos de la República Argentina.
+  </p>
+
+  <p>
+    Es un portal de código abierto desarrollado por el equipo de Datos
+    Argentina y con las tecnologías de CKAN (Comprehensive Knowledge Archive
+    Network) con el fin de ayudar a los organismos públicos a abrir sus
+    datos.
+  </p>
+
+  <h2>¿Para qué sirve?</h2>
+
+  <p>
+    Andino es un portal diseñado para facilitar el proceso de publicación,
+    navegación y descarga de los datos que abren los organismos. Permite que
+    el público en general reutilice los datos y fomenta la transparencia en
+    las instituciones públicas. Cumple con el Perfil de Aplicación Nacional
+    de Metadatos para Datos Abiertos.
+  </p>
+
+  <h2>¿Qué son los datos abiertos?</h2>
+
+  <p>
+    Los datos son la materia prima para generar información. Los datos
+    públicos son aquellos generados en el ámbito gubernamental. Los datos son
+    abiertos cuando se encuentran publicados con un formato abierto, bajo una
+    licencia abierta explícita y con sus metadatos asociados.
+  </p>
+  {% endif %}
 
   <h2>Sobre CKAN</h2>
   {% snippet 'home/snippets/about_text.html' %}