Como instalar um modelo Joomla e conteúdo de demonstração: 2026 Guia passo a passo - PT

Instale um início rápido do Joomla em seu site ativo e você substituirá seu banco de dados, não é o seu modelo. Isso não é um aviso enterrado nos documentos. É assim que o formato é construído. No entanto, a maioria dos tutoriais ainda usa “modelo” e “Início rápido” como se significassem a mesma coisa, e essa é a maneira mais rápida de destruir um site em funcionamento em menos de sessenta segundos.

Resposta rápida: Para um Joomla ao vivo 5 ou 6 local, instale um modelo via Sistema → Instalar → Extensões → Carregar arquivo de pacote, em seguida, ative-o em Sistema → Modelos → Estilos de modelo de site. Os pacotes de início rápido são apenas para servidores novos e são executados por meio do instalador web padrão do Joomla, não o Gerenciador de extensões. Se você quiser a demonstração, procure em um site existente, use a importação separada de conteúdo de demonstração do fornecedor do modelo em vez de um início rápido.

Última revisão: abril 2026. Caminhos verificados no Joomla 5.4.5 e Joomla 6.1 interface de administração.

A maioria dos guias online cobre um método de instalação (carregue o ZIP) e chamá-lo feito. Este cobre todos os quatro, desvenda a confusão Quickstart-vs-demo-content que destrói os iniciantes, e guia você pelo “Não foi possível detectar o arquivo de manifesto” erro que os fóruns do Joomla ainda estão respondendo 2026.

Modelo versus. Início rápido vs.. Pacote de conteúdo de demonstração

Compre um modelo e muitas vezes você encontrará três arquivos na mesma pasta de download. Eles se parecem. Eles fazem coisas totalmente diferentes.

UMA pacote de modelos é um pequeno ZIP contendo a camada da pele: CSS, substituições de layout, posições, parâmetros do modelo. Instale isso em qualquer site Joomla, antigo ou novo, por meio do Gerenciador de extensões. Seu conteúdo permanece intocado.

o Pacote de início rápido é o oposto: um ZIP completo de instalação do Joomla junto com o modelo, extensões, e o banco de dados de demonstração do fornecedor. Não passa pelo Extension Manager. Você descompacta-o em uma nova conta de hospedagem e executa o instalador web Joomla. Esse banco de dados de demonstração é o que cria a aparência exata que você vê no site de visualização do fornecedor, incluindo artigos fictícios, menus, e posicionamentos de módulos.

Depois há o pacote de conteúdo de demonstração, às vezes chamado “dados de amostra” ou “Exportação do Construtor de Páginas SP.” É um arquivo JSON ou SQL que o fornecedor fornece para que você possa recriar o layout de demonstração em um site Joomla já em execução. Importa menus, módulos, e páginas sem alterar a configuração do servidor.

Regra prática: modelo para a pele, Início rápido para uma caixa nova, conteúdo de demonstração para um site existente que você deseja redecorar. ZIPs de início rápido geralmente são 150 para 400 MB porque eles contêm um núcleo Joomla completo. Um ZIP somente de modelo normalmente é 2 para 15 MB. Um arquivo de conteúdo de demonstração está em 2 MB. O tamanho por si só informa o que você baixou, mesmo que o nome do arquivo seja ambíguo.

Antes de começar: A lista de verificação de cinco minutos

Noventa por cento das falhas de instalação ocorrem por pular esta lista.

• Faça backup do site. Backup Akeeba (livre) captura arquivos e banco de dados em um arquivo. Não pule isso, mesmo para uma instalação apenas de modelo.
• Confirme a versão do Joomla. Sistema → Informações do sistema → Versão Joomla. Modelos criados para Joomla 3 não vai funcionar 5 ou 6. Modelos criados para Joomla 4 geralmente trabalha em 5, ocasionalmente em 6.
• Confirme a versão do PHP. Joomla 5 precisa de PHP 8.1+, Joomla 6 precisa de PHP 8.3+. Verifique em Sistema → Informações do Sistema → Informações PHP.
• Mantenha o ZIP como um ZIP. O Safari no macOS extrai downloads automaticamente por padrão. Desative isso nas preferências do Safari, ou sua pasta de modelos se recusará a instalar.
• Verifique o acesso de gravação da pasta tmp. Sistema → Informações do sistema → Permissões do diretório. o /tmp linha deve mostrar “Gravável” em verde.
• Verifique a fonte do modelo. Instale apenas do fornecedor de quem você comprou ou do diretório de extensões Joomla. “Anulado” ou modelos Joomla crackeados gratuitamente são uma das fontes mais comuns de backdoors e injeções de spam de SEO em sites Joomla hackeados. A economia não vale a pena.

