Ir al contenido principal

Solución de problemas de WordPress Playground

Esta página cubre errores del propio sitio de Playground, Playgrounds guardados, almacenamiento del navegador y arranque de WordPress. Para errores específicos de Blueprint, consulta Solucionar problemas y depurar Blueprints.

Playground parece roto​

Prueba esto primero:

  • Usa el botón de recarga dentro de la barra de herramientas de Playground en lugar de actualizar la pestaña del navegador. La actualización del navegador inicia toda la aplicación de Playground de nuevo.
  • Abre la misma URL en una ventana privada para descartar el estado de un sitio guardado o del almacenamiento del navegador.
  • Desactiva extensiones del navegador que bloqueen JavaScript, WebAssembly, almacenamiento, workers o solicitudes de red.
  • Revisa las herramientas de desarrollo del navegador para ver errores en Console y Network.
  • Si la URL incluye ?site-slug=..., prueba a quitar ese parámetro de consulta para iniciar un Playground nuevo sin guardar.

Un sitio limpio dice que falta la extensión MySQL​

Puedes ver una página de error de WordPress como esta:

Your PHP installation appears to be missing the MySQL extension which is required by WordPress.

En Playground, esto suele significar que WordPress no cargó la integración SQLite que permite ejecutar WordPress sin MySQL. Playground ejecuta WordPress en WebAssembly y usa SQLite en lugar de un servidor MySQL.

Prueba estos pasos:

  • Inicia un Playground nuevo sin guardar en https://playground.wordpress.net/ para confirmar que el sitio público puede arrancar.
  • Si la URL incluye un sitio guardado, elimina ?site-slug=... y carga un sitio temporal nuevo.
  • Si esto ocurrió después de importar un ZIP, confirma que la importación no incluyó un wp-content/db.php personalizado que sobrescriba la configuración SQLite de Playground.
  • Si esto ocurrió en la CLI, no uses --skip-sqlite-setup a menos que proporciones tu propia integración de base de datos.
  • Si esto ocurrió con un Blueprint, consulta la página de solución de problemas de Blueprint.

Si estás escribiendo un Blueprint y necesitas añadir el plugin de integración SQLite, plugins va en el nivel superior:

{
	"preferredVersions": {
		"php": "8.3",
		"wp": "latest"
	},
	"plugins": ["sqlite-database-integration"],
	"steps": [
		{
			"step": "login",
			"username": "admin"
		}
	]
}

Error connecting to the SQLite database​

Esto significa que Playground cargó la integración SQLite, pero WordPress aún no pudo conectarse a la base de datos.

Causas comunes:

  • El almacenamiento del navegador de un Playground guardado está obsoleto o incompleto.
  • Un ZIP de sitio importado contiene un archivo de base de datos o drop-in de base de datos incompatible.
  • A un directorio local montado le faltan archivos que WordPress necesita.
  • El almacenamiento del navegador fue borrado, desalojado o bloqueado.

Recuperación recomendada:

  1. Inicia un Playground nuevo sin guardar y sin site-slug.
  2. Si el sitio nuevo funciona, el problema está ligado al sitio guardado o al archivo importado.
  3. Exporta cualquier archivo accesible desde el sitio guardado roto usando el Navegador de archivos o una copia del directorio local, si está disponible.
  4. Vuelve a importar el sitio en un nuevo Playground o reconstruyelo desde su Blueprint.

NotAllowedError​

NotAllowedError suele significar que el navegador bloqueó una operación que requiere permiso del usuario o un contexto de navegador compatible. En Playground, esto a menudo está relacionado con sitios guardados o acceso a directorios locales.

Puedes ver este mensaje exacto:

The request is not allowed by the user agent or the platform in the current context.

Prueba:

  • Abrir Playground en una pestaña normal de nivel superior del navegador, no dentro de un iframe restringido.
  • Volver a abrir el sitio desde el panel Saved Playgrounds de Playground.
  • Si el sitio se guardó en un directorio local, importar o guardar el directorio de nuevo.
  • Confirmar que el navegador admite la API de archivos o almacenamiento que se está usando. Chrome y Edge suelen tener el soporte más amplio para directorios locales.
  • Revisar si el modo de navegación privada, una política empresarial o la configuración del navegador bloquean el acceso al almacenamiento.

NoModificationAllowedError​

NoModificationAllowedError significa que el navegador o el sistema de archivos rechazó una escritura. Esto puede ocurrir cuando un directorio local guardado se volvió de solo lectura, se perdió el permiso o el almacenamiento del navegador no está disponible.

Puedes ver este mensaje exacto:

An attempt was made to write to a file or directory which could not be modified due to the state of the underlying filesystem.

Prueba:

  • Guardar una copia en otro directorio local.
  • Comprobar que la carpeta de destino aún exista y sea escribible.
  • Evitar carpetas protegidas del sistema o carpetas sincronizadas que bloqueen archivos temporalmente.
  • Iniciar un Playground nuevo sin guardar si solo necesitas un sitio de prueba temporal.
  • Usar Playground CLI para desarrollo local que necesite persistencia fiable del sistema de archivos.

Un Playground guardado no puede recargarse​

Los Playgrounds guardados se almacenan en el almacenamiento del navegador o en un directorio local que seleccionaste. No están alojados en un servidor remoto.

Si un Playground guardado no puede recargarse:

  • Confirma que estás usando el mismo navegador y perfil de navegador donde se guardó.
  • Revisa si los datos del navegador se borraron o si el almacenamiento se desactivó.
  • Si el sitio se guardó en un directorio local, confirma que el directorio todavía existe y no se ha movido.
  • Si la URL incluye ?site-slug=..., quítalo para iniciar un sitio nuevo sin guardar.
  • Recrea el sitio guardado desde su Blueprint original o ZIP de importación si se perdió el almacenamiento.

Almacenamiento del navegador y persistencia​

Un Playground sin guardar es temporal. Una actualización del navegador, cerrar la pestaña, limpiar el almacenamiento o cambiar de perfil del navegador puede eliminar su estado.

Usa el botón Save antes de hacer trabajo importante. Para desarrollo local de mayor duración, prefiere Playground CLI, que persiste los archivos del sitio en disco.

El botón de recarga dentro de la barra de herramientas de Playground recarga WordPress mientras mantiene el runtime actual de Playground. El botón de actualizar del navegador recarga toda la aplicación y puede descartar cambios no guardados.

Cuándo empezar de nuevo​

Inicia un Playground nuevo sin guardar cuando:

  • Solo necesitas probar si el sitio público de Playground funciona.
  • La URL apunta a un site-slug guardado que ya no carga.
  • Estás depurando si un error proviene del propio Playground o de un plugin, tema, Blueprint o sitio importado.
  • Se sospecha que el almacenamiento del navegador o el acceso al directorio local está roto.

Usa esta URL para un sitio limpio:

https://playground.wordpress.net/

Informar de un problema de Playground​

Si el problema se reproduce en un Playground nuevo sin guardar, abre un issue e incluye:

  • La URL completa de Playground.
  • El navegador y el sistema operativo.
  • Si usaste un sitio guardado, ZIP importado, Blueprint, directorio local o CLI.
  • El nombre y el mensaje exactos del error.
  • Detalles de Console y Network de las herramientas de desarrollo del navegador.