Digital Revolution: configuración y ayuda

Sube e instala el ZIP de Digital Revolution en Módulos > "Module Manager". Abre "Sell" > Productos digitales > "Settings" > Configuración.

Selecciona la tienda prevista. Comprueba Integridad y resuelve los avisos de actualización de base de datos antes de usar operaciones de licencias. El módulo añade las áreas "Catalog", "Licensing", Soporte, "Analytics" y "Settings" bajo Productos digitales.

Comprueba el panel Claves de firma antes de publicar una descarga. La instalación intenta aprovisionar las claves de firma, pero los fallos quedan visibles. Hasta que las claves sean utilizables, no se pueden activar licencias, descargar módulos protegidos ni producir las respuestas firmadas que necesita la API de licencias.

Usa un producto y un pedido de prueba antes de añadir el resto del catálogo. Los procesos PHP/CLI necesitan acceso a fuentes subidas, versiones preparadas y almacenamiento temporal de compilación. El empaquetado ZIP requiere ZipArchive; las operaciones criptográficas requieren las funciones usadas por los servicios de firma y cifrado.

Abre "Settings" > Configuración > General.

Ejemplos de patrones y direcciones internos:

@yourcompany.com,*.dev.example.com,staging.example.com

127.0.0.1
192.168.1.0/24
10.0.

Un correo o dominio introducido solo clasifica los informes. No autoriza a omitir cuotas de descarga, límites ni bloqueos. La comprobación de solicitudes internas de confianza usa una IP interna configurada.

Los interruptores de notificaciones por correo de demos para administradores y clientes no están disponibles en la configuración.

En Claves de firma, comprueba estado, ID de clave, huella y dirección del emisor. Los nuevos paquetes confían en el emisor y la identidad pública de firma de esta tienda.

Para una tienda nueva sin claves, usa "Set up signing keys". Exporta una copia cifrada con una contraseña y guárdala fuera de la tienda. "Download public key" proporciona la clave pública de firma de respuestas cuando está lista. "Import backup" restaura una identidad existente; las importaciones desde el navegador se limitan a 4 MB.

Si _MPR_DIGITAL_SIGNING_KEY_DIR_ está configurado, el operador del servidor gestiona las claves en esa carpeta. El panel muestra "Use the keys in the operator folder" cuando corresponde. Restaura la carpeta y los archivos configurados si ese backend deja de estar disponible.

Si la tienda ya ha emitido paquetes, restaura su copia de claves antes de considerar sustituirlas. Sustituirlas crea una nueva identidad; los módulos ya entregados pueden dejar de confiar en ella hasta que los clientes vuelvan a descargar. Revoca una clave anterior solo si quieres rechazar lo que firmó. El formulario exige confirmación explícita para sustitución y revocación.

El mismo servicio está disponible desde la raíz de la tienda, usando la identidad del servidor web:

php modules/mprdigitalrevolution/scripts/signing_keys.php status

La utilidad también permite configuración, exportación/importación cifrada, sustitución y revocación. Lee la contraseña de copia de MPR_SIGNING_BACKUP_PASSWORD. Usa sus argumentos documentados en vez de imprimir claves privadas o editar filas de claves manualmente.

Abre "Catalog" > Productos y añade un producto. Vincúlalo a un producto normal de PrestaShop mediante Producto de la tienda. El producto nativo vinculado proporciona el contexto comercial de la tienda.

Usa "Localized Roadmap Content" para los campos traducidos Nombre para mostrar, Slug SEO, Notas de la rama, Descripción de Showcase, Imagen de Showcase, Características de Showcase, Etiquetas de Showcase y Nota de no pedido. Los campos traducidos vacíos no crean por sí solos una página pública localizada completa.

Para un lanzamiento previsto, rellena Lanzamiento esperado y elige Notificar al publicar según corresponda. El área Suscriptores muestra visitantes interesados. Estos campos no sustituyen la subida de una versión activa.

"Minimum Protection Generation", "Blocked Build IDs" y "Legacy Protection Compatibility Until" son controles de operador para aceptar clientes/paquetes. Revisa las generaciones de clientes desplegadas antes de cambiarlos; no hacen falta para la primera configuración ordinaria de un producto.

El editor también contiene Versiones, Precios de licencia, Precios de soporte, Servicios y Variantes. Configura las opciones y precios reales que ofrecerás y comprueba su selección en la tienda y metadatos de pago. No supongas que un nombre de producto o ejemplo JSON antiguo configura esas opciones automáticamente.

Las descargas gratuitas requieren la elegibilidad correspondiente y un producto vinculado de precio cero. El formulario de producto no tiene un interruptor separado para esa elegibilidad. Tras establecer el precio, comprueba todo el proceso de adquisición gratuita.

Abre "Catalog" > Versiones o el área Versiones del producto.

Usa paquetes fuente limpios. Si el módulo carga vendor/autoload.php, incluye sus dependencias de producción y autoloader. El empaquetador valida rutas del archivo, raíz del módulo y archivo principal, y prepara la versión. No uses como fuente un ZIP protegido ya personalizado de un cliente.

