Una guía de desarrollador para contribuir al núcleo de WordPress

Cada mes, el equipo aquí desde el delicioso cerebro tiene un “WP Core Contrib”, un día para devolver el núcleo de WordPress. Este es un día importante para nosotros, porque vivimos en complementos premium de WordPress. Usar nuestras habilidades para mantener el maravilloso núcleo de WordPress es simplemente correcto. Además, todos contribuyen con un día de trabajo por mes a WordPress Core están muy cerca de la contribución del 5% de la que Matt Mullenweg habla en su 5 para el futuro. En este artículo, discutiré los conceptos básicos para encontrar cosas para trabajar, cómo administrar el código fuente de WordPress, cómo enviar su trabajo y lo que puede esperar que suceda allí. Este artículo se dirige en gran medida a los desarrolladores de PHP que ya saben cómo configurar una instalación normal de WordPress, pero buscan hundirse y contribuir de nuevo al núcleo de WordPress.
Dado que todos somos desarrolladores en los deliciosos cerebros, hoy en día WP Core contribuye a encontrar boletos para WordPress Core a los que podemos contribuir cometiendo código. Me centraré en este tipo de contribución, pero hay muchas otras formas de contribuir y lo que sea que pueda hacer es apreciado. Dónde encontrar boletos cuando comenzamos a contribuir en noviembre del año pasado, el primer gran obstáculo que conocimos fue dónde encontrar boletos para trabajar. Aquí hay algunos lugares que hemos atraído por encontrar buenas entradas. Los primeros buenos errores https://core.trac.wordpress.org/tickets/good-first-bugs
El informe “Good First Bugs” es una colección de boletos organizados que se consideran buenos para los desarrolladores que han comenzado a contribuir a WordPress. Personalmente encontré algunos boletos a través de este informe y lo recomiendo como primera parada al principio. La primera sección del informe titulada “Sin revestimiento, ¡salta directamente!” Por lo general, es un buen lugar para encontrar boletos que se les haya dado la nueva palabra “buena primera” y que puedan cubrir todo tipo de desarrollo, pruebas y documentación. A veces, los boletos parecen estar en progreso, pero a menudo simplemente necesitan actualizar el parche, lo que generalmente es algo fácil de resolver (vea aplicar un parche y crear un parche). Este informe tiene algunos enlaces muy útiles a los campos de El manual de los contribuyentes básicos que te insto a leer. Los estándares de codificación de WordPress son una lectura obligatoria antes de comenzar el desarrollo y espero que ya esté familiarizado con el código de WordPress. Vale la pena leer el artículo “Cómo usamos nuestra herramienta de seguimiento de errores” para familiarizarse con la terminología y el flujo de procesos. Sin parche https://core.trac.wordpress.org/tickets/no-patch el informe “sin parche” o “requiere parche, pero no tiene” es excelente para encontrar boletos para trabajar en el que necesitan un parche de necesidad. Nadie puede haber resuelto el boleto todavía o que un parche existente tiene problemas y se requiere un nuevo parche.
Por lo general, hay una sección de “próximo lanzamiento” de este informe del que le animo a que se acerque a los boletos si desea intentar obtener algunos “accesorios” más temprano que más tarde. Los boletos en esta lista son naturalmente más propensos a ser revisados ​​y probados más rápido, ya que han sido priorizados para el próximo lanzamiento. Siempre es una buena sensación ver su nombre mencionado en una de las publicaciones semanales de WordPress Core y lo alentará a que se acerque a más boletos en el futuro. ¿Necesita pruebas unitarias https://core.trac.wordpress.org/tickets/Needs te sujetas a la mano con pruebas unitarias? ¿Quizás quieras explorar WordPress Core y contribuir al mismo tiempo? ¡Entonces el informe “Requiere pruebas unitarias” es solo el boleto! El siguiente lanzamiento mayor y el próximo menor menor https://core.trac.wordpress.org/tickets/major/workflow https://core.trac.wordpress.org/tickets/minor/workflow estos informes “capturar” son son Una forma excelente para dirigir sus esfuerzos en los boletos asignados para las próximas dos versiones. Los enlaces anteriores son versiones de los informes de lanzamiento de la próxima especialidad y el próximo menor de acuerdo con el estado de trabajo, los prefiero, porque es mucho más fácil encontrar boletos que se ajusten a sus habilidades (desarrollo, pruebas, etc.).
Informes de error https://make.wordpress.org/core/reports/ Este informe tiene un título incorrecto, es más bien un boleto para boletos y le brinda un excelente punto de partida para varios informes de boletos. Es el lugar para ir cuando quieres navegar un poco. Hay una linda sección “Boletos por tema” que le brinda acceso rápido a componentes y áreas de interés para WordPress. Para nosotros, una elección natural es el área del componente de “complementos”. También hay una sección “I”, que es muy útil para rastrear los boletos que ha creado, comentado o preferido. También puede ver todos los boletos que tiene un parche sobresaliente. Estirar en Slack #core https://wordpress.slack.com si no está seguro de si un boleto es bueno para comenzar a trabajar o tener preguntas sobre cómo abordar un boleto central de WordPress , no pospongas, ¡pregunte en el canal Slack #core! Hay más información sobre cómo comenzar con los canales de WordPress Slack en https://make.wordpress.org/chat/. Configuración de un sitio de desarrollo OK, suponga que ha encontrado un boleto de investigación. Para seguir, debe descargar el código fuente de WordPress Core, crear WordPress, configurar su sitio de desarrollo local y girarlo antes de profundizar.
Descargue la fuente de fuente de WordPress Core es muy diferente del software de WordPress que descarga para configurar una nueva instancia de WordPress. Tiene una estructura de dirección diferente para ayudar a desarrollar y se almacena en un almacén de subversión (SVN). Como tal, debe usar SVN para obtener su copia del tronco. $ svn co https://develop.svn.wordpress.org/trunk WordPress-Core debe ver una estructura de director similar a la siguiente: Build WordPress para asegurarse de que se construyan cualquier cambio que realice en WordPress y se ejecutarán correctamente, es Es mejor ejecutar su sitio de construcción en el director de compilación creado cuando se construye WordPress, en lugar de directamente desde SRC. Sin embargo, esto requiere algunas herramientas.
Herramientas requeridas:
Node.js
npm

