LA RISPOSTA DI PAGINA

Route, SEO e localizzazione

L'oggetto route raccoglie tutto cio che identifica la pagina come indirizzo: gli URL nelle loro varie forme, i titoli editoriali, i metadati per i motori di ricerca e per la condivisione, il percorso di navigazione e le versioni della stessa pagina nelle altre lingue del sito.

Gli indirizzi della pagina

La route espone lo stesso indirizzo in tre forme, perche un software di rendering ne usa una diversa a seconda del contesto: il percorso relativo per i collegamenti interni, l'URL assoluto per i metadati e i dati strutturati, l'origine per costruire altri indirizzi assoluti.

Proprieta	Esempio	Descrizione
`id`	`9db778e7-...`	Identificativo della route, distinto da quello del contenuto.
`url`	`https://www.gajacms.com/azienda`	URL pubblico assoluto della pagina, comprensivo di schema e dominio.
`path`	`/azienda`	Percorso relativo canonico. E il valore da confrontare con l'URL richiesto e da usare nei collegamenti interni.
`origin`	`https://www.gajacms.com`	Schema e dominio del sito, senza percorso.
`locale`	`it`	Lingua della route. Determina anche la lingua delle regioni comuni restituite.
`canonicalUrl`	`assente`	URL canonico dichiarato nel pannello. Se assente, il canonico e url.
`redirect`	`assente`	Presente soltanto nelle risposte di reindirizzamento, dove e l'unica proprieta valorizzata della pagina.

Titoli editoriali della route

Questi campi sono i testi che la pagina mostra in testata, distinti dai metadati per i motori di ricerca. Ogni testo formattato e disponibile in due forme: la stringa HTML e il documento strutturato con il suffisso Raw.

Proprieta	Descrizione
`title`	Titolo principale della pagina, il candidato naturale come H1 del documento.
`titleRaw`	Stesso titolo come elenco di nodi di testo formattato.
`eyebrow`	Sopracciglio, testo breve mostrato sopra il titolo.
`subtitle` e `subtitleRaw`	Sottotitolo mostrato sotto il titolo principale.
`summary` e `summaryRaw`	Introduzione editoriale mostrata prima dei componenti. Non ha finalita SEO.
`navigationLabel`	Etichetta breve usata nei menu e nelle briciole di pane, quando differisce dal titolo.

Una stringa vuota e un valore legittimo: significa che il campo esiste nel pannello ma non e stato compilato. Il client la tratta come assente e non riserva spazio nel layout.

Metadati per i motori di ricerca

L'oggetto route.seo e sempre presente e contiene i valori con cui il client costruisce la testa del documento.

Proprieta	Uso previsto
`title`	Titolo del documento, distinto dal titolo editoriale. Se assente si ricade su route.title.
`description`	Meta tag description.
`keywords`	Parole chiave dichiarate nel pannello. Spesso assente.
`noIndex` e `noFollow`	Direttive per i robot. Quando almeno uno e true, il client emette il meta tag robots corrispondente.
`openGraphImage`	Immagine per la condivisione sui social, con url, width, height e alt.

L'immagine social e un oggetto ridotto rispetto agli altri contenuti multimediali: espone soltanto le quattro proprieta indicate ed e gia risolta all'indirizzo assoluto della libreria del sito.

Oggetto route

{
  "id": "9db778e7-c264-470b-aab2-1a1a486be54c",
  "url": "https://www.gajacms.com/azienda",
  "path": "/azienda",
  "origin": "https://www.gajacms.com",
  "locale": "it",
  "title": "Azienda",
  "titleRaw": [ { "text": "Azienda", "type": "text" } ],
  "subtitle": "",
  "summary": "",
  "navigationLabel": "Azienda",
  "seo": {
    "title": "Azienda",
    "description": "Software house specializzata in cms, crm, microservizi, web e custom applications, ai, scraping, app native, e-commerce e booking solutions, tickets solutions, frontend, ui",
    "noIndex": false,
    "noFollow": false,
    "openGraphImage": {
      "url": "https://static.gajacms.com/gajacms/images/38440_35_00_page-0001.webp",
      "width": 1240,
      "height": 1755,
      "alt": "CERTIFICAZIONI"
    }
  },
  "home": {
    "url": "/",
    "title": "Gaja Cms",
    "navigationLabel": "Home Page"
  },
  "breadcrumbs": [
    { "title": "Home Page", "url": "/" },
    { "title": "Azienda", "url": "/azienda" }
  ],
  "localizedRoutes": [
    {
      "id": "b983ef8d-aeeb-48eb-a794-688e11a272f6",
      "url": "https://www.gajacms.com/company",
      "path": "/company",
      "origin": "https://www.gajacms.com",
      "locale": "en",
      "title": "Company",
      "navigationLabel": "Company",
      "seo": { "title": "Company", "noIndex": false, "noFollow": false },
      "breadcrumbs": [],
      "localizedRoutes": []
    }
  ]
}

L'oggetto home descrive la home page della lingua corrente con url, title e navigationLabel. Serve a costruire il collegamento del logo di testata senza costruire l'indirizzo a mano.

L'elenco breadcrumbs contiene il percorso di navigazione gia ordinato, dalla radice alla pagina corrente. Ogni voce ha title e url, con percorso relativo. L'ultima voce e la pagina stessa: il client la rende come testo non cliccabile e la usa anche per i dati strutturati BreadcrumbList.

L'elenco può essere vuoto sulla home page o su pagine escluse dalla gerarchia di navigazione.

Versioni nelle altre lingue

L'elenco localizedRoutes contiene la stessa pagina nelle altre lingue del sito, una voce per lingua. Ogni voce ha la forma di una route, ma in versione ridotta: sono valorizzati identificativo, indirizzi, lingua, titolo, etichetta di navigazione e un oggetto seo limitato a titolo e direttive per i robot.

Le proprieta breadcrumbs e localizedRoutes di una route localizzata sono sempre array vuoti. La struttura non e ricorsiva: per ottenere i dati completi di quella pagina occorre una nuova chiamata di risoluzione con il suo percorso.

L'elenco e la sorgente naturale dei collegamenti alternati per lingua nella testa del documento e del selettore di lingua nell'interfaccia. Se il sito e monolingue, l'elenco e vuoto.

Route, SEO e localizzazione

Gli indirizzi della pagina

Titoli editoriali della route

Metadati per i motori di ricerca

Home e breadcrumb

Versioni nelle altre lingue