Una fila de versión no demuestra que la entrega esté lista. Ejecuta las comprobaciones disponibles de Preparación del módulo y realiza una descarga controlada real. El paquete protegido se certifica en el servidor antes de servirse; una certificación fallida impide la entrega e informa de un error.

Los paquetes actuales pueden contener datos de licencia cifrados, .mpr_license.json, un .mpr_wm local al módulo, código de integridad de emisor/runtime y un comentario de archivo MPR:<watermark ID>. Los detalles dependen del modo de entrega. Un JSON auxiliar mínimo antiguo no es una plantilla para nuevas versiones.

Haz un pedido de prueba del producto vinculado. Los hooks de validación y estado de pedido asignan y concilian derechos. Una licencia pendiente no equivale a acceso pagado activo. Confirma que el pedido alcance un estado pagado/logable elegible e inspecciona "Licensing" > Licencias.

Accede como cliente de prueba y abre /licenses usando el enlace localizado generado por la tienda. Inspecciona la tarjeta de licencia y descarga la versión autorizada.

La primera descarga de pago desde una tarjeta de licencia puede ser un paquete firmado que aún no está vinculado al dominio de una tienda. La activación durante la instalación lo vincula a la tienda. Las actualizaciones de una activación existente usan la tienda ya vinculada a la licencia.

Para una demo ya instalada, usa Activar en el cliente, accede al portal emisor y confirma la licencia. Poseer la clave por sí solo no basta para crear una vinculación mediante acciones retiradas de registro de tienda/asignación automática.

Comprueba estado de activación, tienda vinculada, propiedad de licencia y comprobación de actualizaciones del módulo instalado. Revisa "Licensing" > Dominios e "Installs". Usa las acciones compatibles de transferencia/cambio de dominio del portal; no edites directamente las filas de vinculación.

La ruta de descarga pagada con token es:

/release-download/{token}

Evita el directorio físico download/ de PrestaShop. El token de solicitud pagada dura por defecto 30 minutos y se consume al canjearlo. Un servicio separado de tokens de artefactos preparados usa un TTL de 300 segundos. Son etapas de token distintas. Obtén un enlace nuevo del portal cuando caduque o ya se haya usado.

Los registros de descarga relacionan producto, versión, cliente, IP, vinculación, hashes e identidad de marca de agua cuando están disponibles.

Validez de licencia y cobertura de soporte son independientes. Con soporte activo, el servicio puede elegir la última versión activa. Con soporte caducado, elige una publicada dentro del periodo de soporte autorizado. Una licencia perpetua válida no concede automáticamente todas las versiones nuevas. La cobertura de servicios y packs puede imponer su propio límite de versiones.

Usa Precios de soporte y la integración de pago compatible para ampliaciones o soporte recurrente. Comprueba el contrato y las opciones de soporte reales.

En Configuración > Servicios, "Demo Orchestrator Admin Token" empieza vacío. Obténlo de la administración del orquestador de demos configurado. No se genera en este formulario. Una demo alojada requiere el orquestador externo además del indicador del producto.

Los valores predeterminados de las notas de servicio son:

Las notas pueden usar {module_name}, {service_name} y {service_type}. Comprueba el indicador de visibilidad para el cliente al actualizar un pedido de servicio. El módulo ofrece pedidos de servicio, contratos e integración de tickets; inspecciona Soporte y las páginas correspondientes de licencias/administración del cliente seleccionado.

Para un pack de catálogo, activa Paquete, elige Composición del paquete, Incorporaciones posteriores y, si procede, Meses para incorporaciones. Un pack nuevo usa por defecto composición por lista e incorporaciones para siempre. Guárdalo como no disponible para pedidos, edita y guarda ID de productos incluidos en el paquete antes de activar ventas. Verifica los derechos de los productos incluidos con un pedido de prueba.

La pestaña actual "Stripe" expone Secreto del webhook, vacío por defecto. No expone los antiguos campos "Stripe Mode", "Test Secret Key" ni "Live Secret Key". Los procesos recurrentes de pago/soporte siguen requiriendo la integración compatible de pago/suscripción y sus credenciales válidas.

El módulo registra /webhook/stripe. Configura el secreto de firma correcto para ese endpoint. En Cola de reenvío de webhooks, corrige la causa de un evento fallido, usa Volver a poner el evento en cola y después "Resend" en Stripe. Los eventos completados no pueden reproducirse con esta acción.

En Seguridad, "Require Signed Support API Requests" está desactivado por defecto. Actívalo cuando los clientes firmados compatibles hayan llegado a los módulos de los clientes. Clave secreta API se genera al instalar y es de solo escritura en el formulario. Regenerarla cambia el material de autenticación del servidor; revisa antes los clientes y tokens dependientes.

El panel "Shared sign-in credentials" solo aparece si otro módulo instalado ofrece credenciales OAuth compatibles. Revisa propietario/huella y concede o revoca la reutilización para esta tienda. No sirve para pegar claves Stripe arbitrarias.

