Usuarios experimentados

Advertencia

Utiliza las siguientes instrucciones solo si sabes lo que estás haciendo… «El administrador no es responsable en ningún caso de […] » :D

Adaptar a tu gráfica

Si te sientes cómodo con las hojas de estilo CSS, puedes adaptar Galette CSS para que se ajuste con tus propios colores. Para lograrlo, se desaconseja encarecidamente editar los archivos CSS de Galette, sino usar el mecanismo específico diseñado para ello. Crea un archivo galette_local.css en tu carpeta webroot/themes/default con tus propios estilos, serán incluidos automáticamente.

Intenta mantener las cosas lo más simples posible. Por ejemplo, si deseas cambiar el nombre del color de la organización (mostrado bajo los títulos de las páginas), encontrará en Galette la regla CSS #asso_name que define varios parámetros, incluido el color. Después, en tu hoja de estilo, solo necesitarás lo siguiente:

#asso_name {
    color: red;
}

Esto será suficiente para mostrar el nombre de su organización en rojo. Ten en cuenta que el archivo CSS local y todos los problemas que pueda causar no serán tenidos en cuenta por el equipo de Galette, no se prestará ningún tipo de ayuda.

También puedes sobrescribir la hoja de estilos de la impresión, sólo tienes que crear un archivo galette_print_local.css.

Añadir y modificar cadenas

Es posible, si es necesario, personalizar las cadenas traducidas en Galette - sin editar ningún archivo fuente de Galette. Sólo tienes que crear un archivo galette_{mylang}_local_lang.php (donde {mylang} debe ser sustituido por el idioma, como fr_FR.utf8 o en_US) en la carpeta lang. Este archivo debe contener una simple matriz PHP con la cadena original (la del código fuente de Galette) como índice.

Como ejemplo, queremos cambiar la cadena «Contraseña» en la página de inicio de sesión en francés, traducida como Mot de passe :. La cadena original es Password: (ver galette/templates/default/pages/index.html.twig), su traducción al francés es Mot de passe : y queremos reemplazarla con Secret :; así que crearemos galette_fr_FR.utf8_local_lang.php con el siguiente contenido:

<?php
$lang['Password:'] = 'Secret :';
return $lang;

Desde que Galette utiliza un sistema de caché para las traducciones, los cambios no serán visibles inmediatamente; debes reiniciar tu PHP (o vaciar la caché). Es importante tomar la cadena original al pie de la letra, puntuación incluida; y tener cuidado de escapar las comillas simples (con una barra invertida) en todas las cadenas.

También puedes sobrescribir los idiomas para los complementos utilizando el mismo método, pon el archivo en la carpeta de idiomas de los complementos y llámalo {plugin}_{mylang}_local_lang.php donde {plugin} es el nombre de la ruta donde puedes encontrar el archivo _define.php.

Nota

Esto solo funcionará si utilizas la función de traducción de Galette, y no la nativa gettext.

Cambiar la duración de la sesión

Por defecto, Galette creará la sesión con la duración por defecto (y parece que los navegadores actúan diferente en este caso). De todas maneras puedes definir una constante llamada GALETTE_TIMEOUT para cambiar la duración de la sesión utilizando configuración de comportamiento:

<?php
//see https://www.php.net/manual/en/session.configuration.php#ini.session.cookie-lifetime
define('GALETTE_TIMEOUT', 0);

Registrar las direcciones IP detrás de un proxy

