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.
Envíar Comentario
En este sitio los comentarios se publican previa aprobación del equipo de Kodetop. Evita los comentarios ofensivos, obscenos o publicitarios. Si deseas publicar código fuente puedes hacerlo entre las etiquedas
<pre></pre>