Skip to content

Tudo para WordPress, desenvolvimento web — e não só

🛠 Renomear o tema Shapely para o seu projeto: guia completo

🛠 Renomear o tema Shapely para o seu projeto: guia completo

Peguei num tema gratuito, mudei-lhe o nome e obtive um desenvolvimento totalmente personalizado. Parece simples, mas quando abre o diretório do Shapely num editor, os olhos dispersam-se: dezenas de ficheiros, cada um a mencionar o nome antigo. Funções com o prefixo shapely_, domínios de texto, caminhos de assets, descrições no cabeçalho do style.css. Basta falhar um e o tema parte.

O Shapely da Colorlib é uma das melhores bases gratuitas para desenvolvimento personalizado: mais de 10 000 instalações ativas, classificação de 4,6 no WordPress.org, última atualização em abril de 2025. Um one-pager com secções parallax e suporte para WooCommerce que se transforma num produto único para um cliente específico após meia hora de edições.

Abaixo está a sequência completa para substituir o nome do tema Shapely pelo seu. Desde a renomeação em massa de ficheiros até à imagem final, sem saltos e com ferramentas comprovadas.

💡 Visão geral rápida:

  • Descarregue o Shapely da página oficial e copie o diretório do tema com um nome novo.
  • Renomeie ficheiros e pastas em massa: substitua o prefixo antigo shapely pelo seu, em minúsculas.
  • Procure e substitua todas as ocorrências de shapely e Shapely dentro dos ficheiros PHP, CSS e JS, com distinção entre maiúsculas e minúsculas.
  • Corrija o functions.php, a documentação e o personalizador, reescreva o style.css com o novo nome do tema.
  • Prepare uma screenshot.png personalizada e verifique a ativação do tema no painel de administração.

Porquê renomear o Shapely em vez de escrever de raiz

Escrever um tema a partir do zero para um projeto comum é um desperdício de orçamento. O Shapely fornece uma estrutura pronta: layout Bootstrap, widgets para a página inicial, suporte para plugins populares de origem. Obtém um produto funcional e altera apenas o que o cliente precisa: cores, fontes, estrutura das secções e, claro, o nome.

Renomear não é cosmético. Alterar o nome em todos os ficheiros e funções torna o tema seu: é apresentado no painel de administração com a sua marca, não entra em conflito com o Shapely original (pode manter ambos no mesmo site) e o cliente vê desenvolvimento personalizado, não um «tema gratuito da internet».

Na prática, o ciclo completo demora 30 a 40 minutos. Vamos detalhar cada passo.

Passo 1: descarregar e copiar o diretório

Descarregue o Shapely do colorlib.com ou do repositório do WordPress.org. Descompacte o arquivo.

Crie uma cópia do diretório shapely e atribua-lhe o nome do seu tema. Regra: apenas letras minúsculas e hífenes. Sem espaços, underscores ou maiúsculas. Exemplos de nomes corretos: trolleybus, mediadoma-theme ou custom-start.

Porquê minúsculas: o WordPress normaliza os nomes de temas e plugins para minúsculas ao verificar atualizações e ao trabalhar com domínios de texto. Uma letra maiúscula no nome da pasta é um caminho seguro para o «ecrã branco da morte» durante a ativação.

Passo 2: renomeação em massa de ficheiros

Primeira passagem, nomes de ficheiros e pastas. O Shapely tem várias dezenas, e muitos contêm shapely no próprio nome: shapely-documentation.php, class-shapely-customize.php, e assim por diante.

No Total Commander: abra o diretório do tema, Ctrl+B (lista plana), Ctrl+A (selecionar tudo), Ctrl+M (renomeação em lote). No campo «Procurar por» insira shapely, no campo «Substituir por», o novo nome (minúsculas). Execute, todos os ficheiros e pastas são renomeados num segundo.

Alternativa sem Total Commander, PowerShell. Abra um terminal no diretório do tema e execute:

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

