Como criar categorias e subcategorias no LaraClas – Tutorial passo a passo

O LaraClas é um script de classificados em Laravel com suporte nativo a categorias, subcategorias e campos personalizados por categoria. Isso permite organizar anúncios de forma hierárquica, facilitando a navegação do usuário e a gestão do conteúdo.

A seguir, você verá um passo a passo de como criar categorias e subcategorias usando o Painel Administrativo (Painel Admin) do LaraClas.

1. Pré-requisitos

Antes de começar, verifique:

1. O LaraClas já está instalado e acessível pelo navegador.

2. Você possui um usuário com perfil de administrador (acesso ao Painel Admin).

2. Entendendo a estrutura de categorias no LaraClas

No LaraClas, a estrutura de categorias funciona de forma hierárquica:

• Categoria principal (raiz)
  É a categoria de nível mais alto, sem “pai”. Exemplos:

  • Veículos

  • Imóveis

  • Empregos

• Subcategoria
  É uma categoria que tem uma categoria “pai”. Exemplos:

  • Veículos → Carros

  • Veículos → Motos

  • Imóveis → Apartamentos

  • Imóveis → Casas

• Campos personalizados por categoria
  Cada categoria pode ser associada a um conjunto de campos personalizados. Por exemplo:

  • Em “Carros”: Ano, Quilometragem, Combustível, Câmbio

  • Em “Imóveis”: Área, Número de quartos, Vagas de garagem

Além disso, os nomes das categorias são entradas traduzíveis no banco de dados, ou seja, se o seu site é multilíngue, você precisa traduzir esses nomes via Painel Admin. Como você já traduziu tudo para PT-BR, os rótulos do painel já aparecerão em português.

3. Acessando a área de categorias no Painel Admin

1. Acesse o Painel Administrativo do seu site.

2. Faça login com seu usuário administrador.

3. No menu lateral, procure o grupo Anúncios.

4. Dentro do grupo Anúncios, clique em Categorias.

É nessa tela (Anúncios → Categorias) que você gerencia as categorias e subcategorias.

Você verá uma listagem com colunas como:

• Categoria

• Campos personalizados

• Ativo

• Ações

4. Criando uma categoria principal (raiz)

Vamos criar uma categoria de topo, por exemplo “Veículos”.

1. Na tela Anúncios → Categorias, clique no botão Adicionar ou Adicionar categoria.

2. Você será levado a um formulário de criação/edição de categoria.

No formulário, preencha os campos principais:

4.1. Campo “Pai”

• Pai (ou “Categoria pai”): selecione Raiz (ou deixe em branco, dependendo de como aparece na sua tradução) para indicar que esta categoria é uma categoria principal.

4.2. Campo “Nome”

• Nome: insira o nome da categoria, por exemplo:

  • Veículos

Se o seu site tiver mais de um idioma, é possível que o formulário tenha abas ou campos separados por idioma. No seu caso, como o padrão é PT-BR, basta garantir que o campo em Português do Brasil esteja preenchido corretamente.

4.3. Campo “Slug”

• Slug: é a versão amigável do nome para a URL (sem espaços, acentos ou caracteres especiais). Exemplo:

  • veiculos

Em muitas instalações, se você deixar o slug em branco, o próprio sistema gera o slug automaticamente a partir do nome. De qualquer forma, manter um padrão ajuda na organização.

4.4. Campo “Descrição”

• Descrição: texto opcional explicando a categoria. Exemplo:

  • “Categoria destinada a carros, motos e outros tipos de veículos.”

4.5. Campo “Imagem” ou “Ícone”

Dependendo da versão e do tema, você pode ter:

• Campo Imagem para subir um ícone ou imagem da categoria; ou

• Uma interface para selecionar um ícone para a categoria.

Essa imagem/ícone costuma ser utilizada:

• Na área de categorias da página inicial;

• Em listagens de categorias, dependendo do tema.

Dica: use ícones simples, leves e que combinem com o layout do site.

4.6. Campo “Ativo”

• Verifique se o campo Ativo está marcado como Sim.

• Somente categorias ativas aparecem para os usuários no site.

4.7. Salvar a categoria

1. Revise os campos preenchidos.

2. Clique em Salvar (ou Salvar e voltar, conforme a tradução que você adotou).

Pronto: a categoria principal “Veículos” está criada e pronta para ser usada pelos anúncios.

5. Criando subcategorias

Agora vamos criar uma subcategoria “Carros” dentro de “Veículos”.

1. Volte para Anúncios → Categorias no Painel Admin.

2. Clique em Adicionar ou Adicionar categoria para criar uma nova categoria.

3. No formulário, preencha:

5.1. Definir a categoria “Pai”

• Em Pai (ou “Categoria pai”), selecione a categoria principal que você criou antes, por exemplo:

  • Veículos

