Skip to main content

WordPress Plugin Integration

What is this? A production-ready WordPress plugin that rewards your site visitors with LTZ tokens for engaging with your content (comments, signups, daily visits, etc.).

Use this if you're: Running a WordPress site and want to reward user engagement and loyalty.

You'll need:

🚀 Quick Start (Recommended)​

We've built a production-ready WordPress plugin that handles:

  • ✅ Dynamic Event System (add unlimited events)
  • ✅ Automatic Rewards for Comments, Signups, Daily Visits
  • ✅ Flexible WordPress Hook Integration
  • ✅ Server-Side API Calls (no CORS issues)
  • ✅ Easy Admin Configuration

📦 View the Repository​

Clone the repository and install the plugin:

git clone https://github.com/Alpha4-Labs/wordpress-demo.git
cd wordpress-demo/wordpress-loyalty-plugin

Or download the plugin zip directly.

🎮 Try Live Demo​

Test the plugin instantly in your browser using WordPress Playground - no installation required!

How It Works​

Plain English Explanation:

  1. User does something (leaves a comment, signs up, visits daily, etc.)
  2. WordPress triggers a hook (e.g., comment_post, user_register)
  3. Plugin sends event to Loyalteez via server-side API call
  4. User gets LTZ tokens automatically

Step-by-Step Setup​

Step 1: Install the Plugin​

Option A: Upload Plugin (Recommended)

  1. Download the plugin: wordpress-plugin.zip
  2. Go to WordPress Admin → Plugins → Add New → Upload Plugin
  3. Upload the zip file and click "Install Now"
  4. Click "Activate Plugin"

Option B: Manual Installation

  1. Clone the repository: git clone https://github.com/Alpha4-Labs/wordpress-demo.git
  2. Copy the wordpress-loyalty-plugin folder to your wp-content/plugins/ directory
  3. Go to WordPress Admin → Plugins
  4. Find "Loyalteez Rewards" and click "Activate"