Si tu instancia de Galette se encuentra detrás de un proxy, la dirección IP guardada en el historial será la del proxy, no la del usuario :(

Para corregir esto, utiliza configuración de comportamiento para crear una constante llamada GALETTE_X_FORWARDED_FOR_INDEX como:

<?php
define('GALETTE_X_FORWARDED_FOR_INDEX', 1);

Cada servidor de proxy añadirá su propia dirección a la lista, el ejemplo anterior solo funcionará si hay un único servidor proxy.

Advertencia

Por motivos de seguridad, ¡no utilices esto si tu instancia no está detrás de un proxy!

Estadísticas externas

Nuevo en la versión 0.9.

Muchas plataformas de estadísticas se basan en un bloque Javascript adicional para funcionar. Puedes crear un archivo tracking.js en la carpeta webroot/themes/default, se incluirá automáticamente.

Galette utiliza Javascript para funcionar. Si el código que añades en el archivo tracking.js no es correcto, ¡esto romperá Galette!

Exportaciones CSV

Distinto en la versión 1.0.0: Puedes configurar parámetros de exportaciones con un archivo YAML en vez de uno XML.

Galette proporciona un sistema de exportación CSV parametrizado. Solo se proporciona una exportación parametrizada, pero puede agregar la suya al archivo config/exports.yaml.

Nota

Todavía se admite el archivo de configuración XML heredado; si se encuentra un identificador duplicado, el archivo YAML tiene prioridad.

Examinemos la exportación parametrizada existente «cotizaciones»:

- cotisations:
  # Model: List all cotisations amounts, begin and end dates with adherent name and town
  name: Cotisations
  description: Export de l'état des cotisations pour l'ensemble des adhérents
  filename: galette_cotisations.csv
  query: |-
    SELECT nom_adh, prenom_adh, ville_adh, montant_cotis, date_debut_cotis, date_fin_cotis
      FROM galette_cotisations
      INNER JOIN galette_adherents
        ON (galette_cotisations.id_adh=galette_adherents.id_adh)
  headers:
    - Name
    - Surname
    - Town
    - Amount
    - Begin date
    - End date
  separator: ;
  quote: \"

  • cada matriz de entrada es un identificador único, en minúsculas sin espacios o caracteres especiales

  • name and description son obligatorios ya que se utilizan para mostrar cada exportación parametrizada en la interfaz de usuario

  • filename establece el nombre del archivo de salida

  • query es la consulta a ejecutar, es obligatorio. No hay más limitaciones que las del motor SQL, salvo que no puedes enviarles ningún parámetro

  • headers gestiona los títulos de las columnas:

    • como en el ejemplo anterior, una matriz de títulos de tus propias columnas

    • si no está presente, se exportarán los nombres de los campos de Galette. Puedes utilizar alias para las columnas en tu consulta SQL (SELECT nom_adh AS "Column title" FROM ...)

    • establecer a falso (headers: false) para desactivar la columna de cabecera de la salida

  • separator se utilizará el separador CSV. Los valores posibles son:

    • punto y coma (;) - default

    • coma (,)

    • tabulación (\t)

  • quote ya sea doble - por defecto - o sencilla

  • para desactivar una exportación, puedes añadir inactive: true

Herramientas administrativas

Advertencia

Todas las operaciones de herramientas de administrador son destructivas, utilízalas con precaución, ¡asegúrate que hiciste una copia de seguridad antes!

Hay algunas herramientas suministradas por el administrador de Galette que permite:

  • reinicializar los contenidos de los correos electrónicos restablecerá todo el contenido de los correos electrónicos a valores predeterminados,

  • reinicializar la configuración de los campos restablecerá todos los campos principales de los miembros a sus valores predeterminados. Esto no implica a los campos dinámicos,

  • reinicializar los modelos PDF restablecerá todos los modelos PDF a sus valores predeterminados,

  • generar nombres de usuario y contraseñas vacíos esas informaciones son obligatorias para mejorar la seguridad, pero a veces faltan (si importas un CSV por ejemplo). Esta función establecerá valores aleatorios para los campos de nombre de usuario y contraseñas que puedan estar vacías en la base de datos.

  • Fix dynamic fields dates format will convert all dynamic fields dates to the new format (see dynamic fields).

Modos de Galette

En Galette se suministran varios modos que puedes configurar con la constante GALETTE_MODE (ver la configuración de comportamiento de Galette). Esta directiva puede tomar los siguientes valores:

  • PROD: modo producción (la instancia no producción debe estar en otro modo). Este es el modo predeterminado para los lanzamientos, pero puede cambiar en la rama de desarrollo.

  • DEMO: modo demonstración, parecido a PROD pero con algunas funciones desactivadas como el envío de correos electrónicos, modificar los datos del superadministrador, …

  • TEST: reservado para los test unitarios.

  • MAINT: modo mantenimiento. Solo el superadministrador podrá iniciar sesión.

Depuración de Galette

Nuevo en la versión 1.1.0.

Para activar el modo depuración se puede utilizar una constante específica llamada GALETTE_DEBUG. Con este modo activado:

  • se activarán las partes inestables/no acabadas,

  • algunos datos no se guardan en la sesión,

  • El nivel de registro por defecto está establecido en ‘DEBUG,

  • las noticias no se almacenarán en caché,

  • no se comprobará la versión de la base de datos.

Configuración de comportamiento

Es posible cambiar alguno de los ajustes de Galette:

  • GALETTE_DEBUG: ver depuración de Galette;

  • En la parte relacionada de la documentación puede encontrar la configuración del comportamiento para otros usos (como por ejemplo, las tarjetas PDF, la duración de la sesión,…).

Puede agregar estas directivas declarando constantes en el archivo galette/config/behavior.inc.php.

Por ejemplo:

<?php
define('GALETTE_DEBUG', true);