Se algum deles falhar, corrija-os antes de abrir o Extension Manager. Os modelos não são instalados parcialmente, eles falham completamente, e as mensagens de erro são enigmáticas.

Método 1: Carregar arquivo de pacote (O caminho padrão)

Esta é a rota que os documentos do fornecedor geralmente apontam para você, e funciona para qualquer ZIP abaixo do limite de upload do seu servidor (usualmente 64 MB ou 128 MB em hospedagem compartilhada).

1. Logar em /administrador como superusuário.
2. Clique Sistema na barra lateral esquerda, então Instalar → Extensões.
3. o Carregar arquivo de pacote aba abre por padrão. Arraste o modelo ZIP para a zona de upload ou clique em Ou procure o arquivo.
4. Aguarde a barra de progresso do upload. Não recarregue a página.
5. Um verde A instalação do modelo foi bem-sucedida banner confirma que está feito.

Se o seu modelo ZIP for maior que o seu PHP upload_max_filesize, você verá um 500 erro ou falha silenciosa. Pule para o método de pasta abaixo.

Método 2: Instalar a partir do URL (Para pacotes hospedados)

Útil quando o fornecedor do modelo hospeda o ZIP em seu CDN e fornece um link direto para download (comum para pacotes licenciados).

1. Copie o URL ZIP direto da página de download do seu fornecedor. Deve terminar em .zip e não ficar bloqueado por um redirecionamento de login.
2. Vamos para Sistema → Instalar → Extensões e clique no Instalar a partir do URL aba.
3. Cole o URL no URL de instalação campo.
4. Clique Verifique e instale.

Joomla puxa o arquivo de servidor para servidor, então seu limite de upload local não se aplica. A busca falhará se o URL redirecionar, então cole o link ZIP bruto, não a página do produto. Uma pegadinha: alguns fornecedores usam URLs de download assinados que expiram após alguns minutos. Se o seu URL tiver mais de dez minutos, regenerá-lo.

Método 3: Instalar da pasta (Para pacotes grandes)

A saída de emergência quando o modelo ZIP é muito grande para o Extension Manager engolir. Você faz o upload via FTP ou gerenciador de arquivos cPanel, então aponte o Joomla para a pasta extraída.

1. Descompacte o modelo ZIP em sua máquina local.
2. Abra o Gerenciador de Arquivos cPanel ou conecte via FTP (FileZilla funciona bem).
3. Navegue até o Joomla /tmp diretório.
4. Faça upload de toda a pasta extraída (não compactado) em /tmp.
5. Em Joomla, vamos para Sistema → Instalar → Extensões → Instalar da pasta.
6. o Diretório de instalação campo é preenchido automaticamente com seu caminho tmp. Anexe o nome da sua pasta se estiver faltando.
7. Clique Verifique e instale.

Duas coisas incomodam as pessoas aqui. Primeiro, nomes de pastas diferenciam maiúsculas de minúsculas no Linux, então o caminho que você digita deve corresponder exatamente. Segundo, a pasta precisa do arquivo XML de manifesto na sua raiz. Uma configuração de pasta dentro de uma pasta oculta o manifesto e o Joomla gera o erro que descompactamos abaixo.

Método 4: Instalar da Web (Diretório de extensões Joomla)

O mais simples dos quatro, mas útil apenas para modelos gratuitos listados no diretório oficial de extensões do Joomla (JED). Modelos premium e de terceiros não aparecerão aqui.

1. Vamos para Sistema → Instalar → Extensões e clique no Instalar da Web aba.
2. Se esta é sua primeira vez, clique Adicionar “extensões.joomla.org” para a lista branca quando solicitado.
3. Navegue por categoria ou pesquise por nome. Filtrar por “Modelos.”
4. Clique no modelo desejado, em seguida, clique no Instalar botão na página de detalhes.

