Cómo contribuir a Gutenberg como desarrollador de WordPress

Le gustará más o menos, pero Gutenberg, el editor de bloques de WordPress, está aquí para quedarse. Lo bueno es que al ser de código abierto puede cambiarlo según lo desee (si sabe cómo). Además, si encuentra un error en el editor, cree que debe resolverse, puede informarlo o tratar de resolverlo usted mismo y cargar los cambios para que todos los aprovechemos. Con esto contribuirá a mejorar el proyecto, así como a su buen karma.

Escribir contenido en Gutenberg parece muy natural. ¿Conoces los pasos a seguir para contribuir al código base de Gutenberg? Probablemente tu respuesta sea no. Lo mismo me pasó y tuve que investigarlo. Así que explicaré cómo hacerlo para que sea más fácil y más rápido comprender todo el proceso y luego contribuiré a la mejora de Gutenberg (si lo desea) con su propio desarrollador.
Hay mucho que hacer y mejorar, pero está disponible para ayudar a resolver los problemas que encuentra con el editor de bloques de WordPress. Pasos para contribuir al desarrollo de Gutenberg antes de comenzar, asumiré que tiene un conocimiento mínimo sobre GIT y que tiene una cuenta de GitHub. Si este no es el caso, solo tiene que crear una cuenta y echar un vistazo a este tutorial para descubrir los conceptos básicos. Cree una bifurcación de Gutenberg Lo primero que debe saber es que el código fuente de Gutenberg está alojado en GitHub en este depósito de código. Existe la evolución del proyecto.

Github’s Ghitberg Warehouse para WordPress. Aquí tienes el código Gutenberg como complemento WordPress. Para cada nueva versión del complemento, la versión estable de la base de código se transfiere a la próxima versión del núcleo de WordPress. Y esa es la forma de seguir. Para contribuir con el código al almacén de Gutenberg, lo primero que debemos hacer es crear un Furk en nuestra cuenta de GitHub. Para hacer esto, hacemos clic en el botón de la horquilla que aparece en la esquina superior derecha, que puede ver en la imagen anterior. Esto creará un depósito en su cuenta de GitHub con las mismas características y código que el WordPress oficial. Pero dado que está en una cuenta que controla, tendrá acceso para cambiar el código y hacer lo que quiera con él. Básicamente, tiene una copia. Clone the Warehouse Ahora tiene su propio almacén de Gutenberg conectado al original. Es hora de descargarlo a su computadora y trabajar en ella. Para hacer esto, abra un terminal y ejecute el siguiente pedido: Git Clone https://github.com/your-user/gutenberg.git Recuerde reemplazar a su usuario con el nombre de usuario que usa en Github. Esto creará la carpeta Gutenberg en su computadora, descargando todo su contenido local de depósito de GitHub. Cree una nueva rama si accede a la nueva carpeta, verá que contiene todo lo que aparece en la rama principal del depósito (o la rama principal). No debe tocar esta rama con cambios, por lo que antes de cambiar el código Gutenberg, consulte cómo crear una nueva rama.
Si no sabe qué hay una rama en su cuello, le animo a que lea este artículo. Sin embargo, para lo que hacemos, solo necesita saber que las ramas en el GIT son la forma de separar los cambios que realizamos en el código de un almacén, para mantener un cierto orden. Si quiero agregar una nueva funcionalidad, crearé una nueva rama cuyo nombre identifica lo que haré y luego desarrollaré la funcionalidad allí. Una vez terminado y cuando todo mi código modificado es estable, puedo combinar esa rama con la rama principal (maestro, retener) y listo. Los comandos GIT para crear una nueva rama y cargarla en el almacén son los siguientes: Git Checkout -B/Clone-Block Git Push -u Origin/Clone-Block creará rama/clon-bloque fijo. No olvides cambiar el nombre de acuerdo con lo que harás. Según la Guía de colaboradores de Gutenberg, debe usar un nombre para su rama de prefijo y descripción, como: [tipo]/[cambio]. Un buen prefijo suele ser:
Agregar/ agregar una nueva funcionalidad
Funcionalidad de prueba/ experimental, para fines de prueba
Actualización/ actualización de la funcionalidad existente
solucionar/ solucionar un problema
Por ejemplo, Fix/Clone-Block indica que propondremos un remedio cuando clonemos bloques.
Aplique cambios en el código ahora, tiene todo listo para abrir los archivos con el editor que más le guste y para comenzar a programar. Pero antes de hacer esto, debe saber algunas cosas … Primero, todo el código Gutenberg sigue una guía de estilo específica que debe respetar. Los detalles específicos sobre cómo escribir el código se describen aquí.
Ejemplo de reglas para escribir cadenas JavaScript definidas en la Guía de estilo Gutenberg. Hay reglas para CSS, JavaScript y PHP. Respete estas reglas o ciertamente tendrá problemas cuando obtenga el código aceptado en el almacén oficial. FYI, en mi caso, la modificación que hice fue usar el lodash.clonedeep () en los atributos de un bloque cuando clonas un bloque con wp.block.cloneBlock () para que la copia se realice en profundidad, para evitar una copia superficial del bloque que cloné. Puedes ver los cambios que hicimos aquí. Cargue los cambios en la nueva rama una vez que haya terminado confirmar los cambios y cargarlos en el almacén. Si ha creado archivos nuevos, primero debe agregarlos al control de versiones con el siguiente pedido: Git Agregue su archivo y ahora es el momento de confirmar los cambios en este pedido:
Git commit -am “use clonedeep al clonear un bloque” Finalmente, para cargar los cambios en el almacén, debemos usar el siguiente orden: Git Push después, si va al almacén de GitHub, verá los cambios cargados en la rama Lo creaste. ¡Perfecto! Estamos casi allí … Cree una solicitud de extracción al almacén de Gutenberg. Ya hemos realizado los cambios y los cargamos en nuestro almacén. Ahora, lo que debemos hacer es advertir sobre la existencia de los cambios propuestos para los desarrolladores responsables de administrar el proyecto Gutenberg.

Para que nuestros cambios sean discutidos y aprobados para ser parte (o no) del Código Gutenberg, debemos hacer una solicitud de extracción. Una solicitud de extracción es una solicitud que el propietario de una bifurcación de un almacén le hace al propietario del almacén original, de modo que este último incorpora los comentarios que están en la bifurcación. Para hacer esto, vamos a nuestro Gutenberg Fork Warehouse y hacemos clic en el nuevo botón de solicitud de extracción. Esto nos lleva a una visualización para seleccionar la rama que acabamos de cargar con nuestros cambios. Esto se comparará con la rama principal del depósito original de Gutenberg: comparación de la rama maestra del depósito oficial con la rama que incluye nuestros cambios en nuestro almacén bifurcado. Cuando seleccionamos nuestra rama en el selector desplegable a la derecha, como puede ver en la imagen anterior, GitHub nos muestra un resumen de los cambios realizados en esta rama en comparación con el almacén original de Gutenberg. Luego hacemos clic en el botón Crear solicitud de extracción. Esto nos llevará a otra opinión en la que tendremos que completar un texto con información descriptiva por la que queremos hacer estos cambios en el almacén. Como puede ver en la siguiente imagen, ya tenemos una plantilla de contenido que se nos pide que completemos: