Referencia de Settings

Chinaski almacena su configuración de site como settings, pares clave/valor que editas bajo Settings en el área de admin (/admin/settings). Cada guardado se snapshot-ea, así que puedes ver y revisitar qué cambió en la pestaña History, y la app loguea cada guardado.

Las settings están organizadas en pestañas: General, Organization, Integrations, Security, Email, PWA, Deploy, Backups, Permalinks y Workflow (más API Keys y Environment, que son features completas con sus propias páginas). Cada pestaña se guarda independientemente: solo se escribe la pestaña que envías, y un guardado dispara automáticamente un site rebuild cuando los valores cambiados afectan tu output público.

General

• Site name: mostrado en los títulos del navegador y en los correos salientes.
• Tagline: usada en las meta descriptions, resúmenes del feed RSS y el subtítulo de página por defecto.
• Footer copyright: agregado al año © en el footer. Déjalo vacío para omitir.
• Noindex: desalienta a los crawlers vía robots.txt y añade noindex a cada página.
• Minify HTML: colapsa el whitespace en el HTML construido. Activado por defecto; deshabilítalo para conservar el espaciado original al depurar.
• Default site image: usada como fallback de og:image en páginas y posts sin imagen propia. Déjala vacía para omitir.
• Active languages: códigos ISO 639-1 separados por comas (p. ej. en,es,pt). Los códigos se validan al guardar. No puedes eliminar un idioma que todavía tiene páginas, posts o blocks: borra o reasigna ese contenido primero. Guarda aquí antes de cambiar el idioma por defecto.
• Default language: idioma de fallback para el build estático; debe estar presente en Active Languages. Silenciosamente sujeta a la lista activa si no.
• Site timezone: un nombre IANA (p. ej. UTC, America/New_York). Las fechas de publish programado se interpretan en esta zona. Los valores inválidos caen a UTC al guardar.
• Site URL: usada para URLs absolutas en sitemap.xml y RSS. Incluye el protocolo; sin slash final (uno se elimina al guardar).
• Posts per page: número de posts en el índice del blog y archivos de categoría. Sujeto al rango 1 a 100.
• URL base prefix: prefijo para los links del build estático (p. ej. /prefix); déjalo vacío para root-relative. Una variable de entorno CHINASKI_URL_BASE lo sobrescribe.
• CMS base URL: URL pública de este CMS. Permite al shortcode [form:slug​] incrustar un form vivo cuando el form no es parte del build estático. Una variable de entorno CHINASKI_CMS_URL lo sobrescribe.
• Blog index title: encabezado y título de página para el listado del blog; vacío usa "Blog". Cada idioma configurado puede tener su propia override.

Integrations

• Build webhook URL / publish webhook URL / Webhook secret: notificaciones de webhook salientes. La URL debe ser una dirección http(s) pública. El secret se almacena cifrado; déjalo vacío para conservar el valor actual.
• GA4 ID / GTM ID: snippets de analytics. Ambos se eliminan de las páginas construidas en modo air-gap.
• Twitter site.
• Cookie notice: interruptor de activación, texto del aviso, URL de la política de cookies y etiquetas de botones de aceptar/rechazar. Cada idioma configurado puede sustituir el texto del aviso y las etiquetas.

Security

Los campos Turnstile y SSO solo aparecen cuando el modo air-gap está apagado.

• Security contact: debe ser una dirección mailto: o una URL https://, o el guardado es rechazado.
• Security policy URL.
• Turnstile site key / secret key: Cloudflare Turnstile para las páginas de login y form. El secret se almacena cifrado; déjalo vacío para conservar el valor actual.
• Failure threshold: dispara una alerta en el event log cuando los fallos de autenticación logueados (incluidos los intentos bloqueados) dentro de los últimos 10 minutos alcanzan este conteo. Default 20. Este es solo un umbral de alerta; el bloqueo de login en sí es fijo: 60 segundos tras 5 fallos consecutivos, 5 minutos tras 10, y 30 minutos tras 20, por IP.
• API key rate limit: peticiones por minuto; 1 a 10000, default 100.
• Self-registration: permite registros desde la página de login. Apagado por defecto.
• Password expiry: días antes de que las contraseñas expiren; 0 deshabilita la expiración.
• SSO (OAuth): interruptor de activación más client ID, client secret, authorization URL, token URL y userinfo URL. El client secret se almacena cifrado; déjalo vacío para conservarlo.

Email

