Documentazione
Nota: Questa documentazione è attualmente in fase di sviluppo.

Gestisci una mappa con posizioni e percorsi

Apri Impostazioni

Questo documento fornisce una panoramica completa della funzionalità Mappa all'interno dell'applicazione, spiegandone le funzionalità dal punto di vista sia degli utenti standard (editori) che dei coordinatori (amministratori).

Panoramica

La funzione Mappa consente alle congregazioni di gestire e visualizzare visivamente punti di interesse geografici (Posizioni) e aree/percorsi (Percorsi). Può essere usato per coordinare i luoghi della testimonianza pubblica, definire territori specifici o evidenziare aree importanti per i proclamatori.

La mappa utilizza i riquadri OpenStreetMap e il Leaflet per il rendering. Supporta inoltre la visualizzazione delle posizioni degli utenti, la visualizzazione dei confini della congregazione e il caricamento di immagini per posizioni specifiche.

Ruoli utente

  • Utenti standard (editori): Può visualizzare la mappa, le posizioni, i percorsi e i dettagli associati (come immagini e suggerimenti) se la mappa gli viene resa visibile da un Coordinatore.
  • Coordinatori (amministratori): Avere accesso completo alla gestione. Possono configurare le impostazioni della mappa, creare/modificare/eliminare posizioni e percorsi, gestire immagini di posizioni e disegnare poligoni per i percorsi.

Visualizzazione Utente standard (editore).

Se il Coordinatore ha abilitato l'impostazione "Mappa visibile a tutti gli editori", gli Utenti Standard possono accedere alla mappa tramite il menu di navigazione (sotto Altro -> Mappa).


Visualizzazione della mappa

  • Centratura automatica: La mappa regola automaticamente i suoi confini per adattarsi a tutte le posizioni e i percorsi disponibili. Se non è presente nessuno, il valore predefinito è il punto centrale configurato dal Coordinatore.
  • Marcatori e forme:
    • Le Posizioni vengono visualizzate come indicatori sulla mappa con colori e icone personalizzati.
    • I Percorsi vengono visualizzati come poligoni o linee colorati sulla mappa.
    • I Bordi della congregazione vengono visualizzati come contorni arancioni non interattivi (se abilitati dal Coordinatore).
  • Stile della mappa: La mappa può essere visualizzata in colori standard o in scala di grigi (monocromatica) in base alle impostazioni del calendario.

Interazione con gli elementi della mappa

Facendo clic su un indicatore (Posizione) o su un poligono (Percorso) si apre una finestra di dialogo dei dettagli:

  • Dettagli sulla posizione:
    • Visualizza il nome e la descrizione.
    • Mostra Suggerimenti importanti (evidenziati in rosso per maggiore visibilità).
    • Visualizza una galleria di immagini associate. Facendo clic su una miniatura si apre un Lightbox a schermo intero per lo zoom e la navigazione tra le immagini.
  • Dettagli del percorso:
    • Visualizza il nome e la descrizione.
    • Elenca tutte le posizioni associate a quel percorso specifico.

Funzione "Localizzami".

