=== RegiaBot per WordPress ===
Contributors: regiapro
Tags: chatbot, chat, fotografi, lead, crm
Requires at least: 5.0
Tested up to: 7.1
Requires PHP: 7.0
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Mette sul sito la chat del tuo gestionale RegiaPro: risponde ai visitatori e crea i contatti. Si configura da una pagina sola, senza toccare il tema.

== Description ==

RegiaBot e' l'assistente in chat del gestionale RegiaPro, pensato per studi
fotografici, videomaker e professionisti degli eventi. Questo plugin mette
quella chat sul sito WordPress dello studio.

Il chatbot **non gira su questo sito**: gira nel gestionale RegiaPro dello
studio. Il plugin fa tre cose:

* chiede al gestionale, per conto suo e mai mentre un visitatore aspetta la
  pagina, se il bot di quello studio e' acceso;
* se e' acceso, mette in pagina il file della chat con gli agganci previsti da
  WordPress (`wp_enqueue_script`), mai scrivendo codice dentro il tema;
* offre una pagina di impostazioni in italiano con un pulsante che **prova il
  collegamento** e dice, riga per riga, cosa funziona e cosa no.

= Cosa serve =

Un abbonamento a RegiaPro e l'indirizzo internet del proprio gestionale. Non
serve nessuna chiave e nessun codice: in RegiaPro ogni studio ha un indirizzo
suo, quindi l'indirizzo dice gia' di chi e' la chat.

= Privacy =

Il plugin non raccoglie niente e non mette biscotti (cookie). La chat, quando
il visitatore la apre e ci scrive, manda i messaggi al gestionale dello studio:
il plugin prepara il testo gia' pronto per l'informativa del sito, che si trova
in Strumenti - Privacy - Guida alla policy.

== External services ==

Questo plugin si collega **al gestionale RegiaPro dello studio**, il cui
indirizzo lo scrive il proprietario del sito nella pagina delle impostazioni.
Non si collega a nessun altro servizio.

Che cosa viene mandato e quando:

1. **Dal server del sito, ogni ora** (e quando si salvano le impostazioni o si
   preme il pulsante di prova): una richiesta a
   `INDIRIZZO/api/pubblico/chatbot/config` per sapere se il bot e' acceso, come
   si chiama lo studio e se e' attivo il consenso privacy. Non contiene nessun
   dato di nessun visitatore.
2. **Dal browser del visitatore**, e solo se il visitatore apre la chat e ci
   scrive: il file `INDIRIZZO/static/js/widget-chatbot.js` e poi i messaggi
   scritti, verso `INDIRIZZO/api/pubblico/chatbot/messaggio`. Da quella
   conversazione il gestionale puo' creare una scheda contatto.

Poiche' l'indirizzo lo sceglie il proprietario del sito, le condizioni d'uso e
l'informativa privacy sono quelle del servizio RegiaPro dello studio:
https://regiapro.it/condizioni e https://regiapro.it/privacy

== Installation ==

1. Plugin, Aggiungi nuovo, Carica plugin, e scegli il file zip.
2. Attiva.
3. Apri la voce RegiaBot nel menu di sinistra.
4. Incolla l'indirizzo del tuo RegiaPro e premi "Prova il collegamento".
5. Quando la prova e' verde, spunta "Mostra la chat ai visitatori del sito" e
   salva.

Il plugin parte spento apposta: finche' non lo accendi tu, sul sito non compare
niente.

== Frequently Asked Questions ==

= Ho installato e attivato, ma sul sito non si vede niente. =

E' voluto: il plugin parte spento. Apri la pagina RegiaBot: in cima c'e' un
cartello che dice se la chat si vede e, se non si vede, perche'.

= La chat non compare anche se ho acceso tutto. =

Tre cose, in ordine: premi "Prova il collegamento" e leggi le righe rosse;
svuota la cache se hai un plugin che velocizza il sito; guarda il sito da una
finestra anonima del browser.

= Il mio sito e' in https e il gestionale in http. =

Il browser blocca la chat senza dirlo a nessuno. Il pulsante di prova se ne
accorge e te lo scrive. Serve un gestionale che risponda in https.

= Posso mostrarla solo su alcune pagine? =

Si'. Nella pagina delle impostazioni scegli "Solo dove dico io" oppure "Su
tutto il sito tranne dove dico io", e spunti le pagine.

= Voglio nasconderla finche' il visitatore non accetta i cookie. =

C'e' un aggancio per chi sa metterci mano:

`add_filter( 'regiabot_mostra', function ( $mostra ) { return $mostra && ...; } );`

= Il plugin rallenta il sito? =

No. Non chiama mai il gestionale mentre un visitatore aspetta la pagina: lo fa
per conto suo una volta ogni ora. Il file della chat viene caricato in fondo
alla pagina e con "defer", quindi non blocca il disegno della pagina, e non
chiama il gestionale finche' qualcuno non apre la chat.

= Cosa succede se il gestionale smette di rispondere? =

Per un giorno non cambia niente. Dopo un giorno la bolla sparisce dal sito: una
chat che non sa rispondere e' peggio di nessuna chat.

= Cosa succede quando disinstallo il plugin? =

Vengono cancellate le due righe di impostazioni che aveva salvato e il
controllo periodico. Nel gestionale non viene toccato niente: le conversazioni
gia' avvenute sono dello studio e si cancellano da li'.

== Screenshots ==

1. La pagina delle impostazioni, con il cartello che dice se la chat si vede.
2. Il pulsante "Prova il collegamento" e il suo referto, riga per riga.
3. La chat sul sito, con la casella del consenso privacy.

== Changelog ==

= 1.0.0 =
* Prima versione.