• SMTP host, port, encryption, username: elige el cifrado entre STARTTLS, SSL o ninguno (STARTTLS es el default; las elecciones inválidas se resetean a él al guardar).
• From address: desde dónde se envían los correos de confirmación.
• SMTP password: almacenada cifrada. Déjala vacía para conservar la contraseña existente; usa un app password.
• Build notification email: recibe un mensaje cuando un build tiene éxito o falla. Déjalo vacío para deshabilitar.

PWA

• Enable PWA: genera un manifest, un service worker y una página de fallback offline al momento del build.
• Short name: etiqueta del ícono de la pantalla de inicio (aproximadamente 16 caracteres como máximo); por defecto el nombre del site.
• Theme color / background color: valores hex CSS que controlan el chrome del navegador y la splash screen.
• Display mode: standalone, minimal-ui, fullscreen o browser.
• Offline title / message: contenido de la página de fallback offline.

Deploy

• Deploy SSH/rsync: interruptor de activación más host, usuario, remote path y ruta de SSH key.
• Deploy S3: interruptor de activación más bucket, endpoint, region, access key y secret key. La secret key se almacena cifrada; déjala vacía para conservarla.

Los deploys nunca corren en modo air-gap, sin importar estas settings.

Backups

• DigitalOcean Spaces: endpoint, bucket, region (default nyc3), access key y secret key. La secret key se almacena cifrada; déjala vacía para conservarla. Cambiar solo las credenciales de Spaces no dispara un rebuild.
• Schedule: frecuencia de backup (off por defecto) y hora del día (default 02:00).
• Verify every backup after creation: habilitado a menos que lo apagues explícitamente.
• Local retention: conservar las últimas N copias locales y/o conservar copias locales por N días; 0 significa ilimitado.

Permalinks

• Post URL prefix: default blog. Solo letras, dígitos y guiones sobreviven a un guardado; un valor vacío revierte a blog. Cuando lo cambias, el prefijo viejo se recuerda para que las URLs viejas redirijan automáticamente después del próximo rebuild.
• Language URL mode: cómo aparece el código de idioma en las URLs: path, none o subdomain. Sigue tu conteo de idiomas; un site monolingüe se fuerza a none, un site multilingüe nunca puede ser none. Por defecto path.
• Home redirect: a dónde redirige la raíz del dominio (/), por defecto blog. Rebuild necesario después de cambiarlo.
• Cada idioma configurado puede también definir su propio prefijo de URL de posts; limpiar una override hace que ese idioma caiga al default.

Guardar permalinks siempre dispara un rebuild.

Workflow

• Require approval: cuando está habilitado, los cambios de contenido de los usuarios no admin esperan la approval de un admin antes de ir a vivo.
• Review notification email: recibe notificaciones sobre los eventos del workflow de review.
• Promotion guard: compara cada build contra el último promote limpio y puede negarse a promover un build degradado:
  • Mode: warn (default: loguea el problema y promueve de todos modos), enforce (descarta el staging, sigue sirviendo el build anterior y hace fallar el build) u off. Un build bloqueado puede promoverse manualmente con "Promote anyway" en el dashboard o la flag de fuerza.
  • Page-count drop threshold: máximo porcentaje de caída permitido; default 80.
  • Max broken links: aumento permitido versus el último build limpio; default 25.
  • Max unresolved blocks: un conteo absoluto. Esta puerta no está configurada hasta que introduzcas un número (incluido 0); limpiar el campo la apaga de nuevo.
  • Max accessibility issues increase: aumento permitido versus el último build limpio; default 10.
  • Forzar más allá del guard nunca actualiza los baselines de calidad; el próximo build normal aún compara contra el último promote limpio.

Secrets y notas de seguridad

• La contraseña SMTP, el webhook secret, la deploy S3 secret key, la Turnstile secret key, el OAuth client secret y la Spaces secret key se almacenan cifradas en reposo y nunca se devuelven a tu navegador o a la API en texto plano; los formularios siempre renderizan vacíos y guardar un valor vacío conserva el valor existente.
• El cifrado de los secrets almacenados depende de la variable de entorno CHINASKI_SECRET. Rotar esa variable vuelve indescifrables los valores cifrados guardados previamente; vuelve a guardarlos después.

Resetear una pestaña

Cada pestaña excepto Deploy, Permalinks y Workflow puede resetearse a sus defaults desde el control de reset de su sección. Resetear también borra las overrides por idioma de esa sección; la pantalla de confirmación te dice cuántos valores realmente difieren de los defaults antes de que confirmes.

En esta sección

• Configuración de la Organización
• Configuración de Correo
• Integración con Google Analytics
• Integración con Google Tag Manager
• Usuario de X (Twitter)
• Aviso de Cookies
• Claves de API
• Enlaces Permanentes
• Aplicación Web Progresiva (PWA)
• Favicon