Ir al contenido principal

Día del contribuidor en una WordCamp

El día del contribuidor en una WordCamp es un evento donde la comunidad de WordPress se reúne para contribuir al proyecto WordPress. Esta guía se centra en cómo puedes contribuir al proyecto WordPress Playground o cómo Playground puede ayudarte a contribuir a WordPress Core.

¿Quién puede contribuir?​

Algunos eventos tendrán una mesa dedicada al proyecto. Las mesas de contribuidores de WordPress Playground aceptan todo tipo de contribuciones, no solo de desarrolladores. Ya seas escritor, programador, verificador, desarrollador de plugins o temas, especialista en marketing, propietario de un sitio o cualquier otro tipo de usuario, te animamos a contribuir.

Valoramos las contribuciones diversas en varias áreas, incluyendo la creación de comunidades, las pruebas, la documentación y el diseño.

Cómo contribuir al proyecto Playground​

Esta sección describe cómo puedes contribuir directamente al proyecto WordPress Playground y sus herramientas asociadas:

  • Documentación: Mejora nuestra documentación perfeccionando el contenido existente, desarrollando nuevas guías o traduciendo materiales a diferentes idiomas.
  • Blueprints: Crea demostraciones de plugins para los plugins del repositorio de plugins de WordPress o desarrolla nuevos Blueprints para enriquecer la documentación de nuestro proyecto.
  • Pruebas del entorno Playground: Participa en las pruebas del propio proyecto WordPress Playground. Puedes hacerlo elaborando cuidadosamente nuevas incidencias que describan los problemas que encuentres y sugiriendo soluciones viables. Prueba nuestra instancia web de WordPress (el sitio playground.wordpress.net) o explora las diversas aplicaciones que funcionan con Playground. Prueba estas herramientas, observa su funcionalidad y proporciona comentarios detallados.
  • Comentarios sobre el producto: Tus opiniones son muy valiosas para mejorar la experiencia de Playground. Esto incluye comentarios generales sobre la instancia web, la aplicación y cualquier herramienta del lado del servidor.

Todos los comentarios, incluidos los problemas notificados y los resultados de las pruebas, pueden enviarse a través de nuestro repositorio de GitHub.

Seguimiento y compromiso continuo​

Aunque muchas tareas se completan durante el evento, tu contribución no tiene por qué terminar ahí. Te invitamos a seguir trabajando en tus incidencias o pull requests después del día del contribuidor. Esperamos que los colaboradores sigan trabajando en las tareas que hayan asumido más allá del evento. Ten en cuenta que si un pull request no muestra actividad durante un mes, puede considerarse abandonado y se cerrará.

Obtener ayuda y mantenerse comprometido​

Durante el día del contribuidor, podrás encontrar asistencia directa e interactuar con nosotros en la mesa dedicada a Playground. Para obtener asistencia continua e interactuar con la comunidad, puedes conectarte con nosotros en el canal #playground del Slack de WordPress o a través de GitHub.

Cómo usar Playground en el día del contribuidor​

Ahora vamos a explicar cómo Playground puede ayudarte durante el día del contribuidor. La extensión de WordPress Playground para VS Code y @wp-playground/cli agilizan el proceso de configuración de un entorno local de WordPress. WordPress Playground lo hace sin la necesidad de Docker, MySQL ni Apache.

Sigue leyendo para aprender a usar estas herramientas para el desarrollo local cuando contribuyas a WordPress. Ten en cuenta que la extensión y el paquete NPM están en fase de desarrollo y no todos los equipos de Make WordPress son totalmente compatibles.

Primeros pasos​

Extensión de Playground para VS Code​

La extensión de Playground para Visual Studio Code es un entorno de desarrollo fácil de usar, que no requiere configuración.

  1. Abre VS Code y ve a la pestaña Extensiones (Ver > Extensiones).
  2. En la barra de búsqueda, escribe WordPress Playground y haz clic en Instalar.
  3. Para interactuar con Playground, haz clic en el nuevo icono en la Barra de actividad y pulsa el botón Iniciar servidor de WordPress.
  4. En unos segundos se abrirá una nueva pestaña en tu navegador.

Paquete NPM @wp-playground/cli​