Terrestre
Para construir WordPress Core, deberá instalar Primer. Si sus herramientas de desarrollo favoritas aún no incluyen imprimación, hay una guía inicial muy simple para la configuración del cebador y sus adicciones: node.js y npm. Cambie en el directorio que acaba de crear al verificar la fuente de núcleo de WordPress, instalar módulos NPM y ejecutar el cebador predeterminado. $ CD WordPress-Core $ npm Install $ Grurt ahora debe ver algunos directorios nuevos en WordPress Core: Node_Modules y Build.
De ahora en adelante, cada vez que realiza un cambio en el código fuente de WordPress en el director del SRC, simplemente puede ejecutarse nuevamente en el director raíz para la actualización de la compilación, el contenido del director de compilación. Estamos hablando más sobre esto más adelante en la sección Keep It Limpie.
Configurar su sitio local de WordPress tiene una característica elegante que le permite colocar el archivo wp-config.php en el director del director del que sirve al sitio. En este caso, podemos poner wp-config.php en el directorio raíz, incluso si nuestro sitio será atendido desde el gerente de edificios. Seguirá levantándolo. Copie wp-config-smple.php a wp-config.php y actualice para incluir los detalles de la base de datos para una nueva base de datos MySQL que ha creado localmente. Mientras está en esto, ¿por qué no copiar las pruebas WP-config-smple .php archivo a wp tests-config.php y actualizarlo con los detalles de la base de datos para otra base de datos que ha creado localmente para que pueda ejecutar y ejecutar pruebas unitarias. Es importante usar una base de datos separada para pruebas unitarias, porque la base de datos está completamente renovada durante el rodamiento de pruebas unitarias. Ahora que tiene un wp-config.php para su sitio de desarrollo, es hora de configurar un sitio web, como http://wordpress-core.dev, que utiliza el director de compilación como documento de compilación. Utilizo MAMP Pro por su simplicidad y flexibilidad, pero debe usar lo que se sienta más cómodo. Idealmente, use PHP 5.2.x en su desarrollo, ya que esta es la versión mínima aceptada por PHP para WordPress. El desarrollo con él le impedirá utilizar funciones de versiones PHP posteriores que no funcionen con PHP 5.2.
Dale el momento de la verdad. Asegúrese de poder conectarse a su nuevo sitio de desarrollo de WordPress y configurarlo.
También debe pensar en usar algo como la prueba WP para completar su nueva hermosa WordPress con algunos datos de prueba.Dirigir las pruebas unitarias es una muy buena idea para ejecutar pruebas unitarias solo para asegurarse de que todo esté bien en su sitio de desarrollo y que cualquier cambio que realice más tarde no destruya nada.De la raíz de la fuente verificada … $ Phunitnu se sorprendería si ve una falla o dos en las pruebas unitarias.Cuando se trabaja en el baúl, a menudo hay algunos.(¿Tal vez podrías remediarlos?) Al menos sabes dónde hay problemas y, por lo tanto, cuando realiza los cambios, ¡puedes averiguar si has hecho lo mejor, peor o al menos que no los has afectado!

