Controlli SEO dei contenuti salvati
Usa Siti → sito → SEO per esaminare le pagine salvate nelle lingue abilitate del sito, confrontare i metadati e controllare i collegamenti interni. Da CMS 1.116.0, Avvia nuovo controllo invia richieste brevi consecutive nella schermata. Tieni aperta la scheda fino al termine dell’esecuzione. Cron non è necessario. Riaprire l’area di lavoro e scegliere Aggiorna risultati legge soltanto i progressi salvati. Usa Esegui in questa schermata per proseguire il lavoro interrotto. I risultati servono da guida. Non pubblicano, reindirizzano, eliminano o riscrivono mai contenuti e non ne bloccano la pubblicazione.
Per una sola pagina usa Pagine → pagina → Gestione della pagina → Controllo SEO. Il controllo mostra titolo e descrizione generati, la provenienza dalla traduzione o dal valore di ripiego del sito e un numero limitato di esempi. Se la fonte è nota, i collegamenti di modifica aprono il relativo campo di traduzione, l’editor di blocchi o le impostazioni dell’head del sito. I collegamenti ai blocchi mantengono la lingua dei contenuti selezionata. Salva nell’editor normale ed esegui di nuovo il controllo. Un avviso di modifica della fonte indica che occorre ricontrollare i vecchi risultati. Se la verifica di aggiornamento non è disponibile, non puoi concludere che i risultati siano attuali.
Avviare o riprendere un controllo manuale apre la finestra nativa di avanzamento. Tieni aperta la scheda. Sospendi ed esci, il tasto Esc e il comando di chiusura attendono la fine del passaggio corrente e verificano il salvataggio della sospensione. Se la conferma non è disponibile, usa Visualizza risultati prima di ripartire. Gli effetti già completati restano salvati. I risultati finali rimangono visibili fino alla chiusura della finestra o alla consultazione dei risultati. Il tempo trascorso riguarda solo la sessione su questa schermata.
Elaborazione e ambito
I controlli manuali avanzano continuamente con richieste autorizzate del pannello, senza aspettare un trigger ogni minuto. Uscire dalla schermata arresta i passaggi successivi e conserva i progressi già registrati. Per proseguire in modo indipendente, abilita l’attività SEO in Manutenzione → Attività e automazione e segui le istruzioni facoltative di configurazione dell’hosting. L’account di hosting deve disporre di cron con PHP CLI, di uno scheduler gestito o del trigger HTTP autenticato supportato per il lavoro compatibile con il web. La funzionalità non richiede un worker della coda sempre in esecuzione. Il comando CLI esistente fa inoltre avanzare il lavoro quando lo richiami esplicitamente:
php artisan webblocks:seo:work
Il totale dell’avanzamento include ogni coppia pagina nativa/lingua e un controllo separato delle definizioni di navigazione per ciascuna lingua. Il totale è provvisorio durante la preparazione dell’inventario. Pausa e Riprendi preservano i progressi. Riprova controlli incompleti ricontrolla le evidenze non disponibili o parziali. Il lavoro interrotto è recuperabile tramite i lease dei worker soggetti a scadenza. Una modifica alla fonte richiede un nuovo controllo. È ammessa una sola esecuzione attiva per sito. Il worker in background conserva dieci esecuzioni recenti eliminando le evidenze meno recenti. L’avvio di un’esecuzione non attende mai l’eliminazione in cascata della cronologia. Le righe precedenti possono rimanere finché il worker non avanza.
L’anteprima salvata include i blocchi in bozza appartenenti alla pagina e il contenuto pubblicato degli slot condivisi. Nel controllo possono comparire pagine in bozza, in revisione, pubblicate o archiviate. Le pagine sorgente degli slot condivisi e le revisioni candidate al ripristino non costituiscono destinazioni autonome. Le traduzioni di pagina mancanti sono segnalate come suggerimenti editoriali. L’assenza di una riga di traduzione di un blocco e l’uso della descrizione di ripiego del sito sono suggerimenti distinti. Non dimostrano la fedeltà completa della traduzione campo per campo.
Il controllo registra gli orari delle verifiche, la versione del CMS, la versione della fonte e l’ambito dichiarato. Un’esecuzione parziale, non riuscita, in coda o non più aggiornata non rappresenta un risultato completo. Le modifiche dei contenuti tramite Laravel invalidano la generazione registrata. Il meccanismo è prudente: anche una modifica a un altro sito può rendere non più attuale l’esecuzione. Dati di fornitori esterni che cambiano indipendentemente, modifiche dirette al database al di fuori di Laravel e modifiche non versionate all’ambiente di esecuzione richiedono un nuovo controllo esplicito.
Esaminare i risultati
Usa le schede Risultati, Pagine e lingue e Collegamenti interni. Puoi filtrare per ID della pagina di origine, lingua, stato di pubblicazione, categoria e codice del risultato ed esito del collegamento. L’ID pagina 0 seleziona le unità di lavoro delle definizioni di navigazione. Usa il filtro della cronologia per selezionare un’esecuzione precedente.
I risultati tecnici e i suggerimenti editoriali sono distinti dalle evidenze non verificate. Le pagine nella stessa lingua con titoli o descrizioni generati e normalizzati coincidenti sono da esaminare, anche se hanno stati di pubblicazione differenti. Prima di modificare i contenuti valuta se la duplicazione è intenzionale. Una descrizione condivisa del sito produce spesso descrizioni duplicate. Una traduzione specifica per la pagina può essere più utile.
Le evidenze sui collegamenti identificano la pagina e la lingua di origine, il blocco o la voce di navigazione se disponibili, il testo del collegamento, la posizione nell’output generato, la destinazione nativa e un URL attuale suggerito quando è possibile determinarlo. Apri la posizione di modifica per esaminare la fonte effettiva. L’analisi rispetta i domini del sito configurati, i prefissi delle lingue e i montaggi pubblici in sottodirectory.
I risultati distinguono le destinazioni native mancanti, quelle non pubblicate o ad accesso limitato, le differenze di lingua e gli indirizzi nativi obsoleti o non canonici. Una differenza di lingua può essere intenzionale. Una destinazione nativa mancante non dimostra un errore HTTP 404 sul sito attivo: l’indirizzo potrebbe essere gestito da una route del plugin o da un reindirizzamento. La cronologia di Redirect Manager non viene esaminata. I prefissi delle pagine di dettaglio e i modelli delle Pagine automatiche richiedono un’ispezione che tenga conto dei record e sono indicati come esterni a questi controlli nativi. Una riga nativa conservata non può prevalere su un prefisso automatico attivo.
Le definizioni di navigazione sono elencate separatamente dai collegamenti effettivamente generati su una pagina. Una definizione non dimostra che il relativo menu sia inserito nella pagina. Il suggerimento nessun collegamento in entrata indica che non è stato trovato alcun collegamento da un’altra fonte nativa pubblicata ed esaminata per quella coppia pagina/lingua. I collegamenti alla pagina stessa, le fonti in bozza, i rami di blocchi in bozza, le pagine di origine ad accesso limitato e le definizioni di navigazione non inserite non contano. L’analisi può omettere fonti effettive. Controllane l’ambito prima di aggiungere collegamenti o modificare contenuti.
L’ispezione HTML è limitata a 2 MiB e 20.000 elementi. Ogni pagina registra fino a 2.000 collegamenti generati e ogni lingua fino a 2.000 definizioni di navigazione visibili. Il troncamento viene segnalato esplicitamente e produce evidenze parziali. Le evidenze sui collegamenti omettono stringhe di query, frammenti e credenziali negli URL. Non vengono controllati destinazioni esterne, stato HTTP del sito attivo, catene di reindirizzamento, robots.txt, inclusione nella sitemap, script, contenuti di iframe, indicizzazione e rendimento su Google. I risultati non sono un punteggio di posizionamento né una garanzia di aumento del traffico.
Internal Content API
Tutti gli endpoint dei controlli richiedono content.read. L’accesso tramite sessione o token personale richiede anche cms.pages.read, cms.navigation.read e cms.shared-slots.read per il sito. Le capacità del token e l’elenco dei siti consentiti continuano a definire i limiti massimi. Il controllo richiesto deve appartenere al sito indicato nell’URL.
| Operazione | Endpoint | Comportamento |
|---|---|---|
| Leggere i risultati | GET /webadmin/api/sites/{site}/seo-audits | Lettura passiva dell’ultima esecuzione, della cronologia e delle evidenze paginate |
| Richiedere un’esecuzione | POST /webadmin/api/sites/{site}/seo-audits | Restituisce 202 con l’esecuzione accodata o con quella già attiva, senza eseguire l’ispezione nella richiesta |
| Pausa / resume / retry | POST /webadmin/api/sites/{site}/seo-audits/{seoAudit}/{action} | action vale pause, resume o retry. Le transizioni non valide restituiscono 409 |
| Verificare se il rapporto della pagina è aggiornato | GET /webadmin/api/pages/{page}/seo-check/freshness?locale=en&source_version=... | Applica le regole di accesso del controllo della singola pagina e restituisce stale senza generare il rendering |
I filtri dei risultati sono audit, locale, page_id, status, category, code e link_state. per_page accetta valori da 1 a 100 e vale 25 per impostazione predefinita. pages_page, findings_page e links_page paginano separatamente le tre raccolte di evidenze. Le risposte sono private, non vengono memorizzate in cache e non sono indicizzabili. audit.complete vale true solo per un’esecuzione terminata e aggiornata entro l’ambito dichiarato. publication_blocked resta false. Le righe dei collegamenti espongono is_public_source affinché chi usa i dati possa distinguere le evidenze basate sul solo contenuto salvato dalle fonti pubblicate dei collegamenti in entrata.
Consulta API dei contenuti interni per le normali modifiche a pagine, traduzioni e blocchi e Campi SEO, immagine social e favicon per la redazione dei metadati.