Chiral Hub Core Plugin

Introduction

Chiral Hub Core is the server-side plugin of the cross-site related post recommendation system, WP Chiral Network. It transforms a WordPress instance into a Chiral Hub and establishes a new recommendation network.

All article data from user nodes across the network is aggregated and processed by the Chiral Hub.

See more: How It Works

Download

Latest version: 1.0

Last updated: 2025-06-11

Download link: Github

Installation Guide

1. Log in to the WordPress admin dashboard
2. Go to the “Plugins > Add New” page
3. Search and install the Jetpack plugin
4. Register/log in with your Jetpack account
5. Return to the “Plugins > Add New” page
6. Click the “Upload Plugin” button
7. Select the Chiral Hub Core plugin zip file
8. Click “Install Now”
9. Once installed, click “Activate Plugin”

Initial Configuration

1. Find the “Chiral Hub” menu in the WordPress admin dashboard
2. Go to the “Settings” page and configure the following options:

• Network Name: Set a name for your Hub network
• Content Review Policy: Choose the default status (published/pending) for new articles from joined sites
• Default Related Posts Count: Set how many related posts to show per article
• Hub Transfer Mode: Enable or disable based on your needs

Adding Nodes

Chiral Hub Core cannot forcibly add a WordPress site as a node. “Adding a node” means another WordPress instance actively joins your network.

Chiral Hub Core creates a new WordPress user role—“Chiral Porter”. You should create one Chiral Porter account for each joining site and generate an application password for them.

How to Create a Chiral Porter User

1. Go to “Users > Add New”
2. Fill out the following fields:

• Username: Suggested format is “chiral_porter_xxx”
• Email: Use a valid email address
• Role: Select “Chiral Porter”

1. After creating the user, go to their profile page
2. In the “Application Passwords” section, generate a new password
3. Save and send the password to the blogger who wishes to join your network—they will use it to configure the Connector plugin.

You can allow your WordPress site to accept new user registrations and set the default role to Porter. This enables any WordPress site to self-register and complete the join process automatically.

You will see this process detailed in the Chiral Connector plugin page.

FAQ

What are the requirements for installing Chiral Hub Core?

Performance Requirements:

Chiral Hub Core collects all article data from every WordPress site in the current Chiral Network, so its database performance requirement equals the total volume of all articles across the network.

For example, if your Chiral Network has 10 sites and each site has 200 articles, then your Hub site will bear the performance load equivalent to a WordPress site with 2,000 articles when performing searches and updates.

Additionally, enabling Hub Transfer Mode will consume even more server resources.

However, Chiral Hub Core does not calculate related posts itself. Jetpack handles that, with the following data flow:

graph LR
    A[Node Site Article] --> B[Hub Site]
    B --> C[WordPress.com]
    A --> D[User Request]
    D --> C
    C --> E[Related Articles]
    E --> F[Display on Node Site]
    
    %% Labels
    B1[Content Sync<br/>via REST API]
    C1[Jetpack Sync<br/>& Indexing]
    D1[Direct API Call<br/>with hub_cpt_id]
    E1[WordPress.com<br/>Public API Response]
    
    %% Position labels
    A -.-> B1
    B1 -.-> B
    B -.-> C1
    C1 -.-> C
    D -.-> D1
    D1 -.-> C
    C -.-> E1
    E1 -.-> E
    
    %% Style with more vivid colors
    classDef nodeClass fill:#2196F3,stroke:#1976D2,stroke-width:2px,color:#fff
    classDef hubClass fill:#9C27B0,stroke:#7B1FA2,stroke-width:2px,color:#fff
    classDef wpcomClass fill:#FF9800,stroke:#F57C00,stroke-width:2px,color:#fff
    classDef processClass fill:#4CAF50,stroke:#388E3C,stroke-width:2px,color:#fff
    
    class A,D,F nodeClass
    class B hubClass
    class C,E wpcomClass
    class B1,C1,D1,E1 processClass

Jetpack Requirements:

To become a Hub site, you must install and activate the Jetpack plugin in addition to Chiral Hub Core. This requires having a Jetpack account.

How to enable related posts on the Hub site?

You need to install Chiral Connector on the same site where Chiral Hub Core is installed. Chiral Connector will activate Hub Mode, enabling your Hub site to show related posts just like a node site.

What is Hub Transfer Mode?

When enabled, all related post links shown on node sites will redirect through a 301 link hosted on the Hub. This brings extra traffic and potential SEO benefits to the Hub site, but significantly increases its performance load.

How to display related posts on the Hub site?

To show related posts on your Hub site, you must also install the Chiral Connector plugin on it.

In this scenario, Chiral Connector will activate Hub Mode.