WordPress

Dos formas de integración

Este tutorial presenta dos formas distintas de integrar WordPress con Easytools:

1. Parte 1: enfoque con Automations - usa Easytools Automations para crear usuarios de WordPress y el plugin Simple Restrict para un control de acceso básico.
2. Parte 2: enfoque con webhooks - usa un plugin personalizado de WordPress que recibe webhooks de Easytools para una gestión de suscripciones más avanzada.

Elige el enfoque que mejor se adapte a tus necesidades. Ambos videos muestran el flujo completo, desde la configuración hasta las pruebas.

Parte 1: enfoque con Automations y el plugin Simple Restrict

En este primer enfoque, usamos Easytools Automations para crear automáticamente cuentas de usuario de WordPress cuando los clientes compran tu producto. Después usamos el plugin Simple Restrict para controlar qué páginas requieren una suscripción activa.

Requisitos previos

Antes de empezar, asegúrate de que tu sitio de WordPress cumple estos requisitos:

• Certificado SSL: tu sitio de WordPress debe tener un certificado SSL activo (la URL empieza con https://).
• Permalinks (enlaces permanentes): ve a Settings → Permalinks en WordPress. La estructura no puede estar en “Plain” (Sencilla). Usa “Post name” (Nombre de la entrada) o cualquier estructura personalizada.
• Acceso de administrador: necesitas acceso de nivel administrador para generar Application Passwords e instalar plugins.

Paso 1: genera una application password de WordPress

Las Application Passwords permiten que servicios externos como Easytools se conecten a tu sitio de WordPress de forma segura, sin usar tu contraseña principal de acceso.

1. Inicia sesión en tu panel de administración de WordPress
2. Ve a Users → Profile (o edita tu cuenta de administrador)
3. Baja hasta la sección Application Passwords
4. En el campo “New Application Password Name”, escribe un nombre como Easytools
5. Haz clic en Add New Application Password
6. Importante: copia la contraseña generada de inmediato. No podrás volver a verla.

Paso 2: conecta la app de WordPress en Easytools

Ahora vas a establecer la conexión entre Easytools y tu sitio de WordPress.

1. Inicia sesión en tu cuenta de Easytools
2. En la barra lateral izquierda, haz clic en Store para expandirlo y selecciona Automations
3. Haz clic en la pestaña Apps en la navegación superior
4. Haz clic en el botón + New app en la esquina superior derecha
5. Rellena el formulario de conexión:
   • Connection name: escribe un nombre descriptivo
   • Select app: elige Wordpress en el desplegable
   • Platform URL: introduce la URL de tu sitio de WordPress (debe incluir https://)
   • Username: tu nombre de usuario administrador de WordPress
   • Application password: pega la application password que copiaste en el paso 1
6. Haz clic en Check connection para verificar, y luego en Save

Paso 3: crea el escenario de automatización

Configura una automatización que cree una cuenta de usuario de WordPress cada vez que alguien compre tu producto.

1. En Easytools Automations, ve a la pestaña Scenarios
2. Haz clic en + New scenario
3. Configura el escenario:
   • Scenario name: ponle un nombre descriptivo
   • Send email on failure: activa esta opción para recibir un aviso si la automatización falla
   • Assign to products: selecciona el producto de Easytools que activará esta automatización
   • Assign to variants: elige “All variants” (Todas las variantes) o selecciona variantes concretas
   • Connection: selecciona la conexión de WordPress que creaste en el paso 2
   • Action: selecciona Create user (Crear usuario)
4. Haz clic en Save

Paso 4: prueba el flujo de compra

Ahora prueba el flujo completo para asegurarte de que los usuarios se crean correctamente en WordPress.

1. Ve a la página de tu producto en Easytools
2. Haz clic en el botón Checkout para previsualizar tu página de pago
3. Completa una compra de prueba rellenando todos los datos necesarios
4. Después de completar la compra, revisa tu bandeja de entrada para ver el email de confirmación de compra de Easytools

Paso 5: verifica la creación del usuario en WordPress

Comprueba que la automatización ha creado correctamente la cuenta de usuario.

1. En Easytools, ve a la pestaña Automations → Executions (Automatizaciones → Ejecuciones) para ver las estadísticas de ejecución
2. Haz clic en una ejecución reciente para verificar que se completó correctamente
3. Inicia sesión en tu panel de administración de WordPress
4. Ve a Users → All Users (Usuarios → Todos los usuarios)
5. Deberías ver una nueva cuenta de usuario con el rol Subscriber (Suscriptor) y el email usado durante la compra

Paso 6: instala el plugin Simple Restrict

Ahora instala un plugin para controlar qué páginas requieren que el usuario haya iniciado sesión. Te recomendamos Simple Restrict como opción ligera para un control de acceso básico. Si necesitas funciones más avanzadas, hay muchos otros plugins de membresías y control de acceso disponibles en el repositorio de WordPress.

1. En el panel de administración de WordPress, ve a Plugins → Add New Plugin
2. Busca Simple Restrict (o el plugin de control de acceso que prefieras)
3. Haz clic en Install Now y luego en Activate

Paso 7: concede permiso de acceso al usuario

Concede al usuario creado el permiso para acceder a las páginas restringidas.

1. En el panel de administración de WordPress, ve a Users → All Users
2. Haz clic en el usuario que creó la automatización
3. Baja hasta la sección Permissions
4. Marca la casilla only-logged - “Allow this user to see pages marked as only-logged” (Permitir que este usuario vea páginas marcadas como only-logged)
5. Haz clic en Update User para guardar

Paso 8: configura los permisos de página

Configura qué páginas deben estar restringidas solo a usuarios con sesión iniciada.

1. En el panel de administración de WordPress, ve a Pages → All Pages
2. Selecciona la página que quieres proteger y haz clic en Edit
3. En la barra lateral derecha, busca el panel Permissions
4. Marca la casilla only-logged para restringir esta página a usuarios con sesión iniciada
5. Haz clic en Update para guardar

Paso 9: prueba el control de acceso

Este es el paso final crucial: verifica que el control de acceso funciona correctamente tanto para usuarios con sesión iniciada como sin ella.

Escenario 1: probar como usuario sin sesión iniciada (debería estar bloqueado)

1. Abre una nueva ventana de navegación de incógnito/privada
2. Ve a la URL de la página protegida
3. Deberías:
   • Ser redirigido a una página de inicio de sesión, O
   • Ver un mensaje como “Access Denied” o “This content is restricted”, O
   • Ver una página en blanco o un error 403 (según la configuración del plugin)
4. Esto confirma que la restricción funciona

Escenario 2: probar como suscriptor con sesión iniciada (debería ver el contenido)

1. En la misma ventana de incógnito, ve a https://tusitio.com/wp-login.php
2. Inicia sesión con las credenciales del usuario creado por la automatización:
   • Username: el nombre de usuario creado (por ejemplo, test123 o basado en el email)
   • Password: el usuario necesitará usar la opción de restablecer contraseña de WordPress si no la tiene
3. Después de iniciar sesión, ve de nuevo a la página protegida
4. Ahora deberías ver el contenido completo de la página, sin restricciones
5. En la parte superior de la página verás la barra de administración de WordPress mostrando Howdy, [nombre de usuario]

Escenario 3: probar como administrador (acceso completo)

1. Inicia sesión con tu cuenta de administrador de WordPress
2. Ve a la página protegida
3. Deberías ver el contenido completo más la barra de herramientas de administración
4. Esto confirma que los distintos roles de usuario tienen el acceso adecuado

¡Listo! Has completado la Parte 1. Los usuarios que compren tu producto obtendrán automáticamente cuentas de WordPress y podrán acceder al contenido protegido. Cuando su suscripción caduque, puedes configurar la automatización para eliminar su cuenta de usuario de WordPress.

Parte 2: enfoque con webhooks y plugin personalizado

Este segundo enfoque usa webhooks para la comunicación en tiempo real entre Easytools y WordPress. Un plugin personalizado gestiona los eventos de suscripción, administra las cuentas de usuario, envía emails de bienvenida y ofrece una página de rechazo (bouncer page) para quienes no están suscritos.

Paso 1: configura los webhooks en Easytools

Primero, tienes que configurar las notificaciones por webhook en tu cuenta de Easytools.

1. Inicia sesión en Easytools

2. Haz clic en el nombre de tu tienda en la barra lateral izquierda y selecciona Store settings (Configuración de la tienda)

3. En el menú de pestañas superior, haz clic en API & Webhooks

4. Verás dos secciones principales:

   • Sección Webhook

     • Webhook URL: un campo de texto donde pegarás el endpoint del webhook de WordPress (lo obtendrás después de instalar el plugin)
     • Formato de ejemplo: https://tusitio.com/wp-json/easytools/v1/webhook?api\_token=IgCWvRX
     • Webhook signing key: muestra cuándo se creó la clave (por ejemplo, “Created 16.11.2025, 11:37:04”)
     • Botones: Delete (Eliminar) y Change key (Cambiar clave, con icono de actualizar)
     • Si todavía no tienes una signing key, verás un botón para crear una

   • Sección API keys

     • Descripción: “Create and manage API keys for your Store. You can find API docs here.” (Crea y gestiona claves API para tu tienda. Puedes encontrar la documentación de la API aquí, con enlace)
     • Botón + New API key en la esquina superior derecha
     • La sección muestra “Add a new API key” con instrucciones para crear tokens de autenticación de API

5. Importante: no rellenes todavía la Webhook URL, primero tienes que instalar el plugin

6. Si no tienes una webhook signing key, haz clic en el botón para generar una y cópiala de inmediato

Paso 2: instala el plugin Easytools Subscription Manager

Instala el plugin Easytools subscription manager, que gestiona los eventos del webhook.

1. Descarga el archivo del plugin
2. En el panel de administración de WordPress, ve a Plugins → Add New Plugin
3. Haz clic en Upload Plugin y selecciona el archivo ZIP
4. Haz clic en Install Now
5. Haz clic en Activate Plugin
6. Tras la activación, “Easytools” aparecerá en la barra lateral izquierda del panel de administración de WordPress

Paso 3: configura los ajustes del plugin

Configura el plugin con tus credenciales y preferencias de Easytools.

1. En la barra lateral del panel de administración de WordPress, haz clic en Easytools

2. Haz clic en Settings en el submenú

3. Configura las siguientes secciones:

   Basic Settings (ajustes básicos):

   • Easytools Checkout URL: introduce la URL de pago de tu producto de Easytools
   • Webhook Signing Key: pega la signing key de Easytools
   • API Token (Optional): token de seguridad adicional opcional
   • Webhook URL: muestra el endpoint del webhook de tu WordPress - lo copiarás más adelante para pegarlo en Easytools

   Bouncer Page Settings (ajustes de la página de rechazo):

   • Enable Bouncer Page: márcalo para activarlo
   • Bouncer Page: selecciona qué página usar como página de rechazo
   • Product URL: la URL de pago de tu producto de Easytools
   • Icon Color: personaliza el color de los botones si quieres

   Access Control (control de acceso):

   • Protect Entire Site: protege opcionalmente todas las páginas excepto las que elijas
   • Exclude Pages: elige qué páginas deben seguir siendo públicas

4. Haz clic en Save Settings

Paso 4: configura el email de bienvenida

Personaliza el email que reciben los nuevos suscriptores con su enlace para configurar la contraseña.

1. En los ajustes del plugin de Easytools (más abajo), busca la sección Email Configuration
2. Verás una descripción: “Customize the content of welcome emails sent to new users. Available placeholders: {username}, {site_name}, {login_url}” (Personaliza el contenido de los emails de bienvenida enviados a los nuevos usuarios. Marcadores disponibles: {username}, {site_name}, {login_url})
3. Configura los siguientes campos:
   • Email Subject: el valor por defecto es [{site_name}] Welcome! Set Your Password
   • Email Heading: por defecto muestra un emoji de fiesta y Welcome to {site_name}!
   • Email Message: área de texto multilínea con el contenido que prefieras
   • Button Text: el valor por defecto es Set Your Password
4. Debajo de la configuración verás una sección Test Email:
   • Título: “Test your email configuration” (Prueba tu configuración de email)
   • Descripción: “Send a test welcome email to verify your email settings, sender information, and template” (Envía un email de bienvenida de prueba para verificar tus ajustes de email, la información del remitente y la plantilla)
   • Introduce una dirección de email de prueba en el campo
   • Haz clic en el botón Send test email
5. Revisa tu bandeja de entrada para comprobar que el email de bienvenida se ve correctamente

Paso 5: completa la conexión del webhook

Ahora conecta Easytools con el endpoint del webhook de tu WordPress.

1. En los ajustes del plugin de WordPress, busca el campo Webhook URL en Basic Settings
2. Haz clic en el botón verde Show para revelar la URL completa
3. Haz clic en el botón rosa Copy URL para copiarla
4. Vuelve a Easytools → Store settings → API & Webhooks
5. Pega la URL copiada en el campo Webhook URL
6. La URL incluirá el parámetro del token de API (por ejemplo, ?api_token=IgCWvRXUx1o45kJfbcem0SbodmQmmT1)
7. Haz clic en Save

Paso 6: prueba la integración del webhook

Usa la herramienta de prueba integrada para verificar que los webhooks funcionan correctamente.

1. En el panel de administración de WordPress, ve a Easytools → Webhook Testing

2. Verás la página Easytools Webhook Testing con la descripción: “Test and debug webhook integrations with Easytools payment platform” (Prueba y depura las integraciones de webhook con la plataforma de pago de Easytools)

3. La página muestra tres secciones principales:

   • Webhook endpoint:

     • Webhook URL (with API Token): muestra tu endpoint con el token oculto
     • Descripción: “Use this URL in Easytools → API & Webhooks. The API token provides additional security.” (Usa esta URL en Easytools → API & Webhooks. El token de API aporta seguridad adicional)
     • Signing Key: oculta con puntos (••••••••••••••••••)
     • API Token: oculto con puntos
     • Cada uno tiene botones verdes Show y rosas Copy

   • Ejemplos de payloads:

     • Custom Test Email: campo para introducir una dirección de email de prueba
     • Product Assigned: sección con el botón “Send test webhook”
     • Muestra una vista previa del payload JSON de ejemplo
     • Secciones similares para otros tipos de eventos

4. Introduce una dirección de email de prueba en el campo Custom test email

5. En la sección Product Assigned, haz clic en Send test webhook

6. Comprueba el mensaje de éxito y verifica que la prueba funcionó

Paso 7: monitoriza los registros del webhook

Consulta todos los eventos de webhook recibidos por tu sitio de WordPress.

1. En el panel de administración de WordPress, ve a Easytools → Webhook logs
2. Verás una página titulada “Monitor and debug webhook communications from Easytools” (Supervisa y depura las comunicaciones de webhook desde Easytools)
3. En la parte superior hay un filtro de rango de fechas:
   • Dos campos de fecha en formato dd.mm.aaaa
   • El texto “to” (hasta) entre ellos
   • Botón azul Filter (con icono de filtro)
   • Botón rosa Clear (con icono de X)
4. A la derecha hay una sección Export:
   • Botón verde Export to CSV (con icono de descarga)
   • Botón verde Export to MD (con icono de documento)
5. La tabla principal muestra los eventos de webhook con cabeceras verdes:
   • Date: marca de tiempo (por ejemplo, “2025-11-16 22:16:18”)
   • Event Type: muestra nombres de eventos como:
     • product_assigned
     • subscription_created
     • product_access_expired
     • subscription_deleted
   • Customer Email: dirección de email del cliente
   • User ID: número de ID de usuario de WordPress (por ejemplo, “46”, “45”, “44”)
   • Status: todos muestran insignias verdes de success (éxito)
6. Haz clic en Details en cualquier fila para ver el payload completo del webhook y la respuesta

Paso 8: consulta la gestión de suscriptores

Revisa las suscripciones activas e inactivas en el panel de suscriptores.

1. En el panel de administración de WordPress, ve a Easytools → Subscribers

2. Verás una descripción: “View and manage all users with active and inactive subscriptions” (Consulta y gestiona todos los usuarios con suscripciones activas e inactivas)

3. La página se divide en dos secciones con cabeceras verdes:

   Active Subscriptions (suscripciones activas):

   • Icono verde de verificación con el título Active Subscriptions
   • Tabla con columnas:
     • User: nombre de usuario de WordPress
     • Email: email del usuario
     • Subscription Type: tipo de suscripción
     • Renewal Date: fecha de la próxima renovación
     • Status: insignia de estado
   • Si está vacía: “No active subscriptions found.” (No se encontraron suscripciones activas)

   Inactive Accounts (cuentas inactivas):

   • Icono rojo de X con el título Inactive Accounts
   • Descripción: “Users who previously had a subscription that was cancelled, expired, or is no longer active.” (Usuarios que antes tenían una suscripción que se canceló, caducó o ya no está activa)
   • Tabla con columnas:
     • User: nombre de usuario
     • Email: dirección de email
     • Last Subscription Type: tipo (por ejemplo, “monthly”)
     • Last Renewal Date: fecha (por ejemplo, “2025-11-28 16:14:03”)
     • Status: insignia roja mostrando Inactive (Inactivo)

Paso 9: prueba el flujo de compra completo

Ejecuta una prueba de extremo a extremo para verificar toda la integración.

1. Visita la página de pago de tu producto de Easytools
2. Completa una compra de prueba con una dirección de email real
3. Después de la compra, revisa tu email para ver el email de bienvenida con un asunto como “Welcome! Set Your Password”
4. El email debería mostrar:
   • Botón morado/azul con el texto “Set your password”
   • Encabezado del email con el emoji de fiesta y el mensaje de bienvenida
   • Tu nombre de usuario
5. Haz clic en el botón para configurar tu contraseña
6. Ve a Easytools → Subscribers en WordPress
7. Verifica que el usuario aparece en Active Subscriptions
8. Ve a Webhook Logs y verifica que los eventos se registraron:
   • evento product_assigned
   • evento subscription_created

Paso 10: prueba la página de rechazo y el control de acceso

Verifica que los usuarios no suscritos son redirigidos a la página de rechazo.

1. Abre una ventana de navegador de incógnito/privada
2. Ve a una página protegida de tu sitio de WordPress
3. Deberías ser redirigido a la página de rechazo
4. La página de rechazo debería mostrar:
   • La marca/logo de tu sitio (según la plantilla)
   • Un mensaje explicando que se requiere suscripción
   • Un botón para comprar/suscribirse (que enlaza a tu pasarela de pago de Easytools)
5. Ahora inicia sesión como usuario suscriptor
6. Ve a la misma página protegida
7. Deberías ver el contenido completo de la página, sin página de rechazo
8. En la parte superior verás que has iniciado sesión como el usuario suscriptor

¡Felicidades! Has configurado correctamente la integración de WordPress basada en webhooks con el plugin personalizado. Este enfoque ofrece gestión de suscripciones en tiempo real, creación automática de usuarios, emails de bienvenida, control de acceso y registro completo.