> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Solución de problemas WordPress
> Guía completa para solucionar problemas comunes de configuración con Notificaciones Web Push de OneSignal en WordPress, incluyendo compatibilidad de navegador (Chrome, Firefox, Safari), integración de plugin y resolución de conflictos de CDN o caché.
## Problemas comunes de configuración
### Verificar la configuración de tu dashboard de OneSignal
Asegúrate de haber completado cada paso en la [guía de configuración de WordPress](./wordpress):
* Selecciona la opción **WordPress Plugin** al crear tu aplicación OneSignal
* Tu URL del Sitio debe coincidir exactamente con la URL del navegador
* Por ejemplo, `https://example.com` **no** es lo mismo que `https://www.example.com`. Usa una versión consistentemente.
* Solo se soporta un origen de sitio para push. Consulta [Política del mismo origen](https://developer.mozilla.org/en-US/docs/Web/Security/Same-origin_policy).
* Asegúrate de haber agregado al menos una solicitud de permiso.
### No agregar el código de OneSignal manualmente
El plugin de WordPress de OneSignal incluye **automáticamente** el script de inicialización y el Service Worker.
* **No** agregues código `init` de JavaScript de OneSignal a tu sitio.
* **No** uses la [Configuración de Código Personalizado](./web-push-custom-code-setup) con el plugin de WordPress. Si necesitas personalizar el método `init`, **desinstala el plugin** y agrega el código y el Service Worker manualmente.
### Enviar notificación cuando se publica una entrada
Cuando publicas una entrada, página o tipo de entrada personalizado, OneSignal puede enviar automáticamente una notificación a tus suscriptores.
Si no ves la casilla **Enviar notificación cuando la entrada se publique o actualice**, verifica estos elementos:
1. Revisa los metaboxes a la derecha y abajo del editor. Puedes arrastrar y soltar según sea necesario.
2. Revisa las Opciones de Pantalla en la parte superior del editor para asegurarte de que el metabox **OneSignal Push Notifications** esté marcado.
3. Verifica si usas un Tipo de Entrada Personalizado. Normalmente se encuentra en la URL como `post_type=your_custom_type`. Si es así, agrega el tipo de entrada personalizado al campo **Tipos de Entrada Personalizados** en la [configuración del plugin WordPress de OneSignal](./wordpress#add-a-custom-post-type-to-onesignal-wordpress-plugin).
***
## Cómo solucionar problemas de tu sitio
Carga tu sitio en una ventana de navegador normal (no incógnito) con el plugin habilitado.
Abre la pestaña **Console**, refresca la página y busca errores rojos o amarillos relacionados con OneSignal.
Consulta [Errores comunes de consola de OneSignal](#common-onesignal-console-errors) para ayuda.
Después de que la página termine de cargarse y no veas errores de OneSignal en la Consola, pega esto:
```javascript JavaScript theme={null}
OneSignal.User.PushSubscription.id
```
Si el visitante está suscrito, devuelve una cadena (el ID de Suscripción). Si no está suscrito o la suscripción aún no está lista, puedes ver **`null`** o un valor vacío. Si ves **`OneSignal is not defined`**, espera unos segundos y vuelve a intentarlo, o primero corrige los errores de Consola en [Errores comunes de consola de OneSignal](#common-onesignal-console-errors)——el SDK puede estar cargándose aún mediante el cargador diferido.
En el **dashboard de OneSignal**, ve a **Audience > Subscriptions** y busca el ID devuelto arriba.
Si la suscripción existe y el estado es **Subscribed**, sigue la [guía de Push](./push) para enviar una notificación.
Si no aparece nada, consulta [Notifications not shown](./notifications-not-shown-web-push) para correcciones específicas del navegador.
***
## Errores comunes de consola de OneSignal
### SdkInitError: OneSignal: This web push config can only be used on ... Your current origin is ...
Tu URL del sitio en el dashboard de OneSignal no coincide con tu dominio real.
Asegúrate de que coincida exactamente con el dominio que ves en el navegador.
### PushPermissionNotGrantedError: The user dismissed the permission prompt.
El visitante rechazó la solicitud del navegador. No aparecerá nuevamente hasta que expire un período de espera.
Consulta [Solicitudes de permiso web](./permission-requests) para reglas del navegador o limpia los datos del sitio para reintentar inmediatamente.
### The OneSignal web SDK can only be initialized once.
Estás cargando OneSignal dos veces. Elimina el código de OneSignal agregado manualmente si estás usando el plugin.
### Installing service worker failed.. 403 or 404 error
Asegúrate de que este archivo sea accesible (reemplaza `your-site.com` y ajusta el **nombre real de la carpeta del plugin** si difiere del predeterminado):
`https://your-site.com/wp-content/plugins/onesignal-free-web-push-notifications/sdk_files/OneSignalSDKWorker.js`
Si no, consulta [Soporte común de plugin](#common-plugin-support) para corregir problemas de CDN o caché.
***
## Soporte común de plugin
Los CDN y plugins de caché pueden bloquear los archivos requeridos de OneSignal. Las rutas a continuación asumen que el directorio del plugin es **`onesignal-free-web-push-notifications`**; ajusta si tu instalación usa un nombre de carpeta diferente.
### Autoptimize
En **Excluded scripts**, agrega:
```
wp-content/plugins/onesignal-free-web-push-notifications/sdk_files/(.*)
```
### WP Rocket
Bajo **CDN > Exclude Files From CDN**, agrega:
```
(.*)/onesignal-free-web-push-notifications/sdk_files/(.*)
```
### LiteSpeed Cache
Bajo **CDN > Exclude Path**, agrega:
```
(.*)/onesignal-free-web-push-notifications/sdk_files/(.*)
```
Luego presiona guardar.
### WP Super Cache
1. Ve a **Settings > WP Super Cache > CDN**
2. En **Exclude if substring**, incluye: `onesignal-free-web-push-notifications`
3. Haz clic en **Contents** > **Delete Cache**
### WP Engine
WP Engine puede reescribir las URLs de los plugins a través de su CDN. Las reglas de **Procesamiento post-HTML** son específicas de cada entorno; el fragmento a continuación es solo un **ejemplo**——confirma las rutas con el [soporte de WP Engine](https://wpengine.com/support/) o tu Portal de Usuario antes de aplicarlas.
En WP Engine **plugin > General Settings > HTML Post-Processing**, puede que necesites reglas similares a las siguientes. Reemplaza cada marcador de posición con los valores de **tu** sitio y el nombre de host CDN de WP Engine:
| Marcador de posición | Reemplazar con |
| ---------------------- | --------------------------------------------------------------------------------- |
| `YOURSITEHERE` | Tu dominio sin prefijo (segmento de regex), p. ej. `example` para `example.com` |
| `mywpenginehandleHere` | El nombre de tu instalación de WP Engine (subdominio antes de `.wpengine.com`) |
| `wpengineCDNpathHere` | Tu segmento de ruta NetDNA / CDN de WP Engine (suele aparecer en las URLs de CDN) |
| `mywebsiteHere` | El origen de tu sitio activo sin ruta, p. ej. `https://example.com` |
```text text theme={null}
#https?://(www\.)?(YOURSITEHERE\.com|mywpenginehandleHere.wpengine.com|wpengineCDNpathHere.wpengine.netdna-(ssl|cdn).com)/wp-(content|includes)#
=> https://wpengineCDNpathHere-wpengine.netdna-ssl.com/wp-$4
#https://wpengineCDNpathHere-wpengine.netdna-ssl.com/plugins/onesignal-free-web-push-notifications/#
=> https://mywebsiteHere.com/wp-content/plugins/onesignal-free-web-push-notifications/
#https://wpengineCDNpathHere-wpengine.netdna-ssl.com/wp-content/plugins/onesignal-free-web-push-notifications/#
=> https://mywebsiteHere.com/wp-content/plugins/onesignal-free-web-push-notifications/
```
### W3 Total Cache
1. Ve a **Performance > CDN**
2. Bajo **Rejected files**, agrega:
```
{plugins_dir}/onesignal-free-web-push-notifications/sdk_files/*
```
### BunnyCDN
Excluye *onesignal* en las Rutas Excluidas de CDN del plugin.
### CDN Enabler
En Settings > CDN Enabler, agrega esto a "Exclusions":
```
onesignal-free-web-push-notifications
```
### PressCDN
En Exclude Directories, agrega:
```
/wp-content/plugins/onesignal-free-web-push-notifications/
```
### Breeze
En **Settings > CDN > Exclude Content**, agrega:
```
/onesignal-free-web-push-notifications/sdk_files/
```
### Hummingbird Pro
Ve a **Hummingbird > Asset Optimization**. Bajo **JavaScript** (y **CSS** si los assets de OneSignal aparecen allí), localiza archivos cuyas URLs contengan **`onesignal-free-web-push-notifications`** o **`OneSignalSDK`**. **Excluye** dichos archivos de la minificación/combinación/aplazamiento, o cambia la optimización de esos assets a **No cargar** para que el plugin no los reescriba ni los retrase.
### Sucuri
Sigue la [guía de Whitelist de Sucuri](https://kb.sucuri.net/firewall/Whitelist+and+Blacklist/whitelist-file-folder) para permitir archivos de OneSignal.
### Solid Security (anteriormente iThemes Security)
Deshabilita **Disable PHP in Plugins** (o equivalente) bajo **System Tweaks** para que `OneSignalSDKWorker.js.php` pueda ejecutarse.
### Defender Security plugin
No habilites "Prevent PHP execution".
Ve a Defender Plugin > Security Tweaks y verifica que la configuración esté deshabilitada.
### Ejemplo de .htaccess para acceso al Service Worker
```apache theme={null}
Order allow,deny
Deny from all
Allow from all
ForceType 'application/javascript; charset=UTF-8'
Allow from all
ForceType 'application/javascript; charset=UTF-8'
```
Apache 2.4+ frecuentemente usa `Require all denied` / `Require all granted` en lugar de `Order allow,deny`. Consulta a tu hosting o ajusta las reglas para que coincidan con la versión de Apache de tu servidor.
***
## Ralentizaciones del servidor o sitio inalcanzable después de enviar notificaciones
Si tu servidor experimenta ralentizaciones o se vuelve inalcanzable después de enviar notificaciones, a menudo se debe al aumento de carga de activos de notificación o recursos limitados del servidor.
### No alojar tus propios íconos de notificación
Evita el auto-alojamiento de imágenes usadas en notificaciones. Cuando alojas tus propios íconos o imágenes de notificación, tu servidor puede sobrecargarse ya que el navegador de cada destinatario intenta obtener la imagen al mismo tiempo que se envía una notificación.
Para reducir la tensión del servidor, usa soluciones de alojamiento de imágenes o servicios CDN optimizados para acceso de alta concurrencia.
### Considera actualizar recursos de alojamiento
Si los problemas del servidor persisten, puede que necesites:
* **Actualizar tu plan de alojamiento:** Puede ser necesario un mayor ancho de banda o un alojamiento más potente para manejar envíos de notificaciones a gran escala.
* **Consultar con tu proveedor de alojamiento:** Tu proveedor puede ofrecer perspectivas u optimizaciones específicas para tu entorno de alojamiento.
***