Gestão do site
Solução de problemas do WordPress
Resolva os problemas comuns entre o WordPress e o ClubHelix: uma API REST bloqueada, o WP-Cron sem rodar, um plugin de segurança ou cache atrapalhando, o relógio do servidor errado ou o WordPress impedido de se conectar a outros sites.
Traduzido automaticamente. Esta página de ajuda foi traduzida automaticamente do inglês, então algumas palavras podem não ser exatas.
A maioria dos problemas entre o WordPress e o ClubHelix não está em nenhum dos dois produtos. Eles vêm da hospedagem que cerca o WordPress: um plugin de segurança, um cache de páginas, o relógio do servidor ou um firewall. Esta página cobre os seis que mais vemos, como descobrir qual deles você tem e como resolver. Ela começa com um passo no ClubHelix que é fácil de esquecer depois de conectar. A página WordPress explica como conectar um site pela primeira vez.
Comece por Ferramentas → Saúde do site no WordPress. O plugin do ClubHelix adiciona ali sete verificações, cada uma marcada com ClubHelix. A Referência de campos lista todas e indica a seção desta página que corresponde a cada uma.
Quem pode usar
Qualquer pessoa que cuide do site WordPress do clube. A maioria das correções exige um administrador do WordPress, e algumas exigem a sua hospedagem ou quem administra o servidor. No ClubHelix, somente os administradores veem a página do WordPress, onde aparecem o último sinal da conexão e o último erro.
O que há na página
Uma seção por problema. Cada uma diz o que você vai notar, como confirmar e como resolver:
- O site está conectado e verificado, mas os pagamentos não voltam para ele
- A API REST do WordPress está bloqueada
- O WP-Cron não está rodando
- Um plugin de segurança está bloqueando as atualizações do ClubHelix
- As páginas não mudam depois que você atualiza algo no ClubHelix
- O relógio do servidor está errado
- O WordPress não tem permissão para acessar outros sites
Passo a passo
O site está conectado e verificado, mas os pagamentos não voltam para ele
O que você vai notar: A Saúde do site diz A propriedade do site está verificada, mas quem paga termina em uma página do ClubHelix em vez de voltar ao seu site, seus widgets do ClubHelix não aparecem nele e você não consegue torná-lo o seu site público. Na aba Domínio do plugin, você pode ver "Um administrador ainda não confirmou este site no ClubHelix".
Por quê: Verificado só prova que o plugin controla o endereço do site. Um link de conexão pode apontar para qualquer site, então um administrador também precisa confirmar no ClubHelix que o site é do seu clube. O WordPress não consegue fazer esse passo por você.
Como resolver:
- Um administrador abre Gestão do site → WordPress no painel do ClubHelix.
- Em Precisa da sua atenção, encontre Um novo site está esperando que você o confirme.
- Marque Eu reconheço … como o site WordPress do nosso clube e escolha Confirmar este site. Se você não reconhece o endereço, revogue a conexão.
Depois de reinstalar o plugin ou reconectar, a nova conexão precisa ser confirmada de novo. Veja WordPress para saber mais.
A API REST do WordPress está bloqueada
O que você vai notar: A Saúde do site diz Nenhuma atualização recente chegou do ClubHelix, e as mudanças feitas no ClubHelix levam até 15 minutos para aparecer. Se você está levando o seu site para o ClubHelix, a migração pode passar a ler as suas páginas uma a uma.
Por quê: O ClubHelix envia os avisos de atualização para /wp-json/clubhelix/v1/webhook no seu site. Alguns plugins de segurança, e alguns plugins de "desativar a API REST", bloqueiam tudo o que está em /wp-json/ para visitantes que não estão logados. Isso inclui o ClubHelix.
Como resolver:
- Abra
https://seu-site/wp-json/em uma janela anônima do navegador. Se você vir um erro ou uma página de login em vez de uma página de texto, a API REST está bloqueada. - No plugin que a bloqueia, permita a rota
/wp-json/clubhelix/v1/webhook. A maioria desses plugins tem uma lista de rotas ou de namespaces permitidos; adicioneclubhelix/v1. - De volta à Saúde do site, execute as verificações de novo.
Você não precisa abrir toda a API REST ao público. A rota do ClubHelix só aceita mensagens assinadas com o segredo do seu site e ignora todo o resto.
O WP-Cron não está rodando
O que você vai notar: A Saúde do site diz O WP-Cron está desativado ou A verificação de segurança do ClubHelix não roda há mais de uma hora. Eventos e jogos sincronizados ficam desatualizados quando um aviso de atualização se perde, e o relatório diário de status para de chegar, então a página do WordPress no ClubHelix diz que o plugin não deu sinal.
Por quê: O WordPress executa as tarefas agendadas quando alguém visita o site. Em um site com pouco movimento, ou quando a sua hospedagem definiu DISABLE_WP_CRON como true no wp-config.php, essas tarefas podem não rodar. O plugin as usa para verificar a cada 15 minutos se o ClubHelix tem mudanças, como reforço para os avisos de atualização perdidos.
Como resolver:
- Se
DISABLE_WP_CRONestiver definido, a sua hospedagem espera que uma tarefa real do servidor execute o agendador do WordPress. Peça a ela que o execute a cada cinco minutos. Na maioria das hospedagens, é uma tarefa cron que chamawp cron event run --due-nowou que acessahttps://seu-site/wp-cron.php?doing_wp_cron. - Em hospedagens gerenciadas, procure uma configuração de "cron" ou de "tarefas agendadas" no painel da hospedagem.
Um plugin de segurança está bloqueando as atualizações do ClubHelix
O que você vai notar: A página do WordPress no ClubHelix mostra atualizações recentes que não chegaram, enquanto a Saúde do site mostra a API REST funcionando quando você mesmo a testa.
Por quê: Firewalls como o Wordfence podem limitar a frequência ou bloquear solicitações que não vêm de um navegador. Os avisos de atualização do ClubHelix vêm dos nossos servidores, não de um navegador, então uma regra do firewall pode barrá-los.
Como resolver (Wordfence):
- No WordPress, vá em Wordfence → Firewall → Todas as opções do firewall.
- Em Opções avançadas do firewall, adicione
/wp-json/clubhelix/v1/webhookàs URLs permitidas. - Se a limitação de frequência estiver ativada, confirme que ela não bloqueia esse endereço.
Não libere o ClubHelix por endereço IP. Nossos servidores não têm endereços fixos, e a assinatura de cada aviso é o que prova que ele veio de nós.
Outros plugins de segurança têm uma lista de permissões parecida. Adicione o mesmo endereço lá.
As páginas não mudam depois que você atualiza algo no ClubHelix
O que você vai notar: Você alterou um evento ou um preço no ClubHelix, a atualização aparece como entregue na página do WordPress no ClubHelix, mas o seu site continua mostrando a versão antiga.
Por quê: Um cache de páginas está servindo uma cópia salva da página. O plugin limpa o cache das páginas afetadas quando uma atualização chega, mas só com os plugins de cache com os quais sabe se comunicar (FlyingPress, LiteSpeed Cache e WP Rocket). Ele não consegue alcançar um cache que esteja no painel da hospedagem ou em uma rede de distribuição de conteúdo.
Como resolver:
- Limpe o cache uma vez pelo seu plugin de cache ou pelo painel da hospedagem, para confirmar que essa é a causa.
- Se você usa um cache no nível da hospedagem ou uma rede de distribuição de conteúdo, defina um tempo de cache curto para as páginas que mostram blocos do ClubHelix, ou pergunte à sua hospedagem se ele pode ser limpo automaticamente.
- As mudanças sempre aparecem quando a cópia em cache expira, então isso é um atraso, não dados perdidos.
O relógio do servidor está errado
O que você vai notar: A Saúde do site diz O relógio do servidor está errado, e os avisos de atualização são recusados mesmo sem nenhum outro problema.
Por quê: Cada aviso de atualização leva a hora em que foi enviado, e o plugin recusa um que tenha mais de cinco minutos. Isso impede que alguém reenvie um aviso antigo. Se o relógio do seu servidor estiver alguns minutos errado, os avisos genuínos parecem antigos e são recusados.
Como resolver: Peça à sua hospedagem que ative a sincronização automática de horário (NTP) no servidor. Você não consegue resolver isso pelo próprio WordPress. Enquanto isso não for corrigido, a verificação de 15 minutos mantém o seu site atualizado.
O WordPress não tem permissão para acessar outros sites
O que você vai notar: A conexão falha de imediato, e os blocos mostram "Não foi possível carregar … agora". A Saúde do site não tem uma verificação própria para isso. A verificação de conexão dela diz As chamadas ao ClubHelix estão falhando, geralmente com o código network_error.
Por quê: Algumas hospedagens e configurações de segurança adicionam WP_HTTP_BLOCK_EXTERNAL ao wp-config.php, o que impede o WordPress de acessar qualquer outro site. O plugin precisa alcançar o ClubHelix.
Como resolver: Mantenha o bloqueio e adicione o ClubHelix à lista de sites permitidos no wp-config.php:
define( 'WP_ACCESSIBLE_HOSTS', 'clubhelix.com' );
Se essa linha já listar outros sites, acrescente clubhelix.com à lista, separado por vírgula. Se você não consegue editar o wp-config.php, fale com a sua hospedagem.
Referência de campos
Cada verificação mostra um título quando tudo vai bem e outro quando não vai. Os títulos são as palavras do próprio plugin.
| Verificação | Quando tudo vai bem | Quando algo está errado | O que ela testa |
|---|---|---|---|
| Connection | “This site is connected to ClubHelix” | “This site is not connected to ClubHelix”; “ClubHelix calls have been failing”; “ClubHelix has revoked this connection” | O site tem uma conexão, as chamadas dele ao ClubHelix estão funcionando e o ClubHelix não a revogou. |
| Ownership | “Site ownership is verified”; “A ClubHelix verification code is published” | “Site ownership is not confirmed yet”; “Site ownership is not verified yet” | O ClubHelix buscou o código de verificação no site. Não indica se um administrador confirmou o site. |
| ClubHelix updates | “Updates from ClubHelix are arriving”; “ClubHelix updates are not needed until the site is connected” | “No recent updates have arrived from ClubHelix” | Um aviso de atualização chegou nos últimos sete dias. Uma semana calma pode significar apenas que nada mudou. |
| Scheduled tasks | “The ClubHelix backstop is running” | “WP-Cron is switched off”; “The ClubHelix backstop has not run for over an hour” | O WP-Cron está ativado e a verificação de 15 minutos rodou na última hora. |
| Object cache | “ClubHelix content is cached in your object cache” | “ClubHelix content is cached in the database” | Se há um cache persistente disponível. É opcional, mas deixa os blocos mais rápidos. |
| Server clock | “The server clock is accurate”; “The server clock has not been checked yet” | “The server clock is wrong” | A hora do servidor está a menos de dois minutos da hora do ClubHelix. Acima de cinco minutos, as atualizações são recusadas. |
| HTTPS | “The site uses HTTPS” | “The site does not use HTTPS” | O endereço do próprio site começa com https://. Não testa a conexão com o ClubHelix. |
Dicas e perguntas frequentes
Meu site continua funcionando, algo disso é urgente? Não. Os blocos do ClubHelix continuam mostrando a última cópia boa quando algo disso dá errado, então a sua página inicial nunca quebra por nossa causa. Corrigir mantém essa cópia atualizada.
Isso quer dizer que o meu site foi invadido? Não. São configurações do seu site ou do seu servidor, e cada seção descreve a configuração envolvida.
Devo desativar o meu plugin de segurança? Não. Libere o endereço do ClubHelix. Todo aviso enviado a ele é assinado, então liberá-lo não enfraquece o seu site.
Com quem eu falo? Para qualquer passo de "Como resolver" que mencione a sua hospedagem, fale com a sua hospedagem. Se a página do WordPress no ClubHelix continuar mostrando um problema depois de uma correção, use Relatar um problema no seu painel do ClubHelix e diga qual verificação está falhando.