Versionar correctamente un proyecto en WordPress

WordPress es una excelente herramienta para crear webs y blogs, pero para su funcionamiento se requieren tener los archivos de WordPress (core, plugins, themes).

Esto es un problema por que estos archivos van cambiando en cada versión e incrementan el tamaño del repositorio, lo correcto es versionar solamente los archivos del theme o plugin que vamos a crear.

Consideraciones Generales

Para versionar correctamente un proyecto en WordPress es necesario tener las siguientes consideraciones:

No versionar los archivos propios de WordPress, estos cambian en cada versión.
No versionar los archivos de themes y plugins descargados.
No versionar los archivos de la carpeta uploads/, son archivos del usuario.
Documentar el proceso para configurar rápidamente el proyecto.

Configurar el repositorio

La configuración del repositorio consiste en evitar versionar los archivos de WordPress, para ello creamos el archivo .gitignore con las siguientes reglas:


# Hidden files
*.DS_Store
*Thumbs.db

# WordPress Core
*.php
*.txt
*.html
wp-admin/
wp-includes/

# WordPress Themes
wp-content/themes/*.php
wp-content/themes/twenty*

# WordPress Plugins
wp-content/plugins/

# WordPress Content
wp-content/*.php
wp-content/backup*
wp-content/cache/
wp-content/languages/
wp-content/upgrade/
wp-content/uploads/
wp-content/debug.log

Configurar WordPress

Para configurar WordPress utilizaremos la herramienta en línea de comandos WP-CLI que permite descargar y configurar WordPress.

Lo primero es descargar la última versión WordPress:

wp core download

Si prefieres descargar una versión anterior y en español puedes usar:

wp core download --version=4.8.8 --locale=es_ES

Luego puedes crear el archivo wp-config.php interactivamente con:

wp config create --prompt

Configurar carpeta uploads

Para un proyecto WordPress que tenga contenido cargado previamente, se necesita redireccionar los archivos de la carpeta wp-content/uploads/ hacia el servidor de producción ya que esos archivos no existen en local. Esto lo hacemos con el archivo .htaccess.


RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule wp-content/uploads/(.*) http://domain.com/wp-content/uploads/$1 [NC,L]

Notese que debes reemplazar http://domain.com por el dominio de tu servidor de producción.

Documentación

Un paso opcional pero muy importante es documentar el proyecto, la documentación debe ayudar a configurar rápidamente WordPress, de preferencia la documentación debe estar escrita en formato Markdown y contener de forma breve: descripción, requerimientos, configuración y accesos.

Con esta información se debe poder configurar el proyecto rápidamente. Como recomendación puedes usar el formato Markdown para la documentación.

Conclusiones

Una correcta configuración del repositorio debe permitir el versionar sólo de los archivos del theme o plugin que vamos a trabajar. Esto unido a una documentación y la ayuda de WP-CLI puede ayudar a ahorrar tiempo en la configuración de WordPress.

Para finalizar les comparto: docker-wordpress un proyecto para crear un ambiente de desarrollo en WordPress con Docker el cual incluye los lineamientos descritos en este artículo.