Las rutas API usan /mpr-api/license/{action}. El endpoint antiguo de validación acepta clave de licencia y dominio, por ejemplo:

curl -X POST 'https://yourshop.example/mpr-api/license/validate' \
  -H 'Content-Type: application/json' \
  -H 'X-License-Key: YOUR_TEST_LICENSE_KEY' \
  -d '{"domain":"example.com","module":"yourmodule","module_version":"1.2.5","ps_version":"8.2.1","php_version":"8.2"}'

Usa una vinculación real de licencia/dominio de prueba. Esta llamada de validación no crea una vinculación de activación. Otras operaciones tienen sus propios requisitos de autenticación, firma o tokens con ámbito. Usa el cliente de licencias incluido para el protocolo completo de actualización y activación.

Los productos vinculados pueden añadir opciones de licencia, soporte, servicio y demo mediante hooks de producto. El historial de cambios puede aparecer con las integraciones compatibles de pestañas de producto. Comprueba los hooks displayProductAdditionalInfo, pestañas y contenido extra de tu tema.

Las rutas públicas incluyen /roadmap, /roadmap/{slug}, /demos, /demo/{slug} y los procesos /live-demo cuando están activos. /demos/{slug} se conserva como ruta antigua de presentación de demos y redirige mediante el catálogo actual; no trates cada URL antigua como una página autónoma distinta.

Prueba por separado adquisición de demos, descarga con un clic, aceptación de condiciones/privacidad, cuotas y activación inicial. Una concesión demo/gratuita no se convierte en licencia pagada solo porque el cliente acceda después. Comprueba concesión y propiedad correctas en Descargas de demo y el espacio del cliente.

El hook de sitemap comprueba la clave compartida de bajo nivel INCLUDE_IN_SITEMAP, inicializada a 1. Ponerla a 0 suprime la salida sitemap del módulo. No es un ajuste visible de Configuración, y la visibilidad/indexabilidad pública sigue dependiendo de cada contenido y ruta.

El CSS del tema puede usar selectores existentes como .mpr-digital-variants, .mpr-demo-link, .mpr-btn-demo, .mpr-btn-demo-download, .mpr-license-selection y .mprdigital-changelog-tab. Inspecciona el marcado actual antes de añadir overrides.

La instalación registra tareas programadas compartidas de analítica, licencias pagadas pendientes, incorporaciones a packs, reversiones de derechos, activación/asignación de soporte, compilaciones abandonadas y limpieza de auditoría de demos. Configura el ejecutor con el comando/token real generado por el módulo instalado. Comprueba activación y resultados correctos; crear un producto no ejecuta por sí mismo todas las conciliaciones en segundo plano.

En Configuración, "Retention" > "Apply retention now" procesa lotes acotados, hasta 50 filas modificadas por conjunto de datos y pasada. Repite mientras el resultado indique "Repeat". Revisa los registros pendientes de pagos, mensajes de acceso y finalización antes de considerar completada la limpieza histórica. Los registros de errores PHP y backends externos de tickets quedan fuera del servicio.

Los formularios de clasificación histórica piden los ID revisados y la referencia de cierre de cada registro. Usa el registro de cierre real, no una fecha de última edición supuesta.

Si fallan la activación o descargas protegidas, inspecciona primero Claves de firma, la URL mostrada del emisor e Integridad. Después comprueba preparación de la versión, certificación del paquete, propiedad y estado pagado del pedido. Un periodo de soporte caducado puede excluir legítimamente una versión posterior.

Si una URL de descarga devuelve 403, confirma que usas el enlace generado release-download en vez de /download/. Si ha caducado o se ha consumido, genera otro desde la tarjeta de licencia. Si una compilación está ocupada, usa el proceso compatible de reintento de esa solicitud en lugar de crear nuevas descargas repetidamente.

Si no aparecen opciones de producto, comprueba Producto de la tienda, Activo, Pedible, estado de versión, precios/variantes y hooks del tema. Si falta contenido público, comprueba campos localizados e "Indexable (SEO)". Si fallan demos, comprueba integración del orquestador, token, cuotas y protocolo de paquete disponible.

Usa "Analytics" > Descargas, "API Logs", Demostraciones en vivo, Popularidad del producto y Preparación del módulo para revisar cada área. Para soporte recurrente, revisa también la integración de pago y suscripción, los webhooks fallidos y el conciliador programado.

Antes de desinstalar, respalda base de datos, archivos fuente/versiones, claves de firma y registros necesarios. Las claves de firma se conservan durante la desinstalación. Guarda su copia cifrada y los archivos gestionados por el operador. La desinstalación elimina menús, tareas y esquema ordinario del módulo; la limpieza de paquetes compartidos depende de otros usuarios instalados. Puede interrumpir el servicio de licencias/actualizaciones de paquetes ya entregados. Planifica la continuidad de su emisor antes de retirar este servicio de la tienda.

Requiere PrestaShop 1.7.0 o posterior y PHP 7.1 o posterior.