Usar Git con WordPress: una guía paso a paso

Compartir tus creaciones es lo que hace que el arte cobre vida, y lo mismo ocurre con los desarrolladores de WordPress. Cuando has creado algo nuevo o emocionante para la plataforma, es natural que quieras compartirlo con la comunidad de WordPress en general. Tal vez incluso estés pensando en alojar tu código personalizado de forma gratuita. Si te identificas con él, usar Git con WordPress podría ser tu opción perfecta.

Git y GitHub trabajan juntos para proporcionar una solución eficaz para el control de versiones y la administración de su base de código. Le permite alojar su trabajo e invitar a otros desarrolladores a revisar y modificar su código. Además, con las páginas de GitHub, puedes aprovechar el alojamiento gratuito si estás implementando un sitio estático de WordPress.

En esta guía, te mostraremos cómo usar GitHub para administrar tus temas y plugins de WordPress . También descubrirás cómo usar un generador de sitios estáticos de WordPress para implementar tus proyectos en páginas de GitHub, sin gastar un centavo.

¿Qué es Git?

Git, abreviatura de ‘global information tracker’, es un sistema de control de versiones distribuido diseñado para ayudarte a realizar un seguimiento de los cambios en los proyectos o archivos de codificación. Estos proyectos se almacenan en un «repositorio» (repositorio para abreviar), que es esencialmente una carpeta principal que Git usa para organizar todos los archivos que administra.

Git es una herramienta de referencia para los desarrolladores que trabajan en varios proyectos de software. Una de sus mayores ventajas es que varias personas pueden crear sus propios clones del repositorio principal, que contiene el código original. A continuación, pueden realizar ediciones o cambios en su propio equipo local sin alterar directamente el repositorio principal.

Una vez que los cambios están listos para publicarse, los usuarios los suben a un servicio como GitHub, que ayuda a mantener los repositorios del equipo organizados y accesibles.

Git vs. GitHub

Una pregunta común, especialmente para los principiantes, es: ¿cuál es la diferencia entre Git y GitHub?

Muchos nuevos desarrolladores o propietarios de sitios asumen que Git y GitHub son lo mismo, pero en realidad son herramientas diferentes. Git es el sistema de control de versiones: rastrea los cambios en tu código y lo organiza en repositorios. Por otro lado, GitHub es una plataforma de alojamiento web que almacena repositorios de Git, lo que los hace fácilmente accesibles para los equipos.

Si bien puede usar Git por sí solo, administrando todo localmente, GitHub requiere que Git funcione. GitHub también destaca entre otras plataformas de alojamiento de Git como Launchpad, Assembla y Bitbucket por sus características adicionales, que son especialmente útiles para empresas y equipos remotos. Su interfaz fácil de usar y sus herramientas de colaboración hacen que trabajar en proyectos compartidos sea mucho más sencillo.

Además, con GitHub, todo se almacena de forma segura en la nube, por lo que incluso si tu máquina local se daña o se pierde, tu código sigue siendo seguro.

Requisitos previos para usar Git con WordPress

Antes de empezar a integrar Git con tus proyectos de WordPress , es esencial que te asegures de que tienes las herramientas necesarias y los conocimientos básicos. Esto es lo que necesitarás:

Conocimientos básicos de línea de comandos

La familiaridad con las interfaces de línea de comandos (CLI) como Terminal en macOS/Linux o Símbolo del sistema/PowerShell en Windows es crucial. Usará comandos de la CLI para interactuar con Git. También debe saber navegar por directorios (cd), listar archivos (ls o dir) y ejecutar comandos básicos.

Git instalado en su máquina local

Compruebe si Git está instalado ejecutando el git --version en su línea de comandos. Si no está disponible, puedes descargarlo desde el sitio web oficial de Git. Si aún no se ha instalado, siga las instrucciones de instalación de su sistema operativo.

Instalación local de WordPress

Cree un entorno de servidor local con MAMP, XAMPP, WampServer o WP local. Luego, instala WordPress localmente para tener un campo de pruebas seguro para tu trabajo de desarrollo.

Cuenta de GitHub

Regístrese para obtener una cuenta gratuita en GitHub y comprenda cómo crear repositorios de GitHub, confirmar cambios y navegar por la interfaz de GitHub.

Editor de texto o IDE

Puede utilizar un editor de texto como Visual Studio Code, Sublime Text o un entorno de desarrollo integrado (IDE) como PhpStorm para la codificación.

Comprensión básica de la estructura de archivos de WordPress

