Utenti esperti

Avvertimento

Usare solo seguendo le istruzioni se si sa cosa si sta facendo… «La gestione non è responsabile per ogni caso di […]» :D

Adatta al grafico

Se si conosce fogli di stile CSS, si può adattare i CSS di Galette per impostare i colori. Per raggiungere questo obiettivo, è fortemente sconsigliato modificare i file CSS di Galette direttamente, ma piuttosto attraverso un meccanismo specificatamente progettato per questo. Creando un file galette_local.css nella cartella webroot/themes/default i propri stili, verranno automaticamente inclusi.

Si cerchi di mantenere le cose il più semplici possibile. Ad esempio, se si vuole cambiare il colore del nome dell’associazione (visualizzato sotto i titoli delle pagine), si troverà in Galette la regola CSS #asso_name che definisce diversi parametri incluso il colore. Quindi, nel proprio foglio di stile, si avrà bisogno solo di quanto segue:

#asso_name {
    color: red;
}

Questo sarà sufficiente per visualizzare il nome della propria associazione in rosso. Si noti che il file CSS locale e tutti i problemi che può causare non saranno presi in considerazione dal team Galette, non verrà fornito alcun supporto.

Si può anche imporre il foglio di stile di stampa, basta creare un file galette_print_local.css.

Aggiungere e modificare le stringhe

Se necessario, è possibile personalizzare le stringhe tradotte in Galette, senza modificare alcun file sorgente Galette. Basta creare un file galette_{mylang}_local_lang.php (dove {mylang} deve essere sostituito con la lingua, come it_IT.utf8 o en_US) nella cartella lang. Questo file deve contenere un semplice array PHP con la stringa originale (quella nel codice sorgente Galette) come indice.

Ad esempio, vogliamo cambiare la stringa «Password» nella pagina di accesso in francese, tradotta come Mot de passe :. La stringa originale è Password: (vedere galette/templates/default/pages/index.html.twig), la sua traduzione francese è Mot de passe : e vogliamo sostituirla con Secret :; quindi creeremo il galette_fr_FR.utf8_local_lang.php con il seguente contenuto:

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

Poiché Galette utilizza un sistema di cache per le traduzioni, le modifiche potrebbero non essere immediatamente visibili; potrebbe essere necessario riavviare PHP (o svuotare la cache). È importante prendere la stringa originale alla lettera, punteggiatura inclusa; e fare attenzione a evitare le virgolette singole (con una barra rovesciata) in tutte le stringhe.

Si può anche imporrsi sui lang per i plugin usando il metodo sam, basta inserire il file nella cartella lang dei plugin e chiamarlo {plugin}_{mylang}_local_lang.php dove {plugin} è il nome del routing che si trova nel file _define.php.

Nota

Funzionerà solo se usano le funzionalità di traduzione di Galette e non con gettext nativo.

Modifica la durata della sessione

Per impostazione predefinita, Galette creerà sessioni con durata di vita predefinita (e sembra che i browser funzionino in modo diverso in questo caso). È comunque possibile definire una costante chiamata GALETTE_TIMEOUT per cambiare la durata della sessione usando la configurazione del comportamento:

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

Registra gli indirizzi IP dietro un proxy

