Connect WordPress to PostPenguin

WordPress sites can receive PostPenguin posts automatically using our official plugin. Posts are published directly to your WordPress site with full SEO metadata.

🚀 Quick Setup with Official Plugin

📋 What the Plugin Does

⚙️ Plugin Settings

The plugin adds a settings page at Settings → PostPenguin with:

• Secret Key — Your shared secret for webhook verification
• Webhook URL — The URL to enter in PostPenguin (displayed automatically)
• Status — Shows whether the plugin is configured correctly

🧪 Testing Your Setup

After configuring the plugin, test the webhook:

# Generate a test signature
SECRET="your-secret-key"
PAYLOAD='{"postPenguinId":"test_123","title":"Test Post","slug":"test-post","contentHtml":"<p className="text-gray-700">Test content</p>"}'
SIGNATURE=$(echo -n "$PAYLOAD" | openssl dgst -sha256 -hmac "$SECRET" | cut -d' ' -f2)

# Send test webhook
curl -X POST https://your-site.com/wp-json/postpenguin/v1/posts \
  -H "Content-Type: application/json" \
  -H "X-PostPenguin-Secret: $SIGNATURE" \
  -d "$PAYLOAD"

If successful, you'll see a response like:

{
  "success": true,
  "postId": 123,
  "postUrl": "https://your-site.com/test-post/",
  "action": "created"
}

🔧 Advanced: Custom Integration

If you prefer to build your own integration instead of using the plugin, you can create a custom webhook handler:

<?php
// Add to your theme's functions.php or a custom plugin

add_action('rest_api_init', function () {
    register_rest_route('postpenguin/v1', '/posts', [
        'methods' => 'POST',
        'callback' => 'handle_postpenguin_webhook',
        'permission_callback' => '__return_true'
    ]);
});

function handle_postpenguin_webhook(WP_REST_Request $request) {
    // Verify signature
    $signature = $request->get_header('X-PostPenguin-Secret');
    $secret = get_option('postpenguin_secret_key');
    $body = $request->get_body();
    
    $expected = hash_hmac('sha256', $body, $secret);
    if (!hash_equals($expected, $signature)) {
        return new WP_Error('unauthorized', 'Invalid signature', ['status' => 401]);
    }
    
    $data = json_decode($body, true);
    
    // Create WordPress post
    $post_id = wp_insert_post([
        'post_title' => sanitize_text_field($data['title']),
        'post_name' => sanitize_title($data['slug']),
        'post_content' => wp_kses_post($data['contentHtml']),
        'post_status' => 'publish',
        'post_type' => 'post',
    ]);
    
    if (is_wp_error($post_id)) {
        return new WP_Error('error', 'Failed to create post', ['status' => 500]);
    }
    
    // Save PostPenguin ID for future updates
    update_post_meta($post_id, '_postpenguin_id', $data['postPenguinId']);
    
    return [
        'success' => true,
        'postId' => $post_id,
        'postUrl' => get_permalink($post_id)
    ];
}

🐛 Troubleshooting

📚 Plugin Requirements

• WordPress 5.0 or higher
• PHP 7.0 or higher
• REST API enabled (enabled by default in WordPress)
• HTTPS recommended for security