Urgente

🛠️ Ajuda

Como instalar o AloukaNews

O AloukaNews é um tema gratuito para WordPress, de código livre. Ele muda a aparência do site e traz as ferramentas de live: agenda, enquetes, caixa de fofocas e overlay para o OBS. Este guia explica tudo do zero, mesmo que você nunca tenha criado um site.

1. O que é cada coisa

Para colocar um site no ar, você vai ouvir quatro palavras o tempo todo. Vale entender cada uma antes de começar:

  • WordPress

    O programa que faz o site funcionar. Você escreve as notícias num painel parecido com um editor de texto, sem precisar saber programar. É grátis.

  • Tema (ou skin)

    A "roupa" do site: cores, letras, organização das páginas e recursos extras. O AloukaNews é um tema. Trocar de tema não apaga as suas notícias.

  • Hospedagem

    O lugar onde o site fica guardado: um computador ligado 24 horas na internet. Você aluga um espaço nele, por mês ou por ano.

  • Domínio

    O endereço do site, como seusite.com.br. Também é alugado por ano. Sem domínio próprio, você usa um endereço da empresa, como seusite.wordpress.com.

Juntando tudo: o domínio é o endereço, a hospedagem é o terreno, o WordPress é a casa e o tema é a decoração. Dá para trocar a decoração quantas vezes quiser sem derrubar a casa.

Como o domínio encontra a hospedagem

Comprar um domínio é como registrar um endereço: ele ainda não sabe em qual "terreno" o seu site está. Você precisa apontar o domínio para a hospedagem. Isso se chama configurar o DNS, e é mais simples do que parece:

  1. A sua hospedagem informa dois endereços chamados servidores DNS (algo como ns1.suahospedagem.com e ns2.suahospedagem.com). Eles aparecem no painel ou no e-mail de boas-vindas.
  2. Entre no site onde você comprou o domínio, abra as configurações de DNS e troque os servidores pelos que a hospedagem passou.
  3. Espere. A mudança pode levar de alguns minutos até 48 horas para valer na internet inteira.

Dica: se você comprar o domínio na mesma empresa da hospedagem, ela costuma fazer esse apontamento sozinha. Domínios .com.br são registrados no Registro.br, que cobra algo em torno de R$ 40 por ano (confira o preço atual no site deles).

2. Escolha onde o site vai ficar

Existem três caminhos. Se você ainda não tem site, escolha um deles e siga só a parte dele.

Mais fácil

A. WordPress.com

A própria empresa cuida de segurança, atualizações e cópias de segurança. Você só escreve.

Atenção: para enviar um tema baixado, como o AloukaNews, você precisa de um plano pago que libere a instalação de temas e plugins. Os planos grátis e os mais baratos só permitem os temas da loja do WordPress.com. Os nomes dos planos mudam de tempos em tempos: na página de preços, procure o que diz "instalar plugins" ou "temas personalizados".

Mais liberdade

B. Hospedagem própria

Você contrata uma empresa de hospedagem e instala o WordPress com um clique. Costuma sair mais barato e aceita qualquer tema desde o plano mais simples.

Em troca: você (ou o painel da hospedagem) cuida das atualizações e das cópias de segurança.

Só para testar

C. No seu computador

Um programa grátis cria um WordPress que só você vê. Bom para experimentar o tema antes de pagar qualquer coisa.

Limite: ninguém mais acessa o site. Quando quiser publicar, use o caminho A ou B.

Caminho A: WordPress.com

  1. Crie uma conta em wordpress.com e crie o seu site.
  2. Em Plano (ou Fazer upgrade), assine um plano que permita instalar plugins e temas.
  3. (Opcional) Em Domínios, registre um endereço novo ou conecte um que você já tenha. O WordPress.com mostra o passo a passo do DNS.
  4. Pronto. Agora siga para Baixe o tema.

Caminho B: hospedagem própria

  1. Contrate um plano de hospedagem WordPress ou hospedagem compartilhada. É o tipo mais simples: você não precisa de VPS nem de servidor dedicado. Hostinger, HostGator, Locaweb e KingHost são exemplos de empresas no Brasil (não temos parceria com nenhuma delas).
  2. Registre um domínio (muitas hospedagens dão o primeiro ano de graça) ou aponte um que você já tem, como explicado em Como o domínio encontra a hospedagem.
  3. No painel da hospedagem (pode se chamar hPanel, cPanel, Painel do Cliente…), procure Instalar WordPress, Auto instalador ou Softaculous e clique em instalar.
  4. O instalador pede um usuário e uma senha de administrador. Anote os dois: é com eles que você entra no site.
  5. Ative o SSL (o cadeado ao lado do endereço). Quase todas as hospedagens oferecem de graça, com um botão no painel.
  6. Entre no painel do WordPress em seusite.com.br/wp-admin e siga para Baixe o tema.

