Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Integrazioni con il Sito Istituzionale

I widget dell'area personale sono una serie di componenti js/html/css che sono inseribili in una qualunque pagina web. In particolare alcuni di questi sono servizi built-in che i comuni devono offrire

Widget generali:

  • Login Box

  • Satisfy

I servizi built-in implementati sono:

  • Richiedi assistenza

  • Segnala problema in città

  • Prenota appuntamento

  • Pagamenti dovuti

I servizi sono presenti in ogni tenant fin dalla sua creazione e non sono modificabili dagli amministratori. Inoltre possono generare pratiche del tutto simili a quelle dei servizi tradizionali, ma il modulo è standard e come amministratore non è possibile modificarlo.

Ogni tenant (ente) punta in automatico alla sua versione widget compatibile in modo automatico

Tutti i widget possono essere caricati con bootstrap-italia 2 se il sito che lo contiene non carica già una versione di bts2 oppure senza

Esempio

Versione con bootstrap-italia 2
"https://servizi.comune.bugliano.pi.it/widgets/bookings/bootstrap-italia@2/js/bookings.js"
"https://servizi.comune.bugliano.pi.it/widgets/bookings/bootstrap-italia@2/css/bookings.css"

Versione senza bootstrap-italia 2
"https://servizi.comune.bugliano.pi.it/widgets/bookings/js/bookings.js"
"https://servizi.comune.bugliano.pi.it/widgets/bookings/css/bookings.css"

Se in una pagina ci sono più widget lo script con le variabili si inserisce una volta

Pagamenti dovuti

Codice da inserire nella pagina per il caricamento del widget, sostituire <domain> con il link dell'area personale dell’ente es: https://servizi.comune.bugliano.pi.it

Prenota appuntamento

Il widget Prenota appuntamento consente di prenotare un servizio verso l'ente.

Il nuovo widget può essere caricato in due modi:

  • direttamente nella pagina con il contenitore oc-bookings inserendo sulla pagina lo script riportato sotto

  • tramite widget servizio (form.io)

Script

Caricamento tramite widget servizio (form.io)

In alternativa è possibile usare il widget servizio.

La configurazione completa del widget è descritta in Integrazione Widget servizio (FormIO).

Segnalazioni

Il widget delle Segnalazioni consente di segnalare un disservizio verso l'ente.

Il nuovo widget può essere caricato in due modi:

  1. direttamente nella pagina con il contenitore oc-inefficiencies inserendo sulla pagina lo script riportato sotto

  2. tramite widget servizio (form.io)

Script

Caricamento tramite widget servizio (form.io)

In alternativa è possibile usare il widget servizio.

La configurazione completa del widget è descritta in Integrazione Widget servizio (FormIO).

Segnalazioni (deprecato)

Il widget restituisce come pagina di default / oppure /# la pagina di invio nuova segnalazione

Sotto la path /#/segnalazioni restituisce la pagina della lista di segnalazioni Sotto la path /#/segnalazioni/{id} restituisce la pagine del dettaglio di una segnalazione

Dalla versione 1.5.0 è stata aggiunta una nuova variabile per limitare la ricerca degli indirizzi tramite zone, configurando un bounding_box (x1,y1,x2,y2) x = longitudine, y = latitudine

Dalla versione 1.6.0 sono state aggiunte due variabili d'ambiante per la configurazione del provider delle mappe basato su nominatim di default il provider è configurato su nominatim.openstreetmap.org.

OC_MAP_SEARCH_PROVIDER configura il provider di ricerca es. ricerca indirizzi da select

All'occorrenza può essere cambiato con un'altro provider custom basato su nominatim

OC_MAP_REVERSE_PROVIDER configura il provider di ricerca inversa, ovvero restituisce l'indirizzo da punto su mappa, es. quando sposto un marker da mappa mi restituisce un indirizzo testuale.

All'occorrenza può essere cambiato con un'altro provider custom basato su nominatim

Configurazione per mostrare il campo Valuta l'importanza del problema Dalla versione 1.14.3

OC_SHOW_SEVERITY_FIELD gestisce l'abilitazione del campo Valuta l'importanza del problema nel form della segnalazione disservizio. Di default il campo è nascosto.

Personalizzazione campi obbligatori per la segnalazione disservizio. Dalla versione 1.16.7 Per rendere obbligatori altri campi del form delle segnalazioni oltre a quelli già previsti di default è possibile popolarewindow.OC_REQUIRED_FIELDS con la lista dei campi che si vuole rendere obbligatori.

lista dei campi che è possibile rendere obbligatori

nome
descrizione

type

Tipo di disservizio (categoria)

address

Luogo (indirizzo)

fiscal_code

Codice fiscale

severity

Valuta l'importanza del problema

Dalla versione 1.11.0 è stata aggiunta la variabile per rendere modificabile la lista delle categorie

Categorie con canali esterni (dalla versione 1.12.3)

