La configurazione del Gpci framework è totalmente basata su globali php, è possibile configurarle direttamente oppure utilizzando la funzione php SetConfig. Personalizzare la configurazione è opzionale in quanto il framework cercherà nei contesti/hooks di riferimento i valori in questo modo:
- eventuale parametro (solo quando previsto) come potrebbe essere una parametro nella query
- eventuale configurazione impostata (ed eventualmente processerà le condizioni)
- se non trovata una configurazione (oppure le condizioni non sono rispettate) cercherà un'eventuale configurazione default impostata (ed eventualmente processerà le condizioni)
- se non trovata neanche un configurazione default sarà utilizzato il valore interno
In linea di massima è sempre possibile:
- configurare i propri valori predefiniti
- cambiare la configurazione per azioni/blocchi gutenberg poi resettare di nuovo ai valori default
- aggiungere azioni tramite configurazione
Le configurazioni sono sempre ottenute dalla funzione php GetConfig (escluse le funzioni pre wordpress per il launcher) e le globali vanno definite nel file dedicato gpci_config.php (eccetto modifiche temporanee che possono essere definite al momento). In molti casi dovrebbe essere possibile anche definire tramite il modulo snippets.
Una configurazione di esempio potrebbe essere:
$GLOBALS['gpci']['config_default']['php']['hook']['the_posts']['add_post_meta'] = false;
$GLOBALS['gpci']['config']['php']['hook']['the_posts']['add_post_meta'] = true;
//equivalente di
SetConfig( 'default,php,hook,the_posts,add_post_meta', false );
SetConfig( 'php,hook,the_posts.php,add_post_meta', true);Esempio con reset: vedere funzione php ResetConfig.
Condizioni
Tutte le configurazioni (esclusi rarissimi casi) possono avere condizioni che saranno controllate quando il framework ottiene il valore. Vanno semplicemente inserite come chiave array condition oppure conditions e i formati ammessi sono quelli descritti nella funzione php CheckConditions. Se le condizioni non sono rispettate il valore della configurazione diventerà il valore default del framework oppure un valore vuoto/null in base al contesto. Esempi:
$GLOBALS['gpci']['config_default']['php']['hook']['the_posts']['add_post_meta'] = [
'conditions' => [ 'wp,id'=>300 ],
true
];Tabella globali php
Nella tabella seguente sono riportate tutte le globali di configurazione del Gpci framework/core. Quelle relative ai moduli/plugins saranno riportate nelle apposite pagine di documentazione. Notare che tutte queste globali hanno un equivalente default, come visto sopra. Solitamente le globali sono organizzate per percorso, le scorciatoie servono semplicemente ad accorciare la configurazione e organizzare per contesto; tenere presente che ogni scorciatoia imposta la versione lunga corrispondente nel momento della lettura utile (ossia quando serve).
| Globale php | Scorciatoia corrispondente | Tipo di valore | Valore predefinito | Esempio | Descrizione | Documentazione rilevante |
|---|---|---|---|---|---|---|
$GLOBALS['gpci']['config']['php']['cron']['job'] | array di arrays associativi | [] | Configura i cron job chiamati dal launcher integrato nel framework | - Cron | ||
$GLOBALS['gpci']['config']['php']['callback']['EncryptionAction'] | array di arrays associativi - ogni array deve contenere le chiavi id, cipher, secret_key e iv | Configura gli algoritmi di cifratura | - funzione php EncryptionAction | |||
$GLOBALS['gpci']['config']['php']['ajax']['action'] | array di arrays associativi - ogni array deve contenere le chiavi id e function, | [] | Configura le azioni ajax | - ajax |