Cada vez que WordPress anuncia una nueva versión, toca asegurarse de que nuestros plugins siguen siendo totalmente compatibles. Aunque pueda parecer un proceso complejo, en realidad solo requiere revisar unos pocos puntos clave. Vamos a ver como preparar tu plugin para una nueva versión de WordPress.
En esta guía encontrarás el flujo básico —y recomendado— para preparar tu plugin antes del lanzamiento de una versión mayor, como la reciente WordPress 6.9.
1.- Revisa las novedades de la versión
Antes de tocar tu plugin, es fundamental revisar el Field Guide de WordPress, donde se documenta:
- Funciones deprecadas
- Cambios en APIs existentes
- Novedades del editor de bloques
- Cambios en rendimiento y seguridad
- Nuevas funciones, hooks y capacidades
Leer esto te permite anticipar posibles incompatibilidades. En la mayoría de casos no tendrás que modificar nada, pero conviene comprobarlo.
2.- Prueba tu plugin con el plugin WordPress Beta Tester
Para probar tu plugin antes del lanzamiento final, utiliza el plugin oficial de WordPress Beta Tester que permite actualizar tu instalación de pruebas a versiones Beta y RC (Rlease Candidate).
Instalarlo sólo en entornos de desarrollo o staging, nunca en producción.
La configuración recomendada para el plugin de WordPress Beta Tester:
- Channel: Bleeding Edge
- Stream: Beta/RC Only
Cuando WordPress publique la versión RC, podrás actualizar tu instalación con un clic y comprobar que tu plugin funciona con normalidad.
3.- Comprueba el funcionamiento de tu plugin
Con la versión RC instalada, realiza pruebas básicas:
- Activa y desactiva el plugin
- Ejecuta las funciones principales
- Revisa los logs por si aparecen warnings o deprecaciones
- Comprueba que la interfaz en el panel funciona correctamente
Si tu plugin es sencillo, lo normal es que siga funcionando sin necesidad de cambios.
4.- Ajusta avisos o funciones deprecadas
Si observas algún aviso en el log o detectas funciones obsoletas relacionadas con la nueva versión, es el momento de corregirlo. Esto evita problemas futuros y demuestra que el plugin está activamente mantenido.
5.- Actualizar el archivo readme.txt
Este paso es obligatorio para plugins alojados en WordPress.org. Supongamos que tenemos el plugin en la versión 6.8.3 y queremos actualizar a la 6.9
Abres el archivo readme.txt y busca en la línea donde tengas la versión testeada
Tested up to: 6.8.3Y actualízala a la nueva versión, en este caso a la 6.9
Tested up to: 6.9Con esto evitarás que WordPress muestre el aviso de «Plugin no probado en versión 6.9»
6.- (Opcional) Revisar tu plugin con Plugin Check
Para asegurar que tu plugin cumple con las directrices del repositorio de WordPress.org, puedes usar el plugin oficial de Plugin Check.
Este plugin analiza tu código y te avisa si encuentra:
- Malas prácticas
- Falta de sanitización/escape
- Funciones obsoletas
- Problemas de licencia
- Código no recomendado por WordPress.org
No es obligatorio, pero sí muy recomendado, especialmente antes de subir una actualización al repositorio.
7.- Sube los cambios al repositorio de WordPress.org
Una vez revisado y actualizado el plugin, sube los cambios mediante SVN. Aquí os dejo una guía de uso del SVN.
svn commit -m "Compatibilidad con WordPress 6.9 – actualizo Tested up to"(Opcional) Crear o actualizar una etiqueta estable:
svn cp trunk tags/1.2.0
svn commit -m "Versión 1.2.0 compatible con WordPress 6.9"A continuación vamos a verificar en WordPress.org en la página de tu plugin, debería mostrarse:
Tested up to: 6.9Preparar un plugin para una nueva versión de WordPress no tiene por qué ser complicado. Con una revisión rápida del Field Guide, unas pruebas básicas con WordPress Beta Tester y la actualización del readme.txt, puedes garantizar que tu plugin seguirá funcionando sin problemas.
Mantenerlo al día no solo evita incidencias tras una actualización mayor, sino que también transmite confianza a tus usuarios y demuestra un mantenimiento activo y profesional.