Substitua newname pela sua versão. Este método é gratuito e funciona em qualquer Windows sem instalar programas adicionais.

Passo 3: procurar e substituir no conteúdo dos ficheiros

Agora o mais importante, limpar as menções a shapely dentro dos ficheiros PHP, CSS e JS. Existem dezenas delas, e a procura manual não é opção aqui.

No Notepad++: Ctrl+Shift+F (procurar em ficheiros), diretório, a sua nova pasta do tema. Primeira passagem, substitua shapely (minúsculas) por newname. Segunda passagem, substitua Shapely (maiúscula inicial) por Newname. Ative a opção «Match case» em cada passagem.

Locais específicos onde o nome do tema aparece garantidamente:

  • functions.php, hook after_setup_theme, chamadas wp_enqueue_style e wp_enqueue_script com o prefixo shapely_;
  • wp-content/themes/seutema/inc/trolleybus-documentation.php, texto de ajuda no painel de administração;
  • wp-content/themes/seutema/inc/class-customize.php, definições do personalizador.

Nota: altere não só as strings de texto, mas também os nomes das funções. shapely_get_option() deve passar a yourtheme_get_option(). Caso contrário, ao instalar dois temas no mesmo site, o PHP lançará um erro fatal «Cannot redeclare function».

Passo 4: corrigir o style.css, metadados do tema

O ficheiro style.css na raiz do tema é o «passaporte»: o WordPress lê o seu cabeçalho e exibe a informação na secção «Aparência → Temas». Exemplo:

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

Três campos são obrigatórios: Theme Name (nome do tema no painel de administração), Text Domain (deve corresponder ao nome da pasta, o WordPress usa-o para tradução) e Version. O resto é opcional, mas Author e Description criam uma impressão profissional.

Text Domain é um campo crítico. Se não corresponder ao nome da pasta, a função load_theme_textdomain() não carregará as traduções e todas as strings no painel de administração permanecerão em inglês.

Passo 5: preparar uma screenshot.png personalizada

A screenshot.png está na raiz do tema e é mostrada na galeria «Aparência → Temas». Tamanho: de acordo com os requisitos de apresentação de temas do WordPress.org. Formato: PNG.

O que colocar na imagem: logótipo do estúdio, nome do tema e uma captura de ecrã da página inicial após personalização. Não deixe a imagem original do Shapely, o cliente verá o produto de outra pessoa e fará perguntas.

Ferramentas: Photoshop, Figma ou o gratuito GIMP. Desenhe um fundo, adicione o texto com o nome do tema, insira uma captura de ecrã da página inicial. Guarde como screenshot.png e substitua o ficheiro na raiz do tema.

Espaço de trabalho de programador WordPress com código no monitor

Passo 6: verificação final

Antes de entregar ao cliente, verifique três coisas:

  • Ativação sem erros. Vá a «Aparência → Temas» e ative o novo tema. Ecrã branco, volte ao passo 3, provavelmente uma função com o prefixo shapely_ foi esquecida.
  • Nome no painel de administração. A lista de temas exibe o valor Theme Name do style.css, exatamente o que especificou.
  • Funcionamento do personalizador. Abra «Aparência → Personalizar» e percorra as secções. Se alguma opção não guardar, verifique inc/class-customize.php (passo 3), talvez permaneça lá um identificador de opção antigo.

É tudo. O tema está pronto a funcionar e tem o seu nome. O Shapely serviu de base, mas o produto é agora totalmente seu.

Porquê fazê-lo assim e não através de um tema filho

Pergunta comum: porque não criar um tema filho e alterar o nome nele? A resposta depende do cenário.

Um tema filho é adequado quando está a aperfeiçoar um site para si: alterar CSS, adicionar funções ao functions.php, mas o Shapely original permanece a base e recebe atualizações. Este é o caminho certo para o proprietário de um site.

