WP Manifestindependent plugin directory
manifest / integrations / nexus-sc

Nexus Subscription Controller

NEXUS Subscription Controller Alpha.

by Mimer · github.com/mimergt/nexus-sc · website

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/mimergt/nexus-sc/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/mimergt/nexus-sc ↗

Controls access to the GHL/EpicPay integration based on WooCommerce Subscriptions state.

Description

Nexus Subscription Controller vincula cada suscripción de WooCommerce Subscriptions con el ID de sub-cuenta de GoHighLevel (location_id) del cliente que la compró.

Funcionalidades principales:

  • Captura el parámetro ?account_id= en la URL de compra y lo guarda en la sesión de WooCommerce.
  • Al crear la suscripción, asocia el location_id como meta privado (_nexus_ghl_location_id) tanto en la suscripción como en la orden padre.
  • Bloquea compras duplicadas: si ya existe una suscripción activa para el mismo location_id, el checkout muestra un error.
  • Sincroniza el estado (activo / inactivo) con el bridge de Cloudflare via REST: al activar, cancelar, suspender o expirar la suscripción, envía un POST al bridge.
  • Expone el endpoint REST GET /wp-json/nexus-sc/v1/check-subscription?location_id=XXX para que el bridge verifique el estado en tiempo real, autenticado por una API key secreta compartida.
  • Añade columna "GHL Account" en la lista de suscripciones y órdenes de WooCommerce admin.
  • Añade metabox / panel lateral con el location_id en la pantalla de detalle de la suscripción.

Requiere WooCommerce Subscriptions (plugin oficial WooThemes) activo.

Configuración

Añadir en wp-config.php:

define( 'NSC_BRIDGE_URL', 'https://tu-worker.workers.dev' ); define( 'NSC_BRIDGE_API_KEY', 'clave-secreta-aleatoria' );

La misma clave debe configurarse en el bridge de Cloudflare como variable de entorno WP_NEXUS_API_KEY.

Flujo de compra

  1. El cliente llega al checkout desde la página de la app en GHL. La URL incluye: ?account_id={locationId} (generado dinámicamente por el bridge).
  2. Nexus captura el account_id y lo guarda en la sesión WC.
  3. Al completar la compra, el location_id queda vinculado a la suscripción.
  4. El bridge, al cargar /app para ese location_id, consulta este plugin y decide si mostrar la pantalla de onboarding o la pantalla con las llaves de integración.

Instalación

  1. Sube la carpeta nexus-sc a wp-content/plugins/.
  2. Activa el plugin desde WP Admin > Plugins.
  3. Asegúrate de que WooCommerce Subscriptions esté activo.
  4. Configura las constantes en wp-config.php (ver Configuración).

Changelog

1.0.0

  • Lanzamiento inicial.
  • Captura de ?account_id en checkout.
  • Asociación de location_id a suscripción.
  • Validación de duplicados.
  • Sincronización de estado al bridge.
  • Endpoint REST autenticado.
  • Columnas admin en suscripciones y órdenes.
  • Metabox en detalle de suscripción.