WordPress Connector

Installation

Step 1: Download and Install Plugin

1. Go to Settings > Integrations in ILLIXIS
2. Find WordPress in the CMS Connectors section
3. Click Download Plugin
4. In WordPress admin, go to Plugins > Add New > Upload Plugin
5. Upload the illixis-connector.zip file
6. Click Install Now, then Activate

Step 2: Connect to ILLIXIS

1. In WordPress, go to ILLIXIS in the sidebar
2. Click Connect to ILLIXIS
3. You'll be redirected to app.illixis.io to authorize the connection
4. Click Authorize to grant permissions
5. You'll be redirected back to WordPress with the connection established

Connection uses OAuth 2.0 - No need to manually copy API keys.

Plugin Features

Auto-Update System

The plugin checks for updates automatically every 12 hours. Updates are delivered from app.illixis.io and integrate with WordPress's native update system.

Manual update check:

1. Go to Plugins page
2. Find ILLIXIS Connector
3. Click Check for updates (next to Settings)

Updates appear in the standard WordPress updates list alongside other plugins.

Bidirectional Sync

The connector supports both push (WordPress → ILLIXIS) and pull (ILLIXIS → WordPress) sync modes.

Push Sync (WordPress → ILLIXIS)

Sends your existing WordPress content to ILLIXIS for analytics and optimization.

What gets synced:

• Post title, content, excerpt
• Slug and permalink URL
• Categories and tags
• Featured image
• Publication date and modified date
• Post status (published, draft)
• Post type (post, page, custom post types)

Configure push sync:

1. Go to ILLIXIS > Settings
2. Enable Auto Sync
3. Choose Sync Interval (hourly, daily, weekly)
4. Select Content Types to sync (posts, pages, custom types)
5. Click Save Settings

Manual sync: Click Sync Now on the settings page to trigger immediate sync.

Pull Sync (ILLIXIS → WordPress)

Import AI-generated content from ILLIXIS directly into WordPress.

What happens:

1. Content created in ILLIXIS is queued for WordPress
2. Plugin pulls new content on schedule or manual trigger
3. Posts are created as drafts by default
4. Featured images are downloaded and attached
5. Categories and tags are automatically created if needed

Status tracking: Posts created from ILLIXIS include metadata:

• _illixis_generated - Marks content as ILLIXIS-created
• _illixis_id - Links back to ILLIXIS content ID
• _illixis_generated_at - Creation timestamp

Category and Tag Mapping

Categories and tags sync automatically in both directions.

Push (WordPress → ILLIXIS):

• WordPress categories become ILLIXIS content tags
• WordPress tags become secondary tags
• Hierarchical categories are flattened

Pull (ILLIXIS → WordPress):

• ILLIXIS content tags map to WordPress categories
• Categories are auto-created if they don't exist
• Tags are auto-created if they don't exist
• Mapping is case-insensitive (prevents duplicates)

Custom mapping: Define category equivalents in ILLIXIS:

1. Go to Settings > Integrations > WordPress
2. Click Configure Mappings
3. Map ILLIXIS categories to WordPress categories
4. Save mappings

Featured Image Handling

Images sync automatically when pulling content from ILLIXIS.

Process:

1. Plugin downloads image from ILLIXIS URL
2. Image is uploaded to WordPress Media Library
3. Image is set as featured image for the post
4. Filename is sanitized based on post title
5. Image metadata is preserved

Requirements:

• WordPress must allow URL file downloads (default: enabled)
• upload_max_filesize must accommodate image sizes (typically 2-5MB)
• Write permissions on wp-content/uploads/ directory

Troubleshooting: If images fail to sync:

1. Check PHP allow_url_fopen is enabled
2. Verify WordPress filesystem permissions
3. Review sync log at ILLIXIS > Sync History

Scheduled Publishing

Content can be scheduled for future publication.

From ILLIXIS:

1. Create or generate content
2. In publish modal, select WordPress as destination
3. Choose Schedule for later
4. Pick date and time
5. Click Schedule

From WordPress: Scheduled posts from ILLIXIS appear in Posts > Scheduled with future publish dates.

Timezone handling:

• ILLIXIS uses your tenant's timezone (set in Settings > Profile)
• WordPress uses its configured timezone (in Settings > General)
• Plugin converts timestamps during sync

Sync History and Logs

View all sync operations and troubleshoot issues.

Access logs: Go to ILLIXIS > Sync History

Log details:

• Operation - Type of sync (bulk_sync, pull_content, push_single)
• Status - Success, partial, or failed
• Records - Number processed, succeeded, failed
• Message - Human-readable result
• Details - JSON data with specifics
• Timestamp - When operation occurred

Log retention: Logs are stored for 90 days, then automatically pruned.

Export logs: Click Export CSV to download sync history for analysis.

WooCommerce Integration

If WooCommerce is active, the plugin includes additional e-commerce features.

Product Sync

Sync WooCommerce products to ILLIXIS for content repurposing.

What gets synced:

• Product title, description, short description
• SKU and price
• Product images
• Categories and tags
• Stock status
• Product variations

Use case: Generate product descriptions, social posts, and email campaigns from product data.

Order Tracking

