Ho preso un tema gratuito, l’ho rinominato e ho ottenuto uno sviluppo completamente personalizzato. Sembra semplice, ma quando apri la directory di Shapely in un editor lo sguardo si disperde: decine di file, ognuno con riferimenti al vecchio nome. Funzioni con il prefisso shapely_, text domain, percorsi degli asset, descrizioni nell’intestazione del style.css. Basta tralasciarne uno e il tema si rompe.

Shapely di Colorlib è una delle migliori basi gratuite per lo sviluppo personalizzato: oltre 10.000 installazioni attive, valutazione 4,6 su WordPress.org, ultimo aggiornamento ad aprile 2025. Una one page con sezioni parallax e supporto WooCommerce che dopo mezz’ora di modifiche diventa un prodotto unico per un cliente specifico.

Qui sotto trovi la sequenza completa per sostituire il nome del tema Shapely con il tuo. Dalla rinomina massiva dei file allo screenshot finale, senza saltare passaggi e con strumenti collaudati.

💡 Panoramica rapida:

• Scarica Shapely dalla pagina ufficiale e copia la directory del tema con un nuovo nome.
• Rinomina in massa file e cartelle: sostituisci il vecchio prefisso shapely con il tuo, in minuscolo.
• Cerca e sostituisci tutte le occorrenze di shapely e Shapely dentro i file PHP, CSS e JS, rispettando maiuscole e minuscole.
• Correggi function.php, la documentazione e il customizer, riscrivi style.css con il nuovo nome del tema.
• Prepara un screenshot.png personalizzato e verifica l’attivazione del tema nel pannello di amministrazione.

Perché rinominare Shapely invece di scrivere da zero

Scrivere un tema partendo da zero per un progetto ordinario è uno spreco di budget. Shapely fornisce un framework già pronto: layout Bootstrap, widget per la homepage, supporto ai plugin più diffusi nativamente. Ottieni un prodotto funzionante e modifichi solo ciò che serve al cliente: colori, font, struttura delle sezioni e, naturalmente, il nome.

Rinominare non è un intervento cosmetico. Cambiare il nome in tutti i file e le funzioni rende il tema tuo: viene visualizzato nel pannello di amministrazione con il tuo brand, non entra in conflitto con lo Shapely originale (puoi tenerli entrambi sullo stesso sito) e il cliente vede uno sviluppo personalizzato, non un «tema gratuito preso da internet».

In pratica il ciclo completo richiede 30-40 minuti. Analizziamo ogni passaggio.

Passaggio 1: scarica e copia la directory

Scarica Shapely da colorlib.com o dal repository di WordPress.org. Estrai l’archivio.

Crea una copia della directory shapely e chiamala con il nome del tuo tema. Regola: solo lettere latine minuscole e trattini. Niente spazi, underscore o maiuscole. Esempi di nomi corretti: trolleybus, mediadoma-theme oppure custom-start.

Perché minuscolo: WordPress normalizza i nomi di temi e plugin in minuscolo quando verifica gli aggiornamenti e lavora con i text domain. Una lettera maiuscola nel nome della cartella è la strada sicura verso il «white screen of death» in fase di attivazione.

Passaggio 2: rinomina massiva dei file

Prima passata, nomi di file e cartelle. Shapely ne ha diverse decine e molti contengono shapely direttamente nel nome: shapely-documentation.php, class-shapely-customize.php e così via.

In Total Commander: apri la directory del tema, Ctrl+B (elenco piatto), Ctrl+A (seleziona tutto), Ctrl+M (rinomina in blocco). Nel campo «Cerca» inserisci shapely, nel campo «Sostituisci» il nuovo nome (minuscolo). Esegui, tutti i file e le cartelle vengono rinominati in un secondo.

Alternativa senza Total Commander, PowerShell. Apri un terminale nella directory del tema ed esegui:

1
Get-ChildItem -Recurse | Where-Object { $_.Name -like '*shapely*' } | Rename-Item -NewName { $_.Name -replace 'shapely', 'newname' }

Sostituisci newname con la tua versione. Questo metodo è gratuito e funziona su qualsiasi Windows senza installare programmi aggiuntivi.

Passaggio 3: cerca e sostituisci nei contenuti dei file