Debes saber dónde se encuentran los temas (wp-content/themes/) y los plugins (wp-content/plugins/) dentro del directorio de WordPress. La comprensión básica de la función de los archivos principales de WordPress ayudará aún más a evitar modificaciones no deseadas.

Si bien las habilidades de programación no son obligatorias para el control de versiones, la familiaridad con las prácticas de desarrollo de PHP y WordPress lo ayudará a realizar contribuciones significativas a sus proyectos.

Beneficios de usar Git y GitHub con WordPress

Si estás trabajando en el desarrollo de WordPress, es probable que te hayas enfrentado a la frustración de gestionar diferentes versiones de tu tema o plugin. Tal vez haya realizado actualizaciones y desee realizar un seguimiento de los cambios, o tal vez haya colaborado con otros y necesite una forma simplificada de administrar las contribuciones. Aquí es donde Git y GitHub se vuelven útiles:

• Control de versiones: Git le permite realizar un seguimiento de los cambios en sus archivos, mantener un historial de modificaciones, revertir fácilmente a versiones anteriores y colaborar sin caos.
• Seguridad de copia de seguridad: GitHub realiza copias de seguridad seguras de tu código en varias ubicaciones, por lo que no tienes que preocuparte por perder datos importantes.
• Compartir sin esfuerzo: Compartir tu código con otros se vuelve fácil, ya sea que estés trabajando en proyectos de código abierto o colaborando con un equipo privado.
• Colaboración fluida en equipo: GitHub agiliza el trabajo con otros, lo que permite contribuciones fluidas de varios desarrolladores en el mismo proyecto.
• Crea conexiones: colaborar en GitHub abre las puertas para establecer relaciones con otros desarrolladores y expandir tu red profesional.
• Mejora tu perfil: GitHub no es solo una solución de almacenamiento, también es una excelente manera de mostrar tu trabajo y crear un perfil profesional que otros puedan ver.
• Flujo de trabajo de desarrollo profesional: El uso de Git y GitHub hace que la gestión del flujo de trabajo de desarrollo de WordPress sea más fácil y profesional.

Cómo usar Git y GitHub para el desarrollo de WordPress

Git y GitHub son herramientas invaluables para el desarrollo de temas y complementos de WordPress. Ya sea que estés trabajando en la creación de un nuevo tema o personalizando uno existente, GitHub ofrece una plataforma ideal para administrar la base de código de tu proyecto.

Por ejemplo, cuando desarrollas un tema personalizado para tu sitio, puedes obtener el repositorio de temas de GitHub, realizar los cambios y probarlo en un servidor local. Una vez que esté satisfecho con las actualizaciones, envíe el repositorio actualizado a GitHub y luego aplique esos cambios al sitio web de WordPress en vivo.

El mismo flujo de trabajo se aplica al desarrollo de plugins. Si eres un desarrollador de WordPress que crea un plugin, GitHub te ayuda a administrar el código base de manera eficiente. Esto es especialmente útil para proyectos de código abierto, donde otros desarrolladores pueden contribuir corrigiendo errores o mejorando funciones. Puedes descargar los archivos del plugin desde GitHub, mejorar y compartir tu trabajo con la comunidad.

Además de gestionar el desarrollo, GitHub también puede utilizarse para descargar e instalar plugins y temas de WordPress en tu sitio web en vivo. Sin embargo, vale la pena señalar que, si bien GitHub permite el almacenamiento y la descarga de archivos, no está destinado a servir como almacenamiento de archivos como Dropbox o Google Drive.

Configuración de un entorno local de WordPress para Git

Antes de sumergirse en Git y GitHub, es la mejor práctica crear un entorno local de WordPress. Aquí es donde puedes trabajar de forma segura en tu proyecto, hacer cambios, probar tu nuevo código y desarrollar plugins o temas sin afectar a tu sitio web en vivo. Si algo sale mal, puede depurar y corregir fácilmente el código en su entorno local antes de implementarlo en vivo.

Para configurar un entorno local, necesitarás un software que te permita alojar un sitio de WordPress directamente en tu computadora, en lugar de un servidor en vivo o de prueba. Herramientas como Local WP (anteriormente conocido como Local by Flywheel), MAMP, XAMPP y WampServer son excelentes opciones para crear entornos locales. Son gratuitos, fáciles de usar y fáciles de configurar.

Instalación de Git localmente y creación de un repositorio de Git

Una vez que tu entorno local de WordPress esté configurado, el siguiente paso es instalar Git en tu computadora. Sin embargo, antes de sumergirse en la instalación, es una buena idea comprobar si Git ya se ha instalado. Si estás utilizando un dispositivo macOS o Linux, lo más probable es que encuentres Git preinstalado.