Isso fará com que a nova entrada seja uma subcategoria de “Veículos”.

5.2. Nome, slug e descrição

• Nome: Carros

• Slug: carros

• Descrição (opcional): “Anúncios de carros novos e usados.”

5.3. Imagem/ícone da subcategoria

• Se quiser, adicione uma imagem ou ícone específico para “Carros”.

• É comum utilizar ícones somente nas categorias principais, mas nada impede que todas tenham ícones.

5.4. Marcar como ativa e salvar

• Confirme que o campo Ativo está como Sim.

• Clique em Salvar.

Repita o mesmo processo para outras subcategorias de “Veículos”, como:

• Motos – slug motos

• Caminhões – slug caminhoes

• Peças e acessórios – slug pecas-acessorios

6. Traduzindo nomes de categorias (caso use outros idiomas)

Mesmo que o idioma principal seja PT-BR, se você ativar outros idiomas no sistema, lembre-se de que as categorias são traduzíveis.

6.1. Editando a própria categoria

1. Em Anúncios → Categorias, localize a categoria desejada.

2. Clique em Editar.

3. Caso existam abas ou campos por idioma, preencha o Nome e a Descrição em cada idioma que o seu site utiliza.

4. Clique em Salvar.

6.2. Conferindo após adicionar novos idiomas

Sempre que você adicionar um novo idioma em Configurações → Idiomas, é recomendável:

• Revisar todas as Categorias em Anúncios → Categorias;

• Garantir que cada categoria tenha Nome (e, se desejar, Descrição) no novo idioma.

Assim você evita que, em outros idiomas, as categorias apareçam vazias ou ainda em português.

7. Ligando categorias a campos personalizados (opcional, mas muito útil)

Um dos recursos mais fortes do LaraClas é que você pode ter campos personalizados por categoria, tornando o cadastro de anúncios muito mais adequado a cada tipo de item.

Exemplos:

• Categoria “Carros”:

  • Ano, Quilometragem, Combustível, Câmbio, Direção, Cor

• Categoria “Imóveis”:

  • Área (m²), Número de quartos, Número de banheiros, Vagas de garagem, Tipo de imóvel

Em geral, o fluxo é:

1. No menu do Painel Admin, vá em Anúncios → Campos personalizados (ou equivalente, conforme sua tradução).

2. Crie os campos que você precisa (texto, número, lista, etc.).

3. Em seguida, volte em Anúncios → Categorias.

4. Na linha da categoria (por exemplo, “Carros”), clique em uma ação do tipo Campos personalizados ou Configurar campos (dependendo da tradução).

5. Associe os campos personalizados à categoria desejada.

Dessa forma:

• Anúncios em “Carros” verão apenas campos relevantes para carros.

• Anúncios em “Imóveis” verão apenas campos relevantes para imóveis.

8. Boas práticas para organizar categorias e subcategorias

Para evitar bagunça na taxonomia do seu site:

1. Planeje a estrutura antes de cadastrar

   • Liste, em um bloco de notas ou planilha, as categorias principais e suas subcategorias.

   • Tente não passar de 8 a 10 categorias principais, para não poluir o menu e a página inicial.

2. Evite excesso de profundidade

   • Sempre que possível, use apenas 2 níveis (Categoria → Subcategoria).

   • Só crie um terceiro nível se realmente for necessário.

3. Use nomes curtos e objetivos

   • Prefira “Carros” a “Veículos automotores de passeio com quatro rodas”.

4. Padronize slugs

   • Tudo em minúsculas.

   • Sem acentos.

   • Utilize hífens para separar palavras (ex.: pecas-acessorios).

5. Revise após grandes mudanças

   • Sempre que você criar novas categorias ou subcategorias, dê uma olhada no site como usuário final para verificar se a navegação está clara.

9. Checklist rápido

Use este checklist para confirmar que tudo está configurado corretamente:

• Consigo acessar o Painel Admin.

• Acesso o menu Anúncios → Categorias sem erros.

• Cadastrei as categorias principais definindo o campo Pai como Raiz.

• Criei subcategorias escolhendo corretamente a categoria Pai.

• Defini um slug limpo e padronizado para cada categoria e subcategoria.

• Adicionei imagem/ícone nas categorias que aparecem na página inicial (se o meu tema usar isso).

• Marquei todas as categorias necessárias como Ativo = Sim.

• (Se uso outros idiomas) revisei e preenchi as traduções das categorias em todos os idiomas ativos.

• (Opcional) Vinculei campos personalizados às categorias mais importantes, como “Carros” e “Imóveis”.

Seguindo estes passos, você terá uma estrutura de categorias e subcategorias bem organizada no LaraClas, pronta para receber anúncios de forma clara, profissional e escalável.