Subir plugin WordPress SVN es el paso clave para publicar (y actualizar) tu código en el directorio oficial de WordPress.org. Cuando tu solicitud de hosting es aprobada, recibes un correo parecido a este:
- SVN URL (repositorio):
https://plugins.svn.wordpress.org/TU-SLUG - Public URL (ficha del plugin):
https://wordpress.org/plugins/TU-SLUG - Tu usuario SVN es tu usuario de WordPress.org (es case sensitive).
- SVN no acepta tu correo como usuario.
- La propagación del directorio puede tardar (en el correo mencionan hasta 72 horas).
Preparación para subir un plugin a WordPress.org con SVN
Antes de tocar SVN, deja listo tu plugin con una estructura limpia. Lo mínimo recomendado es:
- Archivo principal del plugin (con header
Version:). readme.txtválido (conStable tagy changelog).- Carpetas típicas:
includes/,assets/(si aplica),languages/(si traduces).
En WordPress.org el repo SVN siempre se organiza así:
- trunk/: la versión en desarrollo / la que estás preparando.
- tags/X.Y.Z/: “snapshots” congelados de cada release.
- assets/ (en la raíz): banners, iconos y screenshots que se ven en la ficha del plugin.
Subir plugin WordPress SVN: flujo recomendado (trunk → tag)
- Checkout del repositorio con un cliente SVN (por ejemplo, TortoiseSVN). Usa la URL que te enviaron:
https://plugins.svn.wordpress.org/TU-SLUG. - Copia tu plugin dentro de trunk/ (sin crear una subcarpeta extra). Evita mover o borrar carpetas
.svn. - Actualiza versiones:
- En el header del plugin:
Version: X.Y.Z - En
readme.txt:Stable tag: X.Y.Zy agrega= X.Y.Z =al changelog
- En el header del plugin:
- Haz Commit de trunk/. Si ves archivos “non-versioned”, primero haz Add y luego commitea.
- Crea el tag
tags/X.Y.Zcopiando desde trunk (en TortoiseSVN es Branch/Tag…). - Si cambiaste banners/iconos, súbelos a assets/ (raíz) y haz commit aparte.
Tip para evitar el error más común
Si el tag ya existe (por ejemplo tags/1.0.5.4) y te equivocaste, lo más seguro es publicar una versión nueva (por ejemplo 1.0.5.5) y crear un tag nuevo. Editar tags viejos suele generar confusión.
Comandos SVN (opcional) para subir el plugin
Si prefieres línea de comandos, el flujo se reduce a:
svn checkout https://plugins.svn.wordpress.org/TU-SLUG
svn update
# Copia archivos a trunk/
svn add --force trunk/*
svn commit -m "Release X.Y.Z"
svn copy https://plugins.svn.wordpress.org/TU-SLUG/trunk \
https://plugins.svn.wordpress.org/TU-SLUG/tags/X.Y.Z \
-m "Tag X.Y.Z"
Solución de problemas y buenas prácticas
- La versión no cambia en la ficha del plugin: revisa que
Stable tagapunte al tag correcto y que el headerVersioncoincida. - Faltaron archivos: si quedaron como “non-versioned”, haz Add y un commit adicional, y luego taggea usando la revisión correcta.
- Tu plugin usa tareas programadas: si dependes de cron, revisa esta guía interna para mejorar estabilidad: deshabilitar WP-Cron en WordPress y usar un cron real.
- Documentación oficial: para profundizar, consulta la guía de Subversion del Developer Handbook de WordPress: How to use Subversion (SVN) on WordPress.org.
Con este flujo (trunk → commit → tag) tendrás releases ordenados, fáciles de auditar y compatibles con la forma en que WordPress.org distribuye actualizaciones.