P24 Immobiliare Legacy Link

1. Prima configurazione

1. Installa il plugin da Plugin → Aggiungi nuovo → Carica plugin con lo zip fornito da Portali24 e attivalo.
2. In Impostazioni → P24 Immobiliare inserisci Agenzia ID e API Key forniti da Portali24 e salva. Sono gli unici dati obbligatori: tutti gli shortcode del sito li usano.
3. Premi Prepara il sito, in fondo alla stessa pagina: crea le pagine che mancano (Home, Immobili, Chi siamo, Dove siamo, Contatti e Privacy e cookie in bozza) con il loro shortcode e con i titoli impostati nel gestionale, imposta la Home come pagina iniziale del sito, crea il "Menu principale" imposta logo, titolo e motto del sito con quelli dell'agenzia (logo del gestionale, ragione sociale e claim) e crea l'icona del sito: un monogramma con le iniziali dell'agenzia sul colore prevalente del logo. Le iniziali vengono ricavate dalla ragione sociale; se non vanno bene, scrivile nel campo Iniziali dell'icona e rilancia la procedura. Le pagine, la home, i menu, un logo o un'icona caricati a mano e un titolo o motto scritti a mano non vengono mai modificati, quindi si può rilanciare senza danni; logo, icona, titolo e motto scritti dal plugin vengono invece aggiornati se nel gestionale sono cambiati. Con un tema classico il plugin cerca di capire da solo la posizione del menu principale; se non ci riesce lo segnala e il menu va assegnato da Aspetto → Menu.
4. In alternativa, o per pagine aggiuntive, crea le pagine a mano e inserisci in ciascuna lo shortcode adatto, ad esempio:
   • pagina "Annunci": [p24_immobiliare] (ricerca, elenco e scheda di dettaglio);
   • home: [p24_immobiliare vista="ultimi" numero="6"];
   • pagine "Chi siamo", "Dove siamo", "Contatti": vista="chi-siamo", vista="dove-siamo", vista="contatti";
   • footer: [p24_immobiliare vista="contatti-ridotta"].

Altre impostazioni

• Pagina annunci: la pagina in cui si aprono le schede di dettaglio cliccate dalla vista "ultimi". Con "Automatica" il plugin usa la pagina pubblicata che contiene lo shortcode di ricerca. Con Elementor, che salva i contenuti in modo diverso, la pagina non viene trovata da sola: in quel caso sceglila dall'elenco.
• Coordinate sede: vedi Mappa della sede.
• CSS personalizzato: regole aggiunte dopo lo stile del plugin, per adattare colori e spaziature al tema senza modificare file.

2. Utenti e permessi

La soluzione più semplice per chi gestisce il sito è un utente Amministratore: può modificare pagine e contenuti, configurare il plugin e aggiornarlo. Conviene comunque tenere un secondo amministratore riservato a chi realizza il sito, per non perdere mai l'accesso.

Se serve un utente con meno poteri:

• le impostazioni del plugin richiedono il permesso p24_configura, che gli amministratori hanno sempre;
• per darlo a un altro ruolo (es. Editor) installa un plugin di gestione ruoli, come Members, e aggiungi al ruolo il permesso p24_configura: quell'utente potrà configurare il plugin senza accedere a tutte le impostazioni di WordPress;
• per aggiornare il plugin serve invece il permesso di WordPress per aggiornare i plugin (update_plugins).

3. Dati dell'agenzia e cache

Annunci e dati dell'agenzia (ragione sociale, recapiti, claim, descrizioni, immagini delle pagine) si modificano nel gestionale Portali24, non in WordPress.