Desarrollo Ahora está listo para desarrollarse en WordPress Core, mantenga su almacén actualizado con SVN y reconstruya su núcleo de WordPress con imprimación, según sea necesario o mediante un proceso de reloj. Supongamos que comienza sus contribuciones centrales de WordPress actualizando un parche. Esto implica descargar el archivo de corrección de un boleto, aplicarlo a la fuente verificada, verificar si todavía se aplica correctamente y hace lo que se espera, la recreación del parche y su archivo adjunto al boleto con un nombre actualizado y palabras clave actualizadas. Manténgalo limpio antes de aplicar un parche, asegúrese de que su fuente y construcción estén “limpias”. No hay nada peor que trabajar en algo solo para descubrir que no puede crear un parche limpio, ya que tiene algunos cambios de código anteriores de otro contaminación de boletos. $ SVN Diff Si SVN Diff devuelve algo, tal vez porque ya ha trabajado en un parche, cancele los cambios. $ SVN Reel ruta/a/cambiado/archivo y luego verifique nuevamente con SVN DIF. Cuando no haya cambios en la finalización del pago, asegúrese de estar al tanto de otros cambios que se han cometido en el almacén. $ SVN ahora Asegúrese de que sus depósitos estén limpiados, luego dale un giro. $ Grunt aplicando un parche Descargue el último archivo de corrección de su boleto. Debe llamarse algo así como 14584.3.patch, donde 14584 es el número de boleto y .3 es un número opcional de la versión de corrección que aumenta con cada nuevo parche para un boleto.
El primer archivo de corrección para el boleto 14584 se habría llamado 14584.patch.Si actualiza el parche para un boleto anterior, puede encontrar que el nombre del parche se asemeja a 14584v3.diff.El archivo debe copiarse en el directorio raíz y aplicarse allí con Patch: $ Patch -p0 <14584.3.patchpatch siempre se crea y aplica desde la raíz de la base de código, por lo que debería ver src/… O pruebas/.. . En nombre de los archivos que se corrigen.Esperamos que el parche se aplique de acuerdo con las expectativas.Si no es así (tal vez es por eso que lo actualiza), es posible que deba cancelar cualquier aplicación parcialmente aplicada con SVN Revert .Debido a que uso el maravilloso PHPStorm para todo mi desarrollo de PHP, puedo encontrar fácilmente todos los cambios aplicados por corrección.

Sin embargo, otra forma de verificar si el parche aplicado correctamente es usar el mismo método que usaría para crear un parche. Desarrolle y pruebe cuando se trata de cambios en el código, asegúrese de desarrollar cambios en el directorio SRC de la fuente verificada y asegúrese de cumplir con los estándares de codificación de WordPress. Consulte el artículo de WordPress CodeBase si no está seguro de dónde se debe colocar el nuevo código en el código básico. A medida que realiza los cambios, use prima para actualizar el director de compilación, para que pueda probar los cambios a medida que pasa. Si es posible, agregue pruebas unitarias o actualice pruebas unitarias en el directorio de pruebas, lo que ayuda a asegurarse de que su código se integre bien. Asegúrese de ejecutar pruebas unitarias de vez en cuando. Y seguramente ejecutarlos cuando cree que ha terminado de desarrollar y probar antes de crear un parche. La creación de un parche ha desarrollado y probado los cambios y ahora está listo para enviar los cambios al núcleo de WordPress para el equipo de revisión y prueba. ¿Cómo haces esto? Sucede que si ejecuta lo siguiente, obtendrá exactamente lo que se necesita para corregir otro cheque de depósito: $ SVN DIF

Entonces, para crear su archivo de corrección, simplemente redirige el resultado de SVN Diff a un archivo: $ SVN DIF> 14584.4.patch Es importante tener en cuenta que creamos un archivo con una versión creciente. Incluso si nada ha cambiado en la superficie en este ejemplo, lo hemos generado a partir de una versión mucho más del depósito y, por lo tanto, debemos aumentar el número de la versión si actualizamos y volvemos a enviar el parche de boleto. Enviar el parche para enviar el archivo de corrección es relativamente simple. Asegúrese de estar conectado a WordPress.org, explore el boleto en cuestión y debe encontrar un bloque de archivos adjuntos ubicados entre el bloque de descripción principal y el historial de los cambios. En los archivos adjuntos hay un botón de “archivo adjunto” que lo lleva a Una página donde puede elegir el archivo de carga y dar una breve descripción.



