wsp-settings.php
Il file wsp-settings.php rappresenta il cuore della configurazione di WebsitePack. All'interno di questo file è possibile gestire centinaia di parametri con cui personalizzare in modo dettagliato sia la parte front-end che back-end del progetto.
Tutte le impostazioni sono raccolte all’interno della variabile principale $wsp_settings, una struttura array che utilizza una gerarchia a "nodi" per organizzare e definire i singoli parametri. Ogni nodo rappresenta una specifica sezione o funzionalità del sistema, consentendo un alto livello di controllo e modularità.
Attraverso questi parametri è possibile intervenire su numerosi aspetti del sistema, tra cui:
- l’aspetto e il comportamento del pannello amministrativo
- la gestione di login e iscrizione utenti
- le impostazioni legate alla privacy e ai cookie
- la configurazione del server SMTP
- l’attivazione e la personalizzazione delle applicazioni interne
- e molto altro ancora
Esempi di parametri configurabili:
$wsp_settings['timezone_string']
definisce il fuso orario utilizzato dal sistema$wsp_settings['calendar']['active']
attiva o disattiva l'applicazione Calendario$wsp_settings['shop']['payments']['credit_card']
regola la possibilità di pagare con carta di credito con il sistema di e-commerce
Qui di seguito sono riportati tutti i parametri disponibili, suddivisi per area tematica, per facilitare la consultazione e l’adattamento del sistema alle specifiche esigenze del progetto.
Impostazioni di base
| Parametro | Valori possibili | Descrizione |
|---|---|---|
| license | Stringa alfanumerica | Codice di licenza del software fornito all'acquisto ed indicato in fase d'installazione. |
| project | Stringa alfanumerica | Nome identificativo del progetto. |
Impostazioni progetto remoto/publico
È possibile impostare i parametri di un ambiente/server locale e remoto (oppure public/staging) in modo da poter lavorarvi contemporaneamente. Tramite il parametro local_host è possibile specificare gli host affinché, sulla base di esso, WSP possa collegarsi a l'uno o l'altro database.
| Parametro | Valori possibili | Descrizione |
|---|---|---|
| remote_directory | Stringa |
Directory remota in cui è stata installata la copia del software. Può essere vuoto. Es: /nomeprogetto/ |
| remote_mail | E-mail |
Email base alla quale si vogliono far recapitare le notifiche rivolte al proprietario del sito. |
| remote_mod_rewrite | (1=attivo, 0=disattivo) |
Abilita la riscrittura degli URL per renderli più facili da ricordare e digitare per gli utenti (abilitare se disponibile nel proprio server web). |
| remote_port | Numero | Porta di rete per accesso remoto (vuoto se non necessario). |
| remote_stats | (1=attivo, 0=disattivo) |
Attiva raccolta statistiche sul sito remoto. |
| remote_db_host | Stringa | Host del database remoto. Es: localhost, 127.0.0.1 oppure IP del server database. |
| remote_db_username |
Stringa
|
Username per il database remoto. |
| remote_db_password | Stringa |
Password per il database remoto. |
| remote_db_name | Stringa |
Nome del database remoto. |
| remote_db_prefix | Stringa |
Prefisso delle tabelle nel database remoto scelto in fase d'installazione. |
Impostazioni locale/staging
| Parametro | Valori possibili | Descrizione |
|---|---|---|
| local_host | Array |
Hostname locali ammessi (di default: 127.0.0.1 e localhost). |
| local_directory | Stringa |
Directory locale in cui è stata installata la copia del software. Può essere vuoto. Es: /nomeprogetto/ |
| local_mail | E-mail |
Email mittente in ambiente di test. |
| local_mod_rewrite | (1=attivo, 0=disattivo) |
Abilita la riscrittura degli URL per renderli più facili da ricordare e digitare per gli utenti (abilitare se disponibile nel proprio server web). |
| local_port | Porta di rete per accesso remoto (vuoto se non necessario). | |
| local_stats | (1=attivo, 0=disattivo) |
Attiva raccolta statistiche sul sito locale. |
| local_db_host | Host del database remoto. Es: localhost, 127.0.0.1 oppure IP del server database. | |
| local_db_username | Username per il database locale. | |
| local_db_password | Password per il database locale. | |
| local_db_name | Nome del database locale. | |
| local_db_prefix | Prefisso delle tabelle nel database remoto scelto in fase d'installazione. |
Chiavi di Sicurezza
| Parametro | Valori possibili | Descrizione |
|---|---|---|
| site_key | Stringa alfanumerica | Chiave principale del sito. |
| salt_key | Stringa alfanumerica |
Chiave per salatura degli hash. |
| cookies_key | Stringa alfanumerica |
Chiave usata per proteggere i cookie. |
| password_key | Stringa alfanumerica |
Chiave per l'hashing delle password. |
Debug e modalità operative
| Parametro | Valori possibili | Descrizione |
|---|---|---|
| debug_mode | 0 = disattivato, 1 = standard, 2 = completo. | Attiva la visualizzazione degli errori e le informazioni utili per il debug. |
| setup_mode | 0 = disattivato, 1 = attivato | Se a 1, attiva la modalità d'installazione iniziale. |
| maintenance_mode |
0 = disattivato, 1 = attivato
|
Attiva la modalità manutenzione manuale. |
| beta_mode | 0 = disattivato, 1 = attivato |
Abilita funzioni beta. |
| password_mode | 0 = disattivato, 1 = attivato |
Rende il progetto visibile solo digitando un'apposita password. |
Impostazioni Globali
| Parametro | Valori possibili | Descrizione |
|---|---|---|
| timezone_string | Stringa tzdata (IANA Time Zone Database) | Fuso orario del sito (es. Europe/Rome). |
| currency_name | Stringa di 3 lettere | Codice valuta (es. EUR). |
| currency_symbol | Stringa di 1 lettera | Simbolo valuta (es. €). |
| currency_symbol_position | 1=prima del valore, 2=dopo. | Posizione del simbolo della valuta. |
| date_format | Stringa | Formato delle date (es. d/m/Y). |
| time_format | Stringa | Formato dell'ora (es. H:i). |
| day_start_week | 0=domenica, 1=lunedì, ..., 6=sabato. | Giorno di inizio settimana. |
| thousand_sep | Stringa | Separatore delle migliaia (es. . oppure ,). |
| decimal_sep | Stringa | Separatore dei decimali (es. ,). |
| num_decimals | Numero | Numero di decimali visualizzati (es: 2, 3 o più). |
| weight_unit | Stringa | Unità di misura per il peso (es. kg). |
| dimension_unit | Stringa | Unità di misura per le dimensioni (es. cm). |
| owner_id | Numero | ID dell'utente proprietario del sito. |
| https_redirect | 1=forza HTTPS, 0=non forzare. | Forza la connessione sicura. |
| www_redirect | 1=forza www, 0=non forzare. | Forza il prefisso www negli URL. |
| cleaning_days | Numero | Giorni dopo cui eliminare dati obsoleti. (es. 60 giorni) |
| lazy_load | 1=attiva lazy loading immagini. | Caricamento differito delle immagini per miglioramento delle prestazioni. |
| website_builder | 1=attiva costruttore sito. | Abilita l’editor visuale del sito. |
| stats_session_minutes | Numero | Durata sessione per le statistiche (minuti). |
Lingue del sito [langs]
| Parametro | Valori possibili | Descrizione |
|---|---|---|
| langs['site'] | Array | Lingue disponibili per il sito pubblico. (es. it, en, es, fr, ecc...) |
| langs['panel'] |
Array
|
Lingue disponibili per il pannello di controllo. (es. it, en, es, fr, ecc...) |
| langs['default_redirect'] | 1=attivo, 0 = disattivato | Se non specificata nell'URL, redirect automatico alla lingua predefinita. |
| langs['intro_page'] | 1=attiva, 0 = disattivata | Pagina statica introduttiva prima di visualizzare la homepage. |
SMTP
Parametri per l'invio in SMTP delle e-mail di notifica spedite dal sito. Migliora la qualità e sicurezza.
| Parametro | Valori possibili | Descrizione |
|---|---|---|
| smtp['host'] | Stringa | Indirizzo del server SMTP. |
| smtp['username'] | Stringa |
Nome utente SMTP. |
| smtp['password'] | Stringa |
Password SMTP. |
| smtp['port'] | Numero | Porta SMTP (es. 465 o 587). |
| smtp['method'] | Stringa |
Metodo di crittografia: `ssl`, `tls` o vuoto. |
Cookie
| Parametro | Valori possibili | Descrizione |
|---|---|---|
| cookies['active'] | 1=gestione cookie attiva. | Attiva sistema cookie. |
| cookies['banner'] | 1=mostra banner. | Banner informativo cookie. |
| cookies['auto_blocker'] | 1=blocca fino a consenso. | Blocco preventivo cookie non tecnici. |
| cookies['allowed'] | Valori separati con una virgola | Lista cookie sempre consentiti. (es. nome cookie, altro cookie, altro cookie, ecc...) |
| cookies['types'] | Array | Tipologie cookie che devono essere mostrate nel banner. |
| cookies['list'] | Array |
Elenco cookie utilizzati. |
API
| Parametro | Valori possibili | Descrizione |
|---|---|---|
| api['active'] | 1=API interne attive. | Attiva le API di sistema. |
| openai['private_key'] | Chiave privata per usare OpenAI. |
Login
| Parametro | Valori possibili | Descrizione |
|---|---|---|
| login['session_duration'] | Durata della sessione utente in minuti. | |
| login['login_errors'] | Numero massimo di errori consecutivi. | |
| login['antiflood'] | Attesa tra tentativi falliti (secondi). | |
| login['button'] | 1=mostra pulsante login. | Abilita il pulsante di login visibile. |
| login['redirect'] | URL verso cui redirigere dopo accesso. |
Pannello di controllo
| Parametro | Valori possibili | Descrizione |
|---|---|---|
| panel['active'] | 1=abilita il pannello di amministrazione. | Attiva/disattiva l'accesso al pannello admin. |
| panel['dir'] | Nome della directory per accedere al pannello (es. wsp-admin). | |
| panel['menu'] | Elenco delle sezioni del menu separate da virgola. | |
| panel['accounts'] | 1=abilita la gestione degli account dal pannello. | Permette agli amministratori di gestire gli utenti. |
| panel['options_active'] | 1=attiva il modulo opzioni. | Abilita la sezione opzioni personalizzate. |
| panel['options_name'] | Etichetta personalizzata per la sezione opzioni. |
Calendario
| Parametro | Valori possibili | Descrizione |
|---|---|---|
| calendar['active'] | 1=attiva il calendario. | Attiva la gestione degli eventi. |
| calendar['logs'] | 1=abilita log attività nel calendario. | Abilita il tracciamento delle modifiche. |
| calendar['category_id'] | ID categoria eventi (0 se non usata). |
Messaggi
| Parametro | Valori possibili | Descrizione |
|---|---|---|
| messages['name'] | Etichetta del modulo messaggi. | |
| messages['sender_confirm'] | 1=invio conferma all’utente mittente. | Invia email automatica all'utente che ha inviato un messaggio. |
| messages['owner_confirm'] | 1=invio notifica al proprietario. | Notifica via email il proprietario del sito. |
Menu
| Parametro | Valori possibili | Descrizione |
|---|---|---|
| menu['active'] | 1=abilita la gestione dei menu. | Abilita la modifica/creazione dei menu di navigazione. |
| menu['deletable'] | 1=consente la cancellazione dei menu. | Permette l'eliminazione dei menu dall'interfaccia admin. |
Pagine
| Parametro | Valori possibili | Descrizione |
|---|---|---|
| pages['name'] | Nome visibile del modulo pagine. | |
| pages['style'] | Stili disponibili per la visualizzazione (es. griglia, colonne). | |
| pages['opt_display'] | Array con info aggiuntive da visualizzare. | |
| pages['opt_list'] | Array con opzioni aggiuntive personalizzate. |
Contenuti
| Parametro | Valori possibili | Descrizione |
|---|---|---|
| contents['active'] | 1=modulo contenuti attivo. | modulo contenuti attivo |
| contents['name'] | Nome visibile del modulo | |
| contents['category'] | ID o livello della categoria contenuti | |
| contents['date'] | 1=visualizza la data. | visualizza la data |
| contents['photo_preview'] | 1=anteprima con foto. | anteprima con foto |
| contents['photos'] | 1=abilita galleria foto. | abilita galleria foto |
| contents['status'] | 1=attiva stato pubblicazione. | attiva stato pubblicazione |
| contents['deletable'] | 1=contenuti eliminabili. | contenuti eliminabili |
| contents['seo'] | 1=gestione SEO attiva. | gestione SEO attiva |
| contents['messages'] | 1=abilita messaggi/commenti. | abilita messaggi/commenti |
| contents['show_not_translate'] | 1=mostra contenuti non tradotti. | mostra contenuti non tradotti |
| contents['opt_display'] | Info aggiuntive da mostrare | |
| contents['opt_list'] | Opzioni extra personalizzate |
Foto (photos)
| Parametro | Valori possibili | Descrizione |
|---|---|---|
| photos['active'] | 1=modulo attivo. | modulo attivo |
| photos['name'] | Nome modulo | |
| photos['type'] | Estensioni consentite (.jpg, .png, ecc.) | |
| photos['size'] | Dimensione massima (MB) | |
| photos['webp'] | 1=abilita conversione WebP. | abilita conversione WebP |
| photos['category'] | ID categoria | |
| photos['description'] | 1=abilita descrizione immagini. | abilita descrizione immagini |
| photos['auto_watermark'] | 1=applica watermark automatico. | applica watermark automatico |
| photos['thumbnails'] | Configura dimensioni miniature |
File (files)
| Parametro | Valori possibili | Descrizione |
|---|---|---|
| files['active'] | 1=modulo attivo. | modulo attivo |
| files['name'] | Etichetta del modulo | |
| files['type'] | Estensioni file ammesse | |
| files['size'] | Limite dimensione file (MB) | |
| files['category'] | ID categoria associata | |
| files['preview'] | 1=abilita anteprima file. | abilita anteprima file |
| files['date'] | 1=visualizza data. | visualizza data |
| files['permalink'] | 1=link permanente attivo. | link permanente attivo |
| files['expiration'] | 1=gestione scadenza file. | gestione scadenza file |
| files['status'] | 1=stato attivo/disattivo. | stato attivo/disattivo |
| files['security'] | 1=file protetti. | file protetti |
| files['description'] | 1=descrizione file visibile. | descrizione file visibile |
Video (videos)
| Parametro | Valori possibili | Descrizione |
|---|---|---|
| videos['active'] | 1 | modulo attivo. |
| videos['name'] | Etichetta modulo. | |
| videos['type'] | Formati accettati (es. .mp4, .mov, .avi...). | |
| videos['size'] | Dimensione massima in MB. | |
| videos['category'] | ID categoria associata. | |
| videos['preview'] | 1 | anteprima abilitata. |
| videos['date'] | 1 | usa data pubblicazione. |
| videos['permalink'] | 1 | usa URL permanente. |
| videos['expiration'] | 1 | data di scadenza attiva. |
| videos['status'] | 1 | gestione stato (pubblicato/bozza). |
| videos['security'] | 1 | contenuti riservati. |
| videos['description'] | 1 | descrizione abilitata. |
| videos['opt'] | Array opzioni personalizzate. |
Audio (audios)
| Parametro | Valori possibili | Descrizione |
|---|---|---|
| audios['active'] | 1 | modulo attivo. |
| audios['name'] | Etichetta modulo. | |
| audios['type'] | Formati accettati (es. .mp3, .wav...). | |
| audios['size'] | Dimensione massima in MB. | |
| audios['category'] | ID categoria associata. | |
| audios['preview'] | 1 | anteprima abilitata. |
| audios['date'] | 1 | usa data pubblicazione. |
| audios['permalink'] | 1 | usa URL permanente. |
| audios['expiration'] | 1 | data di scadenza attiva. |
| audios['status'] | 1 | gestione stato (pubblicato/bozza). |
| audios['description'] | 1 | descrizione abilitata. |
| audios['opt'] | Array opzioni personalizzate. |
Utenti (users)
| Parametro | Valori possibili | Descrizione |
|---|---|---|
| users['active'] | 1=modulo utenti attivo. | modulo utenti attivo |
| users['name'] | Etichetta del modulo utenti | |
| users['category'] | ID categoria utenti | |
| users['username'] | 1=usa username. | usa username |
| users['signin'] | 1=abilita registrazione. | abilita registrazione |
| users['signin_complete'] | 1=registrazione completa. | registrazione completa |
| users['signin_verify'] | 1=verifica email richiesta. | verifica email richiesta |
| users['signin_captcha'] | 1=usa captcha nella registrazione. | usa captcha nella registrazione |
| users['preview'] | 1=abilita anteprima utenti. | abilita anteprima utenti |
| users['photos'] | 1=abilita foto profilo. | abilita foto profilo |
| users['parent'] | 1=gestione struttura padre-figlio. | gestione struttura padre-figlio |
| users['account'] | Array opzioni account (email, profilo, dati, billing, ecc.) | |
| users['opt_display'] | Informazioni aggiuntive da mostrare | |
| users['opt_list'] | Lista opzioni extra personalizzate |
Oggetti (items)
| Parametro | Valori possibili | Descrizione |
|---|---|---|
| items['active'] | 1 | modulo attivo. |
| items['name'] | Etichette modulo (singolare, plurale, singolare minuscolo). | |
| items['preview'] | 1 | anteprima attiva. |
| items['photos'] | 1 | abilita galleria immagini. |
| items['short_description'] | 1 | usa descrizione breve. |
| items['long_description'] | 1 | usa descrizione estesa. |
| items['keywords'] | 1 | usa parole chiave. |
| items['title'] | 1 | titolo obbligatorio. |
| items['category'] | ID categoria associata. | |
| items['qt'] | 1 | gestione quantità. |
| items['price'] | 1 | prezzo abilitato. |
| items['discount'] | 1 | sconto attivabile. |
| items['tax'] | Percentuale IVA (es. 22). | |
| items['code'] | 1 | codice prodotto richiesto. |
| items['variants'] | 1 | varianti attive. |
| items['barcode'] | 1 | codice a barre attivo. |
| items['import'] | 1 | importazione disponibile. |
| items['file'] | 1 | file allegati ammessi. |
| items['date_start'] | 1 | data inizio visibilità. |
| items['expiration'] | 1 | data scadenza. |
| items['user'] | 1 | associazione a utente. |
items['parent'] |
(n) |
Abilita la gestione delle associazioni tra oggetti e utenti. |
| items['messages'] | 1 | messaggi abilitati. |
| items['shipping_amount'] | 1 | costo spedizione abilitato. |
| items['opt_display'] | Opzioni extra da mostrare. |
E-commerce (shop)
| Parametro | Valori possibili | Descrizione |
|---|---|---|
| shop['active'] | 1 | attiva lo shop. |
| shop['marketplace'] | 1 | abilita modalità marketplace. |
| shop['name'] | Etichetta modulo ordini. | |
| shop['shipping'] | Array opzioni spedizione. | |
| shop['alerts'] | 1 | abilita avvisi. |
| shop['coupons'] | 1 | codici sconto attivi. |
| shop['cart_total'] | 1 | mostra totale carrello. |
| shop['note'] | 1 | campo note cliente attivo. |
| shop['phone_required'] | 1 | telefono richiesto. |
| shop['request_invoice'] | 1 | opzione fattura disponibile. |
| shop['disable_cart'] | 1 | disabilita carrello. |
| shop['upload_files'] | 1 | caricamento file attivo. |
| shop['auto_invoice'] | 1 | fattura automatica. |
| shop['payments'] | Array metodi di pagamento disponibili. |
Documenti (docs)
| Parametro | Valori possibili | Descrizione |
|---|---|---|
| docs['active'] | 1 | modulo attivo. |
| docs['name'] | Etichetta modulo. | |
| docs['separator'] | Separatore per identificativo (es. /S). | |
| docs['report'] | 1 | abilita reportistica. |
| docs['cap'] | 1 | richiede CAP nei documenti. |
| docs['tax_r'] | Aliquota fiscale predefinita (es. 20). | |
| docs['tax_stamp_value'] | Valore marca da bollo. | |
| docs['tax_stamp_amount'] | Quantità minima per applicare la marca. | |
| docs['tax_note'] | Array con note fiscali da includere. | |
| docs['type'] | Tipologie di documento con info su sigle, nomi, segni contabili. | |
| docs['taxes_to_pay'] | Totale tasse da versare. | |
| docs['opt_list'] | Opzioni aggiuntive personalizzate. |
Contatti (contacts)
| Parametro | Valori possibili | Descrizione |
|---|---|---|
| contacts['active'] | 1 | modulo contatti attivo. |
| contacts['name'] | Etichetta modulo. | |
| contacts['mailchimp'] | Array configurazione Mailchimp (active, api_key, list_id). |
Email (emails)
| Parametro | Valori possibili | Descrizione |
|---|---|---|
| emails['active'] | 1 | modulo email attivo. |
| emails['name'] | Etichetta modulo email. | |
| emails['category'] | Categoria di default per le email. |
Chat (chat)
| Parametro | Valori possibili | Descrizione |
|---|---|---|
| chat['active'] | 1 | modulo chat attivo. |

