WonderRankWonderRankDOCS
Official WonderRank Connector Plugin v1.2.3 (1-Token Handshake)

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)

1

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.

2

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).

3

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_head automatically 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:

Pillar Topics → Parent Categories

The core pillar topic (e.g. "Technical SEO") is automatically created as a top-level parent Category in WordPress (parent = 0).

Subtopics → Child Categories

Cluster spokes (e.g. "Core Web Vitals") are created as child categories nested directly beneath their respective pillar parent category.

Internal Linking & Post Scope

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

  1. Log into your Cloudflare Dashboard and select your domain.
  2. Navigate to Security → WAF → Custom Rules and click Create rule.
  3. Name the rule: Allow WonderRank Publishing.
  4. 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 FieldWordPress DestinationBehavior & Execution
blog.titlepost_titleArticle H1 heading and browser page title.
article.htmlWithSchemapost_contentSanitized article body HTML. Executable scripts stripped via wp_filter_post_kses.
blog.slugpost_nameURL slug (e.g. /my-article/). Updates in-place on republish.
featured_image_urlfeatured_mediaDownloaded 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 / subtopiccategory (hierarchical)Pillar creates parent category, subtopic creates child category nested underneath.
article.schemawp_head (JSON-LD)Output cleanly into <head> without cluttering the post editor.
seo.meta_title_yoast_wpseo_title / rank_math_titleSEO Title populated in Yoast and Rank Math metaboxes.
seo.meta_description_yoast_wpseo_metadesc / rank_math_descriptionMeta description populated for search engine snippets.
primaryKeyword_yoast_wpseo_focuskw / rank_math_focus_keywordFocus keyword populated for SEO scoring.

Troubleshooting

SymptomProbable CauseResolution
401 UnauthorizedToken mismatch between WonderRank and WordPress.Verify that the token in WP Admin → Settings → WonderRank matches the token in your WonderRank dashboard.
404 Not FoundWonderRank 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 ForbiddenSecurity firewall (Cloudflare WAF, Wordfence).Add a WAF skip rule for /wp-json/wonderrank/v1/* as detailed in the Cloudflare section above.
Featured Image MissingTheme does not declare featured image support.Ensure active theme supports add_theme_support('post-thumbnails') in functions.php.