Requisitos do tema: WordPress 6.4 ou mais novo e PHP 8.0 ou mais novo. PHP é a linguagem em que o WordPress é escrito, e a hospedagem escolhe a versão. Quase todas já vêm com uma versão nova; se não, procure "Versão do PHP" no painel da hospedagem.

Caminho C: no seu computador

  1. Baixe e instale o Local (grátis, para Windows, Mac e Linux).
  2. Abra o programa, clique em + e depois em Create a new site. Dê um nome, escolha usuário e senha e espere terminar.
  3. Clique em WP Admin para abrir o painel e siga para Baixe o tema.

3. Baixe o tema

⬇️ Baixar aloukanews-theme.zip

O arquivo baixado se chama aloukanews-theme.zip. Não descompacte: o WordPress precisa receber o arquivo .zip fechado.

  • Usa Mac? O Safari às vezes descompacta o arquivo sozinho e deixa só uma pasta. Se isso acontecer, clique com o botão direito na pasta aloukanews-theme e escolha Comprimir para gerar o .zip de novo.
  • Prefere baixar pelo GitHub? Na página de versões (Releases), abra a mais recente e baixe aloukanews-theme.zip na lista Assets. Evite o botão verde Code → Download ZIP: ele traz também os arquivos de programação, e a pasta vem com outro nome.

4. Instale o tema

Pelo painel do WordPress (recomendado)

  1. Entre no painel do site (seusite.com.br/wp-admin) com o seu usuário e senha.
  2. No menu da esquerda, clique em Aparência → Temas.
  3. No alto da página, clique em Adicionar novo tema. No WordPress.com, o botão pode se chamar Instalar tema.
  4. Clique em Enviar tema.
  5. Clique em Escolher arquivo, selecione o aloukanews-theme.zip e clique em Instalar agora.
  6. Quando aparecer "Tema instalado com sucesso", clique em Ativar. Pronto, o site já está com a cara do AloukaNews! 🎉

Pelo gerenciador de arquivos (se o envio der erro)

Use este caminho só se o painel do WordPress recusar o arquivo. Ele funciona em hospedagem própria, não no WordPress.com.

  1. No painel da hospedagem, abra o Gerenciador de arquivos.
  2. Entre na pasta do site (geralmente public_html) e depois em wp-content → themes.
  3. Envie o aloukanews-theme.zip para essa pasta e use a opção Extrair.
  4. Confira se ficou assim: wp-content/themes/aloukanews-theme/style.css. Se ficou uma pasta dentro da outra, mova a de dentro para themes.
  5. Apague o .zip e ative o tema em Aparência → Temas.

Quem já usa um programa de FTP, como o FileZilla, pode fazer o mesmo: descompacte o arquivo no computador e envie a pasta aloukanews-theme para wp-content/themes.

5. Deixe o site com a sua cara

Com o tema ativo, estes ajustes deixam tudo funcionando. Faça na ordem; leva uns 15 minutos.

  1. Nome e frase do site. Em Configurações → Geral, preencha Título do site e Descrição. Eles aparecem no topo e no rodapé.
  2. Endereços bonitos. Em Configurações → Links permanentes, marque Nome do post e clique em Salvar alterações. Sem isso, páginas como a agenda e o overlay podem dar "página não encontrada".
  3. Seu logo. Em Aparência → Personalizar → Identidade do site, envie a imagem do logo. Enquanto não houver logo, o topo mostra o nome do site. Na mesma tela fica o Ícone do site, a imagem pequena que aparece na aba do navegador. O tema já cadastra um ícone do AloukaNews, e você pode trocar pelo seu.
  4. Páginas especiais. Em Páginas → Adicionar nova página, crie uma página para cada recurso que quiser usar. Na barra da direita, aba Página, clique em Modelo e escolha: Manda a fofoca, Seja um streamer parceiro, Agenda das lives, Overlay da live ou Ajuda: como instalar o tema. Publique cada uma.
  5. Menus. Em Aparência → Menus, crie um menu, marque as páginas e categorias que quer mostrar e escolha onde ele aparece: Menu principal (topo) ou Menu do rodapé. Clique em Salvar menu.
  6. Barra lateral. Em Aparência → Widgets, arraste para a Barra lateral os blocos que começam com AloukaNews: (Mais lidas, Ao vivo agora, Enquete, Agenda…).
  7. Streamers. Em Streamers → Adicionar streamer, coloque o nome, a foto (em Imagem destacada), o nome de usuário da Twitch, as redes, a cor e os dias de live.
  8. Influs. Em Influs → Adicionar influ, cadastre os influenciadores que mais aparecem nas suas matérias: nome, foto, mini bio e redes. Cada um ganha um perfil com a linha do tempo das matérias. Quem for citado pelo nome numa notícia nova entra sozinho; para ajustar, use a caixa Influs citados na notícia.
  9. Ajustes do AloukaNews. Em Configurações → AloukaNews, cole o link do Discord ou do grupo da comunidade (aparece no rodapé) e escreva os recados da faixa de "Urgente".

