Blog — riferimento tecnico

Questa pagina descrive la marcatura, l’archiviazione dei dati, le superfici di amministrazione e le interfacce del pacchetto. Per un’introduzione vedi Panoramica, per il primo articolo l’Avvio rapido.

Una pagina diventa un articolo portando un blocco <wk:blog>. Il blocco non produce alcuna resa; descrive la pagina su cui si trova e viaggia con essa quando la pagina viene copiata.

Due valori sono elementi figli invece che attributi perché superano regolarmente più righe: <excerpt> per l’anteprima e le due descrizioni per i motori di ricerca e i social network.

La marcatura richiede un tag di chiusura; le impostazioni stanno al suo interno, una per riga. Una forma su una sola riga non viene riconosciuta e resta testo sulla pagina.

<blog list>
blog wk
limit 10
tpl wk
</blog>

Un set di modelli decide l’aspetto di un elenco. Sono forniti default, wk, wkbizway e wkbizwayteaser. L’impostazione tpl nell’elenco sceglie il set; in sua assenza vale default.

Un articolo con status=“scheduled” e un momento publish nel futuro resta invisibile finché quel momento non è raggiunto. Il passaggio è compiuto dall’attività di manutenzione del wiki: scrive lo stato nel blocco della pagina e produce così una revisione ordinaria. Non esiste un servizio di pianificazione né un processo permanente — senza traffico sul wiki nemmeno la programmazione avanza.

I blog si distinguono unicamente per il nome nell’impostazione blog. Un secondo blog nasce perché gli articoli portano un nome diverso e un elenco chiede quel nome. Non esiste un’amministrazione dei blog, né creazione né cancellazione; un blog esiste esattamente finché una pagina lo nomina.

La pagina è la verità, il database è un indice da essa derivato. Si trova nel file data/meta/wkblog.sqlite3 e contiene le tabelle entries, comments, tags, subscriptions, optin e opts.

Una reindicizzazione ricostruisce la proiezione dalle pagine. Viene ripristinato tutto ciò che sta nel blocco: titolo, stato, programmazione, blog, etichette, anteprima. Resta intatto tutto ciò che non ha un corrispettivo su una pagina: commenti, iscrizioni, registrazioni di conferma e stato di distribuzione. Sono fatti relativi a eventi esterni al wiki; una reindicizzazione non può né dedurli né distruggerli.

Copiare una pagina in un altro wiki è un caso diverso: là viaggia solo la pagina, quindi solo il blocco. Commenti, iscrizioni e stato di distribuzione restano indietro.

Sei colonne annullabili su entries registrano che e quando un articolo è stato condiviso su un social network. La redazione lo inserisce a mano; non esiste alcuna pubblicazione automatica verso una rete. Deliberatamente non parte del blocco: lo stato di distribuzione non è un’affermazione autoriale della pagina, ma una constatazione su qualcosa accaduto fuori dal wiki.

Otto routine filtrano gli elenchi pubblici in base al livello di accesso della pagina. Se quel filtro viene meno — per esempio perché dopo uno spostamento le funzioni del database non sono registrate — non c’è alcun messaggio di errore. Compaiono troppi articoli.

È la forma più sgradevole di guasto: in esercizio non si distingue dalla correttezza. Una verifica che attende un’eccezione attende invano.

Un’installazione dovrebbe perciò mantenere in modo permanente:

• almeno un articolo pubblicato che non sia leggibile in forma anonima,
• il numero atteso di articoli visibili anonimamente, fissato in anticipo.

Si verifica l’elenco pubblico, non quello di amministrazione: quest’ultimo sta comunque dietro un controllo dei permessi, e il guasto si manifesta solo dove conta un visitatore anonimo. Il blocco stesso appartiene al controllo degli accessi del wiki e non viene mai consegnato con il pacchetto.

Tutto l’accesso al database passa per routine denominate con parametri associati. Ogni routine è una coppia formata da un file .sql e da un manifesto; il nome della tabella vi compare in chiaro, non nel codice PHP. Chi vuole cambiare una query cambia il file della routine. Vedi SQLite Data Studio.

• enabled — i commenti sono possibili
• closed — i commenti esistenti restano visibili, i nuovi non sono possibili
• disabled — su questa pagina non ci sono commenti

Con la revisione attiva, un nuovo commento compare dapprima nascosto e diventa visibile solo dopo l’approvazione. La schermata di amministrazione elenca i commenti in attesa e ne mostra il numero come contrassegno nel workbench.

Per impostazione predefinita non vengono recuperati avatar da server esterni. Se si attiva un servizio esterno, per ogni commento visualizzato una richiesta con la somma di controllo dell’indirizzo lascia la casa. È una decisione consapevole, non una preimpostazione.

La schermata si trova in ?do=admin&page=wkblog.

Sei indicatori: pubblicati, bozze, in attesa di revisione, programmati, commenti da revisionare e stato della cura SEO. Ogni numero conduce all’elenco filtrato corrispondente.

Oltre a titolo e blog, l’elenco filtra per stato di pubblicazione. Il filtro si mantiene durante la paginazione.

Stato, blog e stato dei commenti stanno nel blocco della pagina. Un’azione di gruppo su di essi scrive perciò la pagina attraverso il normale percorso di salvataggio: verifica i permessi, rispetta il blocco di modifica e produce una revisione reale. Solo dopo l’indice viene aggiornato. Quando un articolo viene saltato, il messaggio indica il motivo separatamente — in modifica, non consentito, la pagina non esiste più — perché solo il motivo dice che cosa fare.

Il contrassegno «in evidenza» è escluso: è uno stato operativo del database e coerentemente non produce alcuna revisione.

Il pacchetto non disegna un workbench proprio. Consegna le sue parti a quello già presente: la navigazione come vista nella barra laterale primaria, l’arretrato di moderazione e la posizione corrente come dati della barra di stato, un contrassegno con il numero dei commenti in attesa e due comandi. Vedi wkfluentui.

Le impostazioni si trovano nel gestore della configurazione del wiki sotto il nome del pacchetto. Regolano lo stato predefinito dei nuovi commenti, il blog predefinito, le etichette predefinite, l’obbligo di revisione dei commenti, l’impostazione della data nel modulo di modifica e l’accettazione dei linkback. Un valore non valido non viene assunto; vale allora quello predefinito.

Il pacchetto offre una superficie per la chiamata remota del wiki. Crea articoli, li legge, ne cambia lo stato e cura le etichette. Ogni chiamata attraversa la stessa verifica dei permessi dell’interfaccia utente e produce in scrittura la stessa revisione; non esiste una via che aggiri la pagina.

• Una pagina senza blocco non è un articolo, anche se nel database esiste una riga.
• Una pagina cancellata perde la sua riga al successivo accesso alla voce.
• Un tipo sconosciuto in un elenco ricade su list e lo segnala.
• Se il database manca, le superfici si disattivano invece di far fallire la pagina.

Il pacchetto è un fork di BlogTNG. Il fork è stato meccanico, lo sviluppo successivo no: il blocco portabile di metadati, il secondo formato di testo, la schermata di amministrazione, la programmazione e la superficie per la chiamata remota sono aggiunte della casa. Il vecchio indirizzo del feed resta raggiungibile per compatibilità.