Wiki Arkadia
Procedure operative del team. Non condividere questo link.
Generale
Noleggio
POST PRODUZIONE
Sito
Generali
Nessuna procedura trovata.
Regola d’oro
Sempre un backup prima di qualsiasi aggiornamento. Un aggiornamento mal riuscito può rompere il sito in pochi secondi.
Procedura consigliata
- Backup completo — file + database (vedi procedura “Backup del sito”)
- Aggiorna i plugin uno alla volta — WP Admin → Plugin → Aggiornamenti disponibili
- Dopo ogni aggiornamento plugin: controlla che il sito funzioni ancora
- Aggiorna il tema padre GeneratePress (se disponibile)
- Aggiorna WordPress core per ultimo — WP Admin → Bacheca → Aggiornamenti
- Controlla homepage, pagine di servizio, editor blocchi
Non aggiornare mai
- Il tema figlio generatepress-child — è sviluppato su misura, gli aggiornamenti non esistono
- Plugin sviluppati su misura per Arkadia — stessa ragione
Se un aggiornamento rompe qualcosa
- Ripristina il backup
- Disattiva il plugin appena aggiornato
- Segnala il problema al fornitore del plugin e attendi una versione corretta
Percorso
WP Admin → Lavori → Aggiungi nuovo
Campi da compilare
| Campo | Dove | Note |
|---|---|---|
| Titolo | In cima alla pagina | Nome del progetto |
| Tipo lavoro | Sidebar destra → Tipo Lavoro | Content / Commercial / Cinema & Docu |
| Immagine in evidenza | Sidebar destra | Usata come thumbnail in griglia |
| URL Video | ACF → Video URL | Link YouTube o Vimeo — diventa il video principale |
| Crew | ACF → Crew | Un membro per riga: Nome — Ruolo |
| Link aggiuntivi | ACF → Link 1/2/3 | Opzionali — link esterni correlati al progetto |
Galleria foto
Le foto del progetto si aggiungono nel corpo della pagina con il blocco Galleria (blocco Gutenberg custom Arkadia). Proporzioni consigliate: 16:9 o 4:3.
Pubblicazione
Imposta lo stato su Pubblicato dalla sidebar destra. Il lavoro apparirà automaticamente nella sezione “Ultimi Lavori” della homepage (se tra i 4 più recenti) e nella pagina /lavori/.
Cosa includere in un backup completo
- Database — contiene tutti i contenuti, pagine, impostazioni
- Cartella wp-content — contiene tema, plugin, media caricati
Con plugin (metodo più semplice)
Plugin consigliati: UpdraftPlus (gratuito) o Duplicator.
- Installa e attiva UpdraftPlus
- WP Admin → Impostazioni → UpdraftPlus Backups
- Clicca Esegui backup ora
- Scarica i file generati (database + files) e conservali in un posto sicuro
Puoi configurare backup automatici su Google Drive, Dropbox o email.
Prima di ogni aggiornamento importante
Fai sempre un backup manuale prima di aggiornare WordPress, plugin o il tema. Un backup recente è l’unica salvezza in caso di problemi.
Ripristino
Con UpdraftPlus: WP Admin → Impostazioni → UpdraftPlus → scheda “Backup esistenti” → clicca Ripristina accanto al backup desiderato.
Colore tab bar (per singola voce)
WP Admin → Aspetto → Personalizza → Floating Tab Bar → [voce] → Colore attivo
Usa il color picker. Lascia vuoto per il colore di default.
Colore accent globale del sito
Il colore principale è #EA0909 (rosso scuro). È definito in due posti:
- File CSS —
wp-content/themes/generatepress-child/style.css(richiede accesso FTP o File Manager) - Database — nei contenuti delle pagine (blocchi Gutenberg salvano il colore come attributo JSON)
Per cambiarlo ovunque in una volta sola, usa WP-CLI:
wp search-replace '#EA0909' '#NUOVOCOLORE' wp_posts
wp search-replace '#EA0909' '#NUOVOCOLORE' wp_options
⚠ Poi modifica anche il file style.css manualmente per le regole CSS che non sono nei blocchi.
Colori specifici per pagina
Alcune pagine hanno un colore accent diverso (es. Noleggio usa #df7d2d, Ecosystem usa #1A6B8A). Questi sono impostati blocco per blocco nel contenuto della pagina — si modificano dall’editor di quella pagina, campo Colore accent in ogni blocco.
Palette ufficiale Arkadia
| Ruolo | Colore |
|---|---|
| Accent principale | #EA0909 |
| Accent Noleggio | #df7d2d |
| Accent Ecosystem | #1A6B8A |
| Accent Arkadia Lab | #00C896 |
| Sfondo | #000000 |
| Testo principale | #ffffff |
| Testo secondario | #999999 |
Cos’è uno slug
Lo slug è la parte dell’URL dopo il dominio. Es. per arkadiastudios.it/produzione-video/ lo slug è produzione-video.
Dove si cambia
WP Admin → [Pagina] → Modifica → Permalink (sotto il titolo) → clicca per modificare.
⚠ Conseguenze del cambio slug
Cambiare uno slug rompe i link interni se non vengono aggiornati.
| Cosa si rompe | Come sistemarlo |
|---|---|
| Link nella Tab Bar | WP Admin → Aspetto → Personalizza → Floating Tab Bar → [voce] → URL |
| Link nei blocchi CTA delle pagine | Modifica ogni pagina e aggiorna i campi URL nei blocchi CTA Band e Pulsanti |
| Link nel footer | WP Admin → Aspetto → Personalizza → Footer Arkadia |
| Link da Google (SEO) | Aggiungi un redirect 301 dal vecchio URL al nuovo |
Redirect 301 (SEO-safe)
Installa il plugin Redirection (gratuito) → WP Admin → Strumenti → Redirection → Aggiungi nuovo redirect:
URL sorgente: /vecchio-slug/ → URL destinazione: /nuovo-slug/ → tipo 301.
Panoramica
Il sito genera PDF in due punti distinti. Capire la differenza è importante soprattutto al momento del lancio, perché ognuno legge il logo e i dati da una fonte diversa.
| Chi lo genera | Libreria | Logo | |
|---|---|---|---|
| Ordine di Noleggio | Plugin Arkadia Noleggio | mPDF (gratuito) | Impostazioni Noleggio in WP Admin |
| Catalogo Attrezzatura | Tema (inc/pdf-catalogo.php) | DOMPDF (gratuito) | File img/logo-arkadia-hd.png nel tema |
Entrambe le librerie sono open source e girano sul server: non ci sono costi per generazione o per numero di PDF prodotti.
PDF Ordine di Noleggio
Come si genera
Dalla scheda di un ordine (WP Admin → Ordini Noleggio → apri ordine), clicca Esporta PDF nella sidebar destra. Si apre un modal con i dati del cliente: compilali (o modificali) e clicca Genera PDF. Il PDF si apre in una nuova scheda.
💡 I dati inseriti nel modal non vengono salvati nell’ordine — servono solo per quella generazione. Puoi produrre più versioni PDF con dati cliente diversi dallo stesso ordine.
Cosa contiene il PDF
- Logo e dati azienda (nome, indirizzo, P.IVA, sito, telefono, email)
- Numero e data ordine
- Dati cliente
- Date di prelievo e rientro con orari
- Tabella attrezzature con prezzi, garanzie e totali
- Trasporto, sconto (con prezzo barrato se attivo), totale documento con IVA
- Note, rate di pagamento, dati IBAN e spazio firma
Da dove legge i dati
- Logo e dati azienda: WP Admin → Impostazioni → Impostazioni Noleggio
- Dati pagamento (IBAN, BIC, condizioni): stessa pagina Impostazioni Noleggio
- Dati ordine e attrezzature: il database dell’ordine salvato
- Dati cliente nel PDF: dal modal al momento della generazione (non dall’ordine)
PDF Catalogo Attrezzatura
Come si genera
Vai sulla pagina /noleggio/ mentre sei loggato come amministratore. In basso a destra compare un pulsante “Scarica Catalogo PDF” (visibile solo agli admin). Cliccalo: il PDF si scarica direttamente.
Cosa contiene il PDF
- Copertina con logo
- Una sezione per ciascuna delle 7 categorie di attrezzatura (nell’ordine del catalogo)
- Per ogni prodotto: nome, sottocategoria, quantità disponibile, prezzo giornaliero o “Su preventivo”
Da dove legge i dati
- Logo: file
img/logo-arkadia-hd.pngnella cartella del tema — si carica automaticamente col deploy, non serve fare nulla - Prodotti e prezzi: il database dei CPT Attrezzatura (WP Admin → Attrezzatura)
Setup al lancio del sito
Al momento del go-live ci sono tre cose da verificare prima che i PDF funzionino sul server live.
1 — Caricare le cartelle vendor/
Entrambe le librerie PDF sono installate via Composer e si trovano in cartelle vendor/ che non devono essere escluse dal deploy. Verifica che siano presenti sul server:
wp-content/plugins/arkadia-noleggio/vendor/→ libreria mPDF (ordini)wp-content/themes/generatepress-child/vendor/→ libreria DOMPDF (catalogo)
Se usi FTP: carica le due cartelle vendor/ insieme al resto del tema e del plugin. Se hai SSH sul server puoi anche eseguire composer install direttamente lì dentro.
2 — Compilare le Impostazioni Noleggio
Vai in WP Admin → Impostazioni → Impostazioni Noleggio e compila:
- Dati Azienda: nome, sottotitolo, indirizzo, P.IVA, sito, email, telefono
- Logo: carica il logo dal Media Uploader (formato consigliato: PNG trasparente, ~300px di larghezza)
- Dati Pagamento: beneficiario, IBAN, BIC/SWIFT, URL condizioni generali
- Numerazione Ordini: imposta il prefisso e il numero di partenza se necessario
⚠️ Dopo una migrazione del database il logo va ricaricato, perché è salvato come ID dell’allegato nella Media Library del sito sorgente, non del sito di destinazione.
3 — Verificare i requisiti del server
| Requisito | Valore minimo | Note |
|---|---|---|
| PHP | 8.0+ | mPDF 8.x richiede PHP 8.0 o superiore |
| Memory limit | 256 MB | PDF complessi consumano molta RAM |
| max_execution_time | 60 secondi | Il catalogo con molti prodotti può essere lento |
| Permessi di scrittura | wp-content/uploads/ | mPDF usa questa cartella per la cache dei font |
Se il tuo hosting non ti permette di modificare questi valori dal pannello, puoi aggiungerli nel file .htaccess nella root di WordPress:
php_value memory_limit 256M
php_value max_execution_time 60Problemi comuni e soluzioni
Il PDF ordine dà errore “mPDF non trovato” o pagina bianca
La cartella vendor/ del plugin non è presente sul server. Soluzioni:
- Via FTP: carica la cartella
wp-content/plugins/arkadia-noleggio/vendor/dal tuo computer al server - Via SSH: entra nella cartella del plugin ed esegui
composer install
Il PDF catalogo dà errore o pagina bianca
Stessa causa: manca wp-content/themes/generatepress-child/vendor/. Caricala via FTP oppure esegui composer install nella cartella del tema via SSH.
Il PDF si genera ma il logo non appare (ordine noleggio)
Il logo non è stato caricato nelle Impostazioni Noleggio sul server live. Vai in WP Admin → Impostazioni → Impostazioni Noleggio, clicca il campo Logo e carica il file dalla Media Library (o caricane uno nuovo). Salva.
Il PDF catalogo non appare il logo
Il file img/logo-arkadia-hd.png non è presente nella cartella del tema. Verifica che sia stato caricato correttamente sul server insieme agli altri file del tema.
Il PDF impiega troppo tempo o va in timeout
Il server ha un max_execution_time troppo basso. Prova ad aggiungere nel file .htaccess del sito:
php_value max_execution_time 60Se non cambia nulla, contatta il supporto del tuo hosting e chiedi di aumentare il limite di tempo di esecuzione PHP.
Il PDF viene generato ma le cifre o i testi sono strani
Controlla che tutti i dati dell’ordine siano salvati correttamente prima di generare il PDF. Il modal “Esporta PDF” non salva i dati nell’ordine: ogni volta che apri il modal i campi si precompilano dal database. Se l’ordine non era stato salvato dopo l’ultima modifica, i dati nel PDF potrebbero essere vecchi. Salva sempre l’ordine prima di esportare.
Il pulsante “Scarica Catalogo PDF” non compare sulla pagina noleggio
Il pulsante è visibile solo agli amministratori loggati. Se sei loggato e non lo vedi, verifica che:
- Sei sulla pagina con slug
/noleggio/(non una sua sottopagina) - Il tuo account ha il ruolo Amministratore in WP Admin → Utenti
- Il plugin Arkadia Noleggio è attivo (WP Admin → Plugin)
Panoramica
Questa guida spiega come creare un preventivo di noleggio, generare il PDF da mandare al cliente e risolvere i problemi più comuni. Non serve essere esperti: segui i passi nell’ordine.
1 — Crea un nuovo ordine
Vai in WP Admin → Ordini Noleggio → Nuovo Ordine.
In alto a destra trovi il riquadro Ordine. Qui puoi:
- Numero ordine — viene assegnato automaticamente. Se hai bisogno di un numero specifico, spunta “Numero manuale” e scrivilo tu.
- Data ordine — di default è oggi. Cambiala se necessario.
- Stato — lascia “Bozza” finché non è definitivo.
2 — Inserisci le date di noleggio
Nella sezione Dati di Noleggio imposta la data di Prelievo e la data di Rientro.
⚠️ Il numero di giorni si calcola automaticamente dalla differenza tra le due date. Non devi inserirlo a mano. Se la logica di fatturazione è diversa (es. mezza giornata), puoi modificarlo manualmente dopo.
Compila anche gli orari di prelievo e rientro, la cauzione e l’assicurazione (se non applicabile lascia #N/A).
3 — Aggiungi le attrezzature
Nella sezione Attrezzature hai due modi per aggiungere attrezzatura:
Ricerca dal catalogo
Scrivi il nome nella barra di ricerca e clicca sul risultato. Il prezzo giornaliero e la garanzia si compilano in automatico dai dati del catalogo. Puoi modificarli riga per riga.
Voce manuale (attrezzatura non in catalogo)
Clicca su “+ Aggiungi voce manuale”. Appare una riga vuota: scrivi il nome, inserisci garanzia e prezzo giornaliero. I totali si aggiornano subito.
Per rimuovere una riga clicca la × a destra.
4 — Trasporto e sconto
Nella sezione Trasporto e Sconto:
- Trasporto — attiva il toggle se il trasporto è incluso e inserisci il costo.
- Sconto — scegli il tipo (percentuale o importo fisso) e inserisci il valore. Nel riquadro totali vedrai il prezzo originale barrato e quello scontato.
5 — Note e rate
- Note — scrivi indirizzo di ritiro, consegna o qualsiasi indicazione utile per il cliente.
- Numero rate — di default è 1. Aumentalo se il cliente paga in più tranche. Gli importi si dividono automaticamente; puoi modificare ogni importo e data di scadenza a mano.
6 — Salva l’ordine
Clicca Salva (o Salva bozza se non è ancora definitivo). Il numero ordine viene assegnato al primo salvataggio e non cambia più.
7 — Genera il PDF
Clicca il pulsante Esporta PDF nel riquadro a destra. Si apre una finestra con i campi del cliente:
- Nominativo, Indirizzo, P.IVA, Telefono, Email, Riferimento progetto
Compila i dati (o modificali se erano già salvati) e clicca Genera PDF. Il PDF si apre in una nuova scheda, pronto da scaricare o inviare.
💡 I dati inseriti nel modal non vengono salvati nell’ordine — servono solo per quel PDF. Puoi generare più PDF con dati cliente diversi dallo stesso ordine.
Problemi comuni
Il PDF non si apre o dà errore “mPDF non installato”
La libreria PDF non è stata installata. Apri la LocalWP Site Shell, esegui:
cd wp-content/plugins/arkadia-noleggio && composer installPoi riprova.
I totali non si aggiornano
Ricarica la pagina con F5 (o Cmd+R su Mac). Se il problema persiste, assicurati che le date di prelievo e rientro siano entrambe compilate.
Il logo o i dati azienda non appaiono nel PDF
Vai in WP Admin → Impostazioni → Impostazioni Noleggio e controlla che tutti i campi siano compilati e salvati (nome azienda, P.IVA, IBAN, logo). Il PDF legge sempre da lì.
Il numero giorni non si calcola automaticamente
Il calcolo parte solo quando sono compilate entrambe le date (prelievo e rientro). Se ne compili solo una, i giorni restano a 1. Inseriscile nell’ordine in cui appaiono: prima prelievo, poi rientro.
Un’attrezzatura non compare nella ricerca
Verifica che sia pubblicata in WP Admin → Attrezzatura. Se è in bozza non appare. In alternativa usa “+ Aggiungi voce manuale” e inserisci i dati a mano.
Il numero ordine è sbagliato o voglio ripartire da un numero specifico
Vai in Impostazioni → Impostazioni Noleggio, campo “Prossimo numero ordine”: cambialo con il numero che vuoi usare per il prossimo ordine. Per un ordine già creato usa “Numero manuale” nella scheda ordine.
Panoramica
La pagina /lavori/ mostra il portfolio Arkadia con un sistema di filtri per categoria. Puoi aggiungere nuove categorie, cambiarne il nome, scegliere il colore e personalizzare i testi della pagina — tutto senza toccare codice.
Ci sono due posti dove agire:
- WP Admin → Lavori → Tipi di Lavoro — per gestire le categorie (aggiungere, modificare, eliminare, cambiare colore)
- WP Admin → Aspetto → Personalizza → Pagina Lavori — per cambiare il titolo della pagina, il testo introduttivo e l’etichetta del filtro “Tutti”
Aggiungere una nuova categoria
- Vai in WP Admin → Lavori → Tipi di Lavoro
- Nel pannello a sinistra trovi il form “Aggiungi nuovo tipo di lavoro”
- Compila il campo Nome (es. “Istituzionale”)
- Il campo Slug si compila da solo — lascialo così
- Scegli il colore badge cliccando sul quadratino colorato. Il colore scelto apparirà sul badge delle card e sul bordo del pulsante filtro quando è attivo
- Clicca Aggiungi nuovo tipo di lavoro
La nuova categoria appare subito nella lista a destra. Comparirà come filtro nella pagina Lavori solo quando almeno un lavoro le è assegnato.
Modificare nome o colore di una categoria esistente
- Vai in WP Admin → Lavori → Tipi di Lavoro
- Nella lista a destra passa il mouse sulla categoria che vuoi modificare
- Clicca Modifica
- Cambia il nome e/o il colore
- Clicca Aggiorna
La modifica è immediata: badge e filtri nella pagina Lavori si aggiornano in automatico.
Eliminare una categoria
- Vai in WP Admin → Lavori → Tipi di Lavoro
- Passa il mouse sulla categoria → clicca Elimina
- Conferma l’eliminazione
⚠️ I lavori che avevano quella categoria non vengono eliminati — perdono solo la categoria. Se vuoi riassegnarli, apri ogni lavoro e assegna la categoria corretta.
Assegnare una categoria a un lavoro
- Vai in WP Admin → Lavori → apri il lavoro
- Nel pannello laterale destro trovi la sezione “Tipi di Lavoro”
- Spunta la categoria desiderata
- Clicca Aggiorna
Cambiare titolo e testi della pagina Lavori
- Vai in WP Admin → Aspetto → Personalizza
- Clicca su “Pagina Lavori”
- Modifica i campi:
- Titolo pagina — il grande H1 in cima (default: “I Nostri Lavori”)
- Testo introduttivo — il sottotitolo descrittivo sotto il titolo
- Etichetta filtro “Tutti” — la scritta sul primo pulsante filtro
- Clicca Pubblica in alto per salvare
Problemi comuni
Ho aggiunto una categoria ma non compare tra i filtri della pagina
I filtri mostrano solo le categorie che hanno almeno un lavoro assegnato e pubblicato. Assegna la categoria a un lavoro e pubblicalo: il filtro comparirà automaticamente.
Ho cambiato il colore ma la pagina mostra ancora il colore vecchio
Svuota la cache del browser con Ctrl+Shift+R (Windows) o Cmd+Shift+R (Mac). Se usi un plugin di cache (es. WP Rocket, W3 Total Cache), svuota anche quella dal pannello del plugin.
Ho eliminato una categoria e ora alcuni lavori non hanno badge
I lavori orfani non mostrano nessun badge — è il comportamento corretto. Apri ogni lavoro senza categoria e assegna quella giusta dalla sezione “Tipi di Lavoro” nel pannello laterale.
Schermata bianca (White Screen of Death)
Il sito mostra una pagina bianca o un errore 500.
- Accedi via FTP o File Manager e vai in
wp-content/plugins/ - Rinomina la cartella di un plugin in
plugin-DISABILITATOper disattivarlo - Ricarica il sito — se torna, quel plugin era il problema
- In alternativa: accedi al database →
wp_options→ cercaactive_plugins→ svuota il valore
Non riesco ad accedere al pannello admin
- Vai su
tuodominio.it/wp-login.php?action=lostpassword - Inserisci l’email admin e segui il link ricevuto
- Se non arriva l’email: accedi al database →
wp_users→ cambiauser_passimpostando come tipo di funzione MD5 e digita la nuova password
Pagine che restituiscono 404
Succede dopo spostamenti di pagine o cambi di permalink.
- WP Admin → Impostazioni → Permalink
- Clicca Salva le modifiche senza cambiare nulla — questo rigenera il file
.htaccess
Il sito sembra “vecchio” dopo una modifica
Problema di cache. Soluzioni in ordine:
- Svuota la cache del browser (
Ctrl+Shift+RoCmd+Shift+R) - Se hai un plugin di cache (WP Super Cache, W3 Total Cache): vai nel suo pannello e clicca “Svuota cache”
- Se hai accesso SSH o WP-CLI:
wp cache flush
Errore “Sorry, you are not allowed to access this page”
Il tuo utente ha perso i permessi. Accedi al database → wp_usermeta → cerca il tuo user_id → trova la riga wp_capabilities → imposta il valore a a:1:{s:13:"administrator";b:1;}
Aggiungere un pezzo di attrezzatura
- WP Admin → Attrezzatura → Aggiungi nuova
- Inserisci il nome come titolo
- Assegna la Categoria Noleggio dalla sidebar (camera, lenti, luci, ecc.)
- Compila i campi ACF:
- Prezzo — solo numero (es.
150), senza simboli - Su preventivo — spunta se il prezzo non è fisso (mostra “Su preventivo” invece del prezzo)
- Sottocategoria — testo libero (es. “Cinema Camera”, “LED”) — serve per raggruppare visivamente nel catalogo
- Quantità — testo libero (es. “2”, “Kit”)
- Prezzo — solo numero (es.
- Pubblica
Modificare un pezzo esistente
WP Admin → Attrezzatura → clicca sul nome → modifica i campi → Aggiorna
Ordinamento nel catalogo
L’ordine di visualizzazione segue il campo Ordine (menu_order) — un numero basso appare prima. Per modificarlo: nella lista Attrezzatura, trascina le righe con il cursore ≡ oppure imposta il numero nel campo “Ordine” della sidebar di ogni elemento.
Aggiungere una nuova categoria
WP Admin → Attrezzatura → Categorie Noleggio → Aggiungi nuova categoria
⚠ Dopo aver creato la categoria, devi anche aggiungerla manualmente nel codice del blocco catalogo e nel PDF generator per farla apparire. Contatta chi gestisce il tema.
Scaricare il PDF del catalogo aggiornato
Vai sulla pagina /noleggio/ da admin loggato → clicca il pulsante arancione “Scarica Catalogo PDF” in basso a destra.
Dove si trova
WP Admin → Aspetto → Personalizza → Floating Tab Bar → [voce] → Icona SVG
Ogni voce (Home, Produzione, Lavori, Noleggio, Ecosystem) ha un campo textarea dove incollare il codice SVG completo. Se lasciato vuoto, viene usata l’icona di default.
Formato richiesto
Incolla il tag <svg>…</svg> completo. L’attributo più importante è stroke="currentColor": è quello che fa diventare l’icona rossa (#EA0909) quando la voce è attiva, e grigia quando è inattiva.
<svg viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg" aria-hidden="true"
fill="none" stroke="currentColor" stroke-width="1.6"
stroke-linecap="round" stroke-linejoin="round">
…
</svg>Le icone vengono mostrate a 22×22 px. Usa sempre lo stile Outline (stroke), non Solid (fill): si leggono meglio alle dimensioni ridotte.
Dove trovare le icone
- heroicons.com — Outline — già pronti, zero modifiche
- lucide.dev — Outline — stesso stile di Heroicons
- tabler-icons.io — Outline — libreria molto grande
- phosphoricons.com — Regular o Light — stile più rotondo
Su tutti questi siti: clicca l’icona → Copy SVG → incolla nel Customizer.
Passaggi pratici (Heroicons)
- Vai su heroicons.com
- Cerca l’icona (es. film, camera, globe-alt)
- Seleziona Outline (non Solid)
- Clic → Copy SVG
- Incolla nel textarea del Customizer
- Clicca Pubblica
Heroicons è già perfetto così com’è: ha viewBox="0 0 24 24", stroke="currentColor", fill="none". Non serve modificare nulla.
Attributi da rimuovere
Se presenti nel codice copiato, rimuovi questi attributi dal tag <svg>:
width="24" height="24"— il CSS già imposta 22×22, non servonoclass="..."— può creare conflitti di stilecolor="..."— usastroke="currentColor"invece
L’icona non cambia colore (rimane sempre bianca)
Il problema è un colore fisso su stroke o fill invece di currentColor. Cerca nel codice SVG:
stroke="#ffffff" → sostituisci con stroke="currentColor"
fill="#ffffff" → sostituisci con fill="currentColor"Icona Home — caso speciale
La voce Home usa di default il logo Arkadia (img/logo.svg), che contiene una PNG embedded. La PNG non risponde a currentColor, quindi il colore attivo viene simulato via CSS filter (brightness(0) invert(9%) sepia(100%) saturate(2000%) brightness(0.8)).
Se vuoi sostituirlo con un’icona SVG standard (es. una casina da Heroicons), incolla il codice nel campo: il sistema tornerà al comportamento normale con currentColor.
Ripristinare l’icona di default
Svuota il campo textarea e clicca Pubblica. Il sistema ricarica automaticamente l’icona originale.
Questa guida va seguita solo quando decidi di portare il sito da LocalWP a un server reale. Fino ad allora non devi fare nulla — tutto il SEO è già configurato in locale.
1 — Scegli l’hosting
Serve un hosting che supporti PHP 8.2+, MySQL 8.x e che permetta di caricare file via SFTP o pannello. Opzioni consigliate per WordPress:
- Kinsta o WP Engine — hosting gestito, aggiornamenti automatici, CDN inclusa. Ottimi per siti professionali.
- SiteGround o Aruba Cloud — più economici, buone prestazioni, supporto italiano disponibile per Aruba.
- Vercel / Cloudflare Pages — non adatti per WordPress (sono per siti statici).
Assicurati che il dominio arkadiastudios.it punti al server prima di procedere con i passaggi successivi.
2 — Migra il sito sul server
Il modo più semplice è usare il plugin All-in-One WP Migration (già installato sul sito con il nome “csv-xml-import-for-acf” — se non presente installalo gratuitamente).
Metodo A — Plugin All-in-One WP Migration (consigliato)
- In locale: WP Admin → All-in-One WP Migration → Esporta → scegli “File” → scarica il file
.wpress. - Sul server: installa WordPress pulito, installa All-in-One WP Migration, vai su Importa e carica il file
.wpress. - Il plugin aggiorna automaticamente tutti gli URL nel database (da
arkadiastudiosit.localaarkadiastudios.it).
Metodo B — WP-CLI manuale
Se hai accesso SSH al server, copia i file via SFTP e poi esegui questi comandi:
# Aggiorna tutti gli URL nel database
wp search-replace "arkadiastudiosit.local" "arkadiastudios.it" --all-tables
# Aggiorna siteurl e home
wp option update siteurl "https://arkadiastudios.it"
wp option update home "https://arkadiastudios.it"
# Svuota cache
wp cache flush
wp rewrite flush3 — Togli il blocco ai motori di ricerca
Vai su WP Admin → Impostazioni → Lettura.
Nella sezione “Visibilità nei motori di ricerca” assicurati che la spunta “Scoraggia i motori di ricerca” sia deselezionata. Poi clicca Salva.
⚠️ Se non togli questa spunta, Google non indicizzerà il sito anche se il dominio è attivo.
4 — Collega Rank Math a Google Search Console
Google Search Console è lo strumento gratuito di Google che mostra quante persone trovano il sito e per quali parole chiave. Va collegato una volta sola.
- Vai su search.google.com/search-console e accedi con l’account Google dell’azienda.
- Clicca “Aggiungi proprietà” → inserisci
https://arkadiastudios.it→ scegli il metodo di verifica “Tag HTML”. - Copia il codice che ti dà Google (es.
<meta name="google-site-verification" content="XXXX"/>). - In WP Admin → Rank Math → Impostazioni generali → Webmaster Tools → incolla il codice nel campo “Google Search Console”.
- Torna su Search Console e clicca Verifica.
5 — Invia la sitemap
La sitemap è già attiva — Rank Math la genera automaticamente all’indirizzo arkadiastudios.it/sitemap_index.xml. Devi solo comunicarla a Google.
- In Google Search Console, vai su Sitemap nel menu di sinistra.
- Nel campo “Aggiungi una nuova sitemap” scrivi
sitemap_index.xmle clicca Invia. - Lo stato diventerà “Operazione riuscita” entro qualche minuto. Google inizierà a scansionare il sito.
💡 I primi risultati su Google arrivano in 1–4 settimane. Non è istantaneo — è normale.
6 — Verifica il risultato (Rich Results Test)
Il sito ha già il JSON-LD configurato nel tema (dati azienda + schede video). Puoi verificare che Google lo legga correttamente:
- Vai su search.google.com/test/rich-results.
- Inserisci l’URL di una pagina lavoro (es.
arkadiastudios.it/lavori/nome-del-lavoro/). - Dovrebbe mostrare: VideoObject rilevato ✓ e BreadcrumbList rilevato ✓.
- Ripeti con la homepage: dovrebbe mostrare Organization rilevato ✓.
Problemi comuni
Dopo la migrazione le immagini non si vedono
Gli URL delle immagini nel database contengono ancora il dominio locale. Esegui wp search-replace "arkadiastudiosit.local" "arkadiastudios.it" --all-tables sul server, poi svuota la cache.
Il plugin All-in-One WP Migration non accetta il file (troppo grande)
Il limite di upload del server è troppo basso. Vai su WP Admin → All-in-One WP Migration → Impostazioni e aumenta il limite massimo di upload. In alternativa usa il metodo WP-CLI (Metodo B al punto 2).
Google Search Console non verifica il dominio
Aspetta 10 minuti dalla pubblicazione del meta tag e riprova. Se continua a fallire, controlla che Rank Math sia attivo e che la pagina non abbia una cache troppo aggressiva (svuota la cache del server prima di verificare).
La sitemap dà errore 404
Le regole di rewrite di WordPress non sono aggiornate. In WP Admin → Impostazioni → Permalink → clicca Salva (senza cambiare nulla). Questo rigenera il file .htaccess e riattiva la sitemap.
Il sito non appare su Google dopo settimane
Controlla nell’ordine: 1) la spunta “Scoraggia motori di ricerca” è tolta? 2) la sitemap è stata inviata a Search Console? 3) In Search Console, la sezione “Copertura” mostra errori? Se tutto è OK, aspetta ancora — i siti nuovi possono richiedere 4–8 settimane per la prima indicizzazione.
Dove si modificano i contenuti
La homepage usa il campo ACF — si modifica da WP Admin → Home → Modifica (la pagina si chiama “Home”).
Sezione Hero (video di apertura)
| Campo ACF | Cosa controlla |
|---|---|
| Hero Video URL | URL del video di sfondo (YouTube/Vimeo) oppure carica un .mp4 in Media |
| Hero Eyebrow | Piccola etichetta sopra il titolo |
| Hero Title 1/2/3 | Le tre righe del titolo principale |
| Hero Subtitle | Sottotitolo descrittivo |
| CTA 1/2 Label + URL | Testo e link dei due pulsanti |
Sezione Servizi (6 card)
Ogni card ha: Titolo, Descrizione, URL, Icona, Immagine hover. I campi ACF si chiamano service_1_title, service_1_desc, ecc. (da 1 a 6).
Loghi clienti (marquee)
10 slot ACF: logo_cliente_1 … logo_cliente_10. Carica immagini PNG trasparenti, dimensione ottimale 68×auto px. Gli slot vuoti vengono saltati automaticamente.
CTA finale
Campi: cta_title, cta_subtitle, cta_btn_label, cta_btn_url.
Footer e Tab Bar
Si modificano da WP Admin → Aspetto → Personalizza:
- Footer Arkadia → città, indirizzo, P.IVA, privacy, link contatti
- Floating Tab Bar → etichetta, URL, icona SVG, colore attivo per ogni voce
Il pulsante “Scarica Catalogo PDF” non compare
- Verifica di essere loggato come amministratore
- Il pulsante appare solo sulla pagina
/noleggio/ - Se vuoi renderlo visibile a tutti: WP Admin → Aspetto → Personalizza → PDF Catalogo Noleggio → attiva il toggle
Cliccando il pulsante appare “DOMPDF non installato”
La libreria PHP per la generazione PDF non è stata installata sul server. Serve accesso SSH:
cd /percorso/wp-content/themes/generatepress-child
composer installSe non hai Composer installato sul server, contatta il tuo hosting.
“Token non valido o scaduto”
Il nonce WordPress è scaduto (durata: 12 ore). Ricarica la pagina /noleggio/ e riprova.
Il PDF viene scaricato ma è vuoto o incompleto
- Controlla che il catalogo abbia articoli pubblicati in WP Admin → Attrezzatura
- Verifica che ogni articolo abbia la categoria noleggio assegnata
Il PDF ha margini sbagliati sulla seconda pagina
È un limite noto della libreria DOMPDF per contenuto testuale su più pagine. Non è risolvibile senza cambiare libreria. Il contenuto rimane leggibile.
Dove si trova
WP Admin → Aspetto → Personalizza → PDF Catalogo Noleggio
Un solo checkbox: “Pulsante visibile a tutti (non solo admin)”
Comportamento
| Stato | Admin | Visitatori |
|---|---|---|
| ☐ OFF (default) | Vede il pulsante e può scaricare | Non vede nulla |
| ☑ ON | Vede il pulsante e può scaricare | Vede il pulsante e può scaricare |
Note
- Il pulsante appare sulla pagina /noleggio/ in basso a destra, colore arancione.
- Gli admin vedono sempre il pulsante, indipendentemente dall’impostazione.
- Quando il toggle è OFF, i visitatori che tentassero di accedere direttamente all’URL del PDF ricevono “Accesso negato” — il blocco è lato server, non solo visivo.
- Il PDF generato contiene l’intero catalogo con prezzi aggiornati al momento del download.
Plugin SEO installato
Il sito usa Rank Math (o Yoast SEO). Ogni pagina ha una sezione SEO nella parte bassa dell’editor.
Cosa impostare su ogni pagina
| Campo | Regola | Esempio |
|---|---|---|
| Meta Title | Keyword principale | Arkadia Studios | Produzione Video Milano | Arkadia Studios |
| Meta Description | 140–160 caratteri, include keyword, invito all’azione | Casa di produzione video a Milano. Commercial, documentari e content per brand e agenzie. Richiedi un preventivo. |
| H1 | Un solo H1 per pagina, include la keyword principale | Dal brief allo schermo. |
| Immagine OG | 1200×630 px, mostra bene su social | Foto del team o del lavoro più rappresentativo |
Pagine da tenere in noindex
/wiki-arkadia-2026/— già noindex, non toccare- Pagine di test o bozze — imposta noindex in Rank Math prima di pubblicare accidentalmente
Dopo ogni modifica di testi importanti
- Invia la sitemap a Google Search Console:
tuodominio.it/sitemap_index.xml - Richiedi reindicizzazione dalla Search Console per le pagine modificate
Velocità del sito (Core Web Vitals)
- Ottimizza le immagini prima di caricarle (max 200KB per immagini decorative, max 500KB per hero)
- Usa WebP quando possibile
- Non caricare plugin inutili — ogni plugin aggiunge peso
Regola base SEO
Ogni pagina deve avere un solo H1, seguito da H2 per le sezioni principali e H3 per i sotto-contenuti. Google legge questa gerarchia per capire la struttura e il tema della pagina.
| Tag | Ruolo | Numero per pagina |
|---|---|---|
| H1 | Titolo principale — argomento della pagina | Esattamente 1 |
| H2 | Sezioni principali della pagina | Quante servono |
| H3 | Sotto-sezioni o card all’interno di un H2 | Quante servono |
Come i blocchi Gutenberg gestiscono i heading
La maggior parte dei blocchi Arkadia imposta il livello heading automaticamente nel codice PHP — non serve configurarlo ogni volta.
Heading hardcoded (automatici)
| Blocco | Heading generato | Note |
|---|---|---|
| Hero Servizio | H1 | Sempre il primo blocco della pagina |
| Servizio Alternato | H2 | Titolo di ogni sezione servizio |
| CTA Band | H2 | Titolo della call to action |
| Testo (titolo) | H2 | Il titolo principale del blocco |
| Testo (sotto-sezioni) | H3 | I titolini delle singole sezioni |
| FAQ (titolo) | H2 | Il titolo opzionale sopra le domande |
| Catalogo Noleggio (sottocategorie) | H3 | I nomi dei gruppi prodotto |
Heading configurabile
| Blocco | Default | Come cambiarlo |
|---|---|---|
| Titolo Stilizzato | H2 | Sidebar editor → campo “Livello heading” → scegliere H1 / H2 / H3 |
Struttura heading verificata per ogni pagina
Homepage (front-page.php)
- H1 — “Creiamo storie che rimangono.” (hero video)
- H2 — “Cosa facciamo” (sezione servizi)
- H3 — Titoli delle 6 card servizio
- H2 — “Ultimi lavori” (sezione lavori)
- H3 — Titoli delle card lavoro
- H2 — Titolo CTA finale
Archivio Lavori (archive-lavoro.php)
- H1 — “I Nostri Lavori”
- H2 — Titoli delle card lavoro
Singolo Lavoro (single-lavoro.php)
- H1 — Titolo del lavoro
- H2 — “Crew”, “Risultati”, “Link”, “Altri lavori”
- H3 — Titoli dei lavori correlati
Pagina Ecosystem (ecosystem-cdv1.php)
- H1 — Titolo intro (sezione desktop)
- H2 — Titolo intro mobile + claim dei 5 pilastri + CTA finale
- H3 — Descrizioni dei servizi nella versione mobile
Pagine servizio con blocchi Gutenberg
Struttura standard ottenuta dai blocchi:
- H1 — Blocco Hero Servizio (titolo pagina)
- H2 — Blocchi Servizio Alternato (ogni sezione contenuto)
- H2 — Blocco CTA Band o Testo con titolo
- H3 — Blocco Testo sotto-sezioni, o Catalogo sottocategorie
⚠️ Regola da non violare
Il codice non impedisce di inserire due blocchi Hero Servizio nella stessa pagina, il che creerebbe due H1. Usare sempre un solo blocco Hero Servizio per pagina, e metterlo sempre come primo blocco.
Se si usa il blocco Titolo Stilizzato per un titolo principale, controllare in sidebar che il livello heading sia impostato su H1 solo se non c’è già un Hero Servizio nella pagina.
Fix applicati (maggio 2026)
- ecosystem-cdv1.php — il template aveva due H1 contemporanei nel DOM (uno desktop, uno mobile). Il mobile H1 è stato convertito in H2.
- front-page.php — le etichette “Cosa facciamo” e “Ultimi lavori” erano
<span>; le card sotto usavano H3 senza un H2 intermedio. Convertiti in<h2 class="section-tag">(visivamente identici, gerarchia corretta).
VFX DA DA VINCI AD AFTR EFFETCS
ecco come fare questa cosa