Como criar tipos de posts personalizados no WordPress (via plugin e código)

Principais conclusões

• Os tipos de post personalizados permitem criar conteúdo além dos posts e páginas padrão, como portfólios, notícias ou produtos, tornando o WordPress num CMS mais poderoso e organizado.
• Podes criá-los de três formas: com o plugin Custom Post Type UI, criando um plugin personalizado ou editando diretamente o ficheiro functions.php — cada método adequado a diferentes níveis técnicos.
• Após criar um tipo de post personalizado, é necessário configurar um modelo dedicado e atualizar os Permalinks para evitar erros 404 e garantir uma apresentação correta no frontend.

Quando instalas o WordPress, recebes inicialmente cinco tipos de conteúdo incorporados (tipos de publicação): Posts, Páginas, Anexos, Revisões e Menus de Navegação.

No entanto, à medida que a diversidade de utilizações aumenta, estas opções padrão podem não satisfazer as necessidades de todos.

Para resolver este problema, o WordPress evoluiu para se tornar mais flexível e avançado. É aí que entram em jogo os tipos de post personalizados do WordPress. Eles oferecem uma maneira de criar e gerenciar conteúdo que vai além dos posts, páginas e mídia padrão.

Neste post do blogue, vou guiar-te através da criação e gestão de tipos de posts personalizados no WordPress, desde a compreensão da sua importância até à resolução de problemas comuns, incluindo a forma como podem ser aproveitados numa configuração WordPress sem cabeça para uma entrega de conteúdos mais dinâmica e flexível…

Vamos começar…

O que são tipos de post personalizados?

Os tipos de post personalizados no WordPress podem transformar o teu site num CMS poderoso. Permitem-te criar diferentes tipos de conteúdo para além dos posts, páginas e media padrão.

Não há limite para o número de tipos de post personalizados que podes criar, mas geri-los de forma eficiente é importante para evitar confusão e problemas de desempenho.

Por exemplo, se geres um sítio Web de notícias, podes criar um tipo de publicação personalizado com o título “Notícias”. Este novo tipo terá a sua própria secção dedicada na área de administração do painel de controlo do WordPress. Podes criar tantos tipos de publicação quantos forem necessários, como “Filmes”, “Portfólios” e outros.

Tipos de posts personalizados sem penalizações de velocidade

Tempos de resposta de consulta de 300 ms, mesmo com mais de 50 mil entradas
Armazenamento em cache de objectos Redis incorporado
Recursos isolados para tipos de publicação complexos

Implantar meu servidor pronto para CPT

Tipos de post padrão vs. personalizados

Tanto os tipos de post predefinidos como os personalizados têm as suas próprias utilizações e podem coexistir no teu site WordPress para proporcionar uma experiência de conteúdo rica e diversificada. Olha para as suas diferenças!

	Tipo de publicação predefinido	Tipos de Postos Personalizados
Disponibilidade	Disponível por defeito quando instalas o WordPress.	Necessita de ser criado manualmente ou com um plugin.
Tipos de publicações	Posts, Páginas e Media.	Ilimitado, com base nas tuas necessidades (por exemplo, Notícias, Filmes, Portfólios).
Flexibilidade	Limita-se às opções incorporadas.	Consegue gerir as mensagens de todos os utilizadores. Pode publicar e editar as suas próprias mensagens e as de outros utilizadores.
Utilização	Ideal para publicações de blogues padrão, páginas estáticas e ficheiros multimédia.	Ideal para conteúdos especializados que não se enquadram nos tipos de publicação predefinidos.

Por que usar tipos de post personalizados?

Aqui estão mais algumas razões pelas quais deves utilizar tipos de posts personalizados no WordPress:

1. Ajudam a manter o teu sítio Web organizado, separando os diferentes tipos de conteúdo.
2. Tornam mais fácil para os visitantes encontrarem o que procuram no teu sítio.
3. Permitem-te adicionar caraterísticas especiais a determinadas publicações, como pontuações para críticas de livros.
4. Podem ajudar o teu sítio a aparecer melhor nos resultados dos motores de busca.
5. Facilitam a criação de conteúdo consistente e estruturado, especialmente quando várias pessoas estão a adicionar conteúdo ao teu site.

