WordPress Integration

iContentForge connects directly to your WordPress site using the official WordPress REST API and Application Passwords. This allows you to automatically publish generated articles as posts, complete with categories, tags, and featured images.

Prerequisites

Before you begin, ensure your WordPress site meets the following requirements:

• WordPress Version: 5.6 or higher (for Application Passwords feature).
• Site Accessibility: Your site must be publicly accessible over HTTPS (recommended) or HTTP.
• Permissions: You need administrator access to your WordPress dashboard to generate an Application Password.

Step-by-Step Connection Guide

Follow these steps to connect your WordPress site to iContentForge.

Step 1: Generate an Application Password in WordPress

1. Log in to your WordPress Admin Dashboard.
2. Navigate to Users → Profile (or Edit Profile).
3. Scroll down to the Application Passwords section.
4. Enter a descriptive name for the connection (e.g., "iContentForge") and click Add New Application Password.
5. WordPress will generate a password. Copy this password immediately, as it will not be displayed again.

Step 2: Configure Connection in iContentForge

1. In your iContentForge project, go to Settings → CMS Integration.
2. Select WordPress from the list of CMS providers.
3. Fill in the connection details:
   • Base URL: The full URL of your WordPress site (e.g., https://yourwebsite.com). Do not include a trailing slash.
   • Username: Your WordPress username (usually the one you use to log into the dashboard).
   • Application Password: Paste the password you copied from WordPress in Step 1.
4. Click the Verify Connection button.

Step 3: Select Default Category & Save

1. Upon successful verification, iContentForge will fetch a list of categories from your WordPress site.
2. Select a Default Category from the dropdown menu. All articles published through this connection will be assigned to this category unless specified otherwise in the article generation settings.
3. Click Save Configuration to finalize the connection.

Your WordPress site is now connected. Articles set to "Publish" will be automatically pushed to your site according to your project's drip-feed schedule.

Troubleshooting Common Errors

If you encounter issues during verification, here are the most common causes and solutions.

Error 401: Unauthorized

This means the credentials are incorrect or the Application Password wasn't set up properly.

• Solution: Double-check your Username and Application Password. Ensure you copied the entire password string from WordPress. You may need to generate a new Application Password and try again.

Error 404: Not Found

This usually indicates an incorrect Base URL or that the WordPress REST API is not accessible.

• Solution: Verify your Base URL is correct (no trailing slash). Ensure your site is live. Test the API endpoint directly by visiting {your-base-url}/wp-json/wp/v2/categories in your browser. You should see JSON data.

SSL / HTTPS Issues

If your site uses a self-signed certificate or has SSL problems, the API call may fail.

• Solution: For development sites with self-signed certificates, this may cause a block. For live sites, ensure your SSL certificate is valid and properly installed. You can temporarily use http:// for testing if your site allows it, but this is not recommended for production.

Connection Timeout

iContentForge cannot reach your WordPress site.

• Solution: Check if your WordPress site is online and not behind firewall rules that block incoming API requests. Some hosting providers may restrict external API calls; you may need to whitelist iContentForge's IP addresses (contact support for IP details).

How Publishing Works

Once connected, the publishing flow is automatic:

1. An article generated in iContentForge moves to the Ready status.
2. Based on your project's Drip Feed settings (approximately every 5 minutes), the system picks the next ready article.
3. iContentForge sends a POST request to your WordPress REST API (/wp/v2/posts) with the article's title, content (HTML), excerpt, selected category, tags, and featured image.
4. The article status in iContentForge changes to Published, and you can view it live on your site.

Next Steps

• Learn how to manage your publishing queue with Drip Feed Scheduling.
• Set up other supported platforms: Ghost Integration.
• Understand the full article lifecycle: Article Statuses & Workflow.