Documentación del paquete Pg Paylock

No se han encontrado apartados que coincidan con tu búsqueda.

1. Resumen y Descarga

PG Paylock (pkg_pgpaylock) es un sistema completo de monetización por micropagos para artículos de Joomla. Permite publicar una introducción abierta y gratuita para todos los visitantes y proteger el contenido exclusivo (recetas, código fuente, análisis, tutoriales avanzados, partituras o enlaces de descarga) tras un muro de pago directo mediante tarjeta bancaria (Stripe) y PayPal.

A diferencia de las plataformas de comercio electrónico tradicionales o los sistemas complejos de suscripción, PG Paylock funciona directamente sobre tus artículos estándar de Joomla sin carritos ni fichas de producto, conectando en tiempo real con las APIs oficiales de Stripe y PayPal sin intermediarios ni comisiones adicionales por transacción.

Paquete: pkg_pgpaylock Autor: Paco Guio Joomla 4.x / 5.x / 6.x PHP 8.0+ Licencia GNU GPL v2+

Ficha técnica y arquitectura del paquete

Al instalar el paquete completo, Joomla despliega de forma coordinada los siguientes elementos nativos:

Componente Nombre técnico Función dentro del sistema
Paquete principal pkg_pgpaylock Coordina la instalación, actualización atómica, migración desde plugins antiguos y limpieza al desinstalar.
Plugin de Contenido plg_content_pgpaylock Procesa las etiquetas {pgpaylock}, renderiza el cartel de aviso, gestiona las sesiones de Stripe Checkout y PayPal Orders v2, valida los pagos en servidor y registra las compras.
Plugin Botón de Editor plg_editors-xtd_pgpaylock Añade el botón visual PG Paylock en la barra de herramientas de TinyMCE, JCE y CodeMirror para envolver texto protegido en un clic.
Tabla de Base de Datos #__pgpaylock_purchases Almacena el historial verificado de transacciones, importes, divisas, tokens de sesión y fechas de caducidad de acceso.
Idiomas incluidos es-ES y en-GB Traducción completa del backend, guía rápida, mensajes al comprador y avisos de error en español e inglés.

Requisitos del sistema

  • CMS: Joomla 4.0 o superior, Joomla 5.x o Joomla 6.x (arquitectura 100 % nativa con espacios de nombres PSR-4 y WebAssetManager; no requiere activar el plugin de compatibilidad Behaviour - Backward Compatibility).
  • Servidor: PHP 8.0, 8.1, 8.2 o 8.3 con extensión cURL o allow_url_fopen habilitada para la comunicación HTTPS con las APIs de Stripe y PayPal.
  • Base de datos: MySQL 5.7+ / 8.0+ o MariaDB 10.3+ con soporte utf8mb4.
  • Pasarelas de pago: Cuenta gratuita de Stripe (claves API) y/o cuenta de PayPal Business / Developer (Client ID y Secret).
Aviso legal y condiciones de uso (GNU GPL v2 o posterior) Esta extensión se distribuye como software libre bajo los términos de la licencia GNU General Public License versión 2 o posterior. El software se entrega «tal cual» (as is), sin garantías explícitas ni implícitas de ningún tipo, incluyendo su idoneidad para un propósito particular o ausencia de interrupciones. La instalación, configuración y uso en producción recaen bajo la exclusiva responsabilidad del administrador del sitio web. Es imprescindible realizar una copia de seguridad (backup) completa de los archivos y de la base de datos antes de instalar o actualizar cualquier extensión.

Descarga directa

Descarga el paquete instalable completo listo para subir desde el gestor de extensiones de Joomla:

2. Instalación y Actualización

Pasos de instalación en Joomla

  1. Realiza una copia de seguridad completa de tu sitio web (archivos y base de datos).
  2. Accede al panel de administración de Joomla (/administrator).
  3. Dirígete a Sistema → Instalar → Extensiones.
  4. En la pestaña Subir archivo de paquete, selecciona o arrastra el archivo .zip descargado.
  5. Una vez finalizada la instalación, ve a Sistema → Gestionar → Plugins, busca PG Paylock y comprueba que tanto PG Paylock - Contenido de Pago como Botón - PG Paylock estén activados (estado habilitado).

Automatizaciones del script de instalación

El instalador (script.php) ejecuta automáticamente varias tareas para evitar errores manuales:

  • Creación de tabla SQL: Genera la tabla #__pgpaylock_purchases con índices únicos por pasarela y transacción (idx_gateway_transaction) para impedir registros duplicados.
  • Despliegue de recursos estáticos: Copia los archivos CSS, JavaScript y manifiestos joomla.asset.json en /media/plg_content_pgpaylock/ y /media/plg_editors_xtd_pgpaylock/ para cumplir con las políticas de seguridad de contenidos (CSP) de Joomla 4, 5 y 6.
  • Migración desde versiones antiguas: Si detecta una instalación previa del plugin legado jfpaylock, lo desactiva automáticamente para evitar conflictos de ejecución y mantiene compatibilidad con sus etiquetas antiguas {jfpaylock} en los artículos existentes.

Actualizar sin perder datos

El paquete utiliza method="upgrade" en todos sus manifiestos XML. Para actualizar desde cualquier versión anterior, basta con instalar el nuevo archivo ZIP encima desde Sistema → Instalar → Extensiones sin desinstalar previamente. Todos tus parámetros, claves API, diseño visual del cartel e historial de compras en #__pgpaylock_purchases se conservan intactos.

3. Configuración del Plugin