Para uma agência ou freelancer que entrega um projeto a um cliente, um tema filho é um compromisso. O cliente vê «Shapely» no painel de administração e, ao atualizar o tema pai, as suas edições podem quebrar (os developers alteraram a marcação HTML da secção, a sua correção de CSS deixou de funcionar). A renomeação completa dá controlo sobre cada ficheiro e elimina a dependência das atualizações da Colorlib.

Conclusão: a fazer para si, tema filho. A fazer para um cliente, fork com renomeação.

⁉️🤔 Perguntas comuns

Posso renomear um tema sem o Total Commander?

Sim. No Windows 10/11 use o PowerShell (comando do passo 2), no macOS, o Finder com renomeação em lote ou o utilitário rename no terminal. No Linux, rename 's/shapely/newname/' *. O principal é não esquecer as pastas aninhadas: o PowerShell com o sinalizador -Recurse percorre toda a árvore, enquanto o Finder apenas realça os ficheiros na pasta atual.

O que acontece se deixar menções antigas ao shapely no código?

Depende da localização. Se o prefixo antigo permanecer num nome de função, ao instalar dois temas com os mesmos nomes de funções o PHP lançará um erro fatal, o site irá abaixo. Se estiver num caminho de asset, a imagem ou script não carregará (404). Se estiver no domínio de texto, as strings de tradução não serão carregadas. Pior cenário: o site funciona, entrega o projeto, e um mês depois o cliente instala o Shapely original por curiosidade e obtém um ecrã branco. Dois temas com funções shapely_setup() no mesmo WordPress não coexistem.

O Shapely atualiza após a renomeação?

Não. Fez um fork do tema, as atualizações da Colorlib não lhe chegam. Esta é uma decisão consciente: sacrifica as atualizações automáticas pelo controlo total. Se surgir um patch de segurança crítico no Shapely original, aplica-o manualmente, de forma cirúrgica. Na prática, a estabilidade é mais importante para temas do que as atualizações: um tema não é um plugin, as vulnerabilidades nele são raras. Alternativa para quem quer controlo e atualizações, um tema filho, mas ao entregar um projeto a um cliente, um fork é mais fiável.

O Shapely é um tema apenas para one-pagers?

Por conceção, sim. Mas o layout Bootstrap e a estrutura modular permitem usá-lo também para sites multipágina: basta criar páginas adicionais no WordPress e configurar um menu. Os widgets da página inicial (parallax, portefólio) só funcionam na página definida como «Página inicial» nas definições. Na prática, já construímos blogs e catálogos de produtos sobre o Shapely, a estrutura é inicialmente flexível.

O que fazer com a imagem se não houver designer?

Tire uma captura de ecrã da página inicial finalizada (Ferramenta de Recorte no Windows ou Cmd+Shift+4 no macOS), abra-a no Canva (gratuito, online), sobreponha o nome do tema e o logótipo do estúdio, descarregue como PNG do tamanho necessário. Em 10 minutos obtém um resultado profissional sem Photoshop. O principal é não deixar a imagem do Shapely: o cliente vê exatamente isto ao escolher um tema no painel de administração, e a marca de outra pessoa nesse local mina a confiança no seu trabalho.

O que fazer após renomear: próximo passo

O tema está renomeado e ativado. A seguir, personalização para um projeto específico: substituir o esquema de cores no personalizador, configurar os widgets da página inicial, ligar o WooCommerce se for necessária uma loja, otimização SEO através do Yoast SEO ou Rank Math.

Comece pelo personalizador: «Aparência → Personalizar», e percorra de cima a baixo. O Shapely apresenta dezenas de opções ali: do logótipo ao rodapé. Numa hora de personalização obtém uma aparência única sem escrever uma linha de código. E se o projeto exigir uma personalização mais profunda, já tem o seu próprio fork onde pode adicionar quaisquer funções sem olhar para trás, para o original.

Se o site for planeado como multipágina, crie primeiro os templates para as páginas internas na pasta do tema. E lembre-se: a renomeação libertou-o de conflitos com o original, agora o Shapely e o seu tema podem viver no mesmo site de forma independente.