Para comprobarlo, abra la Terminal (en Mac o Linux) y escriba el comando:

git --version

En Windows, puede verificar abriendo el símbolo del sistema e ingresando el mismo comando:

git --version

Si Git ya está instalado, verás su número de versión. De lo contrario, no verá nada o recibirá un mensaje de error que indica que el comando es desconocido. En ese caso, tendrás que instalar Git manualmente.

Para instalar Git, realice las siguientes acciones:

• Ve al sitio web de Git.
• Vaya al área Descargas.

• Elija el enlace de descarga correspondiente en función de su sistema operativo (Mac, Windows o Linux/Unix).

• Inicie el asistente de instalación después de la descarga.
• Para finalizar la instalación, haga clic en Siguiente y siga las instrucciones que aparecen en pantalla.
• Para asegurarse de que Git se ha instalado correctamente, reinicie su terminal o símbolo del sistema después de la instalación y escriba el siguiente comando:

git --version

Ahora que Git está en funcionamiento, es hora de crear un repositorio de Git local. Este repositorio te permitirá confirmar cambios en tus archivos de WordPress antes de enviarlos a GitHub.

A continuación, te explicamos cómo puedes crear un repositorio local:

• Navega a los archivos locales de tu sitio de WordPress en tu computadora.
• Ve a la carpeta wp-content y busca la carpeta del plugin o tema en el que estás trabajando.

• Haz clic con el botón derecho del ratón en cualquier lugar dentro de esa carpeta de WordPress y selecciona Abrir Git Bash aquí (o abre Git manualmente si estás en Mac/Linux).
• En el terminal, escriba el siguiente comando para inicializar un nuevo repositorio de Git:

git init

• A continuación, para preparar todos los archivos para la primera confirmación, ejecute este comando:

git add .

• Ahora, es el momento de confirmar los cambios. Puedes agregar un mensaje de confirmación para explicar los cambios que realizaste:

git commit -m "your message here"

Asegúrate de reemplazar «tu mensaje aquí» con una nota relevante sobre las actualizaciones que has realizado. Pulsa Intro para completar la confirmación.

Después de esto, aparecerá una carpeta .git oculta en los archivos locales del tema de WordPress o en los archivos del plugin, lo que indica que tu repositorio está configurado y listo para el control de versiones.

Creación de un repositorio de GitHub y confirmación de cambios

El siguiente paso es crear un repositorio en GitHub para alojar tu proyecto después de configurar Git localmente. A continuación, le indicamos cómo realizar estas acciones:

• Visita el sitio web de GitHub y crea una cuenta gratuita. Después de ingresar tu dirección de correo electrónico, haz clic en el botón Registrarse en GitHub.

• En la siguiente pantalla, debe completar sus datos, como su nombre de usuario de GitHub, contraseña y preferencias de correo electrónico. GitHub también te pedirá que resuelvas un rompecabezas rápido para verificar tu cuenta, similar a reCAPTCHA.
• Una vez que tu cuenta esté configurada, se te dirigirá al panel de control de GitHub. Busque el icono ‘+’ en la parte superior derecha, haga clic en él y seleccione Nuevo repositorio.

Ahora que estás creando un nuevo repositorio, esto es lo que debes hacer:

• Escriba un nombre para el nuevo repositorio. También puede agregar una descripción opcional.
• Elija si desea que su repositorio sea público o que sea privado.
• Desplázate hacia abajo y verás más opciones, como agregar un archivo README (que es excelente para la documentación) y seleccionar una licencia para tu proyecto.
• Una vez que hayas completado todos los detalles, haz clic en el botón Crear repositorio.

Obtendrá una URL después de crear el repositorio. Este enlace conectará tu repositorio local con el que acabas de crear en GitHub. Puede encontrar la URL en la sección Configuración rápida.

Para vincular el repositorio local con el repositorio de GitHub, abra Git Bash y ejecute el siguiente comando, reemplazando la URL por el enlace del repositorio de GitHub:

git remote add origin URL

Después de eso, inserte sus archivos locales en GitHub escribiendo el siguiente comando:

git push -u origin main

Si tu cuenta de GitHub aún no está vinculada con Git, se te pedirá que inicies sesión y autorices la conexión. Una vez hecho esto, los archivos locales se cargarán en GitHub, donde estarán disponibles para que otros los vean y colaboren en ellos.

En este punto, tu repositorio en GitHub mostrará los archivos que has editado localmente. Otros desarrolladores ahora pueden bifurcar, clonar o contribuir a su proyecto. Si alguien actualiza el repositorio, puede obtener los cambios más recientes en su entorno local ejecutando el siguiente comando en Git Bash (nuevamente, reemplazando la URL con el enlace del repositorio de GitHub):

