Guida alla pubblicazione CMS per penne di lettura: configurazione di Botble e agon-theme-v2 per SEO

Pubblico: Team web, specialisti SEO e responsabili dei contenuti che pubblicano su SmartReadingPen.com (o su qualsiasi stack Botble + agon-theme-v2). Questa guida copre la configurazione del CMS, la configurazione SEO, il template dei post del blog, il markup schema, la generazione della sitemap e un calendario editoriale di 30 giorni per il programma SEO B2B da 1.000 articoli.

Gestiamo SmartReadingPen.com su Botble CMS con il template agon-theme-v2: uno stack che gestisce bene contenuti multilingua, post del blog, pagine prodotto e dati strutturati, ma solo se configurato correttamente. La configurazione predefinita è funzionale ma lascia sul tavolo circa il 40% delle opportunità SEO. Questa guida è la configurazione che usiamo per pubblicare 1.000 articoli ottimizzati per la SEO senza compromettere i Core Web Vitals o l'internazionalizzazione.

Copre le impostazioni di Botble, le personalizzazioni di agon-theme-v2, il template per post (frontmatter + struttura del corpo), il markup schema (FAQ, Product, Organization), la configurazione di sitemap e robots e una cadenza editoriale di 30 giorni che si adatta alla capacità di un piccolo team di contenuti. Include un diagramma di flusso editoriale, una tabella dei target dei Core Web Vitals, un grafico dei link interni e le 5 domande FAQ che inseriamo in ogni avvio di progetto editoriale. Tutti i link sono interni.

1. Perché la configurazione del CMS è importante per la SEO B2B

Un programma SEO B2B da 1.000 articoli non significa solo scrivere 1.000 articoli. Significa configurare il CMS in modo che ogni articolo venga pubblicato con i metadati corretti, i dati strutturati corretti, i link interni corretti, i tag canonical corretti e i Core Web Vitals corretti. Un CMS mal configurato pubblicherà 1.000 articoli che competono tra loro, cannibalizzano le keyword e si caricano lentamente, vanificando l'intero investimento editoriale.

Di seguito cosa abbiamo misurato quando abbiamo riconfigurato il nostro CMS nel Q1 2026 rispetto alla configurazione predefinita.

L'ottimizzazione ha richiesto 3 settimane di lavoro del team web e ora ripaga ogni trimestre in volume di lead. Di seguito la configurazione che abbiamo rilasciato.

2. Impostazioni di base di Botble CMS

I quattro blocchi di configurazione sono Generale, SEO, Blog, Performance. Di seguito la configurazione che rilasciamo.

3. Personalizzazioni di agon-theme-v2

Il template agon-theme-v2 è responsive e SEO-friendly pronto all'uso, ma sono necessarie cinque personalizzazioni per portarlo al nostro standard.

3.1 Navigazione dell'Header

Home
Prodotti  →  B1 / B2 / F8 / K7 / KF1 / L5 / P2 / Q6 / Q8 / T2 / Y6
Guida all'Acquisto
Tecnico
Applicazione
Settore
Chi Siamo
Contatti

3.2 Template Articolo del Blog

Il template dell'articolo del blog di agon-theme-v2 necessita di una piccola modifica per supportare il frontmatter che utilizziamo. Il file template è platform/themes/agon-theme-v2/templates/blog.blade.php. I campi richiesti sono:

- title
- slug
- category (deve corrispondere a una delle 5 categorie)
- primary_keyword
- secondary_keywords (array)
- meta_title (≤ 60 caratteri)
- meta_description (≤ 160 caratteri)
- word_count_target (predefinito 3000)
- publish_date
- author
- reading_time
- featured_image (percorso sotto /images/)

3.3 Markup Schema

Iniettiamo tre tipi di schema tramite il partial head del tema:

3.4 Suggerimento Automatico Link Interni

Abilitiamo il modulo "Articoli correlati" in fondo a ogni articolo del blog. Il modulo utilizza una semplice corrispondenza categoria-tag per suggerire 4 link interni. Iniettiamo anche un blocco contestuale "Guide correlate" nella barra laterale destra su desktop e alla fine dell'articolo su mobile.

3.5 Pipeline di Ottimizzazione Immagini

Ogni immagine caricata passa attraverso una pipeline di ottimizzazione:

1. Ridimensiona a larghezza massima 1.600 px (preserva la qualità retina senza appesantire)
2. Converti in WebP con fallback JPEG
3. Lazy-load di tutte le immagini tranne l'immagine in evidenza
4. Genera srcset per 1x, 1.5x, 2x, 3x
5. Aggiungi width e height espliciti per prevenire il CLS

4. Il Template dell'Articolo del Blog (Frontmatter + Body)

Ogni articolo su SmartReadingPen.com segue un unico template. La coerenza è da sola il più grande fattore predittivo delle performance SEO su larga scala.

---
title: "..."          # 50–60 caratteri, parola chiave principale vicino all'inizio
slug: BG-XXX-...      # categoria + argomento
category: BUYING-GUIDE
primary_keyword: "..."  # 2–4 parole
secondary_keywords:
  - ...
  - ...
meta_title: "..."      # ≤ 60 caratteri
meta_description: "..." # ≤ 160 caratteri
word_count_target: 3000
publish_date: YYYY-MM-DD
author: "..."
reading_time: "12 min"
featured_image: /images/... # ≥ 1200×630 px
---

![Featured image alt text](/images/...)

# Titolo (H1, corrisponde a meta_title)

> Blockquote del pubblico in corsivo — 2 frasi, indica il pubblico.

[Opening paragraph, 80–120 words, hooks the reader.]

## 1. Prima Sezione H2
...

## 2. Seconda Sezione H2
...

[... 6–8 sezioni H2 totali ...]

## FAQ (5 domande con JSON-LD)


## Letture Correlate
- [Internal link 1]
- [Internal link 2]
- [Internal link 3]
- [Internal link 4]

[CTA paragraph at end]

5. Strategia dei Link Interni

I link interni sono ciò che trasforma 1.000 articoli da una palude in un fossato difensivo. La strategia qui sotto è quella che distribuiamo.

Il grafico dei link viene costruito e verificato da un crawler settimanale. Qualsiasi articolo con meno di 6 link interni viene segnalato per la revisione.

6. Obiettivi Core Web Vitals

Manteniamo il sito ai seguenti obiettivi. Qualsiasi valore inferiore a "Buono" attiva un avviso automatico sulla velocità della pagina.

Lo stack agon-theme-v2 mantiene l'LCP a 1,6 s su mobile e 1,1 s su desktop con la pipeline di ottimizzazione sopra indicata. Il CLS è costantemente 0,00 perché impostiamo dimensioni esplicite su ogni immagine e incorporamento.

7. Configurazione di Sitemap e Robots

Elementi essenziali di Robots.txt:

User-agent: *
Allow: /
Disallow: /admin/
Disallow: /search
Disallow: /cart
Disallow: /checkout
Sitemap: https://smartreadingpen.com/sitemap.xml

Elementi essenziali di llms.txt:

User-agent: GPTBot
Allow: /

User-agent: Claude-Web
Allow: /

User-agent: PerplexityBot
Allow: /

User-agent: CCBot
Allow: /

Consentiamo esplicitamente i crawler LLM perché il flusso di lavoro di ricerca B2B passa sempre più attraverso risposte mediate da LLM. Bloccarli ci escluderebbe da una quota crescente di ricerche di acquirenti qualificati.

8. Il calendario editoriale di 30 giorni

Il calendario seguente prevede 60 articoli al mese con un team di contenuti composto da 2 persone (1 autore, 1 editor). Per il nostro programma da 1.000 articoli, seguiamo la stessa cadenza 17 volte.

Ogni lotto segue lo stesso flusso:

Il gate di QA è un controllo a 12 punti (vedi Reading Pen CMS QA nelle FAQ). Qualsiasi contenuto che non supera il QA torna in modifica prima della pubblicazione.

9. Checklist QA del CMS (per articolo)

[ ] 1. Titolo ≤ 60 caratteri e contiene la parola chiave principale
[ ] 2. Meta description 120–160 caratteri, contiene la parola chiave principale
[ ] 3. Lo slug rispetta la convenzione BG-XXX / PR-XXX / TC-XXX / AP-XXX / IN-XXX
[ ] 4. Immagine in evidenza ≥ 1200×630 px, testo alt impostato, pronto per il lazy-load
[ ] 5. Numero di parole tra 2,800 e 3,500 (target 3,000)
[ ] 6. 6–8 sezioni H2, ciascuna con parola chiave principale o secondaria nel titolo
[ ] 7. ≥ 3 tabelle dati, ≥ 2 grafici SVG, ≥ 8 punti dati numerici
[ ] 8. ≥ 6 link interni, 0 link esterni
[ ] 9. ≥ 2 posizionamenti CTA (1 inline + 1 nel footer)
[ ] 10. Sezione FAQ con 5 domande e script JSON-LD
[ ] 11. Sezione Articoli correlati con 4 link interni
[ ] 12. Tempo di lettura calcolato correttamente