Step 2: Configure the Plugin​

  1. Go to: WordPress Admin → Settings → Loyalteez Rewards
  2. Enter your Brand ID:
    • Log in to Partner Portal
    • Copy your Brand Wallet Address from the dashboard
    • Paste it into the "Brand ID" field
  3. Configure Domain Authentication:
    • In Partner Portal → Settings → Profile → Authentication Methods
    • Under "Domain", enter your website URL (e.g., https://yourbrand.com)
    • This authenticates events from your domain

Step 3: Add Events​

The plugin uses a dynamic event system - add as many events as you need:

  1. Click "Add Event" in the settings page
  2. WordPress Hook: Enter the hook name (e.g., comment_post, user_register)
  3. Loyalteez Event Name: Enter the exact event name from your Partner Portal
  4. Enable: Check the box to activate
  5. Save Changes

Common WordPress Hooks:

  • comment_post - When a comment is posted
  • user_register - When a new user registers
  • init - On every page load (for daily visit tracking)
  • wp_login - When a user logs in
  • publish_post - When a post is published
  • woocommerce_order_status_completed - WooCommerce order completion

Important: Event names must match exactly what you've configured in Partner Portal → Settings → LTZ Distribution.

Step 4: Test Your Integration​

  1. Use the Test Button:

    • Scroll to "Test API Connection" section
    • Enter a test email and event name
    • Click "Send Test Event"
    • Verify success or check error messages

  2. Test Real Events:

    • Leave a comment on a post (if comment_post is configured)
    • Register a new user (if user_register is configured)
    • Check your Partner Portal → Analytics to see events

Code Example​

Here's how the plugin sends events to Loyalteez:

/**
 * Send event to Loyalteez API
 */
public function send_event($event_type, $email, $metadata = []) {
    $body = [
        'brandId'   => $this->brand_id,
        'eventType' => $event_type,
        'userEmail' => $email,
        'domain'    => parse_url(get_site_url(), PHP_URL_HOST),
        'metadata'  => array_merge([
            'platform'  => 'wordpress',
            'timestamp' => current_time('c'),
        ], $metadata)
    ];

    $response = wp_remote_post('https://api.loyalteez.app/loyalteez-api/manual-event', [
        'body'    => json_encode($body),
        'headers' => [
            'Content-Type' => 'application/json',
            'User-Agent'   => 'Loyalteez-WordPress-Plugin/1.0.0'
        ],
        'timeout' => 15
    ]);

    return wp_remote_retrieve_response_code($response) === 200;
}

Programmatic Event Sending​

You can send events from your theme or other plugins:

// Load the API class
require_once WP_PLUGIN_DIR . '/loyalteez-rewards/includes/class-api.php';

// Send a custom event
$api = new Loyalteez_API();
$api->send_event('custom_event_name', '[email protected]', [
    'custom_data' => 'value',
    'source' => 'my_custom_function'
]);

Reward Strategies​

Strategy 1: Comment Rewards​

Why: Encourages engagement and discussion. How: Configure comment_post hook → post_comment event.

Strategy 2: Daily Visit Rewards​

Why: Encourages repeat visits and daily engagement. How: Configure init hook → daily_visit event (plugin handles 24-hour cooldown).

Strategy 3: Signup Rewards​

Why: Rewards new user registration, encourages account creation. How: Configure user_register hook → user_registration event.

Strategy 4: Content Sharing​

Why: Encourages social sharing and viral growth. How: Add share buttons with loyalteez-share class (plugin handles AJAX).

Frontend Integration​

Add Share Buttons​

The plugin includes frontend JavaScript for share rewards:

<button class="loyalteez-share" data-url="https://yourbrand.com/awesome-post">
    Share for Rewards
</button>

The plugin automatically:

  • Prompts for email if user isn't logged in
  • Sends AJAX request to WordPress backend
  • WordPress backend calls Loyalteez API
  • Shows success/error message

Custom Frontend Events​

You can trigger events from JavaScript:

// Via WordPress AJAX (requires nonce)
jQuery.post(ajaxurl, {
    action: 'loyalteez_custom_event',
    nonce: loyalteez_vars.nonce,
    event_name: 'custom_action',
    email: '[email protected]',
    metadata: { custom: 'data' }
});

Troubleshooting​

"Events aren't triggering"​

Check:

  1. Are events enabled in plugin settings?
  2. Do event names match Partner Portal exactly?
  3. Enable Debug Mode and check wp-content/debug.log
  4. Use "Test API Connection" button

"API returns 403 Forbidden"​

Check:

  1. Is your domain configured in Partner Portal → Settings → Profile → Domain?
  2. Domain must match exactly (including https:// or www)
  3. Example: If your site is https://yourbrand.com, enter exactly that

"API returns 400 Bad Request"​

Check:

  1. Does the event name exist in Partner Portal → Settings → LTZ Distribution?
  2. Event names are case-sensitive
  3. Use "Test API Connection" to see exact error message

"No CORS errors but events don't work"​

Note: The plugin makes server-side API calls (no browser CORS). If you see CORS errors, they're from:

  • WordPress Playground loading the plugin zip (use proxy URL)
  • Frontend JavaScript (check browser console)

Debug Mode​

Enable Debug Mode in plugin settings to log all API requests/responses:

  1. Go to Settings → Loyalteez Rewards
  2. Check "Enable Debug Logging"
  3. Ensure WP_DEBUG is enabled in wp-config.php: 
    define('WP_DEBUG', true);
    define('WP_DEBUG_LOG', true);
  4. Check wp-content/debug.log for [Loyalteez] entries

Architecture Notes​

Server-Side Processing​

  • All API calls are made server-side via PHP wp_remote_post()
  • No browser CORS issues
  • Secure (API keys never exposed to frontend)

Dynamic Hook System​

  • Plugin dynamically registers WordPress hooks based on configuration
  • Supports any WordPress action hook
  • Automatically extracts user email from hook context when possible

Domain Authentication​

  • Each event includes your site's domain
  • Partner Portal validates domain matches configured website URL
  • Prevents unauthorized use of your Brand ID

Support​

Last updated on