Como criar tipos de posts personalizados no WordPress [3 métodos fáceis]

A criação de tipos de post personalizados no WordPress pode ser feita através de dois métodos diferentes: via plugin ou manualmente. Cada método atende a diferentes capacidades e preferências dos utilizadores. Vamos analisá-los passo a passo.

Método 1: Criar uma publicação personalizada através de um plug-in

Podes criar um tipo de post personalizado do WordPress facilmente usando o plugin certo. Para este artigo, vou usar o plugin Custom Post Type UI para te guiar pelo processo.

Passo 1: Instalar e ativar o plugin

O primeiro passo é instalar e ativar o plugin.

1. Vai ao teu painel de controlo do WordPress.
2. Seleciona Plugins → Adicionar novo.
3. Procura o plugin “Custom Post Type UI“.
4. Instala e ativa o plugin.

Etapa 2: Configura o plug-in

Uma vez ativado, encontrarás um novo item de menu no painel de instrumentos chamado CPT UI.

• Clica em CPT UI → Adicionar/Editar tipos de publicação para criares um novo tipo de publicação personalizado.
• Preenche o Slug do tipo de publicação, que é um campo obrigatório e tem de ser único (normalmente uma cadeia de caracteres em minúsculas sem espaços).
• Adiciona os nomes no plural e no singular do teu tipo de publicação personalizada, tal como aparecerão no painel de controlo.
• Clica no botão Adicionar tipo de publicação.

Passo 3: Utilizar o teu tipo de publicação personalizado

O teu novo tipo de publicação personalizado deve agora estar visível no painel de controlo do WordPress. Podes começar a adicionar novos conteúdos clicando no item de menu do teu tipo de publicação personalizado.

• Vai a Adicionar novo e personaliza o teu tipo de publicação personalizado.

• Acrescentarei um orçamento e um formulário de contacto na minha página de notícias.
• Para o fazer, clica no sinal + (mais).
• Seleciona Cotação Puxar.

• Seleciona Formulário de Contacto 7.

• Clica no botão Publicar .
• Vê aqui o aspeto da página final das notícias.

Método 2: Criar um Plugin Personalizado para Tipos de Postos Personalizados no WordPress

Se quiseres registar um tipo de publicação personalizado sem depender de um plug-in de terceiros ou modificar o ficheiro functions.php do teu tema, criar um plug-in personalizado é a melhor solução.

Este método é portátil, o que significa que o teu tipo de post personalizado permanecerá intacto mesmo que mudes de tema. Também mantém as tuas funções bem organizadas e separadas do código específico do tema, facilitando a manutenção.

Criar uma nova pasta de plug-ins

• Vai ao teu diretório de instalação do WordPress e acede a wp-content/plugins/.
• Se estiveres a utilizar o FileZilla (cliente FTP), liga-te ao servidor do teu sítio Web introduzindo as credenciais FTP fornecidas pelo teu fornecedor de alojamento.

• Se estiveres a usar o cPanel, podes usar o Gestor de ficheiros para aceder aos diretórios diretamente através da interface web.

Localiza o Diretório WordPress:

• Quando estiveres ligado ao teu servidor ou com sessão iniciada no teu cPanel, vai para o diretório raiz da tua instalação do WordPress. É aqui que encontras os principais ficheiros do WordPress, como o wp-config.php e o wp-content.

Navega até wp-content:

• Dentro da pasta raiz do WordPress, localiza a pasta chamada wp-content – estapasta contém todos os teus temas, plugins e uploads.

Vai para a pasta de plugins:

• Dentro de wp-content, encontra e abre a pasta plugins. É aqui que residem todos os teus plugins WordPress instalados.

Criar uma nova pasta de plug-ins

• Dentro do diretório de plugins, cria uma nova pasta chamada custom-post-type-plugin.