Ora la parte più importante: ripulire i riferimenti a shapely dentro i file PHP, CSS e JS. Sono decine e la ricerca manuale non è un’opzione praticabile.

In Notepad++: Ctrl+Shift+F (trova nei file), directory, la cartella del tuo nuovo tema. Prima passata, sostituisci shapely (minuscolo) con newname. Seconda passata, sostituisci Shapely (con la maiuscola) con Newname. Attiva l’opzione «Maiuscole/minuscole» per ogni passata.

Punti specifici in cui il nome del tema compare di sicuro:

• function.php, hook after_setup_theme, chiamate a wp_enqueue_style e wp_enqueue_script con il prefisso shapely_;
• wp-content/themes/yourtheme/inc/trolleybus-documentation.php, testi di aiuto nel pannello di amministrazione;
• wp-content/themes/yourtheme/inc/class-customize.php, impostazioni del customizer.

Nota: modifica non solo le stringhe di testo, ma anche i nomi delle funzioni. shapely_get_option() deve diventare yourtheme_get_option(). Altrimenti, installando due temi sullo stesso sito, PHP genererà un errore fatale «Cannot redeclare function».

Passaggio 4: correggi style.css, i metadati del tema

Il file style.css nella root del tema è il «passaporto»: WordPress ne legge l’intestazione e mostra le informazioni nella sezione «Aspetto → Temi». Esempio:

1
/*
2
Theme Name: Trolleybus
3
Theme URI: https://your-site.com/
4
Author: Your Name / Studio
5
Author URI: https://your-site.com/
6
Description: Custom theme based on Shapely — a one-pager with parallax sections, WooCommerce support, and responsive layout. Optimized for a specific project.
7
Version: 1.0
8
License: GNU General Public License v2 or later
9
License URI: http://www.gnu.org/licenses/gpl-2.0.html
10
Text Domain: themename
11
*/

Tre campi sono obbligatori: Theme Name (nome del tema nel pannello di amministrazione), Text Domain (deve coincidere con il nome della cartella, WordPress lo usa per le traduzioni) e Version. Il resto è facoltativo, ma Author e Description creano un’impressione professionale.

Text Domain è un campo critico. Se non corrisponde al nome della cartella, la funzione load_theme_textdomain() non caricherà le traduzioni e tutte le stringhe nel pannello di amministrazione resteranno in inglese.

Passaggio 5: prepara uno screenshot.png personalizzato

screenshot.png si trova nella root del tema e viene mostrato nella galleria «Aspetto → Temi». Dimensioni: secondo i requisiti di presentazione dei temi di WordPress.org. Formato: PNG.

Cosa inserire nello screenshot: logo dello studio, nome del tema e una schermata della homepage dopo la personalizzazione. Non lasciare lo screenshot originale di Shapely, il cliente vedrebbe il prodotto di qualcun altro e farebbe domande.

Strumenti: Photoshop, Figma o il gratuito GIMP. Disegna uno sfondo, aggiungi il testo con il nome del tema, inserisci una schermata della homepage. Salva come screenshot.png e sostituisci il file nella root del tema.

Passaggio 6: verifica finale

Prima di consegnare al cliente, controlla tre cose:

• Attivazione senza errori. Vai su «Aspetto → Temi» e attiva il nuovo tema. Schermata bianca? Torna al passaggio 3, molto probabilmente è rimasta una funzione con il prefisso shapely_.
• Nome nel pannello di amministrazione. L’elenco temi mostra il valore Theme Name del style.css, esattamente quello che hai indicato.
• Funzionamento del customizer. Apri «Aspetto → Personalizza» e scorri le sezioni. Se qualche opzione non si salva, controlla inc/class-customize.php (passaggio 3), forse è rimasto un vecchio identificatore di opzione.

Ecco fatto. Il tema è pronto per lavorare e porta il tuo nome. Shapely è servito da fondamenta, ma il prodotto ora è completamente tuo.

Perché fare così e non con un child theme

Domanda frequente: perché non creare un child theme e cambiarci il nome? La risposta dipende dallo scenario.

Un child theme è adatto quando perfezioni un sito per te stesso: modifichi CSS, aggiungi funzioni al functions.php, ma lo Shapely originale resta la base e riceve aggiornamenti. Questa è la strada giusta per il proprietario di un sito.

