=== Natom Push ===
Contributors: natom
Tags: push notifications, web push, notifications, publishing
Requires at least: 5.8
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 1.6.5
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Invia una notifica push ai tuoi lettori direttamente dall'editor di WordPress, senza aprire altre schede.

== Description ==

Natom Push collega WordPress al tuo account Natom (https://natom.app) e aggiunge un riquadro
"Notifica push" nella colonna laterale dell'editor.

Il riquadro propone titolo, testo e immagine gia' compilati a partire dall'articolo: la redazione
puo' correggerli e inviare con un clic, restando dentro WordPress.

Funzioni principali:

* Installa da solo il codice di iscrizione: nessun file da caricare via FTP, nessuna modifica al tema
* Audience automatiche da categorie e tag, e lettori taggati in base a cio' che leggono
* Oppure preferenze esplicite: il lettore sceglie le categorie da seguire e le cambia quando vuole
* Titolo e testo precompilati dall'articolo, modificabili prima dell'invio
* Immagine in evidenza inclusa nella notifica (opzionale)
* Scelta dell'audience quando ne hai configurate su Natom
* Indicazione della data di invio sull'articolo, per non inviare due volte per sbaglio
* Conferma prima dell'invio
* Attivabile solo sui tipi di contenuto che scegli

Serve un account Natom. La chiave del plugin e' inclusa in tutti i piani, anche quello gratuito.

== Installation ==

1. Carica la cartella `natom-push` in `/wp-content/plugins/`, oppure installa lo zip da Plugin > Aggiungi nuovo > Carica plugin.
2. Attiva il plugin dalla voce Plugin. Per aggiornare, carica il nuovo zip sopra il vecchio
   ("Sostituisci con quello caricato"): disinstallare cancella tutte le impostazioni, chiave compresa.
3. Vai in Impostazioni > Natom Push e incolla la chiave che trovi su Natom: sezione Siti, pulsante Codice, riquadro WordPress.
4. Controlla che il dominio indicato corrisponda al sito configurato su Natom.

Da quel momento il plugin aggiunge da solo il codice di iscrizione alle pagine e pubblica il
service worker su /natom-sw.js: i visitatori possono iscriversi e le notifiche raggiungono qualcuno.

== Frequently Asked Questions ==

= Serve un account Natom? =

Si'. Il plugin invia le notifiche tramite Natom. La chiave del plugin e' inclusa in tutti i piani,
compreso quello gratuito.

= Chi puo' inviare le notifiche? =

Gli utenti che possono pubblicare articoli. Solo gli amministratori vedono e modificano la chiave API.

= Perche' su Mac non vedo l'immagine? =

macOS consegna le notifiche al Centro Notifiche di sistema, che non mostra ne' le immagini
ne' l'icona del sito: vedrai sempre l'icona del browser. Su Windows, Linux e Android la
stessa notifica mostra immagine e icona regolarmente.

= Le categorie del pannello devono esistere in WordPress? =

No. Dal plugin scegli fra le categorie di WordPress, ma dalla dashboard di Natom puoi proporre
qualsiasi etichetta (per esempio "Offerte"): Natom crea l'audience e chi la spunta ci entra.
La lista e' una sola: l'ultimo salvataggio, dal plugin o dalla dashboard, sostituisce l'altro.
Le audience gia' create restano con i loro iscritti.

= Chi ha scelto delle categorie riceve anche le push mandate a tutti? =

Si'. Chi non sceglie riceve tutto; chi sceglie riceve le sue categorie piu' le push inviate a
"Tutti gli iscritti". Per raggiungere solo una categoria, scegli l'audience nel riquadro.

= Il plugin invia notifiche in automatico? =

No. L'invio parte solo quando qualcuno preme il pulsante. Per invii automatici o ricorrenti
si usano le funzioni RSS e le campagne ricorrenti dentro Natom.

= Quali dati vengono inviati a Natom? =

Titolo e testo della notifica, indirizzo dell'articolo, dominio del sito e, se scelto,
l'indirizzo dell'immagine in evidenza. Nessun dato dei lettori parte da WordPress.

== Changelog ==

= 1.6.5 =
* Documentazione: categorie del pannello, precedenza fra plugin e dashboard, push a tutti.

= 1.6.4 =
* Pannello delle categorie: titolo, sottotitolo, testo dei bottoni e posizione impostabili anche dal plugin.

= 1.6.3 =
* Nel riquadro dell'editor l'audience viene proposta in base alla categoria dell'articolo
  (se esiste e ha iscritti). "Tutti gli iscritti" resta sempre selezionabile.

= 1.6.2 =
* Corretto: su un'installazione nuova le preferenze del lettore non venivano inviate a Natom.
  Ora partono a ogni salvataggio e la pagina impostazioni mostra l'esito.

= 1.6.1 =
* Lo snippet di iscrizione viene recuperato da solo appena c'e' la chiave, senza dover aprire la pagina impostazioni.

= 1.6.0 =
* Preferenze del lettore: scegli le categorie di WordPress da proporre, e chi si iscrive spunta
  quelle che vuole seguire. Link "Gestisci le notifiche" nel footer o con lo shortcode
  [natom_preferences]. Con le preferenze attive il tagging automatico da lettura si spegne.

= 1.5.1 =
* Nel menu Audience ogni voce mostra quanti iscritti ha; quelle vuote non sono selezionabili.

= 1.5.0 =
* Audience automatiche: una per ogni categoria (e per i tag sopra soglia), create su Natom e
  visibili nel menu dell'editor.
* Tagging automatico dei lettori: chi legge un articolo entra nelle audience delle sue
  categorie e dei suoi tag, senza codice da aggiungere.

= 1.4.0 =
* Sicurezza: il service worker e' incluso nel plugin, nessun codice eseguibile viene piu' scaricato da remoto.
* Sicurezza: lo snippet viene caricato solo dai domini Natom, anche se le opzioni fossero manomesse.
* Sicurezza: la chiave API non viene piu' ristampata nella pagina impostazioni (campo vuoto = mantieni).
* Sicurezza: l'invio richiede la stessa capacita' del riquadro (pubblicare + modificare l'articolo);
  nuovo filtro `natom_can_send` per restringere ai soli editor.
* Pulizia completa alla disinstallazione (opzioni, cache, file natom-sw.js).

= 1.3.0 =
* Il campo Audience e' sempre visibile: se non ne hai ancora create, il plugin spiega come farlo
  invece di nascondere la funzione.

= 1.2.2 =
* Testo della notifica piu' corto (20 parole): prima veniva troncato a meta' frase dal sistema.
* Chiarito che le immagini nelle notifiche non sono visibili su macOS.

= 1.2.1 =
* Il dominio viene riconosciuto anche se scritto con "www." o con maiuscole.
* Quando il dominio non corrisponde, le impostazioni mostrano quali siti la chiave vede davvero.

= 1.2.0 =
* Il service worker viene scritto come file vero nella root: funziona anche su nginx, dove le
  richieste ai file statici non arrivano a WordPress.
* Svuotamento automatico della cache delle pagine (W3 Total Cache, WP Rocket, WP Super Cache,
  WP Fastest Cache, LiteSpeed, Autoptimize) quando l'installazione cambia.
* La pagina impostazioni verifica davvero che il service worker risponda, con un pulsante per
  riprovare, invece di limitarsi a dire che e' tutto a posto.

= 1.1.0 =
* Il plugin installa da solo lo snippet di iscrizione e il service worker: niente FTP, niente modifiche al tema.
* Nuova sezione "Iscrizioni" nelle impostazioni, con lo stato dell'installazione.
* Avviso quando sulle pagine e' rimasto il codice di un altro servizio di notifiche push.

= 1.0.0 =
* Prima versione: riquadro nell'editor, invio con conferma, scelta audience, immagine in evidenza.
