Novità È disponibile GajaCms 2026.11 — regioni del sito, privacy e consensi, pubblicazione multipla. Leggi il changelog

Guida di GajaCms Guida di GajaCms v. 2026.11

Add-on

Gli add-on collegano un sito di GajaCms a servizi esterni, come i listini dei tour operator. Ogni add-on dialoga con un fornitore e, dove previsto, esegue task che importano i dati direttamente nelle strutture del sito: per un add-on travel, partenze, prezzi e contenuti delle strutture ricettive.

La sezione descrive l'uso degli add-on dal pannello del sito. La pagina degli add-on è disponibile ai ruoli ProjectAdmin e Developer.

Dove si trovano

Gli add-on si aprono dal menu laterale dell'ambiente Progetto, gruppo Configurazione, voce Add-on.

La pagina elenca in testa gli add-on Attivi sul sito e sotto quelli Disponibili. Il campo Cerca add-on filtra per nome, categoria ed etichette; i filtri Tutti, Attivi e Disponibili separano gli add-on per stato e, quando sono presenti più categorie, un secondo gruppo di filtri restringe l'elenco alla categoria scelta.

Ogni scheda riporta nome, versione e categoria dell'add-on. Sugli add-on attivi compare anche lo stato del collegamento:

Stato

Significato

Attivo

L'add-on è collegato al fornitore e i task lavorano secondo la pianificazione.

Attivo · test

L'add-on è collegato all'ambiente di test del fornitore.

Credenziali da inserire

L'add-on è attivo sul sito ma mancano i dati di accesso al fornitore.

Errore di collegamento

Il collegamento con il fornitore non è riuscito.

Pagina addons

Attivazione

La scheda di un add-on non attivo mostra la descrizione del servizio: Requisiti, Funzionalità ed eventuale Changelog, con i collegamenti alla guida e ai termini e condizioni quando disponibili.

L'attivazione di un add-on sul sito non avviene dal pannello del sito: si richiede all'agenzia che gestisce il progetto. Una volta attivato, l'add-on passa fra gli Attivi sul sito.

Credenziali del fornitore

Gli add-on che accedono a un servizio esterno richiedono i dati di accesso rilasciati dal fornitore. Finché non sono inseriti, l'add-on resta nello stato Credenziali da inserire e la scheda mostra un avviso.

Il pulsante Credenziali, nella testata della scheda, apre la finestra di inserimento. I campi dipendono dal fornitore: utente e password, chiave e chiave segreta oppure codici specifici come codice azienda e token. I valori riservati restano legati al sito e non compaiono nei report né nei log.

Per i fornitori che prevedono un indirizzo di prova, l'opzione Ambiente di test collega l'add-on a quell'indirizzo; con l'opzione spenta si importano i dati reali.

Task ed esecuzioni

Gli add-on che importano dati lavorano tramite task pianificati. La scheda di un add-on attivo è divisa in Task, Esecuzioni e Descrizione.

Per ogni task la scheda Task riporta la pianificazione, l'ultima e la prossima esecuzione, la destinazione e il riepilogo dei dati importati. Un task appena creato è Da configurare: si sceglie la tipologia di prodotto in cui importare i dati e si attiva il task.

Oltre alle esecuzioni pianificate sono disponibili due comandi manuali:

  • Prova a vuoto: esegue il task in modalità di verifica e produce il report, senza importare i dati nel sito.

  • Esegui ora: avvia subito l'importazione.

I comandi manuali hanno un limite giornaliero. Raggiunto il limite, il pannello indica l'orario da cui il comando torna disponibile. Un'esecuzione in corso si ferma con Interrompi.

La scheda Esecuzioni raccoglie lo storico con lo stato di ciascuna esecuzione: In coda, In corso, Completata, Completata con avvisi, Non riuscita o Interrotta. Selezionando un'esecuzione si apre il report, con i dati importati, le esclusioni, gli avvisi e gli errori.

Pannello Addon

Anomalie e notifiche

Al termine di ogni importazione completata il pannello genera una notifica. Se il fornitore rifiuta le credenziali, o le credenziali mancano, l'esecuzione termina con un errore specifico: la scheda dell'add-on mostra un avviso e la notifica apre direttamente l'add-on.

Sugli errori temporanei del fornitore il sistema ripete l'esecuzione in automatico per un numero limitato di tentativi, indicati nello storico delle esecuzioni.

Disattivazione

Quando un add-on viene disattivato sul sito non compare più nella pagina degli add-on e i suoi task non vengono più eseguiti. Credenziali e configurazione restano conservate e tornano disponibili se l'add-on viene riattivato.

Assistenza

Per richieste di attivazione, anomalie o domande su un add-on il riferimento è l'agenzia che gestisce il progetto.