Pulsar — Documentazione
Tutto quello che il tema fa, nell'ordine in cui ti servirà: installarlo, configurarlo schermata per
schermata, poi consultarlo. Ogni sezione dice a cosa serve un'impostazione prima di dire dove
si clicca.
Che cos'è Pulsar
Un tema WordPress multiuso, costruito attorno alla pubblicazione.
Pulsar ti dà una homepage che componi a blocchi, cinque layout per l'hero, cinque stili di card, tredici
widget, un pannello di impostazioni con anteprime dal vivo e una serie di shortcode per i tuoi articoli.
Non richiede nessun page builder e nessun framework di terze parti.
È nato come tema per notizie e riviste, e non si ferma lì. I stile configurano
tutto in un clic — rivista di notizie, sito di auto e moto, e altri in arrivo — e ognuno è solo un punto
di partenza: palette, tipografia, hero,
blocchi e testi restano modificabili. Un sito che non è nessuno di questi parte dal stile più vicino e
cambia quello che gli serve, che di solito è meno di quanto ci si aspetti.
Cosa decide se un tema è adatto al tuo argomento
Non la demo con cui è stato fotografato, ma quello che puoi cambiare: i colori, il font, l'ordine della
homepage, cosa mostra una card, cosa porta la pagina dell'articolo. Tutto questo sta nel pannello, quindi
lo stesso tema può essere un sito di ricette, una rivista di automobilismo, il blog di un'azienda o una
raccolta di recensioni senza una riga di codice.
Due cose da sapere prima di iniziare
- Appena installato, non viene chiesto niente a nessun altro. I font sono inclusi nel
tema e non ci sono script da CDN. L'unica funzione che può leggere da un server esterno è l'endpoint
pubblico di Apple per le app, e un'installazione nuova continua a non fare nessuna richiesta verso
l'esterno: il banner dell'app è acceso, così il blocco si vede da subito, ma l'interruttore che legge
da Apple — Leggi i dati dell'app automaticamente — arriva spento, e lo
shortcode
[app] ad Apple non chiede niente finché qualcuno non apre un articolo che lo
usa.
- Tutto quello che imposti vive nel tuo database. Aggiornare il tema non sovrascrive
mai le tue impostazioni, i tuoi articoli o i tuoi menu.
1 · Installazione
Dieci minuti, tre file. Falli in quest'ordine.
Nel pacchetto scaricato da ThemeForest trovi:
| File | Che cos'è |
pulsar.zip | Il tema. È il file che WordPress si aspetta. |
pulsar-child.zip | Il child theme. Facoltativo, ma leggi il passo 2. |
plugins/pulsar-core.zip | Il plugin Pulsar Core. Raccomandato: è quello che fa funzionare gli shortcode. |
documentation/ | Le pagine che stai leggendo. |
- Installa il tema.
In WordPress vai su Aspetto → Temi → Aggiungi nuovo → Carica tema, scegli
pulsar.zip e premi Installa ora. Non scompattarlo prima: WordPress vuole lo
zip.
- Installa il child theme e attiva quello.
Carica
pulsar-child.zip allo stesso modo e premi Attiva sul child, non su
Pulsar. Vanno installati entrambi; attivo è solo il child.
- Installa il plugin.
Plugin → Aggiungi nuovo → Carica plugin, scegli
pulsar-core.zip, installa e
attiva. Senza di lui gli shortcode non esistono.
- Apri il pannello.
Nel menu di WordPress a sinistra compare la voce Pulsar Theme. È lì che succede tutto quello
che trovi in questa documentazione.
Se il caricamento fallisce con «il file supera la dimensione massima…»
È il tuo hosting che limita la dimensione di un upload, non un problema del file. Puoi alzare
upload_max_filesize in PHP, oppure caricare la cartella del tema via FTP dentro
wp-content/themes/.
Che cosa cambia all'attivazione
Attivando Pulsar vengono preparate alcune cose, così il sito non è vuoto al primo caricamento:
- Vengono creati i menu Pulsar - Top bar, Pulsar - Header menu, Pulsar - Footer
links e Pulsar - Copyright links e assegnati alle loro posizioni, a meno che tu
non abbia già un menu in quella posizione: in quel caso il tuo non viene toccato.
- Vengono impostate le Impostazioni → Media alle misure con cui il tema disegna (miniatura 150
ritagliata, media 432×243, media_large disattivata, grande 1200).
Se lo installi su un sito con anni di articoli
Le immagini già caricate non hanno le misure che il tema chiede, quindi le card ripiegano su file più
grandi e le pagine pesano di più. Esegui una volta
Regenerate Thumbnails: la schermata
Prestazioni controlla la tua libreria e ti dice se ne vale la pena.
2 · Child theme
Usalo se hai intenzione di mettere mano al codice. Salta questa parte se non lo farai mai.
Un child theme è un piccolo tema che eredita tutto da Pulsar e ti permette di sovrascriverne singoli
pezzi. Il motivo per cui conta è semplice: quando Pulsar si aggiorna, ogni file al suo interno
viene sostituito. Quello che hai scritto nel tema padre sparisce. Quello che sta nel child
sopravvive.
Cosa va nel child
- Il tuo CSS, in
pulsar-child/style.css.
- I tuoi snippet PHP e i filtri, in
pulsar-child/functions.php.
- La copia di un template che vuoi modificare: copia il file da
pulsar/ dentro
pulsar-child/ mantenendo lo stesso percorso e modifica la copia. WordPress userà la
tua. Vale per i template in templates/, per ogni pezzo dentro partials/
— una card, un widget, una fascia della homepage — e per un template messo nella radice del child
invece che in templates/: il child viene guardato sempre per primo.
Per colori, font, dimensioni e layout il child non serve
Tutto questo si fa dal pannello, e il pannello scrive nel database, che gli aggiornamenti non toccano.
3 · Il plugin Pulsar Core
Gli shortcode stanno in un plugin di proposito, così restano tuoi.
Gli shortcode sono contenuto: stanno dentro i tuoi articoli. Se vivessero nel tema, cambiando tema un
giorno ti ritroveresti [product …] stampato come testo in ogni articolo che ne usava uno.
Essendo un plugin, continuano a funzionare con qualunque tema.
Le parole che leggono i tuoi visitatori
Gli shortcode stampano alcune etichette proprie — Leggi anche, Vedi l'offerta,
Scarica, il conteggio dei commenti. Puoi riscriverle tutte in
Impostazioni → Pulsar Core: per tradurle in una lingua non inclusa nel plugin, o
semplicemente per dire altro (Ti potrebbe interessare, Compralo ora). Lasciando un
campo vuoto resta il testo standard, già tradotto nelle lingue incluse.
Il pulsante del prodotto ha due di queste etichette, e il riquadro sceglie da solo:
Vedi Offerta quando lo shortcode indica sia il prezzo sia il prezzo pieno, e
Acquista quando c'è un prezzo solo, senza nulla con cui confrontarlo. Entrambe sono
modificabili, e un cta="…" scritto sullo shortcode ha la precedenza su tutte e due.
Quelle impostazioni stanno nel plugin e non nel pannello di Pulsar, ed è esattamente il punto: seguono
gli shortcode se un giorno cambi tema. I campi contrassegnati con %s devono mantenerlo — è
il posto dove finisce il numero o il nome del negozio, e un testo che l'ha perso viene rifiutato invece
che salvato a metà.
Il resto del testo del plugin — i nomi e le descrizioni degli shortcode che vedi mentre scrivi — si
traduce nel modo consueto, con i file in pulsar-core/languages/. Il plugin gratuito
Loco Translate lo fa dal browser senza toccare un file.
Il plugin è incluso nel pacchetto del tema e si installa come qualsiasi altro plugin. Se
un giorno lo elimini, la schermata Shortcode del pannello ha un pulsante Installa il
plugin che lo scarica di nuovo.
Aggiornalo insieme al tema
Shortcode nuovi e correzioni arrivano con il plugin, non con il tema. Quando aggiorni Pulsar, aggiorna
anche Pulsar Core.
4 · La prima ora
Se fai solo queste otto cose, il sito è già presentabile.
- Scegli uno stile. Pulsar Theme → Stili e Aspetto. Scrive in un clic una
configurazione completa — palette, font, hero, blocchi della homepage — e resta tutto modificabile.
- Importa i contenuti demo, ma solo su un sito nuovo. Stessa schermata. Se il sito ha
già articoli, salta questo passo.
- Metti il tuo logo. Header e logo, poi il pulsante che apre la sezione del
Customizer. Quattro caselle: normale, retina, scuro, scuro retina.
- Imposta l'icona del sito (il quadratino nella scheda del browser), dalla stessa
schermata.
- Controlla i colori. Colori e tipografia. Scrivi un codice esadecimale o
scegline uno: l'anteprima a destra si aggiorna mentre lavori.
- Costruisci la homepage. Homepage: trascina i blocchi nell'ordine che vuoi,
spegni quelli che non ti servono e configura ognuno.
- Costruisci i menu. Aspetto → Menu, oppure la scorciatoia nella schermata
Header e logo.
- Decidi sui cookie. Privacy e cookie. Il banner è spento di default perché è
una decisione legale, ed è tua.
5 · Stili e Aspetto
Una configurazione intera in un clic, pensata per un tipo di pubblicazione.
Uno stile scrive in una volta sola un set completo di opzioni: palette, font, layout dell'hero, ordine
dei blocchi della homepage e i testi di ogni sezione. Resta tutto modificabile dopo: uno stile è un punto
di partenza, non una modalità in cui resti chiuso.
| Stili | Cosa imposta |
| News magazine | Hero C con la sidebar accanto, griglia a due colonne di dieci articoli, nove blocchi. La configurazione predefinita. |
| Auto e moto | Hero C su una fascia dal rosso al bordeaux, due colonne, un carosello di guide all'acquisto e un blocco recensioni. |
Dettagli che appartengono a un solo stile
Uno stile può portarsi dietro un dettaglio suo che non merita un'opzione. Auto e moto
ricolora di rosso il logo incluso nel tema, che di suo è blu, così il marchio si accorda alla fascia
su cui poggia.
Riguarda soltanto il logo incluso. Nel momento in cui imposti un logo tuo in
Header e logo, viene mostrato esattamente come l'hai caricato: il tuo logo ha già il colore
che hai scelto, e potrebbe perfino essere una fotografia.
Di cosa risponde uno stile
Uno stile non è solo una palette: è l'aspetto del sito. Colori e caratteri, certo, ma anche i blocchi
della home e il loro ordine, l'hero, le card e le impostazioni dell'articolo singolo. Tutto il resto — il
tuo logo, i codici pubblicitari, i campi SEO, gli indirizzi social e il blocco HTML libero che scrivi in
fondo agli articoli — appartiene al sito e uno stile non lo sposta mai.
Ogni stile ha le sue impostazioni
Se cambi qualcosa in Home page o in Articoli mentre è attivo uno stile, quella modifica
appartiene a quello stile. Passando all'altro il sito prende le impostazioni di
quest'ultimo, non le tue; tornando indietro ritrovi le tue scelte, esattamente dove le
avevi fatte.
Così gli stili non sono in competizione: puoi sistemarne uno come vuoi tu, provare l'altro e tornare
indietro senza buttare via un pomeriggio di lavoro. Applicare il stile già attivo vuol dire una
cosa diversa, di proposito: è il modo di richiederlo com'è di fabbrica, e azzera quello che avevi
cambiato sotto di lui.
Le opzioni che uno stile non nomina tornano al valore predefinito del tema quando cambi, invece di
restare la decisione dello stile precedente: è questo che fa sì che uno stile somigli a se stesso.
Togliere i contenuti demo
Tutto ciò che l'importazione porta viene marcato come suo, così per toglierlo basta un pulsante —
Rimuovi i contenuti demo, nella stessa schermata — e non un pomeriggio a cancellare articoli a
mano e poi a cercare le immagini che si sono lasciati dietro nella libreria media.
Vengono rimossi gli articoli e le pagine, le immagini e i file che ci stanno dietro, le
categorie, il menu e i widget aggiunti dall'importazione. Viene cancellato solo ciò che porta il
marchio dell'importazione, quindi gli articoli scritti nel frattempo non corrono alcun rischio. Il
pulsante compare solo quando c'è davvero qualcosa da togliere: su un sito i cui articoli arrivano da
altrove il tema non ha nulla da rivendicare, e quindi non propone niente.
Annulla, qui sotto, è un'altra cosa. Rimette le tue impostazioni, non i tuoi contenuti:
per gli articoli e le immagini demo si usa il pulsante qui sopra.
Annulla
Le impostazioni che avevi prima di applicare il primo stile in assoluto vengono conservate.
Ripristina le impostazioni precedenti, in fondo alla stessa schermata, le rimette a posto.
Uno stile non tocca mai i tuoi contenuti. Scrive soltanto opzioni — nessun articolo viene
creato, modificato o cancellato — quindi puoi provarne uno anche su un sito attivo da anni.
Aspetto: chiaro e scuro
Il tema è disegnato in due aspetti. Quello scuro non è un secondo foglio di stile: è un secondo insieme
di valori per le stesse variabili, e prende i colori della tua palette — il colore del
marchio alzato di luminosità perché si legga su una pagina scura, lasciandone intatti tonalità e
saturazione. Cambi il colore del marchio e l'aspetto scuro cambia con lui.
Lo stesso vale per la fascia dietro l'hero: il colore che scegli lì viene portato a un peso che l'aspetto
scuro può reggere, mantenendone la tonalità, così una fascia azzurrina diventa un blu profondo invece di
restare una striscia chiara su una pagina scura. Un gradiente conserva la sua direzione, e un colore già
scuro resta com'è.
Niente di tutto questo ti viene tolto di mano. In Colori e tipografia, in cima, ci sono un sole e
una luna: vesti l'aspetto chiaro, giri l'interruttore e ritrovi gli stessi colori per quello scuro —
sfondo, superficie delle card, bordi, testo, marchio, accento e la pastiglia dei commenti, ognuno con il
colore che il tema ha già calcolato dentro la casella, pronto da leggere o da sostituire. Un colore scuro
segue quello chiaro corrispondente finché non lo cambi; da quel momento è tuo e resta dove l'hai messo.
L'anteprima accanto mostra l'aspetto su cui stai lavorando. I due colori dell'hero funzionano allo stesso
modo.
- Aspetto del sito — Chiaro e Scuro sono ciò che riceve ogni
visitatore, comunque sia impostato il suo dispositivo. Segui il sistema, il valore di
fabbrica, affida invece quella decisione al dispositivo, come fa la maggior parte dei siti.
- Permetti ai visitatori di cambiarlo dall'header — attivo di serie. Aggiunge un
pulsante accanto alla ricerca: una luna sull'aspetto chiaro, un sole su quello scuro. Il sito
parte comunque dall'aspetto che hai scelto; quello che il visitatore sceglie con il
pulsante viene poi ricordato nel suo browser. Disattivandolo, l'aspetto che hai scelto è l'unico
disponibile: il pulsante sparisce e non c'è modo di cambiarlo.
| Aspetto | Pulsante | Cosa vede il visitatore |
| Segui il sistema | attivo | Quello che chiede il suo dispositivo, finché non preme il pulsante. |
| Chiaro o Scuro | attivo | Quello che hai scelto tu, comunque sia il dispositivo — poi il suo, se preme il pulsante. |
| Chiaro o Scuro | spento | Quello che hai scelto tu. Non c'è pulsante e non c'è modo di aggirarlo. |
| Segui il sistema | spento | Quello che chiede il suo dispositivo, e nient'altro. |
Se cambi l'impostazione, tutti ripartono da lì
La scelta del visitatore viene conservata, ma solo finché il sito resta impostato com'era quando l'ha
fatta. Metti il sito su scuro e alla visita successiva tutti ricevono lo scuro, compresi quelli che
avevano già premuto il pulsante. Altrimenti «il sito è scuro» vorrebbe dire soltanto «scuro per chi non
l'ha mai toccato», che non è quello che dice l'impostazione.
La barra superiore e il footer sono scuri in entrambi gli aspetti — è il disegno del tema — quindi non
cambiano. L'header sì: è una barra bianca sull'aspetto chiaro e una scura qui.
Un secondo logo, per l'header scuro
Un logo disegnato con colori scuri scomparirà su un header scuro. In Aspetto → Identità del
sito c'è un Logo per la modalità scura, con il suo file retina; il tema mostra quello dei
due che appartiene all'aspetto in uso, e il browser scarica solo quello. Lascialo vuoto e viene usato lo
stesso logo in entrambi.
L'aspetto viene deciso prima che una sola regola venga letta, nella testa della pagina,
quindi il sito non lampeggia mai in bianco prima di diventare scuro. Un visitatore con JavaScript
disattivato riceve comunque l'aspetto scuro quando è il suo dispositivo a chiederlo.
6 · Contenuti demo — l'importatore in un clic
Per un WordPress che non ha ancora articoli. Si importano una volta sola, se mai serve.
Su un'installazione nuova non c'è niente su cui configurare il tema: una homepage vuota non ti dice come
verrà una griglia o un hero. I contenuti demo riempiono il sito con articoli di esempio, categorie, una
pagina, i menu e i widget, così configuri il tema su una homepage che si comporta come quella vera.
- Ricevi gli articoli del sito demo, non riempitivo: le gallerie, i blocchi cover, le
tabelle, i riquadri recensione, gli shortcode e i commenti che fanno funzionare il widget «Più
commentati». Quattordici articoli, quattordici categorie, i menu e i widget — e una pagina a tutta
larghezza che mostra uno dopo l'altro tutti i blocchi di Gutenberg che il tema veste.
- È un unico set di contenuti, non uno per stile. Gli stili si vedono già dalle loro
miniature: non serve importare quattordici articoli per capire cosa fa una palette.
- Articoli e pagine viaggiano dentro il tema; le fotografie vengono scaricate quando
premi il pulsante — circa 10 MB, una volta sola. Tenere cinquantacinque fotografie nello zip
renderebbe ogni aggiornamento del tema un download da 10 MB per una cosa che quasi tutti importano
una volta, o mai.
- Tutto ciò che viene importato è marcato. Rimuovi i contenuti demo cancella
esattamente quello che era stato creato — articoli, pagine, foto, categorie, commenti — e non tocca
mai un articolo scritto da te.
Serve la connessione, una volta
Le fotografie arrivano dal nostro server, e quella richiesta parte solo quando premi il pulsante: mai
all'attivazione, mai a scadenza, mai mentre una pagina viene servita a un visitatore. Se una fotografia
non si scarica, l'articolo viene importato lo stesso: arriva con il suo testo e senza quell'immagine.
L'importatore ripiega su articoli che scrive da sé, con le copertine disegnate al volo, soltanto quando il
pacchetto demo dentro il tema manca o è illeggibile: in un caso e nell'altro ti ritrovi comunque un sito
su cui configurare il tema.
Se il tuo sito ha già articoli non ti servono
La schermata te lo dice, con il numero di articoli che hai già. Importarli lo stesso è permesso — è il tuo
sito — ma ti ritroveresti quattordici articoli di esempio da ripulire da un archivio vero.
Come funziona il pannello
Una schermata, un argomento. Niente viene applicato finché non salvi.
Il pannello sta sotto Pulsar Theme nel menu di WordPress. La prima pagina è una panoramica: una
card per ogni schermata, ognuna con una riga che dice cosa contiene e una pastiglia con il suo stato
attuale — quante zone pubblicitarie sono accese, se il banner dei cookie è attivo, quale stile è stato
applicato.
Tre abitudini utili
- La barra in basso. Appena cambi qualcosa compare una barra con Salva le
impostazioni. Finché non la premi, niente è attivo. Uscendo dalla pagina le modifiche si
perdono.
- L'anteprima dal vivo. Diverse schermate hanno a destra un'anteprima con il pallino
verde e la scritta non salvato: mostra quello che stai facendo prima che tu lo confermi.
Viene disegnata con i fogli di stile veri del sito, quindi non è un'illustrazione.
- I cursori hanno un ripristino. Passa il mouse sulla riga di un cursore e accanto al
numero compare una piccola freccia: rimette quel valore a quello di serie del tema.
Vuoto di solito significa «usa il predefinito»
In tutto il pannello, svuotare un campo non vuol dire «non mostrare niente» ma «usa quello che il tema
porta con sé». Dove invece il vuoto nasconde davvero qualcosa, il campo lo dice.
Colori e tipografia
La palette, il font del sito e ogni dimensione del testo.
I colori
Il tema è disegnato in due aspetti, chiaro e scuro, e la scheda ne imposta uno per volta. L'interruttore
in cima dice su quale stai lavorando: tutto quello che sta sotto appartiene a quell'aspetto.
Ogni riga è un colore. Puoi impostarlo in due modi, ed è sempre lo stesso valore:
- Scrivi il codice esadecimale nel campo: è quello che viene salvato.
- Clicca il quadratino a sinistra per aprire il selettore di sistema.
Il pulsante in fondo alla riga la riporta al punto di partenza. Sull'aspetto chiaro è il colore di
fabbrica del tema; su quello scuro è Auto, che restituisce il colore al calcolo a
partire dal colore chiaro corrispondente. Un colore scuro continua a seguire il suo gemello chiaro
finché non lo cambi, e da quel momento resta dove lo hai messo.
| Colore | Dove si vede |
| Sfondo | La pagina dietro a tutto. |
| Superficie | Card, riquadri e sidebar. |
| Bordi | Filetti, contorni delle card, separatori. |
| Titoli | I titoli degli articoli, sulle card e in cima alla pagina. |
| Sottotitoli e meta | Il testo che si legge dopo: sottotitoli delle card, autore, data, numero di commenti. Ricavato dal colore dei titoli finché non lo imposti. |
| Brand | Link, pulsanti, la categoria sopra al titolo, voce di menu attiva: è il colore del sito. |
| Accento | Il pulsante e l'etichetta di un box [product], la categoria sulle card cover story, la pastiglia dell'ultim'ora, il badge di una voce in [horizontal-menu]: ciò che non deve sembrare un link. |
| Sfondo e testo dei commenti | La pastiglia dei commenti su card e articoli. Arrivano entrambi ricavati dal brand. |
Le tinte tenui che il tema usa dietro le pastiglie e dietro il testo selezionato sono
derivate dal colore del brand, non fisse: cambia il brand e ogni superficie tenue lo segue.
Il colore della fascia dell'hero non si imposta qui. Appartiene alla fascia, e si imposta
dove sta la fascia: Homepage → Hero, accanto al layout che colora.
Angoli
Quanto è arrotondato tutto — card, immagini, pulsanti, la fascia dell'hero, la pillola attorno alla
categoria — in un'unica impostazione per tutto il sito. Arrotondati è il tema com'è
disegnato, Appena ne lascia un accenno, Squadrati porta ogni angolo a
zero: è l'aspetto della maggior parte delle testate di motori e di sport.
Ogni raggio del tema è scritto come la propria misura moltiplicata per un solo numero, quindi questa
impostazione li cambia tutti insieme e nessuno singolarmente: non viene ridisegnato niente, e tornando su
Arrotondati ritrovi il disegno esattamente com'era. Le forme tonde per natura — gli avatar degli
autori, i pulsanti circolari — usano una percentuale e restano tonde qualunque cosa tu scelga.
Lo stile Auto e moto nasce squadrato, immagine in evidenza compresa.
Font del sito
Dodici famiglie incluse più Sistema, che usa il font del dispositivo di chi legge e non carica
niente. I font inclusi sono ospitati sul tuo sito: nessuna richiesta esce mai da lì. Personalizzato
ti permette di indicare qualunque famiglia tu stia già caricando per conto tuo.
L'elenco copre quattro registri e non uno solo: i sans-serif neutri — Inter, Geist, DM Sans, Nunito,
Open Sans, Lato — quelli geometrici con più carattere — Poppins, Montserrat — le serif, per un sito che
vuole leggersi come una rivista e non come un'app — Playfair Display per i titoli,
Lora e Source Serif per il testo da leggere a lungo — e una condensata,
Oswald, che è la forma che prende di solito una testata di sport o di motori.
Lo stesso elenco di famiglie viene chiesto due volte, e una scheda decide quale delle due stai guardando.
Testi interni è la famiglia di tutto il sito: il testo degli articoli, i menu, i pulsanti, le
righe con l'autore, i widget e le didascalie. Solo i titoli sono i titoli degli articoli, quelli
di sezione e quelli delle card — una serif sopra una sans è l'accoppiamento più antico che una rivista
abbia, e cambia il carattere di un sito più di qualunque colore. Lasciati su Default tema i
titoli seguono la famiglia del sito e tutto tiene una famiglia sola, che è come il tema viene consegnato.
Vengono scaricate solo le famiglie davvero in uso: un corpo di sistema con una serif sui titoli carica un
gruppo di file, non due.
I file sono caricati in modo che la pagina non venga mai ridisegnata a metà strada con un'altra famiglia:
i due file che servono sono precaricati nella testa della pagina e i caratteri sono dichiarati
font-display: optional. Una famiglia che arriva in tempo viene disegnata fin dal primo
rendering; una che non ce la fa viene rimandata alla pagina successiva, quando ormai è in cache. In
entrambi i casi non c'è nessun lampo di un font sostituito da un altro e niente si sposta nella pagina —
che è quello che misura l'indice di spostamento dei report sulle prestazioni.
Dimensioni del testo
Cursori per il corpo del testo, il testo degli articoli, i titoli e i componenti delle card. I due che
contano di più:
- Articolo — la dimensione del testo dentro un articolo. Il tema la riduce sui
telefoni; impostando questo cursore il tuo valore vale su ogni schermo.
- Titolo articolo — il titolo nella pagina dell'articolo singolo.
Ogni dimensione ha il suo gemello per il telefono, dietro l'interruttore desktop / mobile. Un cursore
mobile lasciato a zero vuol dire come su desktop: la dimensione viene ereditata e non viene
scritto niente. L'unica eccezione è Bento · post piccoli, per cui il tema ha una
dimensione sua sul telefono — 15px — perché lì quelle card stanno una sotto l'altra e il
titolo ha la larghezza dello schermo. Il suo cursore a zero dice come da tema (15px), e
spostandolo si sostituisce quel valore.
Lo stesso vale per le due dimensioni in cima a un articolo, in Articoli singoli: il
titolo è 22px sul telefono e il sottotitolo
15px, su ogni stile. Un titolo pensato per una colonna larga non regge su uno schermo
da quattro pollici, quindi il tema li imposta a parte invece di ridurre il valore del desktop.
Ricerca
Due modi per trovare un articolo, e dicono la stessa cosa.
Ricerca istantanea
La lente nell'intestazione apre un riquadro che risponde mentre scrivi — oppure premi
⌘K (Ctrl+K su Windows) da qualunque punto del sito. Ogni risultato porta una
piccola miniatura quadrata, così si riconosce il pezzo prima ancora di leggerne il titolo.
Da tastiera: Esc chiude e riporta il fuoco sulla lente, ↑ e ↓ scorrono
i risultati mentre il cursore di testo resta nel campo (Home e Fine saltano al
primo e all'ultimo), Tab si sposta fra i risultati senza uscire dal riquadro,
Invio apre quello selezionato. Scrivendo una parola e
premendo subito Invio si va invece alla pagina completa dei risultati.
La pagina dei risultati
La stessa ricerca, con le card che vedi ovunque nel sito, la barra laterale e la paginazione: la
pagina per scorrere tutto, invece di scegliere al volo la prima cosa utile.
Che cosa guardano, entrambe
Pulsar cerca nei titoli degli articoli, non in tutto il testo, e pretende che ci siano
tutte le parole che hai scritto. I risultati escono dal più recente,
non per rilevanza.
Un sito di notizie si legge per quello che è successo, non per quante volte compare una
parola. Cercare nel corpo dell'articolo metterebbe un pezzo di cinque anni fa che la nomina di
sfuggita sopra la notizia di oggi che ne parla. Il riquadro istantaneo e la pagina dei risultati
seguono la stessa regola, quindi il primo suggerimento è lo stesso articolo che trovi premendo
Invio.
Su un archivio molto grande
Una ricerca per titolo non può sfruttare un indice del database, quindi il riquadro istantaneo tiene
ogni risposta per cinque minuti: la stessa parola scritta da tanti visitatori è una query sola, non
centinaia.
Homepage
La homepage è una pila di blocchi. Decidi tu quali, in che ordine e come si comporta ognuno.
La schermata ha tre pannelli: Costruisci la tua Home, Personalizza l'Hero e
Personalizza le Card Articoli.
Costruirla
- Aggiungi un blocco con il pulsante Aggiungi, oppure spegni quello che non
vuoi.
- Trascinalo dalla maniglia per cambiarne l'ordine, oppure usa le frecce su e giù accanto alla maniglia — gli stessi pulsanti che la bacheca di WordPress mette sui suoi box, ed il modo per riordinare senza mouse. Un blocco si sposta dentro la propria fascia, e la freccia si spegne quando non ha più dove andare. La homepage viene resa esattamente
in quest'ordine.
- Apri Configura su un blocco per impostarne il titolo, quanti articoli
mostra, da quali categorie o tag li prende, quale stile di card usa e se ha il pulsante Carica
altri.
Alcuni blocchi si possono aggiungere più di una volta — due griglie puntate su categorie
diverse, per esempio. Ogni copia mantiene le sue impostazioni.
La barra delle storie
La fila di copertine rotonde in cima alla pagina, la forma che chi legge da telefono conosce da Instagram:
scorre di lato col dito e ogni copertina apre il suo articolo. Ha quattro impostazioni sue, in
Homepage:
| Impostazione | Cosa fa |
| Dove si vede | Telefono, desktop o entrambi. Di partenza solo telefono, che è da dove viene la forma. |
| Categoria e tag | Quali articoli la riempiono. Lasciati vuoti, i più recenti. |
| Quanti | Otto di serie. |
Nascosta su un dispositivo non costa niente: il blocco esce prima di interrogare qualsiasi
cosa, quindi nessun markup e nessun lavoro sul database — ed è ciò che la rende sicura su un sito servito
da una cache che divide per dispositivo.
I blocchi
| Blocco | Che cos'è | Dove si posiziona |
| Stories | Copertine tonde in fila, come una barra di storie. | Fascia alta, tutta larghezza |
| Hero | Il blocco di apertura. Cinque layout, vedi sotto. | Fascia alta, tutta larghezza |
| Categorie | Una riga di card delle categorie. | Fascia alta, tutta larghezza |
| Griglia Articoli | Una griglia di card, da una a sei colonne, con i chip di filtro. | Colonna principale |
| Lista compatta | Un elenco verticale con miniature laterali: un titolo, una data e nient'altro. | Colonna principale |
| Carosello Articoli | Card che scorrono di lato, con frecce e trascinamento. | Colonna principale |
| Bento Articoli | Una card grande più altre piccole, fino a tre colonne. | Colonna principale |
| Timeline | Articoli lungo una linea con le date. In Configura può escludere gli articoli già pubblicati dai blocchi che la precedono — attivo di serie — così lo stesso pezzo non compare due volte nella pagina; disattivandolo attinge all'intero archivio. | Colonna principale |
| Lista articoli | La card a riga che usano gli archivi: immagine a sinistra e, a destra, il
titolo a corpo di lettura con l'apertura del pezzo sotto. Dove la lista compatta dà un titolo e una data,
questa dà abbastanza per decidere, quindi sta bene in una fascia da cinque articoli e non da quindici.
In Configura, Disegna la lista su una card decide se le righe stanno su una card
propria — di serie sì — oppure direttamente sulla pagina. Gli angoli di quella card seguono lo stile del
sito come ogni altra card. | Colonna principale |
| Timeline estesa | Le stesse righe, appese a una linea con le date, con il giorno scritto una
volta per quanti articoli contiene. È la versione da leggere della Timeline qui sopra, con la stessa
scelta fra stare su una card o sulla pagina. | Colonna principale |
| Banner app | La promozione di un'app iOS, con i dati letti dall'App Store. | Fascia bassa, tutta larghezza |
| Newsletter | Un riquadro di iscrizione che ospita il modulo del tuo plugin. | Fascia bassa, tutta larghezza |
I blocchi della colonna principale stanno accanto alla sidebar della homepage; quelli delle
fasce alta e bassa occupano tutta la larghezza della pagina. È per questo che l'ordine non è del tutto
libero: un blocco a tutta larghezza non può comparire in mezzo a una colonna.
Le fasce a colonna sono due, ognuna con la sua sidebar — Sidebar Homepage e Homepage ·
seconda sidebar — così lo stesso widget non viene mai mostrato due volte nella stessa pagina. Quale
sidebar mostri una fascia è la prima riga di quella fascia in Homepage: una riga fissa, sopra i
blocchi, con un menu che elenca tutte le sidebar del sito e quanti widget contengono. Di serie la prima
fascia mostra la prima sidebar e la seconda fascia la seconda; scambiarle è un clic, e
Nessuna rende quella fascia a tutta larghezza.
Una fascia a colonna riserva sempre lo spazio della sua sidebar, che ci siano widget dentro o no: la
colonna resta larga quanto quella dell'altra fascia, e la striscia vuota è il segno che la sidebar
aspetta di essere riempita da Aspetto → Widget.
Ordine
Ogni blocco che pesca i propri articoli ha un controllo Ordine dentro Configura:
Più recenti, Meno recenti o Casuale. Vale per griglia, lista, carosello,
bento e timeline, da solo o insieme a un filtro per categoria o tag.
Casuale rimescola a ogni caricamento, quindi un blocco impostato così non viene mai messo in
cache: conviene usarlo su un blocco, non su tutti. Il bento aggiunge Ordine, blocco 2 e
Ordine, blocco 3, ciascuno con un valore Eredita in più, che segue l'ordine
impostato sulla prima colonna.
Un secondo titolo per il telefono
Accanto al titolo e al sottotitolo per il desktop, Configura tiene una seconda coppia
per il telefono. Lasciali vuoti — il segnaposto dice uguale al desktop — e il testo
del desktop vale su ogni schermo. Compilandone uno, un titolo lungo può diventare corto dove la
colonna è stretta.
Vengono stampate entrambe le versioni ed è lo schermo a scegliere, in CSS, senza tirare a indovinare
il dispositivo: così la coppia funziona anche dietro una cache di pagina che serve lo stesso HTML a
tutti.
I chip di filtro della griglia
La griglia può mostrare una riga di chip che la filtrano senza ricaricare la pagina. Ogni riga è una
categoria scelta da un elenco con ricerca, più l'etichetta che vuoi sul chip: lascia l'etichetta vuota e
userà il nome della categoria, così rinominando la categoria si rinomina il chip. Su un sito che ha già
articoli, le tre categorie con più articoli vengono proposte finché non salvi il campo la prima volta.
Carica altri
Griglia, lista, bento e timeline possono chiudersi con un pulsante Carica altri che porta il
lotto successivo senza ricaricare la pagina. Decidi tu quanti articoli per clic. Nel bento un solo
pulsante allarga tutte le colonne insieme e nessuna colonna ripete un articolo che un'altra ha già
mostrato.
I layout dell'hero
Cinque modi di aprire la homepage. Si sceglie in Homepage → Personalizza l'Hero.
| Layout | Com'è fatto | Adatto a |
| A | Una card grande con due card impilate accanto. | Una notizia di apertura chiara. |
| B | Una card grande con una lista compatta accanto. | Un blog, dove la lista è l'archivio. |
| C | Un carosello di card con la sidebar accanto. | Siti di notizie: più storie sopra la piega. |
| D | Il layout C su fascia scura, con spazio per un video e due pulsanti. | Lanci, campagne, tecnologia. |
| E | Un grande riquadro media con titolo, pulsanti e un carosello facoltativo. | Approfondimenti e viaggi, dove comanda la foto. |
I pulsanti social dei layout B e C
Entrambi hanno una colonna laterale, e dentro una riga di pulsanti per i tuoi canali social. Un
interruttore decide se la riga viene disegnata, e un elenco di caselle decide quali reti mostra:
Facebook, X, Instagram, YouTube, TikTok e Threads sono spuntate di partenza, Telegram e
WhatsApp si possono aggiungere, e qualsiasi delle sei si può togliere. Compaiono nell'ordine
dell'elenco, che si riordina con le due frecce su ogni card — gli stessi pulsanti funzionano col mouse
e da tastiera.
I due layout hanno una scelta ciascuno, quindi la riga può essere diversa in B e in C. L'indirizzo di
ogni profilo e il suo numero di follower si impostano una volta sola, in
Social & Promo: una rete senza indirizzo mostra comunque il suo pulsante, che
punta alla home della rete stessa e resta senza numero — il tema non inventa mai un conteggio di
follower.
Impostazioni comuni a tutti e cinque
- Sfondo — tinta unita o gradiente, si imposta qui o in Colori e
tipografia.
- Quanti articoli prende l'hero.
- Quali articoli — includi o escludi categorie e tag, per ID oppure per slug.
Un filtro che non trova niente ripiega sugli articoli più recenti, così un'installazione nuova non
apre mai con l'hero vuoto.
Gli articoli in evidenza
Di serie l'hero cerca il tag featured. Assegnalo a un articolo e va in cima; svuota il campo
e l'hero mostra semplicemente gli articoli più recenti.
I layout D ed E
Entrambi hanno due pulsanti di invito all'azione e uno spazio per un media. Due regole da sapere: un
pulsante viene disegnato appena ha un'etichetta, così lo vedi mentre lo configuri, ma diventa un link
vero solo quando ha anche un indirizzo. E se lasci vuoto il media, il tema disegna un suo segnaposto
invece di un riquadro vuoto o di un'immagine rotta.
Le card degli articoli
Nove stili di card. Ogni blocco ne sceglie uno; tu decidi cosa mostra ciascuno stile.
Apri Homepage → Personalizza le Card Articoli. Per ogni stile c'è un'anteprima dal vivo costruita
sui tuoi articoli veri e una serie di interruttori. La card Dove viene usata ogni card ti dice
quali blocchi usano quale stile.
| Stile | Che cos'è |
| Standard | Copertina sopra, testo sotto. È la card di cui è fatto quasi tutto il sito. |
| Hero | La card grande del blocco hero. |
| Cover story | Testo sopra la foto, per una card a tutta immagine. |
| Laterale | Miniatura a sinistra, testo a destra. La usano le liste. |
| Compatta | Piccola e densa, per sidebar e colonne strette. |
| Lista | La riga: immagine a sinistra, titolo a corpo di lettura e apertura del pezzo a destra.
La usano il blocco Lista articoli e la disposizione a elenco degli archivi. |
| Timeline estesa | La stessa riga, appesa a una linea con le date. Parte dalle risposte date
allo stile Lista e da lì tiene le proprie, così una homepage che li porta entrambi può mostrare
l'autore in uno e non nell'altro. |
| Timeline | Una voce della timeline compatta: l'ora, il titolo e — se li chiedi — una
miniatura e la categoria. |
| Bento | Non è una card ma un blocco fatto di due: quella grande è Hero, le piccole sono
Compatta. Qui si impostano solo le sue dimensioni del testo. |
Cosa puoi accendere per ogni stile
- Dove sta la categoria sull'immagine — in basso a sinistra o in alto a sinistra — negli stili che la disegnano lì
- Categoria, e se ha uno sfondo dietro
- Nome dell'autore, avatar dell'autore (desktop e mobile separatamente)
- Data, e il suo formato: condensato (19 Apr 2026) o esteso (19 Aprile 2026)
- Numero di commenti, e se scrivere per esteso la parola «commenti»
- Estratto
Il voto delle recensioni compare da solo
Se un articolo ha il riquadro recensione acceso, il suo punteggio si vede nell'angolo della card ovunque
quell'articolo compaia. Non devi scegliere una card speciale.
Il simbolo del play sugli articoli video
Metti il
Formato dell'articolo su
Video e ogni card di quell'articolo porta un piccolo
simbolo del play sopra la foto, su tutti e cinque gli stili di card. Il
Formato è la prima voce
del riquadro
Pulsar — opzioni dell'articolo, sotto l'editor, accanto al sottotitolo e al video
in evidenza: è la stessa impostazione che WordPress tiene nella barra laterale, messa dove si vedono i
suoi effetti. È un'etichetta, non un lettore: dice «questo è un video» ovunque l'articolo sia elencato.
Per far muovere la foto stessa serve invece il video in evidenza, in
Articoli.
Articolo singolo
Tutto quello che sta nella pagina di un articolo, nell'ordine in cui appare.
La schermata è un elenco numerato di blocchi, dall'alto verso il basso, così si legge come la pagina
stessa: briciole di navigazione, categoria, titolo e sottotitolo, condivisione, riga meta,
immagine in evidenza, contenuto, tag, riquadro autore, precedente/successivo, articoli correlati,
commenti.
Layout dell'articolo
La prima card della schermata sceglie come è disposta la pagina di un articolo. Un layout decide dove
stanno gli elementi e su cosa poggiano; non decide mai che cosa la pagina contenga.
A questo servono gli interruttori sotto di esso, che valgono con qualunque layout tu scelga.
| Layout | Che cos'è |
| Standard | L'articolo e la sidebar come due riquadri sul colore del sito. È quello predefinito del tema. |
| Semplice | Senza riquadri: articolo, commenti e widget poggiano direttamente sulla pagina, senza sfondo, bordo o angoli propri, e una sola linea verticale separa l'articolo dalla sidebar. Solo questo layout offre Immagine sopra il titolo, che fa aprire la pagina dall'immagine in evidenza, con categoria, titolo e riga dell'autore sotto di essa. |
| Titolo esteso | Il layout Semplice con categoria, titolo, sottotitolo e riga dell'autore disposti a tutta larghezza sopra le due colonne: il titolo è largo quanto il sito e non quanto la colonna dell'articolo. I pulsanti di condivisione stanno in fondo alla riga dell'autore, come soli marchi, senza nome e senza sfondo. |
| Editoriale | L'immagine in evidenza a tutta larghezza e il testo più stretto della foto, con la colonna di condivisione allineata al bordo sinistro dell'immagine da circa 1200px — non i 1500px richiesti dagli altri layout, perché qui la colonna sta nello spazio che il testo più stretto lascia e non nel margine della pagina. Il blocco che apre l'articolo — categoria, titolo, sottotitolo, riga dell'autore e pulsanti di condivisione — è centrato, e l'interruttore Blocco iniziale centrato lo spegne per allinearlo a sinistra; quello che sta sotto il testo non cambia. Scegliere il layout imposta lo sfondo della categoria su Pieno, che è ciò che tiene insieme quella riga quando la parola sta da sola al centro della pagina; resta comunque un'impostazione come le altre. In questo layout la sidebar non è prevista: il suo interruttore sparisce dalla schermata finché è scelto, e un articolo impostato così dalle sue opzioni viene disegnato senza. |
| Copertina | L'immagine in evidenza a tutta larghezza, con categoria, titolo, sottotitolo e riga dell'autore scritti sopra; articolo e sidebar seguono più in basso. L'immagine non viene ridisegnata una seconda volta sopra il testo e la sua didascalia non compare sotto la copertina. Scegliere questo layout accende le briciole di navigazione se erano spente, perché con il titolo sulla foto sono loro a dire al lettore dove si trova; restano comunque un interruttore come gli altri. Un articolo senza immagine in evidenza mantiene il titolo sopra il testo, come negli altri layout. Sul telefono il titolo esce da sopra la foto e la pagina si legge come il layout Standard: un'immagine così stretta non può portare un titolo sopra e restare visibile. |
Il layout scelto qui è quello del sito. Un singolo articolo può averne uno suo nel riquadro
Pulsar — opzioni articolo sotto l'editor: il campo Layout parte da
Come impostato nel pannello del tema, e lasciato così l'articolo segue il sito — anche quando
la scelta del sito cambia in seguito. Sceglierne uno lì modifica quell'articolo e nessun altro.
Nella stessa card c'è l'interruttore della sidebar. Spento, la sidebar non viene
disegnata affatto, con entrambi i layout, e l'articolo occupa tutta la larghezza del sito, restringendosi
insieme alla finestra come ogni altra pagina.
Le impostazioni che userai davvero
| Impostazione | Cosa fa |
| Briciole di navigazione | Il percorso Home / Categoria sopra il titolo. Spento di default. I dati strutturati per i motori di ricerca vengono emessi comunque, quindi spegnerlo non costa niente in termini di ricerca. |
| Sfondo della categoria | Tre stati: Nessuno (la parola nel colore del brand), Tenue (una pastiglia tenue), Pieno (colore del brand, testo bianco). |
| Sottotitolo | Una riga sotto il titolo. La scrivi sull'articolo stesso, nel riquadro Pulsar — opzioni dell'articolo, sotto l'editor. |
| Sponsor | Si imposta sull'articolo, nello stesso riquadro: un logo e, se vuoi, un indirizzo a cui collegarlo. Il logo viene disegnato alto 20px e largo al massimo 160, quindi un marchio più largo che alto sta meglio sulla riga; caricato al doppio resta nitido sugli schermi ad alta risoluzione. Con un logo lì, la riga dell'autore scrive Sponsorizzato da e mostra il marchio al posto del nome e dell'immagine dell'autore; il resto della riga — data, tempo di lettura e commenti — non cambia. Il collegamento porta rel="nofollow sponsored", che è ciò che i motori di ricerca si aspettano da un contenuto a pagamento. Lascia il logo vuoto per un articolo normale. |
| Formato della data | Esteso, condensato, o quello che dicono le Impostazioni → Generali. |
| Tempo di lettura | Una stima ricavata dalla lunghezza dell'articolo. |
| Immagine in evidenza | Mostrala o nascondila, imposta il raggio degli angoli e un'ombra facoltativa. |
| Articoli correlati | Accesi o spenti, e quanti per riga su desktop, tablet e telefono. |
| Commenti | Spento qui significa che la sezione non viene disegnata affatto, anche dove WordPress ha i commenti aperti. |
Condivisione
L'articolo può essere proposto al lettore in tre punti, ognuno con il suo interruttore. Sono link e
basta: non viene caricato niente da altri, nessuno script, nessun contatore, nessun cookie.
| Punto | Cos'è |
| Una barra sotto il titolo | Pulsanti che si dividono la larghezza della colonna, sopra la riga con l'autore e la data. Su schermo largo ognuno porta il nome della destinazione, sul telefono il solo marchio. Mostra le prime sei voci dell'elenco: oltre, il pulsante diventa troppo stretto per un dito. Spenta finché non la accendi. |
| La fila sotto l'articolo | In fondo al pezzo, con il nome della destinazione accanto al marchio. Accesa di serie, con le cinque che ha sempre portato: è l'unico punto che non si regola. |
| Una colonna accanto all'articolo | Nel margine a sinistra del testo, segue il lettore mentre scorre. Richiede una finestra larga circa 1500px e sotto quella misura non viene disegnata, perché il margine non c'è. Spenta finché non la accendi. |
La barra e la colonna si regolano separatamente, ognuna sotto il proprio interruttore
e visibile solo quando quello è acceso. Entrambe scelgono il riempimento — il colore
della destinazione dietro un marchio bianco, oppure quel marchio colorato sulla pagina — ed entrambe
scelgono quali destinazioni portare, tra Facebook, X, WhatsApp, Telegram, LinkedIn,
Pinterest, email e un pulsante per copiare il link, da spuntare e riordinare come i profili social. Una
fila corta sopra il pezzo e l'elenco intero lungo il fianco sono due risposte perfettamente
ragionevoli.
La colonna sceglie anche la forma, tonda o squadrata, perché lì ogni pulsante è un
marchio a sé. La barra no: è una fila di pulsanti e prende gli angoli impostati per tutto il sito, in
Stile, come ogni altro pulsante del tema.
Pinterest viene escluso dagli articoli senza immagine in evidenza, che è la foto che finirebbe nella
bacheca.
Il pulsante sopra l'immagine in evidenza è un'altra cosa e ha un interruttore suo: apre il pannello di
condivisione del dispositivo e, dove il browser non ne ha uno, copia l'indirizzo.
Il tuo blocco in fondo
Uno spazio in fondo a ogni articolo che contiene quello che ci scrivi tu: un'offerta referral, un modulo
per la newsletter, una comunicazione, un banner tuo — tutto ciò che il tema non prevede già. Lo trovi in
Articoli → Il tuo blocco in fondo.
Di serie è spento, e se resta vuoto non viene proprio disegnato: un interruttore acceso
senza niente dentro lascerebbe uno spazio vuoto sotto ogni articolo. Il tuo codice finisce nella pagina
così come l'hai scritto, quindi può portare classi tue da vestire dal child theme; sta dopo l'articolo e
prima dei pulsanti finali.
Quello che ci scrivi appartiene al sito, non al stile in uso: cambiando stile non te lo porta via
nessuno.
Le immagini che si aprono ingrandite
Un clic su un'immagine dentro un articolo la apre a tutto schermo sopra la pagina, con lo sfondo scuro e
il pulsante di chiusura (funziona anche Esc). Vale per le immagini che inserisci dall'editor — che da
WordPress 5 non hanno più un collegamento proprio — e per quelle che hai collegato al loro file.
Il visore mostra sempre la versione più grande che WordPress ha prodotto di
quell'immagine, non quella rimpicciolita per la colonna: così il dettaglio c'è davvero quando il lettore
va a guardare da vicino.
Restano fuori, di proposito: le immagini dentro un collegamento che porta altrove (quel collegamento va
seguito), le fotografie che appartengono ai blocchi del tema — schede prodotto, miniature delle card,
copertine dei video, sfondi dei blocchi cover — e tutto ciò che viene disegnato più piccolo di
140 px, che è un'icona e non una fotografia. Per escludere una tua immagine, dalle la classe
pls-no-lightbox.
Il visore funziona anche senza mouse: un'immagine apribile è raggiungibile con Tab, Invio o Spazio la
apre, il Tab resta dentro il visore finché è aperto ed Esc lo chiude riportando il focus sull'immagine.
La pillola sotto l'immagine in evidenza
Fra l'immagine e il testo Pulsar può mostrare un invito solo: Aggiungi <il tuo sito> come fonte
preferita su Google. Chi lo fa vede i tuoi articoli più spesso nelle notizie principali e nelle
risposte generate da Google. È attiva di serie e si governa da Articoli → Barra sotto l'immagine.
Il clic aggiunge la fonte senza portare via il lettore: resta dove stava leggendo, ed è
Google a mostrargli una breve conferma. Questo avviene con il modulo che Google pubblica apposta, non con
il suo bottone già pronto: la pillola resta quella del tema, con i colori del tema, e nelle tue pagine non
finisce nessuno script di terzi.
Quando Google viene contattato. Mai mentre si legge un articolo. Il modulo viene
scaricato la prima volta che un lettore si avvicina alla pillola — passandoci sopra, toccandola o
arrivandoci con la tastiera — che è un gesto deliberato. Col mouse il puntatore deve però fermarcisi un
istante (180 ms): la pillola sta dove il puntatore passa scendendo verso il testo, e uno sfioramento di
passaggio non deve costare un download al lettore. Le pagine senza la pillola non lo caricano mai.
Se non riesce a caricarsi — un browser vecchio, una Content Security Policy severa,
nessuna connessione — non si rompe niente: la pillola è un collegamento vero alla pagina che Google
dedica alla stessa cosa, e il clic lo segue in una nuova scheda come farebbe qualsiasi link.
Due cose da sapere, entrambe stabilite da Google. Possono essere fonti preferite solo i domini e i
sottodomini, non le sottocartelle: un sito che vive su example.com/news/ non è idoneo. E
Google non offre alcun modo per sapere se un lettore ti ha già aggiunto, quindi la pillola non può
mostrare uno stato «già aggiunto».
Per tenere la pillola senza caricare mai il modulo, restituisci false dal filtro
pulsar_google_preferred_inline: resterà un collegamento normale. Per toglierla del tutto,
spegnila in Articoli.
Il video in evidenza
Un articolo può aprirsi con un video invece che con una foto ferma. Si imposta sull'articolo, nel
riquadro Pulsar — opzioni dell'articolo, sotto l'editor: incolla l'indirizzo di un file .mp4 o
.webm, oppure un link di YouTube, oppure premi Scegli dalla libreria per prendere
un video che hai già caricato.
Accanto al campo ci sono due interruttori. Ripeti lo fa ricominciare quando finisce.
Autoplay nelle card fa girare lo stesso video dentro le card che elencano l'articolo, in home
e negli archivi; spento, le card restano la foto ferma e il video si vede solo dentro l'articolo.
La prima cosa disegnata resta comunque l'immagine in evidenza, ovunque: la pagina si dipinge con la
foto e il video prende il suo posto quando è pronto, così con una connessione lenta si vede l'articolo e
non un riquadro vuoto. Per lo stesso motivo lo script del lettore viene caricato solo sulle pagine dove
un video c'è davvero, e un articolo senza immagine in evidenza non può mostrare un video in evidenza:
è la foto a fargli da sostituto.
Un video di YouTube aspetta di essere chiesto. Riprodurne uno significa scaricare il
lettore da www.youtube.com, e quella richiesta porta con sé i cookie Google che il browser
del lettore ha già: il tema non la fa di sua iniziativa. La copertina resta l'immagine in evidenza e
mostra un pulsante play; il video parte quando il lettore lo preme, oppure subito se il banner del
consenso è acceso e il lettore ha concesso Esperienza, la finalità che riguarda i contenuti
provenienti da altre piattaforme. Un video ospitato sul tuo sito non è toccato: non contatta nessuno e
parte come prima.
Se la questione è già risolta altrove sul tuo sito — un tuo plugin per il consenso, o un pubblico per
cui non si applica — una riga nel child theme toglie l'attesa:
add_filter('pulsar_youtube_click_to_play', '__return_false');
Post di X, come schede
Con questa funzione accesa, l'indirizzo di un post di X da solo sulla sua riga viene
disegnato come una scheda del tuo sito: autore, testo, immagini, il post citato. Un indirizzo scritto
dentro una frase resta il link che hai scritto. Arriva spenta e si accende in
Shortcode e recensioni.
Non viene caricato nessuno script di X, nessun iframe, niente che segua i tuoi lettori. Il post viene
letto una volta sola, in sottofondo, quando salvi l'articolo — mai mentre qualcuno
aspetta la pagina — e il suo testo con le immagini vengono copiati sul tuo sito. Così la scheda continua
a funzionare il giorno in cui l'originale viene cancellato o reso privato, e il tuo lettore non chiede
mai niente a X.
Un riquadro nell'editor, accanto all'articolo, elenca i post di X che cita e dice quando ciascuno è stato
salvato. Il pulsante Aggiorna lo rilegge e sostituisce la copia conservata: serve per un
post modificato nel frattempo, o per uno che la prima volta non è arrivato. È l'unico momento in cui quella
schermata parla con l'esterno.
Usa un servizio esterno, una volta per post
I dati arrivano da fxtwitter.com, un servizio pubblico che risponde con il post sotto
forma di dati: nessun account, nessuna chiave. Il tuo sito lo interroga quando salvi un articolo, non
quando un lettore ne apre uno. Se smette di rispondere, le schede già salvate continuano a funzionare:
smettono solo di comparirne di nuove.
Il riquadro recensione
Ogni articolo può portare una recensione: un voto su dieci, una serie di criteri con i loro punteggi, un
verdetto con una riga di testo ed elenchi di pro e contro. Si compila sull'articolo, nel riquadro
Review. Ogni criterio è disegnato come una barra, e il numero accanto si legge in decimi oppure in percentuale: quella è l'unica scelta. Il voto complessivo è quello che
compare sulle card.
Un sito che non recensisce niente può metterla via del tutto: Shortcode e Recensioni →
Il riquadro recensione → Permetti agli articoli di portare una recensione. Da spento i campi
escono dall'editor dell'articolo, il riquadro non viene disegnato e sulle card non compare alcun
voto. Non si cancella niente: quello che era già stato scritto torna il giorno in cui lo
riaccendi.
Il riquadro arriva dal plugin Pulsar Core, come gli shortcode e per la stessa ragione:
un voto e un verdetto sono qualcosa che hai scritto tu, e quello che scrivi deve restare sui tuoi
articoli qualunque tema venga dopo. Il tema disegna il riquadro; i dati sono del plugin. Spegni il
plugin e le recensioni restano dove sono — semplicemente non vengono disegnate — e non si rompe
niente.
Avviso blocco pubblicità
Un messaggio per chi legge il sito con un blocco pubblicità attivo. Spento finché non lo accendi.
In fondo alla schermata Pubblicità. Con l'avviso acceso il tema cerca un blocco pubblicitario e
— solo quando lo trova — mostra un messaggio scritto da te: un titolo, un paragrafo e fino a due pulsanti
tuoi, ognuno con la sua etichetta e il suo indirizzo.
| Impostazione | Cosa fa |
| Mostra l'avviso | Spento, non viene stampato niente e non vengono caricati né lo script né il foglio di stile. |
| Titolo e messaggio | Parole tue. Lasciati vuoti valgono quelle del tema. |
| Pulsanti | Al massimo due: una pagina che spiega perché il sito ha la pubblicità, la tua app, un modo per scriverti. Compaiono solo quando hanno sia etichetta sia indirizzo. |
| Permetti di chiudere l'avviso | Aggiunge un link discreto per chiudere l'avviso. Spento — ed è così che il tema arriva — non c'è modo di superarlo. Accendilo, a meno che impedire la navigazione non sia proprio quello che vuoi. |
| Mai a chi ha fatto l'accesso | Spento, quindi l'avviso arriva a tutti. Acceso, viene risparmiato a chi ha effettuato l'accesso: il lettore che torna, e quello che un tuo plugin di iscrizioni tratta già in modo diverso. |
| Pagine da escludere | Un percorso per riga. Le pagine a cui l'avviso stesso manda i lettori devono restarne fuori. |
Il rilevamento non è mai certo
Il tema legge tre segnali — un elemento che ogni lista di filtri nasconde, se lo script della pubblicità è
raggiungibile, e la variabile che quello script lascia — e mostra l'avviso quando uno qualsiasi dice che
c'è un blocco. Così intercetta più lettori ma, ogni tanto, anche qualcuno che non sta bloccando niente:
è il motivo per cui conviene accendere Permetti di chiudere l'avviso. I motori di ricerca e gli
strumenti che misurano la velocità del sito vengono saltati del tutto.
Pagine
Pagine statiche, elenchi di categoria e tag, risultati di ricerca.
Tre tipi di pagina che non sono né la home né un articolo, tenuti separati perché si leggono in modo
diverso: chi arriva su una categoria cerca altro dello stesso genere, chi ha cercato sta cercando una
cosa sola. Ognuno ha le sue risposte.
| Impostazione | Che cosa fa |
| Pagine statiche | Immagine in evidenza in cima e sidebar. Una singola pagina può comunque decidere diversamente per conto suo, in Pulsar — opzioni della pagina sotto l'editor. |
| Elenchi di categoria e tag | La card — Standard, una tessera con l'immagine sopra il titolo, Elenco, un articolo per riga con immagine grande accanto al titolo e l'inizio del pezzo sotto, oppure Timeline, quelle righe appese a una linea datata, con la data scritta una volta per giorno per quanti articoli quel giorno contenga e il mese una volta dove cambia — quante ne stanno affiancate (chiesto solo per la card standard, perché un elenco è uno per riga), il numero di articoli accanto al nome, la descrizione della categoria, come si raggiunge il resto dell'elenco — un pulsante Carica altri che aggiunge il gruppo successivo sotto quelli già presenti, che è quanto il tema propone di serie, oppure le pagine numerate — e la sidebar. Accanto alle impostazioni c'è l'anteprima di una categoria vera, che le segue mentre le cambi. |
| Risultati di ricerca | Le stesse due card più una terza, Timeline: una colonna sola ordinata per l'ora di pubblicazione, lo stesso elenco che può comparire in home. Tre per riga di serie, la stessa scelta fra il pulsante e le pagine numerate, e la sidebar. Tenuti separati dagli elenchi: una ricerca è una domanda, e le sue risposte si leggono una per una. |
I valori predefiniti per tutte le pagine, e l'eccezione su ognuna.
Questa schermata imposta il comportamento generale delle pagine: se mostrano la sidebar, se stampano
l'immagine in evidenza e lo stile del titolo. Poi, su una singola pagina, il riquadro Pulsar ti permette
di decidere diversamente solo per quella — una landing page senza sidebar, per esempio, mentre tutte le
altre la mantengono.
| Opzione | Valori |
| Layout | Auto · Sidebar forzata · Tutta larghezza |
| Stile del titolo | Standard · Barra hero chiara · Barra hero scura · Nascosto |
| Immagine in evidenza | Predefinito · Mostra · Nascondi |
Social & Promo
I tuoi profili, il banner dell'app e il riquadro della newsletter.
Profili social
Un indirizzo per ogni rete. Una rete di cui non indichi l'indirizzo compare lo stesso, ma punta alla home
del social e non mostra nessun numero di follower: il tema non inventa mai dei numeri.
Stile dei pulsanti
Come vengono disegnati i pulsanti social, ovunque il tema li disegni: la riga accanto all'hero nei layout
B e C e il widget Social. Sotto la scelta due esempi mostrano l'aspetto di ciascuno stile.
- Minimal — il pulsante del tema: superficie chiara, marchio nel colore della rete e
numero di follower accanto. È quello con cui parte un'installazione nuova.
- Flat — il pulsante riempito con il colore della rete, marchio bianco su un quadrato
più scuro all'inizio e numero di follower in fondo. Ogni rete è riempita con un gradiente: il suo
colore che si scurisce verso il lato dove sta il numero, e per Instagram i quattro punti con cui è
disegnato il suo marchio. Le tre che hanno il marchio nero portano invece un colore — un pulsante
riempito di nero sarebbe un buco nella pagina — e X è quella che tiene il grigio scuro.
Pulsanti per riga decide se stanno due affiancati, come in un'installazione nuova, o uno
per tutta la larghezza della colonna in cui si trovano.
Banner dell'app
Un blocco promozionale per un'app iOS: icona, nome, slogan, pulsante App Store, valutazione e numero di
valutazioni, con due iPhone disegnati in CSS. È acceso di default, così il blocco si
vede da subito, con segnaposto grigi al posto dell'icona e degli screenshot finché non metti i tuoi.
Da solo non esce niente dal tuo server: l'interruttore che legge da Apple arriva spento.
- Incolla l'indirizzo App Store della tua app. Senza, viene disegnato tutto tranne il
pulsante, che non porterebbe da nessuna parte.
- Accendi Leggi i dati dell'app automaticamente per far leggere icona,
valutazione e numero di valutazioni dall'endpoint pubblico iTunes di Apple: appena scrivi
l'indirizzo e una volta a settimana, mai mentre un visitatore sta caricando la pagina.
- Oppure lascialo spento e compila tu quei tre campi: con la lettura spenta il banner
mostra esattamente quello che scrivi.
- Aggiungi i due screenshot, verticali, circa 588×1280. Un telefono senza immagine
tiene la sua forma e mostra uno schermo grigio chiaro.
- Spegni il blocco da Usa il banner app se il tuo sito non ha un'app.
Newsletter
Il tema disegna il riquadro; un plugin raccoglie gli indirizzi. È una divisione voluta: raccogliere
un'email significa conservare dati personali, mandare la conferma e onorare le cancellazioni, e questo
deve sopravvivere a un cambio di tema.
- Installa un plugin per la newsletter. La schermata riconosce MC4WP, Newsletter,
MailPoet, Brevo e FluentCRM e ti dice quali sono installati, ma va bene qualunque plugin.
- Incolla il suo shortcode nel campo Shortcode del modulo.
- Scrivi i testi — occhiello, titolo, testo, nota.
Finché non c'è uno shortcode il blocco non viene mostrato ai visitatori: un riquadro di iscrizione che
non raccoglie niente è peggio di nessun riquadro. Come amministratore vedi comunque una riga che spiega
perché.
Pubblicità
Sei zone nel pannello — tre delle quali dentro l'articolo — più un widget per la sidebar. Arrivano tutte spente.
Il tema non porta nessun markup pubblicitario suo: una zona rende esattamente quello che
incolli, e se il campo è vuoto non viene stampato niente — nessun contenitore, nessuna etichetta
«Pubblicità», nessuna altezza riservata.
| Zona | Dove appare |
| Home · sopra la griglia | Fra l'hero e la griglia della homepage. |
| Home · in-feed | Come card fra gli articoli della griglia. |
| Articolo · sopra il titolo | In cima, prima della categoria e del titolo. |
| Articolo · in alto | Subito dopo il primo paragrafo. |
| Articolo · a metà | Dopo il quarto paragrafo, se l'articolo è abbastanza lungo. |
| Articolo · in fondo | Alla fine del contenuto. |
| Sidebar | Non è una zona del pannello: è il widget Pulsar: Spazio pubblicitario. |
Con AdSense
Metti il tuo ID publisher (ca-pub-…) in Integrazioni e il tema
inserisce il loader una volta sola, nel punto giusto. Da lì in poi puoi incollare in una zona solo il
blocco <ins>. Gli slot vengono richiesti solo quando hanno una larghezza e sono vicini
alla finestra, e uno slot che il circuito non riempie si chiude invece di lasciare un riquadro vuoto con
l'etichetta.
SEO
Basta a se stesso, e tace se usi un plugin.
Pulsar emette meta description, Open Graph e Twitter card, direttive robots, link canonici e dati
strutturati JSON-LD per articoli, briciole di navigazione e la tua organizzazione. Se sono attivi
Yoast, Rank Math, SEOPress o All in One SEO, il tema si fa da parte e lascia fare al
plugin: non c'è niente da configurare perché succeda.
Cosa compilare
- Nome e logo dell'organizzazione — usati nei dati strutturati di ogni pagina.
- Paese e di cosa parla il sito — entrambi facoltativi, ed entrambi lasciati vuoti di
proposito: un paese che non hai scelto sarebbe sbagliato su ogni sito tranne uno.
- Profili social ufficiali — l'elenco
sameAs che lega i tuoi account al
tuo sito.
- Pagine delle policy editoriali — per Google News, se le hai.
Il link canonico viene emesso dove WordPress non lo fa da sé, e la pagina due di un archivio
è canonica verso sé stessa, mai verso la prima: contengono articoli diversi, e puntarle allo stesso
indirizzo chiede a Google di ignorare tutto quello che viene dopo la prima pagina.
Con chi parla il tema
Ogni server che questo tema può contattare, quando, e se gliel'hai chiesto tu.
Un'installazione appena fatta non parla con nessuno. Ognuna delle richieste qui sotto
viene da una funzione che è spenta finché non la accendi, oppure che hai avviato tu premendo un pulsante.
Nessuna avviene mentre un lettore sta leggendo una pagina, tranne quelle che configuri tu: la tua rete
pubblicitaria, le tue statistiche.
| Dove | Per cosa | Quando |
api.fxtwitter.com | Leggere un post di X citato in un articolo, per disegnarlo come scheda. | Solo con Post di X acceso. Una volta per post, quando salvi l'articolo o premi Aggiorna: mai mentre un lettore aspetta. |
itunes.apple.com | Nome, icona e voto di un'app, per lo shortcode [app] e il banner app. | Solo dove li usi. La risposta viene messa in cache, quindi si chiede una volta e non a ogni lettore. |
www.ispazio.net | Le fotografie dei contenuti demo; e la registrazione della tua copia del tema. | Solo se scegli di importare gli articoli demo sul sito, utili se devi iniziare un sito da zero — e quando registri. La registrazione è facoltativa e non sblocca niente. |
pagead2.googlesyndication.com | Verificare se lo script della pubblicità è raggiungibile, per l'avviso sul blocco pubblicitario. | Solo con l'avviso acceso, nel browser del lettore. Non viene inviato niente: la richiesta serve a vedere se fallisce. |
Quello che aggiungi tu è tuo
AdSense, Analytics, Tag Manager, un video di YouTube, un font di Google: arrivano al lettore perché ce li
hai messi tu, e il tema non li aggiunge né li toglie. A governarli è il banner di consenso in
Privacy e cookie.
Ognuno si può dirottare altrove o spegnere
Gli indirizzi passano da filtri — pulsar_registration_endpoint,
pulsar_demo_media_url — e le funzioni che li usano hanno un interruttore. Un tema che telefona
a casa dev'essere un tema che puoi fermare.
Privacy e cookie — consenso GDPR
Un banner di consenso GDPR integrato nel tema. Spento di default, perché è una decisione legale.
Quando lo accendi, i visitatori vedono un banner e un pannello delle preferenze con quattro finalità —
funzionalità, esperienza, misurazione, marketing — più quelle strettamente necessarie, che non si possono
spegnere. Consent Mode v2 parte con tutto negato e viene aggiornato con la scelta del lettore, conservata
in un cookie per 180 giorni. Non viene inviato niente a nessuno: è un gestore di consenso, non un
servizio.
La pubblicità non viene mai trattenuta
Finché il lettore non sceglie, gli annunci vengono serviti non personalizzati invece che messi in
pausa, e lo spazio si riempie lo stesso. «Non personalizzati» significa che Google non usa il profilo del
lettore per scegliere l'annuncio, non che non venga scambiato niente: Google riceve comunque l'indirizzo
della pagina e l'indirizzo IP, e può comunque posare cookie tecnici per il limite di frequenza, i rapporti
e l'antifrode. Una richiesta trattenuta spesso non riparte più, e un annuncio che rende meno vale comunque
più di un buco nella pagina.
Un limite, detto in chiaro
Per gli annunci Google mostrati in SEE, Regno Unito e Svizzera, Google richiede una piattaforma di
gestione del consenso certificata da Google e conforme allo IAB TCF. Questo banner non lo è.
Senza una CMP certificata, in quelle aree gli annunci semplicemente non escono. Se è lì il tuo traffico,
usa una CMP certificata e lascia spento questo banner. Questo è un riassunto scritto da sviluppatori, non
una consulenza legale.
Integrazioni
Google Analytics 4 e AdSense, e nient'altro.
| Campo | Dove si trova |
ID di misurazione GA4 (G-…) | Google Analytics → Amministrazione → Flussi di dati → il tuo flusso. |
ID publisher AdSense (ca-pub-…) | AdSense → Account → Informazioni sull'account. |
- Consent Mode v2 — accendilo se hai traffico europeo: è quello che fa funzionare
davvero un banner di consenso.
- Anonimizza l'IP — manda
anonymize_ip insieme al tag. Una proprietà GA4
tronca già l'indirizzo alla raccolta e lo ignora; è l'impostazione che conta se punti il campo a una
vecchia proprietà Universal Analytics.
Tutto quello che sta in questa schermata manda dati a qualcun altro. Niente è attivo finché
non compili un campo: con l'ID di misurazione vuoto il tema non stampa nessun tag di Analytics. Compilalo
e il tag esce nell'<head>, dopo che il banner del consenso ha detto la sua.
Shortcode
Undici blocchi per i tuoi articoli e le tue pagine, forniti dal plugin Pulsar Core.
La schermata Shortcode (plugin) del pannello — si chiama così perché gli shortcode arrivano dal plugin Pulsar Core, non dal tema — li elenca tutti, ognuno con il suo interruttore, un esempio
da copiare e un'anteprima dal vivo in larghezza desktop e mobile. C'è anche un interruttore generale: con
quello spento nessuno shortcode viene disegnato e il loro foglio di stile non viene mai inviato.
Le immagini vengono chieste alla misura in cui si vedono
Incolla l'indirizzo di un'immagine della tua libreria e il plugin risale all'allegato e sceglie la più
piccola misura generata che copre lo spazio — al doppio della misura CSS, perché gli schermi sono retina.
Un originale da 308 KB diventa un'icona da 4 KB. Un indirizzo di un altro sito resta esattamente com'è.
[app]
L'unico blocco che legge da fuori il tuo sito
L'endpoint pubblico di Apple, per nome, icona e prezzo. È acceso, perché una scheda scritta da un autore
deve disegnarsi — ed essere acceso non costa niente: ad Apple si chiede qualcosa solo quando qualcuno
apre un articolo che usa davvero questo shortcode. Ogni altra pagina del sito, e un sito senza articoli
del genere, non chiama nessuno. Quello che torna resta in cache per una settimana e l'icona viene
copiata nella tua cartella dei caricamenti. Se preferisci che non succeda mai, lo spegni in
Shortcode, sulla sua card.
Una scheda per un'app iOS: icona, nome, sviluppatore e un pulsante. Con il solo ID legge nome,
sviluppatore, prezzo e icona dall'endpoint pubblico di Apple e li tiene in cache per una settimana.
[app id="331441694"]
L'ID è il numero nell'indirizzo dell'App Store. Puoi sovrascrivere qualunque dato scrivendolo:
name, developer, price, icon_url,
rating, ratings, link.
[product]
Una scheda prodotto: foto, titolo, prezzo, prezzo precedente, un badge e un pulsante. Nessuna API,
nessuna chiave, niente che si aggiorni da solo: mostra quello che scrivi, che è anche ciò che i programmi
di affiliazione chiedono di un prezzo dichiarato.
[product img="https://esempio.it/foto.jpg" title="Cuffie in-ear con cancellazione attiva del rumore"
price="199,00 €" full_price="249,00 €" badge="Minimo storico" link="https://esempio.it/offerta"]
Una breve descrizione del prodotto, fra i tag.
[/product]
Lo sconto lo calcola il tema dai due prezzi: la percentuale non la scrivi. Vengono
capiti sia 1.299,99 sia 1,299.99. Il link è marcato
sponsored.
[read] e [read-also]
Lo stesso blocco in due modalità. [read] vuole gli ID degli articoli e costruisce la
card dall'articolo stesso; [read-also] è la versione manuale, per un articolo che sta
altrove.
[read]2261096[/read]
[read]2261096, 2261094[/read]
[read-also title="Un articolo su un sito esterno" subtitle="Una descrizione facoltativa del link"
img="https://esempio.it/foto.jpg" link="https://esempio.it/articolo"]
Quale forma ottieni dipende dal tag, non da quanti ID scrivi:
| Se scrivi | Ottieni |
[read], un ID | La fascia piena: immagine grande, titolo, descrizione. |
[read], più ID | La stessa fascia piena, ripetuta per ogni articolo. |
[read-also], un ID | La fascia piena — una lista di uno non è una lista. |
[read-also], più ID | La lista compatta: miniature più piccole, senza descrizione. |
Quindi usa [read] quando ogni articolo merita il suo spazio, e [read-also]
quando sono una fila di link correlati in coda a un paragrafo.
[section-title]
[section-title]Il nostro verdetto sul prodotto[/section-title]
[button] e [menu-button]
Una riga a tutta larghezza che funziona da link, con un'icona o un'immagine.
[menu-button] è la stessa cosa senza cornice, per una lista di link.
[button label="Guida" title="Come si configura" subtitle="In dieci minuti"
icon="https://esempio.it/icona.svg" link="https://esempio.it/guida"
mobile="Riga breve mostrata sui telefoni"]
La descrizione più lunga, fra i tag.
[/button]
[tabnav]
Una riga di schede. Le voci sono un attributo, separate da virgole, e current conta
da zero.
[tabnav titles="Introduzione, La prova, I numeri, Il verdetto" current="0"]
Le schede diventano link aggiungendo link, un indirizzo per voce, nello stesso ordine e
separati da virgole allo stesso modo; con target="_blank" si aprono in una scheda nuova.
Con images ogni scheda prende una piccola immagine accanto alle parole, sempre una per
voce. style sceglie l'aspetto: light (quello di serie), dark,
flat-light o flat-dark. Un titolo fra doppie graffe viene stampato in
grassetto — {{Il verdetto}}.
[tabnav titles="Introduzione, La prova, {{Il verdetto}}"
link="/introduzione, /prova, /verdetto"
images="https://esempio.it/a.svg, https://esempio.it/b.svg, https://esempio.it/c.svg"
style="dark" current="2" target="_blank"]
[horizontal-menu]
Una riga di schedine che scorre di lato, con una dissolvenza sul bordo destro così si capisce che
continua.
[horizontal-menu name1="Telefoni" link1="/telefoni" img1="https://esempio.it/1.svg"
name2="Tablet" link2="/tablet" img2="https://esempio.it/2.svg"]
Fino a dieci voci. L'immagine è img1, img2 e così via; image1 è
accettato ugualmente. Con new1="Novità" la voce prende un badge.
[video]
Un lettore video con fotogramma di anteprima. La sorgente va fra i tag, non in un
attributo. L'anteprima è img; poster è accettato ugualmente. Aggiungendo anche
name e description il video viene descritto ai motori di ricerca.
Un video che parla dovrebbe portare i suoi sottotitoli: captions prende l'indirizzo di un
file WebVTT e il lettore li offre. captions_lang dice in che lingua sono (quella del sito
se lo ometti) e captions_label come si chiamano nel menu.
[video img="https://esempio.it/poster.jpg" controls="yes"
captions="https://esempio.it/sottotitoli.vtt" captions_lang="it"]
https://esempio.it/video.mp4
[/video]
[video img="https://esempio.it/poster.jpg" name="Il titolo" controls="yes"]
https://esempio.it/video.mp4
[/video]
[timed-content]
Contenuto che resta nascosto fino a un momento che scegli tu: dentro ci può stare qualunque cosa, testo,
un'immagine, un video, un iframe, un liveblog. Il fuso orario va in fondo alla data, nella forma del
database.
[timed-content show="2026-06-08 16:00 Europe/Rome"]
Quello che compare a quell'ora.
[/timed-content]
Se non scrivi il fuso, viene usato quello del sito.
Lingua
La lingua del pannello, e import ed export delle traduzioni.
Pulsar è distribuito in inglese e italiano. Questa schermata imposta la
lingua del solo pannello: il sito segue WordPress, ed è quello che vuoi — tenere il pannello
nella tua lingua non deve mettere in quella lingua l'intero sito.
- Esporta ti dà un file
.po del catalogo inglese, da consegnare a un
traduttore o a un'AI.
- Importa riprende un
.po o un .mo, lo compila e lo salva in
wp-content/languages/themes/ — fuori dal tema, così sopravvive agli
aggiornamenti. Le voci lasciate non tradotte vengono scartate invece che salvate vuote.
Lingue con più di due forme plurali
Il file esportato porta la regola inglese. Per russo, polacco, arabo e simili vanno impostati
Plural-Forms nell'intestazione e tutte le msgstr[n]. L'intestazione che carichi
viene conservata.
Info sul tema
Versione, crediti e registrazione della tua copia.
Registrare è facoltativo e non sblocca niente. Il tema si comporta in modo identico che
tu registri o no; serve solo ad avere il tuo purchase code in mano quando chiedi assistenza.
- Trova il tuo purchase code nei download di ThemeForest, sotto Licence
certificate & purchase code.
- Incollalo nel campo e premi Registra.
Un secondo passaggio, facoltativo. Quando il codice è stato verificato con la
vendita, la schermata mostra un pulsante Conferma con Envato. Ti porta su Envato, accedi con
il tuo account e torni con una spunta verde che dice due cose: il codice d'acquisto è stato verificato,
e questa copia è tua. Serve perché un codice d'acquisto non è un segreto — chiunque ne avesse una copia
potrebbe altrimenti intestarsi la tua registrazione — e permette di distinguere chi possiede la licenza
da chiunque altro. Come la registrazione, non condiziona nulla: una copia mai confermata mantiene tutte
le funzioni. A Envato chiediamo il nome del tuo account e nient'altro.
Cosa viene inviato, e solo quando premi quel pulsante: il purchase code, l'indirizzo e il nome del sito,
l'email dell'amministratore, la versione del tema, le versioni di WordPress e PHP e la lingua. Se il
nostro server non risponde, il codice viene salvato lo stesso e la consegna viene riprovata da sola —
dopo un'ora, poi a qualche ora di distanza, poi una volta al giorno, per circa una settimana — finché non
arriva. Un nostro server giù non è un problema tuo. Finché non è arrivata, il pannello scrive Non
ancora consegnata invece di Registrata, e la scheda Crediti porta un pulsante per
riprovare subito.
Rimuovere il codice. Rimuovi il codice da questo sito lo cancella qui e
chiede al nostro server di ritirare la registrazione: l'indirizzo del sito, il suo nome, l'email
dell'amministratore e l'indirizzo di rete vengono eliminati dai nostri archivi, e restano solo il
purchase code e la data, così sappiamo che la registrazione c'è stata ed è stata ritirata.
L'indirizzo di rete viene comunque conservato senza la sua ultima parte, quindi non identifica mai
una singola connessione. Quel che resta di una registrazione ritirata — un purchase code e due date
— viene cancellato dopo un anno. Su richiesta cancelliamo qualunque riga: basta scriverci.
Dimensioni immagine
Cosa genera il tema, e cosa conviene caricare.
| Nome | Misura | Usata da |
| pulsar-hero | 1200 × 675 | L'hero e l'immagine in evidenza di un articolo. |
| pulsar-main | 864 × 486 | Le card grandi. |
| pulsar-card | 600 × 338 | Le card standard. |
| pulsar-card-sm | 300 × 169 | Card piccole e telefoni. |
| pulsar-list | 220 × 124 | Le miniature delle liste. |
| pulsar-list-sm | 110 × 62 | Le liste compatte. |
| pulsar-stories | 220 × 220 | La riga delle stories, quadrata. |
Carica a 1600 pixel di larghezza o più, in 16:9
WordPress può solo rimpicciolire, mai ingrandire. Un'immagine più stretta di una misura semplicemente non
l'avrà, e il tema ripiegherà su qualcosa di più grande e pesante.
Tradurre il sito
Sono due cose diverse, spesso confuse.
- Tradurre le parole del tema — «Leggi di più», «commenti», le etichette attorno ai
tuoi contenuti. Si fa con l'import e l'export in Lingua.
- Avere il sito in più lingue — è il lavoro di un plugin multilingua (WPML, Polylang e
simili). Pulsar usa ovunque le funzioni standard di WordPress, quindi quei plugin funzionano, ma il
tema non lo fa da solo.
Filtri per sviluppatori
Gli agganci che il tema espone, per il functions.php di un child theme.
| Filtro | Cosa cambia |
pulsar_layout_presets | Aggiungi un tuo stile, o modifica uno di quelli inclusi. |
pulsar_demo_content | Le categorie e i titoli che l'importatore demo crea. |
pulsar_most_viewed_ids | Restituendo un array di ID prendi in carico interamente il widget «Più letti». |
pulsar_shortcode_catalog | L'elenco degli shortcode mostrato nel pannello. |
pulsar_load_shortcode_styles | Forza il foglio di stile degli shortcode, per uno shortcode usato in un widget. |
pulsar_card_title_max | Quanto può essere lungo il titolo di una card prima di essere tagliato. |
pulsar_related_excluded_categories | Categorie da tenere fuori dagli «Articoli correlati». |
pulsar_hide_ads | Restituisci true per nascondere ogni zona pubblicitaria in una richiesta. |
pulsar_ads_excluded_paths | I percorsi dove la pubblicità non viene mai stampata. |
pulsar_app_store_lookup | I dati letti dall'App Store, prima che vengano usati. |
pulsar_registration_endpoint | Dove viene inviata la registrazione: cambialo, o puntalo nel vuoto. |
pulsar_default_grid_chip_rows | I chip proposti su un sito che non li ha mai salvati. |
pulsar_resource_hint_domains | I domini a cui preconnettersi. |
pulsar_redirect_author_feeds | Restituendo true, tutti i feed degli autori vengono mandati a quello principale. Spento: /author/nome/feed/ funziona come vuole WordPress. |
pulsar_strip_elementor | Se smontare i wrapper di Elementor rimasti in un articolo. Falso finche' Elementor e' installato, cosi' il tema non tocca mai un page builder attivo; vero quando e' stato rimosso, per ripulire quello che ha lasciato. |
pulsar_legacy_feed_slugs | Slug di categorie o tag ritirati il cui feed deve finire su quello principale. Vuoto. |
pulsar_share_networks | Quali reti offre la riga di condivisione, e in che ordine. |
pulsar_social_networks | L'elenco dei profili social che il pannello chiede. |
pulsar_supports_dark_mode | Restituisci true e il tema disegna il suo aspetto scuro. |
pulsar_speakable_selectors | Le parti di un articolo che un assistente vocale deve leggere. |
pulsar_load_more_partials | I partial di card che l'endpoint «Carica altri» può disegnare. |
pulsar_load_more_html | Il markup del pulsante «Carica altri». |
pulsar_header_supports | Che cosa ogni disposizione dell'header può mostrare. |
pulsar_icon_tints | I colori con cui vengono tinte le icone del pannello. |
pulsar_dns_prefetch_domains | Domini da risolvere in anticipo, oltre a quelli che il tema conosce. |
pulsar_lean_landing_templates | I template di pagina serviti con l'elenco ridotto di fogli di stile. |
pulsar_no_hero_preload_templates | I template di pagina in cui l'immagine dell'hero non viene precaricata. |
pulsar_demo_media_url | Da dove vengono scaricate le fotografie dei contenuti demo. |
pulsar_core_plugin_package | Da dove viene preso lo zip di Pulsar Core quando lo si installa. |
pulsar_support_email | L'indirizzo a cui scrive la schermata Supporto. |
pulsar_theme_page_url | L'indirizzo della pagina del tema collegata dal pannello. |
pulsar_user_menu_cacheable | Se il menu utente può essere servito da una cache. |
pulsar_affiliate_partners | I negozi che lo shortcode del prodotto sa collegare. |
C'è anche un'azione, pulsar_preset_applied, che scatta subito dopo l'applicazione di un
stile.
Domande frequenti
Ho attivato il tema e la homepage sembra un blog, non la demo.
La homepage si compone a blocchi e parte da una configurazione ragionevole. Applica uno stile
(Stili) e, su un sito nuovo, importa i contenuti demo.
Gli shortcode vengono stampati come testo nei miei articoli.
Il plugin Pulsar Core non è attivo. Installalo dal pacchetto, oppure usa il pulsante Installa il
plugin nella schermata Shortcode.
Le immagini si vedono sfocate, o le pagine sono pesanti.
Le immagini caricate prima dell'installazione del tema non hanno le misure che lui chiede. Esegui una
volta Regenerate Thumbnails: la schermata Prestazioni ti dice se ti serve.
Ho cambiato un'impostazione e il sito è identico.
Tre motivi soliti, nell'ordine in cui conviene controllarli:
- Non hai ancora premuto Salva le impostazioni. La barra in fondo al pannello
è ancora lì.
- Una cache di pagina sta servendo l'HTML vecchio. Svuotala dopo aver salvato.
- Il critical CSS è ancora quello di prima. Se lo hai acceso, dentro ogni pagina viene
stampata una porzione di foglio di stile, ed è una fotografia del tema com'era quando è stato
generato: finché non viene rifatto, la prima cosa che il visitatore vede è dipinta con le regole
vecchie. Si rigenera da solo mentre sei nell'amministrazione — al massimo una volta ogni quindici
minuti — oppure subito da Prestazioni → Genera.
Se usi entrambe le cose, l'ordine conta
Prima rigenera il critical CSS, poi svuota la cache di pagina: il critical CSS viaggia dentro l'HTML,
quindi una cache svuotata prima della rigenerazione si limita a memorizzare di nuovo quello vecchio.
Se cambio tema, che fine fanno le mie impostazioni?
Restano nel database, intatte. Torni a Pulsar e le ritrovi tutte. Anche gli shortcode continuano a
funzionare con un altro tema, perché vivono nel plugin.
Posso usarlo su più di un sito?
Lo stabilisce la licenza che hai comprato su ThemeForest, non il tema. Una licenza regular copre un
prodotto finale.
Il numero di commenti sulle card per un istante è sbagliato.
Viene aggiornato dopo il caricamento della pagina, così l'HTML può stare in cache. Il numero che vedi per
primo è quello della pagina in cache; un istante dopo è quello vero.
Licenze e crediti
Il PHP eredita la GNU GPL v2 o successiva, perché estende WordPress. Fogli di stile, script, immagini e
design sono coperti dalla licenza che hai accettato acquistando il tema, che definisce quante
installazioni puoi farne e cosa non puoi redistribuire. Assistenza e aggiornamenti arrivano dal canale
d'acquisto.
Lavoro di terze parti incluso
| Componente | Cosa fa | Licenza |
| SortableJS | Il riordino per trascinamento nel pannello. | MIT |
| Inter, Geist, DM Sans, Nunito, Open Sans, Lato, Poppins, Montserrat | I font inclusi, ospitati sul tuo sito. | SIL Open Font Licence |
| Le icone | Disegnate per questo tema. | Parte del tema. |
Servizi esterni, e cosa esce dal tuo sito
Il tema può fare esattamente due chiamate fuori dal tuo server, entrambe facoltative ed entrambe
dichiarate in readme.txt: l'endpoint pubblico iTunes di Apple, per il banner dell'app e lo
shortcode [app]; e il nostro endpoint di registrazione, solo quando premi
Registra.
La registrazione della tua copia
Finché non premi Registra non parte niente. Quando lo premi, a ispazio.net va
esattamente questo, e nient'altro:
- il codice d'acquisto che hai scritto;
- l'indirizzo e il nome di questo sito;
- l'indirizzo email dell'amministratore;
- nome e versione del tema, versioni di WordPress e PHP, lingua del sito.
Serve a due cose: verificare l'acquisto con Envato e raggiungerti per aggiornamenti e correzioni di
sicurezza. Resta finché la licenza è in uso, perché è a questo che serve il record. Il tuo indirizzo di
rete non viene mai conservato intero: l'ultima parte viene tolta prima di scriverlo, così non
identifica nessuno.
Puoi riprendertelo. Premi Rimuovi il codice da questo sito, in
Pulsar → Crediti, e il sito chiede al server di ritirare la registrazione: indirizzo del sito,
nome, email dell'amministratore e indirizzo di rete vengono cancellati subito, e quello che resta — un
codice d'acquisto e due date — viene eliminato un anno dopo. Oppure scrivi a
ispazio@gmail.com e chiedilo.
L'indirizzo a cui il tema parla si può cambiare, o spegnere del tutto, con il filtro
pulsar_registration_endpoint: un tema che chiama casa dev'essere un tema che puoi
dirottare altrove.
Social & Promo
I tuoi profili, il banner dell'app e il riquadro della newsletter.
Profili social
Un indirizzo per ogni rete. Una rete di cui non indichi l'indirizzo compare lo stesso, ma punta alla home del social e non mostra nessun numero di follower: il tema non inventa mai dei numeri.
Stile dei pulsanti
Come vengono disegnati i pulsanti social, ovunque il tema li disegni: la riga accanto all'hero nei layout B e C e il widget Social. Sotto la scelta due esempi mostrano l'aspetto di ciascuno stile.
Pulsanti per riga decide se stanno due affiancati, come in un'installazione nuova, o uno per tutta la larghezza della colonna in cui si trovano.
Banner dell'app
Un blocco promozionale per un'app iOS: icona, nome, slogan, pulsante App Store, valutazione e numero di valutazioni, con due iPhone disegnati in CSS. È acceso di default, così il blocco si vede da subito, con segnaposto grigi al posto dell'icona e degli screenshot finché non metti i tuoi. Da solo non esce niente dal tuo server: l'interruttore che legge da Apple arriva spento.
Newsletter
Il tema disegna il riquadro; un plugin raccoglie gli indirizzi. È una divisione voluta: raccogliere un'email significa conservare dati personali, mandare la conferma e onorare le cancellazioni, e questo deve sopravvivere a un cambio di tema.
Finché non c'è uno shortcode il blocco non viene mostrato ai visitatori: un riquadro di iscrizione che non raccoglie niente è peggio di nessun riquadro. Come amministratore vedi comunque una riga che spiega perché.