Se l’istanza Galette è dietro un proxy, l’indirizzo IP memorizzato nella storia sarà quello del proxy e non quello dell’utente :(

Per risolvere questo problema, utilizzare la configurazione del comportamento per creare una costante denominata GALETTE_X_FORWARDED_FOR_INDEX come:

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

Ogni server proxy aggiungerà il proprio indirizzo nell’elenco, l’esempio sopra funzionerà solo se c’è solo un server proxy.

Avvertimento

Per motivi di sicurezza, da non utilizzare se l’istanza non è dietro un proxy!

Statistiche esterne

Nuovo nella versione 0.9.

Molte piattaforme di statistica si basano su un blocco Javascript extra per funzionare. È possibile creare un file tracking.js nella cartella webroot/themes/default, esso verrà incluso automaticamente.

Galette utilizza Javascript per funzionare. Se il codice aggiunto nel file tracking.js è errato, si può bloccare Galette!

Esportazione in CSV

Cambiato nella versione 1.0.0: È possibile impostare le esportazioni dei parametri con un file YAML anziché con uno XML.

Galette fornisce un sistema di esportazione CSV parametrizzato. Viene fornita solo un’esportazione con parametri, ma è possibile aggiungerne una propria al file config/exports.yaml.

Nota

Il file di configurazione XML tradizionale è ancora supportato; ma se si trova un identificatore duplicato, il file YAML ha la precedenza.

Esaminiamo i parametri di esportazione delle «cotizzazioni» esistenti:

- 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: \"

  • ogni voce dell’array è un identificatore univoco, minuscolo senza spazi o caratteri speciali

  • name e description sono obbligatori poiché vengono utilizzati per visualizzare ciascuna esportazione con parametri nell’interfaccia utente

  • filename imposta il nome del file per il file di uscita

  • query è la query da eseguire, è obbligatorio. Non c’è altra limitazione oltre a quelle del motore SQL, ci si aspetta che non si possano inviare loro dei parametri

  • headers gestisce i titoli delle colonne:

    • come nell’esempio sopra, una serie di titoli di colonne di propria scelta

    • se non presente, i nomi dei campi Galette saranno esportati. È possibile utilizzare le colonne nominate nella query SQL (SELECT nom_adh AS "Titolo colonna" FROM ...)

    • impostare a falso (headers: false) per disabilitare le intestazioni delle colonne nell’uscita

  • separator è il separatore CSV che verrà utilizzato. Valori possibili sono:

    • punto e virgola (;) - predefinito

    • virgola (,)

    • carattere di tabulazione (\t)

  • quote virgolette doppie - predefinito - oppure singolo apice

  • per disabilitare un’esportazione, è possibile aggiungere inactive: true

Impostazioni amministratore

Avvertimento

Tutte le operazioni degli strumenti di amministrazione sono distruttive, usarle con cautela e prima assicurarsi di aver eseguito un backup del database!

Ci sono alcuni strumenti forniti per l’amministratore di Galette che permettono di:

  • reinizializza i contenuti dei messaggi di posta ripristinerà tutti i contenuti delle email ai valori predefiniti,

  • reinizializza la configurazione dei campi ripristinerà tutti i campi principali dei membri al loro valore predefinito. Ciò non implica campi dinamici,

  • reinizializza modelli PDF ripristinerà tutti i modelli PDF ai valori predefiniti,

  • genera accessi e password vuoti queste informazioni sono necessarie per migliorare la sicurezza, ma a volte mancano (se si importa un CSV, ad esempio). Questa funzione imposterà valori casuali come campi di login e password che rimarrebbero vuoti nel database.

  • Correggi il formato delle date dei campi dinamici convertirà tutte le date dei campi dinamici nel nuovo formato (vedi campi dinamici).

Modalità di Galette

È possibile configurare Galette con varie modalità di cui è fornito con la costante GALETTE_MODE (vedere configurazione comportamento di Galette). Questa direttiva può assumere i seguenti valori:

  • PROD: modalità di produzione (l’istanza di non produzione dovrebbe essere su un’altra modalità). Questa è la modalità predefinita per i rilasci, ma può cambiare nel ramo di sviluppo.

  • DEMO: modalità dimostrativa, uguale a PROD ma con alcune caratteristiche disabilitate come l’invio di e-mail, la modifica dei dati superadmin, …

  • TEST: riservata agli unit test.

  • MAINT: modalità di manutenzione. Solo il super amministratore sarà in grado di effettuare il login.

Debug di Galette

Nuovo nella versione 1.1.0.

Un nome costante dedicato GALETTE_DEBUG` può essere utilizzato per abilitare la modalità debug. Con questa modalità abilitata:

  • parti instabili/non finite verranno attivate,

  • alcuni dati non saranno memorizzati nella sessione,

  • il livello di log predefinito sarà impostato a DEBUG,

  • le notizie non verranno memorizzate,

  • il controllo versione database non sarà eseguito.

Configurazione del comportamento

È possibile cambiare alcuni comportamenti di Galette:

  • GALETTE_DEBUG: vedere Debug di Galette;

  • troverete nella parte relativa della documentazione che è possibile utilizzare la configurazione del comportamento per altri usi (come le impostazioni delle schede PDF, la durata della sessione, …).

È possibile aggiungere queste direttive dichiarando costanti in galette/config/behavior.inc.php.

Per esempio:

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