Como criar taxonomias personalizadas para sites de construtoras e incorporadoras no WordPress

Hoje, abordaremos um tema que é como o alicerce de um edifício em construção — importante e fundamental. Falamos sobre como criar taxonomias personalizadas no WordPress para sites de construtoras e incorporadoras.

Introdução

O que é uma taxonomia personalizada?

A palavra “taxonomia” pode lembrar você de aulas de biologia, onde aprendeu a categorizar animais e plantas. No mundo WordPress, é quase a mesma coisa. Taxonomias são uma forma de agrupar conteúdos de maneira ordenada.

Exemplo: Você tem um site de uma construtora e quer agrupar os projetos de acordo com as cidades onde estão localizados. Uma taxonomia personalizada chamada “Cidades” seria a solução perfeita.

Por que personalizar

Bem, o WordPress já vem com taxonomias prontas, como categorias e tags. “Então por que reinventar a roda?”, você deve estar se perguntando. Calma, temos bons motivos.

O motivo é simples: Personalização permite maior controle. Isso é como ter um guindaste em um canteiro de obras; você pode levantar o que quiser, para onde quiser e quando quiser.

Como criar as taxonomias personalizadas

1. Abrir o arquivo functions.php

Vá até o painel de controle do seu tema WordPress e localize o arquivo functions.php. Abra-o, ele é como o projeto arquitetônico do seu site.

2. Colocar o código para registrar a taxonomia

Agora, a parte que realmente interessa: o código. No exemplo que estamos usando, o código não só cria duas taxonomias (Cidades e Disponibilidade), mas também um tipo de post personalizado chamado “Empreendimentos”.

// Criação do Custom Post Type: Empreendimentos
function create_empreendimentos_post_type() {
    $labels = array(
        'name'                  => _x('Empreendimentos', 'Post Type General Name'),
        'singular_name'         => _x('Empreendimento', 'Post Type Singular Name'),
        'menu_name'             => __('Empreendimentos'),
        'name_admin_bar'        => __('Empreendimento'),
        'archives'              => __('Arquivo de empreendimentos'),
        'attributes'            => __('Atributos do empreendimento'),
        'parent_item_colon'     => __('Empreendimento pai:'),
        'all_items'             => __('Todos os empreendimentos'),
        'add_new_item'          => __('Adicionar novo empreendimento'),
        'add_new'               => __('Adicionar novo'),
        'new_item'              => __('Novo empreendimento'),
        'edit_item'             => __('Editar empreendimento'),
        'update_item'           => __('Atualizar empreendimento'),
        'view_item'             => __('Ver empreendimento'),
        'view_items'            => __('Ver empreendimentos'),
        'search_items'          => __('Pesquisar empreendimentos'),
        'not_found'             => __('Não encontrado'),
        'not_found_in_trash'    => __('Não encontrado na lixeira'),
        'featured_image'        => __('Imagem destaque'),
        'set_featured_image'    => __('Definir imagem destaque'),
        'remove_featured_image' => __('Remover imagem destaque'),
        'use_featured_image'    => __('Usar como imagem destaque'),
        'insert_into_item'      => __('Inserir no empreendimento'),
        'uploaded_to_this_item' => __('Enviado para este empreendimento'),
        'items_list'            => __('Lista de empreendimentos'),
        'items_list_navigation' => __('Navegação de lista de empreendimentos'),
        'filter_items_list'     => __('Filtrar lista de empreendimentos'),
    );

    $args = array(
        'label'                 => __('Empreendimento'),
        'description'           => __('Descrição do Empreendimento'),
        'labels'                => $labels,
        'supports'              => array('title', 'editor', 'thumbnail', 'revisions', 'author'),
        'hierarchical'          => false,
        'public'                => true,
        'show_ui'               => true,
        'show_in_menu'          => true,
        'menu_position'         => 5,
        'show_in_admin_bar'     => true,
        'show_in_nav_menus'     => true,
        'can_export'            => true,
        'has_archive'           => true,
        'exclude_from_search'   => false,
        'publicly_queryable'    => true,
        'show_in_rest'          => true, // Isto permite o suporte ao Gutenberg.
        'capability_type'       => 'post',
    );

    register_post_type('empreendimentos', $args);
}

