Cómo enviar complementos al repositorio de WordPress.org

Publicado: 2021-06-02

Alojar un complemento en el repositorio de WordPress.org es una de las formas más populares (y efectivas) de iniciar un negocio freemium exitoso. Si es la primera vez que envía un complemento al repositorio, algunos de los pasos pueden ser poco claros o confusos, por lo que describí el proceso para guiarlo. También recomendaría marcar esta página como favorita si necesita hacer referencia a ella en el futuro.

Preparación para la presentación

En primer lugar, debe obtener la aprobación del equipo de revisión de complementos para alojar su producto en el repositorio. Para eso, necesitas tener una cuenta en WordPress.org. ¿No tienes uno? No te preocupes, puedes registrarte aquí.

Creación del archivo Readme.txt del complemento

A continuación, debe crear un archivo readme.txt con formato de descuento que se utilizará para la página de listado de su complemento en WordPress.org. Necesita contener la siguiente información:

Nombre del complemento
Colaboradores (su ID de usuario de WordPress.org)
Etiquetas de complementos
Requiere al menos (versión de WordPress)
Probado hasta (versión de WordPress)
Etiqueta estable (versión de complemento)
Licencia (GPLv2 o posterior)
URI de licencia: www.gnu.org/licenses/gpl-2.0.html
Descripción (descripción completa de su complemento)
preguntas frecuentes
capturas de pantalla
registro de cambios

Como referencia, aquí hay una plantilla de archivo readme.txt estándar.

Para asegurarse de haber formateado y estructurado correctamente el archivo readme.txt de su complemento, use el Validador de Léame de WordPress.

Elija el nombre de su complemento con cuidado

Es importante que se tome el tiempo para elegir el nombre del complemento "correcto" antes del envío inicial, ya que afectará la URL de la lista de su complemento, lo que afectará el SEO de su lista de WordPress.org y, finalmente, la exposición orgánica y el crecimiento del complemento.

Aquí está la sección relevante que cubre el impacto del nombre desde la página de envío del complemento:

La URL de su complemento se completará según el valor del Plugin Name en su archivo de complemento principal (el que tiene los encabezados del complemento). Si configura el suyo como Plugin Name: Boaty McBoatface , su URL será https://wordpress.org/plugins/boaty-mcboatface y su slug será boaty-mcboatface por ejemplo. Si existe un complemento con su nombre, será boaty-mcboatface-2 y así sucesivamente. Se comporta exactamente como los nombres de las publicaciones de WordPress.

Entonces, cuando elija el nombre inicial, piense en optimizarlo para SEO en lugar de la marca. Pregúntate a qué palabras clave te gustaría apuntar y extrapola el nombre. Puede encontrar algunos consejos de nombres aquí.

Recuerde, siempre puede cambiar el nombre del complemento después del envío inicial, por lo que incluso si elige un nombre que no le gusta, puede cambiarlo más adelante (y tantas veces como desee). Lo que no puede cambiar es el slug del complemento, por lo tanto, el nombre inicial es importante.

También tenga en cuenta que el slug se crea a partir del nombre del complemento en su archivo de complemento principal, que puede ser diferente del valor del nombre del complemento en el archivo readme.txt.

Envío de su complemento

Una vez que elija un buen nombre de SEO, y su complemento y el archivo readme.txt estén listos, diríjase a la página Agregar su complemento y envíelo para su revisión.

El proceso de revisión es manual y puede demorar entre 1 y 10 días, según la cola de revisión y la complejidad de su complemento. Si se encuentran problemas, recibirá un correo electrónico detallando dichos problemas y cómo puede solucionarlos.

Una vez que se hayan resuelto los problemas (si los hay), recibirá la aprobación por correo electrónico. Su complemento no es público en este momento, pero aún puede cargar, editar y eliminar archivos a través de la línea de comando o un cliente SVN.

Sugerencia: para asegurarse de no perderse los correos electrónicos importantes, le recomiendo incluir en la lista blanca [email protected] , la dirección de correo electrónico que utiliza el equipo de revisión de complementos de WordPress.org para comunicarse con los desarrolladores de complementos.

Subiendo el complemento

Ahora que se le otorgó acceso al repositorio de SVN, el siguiente paso es cargar su complemento en el repositorio de WordPress.org. Antes de hacerlo, le recomendamos que se familiarice con los conceptos básicos del uso de Subversion con WordPress.

Voy con la interfaz de línea de comandos para este tutorial. Si no le gusta y prefiere trabajar con un cliente visual, considere TortoiseSVN para Windows y Cornerstone para Mac.

Antes de que pueda cargar los archivos del complemento en el repositorio de SVN, debe crear una carpeta local donde se almacenarán los archivos y los activos. Este comando creará un directorio local:

$ mkdir my-awesome-plugin

Para mantener la coherencia, es una buena práctica nombrar la carpeta y el archivo PHP principal del complemento de acuerdo con el slug que se le asignó después del envío inicial. En este ejemplo, asumo que el nombre de su complemento es My Awesome Plugin y su slug aprobado es my-awesome-plugin .

Ahora, para ver y descargar el repositorio precompilado:

$ svn checkout https://plugins.svn.wordpress.org/my-awesome-plugin local/path/to/my-awesome-plugin

Esto dará el siguiente retorno:

A my-awesome-plugin/branches
A my-awesome-plugin/tags
A my-awesome-plugin/trunk
Checked out revision #####

Aquí, A significa que los directorios se agregaron a la carpeta local desde el repositorio central. A continuación, debe copiar los archivos y carpetas de su complemento en la carpeta trunk :

$ rsync -r local/path/to/wordpress/wp-includes/plugins/my-awesome-plugin/* local/path/to/my-awesome-plugin/trunk

Y añádelos al repositorio.

$ svn add trunk/*

A cambio, se le pedirá que se autentique. Una vez que haya iniciado sesión, obtendrá una respuesta similar a esta:

A trunk/my-awesome-plugin.php
A trunk/readme.txt

Importante: WordPress.org trata la carpeta trunk como la carpeta de nivel superior de su complemento. Por lo tanto, no copie toda la carpeta del complemento tal como está, el trunk solo debe incluir el contenido del complemento.

Evita esto: trunk/my-awesome-plugin/my-awesome-plugin.php

Después de agregar todos los archivos, vuelva a enviar los cambios al repositorio central:

$ svn commit -m 'My first plugin version'

Esto devolverá la siguiente respuesta:

Adding trunk/my-awesome-plugin.php
Adding trunk/readme.txt
Transmitting file data.
Committed revision 9999999.

Para cargar un ícono de complemento, un banner y capturas de pantalla, puede crear una nueva carpeta de activos dentro de su repositorio local SVN:

$ mkdir local/path/to/my-awesome-plugin/assets

Puede aprender cómo funcionan los activos del complemento aquí.

Una vez que tenga sus activos listos, agregue los activos del complemento al repositorio SVN:

$ svn add assets/*

Vuelva a confirmar los cambios:

$ svn commit -m 'Assets upload'

¡Eso es todo! Su complemento ya está disponible para descargar y puede comenzar a promocionarlo.

Publicación de una nueva versión

Para la próxima versión de actualización de su complemento, los pasos son ligeramente diferentes. Antes de publicar la nueva versión, actualice el campo Stable Tag en el trunk/readme.txt file y el número de versión en el comentario del encabezado del complemento. Una vez que tenga listos los archivos de complemento, cópielos en una subcarpeta de /tags y establezca el nombre de la subcarpeta en la nueva versión, como 1.0.1 .

$ svn copy trunk tags/1.0.1

  A tags/1.0.1

Confirme los cambios.

$ svn commit -m 'Version 1.0.1 release'

  Adding tags/1.0.1
  Adding tags/1.0.1/my-awesome-plugin.php
  Adding tags/1.0.1/readme.txt
  Committed revision 999999.

¡Y así, la nueva versión de su complemento está lista!

Sugerencias para la gestión de versiones

Es posible que note algún retraso desde el momento de lanzar una nueva versión y cuando esté disponible para su descarga en la página de lista de complementos de WordPress.org. Espere unas horas y, si aún no lo ve, puede enviar un correo electrónico a [email protected] ya que el sistema tiene problemas de vez en cuando.
Como regla general, para reducir los problemas de sincronización, se recomienda que la versión del complemento en su carpeta trunk sea idéntica a la versión del complemento en su última versión en la carpeta de tags .

¿Que sigue?

Por naturaleza, los desarrolladores de complementos gratuitos están motivados y apasionados por contribuir con cosas que son útiles para el mundo. Sobre todo, queremos que nuestros productos resuelvan problemas específicos que las personas puedan tener. Pero independientemente de cuán bueno sea su complemento, no será de mucha ayuda si las personas no pueden encontrarlo.

Un buen siguiente paso para mejorar la visibilidad de su complemento gratuito es optimizar el archivo readme.txt para SEO, que es algo que exploramos aquí.

Si está pensando en ganar dinero con su complemento, no es suficiente tener su producto en línea de forma gratuita: ¡quiere que las personas lo descubran, lo usen, lo amen y (con suerte) actualicen a su versión paga! Hoy en día, un desarrollador de WordPress usa muchos sombreros, desde creador de productos hasta propietario de un negocio y comercializador, y para que las personas adecuadas vean su complemento, necesita desarrollar y refinar sus habilidades de marketing.

Este es un tema que exploramos en profundidad con nuestro Manual de marketing para creadores de productos de WordPress. También recomiendo consultar la siguiente hoja de trucos para vender complementos y temas de WordPress: es una hoja de ruta práctica y concisa para crear un negocio exitoso de WordPress, desde la idea hasta el lanzamiento y el crecimiento.

Obtenga una copia gratuita de nuestro

Hoja de trucos para vender temas y complementos

Una hoja de ruta de crecimiento con consejos prácticos y concisos para cada hito del desarrollo de productos de WordPress.

¡Gracias por suscribirte!

- acabamos de enviar su copia de 'Hoja de trucos para vender temas y complementos' a .

¿Tienes un error tipográfico en tu correo electrónico? haga clic aquí para editar la dirección de correo electrónico y enviar de nuevo.

¿Está planeando enviar un complemento al repositorio de WordPress.org? ¿Estás pensando en utilizar el modelo de negocio freemium? ¡Apague el sonido abajo en los comentarios!