WordPress Publishing with WonderRank
Automatically publish production-ready SEO articles to your WordPress site with a single security token. Includes native featured & in-body media sideloading, hierarchical topical categories (Pillar → Subtopic), in-head JSON-LD Schema, in-place republishing, and seamless Yoast, Rank Math, AIOSEO & SEOPress metadata sync.
WonderRank Connector v1.2.3Production Standard
Zero user passwords required. One token connects your site. Downloads all featured and in-body images directly to your WordPress media library, organizes topical map pillars into parent/child categories, and outputs clean Schema markup in your site header.
Setup Instructions (3 Steps)
Download & Upload the Connector Plugin
Download wonderrank-connector.zip above. In your WordPress Admin, go to Plugins → Add New Plugin → Upload Plugin, choose the downloaded ZIP file, and click Install Now → Activate Plugin.
Copy Your Token from WordPress Admin
Once activated, go to Settings → WonderRank in your WordPress Admin. Your secure wr_wp_... token is generated automatically. Click Copy Token (and optionally choose your default author and banner placement).
Paste Token in WonderRank & Save
In your WonderRank dashboard, open Integrations → WordPress, enter your WordPress Site URL, and paste the token from WordPress into the Integration Token box.
Click Test WordPress Connection to verify write access, then click Save WordPress Settings.
Core Architecture & Auto-Publishing Engine
- Articles Only (
post_type: 'post'): WonderRank generates focused SEO blog posts. It does not publish layout pages or tamper with site navigation menus. - In-Body & Featured Media Sideloading: The featured share image and all images inside the post body are automatically downloaded into your WordPress Media Library using core PHP sideloading. Your live site never relies on external WonderRank servers.
- Topical Hierarchy (Pillars & Subtopics): WonderRank maps Topical Map pillars to top-level WordPress Parent Categories, and subtopic spokes to Child Categories nested underneath.
- In-Head JSON-LD Schema: Articles output clean, structured data into
wp_headautomatically via the plugin, keeping Gutenberg and post body markup pristine. - Yoast SEO & Rank Math Native Sync: SEO meta titles, meta descriptions, and focus keywords are written directly into Yoast and Rank Math fields without requiring custom snippets in functions.php.
- In-Place Republishing & Draft Reversion: Re-publishing an article updates the existing post without duplicating URLs. Reverting to draft unpublishes the live post cleanly in-place.
- Plain Permalinks Automatic Fallback: If your WordPress site uses Plain permalinks (or your host lacks
/wp-json/rewrite rules), WonderRank automatically routes calls via/?rest_route=/wonderrank/v1/*.
Topical Map & Category Hierarchy Mapping
WonderRank generates topical clusters (Pillars and Subtopics) to establish search authority. Here is how your topical hierarchy is translated into WordPress:
The core pillar topic (e.g. "Technical SEO") is automatically created as a top-level parent Category in WordPress (parent = 0).
Cluster spokes (e.g. "Core Web Vitals") are created as child categories nested directly beneath their respective pillar parent category.
WonderRank exclusively publishes articles as standard WordPress posts (post_type: 'post'). All contextual links between spoke articles and pillar hub articles are woven directly into the HTML body content.
Cloudflare & WAF Whitelisting
If your WordPress site uses Cloudflare, Wordfence, or Sucuri, add a WAF bypass rule to avoid automated publishing blocks:
Cloudflare Custom WAF Rule
- Log into your Cloudflare Dashboard and select your domain.
- Navigate to Security → WAF → Custom Rules and click Create rule.
- Name the rule:
Allow WonderRank Publishing. - Click Edit expression and paste:
(http.request.uri.path contains "/wp-json/wonderrank/v1/")Set Action to Skip → Select All Managed Rules → Click Deploy.
Field Auto-Mapping Reference
| WonderRank Field | WordPress Destination | Behavior & Execution |
|---|---|---|
| blog.title | post_title | Article H1 heading and browser page title. |
| article.htmlWithSchema | post_content | Sanitized article body HTML. Executable scripts stripped via wp_filter_post_kses. |
| blog.slug | post_name | URL slug (e.g. /my-article/). Updates in-place on republish. |
| featured_image_url | featured_media | Downloaded and attached to WordPress Media Library via core media sideload. |
| in-body images (<img src="...">) | post_content (Media Library) | External image URLs are downloaded into the Media Library and replaced with local attachment URLs. |
| pillar / subtopic | category (hierarchical) | Pillar creates parent category, subtopic creates child category nested underneath. |
| article.schema | wp_head (JSON-LD) | Output cleanly into <head> without cluttering the post editor. |
| seo.meta_title | _yoast_wpseo_title / rank_math_title | SEO Title populated in Yoast and Rank Math metaboxes. |
| seo.meta_description | _yoast_wpseo_metadesc / rank_math_description | Meta description populated for search engine snippets. |
| primaryKeyword | _yoast_wpseo_focuskw / rank_math_focus_keyword | Focus keyword populated for SEO scoring. |
Troubleshooting
| Symptom | Probable Cause | Resolution |
|---|---|---|
| 401 Unauthorized | Token mismatch between WonderRank and WordPress. | Verify that the token in WP Admin → Settings → WonderRank matches the token in your WonderRank dashboard. |
| 404 Not Found | WonderRank Connector plugin is inactive or deactivated. | Confirm the WonderRank plugin is activated in WP Admin → Plugins. Note: Plain permalinks are supported automatically via rest_route fallback. |
| 403 Forbidden | Security firewall (Cloudflare WAF, Wordfence). | Add a WAF skip rule for /wp-json/wonderrank/v1/* as detailed in the Cloudflare section above. |
| Featured Image Missing | Theme does not declare featured image support. | Ensure active theme supports add_theme_support('post-thumbnails') in functions.php. |