La checklist QA viene applicata da un hook pre-publish in Botble. Gli articoli che non superano un controllo vengono reinoltrati all'editor con un rapporto della checklist.

10. Mappa dei link interni per la documentazione del CMS

Quando pubblichi questa guida, collegala al resto dei tuoi contenuti B2B:

• Reading Pen Localization
• Reading Pen Brand Building
• Reading Pen Marketing for Schools
• Reading Pen Subscription Box Model
• Reading Pen Data Privacy Compliance

11. Le 5 domande frequenti sul CMS

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Qual è la configurazione del CMS Botble consigliata per un sito B2B di penne per la lettura?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "La configurazione consigliata copre quattro aree: Generale (titolo del sito, descrizione, immagine OG predefinita, email amministratore), SEO (separatore con trattino lungo, canonico auto-referenziante, schema predefiniti), Blog (autore predefinito, 5 categorie, immagine in evidenza obbligatoria) e Prestazioni (cache TTL 1 ora, lazy-load delle immagini, minimizzazione di HTML/CSS/JS, CDN). Il template agon-theme-v2 offre impostazioni predefinite ragionevoli, ma trae beneficio da cinque personalizzazioni: navigazione dell'intestazione, campi del modello degli articoli del blog, iniezione dello schema, suggerimento automatico dei link interni e ottimizzazione delle immagini."
      }
    },
    {
      "@type": "Question",
      "name": "Come evitare la cannibalizzazione delle parole chiave su 1,000 articoli?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Mantieni una sola parola chiave principale per articolo, imponi slug unici (convenzioni BG-XXX, PR-XXX, TC-XXX, AP-XXX, IN-XXX) ed esegui un crawler settimanale per individuare eventuali coppie di articoli che puntano alla stessa parola chiave principale. Usa le parole chiave secondarie per differenziare; un programma da 1,000 articoli dovrebbe puntare ad almeno 800 parole chiave principali distinte."
      }
    },
    {
      "@type": "Question",
      "name": "È opportuno consentire ai crawler LLM come GPTBot di indicizzare i miei contenuti?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Sì. La ricerca degli acquirenti B2B passa sempre più spesso attraverso risposte fornite da LLM. Bloccare i crawler LLM ti esclude da una quota crescente di ricerche qualificate. Consentiamo esplicitamente GPTBot, Claude-Web, PerplexityBot e CCBot in /llms.txt. Si tratta di una strategia di visibilità del marchio a lungo termine: più i tuoi contenuti compaiono nelle risposte degli LLM, più lead in entrata ricevi dagli acquirenti che usano questi strumenti."
      }
    },
    {
      "@type": "Question",
      "name": "Come mantenere i Core Web Vitals nella fascia 'Buono' pubblicando 1,000 articoli?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Tre regole: (1) ogni immagine deve avere attributi width e height espliciti per evitare il CLS, (2) ogni articolo deve caricare in lazy-load tutte le immagini tranne l'immagine in evidenza, (3) ogni elemento incorporato (SVG, grafico) deve dichiarare subito le proprie dimensioni. Grazie a queste regole e alla nostra configurazione CDN e cache, manteniamo l'LCP a 1.6 s su mobile e 1.1 s su desktop sull'intero corpus di 1,000 articoli."
      }
    },
    {
      "@type": "Question",
      "name": "Quanti link interni dovrebbe contenere ciascun articolo?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Almeno 6 link interni per articolo, e ogni articolo dovrebbe essere collegato da almeno 3 altri articoli. Il modello hub-and-spoke funziona meglio: ogni categoria ha una pagina hub che collega ogni articolo della categoria, e ogni articolo collega il proprio hub più 5 articoli correlati per argomento. Un crawler settimanale segnala gli articoli che scendono sotto la soglia dei 6 link."
      }
    }
  ]
}

12. Letture correlate sul blog Smart Reading Pen

• Reading Pen Localization
• Reading Pen Brand Building
• Reading Pen Marketing for Schools
• Reading Pen Subscription Box Model
• Reading Pen Data Privacy Compliance