Documento interno · Tecnico
Mappa tecnica: dal campo articolo ai segnali di home e Google News
Riferimento per noi (progetto/sviluppo). Descrive come ogni campo di un articolo alimenta hero, card, “Più letti”, pagina articolo e i segnali letti da Google News. In fondo trovi le linee guida per costruire l'Area Riservata che permetterà ai giornalisti di ottenere tutto questo senza competenze tecniche. La versione per i giornalisti è nel tab ✍️ Istruzioni editoriali.
1 Categoria
2 Titolo + occhiello
3 Sommario
4 Autore
5 Data/ora
6 Immagine
7 Corpo
8 Tag/correlati
9 URL
10 Pubblica & verifica
1
Scegli categoria e sezione
È la prima decisione: determina il badge colorato, il menu in cui compare, l'URL e il campo articleSection dei dati strutturati.
- Assegna una sola categoria principale tra quelle del menu: Napoli · Calciomercato · Serie A · Interviste · Video · Rubriche.
- Se è un contenuto forte, marca l'occhiello come
Esclusiva o Live (badge rosso): è quello che fa salire la notizia nell'hero.
- Niente articoli “senza categoria”: restano fuori dalle griglie di sezione della home.
📍 Alimenta: badge categoria su hero e card · griglie “Ultime Notizie” / “Calciomercato”
2
Scrivi il titolo (H1) e l'occhiello
Il titolo è ciò che appare in hero, nelle card e in headline JSON-LD. Deve funzionare anche estrapolato dal contesto.
- Lunghezza utile: ≤ 110 caratteri (limite letto da Google News per
headline).
- Informativo, non clickbait estremo: il fatto in chiaro (chi/cosa). Il clickbait spinto è motivo di esclusione da Google News.
- Parola chiave principale a sinistra (es. “Napoli, …”): aiuta scansione in lista e SEO.
📍 Alimenta: titolo hero, titolo card, <h1> articolo e headline JSON-LD
3
Compila il sommario (standfirst)
Due righe sotto al titolo che spiegano la notizia. Compaiono nell'hero e nell'occhiello della pagina articolo, e fanno da meta description.
- 1–2 frasi, 140–200 caratteri: cosa è successo e perché è rilevante oggi.
- Non ripetere parola per parola il titolo: aggiungi il dettaglio in più.
📍 Alimenta: occhiello hero in home · standfirst in pagina articolo
4
Imposta l'autore (firma reale)
La firma è un segnale E-E-A-T fondamentale per il rientro in Google News: serve un autore vero, con pagina dedicata.
- Seleziona un autore reale esistente — niente “Redazione” generica sugli articoli firmabili.
- Verifica che la pagina autore esista (
/autore/slug/) con bio, foto e archivio.
- L'autore popola sia la byline in home/articolo sia il box autore a fine pezzo e il campo
author JSON-LD.
📍 Alimenta: byline (avatar + nome) su hero, card e articolo · box autore · author JSON-LD
5
Data e ora di pubblicazione (e aggiornamento)
Le date machine-readable sono obbligatorie per Google News e ordinano i contenuti in home (“1h”, “2h fa”, classifica del giorno).
- Pubblica con data/ora corretta: il template genera
datePublished e <time datetime> in ISO 8601 con fuso.
- Se aggiorni il pezzo, usa la funzione “aggiorna” così si valorizza
dateModified e compare “Agg. …”.
- Non retrodatare né postdatare manualmente: falsa l'ordinamento e i segnali news.
📍 Alimenta: timestamp su card e byline · ordinamento “Ultime” / “Più letti” · datePublished/dateModified
6
Carica l'immagine di copertina
È la thumbnail delle card, l'hero 16:9 dell'articolo e il campo image JSON-LD richiesto da Google News.
- Formato 16:9, lato lungo ≥ 1200px (Google News chiede immagini grandi).
- Salva in WebP/AVIF con dimensioni esplicite: niente layout shift (CLS).
- Compila sempre testo alternativo e didascalia/credito della foto.
📍 Alimenta: thumbnail card · hero image articolo · anteprima Google News · image JSON-LD
7
Struttura il corpo del testo
Un corpo ben strutturato è leggibile, ospita lo slot pubblicitario in-article senza disturbo e migliora il tempo di lettura (→ “Più letti”).
- Paragrafi brevi; usa i sottotitoli H2 per gli snodi (“I dettagli dell'operazione”).
- Inserisci almeno una pull-quote per dare ritmo dove c'è una dichiarazione forte.
- Testo originale e datato; le correzioni vanno tracciate, non sovrascritte in silenzio.
- Lo slot in-article si inserisce da solo dopo i primi paragrafi: non incollare banner a mano.
📍 Alimenta: corpo articolo leggibile · tempo di permanenza → classifica “Più letti oggi”
8
Aggiungi tag e correlati
I tag costruiscono i blocchi “Correlati” in pagina e le card squadra in sidebar, tenendo il lettore dentro al sito.
- 3–5 tag pertinenti (squadra, competizione, tema):
#Napoli #Calciomercato #SerieA.
- Riusa i tag esistenti invece di crearne di nuovi quasi-uguali: evita doppioni.
📍 Alimenta: box “Correlati” · tag squadre in sidebar · navigazione interna
9
Controlla lo slug / URL
L'URL deve essere pulito, stabile e parlante: è un requisito tecnico Google News e non va mai cambiato dopo la pubblicazione.
- Pattern
/{categoria}/{slug}/ → es. /calciomercato/napoli-colpo-centrocampo/.
- Niente
?p=1234, niente date nello slug, niente parole inutili.
- Non modificare l'URL a articolo già online: se proprio serve, va impostato un redirect 301.
📍 Alimenta: URL canonico · sitemap news · mainEntityOfPage JSON-LD
10
Pubblica e verifica
Alla pubblicazione l'articolo entra nella news-sitemap (48h) e diventa candidabile a hero/card. Prima di chiudere, controlla i segnali.
- Anteprima: titolo, sommario, immagine e byline appaiono corretti in hero e card?
- Le date si mostrano (“pubblicato” + eventuale “agg.”)?
- Su pezzi importanti, passa l'URL al Rich Results Test per validare il JSON-LD
NewsArticle.
📍 Alimenta: ingresso in news-sitemap · candidatura a hero/card home · indicizzazione Google News
⚠️ Regola d'oro: non aggiungere banner pubblicitari manualmente nel corpo e non sovraccaricare di immagini pesanti. Gli slot (in-article, half-page, native) sono già posizionati dal template per non rovinare i Core Web Vitals. Troppa pubblicità o pagine lente sono tra le cause più comuni di esclusione da Google News.
📰 Checklist prima di pubblicare
- Categoria principale assegnata
- Titolo ≤ 110 caratteri, non clickbait
- Sommario di 1–2 frasi compilato
- Autore reale + pagina autore attiva
- Data/ora corrette (no retrodatazioni)
- Immagine 16:9 ≥ 1200px in WebP/AVIF
- Alt text e didascalia/credito foto
- Sottotitoli H2 e almeno una pull-quote
- 3–5 tag pertinenti, senza doppioni
- URL pulito
/categoria/slug/
- Nessun banner inserito a mano
- JSON-LD validato (pezzi chiave)
Linee guida per l'Area Riservata (CMS)
Obiettivo della piattaforma: il giornalista compila campi semplici e il sistema genera da solo tutti i segnali tecnici (slug, date ISO, JSON-LD, immagini ottimizzate, sitemap). Nessuno in redazione deve toccare codice. Sotto: i principi, la mappa campo→automazione e i controlli bloccanti.
A
Principi di progetto del backend
- Un solo form per articolo, lineare e in italiano: l'ordine dei campi segue i 10 passi di questa guida.
- Automazione invisibile: ogni requisito tecnico è prodotto dal sistema, mai chiesto all'utente (niente HTML, niente JSON, niente date ISO a mano).
- Anteprima live a lato: “come appare in homepage” e “come appare in pagina” aggiornate mentre si scrive.
- Semaforo di idoneità (rosso/giallo/verde) che riassume completezza editoriale + segnali Google News, con suggerimenti azionabili.
- Ruoli: Redattore (scrive/invia) · Editor/Caporedattore (pubblica) · Admin (anagrafiche, sezioni, utenti).
B
Mappa: campo dell'editore → automazione del sistema
Cosa vede e compila il giornalista (colonna sinistra) e cosa genera la piattaforma dietro le quinte (colonna destra).
| Campo nel form (utente) | Cosa genera la piattaforma (automatico) |
|---|
| Sezione (menu a tendina) | Badge categoria, prefisso URL, voce di menu, articleSection nel JSON-LD |
| Titolo (con contatore live) | <h1> + headline; alert oltre 110 caratteri; proposta automatica di slug |
| Sommario (textarea breve) | Standfirst in pagina, occhiello hero, meta description |
| Autore (da anagrafica firme) | Byline + box autore + author con link a /autore/slug/ |
| (nessun campo data) | datePublished alla pubblicazione e dateModified ad ogni modifica, in ISO 8601 con fuso |
| Immagine (drag&drop + crop guidato 16:9) | Resize ≥1200px, conversione WebP/AVIF, srcset, dimensioni esplicite, image JSON-LD |
| Alt + didascalia/credito | Attributo alt e caption sotto la foto (campi obbligatori) |
| Corpo (editor visuale con pulsanti) | Solo stili consentiti (H2, pull-quote, grassetto); pulizia HTML; inserimento automatico dello slot in-article |
| Tag (autocomplete dai tag esistenti) | Blocco “Correlati”, tag squadre, link interni |
| Slug (proposto, modificabile prima della pubblicazione) | URL pulito /categoria/slug/, rel=canonical, 301 automatico se modificato dopo l'online |
| Pulsante “Pubblica” | JSON-LD NewsArticle completo, inserimento in news-sitemap (48h) + sitemap generale |
C
Controlli bloccanti prima della pubblicazione
Il pulsante “Pubblica” resta disattivo finché tutti i requisiti minimi sono soddisfatti — così l'idoneità Google News non dipende dalla memoria del redattore.
- Sezione assegnata e titolo entro 110 caratteri.
- Sommario presente.
- Autore reale selezionato (no “Redazione” sui pezzi firmabili) con pagina autore attiva.
- Immagine caricata, 16:9, ≥1200px, con alt e didascalia.
- Slug valido e univoco.
- Anteprima confermata.
⚙️ Extra consigliati: validazione JSON-LD automatica in fase di salvataggio · log delle modifiche (correzioni tracciate) · programmazione/pianificazione uscita.
🎯 Regola di design: se per ottenere un requisito tecnico serve che il giornalista “si ricordi” di qualcosa, quel requisito va spostato dentro un'automazione o un controllo bloccante. L'Area Riservata è considerata pronta quando un redattore senza competenze tecniche, compilando solo i campi del form, produce un articolo già conforme a Google News.