Para configurar la extensión, entra en Sistema → Gestionar → Plugins y haz clic sobre PG Paylock - Contenido de Pago. La pantalla de ajustes está organizada en 6 pestañas claras:

Pestaña 0: Guía Rápida (Empieza aquí)

Incluye un resumen visual en lenguaje no técnico con los 4 pasos esenciales de puesta en marcha y una chuleta rápida con los parámetros opcionales de los shortcodes (precio, moneda y modulo).

Pestaña 1: Cartel de Aviso (Constructor Visual)

Permite elegir entre el Constructor Visual (Clic y Editar) o el Modo HTML Avanzado mediante el selector superior:

Parámetro / Herramienta Tipo Valor por defecto Descripción
custom_html_mode Botones 0 (Constructor Visual) Alterna de forma exclusiva entre el maquetador visual interactivo (0) y el editor de código HTML libre (1).
notice_layout (Lienzo y Panel Inspector) Constructor Visual Diseño limpio preconfigurado Editor en dos columnas: haz clic en el fondo/borde del cartel para ajustar plantillas rápidas (Blanco limpio, Azul profesional, Dorado VIP, Oscuro Dark), color o imagen de fondo (integrada con el Gestor Multimedia de Joomla) con oscurecimiento, grosor/estilo/color de borde, radio de esquinas, padding, sombra y ancho máximo. Haz clic sobre cualquier bloque interior para editar su texto, color o tamaño, o añade nuevos bloques (+ Título, + Texto, + Imagen, + Lista, + Precio, + Icono, + Línea).
notice_html Editor WYSIWYG / HTML Tarjeta Bootstrap 5 Solo visible en modo HTML Avanzado. Permite escribir código HTML personalizado manteniendo los anclajes mágicos #stripe y #paypal en los botones de pago.

Pestaña 2: Cobrar con Tarjeta (Stripe)

Parámetro Nombre técnico Descripción
Activar Stripe stripe_enabled Habilita o deshabilita el botón de pago con tarjeta bancaria mediante Stripe Checkout.
Modo de entorno stripe_mode Alterna entre Pruebas (Test / Sandbox) y Producción (Live).
Claves API de Stripe stripe_test_secret / stripe_live_secret Clave secreta (sk_test_... o sk_live_...) obtenida desde el panel de desarrolladores de Stripe para crear y verificar sesiones de pago en servidor.

Pestaña 3: Cobrar con PayPal

Parámetro Nombre técnico Descripción
Activar PayPal paypal_enabled Habilita o deshabilita el botón de pago mediante la API oficial PayPal Orders v2.
Entorno PayPal paypal_mode Selecciona Sandbox (Pruebas) o Live (Real).
Credenciales REST API paypal_client_id / paypal_secret Identificador de cliente y clave secreta de tu aplicación REST en PayPal Developer.

Pestaña 4: Precio, Moneda y Duración del Acceso

  • Precio por defecto y divisa: Define la tarifa base y la moneda (EUR, USD, MXN, ARS, COP, CLP, GBP o BRL).
  • Control de acceso: Permite elegir si el acceso tras pagar es permanente (de por vida) o limitado a un número concreto de días, y si se exige o no inicio de sesión previo en Joomla.

Pestaña 5: Mensajes al Comprador

Personaliza los avisos de confirmación tras completar el pago, mensajes de cancelación o errores de verificación sin tocar archivos de idioma.

4. Guía de Uso Diario

Uso rápido con el botón del editor

  1. Abre o crea un artículo en Contenido → Artículos y redacta la introducción abierta al público.
  2. Selecciona con el ratón el bloque de contenido exclusivo que deseas proteger.
  3. Pulsa el botón PG Paylock en la barra de herramientas del editor (TinyMCE, JCE o CodeMirror) para envolver automáticamente la selección entre las etiquetas {pgpaylock}...{/pgpaylock}.

Shortcodes y parámetros avanzados por artículo

  • Etiqueta estándar: {pgpaylock}Contenido exclusivo{/pgpaylock} (aplica el precio y moneda globales).
  • Precio y moneda personalizados: {pgpaylock precio=19.95 moneda=EUR}Contenido exclusivo{/pgpaylock}.
  • Mostrar un módulo dentro del aviso: {pgpaylock modulo=123}Contenido exclusivo{/pgpaylock}.

Pruebas en modo Sandbox / Test

Activa el entorno de pruebas en las pestañas de Stripe y/o PayPal, realiza una compra simulada desde el frontend y comprueba que el contenido se desbloquea al instante y queda registrado en la tabla #__pgpaylock_purchases antes de pasar a modo Live.

5. Preguntas Frecuentes y Errores

¿El visitante necesita registrarse en Joomla antes de pagar?

No es obligatorio. Puedes permitir el pago exprés sin registro (el acceso queda vinculado a su sesión/cookie firmada) o activar la opción de exigir cuenta de usuario para que el comprador conserve su acceso desde cualquier dispositivo.

No aparecen los botones de Stripe o PayPal en el cartel de pago

Comprueba en la configuración del plugin que al menos una de las dos pasarelas esté activada y tenga sus claves API rellenas para el entorno seleccionado (Test/Sandbox o Live). El plugin oculta automáticamente cualquier pasarela sin credenciales válidas.

6. Historial de Versiones

  • Versión 2.0.9: Constructor Visual interactivo en dos columnas para el cartel de pago, integración nativa con Stripe Checkout y PayPal Orders v2, soporte para precios por artículo y compatibilidad completa con Joomla 4, 5 y 6.
logo paco guio