Skip to content

README.MD

Latest commit

 

History

History
95 lines (63 loc) · 2.05 KB

README.MD

File metadata and controls

95 lines (63 loc) · 2.05 KB

📊 GraphQL and Post Views

Versão: 1.2
Autor: [cairesdev]
Descrição:
Este plugin adiciona suporte para rastreamento de visualizações de posts em WordPress. As visualizações são atualizadas via REST API e podem ser consultadas pela API GraphQL.

🔧 Funcionalidades

1. Consulta de Visualizações via GraphQL

Adiciona o campo views ao tipo Post na API GraphQL.

  • Campo: views
  • Tipo: Int
  • Descrição: Número de visualizações do post

Exemplo de query:

query {
  post(id: "meu-post", idType: SLUG) {
    title
    views
  }
}

2. Incremento de Visualizações via REST API

Exponibiliza uma rota REST para incrementar as visualizações de um post.

Endpoint:

POST /wp-json/views/v1/hit/{slug}

  • Parâmetro da URL: slug – Slug do post (ex: meu-post)

  • Resposta de Sucesso (200 OK):

{
  "postId": 123,
  "slug": "meu-post",
  "views": 42
}

  • Erros Possíveis:

    • 400 Bad Request – Post inválido ou não publicado.

🛠️ Como Funciona

  • Usa graphql_register_types para adicionar o campo views ao tipo Post.
  • Usa register_rest_route para criar a rota REST /views/v1/hit/{slug}.
  • A cada requisição POST, incrementa o campo views no meta do post.

✅ Permissões

  • A rota REST está acessível publicamente (__return_true), sem necessidade de autenticação.

⚠️ Atenção: Considere proteger a rota se quiser evitar manipulação ou spam de visualizações.

📌 Requisitos

  • WordPress com WPGraphQL instalado e ativo.
  • Permalinks ativados para uso correto dos slugs.

💡 Dicas de Integração

  • Faça uma chamada POST ao endpoint REST ao carregar uma página de post via JavaScript.
  • Exemplo usando fetch no frontend:
fetch('/wp-json/views/v1/hit/meu-post', {
  method: 'POST'
});
  • Em temas com cache agressivo, certifique-se de que a chamada seja feita do lado do cliente para registrar corretamente as visualizações.