OptimoCMS Docs
Volver al resumen

Marketplace

Descubre, instala y publica packages reutilizables para tus sitios web.

¿Qué es el Marketplace?

El Marketplace es un ecosistema abierto donde agencias y desarrolladores publican, comparten y venden componentes reutilizables. Un package es un bloque listo para usar (hero, tabla de precios, pie de página, etc.) que añades a tu sitio con un clic. Categorías: • Layout – Diseños y estructuras de página • Content – Bloques de contenido listos para usar • Interaction – Elementos interactivos (formularios, sliders) • Social Proof – Testimonios, reseñas, valoraciones • Notification – Banners, popups, alertas • Navigation – Menús, migas de pan, pies de página • Global – Otros packages Modelos de precio: • Gratis – Instalación libre • Único – Pago único, acceso permanente • Suscripción – Pago mensual por actualizaciones y soporte Roles: solo los administradores (Admin) pueden instalar y publicar packages.

Buscar e instalar packages

Paso a paso: 1. Ve a Marketplace en el menú principal 2. Usa la barra de búsqueda para buscar por nombre o palabra clave 3. Filtra por categoría (Layout, Content, etc.) o precio (gratis, único, suscripción) 4. Haz clic en un package para abrir la página de detalle 5. Revisa la descripción, capturas de pantalla, reseñas y precio 6. Haz clic en "Instalar" (gratis) o "Comprar e instalar" (de pago) 7. Elige el sitio donde quieres instalar el package 8. El package aparece inmediatamente en tu selector de bloques en el editor de páginas
Consejos
  • Empieza con packages gratuitos para conocer el Marketplace.
  • Lee las reseñas de otros usuarios antes de comprar un package de pago.
  • Puedes ver los packages instalados en Marketplace → Mis instalaciones.

Comprar packages de pago

Para packages de pago el proceso es: 1. Haz clic en "Comprar e instalar" en la página de detalle 2. Serás redirigido a Stripe Checkout 3. Introduce tus datos de pago y confirma 4. Después del pago exitoso serás redirigido al CMS 5. El package se instala automáticamente en el sitio elegido Estado de licencia: • 🟢 Licencia activa – El package funciona completamente • 🔴 Licencia expirada – Para suscripciones canceladas Con un pago único tienes acceso permanente. Con una suscripción el package funciona mientras tu suscripción esté activa.
Nota
  • Revisa las condiciones de precio antes de suscribirte.
  • Al cancelar una suscripción el package permanece instalado pero muestra una insignia de 'licencia expirada'.

Publicar un package: Preparación

Para publicar un package necesitas: • Un bundle JavaScript (.js) – Tu componente como módulo ESM (máx. 500KB) • Opcional: un archivo CSS (.css) – Estilos adicionales para tu componente • Imágenes de vista previa – Mínimo 1, máximo 5 capturas de pantalla El bundle JS debe exportar un componente page builder válido. Usa tu bundler favorito (Vite, Rollup, esbuild) para empaquetar tu componente React como ESM. Requisitos del manifiesto: • Nombre: @scope/nombre-del-package (ej. @miagencia/hero-premium) • Versión: formato semver (ej. 1.0.0) • Nombre visible: nombre legible (ej. "Sección Hero Premium") • Descripción: mínimo 10 caracteres • Categoría: elegir entre Layout, Content, Interaction, etc. • Sectores: para qué sectores es relevante (dentista, restaurante, etc.) • Licencia: free o commercial
Consejos
  • Mantén tu bundle lo más pequeño posible – máx. 500KB.
  • Prueba tu componente localmente en el editor de páginas antes de publicar.
  • Usa design tokens (--dt-*) para que tu componente se adapte al tema de cada sitio.

Publicar un package: Paso a paso

