El ecosistema de plugins funciona mejor cuando cualquier desarrollador entiende que debe construir, como documentar y que revisar antes de publicar. Esta guia te lleva desde la idea hasta la publicacion final dentro del marketplace.
1. Define el problema real que resolvera el plugin
Antes de escribir codigo, responde tres preguntas: que problema resuelve, para quien sirve y en que parte del sitio actuara. Un buen plugin no empieza con un efecto visual, empieza con una necesidad concreta.
- Describe el caso de uso en una sola frase.
- Define si el plugin afecta layout global, contenido, conversion o integraciones.
- Evita crear plugins genericos que hagan muchas cosas a la vez.
2. Crea el plugin desde el panel admin
Entra a Portal Admin > Plugins y crea un nuevo plugin. Ese formulario ahora funciona como un manifiesto publico, por lo que conviene completarlo con criterio desde el principio.
- Nombre: claro y entendible.
- Slug: corto, estable y en minusculas.
- Autor visible: equipo o desarrollador responsable.
- Version: usa versionado semantico como 1.0.0.
- Categoria y tags: ayudan a descubrirlo luego en el marketplace.
3. Completa la ficha publica como si fueras una tienda de plugins
No basta con que el plugin funcione. La comunidad necesita confiar en el plugin antes de instalarlo. Para eso la ficha publica debe estar bien armada.
- Escribe una descripcion orientada a beneficios, no solo a tecnologia.
- Indica compatibilidad: por ejemplo Layout global o bloques de contenido.
- Define licencia y nivel de soporte.
- Agrega enlaces a documentacion, repositorio, demo y soporte si existen.
- Incluye notas de instalacion cuando haya dependencias o pasos previos.
4. Diseña bien el esquema de configuracion
El esquema de configuracion es el contrato entre tu plugin y quien lo instala. Cada campo debe tener nombre, tipo, valor por defecto y ayuda breve si hace falta.
Buenas practicas:
- Usa text para textos cortos.
- Usa textarea para mensajes largos.
- Usa select cuando el usuario no deba escribir libremente.
- Usa toggle para activaciones simples.
- Usa number con min, max y step cuando controles medidas o tiempos.
Si un plugin tiene demasiadas opciones, probablemente deberias dividirlo en mas de un plugin.
5. Construye el plugin por capas
En el editor de codigo separa claramente cada responsabilidad:
- template.html: markup que se inyecta.
- styles.css: estilos encapsulados y legibles.
- script.js: comportamiento y eventos.
- head.html: solo si realmente necesitas algo en el head.
Evita depender de clases globales fragiles o de selectores demasiado amplios. Mientras mas aislado sea el plugin, mas seguro sera publicarlo para terceros.
6. Usa variables de configuracion en vez de hardcodear valores
Cuando quieras insertar valores configurables, usa el patron {{config.campo}}. Eso permite que el plugin se adapte a distintos sitios sin tocar el codigo fuente en cada instalacion.
Ejemplos comunes:
- Colores del boton o del bloque.
- Textos visibles para el usuario.
- Selectores objetivo.
- Duraciones, offsets o thresholds.
7. Prueba el plugin en el preview antes de pensar en publicarlo
El editor visual y el preview sirven para validar comportamiento real, no solo para ver si el codigo compila.
- Verifica el render inicial.
- Prueba estados activos e inactivos.
- Confirma que el plugin aguanta cambios de configuracion.
- Revisa que no rompa la jerarquia visual del layout.
- Comprueba que la experiencia siga siendo razonable en mobile.
8. Instala el plugin en un sitio de prueba
Publicar sin instalar en un sitio real casi siempre termina en soporte correctivo. Antes de salir al marketplace, instala el plugin en una web de test desde Portal Cliente > Sitio web > Extensiones.
En ese entorno debes comprobar:
- Instalacion y desinstalacion sin residuos inesperados.
- Activacion y desactivacion sin errores visuales.
- Persistencia correcta de la configuracion.
- Convivencia con otros plugins o fuentes instaladas.
9. Publica solo cuando la ficha este completa
Un plugin no esta listo porque funciona. Esta listo cuando una tercera persona puede entenderlo, instalarlo y mantenerlo sin pedir contexto extra.
Checklist minimo antes de pasar a Publicado:
- Nombre, slug y autor visibles correctos.
- Descripcion publica clara.
- Categoria, tags y compatibilidad definidas.
- Licencia y nivel de soporte definidos.
- Documentacion o notas de instalacion disponibles.
- Prueba real en una web de ensayo.
10. Mantencion, versionado y soporte
Publicar un plugin no es el final. Desde ese momento existe una expectativa de mantenimiento. Si corriges un bug o agregas funciones, actualiza la version y deja registro de que cambio.
- Patch para correcciones pequenas.
- Minor para mejoras compatibles.
- Major si rompes compatibilidad o cambias el contrato.
Si el plugin es comunitario, el enlace de soporte y el repositorio son claves para que otras personas puedan colaborar o reportar problemas de forma ordenada.
11. Recomendaciones para plugins que la comunidad realmente quiera usar
- Manten una sola responsabilidad por plugin.
- Explica que gana el usuario final, no solo que hace el codigo.
- Incluye defaults sensatos para instalar y probar en segundos.
- No dependas de hacks visuales dificiles de mantener.
- Prefiere configuracion explicita por sobre magia oculta.
Un buen plugin no solo agrega una capacidad. Tambien reduce dudas, friccion y soporte al momento de instalarlo.
Si sigues este flujo, no solo tendras plugins funcionales. Tendras un marketplace que la comunidad puede entender, revisar y extender con mas confianza.