WP Chiral Network

Zh/EN

Chiral Connector Plugin

Chiral Connector is the client plugin for the Chiral Hub ecosystem. It is installed on individual WordPress sites (referred to as “Hub sites”) to serve as the bridge connecting them to the central Chiral Hub Core.

With Chiral Connector, your site can securely and easily sync article data (such as title, excerpt, and featured image) to the Chiral Hub. More importantly, it fetches intelligent related post recommendations powered by Jetpack from across the content network and seamlessly displays them on your post pages.

This not only greatly enriches the content of your website, but also effectively enhances user engagement and page views, extending the influence of your site’s content throughout the Chiral network.

Learn more: How It Works

Core Features:

  • Seamless Integration: Easily connect to your Chiral Hub Core site.
  • Auto Sync: Automatically sync post metadata to the Hub when you create, update, or delete posts.
  • Smart Recommendations: Display highly relevant articles from across the network at the end of your posts or via shortcode.
  • Flexible Control: Freely configure which post types to sync, the number of related posts to show, and display titles.
  • Status Monitoring: Provides tools for connection testing, cache clearing, and bulk sync, keeping you in control of your site’s integration status.

Effect

Author’s blog post: https://1q43.blog/post/11054/

Download

Latest Version: 1.1.1

Last Updated: 2025-06-14

Download URL: Github

Installation Guide

Before installing Chiral Connector, make sure you’ve obtained the following information from your Hub administrator:

  • Hub site URL
  • A Chiral Porter role username
  • An application password generated for that user

Installation Steps:

  1. Log in to the admin dashboard of your WordPress node site (the site where you want to install the Connector).
  2. Navigate to Plugins > Add New.
  3. Click the Upload Plugin button at the top of the page.
  4. Select the chiral-connector.zip file you downloaded, then click Install Now.
  5. Once installation is complete, click Activate Plugin.

Generating an Application Password

Before configuration, log in with your account credentials to the Hub you want to join (e.g., https://hub.yournetwork.com)

On your profile page, generate an Application Password:

This password cannot be used to log in directly to the Hub; it is specifically for plugin access.

Initial Configuration

After activation, navigate to the Chiral Connector settings page in your WordPress admin menu and complete the initial setup.

  1. Connection Settings:
    • Hub URL: Enter the full URL of your Chiral Hub Core site (e.g., https://hub.yournetwork.com).
    • Hub Username: Enter the Chiral Porter username provided by the Hub administrator.
    • Hub Application Password: Enter the application password generated for that Porter user. This is not the user’s login password.
  2. Display Options:
    • Enable Related Posts: Check this box to automatically display related posts on article pages.
    • Number of Posts: Set how many related posts to display.
  3. Save & Test:
    • Click Save Changes.
    • Click Test Connection. If you see “Successfully connected to Hub!”, your configuration is correct.
  4. Initial Bulk Sync:
    • If your site already has many posts, click the Batch Sync All Posts button to sync all existing posts to the Hub.

FAQ

What if connection test fails?

Please troubleshoot with the following steps:

Contact the Hub admin to confirm that your credentials and Node ID are valid.

Double-check that the Hub URL is spelled correctly and includes http:// or https://.

Ensure the Hub Username and Application Password are correct and contain no extra spaces.

Make sure the Hub site is accessible and not blocked by firewalls or security plugins from exposing its REST API.

Why aren’t my posts syncing to the Hub?
  1. First, ensure the connection test passed.
  2. When joining a network for the first time, use Batch Sync All Posts to sync historical content.
  3. On the post edit screen, ensure the “Send to Chiral?” meta box is checked.
  4. Some posts may be marked as “Pending Review” on the Hub side and require approval from the administrator before being included in recommendations. Please check with your Hub admin.
Why isn’t the related posts module showing?
  1. Ensure “Enable Related Posts” is checked in the settings.
  2. It takes time for the content to sync and get indexed by WordPress.com, especially for new sites. Please wait a while after bulk sync.
  3. If your theme is very customized, it may not correctly trigger the the_content filter. You can manually insert the
    Loading related Chiral data...
     shortcode in the post content to control display position.
  4. The more content in the network, the better the quality and availability of recommendations. If content is limited, there may not be suitable articles to recommend yet.
How can I change the “Source Name” shown on other sites?

The Source Name is currently based on the display name of your Chiral Porter user on the Hub site. You need to log in to the Hub backend with your Porter user and go to Users > Profile to update it.

If the Hub site does not allow you to log in to the WordPress admin, you may request the Hub administrator to update it for you.

Why does related post loading fail with LiteSpeed?

You need to configure an exception in LiteSpeed for the related post feature to avoid conflicts between plugin cache and LiteSpeed cache. Here are the steps:

  1. Navigate to ESI settings: In your WordPress dashboard, go to LiteSpeed Cache -> Cache -> ESI tab.
  2. Enable ESI: Set the “Enable ESI” option to ON.
  3. Add Nonce to ESI list:
  4. Find the “ESI Nonces” field. Add the following nonce handle used by Chiral Connector on a new line: chiral_connector_related_posts_nonce
What happens when I click “Quit Network”?

This is a critical action. Clicking this will send a request to the Hub to delete all data associated with your Node ID. It will also clear all local connection settings and deactivate the plugin. This action is almost irreversible. After this, it is your responsibility to log in to the Hub site and verify that your data has been fully removed.