Opcional: mostrar sozinho quem está ao vivo

Sem esta etapa, você marca "Ao vivo agora" à mão no cadastro do streamer. Com ela, o site pergunta para a Twitch a cada minuto.

  1. Entre em dev.twitch.tv/console com a sua conta da Twitch. A Twitch exige que a conta tenha verificação em duas etapas ligada.
  2. Clique em Register Your Application (Registrar aplicativo). Dê qualquer nome, preencha OAuth Redirect URLs com http://localhost, escolha a categoria Website Integration e crie.
  3. Clique em Manage (Gerenciar). Copie o Client ID, clique em New Secret e copie o segredo que aparecer.
  4. Cole os dois em Configurações → AloukaNews e salve.

Opcional: overlay no OBS

No OBS, em Fontes, clique em + → Navegador. No endereço, coloque seusite.com.br/overlay/ (a página com o modelo Overlay da live), largura 1920 e altura 1080. A manchete, os vídeos e as enquetes enviados pelo site aparecem por cima da live.

A câmera está no canto e cobre o palco? Na barra de cima do palco de mídias, use os botões ◧ ◫ ◨ para deixá-lo à esquerda, no centro ou à direita, ou arraste a barra para colocá-lo onde quiser. O site lembra a posição da próxima vez.

6. Atualize para uma versão nova

Quando sair uma versão nova, baixe o .zip de novo pelo mesmo botão e repita o envio em Aparência → Temas → Adicionar novo tema → Enviar tema. O WordPress avisa que o tema já existe: clique em Substituir o atual pelo enviado. Suas notícias, páginas, menus e ajustes continuam no lugar.

7. Deu ruim? Problemas comuns

"O arquivo enviado excede o tamanho máximo permitido"

A hospedagem limita o tamanho dos envios. Instale pelo gerenciador de arquivos ou peça ao suporte da hospedagem para aumentar o limite de upload.

"O pacote não pôde ser instalado. O tema não tem a folha de estilo style.css"

O .zip enviado não é o do tema, ou tem uma pasta dentro da outra. Baixe de novo pelo botão Baixar o tema e envie o arquivo sem descompactar.

Não aparece a opção "Enviar tema" no WordPress.com

O seu plano não permite instalar temas de fora. Veja o caminho A: é preciso um plano que libere plugins e temas.

O site ficou sem cores, tudo branco e desalinhado

Faltou a pasta dist, onde ficam o visual e os recursos do tema. Isso acontece com o .zip errado. Baixe o arquivo pelo botão desta página e instale de novo.

"Página não encontrada" na agenda, no overlay ou nos streamers

Vá em Configurações → Links permanentes e clique em Salvar alterações, mesmo sem mudar nada. Isso refaz os endereços do site.

"Houve um erro crítico neste site" depois de ativar

Quase sempre é a versão do PHP antiga. No painel da hospedagem, mude para PHP 8.0 ou mais novo. Se não conseguir entrar no painel do WordPress, abra o gerenciador de arquivos e renomeie a pasta wp-content/themes/aloukanews-theme (por exemplo, para aloukanews-theme-off): o WordPress volta para o tema anterior.

Comprei o domínio, mas ele não abre o site

O apontamento (DNS) pode levar até 48 horas. Se passar disso, confira se os servidores DNS cadastrados no domínio são exatamente os que a hospedagem passou.

Trocar de tema apaga as minhas notícias?

Não. Notícias, páginas, imagens e comentários ficam guardados no WordPress, não no tema. Se você voltar para outro tema, só a aparência muda. As enquetes e os streamers são recursos do AloukaNews: eles somem da tela, mas continuam salvos e voltam quando o tema é ativado de novo.

Não achou a sua dúvida? Abra uma pergunta no GitHub (é preciso criar uma conta gratuita) contando o que aconteceu e, se puder, uma captura de tela.

8. Para quem programa

O tema usa WordPress, Parcel, TailwindCSS, Swup.js e React. A pasta dist já vem pronta, então ninguém precisa compilar nada para usar o tema. Para mudar o código-fonte em src, rode npm install e depois npm run build. Os detalhes estão no README do projeto.