Track abandoned carts and purchase behavior for email automation.

Tracked events:

• Cart abandonment (30-minute threshold)
• Purchase completion
• First-time buyer vs. repeat customer

Webhooks sent to ILLIXIS:

• woocommerce/order/created
• woocommerce/order/status_changed
• woocommerce/cart/abandoned

These trigger email sequences in Email Automation > E-commerce Flows.

Enable tracking:

1. Go to ILLIXIS > Settings
2. Check Enable E-commerce Tracking
3. Save settings

Embedded Forms

Embed ILLIXIS lead capture forms in WordPress content using shortcodes.

Shortcode format:
```
[illixis_form tenant="your-tenant-slug" slug="form-slug" height="700"]
```

Parameters:

• tenant - Your ILLIXIS tenant slug (required)
• slug - Form slug from ILLIXIS (required)
• height - Iframe height in pixels (default: 700)
• width - Iframe width (default: 100%)

Get form details:

1. In ILLIXIS, go to Email Automation > Forms
2. Click the form you want to embed
3. Click Embed Code tab
4. Copy the WordPress shortcode

Example usage:
```
[illixis_form tenant="acme-corp" slug="newsletter-signup" height="600"]
```

Forms are responsive and styled to match your WordPress theme.

Promo Banners (Widget)

Display ILLIXIS-created promotional banners on your WordPress site.

What it does:
Injects a JavaScript widget that fetches and displays promotional content (lead magnets, offers, announcements) created in ILLIXIS.

Enable promo widget:

1. Go to ILLIXIS > Settings
2. Scroll to Promo Banners
3. Check Enable Promo Widget
4. Save settings

Widget placement:
The widget automatically injects into your site footer. It fetches promo content from ILLIXIS and displays it according to your campaign rules (targeting, frequency capping, etc.).

Manage promos:
Create and manage promotional content in ILLIXIS at Content > Promo Campaigns.

Troubleshooting

Connection Issues

"Not connected to ILLIXIS" error:

1. Go to ILLIXIS > Settings
2. Click Reconnect
3. Complete OAuth authorization again
4. Verify connection status shows "Connected"

"Authorization failed" during OAuth:

• Verify your ILLIXIS account is active
• Check WordPress site URL matches the URL configured in ILLIXIS
• Try disconnecting and reconnecting

Sync Failures

"Sync failed: No new content available":
This is normal - means no content is queued from ILLIXIS.

"Sync failed: API request failed":

1. Check internet connectivity
2. Verify ILLIXIS API is reachable (check app.illixis.io status)
3. Review ILLIXIS > Sync History for detailed error messages
4. Contact support if issue persists

Images not downloading:

1. Test URL file downloads: Add this to a test PHP file:
   ```php
   echo ini_get('allow_url_fopen') ? 'Enabled' : 'Disabled';
   ```
2. Check filesystem permissions:
   ```bash
   ls -la wp-content/uploads/
   ```
3. Increase upload_max_filesize in php.ini if needed

Categories/tags not created: Verify your WordPress user has manage_categories capability. The plugin requires admin-level permissions for taxonomy creation.

Performance Issues

Sync taking too long:

1. Reduce Content Types being synced (exclude pages or custom types)
2. Change Sync Interval to less frequent (daily instead of hourly)
3. Manually sync during off-peak hours

Large sites (1000+ posts): The plugin syncs in batches of 50 posts per operation. For initial sync of large sites:

1. Set Auto Sync to Off
2. Run Sync Now manually multiple times
3. Monitor progress in Sync History
4. Re-enable Auto Sync after initial sync completes

Security

Authentication:

• OAuth 2.0 with refresh tokens (no stored passwords)
• Tokens are encrypted at rest
• Connections expire after 90 days of inactivity

Permissions: Plugin requires manage_options capability (admin-only).

Data transmission: All API requests use HTTPS with TLS 1.2+.

Webhook verification: Incoming webhooks from ILLIXIS are verified using HMAC signatures.

API Endpoints (For WordPress Admins)

The plugin registers the following REST API routes on your WordPress site, which ILLIXIS uses to communicate with your server:

| Route | Method | Purpose |
|-------|--------|---------|
| /wp-json/illixis/v1/publish | POST | Publish content from ILLIXIS |
| /wp-json/illixis/v1/update | POST | Update existing content |
| /wp-json/illixis/v1/status | GET | Health check |
| /wp-json/illixis/v1/sync | POST | Trigger content sync |

All endpoints are secured with OAuth bearer tokens -- they are not publicly accessible. If your WordPress site uses a firewall or security plugin, ensure these routes are not blocked.

Support

Plugin issues:

1. Check ILLIXIS > Sync History for detailed error logs
2. Verify WordPress and PHP meet minimum requirements:

• WordPress 5.0+
• PHP 7.4+
• cURL extension enabled

3. Try deactivating and reactivating the plugin

Content not appearing:

1. Verify content is published in ILLIXIS (not draft)
2. Check content is assigned to the correct content source
3. Review sync logs for errors
4. Manually trigger Sync Now to force refresh

Need help? Contact support at support@illixis.io with:

• WordPress version
• Plugin version
• Sync log details (from Sync History page)
• Description of issue