Se dopo 10 minuti la modifica non si vede ancora, la causa è quasi sempre una cache di pagina del sito (plugin come WP Rocket, LiteSpeed Cache, W3 Total Cache o la cache dell'hosting): va svuotata da quel plugin. Per una verifica veloce apri la pagina in una finestra anonima.

Nelle descrizioni gli a capo del gestionale diventano paragrafi e l'HTML viene mantenuto, tranne i tag non sicuri (script, iframe, form). I numeri di telefono sono mostrati con i separatori (0566 844 623, 389 273 1849).

4. Mappa della sede

• Se nel gestionale è impostata una mappa Google (campo della sezione sito), la pagina "dove siamo" usa quella.
• Altrimenti viene mostrata una mappa OpenStreetMap sulle coordinate della sede. Alla prima visita il plugin le calcola dall'indirizzo dell'agenzia e le salva in Impostazioni → Coordinate sede.
• Il calcolo automatico a volte trova la via ma non il numero civico: se il segnaposto non è preciso, copia latitudine e longitudine da Google Maps (clic destro sul punto esatto) e salvale a mano.
• Se l'agenzia cambia indirizzo, usa Ricalcola coordinate.

Nella scheda di un annuncio la mappa compare solo se nel gestionale l'annuncio ha la mappa attiva, l'indirizzo visibile e le coordinate: in caso contrario la posizione non viene mostrata, per non rivelare l'indirizzo dell'immobile.

5. Form di contatto e richieste

Il form compare nella vista "contatti" e, come "Richiedi informazioni", nella scheda di ogni annuncio (si nasconde con form_richiesta="false").

• Ogni richiesta viene salvata in WordPress, nel menu Richieste contatto, prima di qualsiasi invio: non va persa neanche se l'email non parte.
• L'email all'agenzia viene inviata dal server Portali24, quindi non serve configurare un servizio di posta (SMTP) sul sito. Rispondendo all'email si risponde direttamente al visitatore.
• La colonna Invio email dell'elenco richieste indica se l'email è partita; in caso di errore, passando col mouse sull'esito si vede il motivo.
• Lo spam automatico viene filtrato senza captcha. Il server limita anche il numero di richieste in un'ora, per bloccare gli abusi.

6. Divi, Elementor e altri page builder

Gli shortcode si inseriscono in un modulo Testo o Codice (Divi) o nel widget Shortcode (Elementor).

Dati dell'agenzia nei testi

• Shortcode [p24_dato campo="telefono"], utilizzabile dentro qualsiasi testo: Abbiamo [p24_dato campo="totale_vendita"] immobili in vendita.
• Campi personalizzati p24_telefono, p24_claim, p24_totale_annunci… presenti in ogni pagina, da usare con il "contenuto dinamico" del builder (Divi: Campo personalizzato; Elementor Pro: Tag dinamici → Campo personalizzato). Per i testi con formattazione abilita l'opzione HTML del contenuto dinamico.
• Nei temi a blocchi (WordPress 6.7 o successivo) i blocchi Paragrafo, Titolo, Pulsante e Immagine si collegano ai dati dal pannello Attributi, sorgente "Dati agenzia P24".

L'elenco completo dei campi è in Guida all'uso.

Note su Divi

• Il modulo Contatore di Divi accetta solo un numero fisso: per i totali degli annunci usa un modulo Testo.
• Se aprendo una pagina compare "Questo blocco ha un contenuto inaspettato o non valido", la pagina è stata aperta con l'editor a blocchi di WordPress invece che con Divi: aprila con Modifica con Divi, oppure attiva l'editor classico in Divi → Opzioni del tema → Builder → Avanzate. La pagina non è danneggiata.
• Per la mappa da bordo a bordo (solo_mappa="true") anche la riga di Divi deve essere a larghezza piena.

7. Aggiornamenti del plugin

• Le nuove versioni compaiono nella pagina Plugin come per gli altri plugin, con Aggiorna ora e Visualizza dettagli (le novità della versione).
• Dalla stessa pagina si possono attivare gli aggiornamenti automatici.
• WordPress controlla gli aggiornamenti un paio di volte al giorno; per controllare subito usa Controlla aggiornamenti in fondo alle impostazioni del plugin.
• Le impostazioni del plugin non vengono toccate dagli aggiornamenti.

8. Clonare il sito per un'altra agenzia

Un sito già pronto si può copiare su un nuovo dominio (ad esempio con il plugin Duplicator) e adattare a un'altra agenzia.

Prima di creare la copia

1. Cancella le Richieste contatto ricevute: sono dati personali dei visitatori di questo sito.
2. Facoltativo, per una copia più leggera: elimina dai Media le foto degli annunci salvate dal plugin (il nome del file inizia con p24-). Vengono ricreate da sole quando servono.
3. Se vuoi, togli l'API Key dal sito di partenza, così la copia non mostra gli annunci della vecchia agenzia finché non viene configurata. Ricordati di reinserirla nel sito di partenza.

Nel sito copiato

1. Al termine dell'installazione elimina i file dell'installatore (con Duplicator: installer.php e l'archivio).
2. In Impostazioni → P24 Immobiliare inserisci Agenzia ID e API Key della nuova agenzia e salva.
3. Al cambio di Agenzia ID il plugin scarta da solo le coordinate della mappa e i dati in cache della vecchia agenzia: la mappa viene ricalcolata dall'indirizzo della nuova alla prima visita della pagina "dove siamo". Anche il logo e l'icona creati dal plugin vengono tolti: premi Prepara il sito per crearli con i dati della nuova agenzia. Lo stesso pulsante aggiorna anche titolo e motto del sito, se erano stati scritti dal plugin; se li avevi cambiati a mano, aggiornali da Impostazioni → Generali.
4. Con Divi, svuota la cache dei file CSS generati (Divi → Opzioni del tema → Builder → Avanzate, generazione dei file CSS statici), altrimenti qualche stile può puntare ancora al vecchio dominio.
5. Controlla i testi scritti a mano nelle pagine (nome dell'agenzia, slogan, immagini): solo i dati inseriti con il plugin si aggiornano da soli.

9. Risoluzione dei problemi

10. Per lo sviluppatore: pubblicare una versione

1. Aumenta Version nell'intestazione di p24-immobiliare.php (e, se hai provato una nuova versione di WordPress, Tested up to), poi fai il commit.
2. Lancia tools/crea-rilascio.sh "nota 1 nota 2" dal repository: crea in dist/ lo zip e p24-immobiliare.json partendo dall'ultimo commit.
3. Carica in https://www.portali24.it/p24-immobiliare/ prima lo zip, poi il json.
4. Segna la versione: git tag vX.Y.Z && git push origin main vX.Y.Z.