Solução de Problemas
Problemas comuns e suas soluções para o SportsPress e SportsPress Pro.
Página Não Encontrada (404) Após Instalar
Sintoma: Clicar em um evento, time, jogador ou outra página do SportsPress retorna um erro 404 "Página Não Encontrada" imediatamente após ativar o plugin.
Causa: As regras de permalink do WordPress não foram regeneradas para incluir os slugs de tipos de post personalizados do SportsPress.
Solução: Limpe o cache de permalink.
Acesse Configurações > Permalinks no administrador do WordPress.
Clique em Salvar Alterações (nenhuma alteração necessária — apenas salvar regenera as regras).
Isso força o WordPress a reconstruir as regras de reescrita e registrar todas as rotas do SportsPress.
Eventos Mostrando "Agendamento Perdido"
Sintoma: Eventos agendados (futuros) exibem o status "Agendamento perdido" em vez de aparecer como fixtures próximos no frontend.
Causa: O WordPress está configurado para usar permalinks "Simples", que não suporta a estrutura de URL baseada em data que o SportsPress requer para exibição de eventos agendados.
Solução: Altere a estrutura de permalink para pelo menos "Dia e nome".
Acesse Configurações > Permalinks.
Selecione Dia e nome ou qualquer estrutura personalizada.
Clique em Salvar Alterações.
A configuração de permalink "Simples" é a única que quebra a exibição de eventos agendados. Todas as outras estruturas de permalink são suportadas.
Lista de Jogadores Não Mostrando Jogadores
Sintoma: Uma lista de jogadores em uma página de time ou um shortcode de lista de jogadores incorporado manualmente não mostra jogadores, ou menos jogadores do que esperado.
Causas comuns e soluções:
Jogador não atribuído ao time — Abra a tela de edição do jogador e confirme que o time está selecionado na meta box Times. O jogador deve ter o time atribuído como time atual para aparecer na lista de jogadores daquele time.
Lista de jogadores filtrada por liga/temporada — Se a lista de jogadores tiver um filtro de liga ou temporada definido, apenas os jogadores que também estão atribuídos a essa liga ou temporada aparecerão. Verifique as configurações da lista de jogadores e as atribuições de taxonomia do jogador.
Lista de jogadores não vinculada ao time — Na tela de edição da lista de jogadores, verifique se o time correto está selecionado. Para listas geradas automaticamente, as configurações da página do time devem ter "Lista de Jogadores" habilitada.
Jogador atribuído apenas como time anterior — Jogadores atribuídos apenas como membros de times anteriores não aparecerão na lista de jogadores atual por padrão. Verifique se a lista de jogadores está configurada para incluir jogadores anteriores.
Tabela de Liga Mostrando Zeros
Sintoma: Todos os valores em uma tabela de liga exibem zero mesmo que eventos com resultados tenham sido publicados.
Causas comuns e soluções:
Equação não configurada — Acesse SportsPress > Configurar > Colunas de Tabela de Liga e verifique se cada coluna tem uma equação válida. Uma coluna sem equação ou com uma referência de variável inválida produzirá zero.
Eventos não atribuídos à liga ou temporada corretas — A tabela de liga está vinculada a uma liga e temporada específicas. Os eventos devem ser atribuídos aos mesmos termos. Verifique as atribuições de liga e temporada do evento.
Resultados não inseridos nos eventos — Os cálculos da tabela de liga são impulsionados por resultados de eventos publicados. Confirme que os eventos usados no cálculo estão publicados e têm resultados inseridos.
Times incorretos selecionados na tabela — Na tela de edição da tabela de liga, verifique se os times corretos estão listados. Se o modo "Auto" estiver selecionado, os times são obtidos de eventos na liga/temporada atribuída.
Estatísticas de Jogadores Mostrando Zero
Sintoma: As estatísticas de um jogador em seu perfil ou em uma lista de jogadores exibem zero.
Causas comuns e soluções:
Evento não publicado — As estatísticas são calculadas apenas de eventos publicados. Rascunhos ou eventos agendados não são incluídos. Publique os eventos que contêm os dados de desempenho do jogador.
Resultados não inseridos — O evento deve ter resultados inseridos (placares/resultados). Eventos sem resultados não contribuem para as estatísticas.
Colunas de desempenho não configuradas — Acesse SportsPress > Configurar > Desempenho de Jogadores e confirme que as colunas estão configuradas. Se não existirem colunas de desempenho, nenhuma estatística pode ser coletada.
Equações de estatísticas de jogadores fazem referência a variáveis ausentes — Acesse SportsPress > Configurar > Estatísticas de Jogadores e verifique se a equação de cada estatística faz referência a nomes de variáveis de coluna de desempenho existentes.
Jogador não listado no evento — Abra a tela de edição do evento e confirme que o jogador aparece no box score para seu time.
Conflitos com Plugins de Cache
Sintoma: Os dados do SportsPress (tabelas de liga, listas de jogadores, resultados de eventos) parecem desatualizados ou não são atualizados após as alterações serem salvas. A rotação aleatória de patrocinadores não funciona.
Plugins afetados conhecidos:
Litespeed Cache — O cache de objetos pode impedir que as consultas de meta do SportsPress retornem dados atualizados.
W3 Total Cache — O cache de objetos e de banco de dados podem interferir com as consultas dinâmicas do SportsPress.
Soluções:
Desabilite o cache de objetos para páginas que contêm conteúdo do SportsPress, ou configure exclusões de cache para URLs de tipos de post do SportsPress (por exemplo, caminhos correspondendo a
/event/,/team/,/player/).No Litespeed Cache, adicione os slugs de tipos de post do SportsPress à lista "Não Fazer Cache de URIs".
No W3 Total Cache, desabilite o "Cache de Banco de Dados" se os dados de tabela/lista não estiverem sendo atualizados após alterações de resultados de eventos.
Os patrocinadores usam uma requisição AJAX para contornar o cache para rotação aleatória — certifique-se de que sua configuração de cache não faça cache de respostas AJAX.
Erros PHP ou Telas em Branco
Sintoma: Telas de administração mostram avisos PHP, erros fatais ou páginas em branco após atualizar o PHP ou o SportsPress.
Requisitos mínimos:
PHP 5.2.4 ou superior (PHP 7.4+ recomendado; PHP 8.x é suportado a partir de versões recentes)
WordPress 3.8 ou mais recente
MySQL 5.0 ou superior
Limite de memória PHP: mínimo recomendado de 64 MB
Soluções:
Atualize o SportsPress Pro para a versão mais recente, pois cada atualização de versão menor do PHP pode requerer correções de compatibilidade.
Se estiver usando PHP 8.x, certifique-se de estar no SportsPress Pro 2.7.18 ou posterior, que contém correções para avisos de depreciação do PHP 8.x.
Verifique o log de erros PHP do seu servidor para a mensagem de erro específica. Problemas comuns do PHP 8.x envolvem assinaturas de funções obsoletas e tratamento de parâmetros nulos.
Aumente o limite de memória PHP se estiver enfrentando erros fatais de memória adicionando
define('WP_MEMORY_LIMIT', '128M');aowp-config.php.
