Developer Reference

This is the comprehensive developer reference for FCHub Memberships. It covers everything you need to extend, integrate with, or debug the plugin.

Action Hooks

The plugin fires these WordPress action hooks during the membership lifecycle. All hooks are prefixed with fchub_memberships/.

Filter Hooks

Listening to Hooks

add_action('fchub_memberships/grant_created', function (int $userId, int $planId, array $context) {
    // Your custom logic when a membership is granted
    $sourceType = $context['source_type'] ?? 'manual';
    error_log("User {$userId} granted plan {$planId} via {$sourceType}");
}, 10, 3);

REST API

All endpoints are under the fchub-memberships/v1 namespace. Unless noted, endpoints require manage_options capability (administrator).

Frontend API

These endpoints are available to authenticated users (no admin requirement):

Dynamic Options

WP-CLI Commands

All commands are under the wp fchub-membership namespace.

wp fchub-membership list-grants --member=<id|email> [--status=<status>] [--plan=<slug>]

wp fchub-membership grant --member=<id|email> --plan=<slug>

wp fchub-membership revoke --member=<id|email> --plan=<slug> [--reason=<text>]

wp fchub-membership revoke-by-order --order=<id> [--reason=<text>]

wp fchub-membership check --member=<id|email> --plan=<slug>

wp fchub-membership backfill [--dry-run] [--limit=<n>]

wp fchub-membership sync [--dry-run]

wp fchub-membership expire-check

wp fchub-membership drip-process [--limit=<n>]

wp fchub-membership purge-expired [--days=<n>] [--dry-run]

wp fchub-membership debug --member=<id|email>

wp fchub-membership stats [--period=<period>] [--aggregate]

wp fchub-membership export-members [--plan=<slug>] [--status=<status>] [--format=<csv|json|table>]

Webhooks

Webhooks send membership events to external services as HTTP POST requests with JSON payloads.

Configuration

In Memberships > Settings:

• Webhook Enabled (webhook_enabled) — master switch for webhooks
• Webhook URLs (webhook_urls) — newline-separated list of endpoint URLs. Multiple URLs are supported
• Webhook Secret (webhook_secret) — shared secret for HMAC-SHA256 signature verification

Events

Payload Format

{
  "event_type": "grant_created",
  "timestamp": "2025-01-15T10:30:00+00:00",
  "site_url": "https://example.com",
  "data": {
    "user": {
      "id": 42,
      "email": "member@example.com",
      "display_name": "Jane Doe"
    },
    "plan": {
      "id": 1,
      "title": "Pro Membership",
      "slug": "pro"
    },
    "context": {
      "source_type": "order",
      "source_id": 156
    }
  }
}

Signature Verification

Every webhook includes an X-FCHub-Signature header containing the HMAC-SHA256 signature of the request body:

signature = HMAC-SHA256(request_body, webhook_secret)

Verify the signature on your receiving end:

$payload = file_get_contents('php://input');
$signature = $_SERVER['HTTP_X_FCHUB_SIGNATURE'] ?? '';
$expected = hash_hmac('sha256', $payload, $your_shared_secret);

if (!hash_equals($expected, $signature)) {
    http_response_code(403);
    exit('Invalid signature');
}

The X-FCHub-Event header contains the event type string.

Delivery

Webhooks are delivered asynchronously via Action Scheduler when available. The fchub_memberships_dispatch_webhook hook fires with the URL, body, and headers. If Action Scheduler is not available, delivery falls back to synchronous wp_remote_post() with a 15-second timeout.

Failed deliveries are logged via the Logger class.

Test Webhook

Send a test event from Memberships > Settings or via the REST API:

curl -X POST https://example.com/wp-json/fchub-memberships/v1/settings/webhook-test \
  -H "X-WP-Nonce: <nonce>"

Adapter System

The adapter system provides a uniform interface for granting and revoking access across different content providers.

AccessAdapterInterface

interface AccessAdapterInterface
{
    public function supports(string $resourceType): bool;
    public function grant(int $userId, string $resourceType, string $resourceId, array $context = []): array;
    public function revoke(int $userId, string $resourceType, string $resourceId, array $context = []): array;
    public function check(int $userId, string $resourceType, string $resourceId): bool;
    public function getResourceLabel(string $resourceType, string $resourceId): string;
}

Built-in Adapters

Registering Custom Adapters

Adapters are resolved by provider string. You can register custom resource types through the fchub_memberships/resource_types action:

add_action('fchub_memberships/resource_types', function ($registry) {
    $registry->register('my_resource', [
        'label'     => 'My Custom Resource',
        'group'     => 'content',
        'provider'  => 'my_plugin',
        'searchable' => true,
    ]);
});

Database Tables

All tables are prefixed with {wp_prefix}fchub_membership_.

CSV Import

The import system supports multiple CSV formats through parser classes implementing CsvParserInterface.

Built-in Parsers

Import Flow

1. Upload — CSV file is uploaded and validated
2. Preview — The parser processes the CSV and returns a preview of what will be imported (users matched, plans matched, conflicts detected)
3. Execute — Grants are created for each valid row. Existing grants are updated if found

Custom Parsers

Implement CsvParserInterface and register your parser via a hook to support additional CSV formats from other membership plugins.

Cron Jobs

WP-Cron Events

Action Scheduler Hooks

All cron handlers check for FLUENTCART_VERSION before executing to avoid errors when FluentCart is temporarily deactivated.