Cria o ficheiro Plugin

• Agora, vamos criar o ficheiro principal do plugin. Abre qualquer editor de texto (vou usar o Notepad).
• Clica em Ficheiro → Novo e cola o seguinte código:

<?php
/**
*Plugin Name: Custom Post Type Plugin
*Plugin URL: https://yourwebsite.com

*Description: A simple plugin to register a custom post type in WordPress

*Version: 1.0

*Author: Your Name

*Author URI: https://yourwebsite.com

*License: GPL2
*/

if(!defined('ABSPATH')){

 exit;//Prevent direct access
}

//Function to register the custom post type

function custom_post_type_news(){

 $args=array(
   'label'         =>__('News','textdomain'),
   'pbulic'        =>true,
   'supports'      =>array('title', 'editor', 'thumbnail', 'excerpt'),
   'menu_position' => 5,
   'menu_icon'     => 'dashicons-admin-site'
   'has_archive'   => true,
   'rewrite'       => array('slug' => 'news'),
);
 register_post_type('news',$args);

}

add_action('init', 'custom_post_type_news');

Carrega o ficheiro do plug-in

• Move o ficheiro que acabaste de criar para: wp-content/plugins/custom-post-type-plugin/
• Arrasta e larga o ficheiro custom-post-type.php do teu computador para esta pasta.

Ativar o plugin no WordPress

• Acede ao teu painel de administração do WordPress.
• Vai a Plugins → Plugins instalados.

• Procura o Plugin Custom Post Type e clica em Ativar.

Verifica o tipo de post personalizado

• No teu menu de administração do WordPress, verifica se vês uma nova secção chamada Notícias.

• Clica em Notícias → Adicionar nova publicação para a testares.

• Como podes ver, agora podemos criar um novo post para o novo tipo de post personalizado que acabámos de criar.

• Depois de publicares o conteúdo do teu tipo de post personalizado recém-criado, se vires um erro “Página não encontrada”, terás de atualizar os teus Permalinks. Eu recebi este erro, por isso vou mostrar-te como atualizar os teus Permalinks:
  • No teu painel de controlo do WordPress, vai a Definições → Permalinks.
  • Não precisas de mudar nada aqui.
  • Basta clicares no botão Guardar alterações. Isto forçará o WordPress a regenerar a estrutura de permalink e a reconhecer os novos URLs de tipo de post personalizado.
    

Método 3: Criar manualmente uma publicação personalizada no WordPress

Agora, vamos seguir estes passos para criar um tipo de publicação personalizado manualmente no teu site WordPress:

• Navega até ao ficheiro function.php no diretório do teu tema.

• Adiciona o seguinte código ao ficheiro function.php.

/*Register News Post Type*/

/* Custom Post Type Start */

function create_posttype() {

register_post_type( 'news',

// CPT Options

array(

'labels' => array(

'name' => __( 'news' ),

'singular_name' => __( 'News' )

),

'public' => true,

'has_archive' => false,

'rewrite' => array('slug' => 'news'),

)

);

}

// Hooking up our function to theme setup

add_action( 'init', 'create_posttype' );

/* Custom Post Type End */

• Depois de adicionares o código, o tipo de publicação Notícias aparecerá automaticamente no teu menu do WordPress.
  

• Quando crias tipos de posts personalizados, é necessário utilizar init para o gancho em add_action(), e a função register_post_type() receberá os argumentos.

Os passos que percorremos até agora mostraram-te como registar tipos de publicação personalizados no backend de qualquer tema do WordPress. Agora, vamos avançar e aprender como adicionar uma publicação personalizada ao teu site WordPress.

Adicionar um novo tipo de postagem personalizada do WordPress

Podes adicionar uma nova publicação personalizada ao teu site WordPress seguindo estes passos:

• Clica no tipo de correio personalizado registado, que, no nosso caso, é Notícias.
• Clica em Adicionar novo.
• Escreve o título e o corpo da tua publicação.