add_action('init', 'create_empreendimentos_post_type', 0);

// Taxonomia personalizada: Cidades
function create_cidades_taxonomy() {
    $labels = array(
        'name' => _x('Cidades', 'taxonomy general name'),
        'singular_name' => _x('Cidade', 'taxonomy singular name'),
        'search_items' => __('Pesquisar cidades'),
        'all_items' => __('Todas as cidades'),
        'parent_item' => __('Cidade pai'),
        'parent_item_colon' => __('Cidade pai:'),
        'edit_item' => __('Editar cidade'),
        'update_item' => __('Atualizar cidade'),
        'add_new_item' => __('Adicionar nova cidade'),
        'new_item_name' => __('Nome da nova cidade'),
        'menu_name' => __('Cidades'),
    );

    $args = array(
        'hierarchical' => true,
        'labels' => $labels,
        'show_ui' => true,
        'show_admin_column' => true,
        'query_var' => true,
        'show_in_rest' => true, // Isto permite o suporte ao Gutenberg.
        'rewrite' => array('slug' => 'cidade'),
    );

    register_taxonomy('cidades', array('empreendimentos'), $args);
}

add_action('init', 'create_cidades_taxonomy');

// Taxonomia personalizada: Disponibilidade
function create_disponibilidade_taxonomy() {
    $labels = array(
        'name' => _x('Disponibilidades', 'taxonomy general name'),
        'singular_name' => _x('Disponibilidade', 'taxonomy singular name'),
        'search_items' => __('Pesquisar disponibilidades'),
        'popular_items' => __('Disponibilidades populares'),
        'all_items' => __('Todas as disponibilidades'),
        'edit_item' => __('Editar disponibilidade'),
        'update_item' => __('Atualizar disponibilidade'),
        'add_new_item' => __('Adicionar nova disponibilidade'),
        'new_item_name' => __('Nome da nova disponibilidade'),
        'separate_items_with_commas' => __('Separe disponibilidades com vírgulas'),
        'add_or_remove_items' => __('Adicionar ou remover disponibilidades'),
        'choose_from_most_used' => __('Escolha entre as disponibilidades mais usadas'),
        'not_found' => __('Nenhuma disponibilidade encontrada'),
        'menu_name' => __('Disponibilidades'),
    );

    $args = array(
        'hierarchical' => false,
        'labels' => $labels,
        'show_ui' => true,
        'show_admin_column' => true,
        'query_var' => true,
        'show_in_rest' => true, // Isto permite o suporte ao Gutenberg.
        'rewrite' => array('slug' => 'disponibilidade'),
    );

    register_taxonomy('disponibilidade', array('empreendimentos'), $args);
}

add_action('init', 'create_disponibilidade_taxonomy');

Perceba que, em ambos os casos, estamos usando a função add_action('init', 'nome_da_funcao'); para registrar nossas taxonomias e o tipo de post. Esta é a “pedra fundamental” de todo o processo, tornando tudo isso possível no WordPress.

Nota: A palavra 'empreendimentos' no código faz uma ponte entre o tipo de post e as taxonomias, indicando que estas últimas se aplicam ao tipo de post 'empreendimentos'.

3. Salvar e testar

Depois de adicionar o código, salve o arquivo functions.php. Não esqueça de testar para garantir que tudo está funcionando como deveria. Imagine se um engenheiro não testasse a resistência de um pilar. Nada bom, concorda?

Não quero ser o portador de más notícias, mas atenção: erros de sintaxe podem quebrar seu site. Então, sempre faça backup antes de fazer alterações significativas. É como ter um plano B em um projeto de construção; é sempre bom ter um.

Agora você já sabe como criar taxonomias personalizadas em WordPress, mais especificamente para sites de construtoras e incorporadoras. Não é tão complicado quanto parece, não é mesmo? Ou, para manter a analogia com o mundo das construções, não é como levantar um prédio de 50 andares.

Então, coloque o capacete, suba no guindaste e mãos à obra. Afinal, o seu projeto WordPress não vai se construir sozinho, vai?

Espero que este guia tenha sido útil. E então, quais serão suas próximas construções no mundo digital? Estou ansioso para saber!