Unlimited WordPress themes, graphics, videos & courses! Unlimited asset downloads! From $16.50/m
Advertisement
  1. Code
  2. Plugins
Code

Cómo Publicar en el Repositorio de Plugins de WordPress

by
Length:ShortLanguages:

Spanish (Español) translation by CYC (you can also view the original English article)

Una de las consideraciones que todos los programadores de plugins WordPress deben hacer es cómo publicar su trabajo. Muchos de los plugins premium optan por alojarlo en su propia web, documentación y pasarela de compra, pero si quieres publicar un plugin libre o quizás una pequeña versión de un plugin premium, entonces una buena opción es utilizar el repositorio de plugins de WordPress.

WordPress.org ofrece control de código fuente, seguimiento de estadísticas, y notifica automáticamente a los usuarios de todas las actualizaciones de forma gratuita. No hace mal que el sitio tenga un ranking sólido con los motores de búsqueda, ¡ya sea especialmente porque tu plugin puede beneficiarse!

En este artículo, veremos cómo configurar un repositorio de plugins de WordPress y mantener tu proyecto a lo largo de su ciclo de vida de desarrollo. Ten en cuenta que este artículo supone que tiene familiaridad básica con Subversion.


Paso 1: Solicitar acceso

Antes de solicitar acceso para tu proyecto, necesitas tener una cuenta en WordPress.org. Son gratuitas y fáciles de configurar.

En primer lugar, ve a esta página y proporciona la información solicitada. Una vez que tu cuenta está configurada y confirmada, puedes configurar el repositorio. Ve al Centro de desarrolladores de WordPress. Desde la página principal de WordPress.org, haz clic en Extensiones y Plugins. Después, haz clic en "Agregar tu Plugin:"

En la siguiente pantalla, se te pedirá que ingreses el nombre del plugin, una breve descripción y la URL de la página principal del proyecto. Esto no tiene que ser profundo, pero aquí hay algunos consejos que te servirán en la solicitud de acceso:

  • Asegúrate de que el nombre del plugin es definitivo. Una vez que tengas acceso al repositorio, no podrás cambiar el nombre. También, piensa estratégicamente a la hora de nombrar el plugin. Para obtener los mejores resultados, a menudo es mejor nombrar el plugin de manera simple y que esté relacionado con lo que los usuarios buscarán en un motor de búsqueda.
  • No gastes mucho tiempo en la redacción de una descripción de tu plugin en este momento. Ve al grano, una frase estará muy bien. El archivo README para el plugin proporcionará más detalles una vez que hayas iniciado el proyecto.
  • La dirección URL de la página principal del plugin no tiene que ser necesariamente válida, pero asegúrate de que cualquier URL que especifiques sea la página principal del plugin en realidad.

Una vez que hayas proporcionado la información, envía la solicitud. Recibirás las credenciales del repositorio en tu correo electrónico normalmente entre 24 y 48 horas después de las cuales podrás realizar tu primer 'commit'.


Paso 2: Configuración del repositorio

Después de haber recibido la URL del repositorio, puedes realizar la comprobación inicial. Usando tu cliente de subversión favorito (estoy usando TortoiseSVN en este tutorial), realiza una comprobación usando la URL del repositorio:

Esto creará un directorio con el nombre del complemento que especificaste en el primer paso de este tutorial. También inicializará: branches, tags y directorios trunk.

Una nota rápida sobre la estructura de directorios:

  • El 'trunk' del repositorio es tu directorio de trabajo. Este es el directorio en el que realiza todo tu desarrollo principal.
  • Las etiquetas (tags) son versiones o instantáneas del 'trunk' en puntos específicos de tu ciclo de desarrollo. Muchas veces, puedes marcar el 'trunk' cada vez que desees realizar un lanzamiento.
  • El directorio de la rama (branch) es una copia del 'trunk' en un cierto punto en el tiempo que se utiliza para el desarrollo difícil. Si vas a hacer un gran desarrollo, lo mejor es la rama - de esta manera, se conserva la calidad del 'trunk'.

Puedes leer mucho más sobre la estructura del directorio de subversión aquí.


Paso 4: Encomendar cambios

En este punto, puedes empezar a trabajar fuera del repositorio. Si es la primera vez que trabajas con él, el directorio 'trunk' debe estar vacío. Si has estado trabajando en tu plugin antes de inicializar el directorio, entonces continúa y copia los archivos en el directorio 'trunk' ahora. De lo contrario, siéntete libre de comenzar a trabajar en tu plugin.

Una vez que hayas terminado de copiar o hayas comenzado a trabajar en el plugin, tendrás que agregar los archivos al control de código fuente. Para ello, ejecuta el comando add:

Esto instruirá subversion para comenzar a rastrear estos archivos. A continuación, ejecuta el comando commit:

Este paso realmente enviará la base del código del plugin al repositorio de plugins de WordPress.

Por supuesto, todavía no has publicado tu plugin hasta que lo etiquetes. Antes de hacerlo, asegúrate de que has configurado correctamente el encabezado de tu plugin y es el archivo README. También puedes leer más sobre esto en la serie Escribiendo Widgets Mantenibles para WordPress.


Paso 3: Etiquetado y Lanzamiento

Suponiendo que has completado una versión funcional de tu plugin y le has configurado el encabezado y README, es hora de lanzar una versión. Para ello, ejecuta el comando Branch/Tag [TODO] en el directorio trunk.

Antes de hacerlo, asegúrate de actualizar la etiqueta de la versión en el encabezado del plugin:

Y actualiza también la etiqueta estable del README:

A continuación, confirma los cambios en el trunk.

Después de eso, estás listo para etiquetar:

Al hacerlo, Subversion te preguntará en qué directorio deseas etiquetar la versión. Es muy importante asegurarse de actualizar la ruta del complemento a la ruta de las etiquetas. La mayoría de los clientes de Subversion llenarán el destino con la dirección del trunk. Esto es incorrecto - en su lugar, querrás cambiar la ruta a /tags/1.0 (pero si estás etiquetando 1.5 o 2.0, entonces cambia el número):

En este momento, tu plugin se ha comprobado en el control de código fuente y se ha etiquetado como una versión específica. Dentro de 20 minutos, tu plugin debe aparecer en el repositorio de Plugins de WordPress en la URL que especificaste al solicitar el repositorio.

En versiones futuras, comprueba que el plugin funciona igual que en los pasos anteriores. Con el tiempo, podrás seguir desarrollando el plugin y seguir las estadísticas de descarga desde la página del proyecto.


Conclusión

¡Eso es todo! Esperemos que por ahora tengas una buena comprensión de lo que se necesita para publicar formalmente tu plugin a través del repositorio de plugins de WordPress. Recientemente hemos estudiado cómo empezar a crear plugins... así que deberías tener una base sólida para salir y empezar a crear tus propios plugins personalizados. Lo bueno de todo esto es que esto ayuda a contribuir a la ya sobresaliente plataforma que es WordPress. Los desarrolladores y diseñadores más talentosos podemos salir de allí creando complementos útiles, ¡y mejor será la plataforma!

Recursos adicionales

Si estás interesado en aprender más sobre el desarrollo de plugins para WordPress, entonces consulta nuestros servicios de plugins para WordPress en el Estudio de Envato para obtener más recursos y educación sobre el tema.

Advertisement
Advertisement
Looking for something to help kick start your next project?
Envato Market has a range of items for sale to help get you started.