• Escreve o excerto e define uma imagem em destaque.
• Clica no botão Publicar para ativar a nova publicação personalizada.

Quando crias um tipo de publicação personalizado como“Notícias“, o WordPress não fornece automaticamente um layout de front-end. Sem um modelo, as tuas publicações de Notícias vão aparecer como publicações normais sem um layout dedicado. Este é exatamente o nosso caso, se olhares para a captura de ecrã acima.

Terás de criar um modelo personalizado para os apresentar num formato ou estilo específico. Vamos ver como fazer isso…

Criar um modelo para o teu tipo de publicação personalizada de notícias utilizando o FSE

Na Edição Completa do Site, os modelos são criados e atribuídos através do Editor do Site e não através de ficheiros PHP. Como estou a utilizar o tema Twenty Twenty-Four do WordPress, que utiliza totalmente a Edição Completa do Site (FSE), eis como vou criar um modelo personalizado para o meu tipo de publicação personalizada Notícias.

Cria um modelo no Full Site Editor

• Vai ao painel de controlo do WordPress e navega até Aparência > Editor.

• No Editor de Sites, clica em Modelos no painel do lado esquerdo.

• Clica no botão Adicionar novo modelo para criar um novo modelo.
• Quando aparecer a nova janela pop-up, seleciona o tipo de modelo que pretendes criar. Vou escolher um modelo Personalizado.

• Em seguida, nomeio o meu modelo como Modelo personalizado de notícias e carrego em Criar.

• Depois de criares o modelo, este abre-se no editor, onde podes adicionar blocos. É provável que queiras adicionar blocos para apresentar o conteúdo da publicação, o título e a imagem em destaque.
• Quando estiveres satisfeito com o modelo, carrega em Guardar.

O teu modelo está agora criado, mas não faz nada a não ser que lhe atribuas algo. Por isso, no nosso caso, vou atribuí-lo ao tipo de publicação News que criámos.

Atribuir o modelo ao teu tipo de post personalizado

• Para atribuir o nosso modelo ao tipo de publicação personalizada Notícias, vou criar uma nova publicação e selecionar o nosso novo modelo em Atributos da publicação.
• Também adiciono um título de publicação, o conteúdo do corpo e uma imagem em destaque.
• Quando terminar, carrego em Publicar.

• Agora, se eu vir a publicação recém-criada, vais reparar que herdou o design do modelo personalizado que criámos anteriormente.

Se estiveres a utilizar um tema que não utilize a Edição completa do site (FSE), podes seguir os passos abaixo.

Criar manualmente o arquivo de modelo para temas que não são de edição de site completo

• Abre a tua pasta de temas do WordPress (onde se encontram os teus ficheiros de temas). Podes fazer isso usando o FileZilla ou qualquer outra ferramenta FTP.
• Dentro da pasta do tema ativo que estás a utilizar, cria um novo ficheiro e dá-lhe o nome de template-news.php. Vou utilizar o tema Twenty Nineteen para este exemplo, uma vez que não suporta FSE. Este ficheiro irá apresentar o teu tipo de publicação personalizado.

Adiciona o código do modelo

• Abre o ficheiro recém-criado(template-news.php) num editor de texto (como o Notepad) e adiciona o seguinte código:

<?php 
/* Template Name: News */ 

get_header(); // Includes the site header 

?>

<?php 

// Define query arguments 

$args = array( 

    'post_type'      => 'news', // Custom post type 

    'posts_per_page' => 10, // Number of posts to display ); 

);

// Create a new WP_Query instance 

$the_query = new WP_Query($args); 

?> 


<?php if ($the_query->have_posts()) : ?> 

  <?php while ($the_query->have_posts()) : $the_query->the_post(); ?> <h2><?php the_title(); ?>

    </h2> <!-- Display the post title --> 
    <div class="entry-content">
      <?php the_content(); ?> <!-- Display the post content -->
    </div>
  <?php endwhile; ?>


 <?php wp_reset_postdata(); // Reset the post data to restore the global $post object ?>