O catálogo JED é limitado, mas todas as listagens passaram pela análise do Joomla, então é o caminho mais seguro para iniciantes. Um truque bônus: se você já enviou um modelo via FTP, mas o Gerenciador de extensões não o vê, usar Extensões → Gerenciar → Descobrir. O Discover verifica o sistema de arquivos em busca de extensões não registradas e as instala sem precisar de um ZIP.

Ativando o modelo após a instalação

A instalação de um modelo na verdade não muda seu site para ele. Essa é uma etapa separada, e é onde os iniciantes geralmente entram em pânico pensando que o modelo falhou.

1. Vamos para Sistema → Modelos → Estilos de modelo de site. (Estilos de modelo que não são de administrador, que controla a aparência do painel de administração.)
2. Encontre seu modelo recém-instalado na lista.
3. Clique no ícone de estrela no Padrão coluna para torná-lo o modelo de site ativo.
4. Carregue o frontend do seu site em uma guia anônima. O novo modelo deve ser renderizado imediatamente.

Frontend ainda mostrando Cassiopeia ou seu tema antigo? Limpe o cache do Joomla (Sistema → Manutenção → Limpar Cache) e atualize seu navegador. Um plugin de cache do lado do servidor ou um CDN como o Cloudflare também manterá a renderização antiga até que você a limpe.

Instalando um pacote de início rápido (Apenas novas instalações)

Um aviso antes das etapas: um início rápido substitui tudo. Instale-o em cima de um site Joomla em execução e de seus artigos, Comercial, módulos, e a configuração desaparece. Use o Quickstart apenas em uma conta de hospedagem em branco ou em um novo subdomínio que você reservou para isso.

1. Prepare um diretório de hospedagem limpo. Exclua todos os arquivos existentes em seu diretório de destino (public_html ou uma subpasta). Crie um banco de dados vazio e um usuário de banco de dados com privilégios totais.
2. Descompacte o ZIP de início rápido localmente. Você verá uma estrutura de pastas que parece uma versão completa do Joomla, com installation/, administrator/, e components/ diretórios.
3. Upload via FTP ou gerenciador de arquivos. Todos os arquivos e pastas vão para a raiz do seu documento. Isso pode levar 10 para 30 minutos em hospedagem compartilhada por causa da contagem de arquivos, não o tamanho total.
4. Execute o instalador web do Joomla. Abra seu domínio em um navegador. O assistente de instalação padrão do Joomla em três etapas aparece. Preencha o nome do site, credenciais de administrador, hospedeiro de banco de dados, nome do banco de dados, e usuário do banco de dados.
5. Instale dados de amostra quando solicitado. Selecione Dados de amostra padrão ou a opção rotulada pelo fornecedor (geralmente nomeado após o modelo, gostar “Dados de amostra Helix Ultimate”). Isso é o que cria a aparência de demonstração.
6. Exclua a pasta de instalação. Joomla vai incomodar você sobre isso. Remover /installation via FTP quando estiver no painel de administração.

O início rápido é o caminho de menor resistência se você estiver criando um site totalmente novo e quiser o layout de demonstração. É uma mina terrestre se você já tem conteúdo. Para sites ativos, pule para a próxima seção.

Instalando conteúdo de demonstração em um site ativo (Sem substituir)

Muitos vendedores em 2026 estão abandonando totalmente o Quickstart. Joomla 4, 5, e 6 cada navio envia componentes principais ligeiramente diferentes, então os pacotes de início rápido precisam ser reconstruídos para cada versão secundária. JoomShaper, Temas baseados em Astroid, e YOOtheme agora favorecem um importação de conteúdo de demonstração fluxo de trabalho. É menos espetacular que o Quickstart, mas muito mais seguro.

As etapas exatas dependem do construtor de páginas do modelo, mas o padrão é:

1. Instale o pacote de modelos usando método 1 acima de.
2. Instale a estrutura do modelo se o fornecedor enviar um (Hélice, SP Page Builder, Astroide). Chega como seu próprio ZIP, instalado da mesma maneira.
3. Importar conteúdo de demonstração através da tela de importação do framework. Para construtor de páginas SP: Componentes → SP Page Builder → Complementos → Importar. Para Astroide: Componentes → Astroid → Importar demonstração.
4. Menus e módulos do mapa. As importações de demonstração geralmente criam menus órfãos que precisam de um item de menu. Reveja Menus → Menu Reproduzir e atribua a página inicial de demonstração como padrão.

Seu conteúdo existente, Comercial, e as configurações permanecem exatamente onde estão. A compensação: o conteúdo de demonstração geralmente é importado como páginas independentes, em vez de uma estrutura adequada de artigo e categoria, então você ainda pode acabar copiando parágrafos em seus próprios artigos posteriormente.

Solução de erros comuns de instalação

Quatro erros cobrem a maior parte do que aparece nos fóruns de suporte do Joomla. Corrija-os nesta ordem.

Erro: Não foi possível detectar o arquivo de manifesto

Esmagadoramente, isso significa que o Safari ou o Chrome extraiu automaticamente seu download. Joomla precisa do ZIP original, não a pasta extraída. Baixe novamente o arquivo e desative a extração automática em seu navegador. Se o ZIP estiver intacto, a segunda causa é uma estrutura de pastas aninhadas (ZIP contém uma pasta que contém outra pasta que contém o manifesto). Extraia localmente, encontre a pasta com templateDetails.xml, compactar novamente apenas o conteúdo dessa pasta, e carregue o novo ZIP.

Erro: JFolder::crio: Não foi possível criar a pasta

Permissões de arquivo. SSH ou FTP e execute chmod 755 em /tmp, /templates, e /cache. Em hospedagem gerenciada sem acesso shell, abra um ticket de suporte e peça para redefinir as permissões da pasta Joomla. É uma solução de dois minutos da parte deles.

Erro: Tamanho de memória permitido esgotado

O limite de memória do PHP é muito baixo. Editar php.ini ou coloque isso em .htaccess: php_value memory_limit 256M. A maioria 2026 hospedagem compartilhada vem com 128 MB ou 256 MB, mas planos mais antigos ainda permanecem por aí 64 MB. Se o seu anfitrião se recusar a aumentá-lo, uma Plano de hospedagem VPS coloca as configurações do PHP de volta em suas mãos.

Tela branca após ativar o modelo

Os arquivos PHP do modelo estão gerando um erro, geralmente devido a uma dependência de extensão ausente ou a uma lacuna de compatibilidade do Joomla 4 a 6. Renomeie a pasta do modelo em /templates/ através de FTP. Isso quebra a tarefa e Joomla volta para Cassiopeia, para que você possa fazer login novamente. Em seguida, instale a versão correta do modelo e exclua a pasta quebrada. Uma página em branco em um site ativo é alarmante, mas a correção leva menos de cinco minutos quando você sabe onde procurar.

O que fazer depois que o modelo estiver ativo

A instalação é a parte fácil. As próximas horas determinam se o site permanecerá rápido e funcionando após a próxima atualização do Joomla.

Personalize através da tela de parâmetros do modelo em vez de editar os arquivos de origem. Sistema → Modelos → Estilos de modelo de site → seu modelo expõe cores, fontes, logotipo, e opções de layout. As edições feitas aqui sobrevivem às atualizações do modelo. Edições feitas diretamente em /templates/yourtheme/css/template.css será substituído na próxima vez que você atualizar o modelo.

Se o modelo enviar suporte para modelo filho (Cassiopéia faz, e a maior parte do Joomla 6 modelos faça agora), crie um modelo filho para CSS personalizado e substituições. O pai permanece atualizável, a criança carrega suas mudanças. O filho Cassiopeia do Joomla 6 adiciona personalização de cores e fontes prontas para uso, o que é honestamente uma das mudanças mais úteis no 6.0 liberação.

E teste no celular. Modelos que parecem elegantes no desktop quebram rotineiramente em 390 pixels de largura. Chrome DevTools’ emulador de dispositivo é gratuito e captura a maior parte em dez minutos.

