WordPress Integration

Set up seamless integration between BlogShoot and your WordPress website.

Prerequisites

Before connecting, ensure:

• WordPress 5.0 or higher
• HTTPS enabled (required for REST API)
• Application Passwords enabled
• Admin or Editor role access

Creating Application Password

Application Passwords allow secure API access without using your main password.

Step-by-Step

1. Log in to your WordPress admin dashboard
2. Go to Users → Your Profile
3. Scroll to Application Passwords section
4. Enter application name: BlogShoot
5. Click Add New Application Password
6. Copy the generated password (shown once)

Security Note

Store this password securely. It won’t be shown again. If lost, generate a new one and update BlogShoot settings.

Troubleshooting Application Passwords

If the Application Passwords section is missing:

1. Ensure WordPress 5.6+ is installed
2. Verify HTTPS is enabled
3. Check if disabled by plugin or hosting provider
4. Contact your host’s support if needed

Connecting Your WordPress Site

In BlogShoot Dashboard

1. Navigate to Integrations → WordPress
2. Click “Add WordPress Site”
3. Fill in connection details:

Site URL: https://yoursite.com
Username: your-admin-username
Application Password: [paste generated password]

4. Click “Test Connection”

   • ✅ Success: Connection verified
   • ❌ Failed: Check troubleshooting below

5. Click “Save Connection”

Publishing Configuration

Default Settings

Set default options for all published posts:

Post Status

• Publish: Posts go live immediately
• Draft: Save for manual review in WordPress
• Scheduled: Set future publish date/time

Categories

Select default category or create new ones automatically.

Tags

Choose to:

• Auto-generate tags from content
• Use custom tags
• Map to existing WordPress tags

Author

Select the WordPress user to attribute posts to.

Featured Image

• Always set: Every post gets a featured image
• Optional: Only set if available
• Never: Don’t set featured images

Post Template Settings

Customize how content appears:

<!-- Before content -->
Custom intro text or notice

<!-- After content -->
Author bio, CTA, related posts widget

Advanced Configuration

Custom Fields

Map BlogShoot data to WordPress custom fields:

BlogShoot Field	WordPress Custom Field	Value
SEO Score	_seo_score	Integer
Word Count	_word_count	Integer
AI Generated	_blogshoot_ai	Boolean

Yoast SEO Integration

If Yoast SEO is installed, BlogShoot automatically sets:

• Focus keyword
• Meta description
• SEO title
• Readability score

Rank Math Integration

For Rank Math users:

• Primary keyword
• Meta description
• Schema markup
• Social media images

Testing Your Connection

Connection Test

Click “Test Connection” to verify:

• Site accessible
• REST API enabled
• Authentication valid
• Permissions correct
• Categories accessible
• Media uploads working

Test Post

Send a test post to verify full workflow:

1. Click “Send Test Post”
2. Check WordPress dashboard
3. Verify:
   • Post created correctly
   • Images uploaded
   • Categories assigned
   • Formatting preserved

Managing Multiple Sites

Connect multiple WordPress sites to one workspace:

1. Click “Add Another Site”
2. Configure connection
3. Set as default or choose per post

Use Cases for Multiple Sites

• Main blog + subdomain blog
• Production + staging environments
• Multi-language sites
• Client sites (agencies)

Disconnecting a Site

To remove a WordPress connection:

1. Go to Integrations → WordPress
2. Find the site to disconnect
3. Click ”⋮” → “Disconnect”
4. Confirm action

Note

Disconnecting doesn’t delete previously published posts from WordPress.

Troubleshooting

Connection Failed

Possible causes:

1. Invalid credentials

   • Verify username is correct
   • Generate new Application Password
   • Try again

2. REST API disabled

   • Check if hosting blocks REST API
   • Contact hosting support
   • Consider changing hosts

3. HTTPS not enabled

   • Install SSL certificate
   • Update site URL to HTTPS
   • Clear WordPress cache

4. Firewall blocking

   • Whitelist BlogShoot IPs
   • Check security plugins
   • Review hosting firewall rules

Publishing Fails

Possible causes:

1. Insufficient permissions

   • Verify user has Editor or Admin role
   • Check capability: publish_posts

2. Media upload fails

   • Check upload directory permissions
   • Verify max upload size
   • Check available disk space

3. Connection expired

   • Reconnect WordPress site
   • Generate new Application Password

Images Not Uploading

1. Check WordPress upload directory permissions
2. Verify upload_max_filesize in php.ini
3. Check available storage space
4. Try manually uploading an image in WordPress

Security Best Practices

Application Password Security

• Use unique password per integration
• Rotate passwords every 6 months
• Revoke passwords for unused integrations
• Never share passwords

Monitoring

• Review WordPress user activity logs
• Check for unauthorized posts
• Monitor API usage in WordPress

Permissions

• Use Editor role, not Administrator
• Limit to necessary capabilities only
• Review permissions regularly

API Rate Limits

BlogShoot respects WordPress REST API limits:

• Maximum 5 requests per second
• Maximum 100 posts per day per site
• Images uploaded sequentially

For higher limits, contact support.

Next Steps

• Publishing to WordPress
• WordPress SEO Optimization
• API Reference