Guia abrangente para solucionar problemas comuns de configuração com Notificações Web Push do OneSignal no WordPress, incluindo compatibilidade de navegador (Chrome, Firefox, Safari), integração de plugin e resolução de conflitos de CDN ou cache.
O plugin WordPress OneSignal automaticamente inclui o script de inicialização e Service Worker.
Não adicione código JavaScript init do OneSignal ao seu site.
Não use a Configuração de Código Personalizado com o plugin WordPress. Se precisar personalizar o método init, desinstale o plugin e adicione o código e o Service Worker manualmente.
Quando você publica um post, página ou tipo de post personalizado, o OneSignal pode enviar automaticamente uma notificação para seus assinantes.
Metabox do OneSignal Push Notifications——arraste para reposicionar se necessário
Se você não vir a caixa de seleção Enviar notificação quando o post for publicado ou atualizado, verifique estes itens:
Verifique as metaboxes à direita e na parte inferior do editor. Você pode arrastar e soltar conforme necessário.
Verifique as Opções de Tela no topo do editor para garantir que a metabox OneSignal Push Notifications esteja marcada.
Opções de Tela mostrando a metabox OneSignal Push Notifications marcada
Verifique se está usando um Tipo de Post Personalizado. Geralmente encontrado na URL como post_type=your_custom_type. Nesse caso, adicione o tipo de post personalizado ao campo Tipos de Post Personalizados nas configurações do plugin WordPress OneSignal.
Exemplo de onde encontrar o nome do tipo de post personalizado
Verificar se o plugin está ativo e abrir ferramentas do desenvolvedor
Carregue seu site em uma janela de navegador normal (não anônimo) com o plugin habilitado.
Clique com o botão direito no seu site, clique em Inspecionar e abra a aba Console.
2
Verificar o console para erros OneSignal
Abra a aba Console, atualize a página e procure por quaisquer erros relacionados ao OneSignal em vermelho ou amarelo.
Veja Erros comuns do Console OneSignal para ajuda.
3
Verificar status de assinatura no navegador
Após a página terminar de carregar e você não ver erros do OneSignal no Console, cole:
JavaScript
OneSignal.User.PushSubscription.id
Se o visitante estiver assinado, retorna uma string (o Subscription ID). Se não estiver assinado ou a assinatura ainda não estiver pronta, você pode ver null ou um valor vazio. Se você ver OneSignal is not defined, aguarde alguns segundos e tente novamente, ou primeiro corrija os erros do Console em Erros comuns do Console OneSignal——o SDK pode ainda estar carregando via o loader diferido.
Encontre seu OneSignal Subscription ID no console.
4
Verificar Subscription ID no dashboard OneSignal
No dashboard do OneSignal, vá para Audience > Subscriptions e procure pelo ID retornado acima.
Procure no seu dashboard OneSignal pelo Subscription ID.
5
Enviar uma notificação push de teste
Se a assinatura existe e o status é Subscribed, siga o guia Push para enviar uma notificação.
Se nada aparecer, veja Notificações não mostradas para correções específicas do navegador.
SdkInitError: OneSignal: This web push config can only be used on … Your current origin is …
Erro de incompatibilidade de URL do site.
Sua URL do site no dashboard OneSignal não corresponde ao seu domínio real.
Certifique-se de que corresponde exatamente ao domínio que você vê no navegador.
PushPermissionNotGrantedError: The user dismissed the permission prompt.
O visitante recusou o prompt do navegador. Não aparecerá novamente até que um período de espera expire.
Veja Prompts de permissão web para regras do navegador ou limpe os dados do site para tentar novamente imediatamente.
Installing service worker failed.. 403 or 404 error
Arquivo Service Worker ausente (403/404).
Certifique-se de que este arquivo está acessível (substitua your-site.com e ajuste o nome real da pasta do plugin se diferir do padrão):
https://your-site.com/wp-content/plugins/onesignal-free-web-push-notifications/sdk_files/OneSignalSDKWorker.jsSe não, veja Suporte comum de plugin para corrigir problemas de CDN ou cache.
CDNs e plugins de cache podem bloquear os arquivos necessários do OneSignal. Os caminhos abaixo assumem que o diretório do plugin é onesignal-free-web-push-notifications; ajuste se sua instalação usar um nome de pasta diferente.
O WP Engine pode reescrever URLs de plugins via seu CDN. As regras de HTML Post-Processing são específicas de cada ambiente; o trecho abaixo é apenas um exemplo——confirme os caminhos com o suporte do WP Engine ou seu Portal do Usuário antes de aplicar.No WP Engine plugin > General Settings > HTML Post-Processing, você pode precisar de regras similares às seguintes. Substitua cada placeholder com os valores do seu site e hostname do CDN do WP Engine:
Placeholder
Substituir por
YOURSITEHERE
Seu domínio base (segmento de regex), ex. example para example.com
mywpenginehandleHere
O nome da sua instalação WP Engine (subdomínio antes de .wpengine.com)
wpengineCDNpathHere
Seu segmento de caminho NetDNA / CDN do WP Engine (frequentemente mostrado nas URLs de CDN)
mywebsiteHere
A origem do seu site ativo sem caminho, ex. https://example.com
Vá para Hummingbird > Asset Optimization. Em JavaScript (e CSS se os assets do OneSignal aparecerem lá), localize arquivos cujas URLs contenham onesignal-free-web-push-notifications ou OneSignalSDK. Exclua-os de minificação/combinação/adiamento, ou mude esses assets para otimização Não carregar para que o plugin não os reescreva ou adie.
<Files *.php>Order allow,denyDeny from all</Files><Files OneSignalSDKWorker.js.php>Allow from allForceType 'application/javascript; charset=UTF-8'</Files><Files OneSignalSDKWorker.js>Allow from allForceType 'application/javascript; charset=UTF-8'</Files>
Apache 2.4+ frequentemente usa Require all denied / Require all granted em vez de Order allow,deny. Consulte seu host ou ajuste as regras para corresponder à versão do Apache do seu servidor.
Lentidão do servidor ou site inacessível após enviar notificações
Se seu servidor experimenta lentidão ou fica inacessível após enviar notificações, frequentemente é devido ao aumento de carga de recursos de notificação ou recursos limitados do servidor.
Evite auto-hospedar imagens usadas em notificações. Quando você hospeda seus próprios ícones ou imagens de notificação, seu servidor pode ficar sobrecarregado já que o navegador de cada destinatário tenta buscar a imagem ao mesmo tempo que uma notificação é enviada.
Para reduzir a carga do servidor, use soluções de hospedagem de imagem ou serviços CDN otimizados para acesso de alta concorrência.
Se problemas de servidor persistirem, você pode precisar:
Atualizar seu plano de hospedagem: Maior largura de banda ou hospedagem mais poderosa pode ser necessária para lidar com envios de notificação em larga escala.
Consultar seu provedor de hospedagem: Seu provedor pode oferecer insights ou otimizações específicas para seu ambiente de hospedagem.