@wp-playground/cli es una herramienta de línea de comandos que te permite crear un sitio WordPress con un único comando. No necesitas Docker, MySQL ni Apache.

Requisitos previos​

@wp-playground/cli requiere Node.js 20.18 o superior y NPM. Si aún no lo has hecho, descarga e instala ambos antes de comenzar.

Dependiendo del equipo de Make WordPress al que contribuyas, es posible que necesites una versión de Node.js diferente a la que tienes instalada. Puedes usar Node Version Manager (NVM) para cambiar entre versiones. Encuentra la guía de instalación aquí.

Ejecutando @wp-playground/cli​

No es necesario que instales @wp-playground/cli en tu dispositivo para usarlo. Ve a tu directorio de plugins o temas e inicia @wp-playground/cli con los siguientes comandos:

cd mi-directorio-de-plugins-o-temas
npx @wp-playground/cli@latest server --auto-mount

Ideas para colaboradores​

Crear un pull request (PR) en Gutenberg​

  1. Haz un fork del repositorio de Gutenberg en tu cuenta de GitHub.
  2. Luego, clona el repositorio bifurcado para descargar los archivos.
  3. Instala las dependencias necesarias y compila el código en modo de desarrollo.
git clone git@github.com:WordPress/gutenberg.git
cd gutenberg
npm install
npm run dev

<!--
:::info

If you're unsure about the steps listed above, visit the official [Gutenberg Project Contributor Guide](https://developer.wordpress.org/block-editor/contributors/). Note that in this case, `@wp-playground/cli` replaces `wp-env`.

:::
-->

:::info

Si no estás seguro de los pasos anteriores, visita la [guía oficial para colaboradores del proyecto Gutenberg](https://developer.wordpress.org/block-editor/contributors/). Ten en cuenta que, en este caso, `@wp-playground/cli` sustituye a `wp-env`.

:::

<!--
Open a new terminal terminal tab, navigate to the Gutenberg directory, and start WordPress using `@wp-playground/cli`:
-->

Abre una nueva pestaña en tu terminal, navega hasta el directorio de Gutenberg e inicia WordPress usando `@wp-playground/cli`:

```bash
cd gutenberg
npx @wp-playground/cli@latest server --auto-mount

Cuando estés listo, confirma y envía tus cambios al repositorio bifurcado en GitHub y abre un Pull Request en el repositorio de Gutenberg.

Probar un PR de Gutenberg​

  1. Para probar otros PRs de Gutenberg, haz checkout en la rama asociada a él.
  2. Descarga los últimos cambios para asegurarte de que tu copia local está actualizada.
  3. A continuación, instala las dependencias necesarias, asegurándote de que tu entorno de pruebas coincide con los últimos cambios.
  4. Finalmente, compila el código en modo de desarrollo.
# copia el nombre-de-la-rama desde GitHub #
git checkout nombre-de-la-rama
git pull
npm install
npm run dev

# En una terminal diferente dentro del directorio de Gutenberg *
npx @wp-playground/cli@latest server --auto-mount

Probar un PR de Gutenberg con Playground en el navegador​

No necesitas un entorno de desarrollo local para probar los PRs de Gutenberg; usa Playground para hacerlo directamente en el navegador.

  1. Copia el ID del PR que te gustaría probar (elige uno de la lista de pull requests abiertos).
  2. Abre el visualizador de PRs de Gutenberg de Playground y pega el ID que has copiado.
  3. Una vez que hagas clic en Ir, Playground verificará que el PR es válido y abrirá una nueva pestaña con el PR correspondiente, permitiéndote revisar los cambios propuestos.

Traducir plugins de WordPress con Playground en el navegador​

Puedes traducir los plugins de WordPress compatibles cargando el plugin que quieres traducir y usando la traducción en Línea. Si los desarrolladores del plugin han añadido la opción, encontrarás el enlace Translate Live en la barra de herramientas superior derecha de la vista de traducción. Puedes obtener más información sobre esta nueva y emocionante opción en esta entrada del blog de Polyglots.

Obtener ayuda y contribuir a WordPress Playground​

¿Tienes alguna pregunta o una idea para una nueva función? ¿Has encontrado un error? ¿Hay algo que no funciona como esperabas? Estamos aquí para ayudarte: