[DISCUSSION] What are best ways to promote your custom plugin published on wordpress.org? - ilustracion

Cómo promocionar plugin WordPress y rankear en 2026

Si querés promocionar tu plugin en WordPress.org y que no quede sepultado entre más de 60.000, el nombre es tu principal activo. Según la documentación de WordPress.org de 2026, el algoritmo de ElasticSearch sigue ponderando el nombre del plugin como el factor con mayor peso en el ranking, seguido por la short description y la velocidad de descargas recientes — no el total acumulado. Sin estas bases, la difusión externa que hagas va a empujar un carro sin ruedas.

Promocionar un plugin en WordPress.org es el proceso de posicionar un plugin gratuito dentro del directorio oficial para que aparezca entre los primeros resultados cuando un usuario busca una solución. Combinás optimización del readme.txt —el archivo que WordPress.org indexa íntegro con ElasticSearch—, elección estratégica del nombre, generación de descargas y reseñas activas, y difusión en comunidades y blogs especializados. No es «subilo y esperá»: requiere acciones concretas desde antes del día uno.

En 30 segundos

  • El nombre del plugin pesa más que cualquier otra cosa en el algoritmo de búsqueda de WordPress.org. Si es genérico o ya existe en 2.000 resultados, no te encuentra nadie.
  • La short description (150 caracteres) y el readme completo se indexan. Si no incluiste la keyword principal ahí, básicamente estás regalando posiciones.
  • Las descargas recientes le ganan al total histórico. Un plugin con 500 descargas activas y 5 estrellas puede superar a uno con 10.000 descargas acumuladas y readme genérico.
  • El proceso de aprobación toma entre 2 semanas y 1 mes. El equipo revisor procesa ~700 envíos semanales, así que cada error en el código te retrasa días.
  • Sin tracción externa, no hay algoritmo que te salve. Comunidades, blogs y cross-promotion son el empujón inicial que activa las descargas que el algoritmo premia.

WordPress es un sistema de gestión de contenidos de código abierto, creado por Matt Mullenweg y Mike Little, y desarrollado por la comunidad WordPress. Permite crear y administrar sitios web, desde blogs hasta aplicaciones complejas.

¿Qué peso tiene el nombre del plugin en el ranking de WordPress.org?

Es el factor con mayor peso. Así de simple. Cuando un usuario busca «SEO» en el directorio, el algoritmo de ElasticSearch de WordPress.org compara el término contra los nombres de los plugins primero, y ahí define gran parte del orden. Si tu plugin se llama simplemente «SEO», competís contra más de 2.000 resultados — es como abrir un local llamado «Comida» en pleno centro y esperar que la gente entre por el cartel.

La recomendación, según datos recopilados por especialistas en el ecosistema, es usar entre 2 y 5 palabras que describan el problema y la solución. Algo como «Optimizador de Imágenes WebP» o «Programador de Respaldos Automáticos» le da a ElasticSearch contexto suficiente y al usuario le queda claro qué hace en dos segundos. Antes de decidirte, buscá el nombre en Google junto a la palabra «WordPress»: si ya existen varios resultados idénticos, volvé a pensarlo.

Ojo: si tu plugin resuelve algo para WooCommerce pero no es una extensión oficial, no uses «WooCommerce» en el nombre. Las guías de marca de WordPress.org son estrictas con esto y el equipo revisor te lo va a rebotar — con razón, porque confunde al usuario y roza la suplantación de identidad. En aprender sobre la comunidad de WordPress profundizamos sobre esto.

¿Cómo optimizar el readme.txt para aparecer en los primeros resultados?

promocionar plugin wordpress diagrama explicativo

El readme.txt no es un trámite administrativo — es tu página de venta, tu ficha técnica y tu único control directo sobre qué indexa ElasticSearch. WordPress.org se come todo el contenido de ese archivo: título, descripción corta, descripción larga, FAQ, changelog, captions de screenshots. Cada palabra que ponés (o que no ponés) define si aparecés en la búsqueda o no.

Los puntos clave, según la charla de David Pérez sobre preparación de plugins para WordPress.org:

  • Short description (150 caracteres): tiene que contener tu keyword principal sí o sí. Es lo primero que lee el algoritmo y lo primero que ve el usuario. Si tu plugin programa respaldos automáticos, que la short description arranque con «Programa respaldos automáticos de tu WordPress y…». Sin rodeos.
  • Descripción larga: cubrí variantes de keywords, casos de uso reales y todas las integraciones que soporta. No repitas la short description — expandila. Si tu plugin se integra con Google Drive, Dropbox y Amazon S3, que esas palabras estén en la descripción larga porque alguien va a buscar justamente «backup a Google Drive».
  • FAQ: las preguntas frecuentes capturan búsquedas tipo pregunta que el usuario hace en Google y que ElasticSearch también indexa. «¿Cómo restauro un backup?» o «¿Funciona con multisitio?» no son solo ayuda al usuario — son keywords de cola larga que te traen tráfico.
  • Screenshots (captions): los captions de las imágenes se indexan. Si los dejás en blanco, estás desperdiciando texto indexable que además ayuda al usuario a entender la interfaz antes de instalar.

La pregunta es: ¿estás usando el readme para describir qué hace el plugin o para anticipar qué va a buscar el usuario? La segunda es la que rankea.

¿Qué rol juegan las descargas recientes y las reseñas en el posicionamiento?

El algoritmo de WordPress.org pondera la velocidad de descargas recientes por sobre el total histórico acumulado. Traducción: un plugin con 500 descargas en los últimos 30 días y 5 estrellas puede aparecer arriba de uno con 10.000 descargas totales que viene planchado hace meses y tiene un readme genérico. Esto es clave porque significa que un plugin nuevo sí puede competir — siempre que logre tracción inicial real.

Las reseñas son la señal de confianza que cierra el círculo. Rating (estrellas) y cantidad de reviews le dicen al algoritmo «este plugin no solo se descarga, sino que la gente lo usa y le gusta». A eso sumale la compatibilidad declarada con la versión actual de WordPress (en 2026, la 6.6 y 6.7) y la actividad de soporte en los foros: un plugin con hilos de soporte sin respuesta es una bandera roja para el algoritmo y para el usuario. Sobre eso hablamos en crear una landing page optimizada.

¿Cómo generar tracción inicial para un plugin nuevo?

Acá es donde la teoría choca con la realidad: podés tener el mejor readme del mundo, pero si nadie descarga tu plugin, el algoritmo no tiene velocidad reciente que premiar. La tracción inicial es el oxígeno que enciende el motor. Y no — no alcanza con tuitear el link dos veces.

Estrategias que funcionan, extraídas de casos documentados en la comunidad:

  • Pre-lanzamiento en comunidades: grupos de Facebook de WordPress en español, subreddits como r/WordPress o r/ProWordPress, y el Slack de Make WordPress (canal #pluginreview). La idea es mostrar el plugin antes de publicarlo, recibir feedback real y sumar los primeros interesados que lo instalen el día del lanzamiento.
  • Cross-promotion con otros plugins o herramientas: si tu plugin hace algo complementario a otro plugin popular, contactá al autor y proponé una mención colaborativa. No es raro que plugins chicos crezcan así — el ecosistema WordPress tiene culture de colaboración, no de competencia a muerte.
  • Cobertura en blogs especializados: WPBeginner, WPTavern y blogs locales como AyudaWP reciben pitches de plugins nuevos todo el tiempo. Si tu plugin resuelve un problema concreto y tenés un pitch claro (qué hace, para quién, por qué es distinto), tenés buenas chances de que lo cubran.

El punto es que la tracción tiene que ser activa: descargas reales de usuarios reales en semanas recientes. Una oleada de descargas históricas de hace dos años no mueve la aguja del algoritmo.

¿Qué acciones de marketing gratuitas puedo hacer desde el día uno?

No necesitás presupuesto para arrancar. Necesitás constancia. Estas acciones, documentadas por desarrolladores que ya pasaron por el proceso, son 100% gratuitas y las podés ejecutar desde el minuto cero:

  • Perfiles sociales con enlace directo a WordPress.org: si tenés Twitter/X, LinkedIn o Mastodon, actualizá la bio con el link al plugin. No lo pongas en un linktree — ponelo directo para que el algoritmo de cada red no opaque el destino.
  • Artículo en tu blog explicando cómo usarlo: una entrada detallada con capturas, casos de uso y un tutorial paso a paso no solo ayuda al SEO de tu sitio — también es contenido indexable que Google asocia al plugin. Si no tenés blog, un hosting WordPress como el de Donweb te da el entorno para montarlo en una tarde sin renegar con la configuración.
  • Responder en foros cuando alguien pregunta por una solución que tu plugin ofrece: sin spam, sin copy-paste genérico. Si alguien en los foros de soporte de WordPress.org pregunta «¿cómo hago para X?» y tu plugin resuelve X, respondé con la solución y mencioná que desarrollaste una herramienta que automatiza justamente eso. Aportás valor y dejás la puerta abierta.
  • Contactar sitios de listados de plugins: hay decenas de sitios que curan listas como «mejores plugins de backup para WordPress». Escribiles un mail corto diciendo qué hace tu plugin y por qué merece estar en la lista.
  • Pedir reseñas a usuarios satisfechos: después de que alguien usa tu plugin y te da feedback positivo, pedile una reseña en WordPress.org. La mayoría no lo hace por iniciativa propia, pero si se lo recordás con un link directo, muchos acceden.

¿Cuáles son los errores más comunes al presentar un plugin y cómo evitarlos?

Después de revisar cientos de envíos, los revisores del Plugins Team —y cualquiera que haya submitido un plugin— reconocen estos patrones. Evitalos y ahorrate ciclos de reenvío (y frustración): Cubrimos ese tema en detalle en utilizar un entorno de staging.

  • Nombres que parecen integración oficial sin serlo: ya lo mencioné antes. Usar «WooCommerce», «Yoast» o «Elementor» en el nombre de tu plugin cuando no tenés relación con esas marcas es garantía de rechazo. El equipo revisor es estricto con la política de marcas de WordPress.org.
  • Nombres genéricos que hacen imposible encontrar el plugin: «SEO», «Security», «Backup» a secas. Sí, describen la categoría — pero hay 2.000 plugins con ese nombre aproximado y el tuyo va a ser el número 2.001 que nadie scrollea hasta encontrar.
  • Descripciones que no explican en 5 segundos qué hace el plugin: frases como «solución integral para optimizar tu flujo de trabajo» no le dicen nada a nadie. El usuario (y el revisor) necesita saber en una línea qué problema resolvés. Si no podés explicarlo en una oración, el plugin probablemente tenga un problema de scope.
  • Falta de icono y banners atractivos: el icono es lo primero que ve el usuario en los resultados de búsqueda. Un icono genérico o inexistente grita «esto lo subí un domingo a las 3 AM y nunca más lo toqué». Los banners (772×250 y 1544×500 píxeles) son opcionales pero casi obligatorios si querés que tu página de plugin luzca profesional.
  • Menos de 3 capturas de pantalla: las capturas son la demostración visual de que el plugin existe y funciona. Sin screenshots, el usuario no tiene forma de saber si la interfaz es usable o si siquiera tiene interfaz. Tres es el mínimo.

¿Cómo funciona el proceso de revisión y aprobación en WordPress.org?

El Plugins Team revisa aproximadamente 700 envíos por semana, gestiona 2.000 revisiones y responde 4.000 correos en el mismo período. Son voluntarios (en su mayoría) revisando código, licencias, nombres de marca y buenas prácticas. No es un bot que aprueba automáticamente — hay un humano (o varios) del otro lado.

El flujo es así: subís el plugin, un revisor lo toma, lo analiza contra los lineamientos detallados del directorio, y te devuelve un informe con correcciones. Vos corregís y reenviás. Este ciclo se repite hasta que el plugin está ok. La primera revisión suele tardar unos 5 días; la aprobación total, entre 2 semanas y 1 mes según la carga del equipo y la cantidad de correcciones necesarias.

Para reducir la fricción, usá Plugin Check (PCP), la herramienta oficial que corre checks automáticos antes de enviar. Sumale PHPCS con WordPress Coding Standards para asegurar que tu código cumple las convenciones. Y si tenés dudas de estilo, la WordPress Coding Standards AI Skill —disponible desde este año— te ayuda a validar fragmentos contra el estándar sin tener que memorizarlo. Acordate también de revisar el checklist de seguridad básico de nuestro blog hermano antes de submitir — aunque no reemplaza la revisión del equipo, te ahorra correcciones evitables.

Preguntas Frecuentes

¿Cómo consigo las primeras instalaciones de un plugin?

Con tracción externa antes y durante el lanzamiento. Publicá el plugin en comunidades de WordPress (grupos de Facebook, Slack de Make WordPress, subreddits), contactá blogs especializados como WPBeginner o AyudaWP, y usá tus perfiles sociales con enlace directo al directorio. Las primeras 100-200 descargas activas en semanas recientes le dan al algoritmo la señal de velocidad que necesita para empezar a rankearte.

¿Qué factores usa WordPress para ordenar los plugins en la búsqueda?

ElasticSearch pondera principalmente: nombre del plugin (mayor peso), coincidencia en la short description y descripción larga del readme.txt, velocidad de descargas recientes, rating y cantidad de reseñas, compatibilidad con la versión actual de WordPress, y actividad de soporte en foros. El total de descargas históricas acumuladas pesa menos que la velocidad reciente.

¿Cómo escribo el readme.txt para que mi plugin rankee?

La short description (150 caracteres) debe incluir la keyword principal y describir exactamente qué hace el plugin. La descripción larga tiene que cubrir variantes de keywords, casos de uso e integraciones. Las FAQ capturan búsquedas tipo pregunta, y los captions de los screenshots se indexan — no los dejes en blanco. ElasticSearch indexa todo el contenido del readme, así que cada palabra cuenta. Lo explicamos a fondo en arreglar enlaces rotos fácilmente.

¿Cómo armo el nombre de un plugin para que sea encontrado?

Usá entre 2 y 5 palabras que describan el problema y la solución. Evitá nombres genéricos como «SEO» o «Security» a secas — hay miles de resultados con esos términos. Antes de definir el nombre, buscá en Google «nombre propuesto + WordPress» para verificar que no esté saturado. Si el plugin no tiene relación oficial con una marca (WooCommerce, Elementor, Yoast), no uses esa marca en el nombre.

¿Cuánto tarda la aprobación de un plugin en WordPress.org?

La primera revisión suele llegar en unos 5 días hábiles. La aprobación total toma entre 2 semanas y 1 mes, según la carga del Plugins Team (que procesa ~700 envíos semanales) y la cantidad de correcciones que necesite tu código. Usar Plugin Check (PCP) y PHPCS con WPCS antes de enviar acorta el ciclo significativamente.

Conclusión

Promocionar un plugin en WordPress.org en 2026 no va de ser el que más descargas acumuló en cinco años — va de ser el que mejor entendió cómo funciona ElasticSearch y cómo generar tracción reciente sostenida. El nombre, el readme.txt y las primeras descargas activas son la trifecta que define si tu plugin aparece en los primeros resultados o en la página 15.

Si estás empezando, hacé esto: pulí el nombre y el readme antes de submitir, pasá el Plugin Check, movete en comunidades durante el lanzamiento, y no dejes pasar la primera semana sin capitalizar cada instalación pidiendo reseña. Lo demás —las descargas acumuladas, la reputación— se construye solo si la base está sólida.

Fuentes

Volver a

Novedades

Publicaciones relacionadas