git fetch URL

Esto garantiza que el entorno local se mantenga sincronizado con las últimas actualizaciones de GitHub. Una vez que estés satisfecho con los cambios, puedes enviarlos a tu sitio web de WordPress en vivo.

Implementación de temas y complementos de GitHub en un sitio de WordPress en vivo

Después de completar el desarrollo de su complemento o tema de WordPress, el paso final es implementarlo en su sitio en vivo. Si bien puede usar comandos de Git para enviar actualizaciones a WordPress, hay una manera más fácil de usar el complemento WP Pusher , que simplifica este proceso.

A continuación, te explicamos cómo puedes desplegar tu proyecto con WP Pusher:

• Dirígete al sitio web de WP Pusher y haz clic en el botón Descargar. Guarde los archivos del complemento en su computadora.

• A continuación, instala y activa el plugin WP Pusher en WordPress.
• Una vez que WP Pusher esté activado, navega a la pestaña GitHub en la configuración de WP Pusher desde tu panel de control de WordPress.
• Aparecerá una ventana que solicita autorización para establecer una conexión con tu cuenta de GitHub. Haz clic en Autorizar wppusher e inicia sesión en tu cuenta de GitHub.
• Después de iniciar sesión, GitHub generará un token para WP Pusher. Copie este token.
• En la configuración de WP Pusher, pega el token en el campo de token de GitHub y haz clic en Guardar token de GitHub. Esto crea un enlace entre tu cuenta de GitHub y el sitio web de WordPress.

Ahora que GitHub está conectado, puedes implementar tus temas y plugins directamente desde tu repositorio de GitHub.

Instala plugins desde GitHub:

• Para instalar un plugin, vaya a WP Pusher » Instalar plugin en el panel de administración de WordPress.
• Ingresa la URL del repositorio de plugins o haz clic en Seleccionar de GitHub para seleccionar el plugin de tu cuenta de GitHub.
• Después de pegar la URL del repositorio, puede especificar opciones adicionales como la rama o el subdirectorio si es necesario.
• Desplázate hacia abajo y haz clic en Instalar plugin para instalarlo en tu sitio web de WordPress.

Activa el plugin:

• Una vez instalado el plugin, selecciona Plugins > Plugins instalados y haz clic en el plugin recién añadido haciendo clic en Activar.
• En este punto, su sitio en vivo puede utilizar el complemento ya que está activo.

Instalar temas desde GitHub:

• Si está implementando un tema en su lugar, siga el mismo proceso en Instalar tema en el menú WP Pusher.
• Introduce la URL del repositorio del tema, rellena los datos necesarios y haz clic en Instalar tema.

Con WP Pusher, la administración e implementación de temas y complementos personalizados de GitHub se vuelve fluida, lo que le permite agilizar el proceso de desarrollo y garantizar que su sitio de WordPress en vivo esté siempre actualizado con los últimos cambios.

Instalación de plugins y temas de WordPress desde GitHub

Más allá de usar Git y GitHub para el desarrollo, también puede obtener complementos y temas que ya no están disponibles en el repositorio WordPress.org. Muchos desarrolladores de WordPress mantienen sus plugins y temas en GitHub, lo que lo convierte en un recurso valioso cuando no puedes encontrarlos en la biblioteca oficial.

A continuación, te explicamos cómo puedes instalar plugins y temas desde GitHub:

• Abre GitHub y busca el plugin o tema que quieres instalar.
• Una vez que encuentres el repositorio, haz clic en el botón Código y selecciona Descargar ZIP. Esto descargará un archivo ZIP que contiene los archivos del complemento o del tema en su computadora.
• Para instalar el plugin o tema descargado, ve a tu panel de control de WordPress. Para los complementos, vaya a Complementos > Agregar nuevo complemento y haga clic en Cargar complemento.

• En el caso de los temas, ve a Apariencia > Temas, haz clic en Añadir nuevo y, a continuación, en Subir. Elige el archivo ZIP que descargaste e instálalo.

• Después de la instalación, active el complemento o tema desde las secciones respectivas en su panel de control de WordPress. Ahora puedes usarlo en tu sitio.

Solución de problemas comunes de Git en proyectos de WordPress

Como nuevo desarrollador que trabaja con WordPress, es posible que te encuentres con algunos problemas comunes de Git. Esta es una guía sencilla que le ayudará a solucionar y resolver estos problemas de forma eficaz.

Conflictos de fusión

Emitir: Encontrará conflictos al fusionar ramas.

Solución:

• Identifique los conflictos: Git señalará qué archivos están en conflicto.
• Edite manualmente los archivos en conflicto: Busque los marcadores de conflicto (p. ej., <<<<<<< CABEZA y >>>>>>>) y resolverlos.
• Almacene provisionalmente y confirme los cambios: Una vez resuelto, usa git add para preparar los archivos y, a continuación, confirma los cambios.

Archivos confidenciales confirmados accidentalmente

Emitir: Los archivos confidenciales (como contraseñas o claves API) se confirmaron accidentalmente en tu repositorio.

Solución:

• Eliminar los archivos: Use git rm –cached filename para eliminar el archivo de su historial de Git.
• Actualiza tu .gitignore: Agregue los archivos confidenciales a .gitignore para que no se vuelvan a confirmar.
• Elimínalos de tu historial de Git: Utilice herramientas como BFG Repo-Cleaner para limpiar las confirmaciones anteriores.
• Actualice las credenciales expuestas: Asegúrese de cambiar cualquier información confidencial que haya quedado expuesta.

Problemas de sincronización

Emitir: Se producen errores al intentar extraer o insertar cambios.

Solución:

• Usa git pull –rebase: Esto garantiza que los cambios se vuelvan a aplicar de forma limpia sobre las últimas confirmaciones.
• Evite empujar con fuerza: Solo fuerce el empuje cuando sea absolutamente necesario, ya que puede sobrescribir el trabajo de otros.
• Compruebe las URL remotas: Asegúrate de que la URL del repositorio remoto sea correcta.

Estado HEAD separado

Emitir: Está trabajando en un estado de «HEAD separado», lo que significa que no está en una rama.

Solución:

• Cree una nueva rama: Ejecute git checkout -b branch-name para crear y cambiar a una nueva rama.
• Cambiar a una rama existente: Usa git checkout branch-name para volver a una rama en la que estabas trabajando anteriormente.

Los archivos en .gitignore aún se rastrean

Emitir: Git sigue rastreando los archivos que has añadido a .gitignore.

Solución:

• Dejar de rastrear los archivos: Utilice git rm –cached filename para detener el seguimiento de los archivos.
• Revisa la sintaxis de tu .gitignore: Asegúrate de que no haya errores en la forma en que has enumerado los archivos en .gitignore.

Repositorio grande debido a los archivos multimedia

Emitir: Su repositorio se está volviendo demasiado grande debido a los archivos multimedia.

Solución:

• Excluir archivos multimedia: Agregue archivos multimedia a .gitignore para que no se confirmen.
• Usar Git LFS: En el caso de los archivos grandes, use Git Large File Storage (Git LFS) para almacenarlos de forma más eficiente.

Conflictos de fin de línea

Emitir: Se enfrenta a problemas debido a diferentes sistemas operativos que utilizan diferentes finales de línea (por ejemplo, Windows frente a Mac/Linux).

Solución

• Configurar Git: Ejecute git config core.autocrlf true en Windows para controlar las diferencias de fin de línea.
• Estandarizar la configuración: Asegúrese de que su equipo use una configuración de Git coherente para evitar futuros conflictos de final de línea.

Términos importantes de Git y GitHub que debes conocer

A medida que profundice en el uso de Git y GitHub para el desarrollo de WordPress, encontrará varios términos clave. Aquí tienes un glosario rápido para ayudarte a navegar:

• Ramas: Piensa en las ramas como rutas separadas dentro de un repositorio. Le permiten realizar cambios independientemente de la base de código principal, por lo que puede experimentar sin afectar la versión en vivo.
• Fusión: La fusión es el proceso de integrar los cambios de una rama a otra. Por ejemplo, puede combinar una rama de características en la rama principal para combinar actualizaciones.
• Extracción: La extracción implica obtener cambios de un repositorio remoto e incorporarlos a su copia local. Garantiza que sus archivos locales permanezcan actualizados con los últimos cambios.
• Solicitudes de incorporación de cambios (PR): Un método para sugerir modificaciones a un repositorio es a través de una solicitud de incorporación de cambios. Antes de que las modificaciones se integren en la base de código principal, permite que otros examinen y debatan los cambios.
• Bifurcación: La bifurcación crea una copia personal del repositorio de otro usuario. Puede realizar cambios en su bifurcación sin afectar el proyecto original.
• Commit: Una confirmación es un registro de las modificaciones que se han realizado en el repositorio. Cada confirmación tiene un ID único y registra quién realizó los cambios y cuándo.
• Push: Push envía los cambios locales a un repositorio remoto en GitHub, lo que los hace accesibles para otros usuarios.

Preguntas frecuentes sobre el uso de Git con WordPress