<?php else : ?>
  
  <p><?php esc_html_e('Sorry, no posts matched your criteria.', 'textdomain'); ?></p> <!-- Fallback message -->

<?php endif; ?>

<?php

get_footer(); // Includes the site footer

?>

<?php wp_reset_postdata(); // Repõe os dados do post para restaurar o objeto global $post ?> <?php else : ?>

 

<?php endif; ?> <?php get_footer(); // Inclui o rodapé do site ?>

Este código vai buscar e mostra até 10 publicações do tipo de publicação personalizada ‘news’. Para cada publicação, mostra o título como um link para a página da publicação individual e exibe um pequeno trecho. Se não forem encontradas publicações, apresenta uma mensagem de retorno.

Atribuir o modelo ao teu tipo de post personalizado

Depois de criares o modelo, tens de o atribuir a uma página para que o WordPress saiba utilizá-lo.

Segue estes passos:

• Vai ao teu painel de controlo do WordPress.
• Clica em Páginas → Adicionar novo.
• Cria uma nova página e dá-lhe o nome de Notícias.
• Encontra a secção Atributos da página no painel do lado direito e procura o menu pendente Modelo .
• Na lista pendente, seleciona o modelo de Notícias que acabaste de criar (aparecerá como uma opção porque adicionaste o Nome do modelo no ficheiro PHP).
• Clica em Publicar para ativar a página.

Consulta a imagem abaixo para veres a representação visual dos passos acima referidos:

A imagem abaixo representa a apresentação final da tua página de listagem:

Adicionar menu ao tipo de post personalizado

Adiciona o teu tipo de publicação personalizado como parte das opções de Menu no teu site WordPress, seguindo estes passos:

• Vai ao teu painel de controlo do WordPress.
• Navega até Aparência → Menus.
• Adiciona a página Notícias ao teu menu principal para apresentar uma ligação de navegação para o nosso tipo de publicação personalizada do WordPress recém-criado, Notícias.

Para mais informações, consulta a imagem abaixo.

E é assim que o teu site vai ficar na parte da frente. Vê a imagem abaixo:

Resolução de problemas comuns

Ao trabalhar com Custom Post Types (CPTs) no WordPress, podes encontrar alguns problemas comuns. Aqui estão os dois problemas mais comuns e as formas de os resolver.

1. O tipo de post personalizado não está a aparecer

Por vezes, adicionaste o tipo de publicação personalizado, mas ele não aparece. As possíveis razões para isso podem ser:

• Código incorreto.
• Conflito de plugins.

Solução

• Tens de rever o código para garantir que o código está correto. Recorre à ajuda de um especialista para o fazer.
• Tenta desativar os plugins para verificar se nenhum entra em conflito com o plugin de pós-tipo personalizado que estás a utilizar.

2. Problemas com Permalinks

Se estiveres a ter problemas com as hiperligações permanentes relacionadas com o teu CPT, como erros 404 ou encaminhamento incorreto, eis como podes resolver o problema.

Solução

• Vai a Definições → Permalinks.
• Clica no botão Guardar alterações .

Além disso, por vezes, um CPT pode ter o mesmo slug que uma página existente, causando conflitos. Certifica-te de que o slug do teu CPT é único.

Resumo

Então, aí tens! Percorremos três formas diferentes de criar tipos de post personalizados no WordPress: utilizando um plugin, criando o teu próprio plugin de tipos de post personalizados e editando diretamente o ficheiro functions.php.

Cada método tem as suas vantagens, dependendo do método com que te sentes mais confortável ou do que melhor se adequa ao teu projeto.

Se pretendes tirar o máximo partido dos teus tipos de publicação personalizados, utilizar um alojamento fiável para WordPress pode ajudar a manter as coisas a funcionar sem problemas.

E não te esqueças de consultar as nossas outras publicações no blogue para obteres mais dicas sobre como otimizar o teu site WordPress, como 23 dicas fáceis para acelerar o teu site WordPress.

Se tiveres alguma dúvida ou opinião, não hesites em comentar abaixo!