list_categories()

Exibe uma lista hierárquica de categorias de postagens.

• $args array (opcional)
  Argumentos utilizados para filtragem e personalização da listagem.
  Argumentos disponíveis:
  • except array
    Lista de slugs de categorias que devem ser removidas da listagem.
  • thumbnail bool
    Exibe a miniatura da categoria quando disponível. Padrão: false
  • active_item bool
    Adiciona a classe .active ao item correspondente à categoria atual. Padrão: true
  • attrs array
    Adiciona atributos personalizados ao elemento de lista principal.

Retorno: void
Imprime diretamente a estrutura HTML da listagem hierárquica.

<aside>
    <h2>Categorias</h2>
    <section id="list-categories">
    <?php
        // Uso basico:
        list_categories();

        // Exemplo com atributos personalizados
        list_categories([
            'attrs' => [
                'class' => 'custom-listcats'
            ],
            'thumbnail' => true,
            'except'    => ['private', 'hidden'],
        ]);

        // Sem highlight da categoria ativa 
        list_categories([ 'active_item' => false ]);
    ?>
    </section>
</aside>

• A função utiliza internamente o método list() da classe Category.
• A classe .active é adicionada automaticamente em páginas de listagem de posts por categoria.
• O elemento principal da listagem utiliza a classe padrão .listcats, necessária para funcionamento interno do sistema.
• Evite utilizar a classe .listcats para estilizações específicas do site. Prefira adicionar classes personalizadas através do argumento attrs.
• A estrutura hierárquica é processada utilizando abordagem iterativa, evitando recursão.