Buddypress Groups Location

Visualizza i gruppi BuddyPress e BuddyBoss su mappe OpenStreetMap (OSM) interattive, con ricerca, clustering e sincronizzazione automatica dei colori.

Description

bpglocation è l'estensione definitiva per geolocalizzare i gruppi della tua community BuddyPress o BuddyBoss utilizzando la tecnologia open-source di OpenStreetMap (OSM). Dì addio alle costose chiavi API a pagamento di Google Maps.

Il plugin consente agli amministratori e ai creatori dei gruppi di inserire un indirizzo testuale nel frontend o nel backend di WordPress. Il sistema si occupa del resto, traducendo l'indirizzo in coordinate geografiche reali tramite il servizio di geocodifica gratuito Nominatim.

Caratteristiche Principali

• Integrazione Nativa: Crea automaticamente una nuova scheda "Mappa" all'interno del profilo di ogni gruppo, perfettamente integrata nel design di BuddyBoss e BuddyPress.
• Sistema a Doppio Motore: Se utilizzi i plugin esterni Leaflet Map e Extensions for Leaflet Map, bpglocation si aggancia ad esso sfruttandone shortcode ed estensioni. In caso contrario, attiva un potente motore di fallback nativo caricando le librerie Leaflet da CDN in totale autonomia.
• Master Shortcode Flessibile: Usa il tag [bpglocation] per generare mappe globali, solo moduli di ricerca o mappe di singoli gruppi ovunque tu voglia sul tuo sito.
• Ricerca e Filtri Real-time: Gli utenti possono cercare i gruppi per nome/indirizzo o filtrarli per Group Type tramite una barra responsive posizionata sopra la mappa globale.
• Marker Clustering: Raggruppa automaticamente i marker vicini in comode "bolle numerate" per evitare di appesantire il browser e mantenere la mappa pulita ed esplorabile.
• Sincronizzazione Colori BuddyBoss: Intercetta il colore HEX assegnato alle etichette dei tuoi Group Types su BuddyBoss e lo mappa dinamicamente con il colore del marker Leaflet più vicino.
• Disinstallazione Pulita: Grazie al file uninstall.php, se decidi di eliminare il plugin, tutti i dati geografici (latitudine, longitudine e indirizzi) vengono rimossi dal database senza lasciare record orfani.

Installazione

1. Carica la cartella bpglocation nella directory /wp-content/plugins/.
2. Attiva il plugin tramite il menu 'Plugin' di WordPress.
3. Assicurati che BuddyPress o BuddyBoss Platform siano attivi.
4. (Opzionale) Installa il plugin Leaflet Map e il suo add-on Extensions for Leaflet Map per sbloccare funzioni avanzate come la ricerca per città interna alla mappa o il pulsante a schermo intero.
5. Vai su Impostazioni -> bpglocation nel backend di WordPress per consultare la guida rapida all'uso degli shortcode.

Shortcodes

Il plugin utilizza un unico shortcode centralizzato configurabile tramite attributi:

[bpglocation]

Parametri disponibili

• view: Definisce cosa mostrare.
  • global (default): Mostra la barra di ricerca unita alla mappa di tutti i gruppi.
  • map_only: Mostra solo la mappa globale senza i filtri di ricerca superiori.
  • filters_only: Mostra solo la barra di ricerca e il selettore del tipo di gruppo (ideale per widget o barre laterali).
  • single: Mostra la mappa di un singolo gruppo specifico.
• height: Imposta l'altezza della mappa in pixel (es: height="400"). Default: 550.
• group_id: Specifica l'ID del gruppo da mostrare (richiesto solo se view="single").
• fullscreen: Accetta yes o no. Se impostato su yes, aggiunge il pulsante per ingrandire la mappa a tutto schermo (richiede il plugin esterno Leaflet Map attivo).
• search_geo: Accetta yes o no. Se impostato su yes, aggiunge una lente di ingrandimento dentro la mappa per cercare posizioni o città sulla terra (richiede il plugin esterno Leaflet Map attivo).

Esempi Pratici

• Mappa standard con filtri: [bpglocation]
• Solo mappa ridotta a 400px: [bpglocation view="map_only" height="400"]
• Solo barra filtri per la sidebar: [bpglocation view="filters_only"]
• Mappa del gruppo con ID 15: [bpglocation view="single" group_id="15"]

Frequently Asked Questions

Il plugin supporta il caricamento AJAX di BuddyBoss?

Sì. Tutti gli script di inizializzazione della mappa sono compatibili con i temi BuddyBoss e non soffrono del problema della "mappa grigia o spezzata" durante il cambio di tab nei profili.

Come funziona la sincronizzazione dei colori con BuddyBoss?

Quando crei un "Tipo di Gruppo" su BuddyBoss, puoi assegnargli un colore. Il plugin bpglocation calcola matematicamente a quale degli 8 colori supportati da Leaflet (Blue, Red, Green, Orange, Yellow, Violet, Grey, Black) si avvicina di più il tuo colore personalizzato e colora il pin sulla mappa di conseguenza.

I dati vengono salvati nei metadati dei gruppi?

Sì, vengono archiviati in modo ottimizzato all'interno della tabella bp_groups_groupmeta utilizzando le chiavi bpgl_address, bpgl_lat e bpgl_lng.

Cosa succede se disinstallo il plugin?

Se elimini il plugin dal pannello di controllo di WordPress, tutti i dati geografici e gli indirizzi dei gruppi verranno rimossi permanentemente dal database per garantire la massima pulizia del sito.

Changelog

1.8.0

• Aggiunta pagina ufficiale "Shortcode Helper" nel menu Impostazioni di WP-Admin.
• Ottimizzazione delle query di recupero dei Group Types.

1.7.0

• Introduzione della barra di ricerca alfanumerica integrata.
• Aggiunta del filtro a tendina dinamico basato sui Group Types di BuddyBoss.

1.6.0

• Ristrutturazione completa del plugin con divisione dei file statici nella cartella /assets/.
• Predisposizione della cartella /languages/ per la localizzazione multilingua e file di template .pot.
• Scrittura del modulo di disinstallazione sicura uninstall.php.

1.5.0

• Implementazione dell'algoritmo di conversione cromatica da codici HEX BuddyBoss a tavolozza standard Leaflet.

1.2.0

• Integrazione della libreria e del tag [cluster] per il Marker Clustering automatico sui grandi numeri.

1.0.0

• Rilascio iniziale del plugin. Integrazione base OpenStreetMap via BP_Group_Extension API.