Se você ainda está escolhendo hospedagem, nosso comparação de hospedagem compartilhada cobre o final do orçamento. Para o nível mais rápido, onde o administrador do Joomla para de se sentir lento, veja nosso Guia de hospedagem SSD.

perguntas frequentes

Posso instalar um início rápido do Joomla em um site existente??

Não. Um pacote Quickstart é uma instalação completa do Joomla mais um banco de dados de demonstração. Executá-lo em cima de um site existente substitui tudo em seu banco de dados e na raiz do documento. Para sites ativos, instale apenas o pacote de modelo, em seguida, importe o conteúdo de demonstração por meio da estrutura do modelo (SP Page Builder, Astroide, ou similar).

Por que Joomla diz “Não foi possível detectar o arquivo de manifesto” quando eu instalo um modelo?

Nove em cada dez vezes, seu navegador extraiu automaticamente o ZIP quando você baixou. Joomla espera o arquivo compactado original, não a pasta descompactada. Baixe novamente com a extração automática desativada. Se o ZIP estiver intacto, o modelo contém uma estrutura de pastas aninhada. Extrair, localize a pasta que contém templateDetails.xml, e compactar novamente seu conteúdo.

Joomla 6 ainda oferece suporte a pacotes de início rápido?

sim, mas o suporte do fornecedor é misto. Joomla 6.1 aceita pacotes de início rápido criados para 6.x, mas muitos fornecedores pararam de criá-los separadamente para cada versão secundária e passaram a importar conteúdo de demonstração. Verifique a página de documentação do seu modelo para um Joomla 6 Início rápido antes de presumir que existe um. Se o fornecedor oferecer apenas um Joomla 4 ou 5 Início rápido, não execute-o em um servidor 6.x.

Como altero o modelo padrão do Joomla sem perder meu conteúdo?

Vamos para Sistema → Modelos → Estilos de modelo de site, encontre o modelo que você deseja, e clique no ícone de estrela. Seus artigos, menus, módulos, e os usuários ficam exatamente onde estão. Apenas a camada visual muda. A única ressalva: módulos atribuídos a posições que não existem no novo modelo tornam-se invisíveis até que você os reatribua a posições válidas.

Qual é a diferença entre dados de amostra do Joomla e um pacote de início rápido?

Dados de amostra são o conjunto de artigos e menus de exemplo que o Joomla oferece durante uma instalação limpa (amostra de blog, amostra de folheto, amostra padrão). Os dados de amostra são genéricos. Um guia de início rápido agrupa dados de amostra criados para um modelo específico, para que o site instalado corresponda à visualização de marketing desse modelo. Ambos são executados através do instalador web Joomla, não o Gerenciador de extensões.

Quanto tempo leva para instalar um template Joomla?

Uma instalação somente de modelo por meio do Extension Manager leva 30 para 90 segundos de ponta a ponta, incluindo o clique de ativação. Uma instalação completa do Quickstart é executada 15 para 45 minutos, a maior parte é gasta no upload dos arquivos para o seu servidor. As importações de conteúdo de demonstração ficam entre os dois, usualmente 2 para 10 minutos, dependendo de quantas páginas e módulos o fornecedor incluiu.

Palavra final

O processo de instalação em si leva cinco cliques. O que quebra as pessoas é não saber qual arquivo baixaram. ZIPs de modelo passam pelo Extension Manager, ZIPs de início rápido passam por uma nova instalação do Joomla, pacotes de conteúdo de demonstração passam pela ferramenta de importação do próprio modelo. Esses três caminhos nunca se cruzam.

Para um site em execução, o padrão seguro é sempre: instale o modelo, ative-o, importe o conteúdo de demonstração se precisar do layout, personalizar através de parâmetros de modelo. O início rápido está reservado para o primeiro dia de um novo domínio. Depois de internalizar essa divisão, A instalação do template Joomla se torna chata, qual é a resposta emocional correta a um processo de cinco cliques.

Leitura relacionada: se você ainda não configurou o Joomla, nosso Guia do construtor AI WordPress cobre um caminho mais rápido para sites que não precisam do poder estrutural do Joomla. Para sites Joomla de alto tráfego que superam a hospedagem compartilhada, a comparação de hospedagem na nuvem tem provedores que lidam com a carga administrativa do Joomla sem travar.