Ir al contenido principal

Contribuciones de código

Como todos los proyectos de WordPress, Playground utiliza GitHub para gestionar el código y hacer seguimiento de los problemas. El repositorio principal está en https://github.com/WordPress/wordpress-playground y el repositorio de Playground Tools está en https://github.com/WordPress/playground-tools/.

Contribuye a las herramientas de Playground

Esta guía incluye enlaces al repositorio principal, pero todos los pasos y opciones se aplican a ambos. Si estás interesado en los plugins o en las herramientas de desarrollo local, empieza por ahí.

Explora la lista de problemas abiertos para encontrar en qué trabajar. La etiqueta Good First Issue es un punto de partida recomendado para los que contribuyen por primera vez.

Asegúrate de revisar los siguientes recursos antes de empezar:

Contribuir con Pull Requests​

Haz un fork del repositorio de Playground y clónalo en tu máquina local. Para ello, copia y pega estos comandos en tu terminal:

git clone -b trunk --single-branch --depth 1 --recurse-submodules

# replace `YOUR-GITHUB-USERNAME` with your GitHub username:
git@github.com:YOUR-GITHUB-USERNAME/wordpress-playground.git
cd wordpress-playground
npm install

Crea una rama, haz los cambios y pruébalo localmente ejecutando el siguiente comando:

npm run dev

Playground se abrirá en una nueva pestaña del navegador y se actualizará automáticamente con cada cambio.

Cuando estés listo, haz commit de los cambios y envía un Pull Request.

Formato

Nos encargamos del formato del código y del linting automáticamente. Relájate, escribe y deja que las máquinas hagan el trabajo.

Ejecutar un Multisite local​

WordPress Multisite tiene algunas restricciones cuando se ejecuta localmente. Si planeas probar una red Multisite usando el paso enableMultisite de Playground, asegúrate de cambiar el puerto por defecto de wp-now o de establecer un dominio de prueba local que se ejecute a través de HTTPS.

Para cambiar el puerto por defecto de wp-now al soportado por WordPress Multisite, ejecútalo usando la bandera --port=80:

npx @wp-now/wp-now start --port=80

Hay varias maneras de configurar un dominio de prueba local, incluyendo la edición de tu archivo hosts. Si no estás seguro de cómo hacerlo, te sugerimos que instales Laravel Valet y luego ejecutes el siguiente comando:

valet proxy playground.test http://127.0.0.1:5400 --secure

Tu servidor de desarrollo está ahora disponible en https://playground.test.

Depuración​

Usar VS Code y Chrome​

Si usas VS Code y tienes Chrome instalado, puedes depurar Playground en el editor de código:

  • Abre la carpeta del proyecto en VS Code.
  • Selecciona Ejecutar > Iniciar depuración en el menú principal o pulsa F5/fn+F5.

Depuración de PHP​

Playground registra los errores de PHP en la consola del navegador después de cada solicitud PHP.