Per le categorie configurate con link esterni, il widget invita l'utente a proseguire tramite i canali esterni e impedisce la prosecuzione della compilazione e dell'invio della segnalazione.

I link esterni vanno configurati nel json richiamato tramite window.OC_CATEGORIES_URL popolando all'interno della categoria, il valore external_ref (opzionale) con i seguenti campi:

nome
descrizione

title

titolo

text

descrizione

channels

[channel]

channel

nome
descrizione

type

web, email, phone, ios o android

href

link href

label

link label

esempio:

Configurazione apertura dettaglio segnalazione (dalla versione 1.16.0)

Al termine della compilazione e di invio di una segnalazione se l'utente si è autenticato è presente un link per andare al dettaglio della segnalazione.

Di default il link punta al dettaglio della segnalazione sull'area personale, in alternativa è possibile configurare l'apertura del dettaglio rimanendo nel widget tramite variabile window.OC_SHOW_DETAIL_ON_WEBSITE=true

Dalla versione 1.17.1 è disponibile il routing senza l'uso dell'#

Nelle versione precedenti alla 1.17.0 il routing del widget funzionava solo tramite # HashRouting

Es. https://www.comune-qa.bugliano.pi.it/segnala_disservizio#/segnala_disservizio

Aggiungendo la nuova variabile d'ambiante window.OC_BASENAME è possibile trasformare il routing in versione BrowserRouting

Es. https://www.comune-qa.bugliano.pi.it/segnala_disservizio/segnala_disservizio

Per configurare la variabile window.OC_BASENAME c'è bisogno del path dove è configurato il widget con eventuali sottodomini se il widget è configurato in path non di primo livello.

Es. https://sito.it -> window.OC_BASENAME='/'

Es. https://sito.it/segnalazioni -> window.OC_BASENAME='/segnalazioni'

Es. https://sito.it/segnalazioni/123 -> window.OC_BASENAME='/segnalazioni/123'

Richiesta assistenza

Il widget Richiesta assistenza consente di inviare una richiesta di assistenza all'ente.

Il nuovo widget può essere caricato in due modi:

  1. direttamente nella pagina con il contenitore oc-helpdesk inserendo sulla pagina lo script riportato sotto

  2. tramite widget servizio (form.io)

Script

Caricamento tramite widget servizio (form.io)

In alternativa è possibile usare il widget servizio.

La configurazione completa del widget è descritta in Integrazione Widget servizio (FormIO).

Sui servizi built-in:

  • Richiedi assistenza

  • Segnala problema in città

  • Prenota appuntamento

è stata aggiunta la possibilità di auto generasi un breadcrums semplice del tipo Home / Segnalazioni dove Home è la homepage del sito e segnalzioni è la route del widget, aggiungendo la variabile:

window.OC_RENDER_BREADCRUMB=true

se la variabile non è presente o ha valore false la breadcrums non verrà abilitata

Pulsante accedi all'area personale

Se si hanno altri tipi di autenticazione oltre a SPID è possibile personalizzare il titolo del popup.

Il pulsante Accedi dopo aver effettuato la login può mostrare un menù a tendina con vari voci che ti ridirigono all'area personale, per abilitarlo omettere o impostare come da variabile sotto a false

Per disabilitarlo e vedere solo al voce do logout impostare la variabile a true

Satisfy Widget

Il widget Satisfy consente di raccogliere feedback da parte degli utenti. È disponibile in diverse versioni ed è consigliato utilizzare sempre l’ultima versione aggiornata per garantire compatibilità e funzionalità ottimali. Tutte le versioni che puntano alla Stanza del Cittadino si aggiornano automaticamente.

Tutte le versioni del widget sono disponibili sulla pagina

Installazione

Versione con Bootstrap Italia 2

Se il sito non utilizza già Bootstrap Italia 2 (BI2), includere la versione del widget che lo incorpora:

Sostituire {version} con la versione desiderata (es. 1.6.0). Questa versione è auto-aggiornante.

Versione senza stili (se BI2 è già incluso nel sito)

Se il sito utilizza già Bootstrap Italia 2, includere solamente il componente e lo script del widget:

Oppure, utilizzando una versione CDN:

data-entrypoints è un attributo obbligatorio e contiene l’UUID della configurazione globale del widget.

Configurazioni avanzate

Endpoint personalizzati (dalla versione 1.5.8)

È possibile specificare endpoint alternativi per i salvataggi e per le chiamate API:

Parametri disponibili

Attributo
Descrizione

data-entrypoints

Obbligatorio. UUID della configurazione del widget.

data-api-ratings

URL personalizzato per le richieste POST di salvataggio dei feedback. Se non specificato, usa il default https://satisfy.opencityitalia.it/api/v1/ratings.

data-api-configs

URL personalizzato per le chiamate API GraphQL. Se non specificato, usa https://satisfy.opencityitalia.it/v1/graphql.

PrecedenteDefinizione API PDND ConnectorSuccessivoSingle Sign-On

Ultimo aggiornamento

È stato utile?