Per un’agenzia o un freelance che consegna un progetto a un cliente, il child theme è un compromesso. Il cliente vede «Shapely» nel pannello di amministrazione e, quando il tema padre si aggiorna, le tue modifiche possono rompersi (gli sviluppatori hanno cambiato il markup HTML di una sezione, la tua correzione CSS ha smesso di funzionare). La rinomina completa dà il controllo su ogni file ed elimina la dipendenza dagli aggiornamenti di Colorlib.

Conclusione: se lo fai per te, child theme. Se lo fai per un cliente, fork con rinomina.

⁉️🤔 Domande frequenti

Posso rinominare un tema senza Total Commander?

Sì. Su Windows 10/11 usa PowerShell (comando del passaggio 2), su macOS il Finder con la rinomina in blocco o l’utility rename nel terminale. Su Linux, rename 's/shapely/newname/' *. L’importante è non saltare le cartelle nidificate: PowerShell con il flag -Recurse attraversa l’intero albero, mentre il Finder evidenzia solo i file nella cartella corrente.

Cosa succede se lascio vecchi riferimenti a shapely nel codice?

Dipende dalla posizione. Se il vecchio prefisso resta in un nome di funzione, installando due temi con le stesse funzioni PHP genererà un errore fatale, il sito andrà in crash. Se in un percorso di un asset, l’immagine o lo script non verranno caricati (404). Se nel text domain, le stringhe di traduzione non verranno caricate. Scenario peggiore: il sito funziona, consegni il progetto e un mese dopo il cliente installa lo Shapely originale per curiosità e ottiene una schermata bianca. Due temi con funzioni shapely_setup() nello stesso WordPress non coesistono.

Shapely si aggiorna dopo la rinomina?

No. Hai fatto un fork del tema, gli aggiornamenti di Colorlib non ti raggiungono. È una scelta consapevole: sacrifichi gli aggiornamenti automatici in cambio del pieno controllo. Se nello Shapely originale esce una patch di sicurezza critica, la applichi manualmente, in modo chirurgico. In pratica, per i temi la stabilità è più importante degli aggiornamenti: un tema non è un plugin, le vulnerabilità sono rare. L’alternativa per chi vuole sia controllo sia aggiornamenti è il child theme, ma quando si consegna un progetto a un cliente il fork è più affidabile.

Shapely è un tema solo per one page?

Per concezione, sì. Ma il layout Bootstrap e la struttura modulare permettono di usarlo anche per siti multipagina: basta creare pagine aggiuntive in WordPress e impostare un menu. I widget della homepage (parallax, portfolio) funzionano solo sulla pagina assegnata come «Homepage» nelle impostazioni. In pratica abbiamo costruito blog e cataloghi prodotti su Shapely, il framework è flessibile in partenza.

Cosa fare con lo screenshot se non c’è un designer?

Cattura una schermata della homepage finita (Strumento di cattura su Windows o Cmd+Shift+4 su macOS), aprila in Canva (gratuito, online), sovrapponi il nome del tema e il logo dello studio, scarica come PNG della dimensione richiesta. In 10 minuti ottieni un risultato professionale senza Photoshop. L’importante è non lasciare lo screenshot di Shapely: il cliente vede esattamente questo quando sceglie un tema nel pannello di amministrazione e il brand di qualcun altro in quella posizione mina la fiducia nel tuo lavoro.

Cosa fare dopo la rinomina: il passo successivo

Il tema è rinominato e attivato. Ora la personalizzazione per il progetto specifico: sostituire la palette colori nel customizer, configurare i widget della homepage, attivare WooCommerce se serve un negozio, ottimizzazione SEO con Yoast SEO o Rank Math.

Inizia dal customizer: «Aspetto → Personalizza» e procedi dall’alto verso il basso. Shapely espone lì decine di opzioni: dal logo al footer. In un’ora di personalizzazione ottieni un aspetto unico senza scrivere una riga di codice. E se il progetto richiede una personalizzazione più profonda, hai già il tuo fork dove puoi aggiungere qualsiasi funzione senza guardare all’originale.

Se il sito sarà multipagina, crea prima i template per le pagine interne nella cartella del tema. E ricorda: la rinomina ti ha liberato dai conflitti con l’originale, ora Shapely e il tuo tema possono convivere sullo stesso sito in modo indipendente.