El asistente de publicación tiene 4 pasos: Paso 1 – Subir bundle: • Arrastra tu bundle .js al campo de carga (máx. 500KB) • Opcional: añade un archivo .css Paso 2 – Rellenar manifiesto: • Nombre (@scope/nombre-del-package) • Versión (1.0.0) • Nombre visible y descripción • Seleccionar categoría y sectores • Compatibilidad de versión del editor • Seleccionar dependencias de tokens • Elegir licencia (free/commercial) Paso 3 – Imágenes de vista previa: • Sube 1-5 capturas de pantalla de tu componente • Opcional: añade una URL de demostración Paso 4 – Revisar y publicar: • Revisa un resumen de todos los datos introducidos • Haz clic en "Publicar" para enviar tu package • Después de la revisión tu package será visible en el Marketplace
Consejos
  • Buenas capturas de pantalla aumentan la probabilidad de que otros instalen tu package.
  • Añade una URL de demostración para que los compradores potenciales vean tu componente en acción.

Establecer el precio de tu package

En el paso 2 del asistente de publicación estableces el precio: Gratis: • Selecciona "Gratis" como modelo de precio • Cualquiera puede instalar tu package directamente Único: • Selecciona "Único" como modelo de precio • Introduce el precio en euros (ej. 29 €) • Los compradores pagan una vez a través de Stripe Checkout • Se crea automáticamente un Stripe Product + Price Suscripción: • Selecciona "Suscripción" como modelo de precio • Introduce el precio mensual en euros (ej. 9 €/mes) • Los compradores pagan mensualmente a través de Stripe • Al cancelar, el comprador pierde acceso a las actualizaciones Puedes ver tus ingresos en Marketplace → Revenue Dashboard.
Consejos
  • Los packages gratuitos obtienen más instalaciones y ayudan a construir tu reputación.
  • Considera un precio único bajo para componentes premium.
  • Las suscripciones funcionan bien para packs de componentes que actualizas regularmente.

Gestionar y actualizar packages

Después de la publicación puedes gestionar tus packages: • Ver estadísticas de instalación y reseñas • Publicar una nueva versión con un número de versión superior • Ver tus ingresos en el Revenue Dashboard Publicar una nueva versión: 1. Ve a Marketplace → Publicar 2. Sube el nuevo bundle 3. Aumenta el número de versión (semver: 1.0.0 → 1.1.0 para funcionalidades, 1.0.1 para correcciones) 4. Rellena los datos restantes 5. Publica Los usuarios que ya instalaron tu package verán una notificación de actualización.
Consejos
  • Usa versionado semántico: major.minor.patch (ej. 2.0.0 para cambios importantes).
  • Responde a las reseñas para mejorar tu reputación.

Preguntas frecuentes (FAQ)

¿Qué tamaño puede tener mi bundle? → Máximo 500KB. Mantén tu bundle lo más pequeño posible para tiempos de carga rápidos. ¿Qué es semver? → Versionado semántico: major.minor.patch (ej. 1.2.3). Major = cambios importantes, minor = nuevas funcionalidades, patch = correcciones. ¿Qué licencias están disponibles? → 'free' (uso gratuito) y 'commercial' (de pago, licencia requerida). ¿Cómo recibo mis pagos de Stripe? → Los ingresos se procesan a través de Stripe. Puedes ver tus pagos en tu Stripe Dashboard. ¿Puedo desinstalar un package? → Sí, ve a Marketplace → Mis instalaciones y haz clic en "Desinstalar". El package se elimina de tu sitio. ¿Qué pasa si cancelo mi suscripción? → El package permanece instalado pero muestra una insignia de 'licencia expirada'. Ya no recibes actualizaciones. ¿Puedo eliminar mi package del Marketplace? → Contacta con soporte. Las instalaciones existentes siguen funcionando. ¿Qué sectores puedo seleccionar? → Dentista, Restaurante, Inmobiliaria, Abogado, Fitness, E-commerce, Fotografía, Freelancer, ONG, Startup, Educación, Salud y más.

Llámanos