Cambie el ticket a la parte inferior del boleto de WordPress en el que trabajó, debería ver un bloque de modificación del boleto.


Dependiendo de lo que haya hecho o haya encontrado, es posible que deba cambiar algunas de las palabras clave del flujo de trabajo en la modificación de las propiedades.En la mayoría de los casos, eliminará cosas como las palabras clave “necesidades de necesidades” o “refresh de necesidades” y agregará las palabras clave “tiene patch” y “necesita”.Una vez terminado, esto moverá el boleto al informe basado en las palabras clave de alguien como algo para examinar y probar.Si tiene alguna duda sobre cómo cambiar las palabras clave, consulte el artículo oficial sobre el uso de la herramienta de seguimiento de errores.Es muy poco probable que necesite cambiar algo en la sección de acción.¡He cambiado algunos artículos por error una vez allí y no haré esto a toda prisa!
Esta sección es en principio para cerrar un caso, ya sea porque se completó y se fusionó en el almacén, o porque se descubrió que no era válido por una razón u otra (por ejemplo, un duplicado). Es mejor dejar esta sección en paz, a menos que esté en el equipo central de WordPress o que haya sido designado para revisar la validez del boleto. Limpie nuevamente ahora que ha enviado el parche y que está listo para pasar al siguiente boleto, asegúrese de que el almacén esté listo para un nuevo desarrollo (ver Mantenlo limpio). Al dejar el archivo de corrección creado en el directorio raíz, no debe interferir con ningún desarrollo nuevo (debe excluirse automáticamente de cualquier diferencia), es mejor eliminarlo. Siempre puede reasignar el archivo de corrección enviado desde el boleto. Manténgase al día con sus boletos incluso si ha enviado su mejor parche en el historial de desarrollo de WordPress, eso no significa que haya terminado. Por varias razones, su parche puede no ser revisado, probado y enviado a través del tronco. Debe tener en cuenta sus boletos. De vez en cuando, debe asegurarse de que el parche todavía se aplique al tronco y, si no, actualice. Notificaciones por correo electrónico Hay altas posibilidades de recibir algunas notificaciones por correo electrónico cuando las cosas cambian en los boletos en los que ha trabajado. Asegúrese de leerlos, porque pueden ser cosas que debe hacer en respuesta, como la reticencia del parche o la respuesta a un comentario para aclarar algo. El mejor tipo de notificación es una notificación de compromiso o lo que yo llamo un correo electrónico de “accesorios”. Son maravillosos.
Es genial ver que su nombre de usuario tiene algunos elementos de accesorios cuando un boleto está cerrado como completo. ¡Tómate un momento y golpea tu espalda, lo ganaste! Mis parches https://core.trac.wordpress.org/my-patches usan este informe de TRAC de vez en cuando para examinar el estado de los boletos a los que envió correcciones, pero por algunas razones aún no han sido aceptadas, revisadas,, revisadas, probado o enviado al baúl. Los boletos a los que asistí https://core.trac.wordpress.org/my-comments es un informe ligeramente diferente del informe My Patch, ya que incluye los boletos que comentó. Tal vez haya revisado o probado un parche. Cronología https://core.trac.wordpress.org/timeline es más para felicitarte o simplemente encontrar ese boleto por el que recuerda haber hecho algo, pero puede estar cerrado ahora. Por defecto, este informe muestra todos los eventos de boletos en que estabas involucrado hace hasta 90 días. Si desea ver un poco más tarde, hay un panel de control a la parte superior derecha que puede usar para establecer la fecha de inicio o puede usar los enlaces de “período anterior” y el “próximo período” para regresar y avanzar a través de su cronología . ¡Verse envuelto! Nos gustó compartir lo que trabajamos entre nosotros, nuestros éxitos y fracasos y realmente descubrimos que está lleno de satisfacción. Con cada pequeña contribución, ayudamos a empujar a WordPress un poco antes. Cuantas más personas solo hagan un poco cuando pueden, más WordPress puede evolucionar y mejorar más rápido. Todo se está reuniendo. ¡Involucrarse, ayudar a hacer WordPress antes!