=== Vorrei Menu – Integrazione ===
Contributors: vorreigroup
Tags: menu, restaurant, digital menu, qr code, whatsapp
Requires at least: 5.8
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.4.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Integra il menù digitale Vorrei Menu dentro il tuo sito WordPress con uno shortcode, un pulsante flottante e un pannello di impostazioni semplice.

== Description ==

Questo plugin collega il tuo **menù digitale Vorrei Menu** al sito WordPress.

L’idea è molto semplice:

* in Vorrei Menu hai il tuo menù digitale (categorie, piatti, lingue, carrello WhatsApp, QR ecc.)
* nel plugin incolli l’URL del tuo menù (es. `https://tuolocale.vorreimenu.it`)
* su WordPress usi uno **shortcode** o un **pulsante flottante** per mostrarlo ai clienti

Il tuo sito resta il centro (es. `ristorante.it`), ma la parte “viva” del menù viene gestita da Vorrei Menu, che è pensato apposta per ristoranti, pizzerie, bar, agriturismi e hotel.

---

### Cosa fa in pratica

**1. Collega il menù digitale a WordPress**

Nel pannello **Impostazioni → Vorrei Menu** imposti:

* URL del tuo menù Vorrei Menu (`https://tuolocale.vorreimenu.it`)
* logo da mostrare (di default il logo Vorrei Menu, oppure il logo del locale)
* attivazione del pulsante flottante “Apri il menù”
* posizione del pulsante (in basso a destra o in basso a sinistra)
* colore del pulsante (rosso brand, verde, oro, scuro)
* testo del pulsante (es. “Apri il menù digitale”, “Guarda il menù”, “Ordina da qui”)

---

**2. Shortcode per incorporare il menù**

Puoi mostrare il menù digitale dentro qualsiasi pagina o articolo con:

`[vorreimenu_embed]`

Lo shortcode genera un **iframe** responsive con il tuo menù Vorrei Menu.

Opzioni disponibili:

`[vorreimenu_embed width="100%" max_width="420px" height="650"]`

* `width` – larghezza iframe (default `100%`)
* `max_width` – larghezza massima (default `420px`)
* `height` – altezza in pixel (default `650`)

Perfetto per una pagina “Menù” nel sito del ristorante.

---

**3. Pulsante flottante “Apri il menù”**

Se lo abiliti nelle impostazioni, il plugin mostra un **pulsante flottante** su tutte le pagine pubbliche del sito:

* sempre visibile nell’angolo (destra o sinistra)
* con logo rotondo (di default `https://vorreiordinare.it/logobase.png`)
* con testo e colore personalizzabili

Il cliente, in qualsiasi punto del sito si trovi, può toccare il pulsante e aprire subito il menù digitale.

---

**4. Altri shortcode utili**

* `[vorreimenu_button]`  
  Stampa un bottone standard che apre il menù in una nuova scheda.  
  Esempio:  
  `[vorreimenu_button text="Guarda il menù del ristorante"]`

* `[vorreimenu_link]`  
  Stampa un link testuale all’URL del menù.  
  Esempio:  
  `[vorreimenu_link text="Apri il menù digitale"]`

---

### Perché usarlo

* Non devi rifare il sito: aggiungi solo la pagina “Menù”.
* Il menù è sempre aggiornato: modifichi da Vorrei Menu, il sito segue da solo.
* Funziona con **qualsiasi tema** e con page builder (Gutenberg, Elementor, Divi, WPBakery, ecc.) perché usa solo shortcode e un po’ di CSS.
* Nessun codice complesso: l’installazione è guidata, con spiegazioni in italiano nel pannello impostazioni.
* Nessun tracking nascosto: il plugin non aggiunge cookie, pixel o script di analisi.

> Questo plugin è pensato per farti sentire **autonomo**: inserisci uno shortcode, controlli il risultato, e da quel momento puoi gestire il menù senza chiamare ogni volta il webmaster.

---

== Installation ==

### 1. Installazione standard da WordPress

1. Vai in **Plugin → Aggiungi nuovo**.
2. Clicca su **Carica plugin**.
3. Seleziona il file `vorrei-menu-integrazione.zip`.
4. Clicca su **Installa ora**.
5. Dopo l’installazione, clicca su **Attiva plugin**.

### 2. Collega il tuo menù Vorrei Menu

1. Vai in **Impostazioni → Vorrei Menu**.
2. Nel campo **URL menù Vorrei Menu** incolla l’indirizzo del tuo menù (esempio: `https://tuolocale.vorreimenu.it`).
3. Controlla che l’URL sia corretto (puoi provarlo in una nuova scheda).
4. Nel campo **Logo sul pulsante** puoi lasciare quello predefinito o mettere un’immagine del locale.
5. Se vuoi, attiva la spunta **“Pulsante flottante”** e scegli:
   * posizione (destra/sinistra)
   * colore del pulsante
   * testo del pulsante
6. Clicca su **Salva le modifiche**.

### 3. Mostra il menù in una pagina

1. Crea o modifica la pagina “Menù” del tuo sito.
2. Nell’editor (Gutenberg, classico o page builder) incolla lo shortcode:

   `[vorreimenu_embed]`

3. Aggiorna la pagina e visitala: dovresti vedere il tuo menù digitale integrato.

---

== Frequently Asked Questions ==

= Serve per forza un account su Vorrei Menu? =

Sì. Il plugin è un ponte tra WordPress e Vorrei Menu.  
Se non hai ancora un menù Vorrei Menu, puoi visitarne il sito per scoprire come attivarlo.

= Posso usare il plugin su qualsiasi tema WordPress? =

Sì. Il plugin non dipende da un tema specifico: aggiunge solo shortcode e un po’ di CSS.  
Funziona con temi gratuiti, premium e child theme.

= Funziona con page builder (Elementor, Divi, WPBakery…)? =

Sì. Inserisci lo shortcode `[vorreimenu_embed]` dentro un widget “Testo”, “Shortcode” o simile.  
Il menù appare all’interno della sezione che hai scelto.

= Posso personalizzare il testo del pulsante flottante? =

Sì. Nelle impostazioni puoi cambiare il testo (es. “Guarda il menù”, “Ordina ora”, “Apri il menù digitale”).

= Il pulsante flottante appare su tutte le pagine? =

Per impostazione predefinita sì, su tutte le pagine pubbliche.  
Se vuoi limitare il comportamento, puoi usare le funzioni standard di WordPress (hook, conditionals) in un plugin personalizzato o nel functions.php del tema child.

= Il plugin aggiunge cookie o sistemi di tracciamento? =

No. Il plugin non aggiunge cookie, pixel o script di tracciamento.  
Si limita a incorporare il tuo menù Vorrei Menu tramite iframe e a offrire un collegamento comodo per i visitatori.

= Posso cambiare il logo nel pulsante? =

Sì. Nel campo **Logo sul pulsante** puoi incollare l’URL di un’immagine (meglio quadrata o rotonda).  
Se lo lasci vuoto, il pulsante verrà mostrato senza logo (solo testo).

= Cosa succede se non imposto l’URL del menù? =

Lo shortcode `[vorreimenu_embed]` non mostrerà nulla (solo un commento HTML interno) e il pulsante flottante non verrà stampato.  
Appena inserisci un URL valido e salvi, tutto riprende a funzionare.

---

== Screenshots ==

1. **Pagina impostazioni** – Colleghi l’URL del menù, scegli logo, posizione e colore del pulsante.
2. **Shortcode nella pagina “Menù”** – Un semplice shortcode incorporato nell’editor.
3. **Menù digitale integrato nel sito** – Il menù Vorrei Menu dentro la pagina WordPress.
4. **Pulsante flottante** – Bottoncino con logo “Apri il menù”, sempre visibile in basso a destra o sinistra.

*(Quando caricherai il plugin su wordpress.org potrai associare a questi punti gli screenshot reali del tuo sito.)*

---

== Changelog ==

= 1.0.0 =
* Prima versione pubblica.
* Shortcode `[vorreimenu_embed]`, `[vorreimenu_button]`, `[vorreimenu_link]`.
* Pulsante flottante con logo, posizione e colori personalizzabili.
* Pannello impostazioni semplice in **Impostazioni → Vorrei Menu**.

== Upgrade Notice ==

= 1.0.0 =
Prima versione stabile del plugin.  
Aggiorna a questa versione per avere shortcode, pulsante flottante e pannello impostazioni in italiano.