Gli utenti possono fare clic sul pulsante "Mostra la mia posizione" (icona di destinazione nell'angolo in alto a destra della mappa) per richiedere al browser di trovare e visualizzare la loro posizione geografica corrente sulla mappa. Ciò è utile per trovare i luoghi di testimonianza più vicini.


Visualizzazione Coordinatore (amministratore).

I coordinatori gestiscono la funzione Mappa dall'area di amministrazione in Gestisci mappa (`/admin/map`). Da qui possono configurare le impostazioni globali, gestire le posizioni e i percorsi.


1. Impostazioni della mappa

Accessibile tramite l'icona delle impostazioni (ingranaggio) nella dashboard Gestisci mappa.

Centro latitudine e longitudine

  • Center latitude
  • Center longitude
  • Pick center on map

Cosa fa: Imposta il punto centrale geografico predefinito della mappa. Ciò determina la visualizzazione iniziale quando la mappa viene caricata.

Dove appare / Effetto: Nella visualizzazione della mappa principale, quando un utente apre la sezione della mappa, la mappa verrà inizialmente spostata su queste coordinate esatte.

Mappa visibile per tutti gli editori

Cosa fa: Determina se la funzionalità della mappa è riservata ad amministratori e coordinatori o se è accessibile anche agli utenti standard (editori).

Dove appare / Effetto: Controlla l'aspetto del collegamento del menu Mappa nella navigazione principale. Se abilitato, tutti gli editori vedranno la voce "Mappa" nel proprio menu e potranno visualizzare le località e i percorsi configurati.

Usa tessere monocromatiche

Cosa fa: Modifica lo stile della mappa di base da a colori a scala di grigi (monocromatica).

Dove appare / Effetto: Si applica direttamente agli sfondi della mappa visualizzati da tutti gli utenti. Lo sfondo della mappa diventa bianco e nero, il che può aiutare i percorsi colorati personalizzati e gli indicatori di posizione a risaltare in modo più evidente.

Mostra i confini della congregazione

Cosa fa: Abilita il disegno di linee di confine di congregazione predefinite sulla mappa.

Dove appare / Effetto: Una sovrapposizione di confini verrà sovrapposta alla visualizzazione della mappa principale per tutti gli utenti, delineando aree specifiche.


2. Gestione delle posizioni

Apri nell'area amministrativa

Le posizioni rappresentano punti specifici sulla mappa (ad esempio, la posizione di un carrello, un punto di incontro).

Creazione/modifica di una posizione:

Nome

Cosa fa: L'identificatore principale o il titolo della posizione.

Dove appare / Effetto: Viene visualizzato come titolo quando un utente fa clic sull'indicatore di posizione sulla mappa, nell'elenco delle posizioni nell'area di amministrazione e in qualsiasi menu a discesa di associazione.

Colore / Icon

  • Colore:
    • Cosa fa: Determina la tinta del colore dell'indicatore della mappa.
    • Dove appare / Effetto: L'icona della puntina sulla visualizzazione della mappa effettiva verrà visualizzata nel colore selezionato.
  • Icon:
    • Cosa fa: Consente la selezione di un simbolo o glifo specifico da posizionare all'interno dell'indicatore della mappa.
    • Dove appare / Effetto: L'icona selezionata sarà visibile all'interno della puntina colorata nella visualizzazione mappa, aiutando gli utenti a identificare rapidamente il tipo di posizione a colpo d'occhio.

Coordinate

Latitudine e longitudine. Viene fornito uno strumento "Seleziona coordinate" per selezionare il punto esatto su una mappa.

Descrizione

Cosa fa: Un campo di testo ricco per fornire informazioni generali sulla posizione.

Dove appare / Effetto: Viene visualizzato nel popup o nel pannello dei dettagli quando un utente fa clic sull'indicatore di posizione sulla mappa.

Important hints

Cosa fa: Un campo di testo RTF secondario specifico per avvisi, regole o avvisi critici relativi alla posizione.

Dove appare / Effetto: Appare in primo piano nel pannello dei dettagli della posizione quando si fa clic sulla mappa, spesso con uno stile tale da attirare l'attenzione dell'utente.

Associated routes

Cosa fa: Collega la posizione a uno o più percorsi predefiniti.

Dove appare / Effetto: Attualmente funge da raggruppamento logico. Quando vengono interrogati percorsi o posizioni, questi vengono collegati insieme nel database, il che può influenzare il modo in cui vengono filtrati o visualizzati insieme sulla mappa.

Validity period

Cosa fa: Definisce una data di inizio e di fine in cui questa posizione deve essere considerata attiva.

Dove appare / Effetto: Se la data corrente non rientra in questo intervallo, la posizione verrà automaticamente nascosta dalla visualizzazione della mappa pubblica, anche se è selezionata l'opzione "Attivo".

attivo

Cosa fa: Un interruttore principale per abilitare o disabilitare completamente la posizione.

Dove appare / Effetto: Se deselezionato, l'indicatore di posizione scompare immediatamente dalla mappa per tutti gli utenti, indipendentemente dal periodo di validità.

Gestione delle immagini della posizione:

Dopo aver salvato una posizione, i coordinatori possono caricarvi immagini.

  • Le immagini vengono ridimensionate automaticamente nelle versioni piccola (larghezza 600 px) e grande (larghezza 1600 px) per un caricamento ottimizzato nella galleria frontend e nella lightbox.
  • I coordinatori possono fornire un Titolo e una Descrizione per ciascuna immagine.
  • Le immagini possono essere impostate come Attive o eliminate completamente.

3. Gestione dei percorsi

Apri nell'area amministrativa

I percorsi rappresentano poligoni, linee o aree specifiche sulla mappa (ad esempio, una zona specifica di testimonianza pubblica, un percorso pedonale).

Creazione/modifica di un percorso:

Nome

Cosa fa: L'identificatore primario per il percorso.

Dove appare / Effetto: Visibile nell'elenco dei percorsi dell'area di amministrazione, nei menu a discesa delle associazioni e come titolo se si fa clic sul percorso sulla mappa.

Colore

Cosa fa: Imposta il colore delle linee del percorso e dell'area di riempimento.

Dove appare / Effetto: La forma disegnata sulla mappa verrà renderizzata in questo colore con opacità variabile.

Descrizione

Cosa fa: Testo generale che dettaglia le informazioni sul percorso.

Dove appare / Effetto: Visibile cliccando sull'area del percorso sulla mappa.

Cassetto percorso (poligoni)

Uno strumento cartografico interattivo che consente al Coordinatore di disegnare forme (poligoni) direttamente sulla mappa per definire i confini geografici del percorso.

Associazioni

  • Associated locations:
    • Cosa fa: Collega il percorso a una o più posizioni predefinite sulla mappa.
    • Dove appare / Effetto: Consente di raggruppare logicamente le posizioni in questo percorso. Potrebbe influire sulle visualizzazioni filtrate o sul raggruppamento sulla mappa principale.
  • Articoli prenotabili associati:
    • Cosa fa: Collega il percorso geografico agli elementi del calendario che gli utenti possono prenotare.
    • Dove appare / Effetto: Ciò collega la funzionalità della mappa direttamente al calendario delle prenotazioni. Quando un utente interagisce con un elemento prenotabile specifico, è possibile fare riferimento o mostrare questo percorso.
  • Campagne associate:
    • Cosa fa: Collega il percorso geografico a specifiche Campagne di prenotazione (raggruppamenti logici di turni).
    • Dove appare / Effetto: Quando si gestiscono o si visualizzano le campagne all'interno del calendario, questo contesto geografico fornisce una rappresentazione visiva di dove si svolge la campagna sulla mappa.