OnixFeed WooCommerce Plugin

The OnixFeed WooCommerce Integration plugin connects your WooCommerce store to OnixFeed, allowing you to import and sync your book catalog directly into your WordPress website.

What It Does

• Import books from OnixFeed into WooCommerce as products
• Sync contributors (authors, illustrators, editors) as custom post types
• Import publishers and reviews
• Multi-language support with language variant products
• Clean URLs like /product/book-title/afrikaans/
• Automatic cover images downloaded and attached to products

Installation

Requirements

• WordPress 5.8 or higher
• WooCommerce 5.0 or higher
• PHP 7.4 or higher
• An active OnixFeed instance

Installing the Plugin

1. Download the onixfeed-woo plugin folder
2. Upload to /wp-content/plugins/ on your WordPress site
3. Go to Plugins in WordPress admin
4. Find OnixFeed WooCommerce Integration and click Activate

Setup Wizard

After activation, the plugin guides you through setup:

1. Welcome - Overview of features
2. API Configuration - Connect to your OnixFeed instance
3. JetEngine Setup - Configure advanced relationships (optional)
4. Ready to Use - You're all set

Configuration

Navigate to OnixFeed → Settings in your WordPress admin.

API Settings

Setting	Description
OnixFeed API URL	Your OnixFeed instance URL
API Token	Authentication token
Collection Key	Which collection to sync
Test Connection	Verify your settings work

Import Settings

Setting	Description
Automatic Sync	Enable/disable scheduled imports
Sync Interval	Hourly, twice daily, or daily
Batch Size	How many items to process at once

Product Settings

Setting	Description
Download Cover Images	Automatically download and attach covers
Default Language	Fallback language for products

Integrations

Setting	Description
JetEngine Integration	Enable advanced relationships (requires JetEngine plugin)

Importing Books

Generating CSV Files

First, generate CSV files in OnixFeed:

1. In OnixFeed, go to Store Collections
2. Create or select a collection
3. Add books to the collection
4. Click Generate to create CSV files

Importing to WooCommerce

1. Go to OnixFeed → Book Import in WordPress
2. Click Refresh to see available CSV files
3. Import in this order:
   • Contributors (authors, illustrators)
   • Publishers
   • Reviews
   • Books (imports last to link everything)
4. Click Import for each file type
5. Wait for the import to complete

Import Order Matters

Always import in this order:

1. Contributors
2. Publishers
3. Reviews
4. Books

This ensures books can link to contributors, publishers, and reviews correctly.

What Gets Created

Products

Each book becomes a WooCommerce product with:

• Title and description
• Cover image
• Price and stock
• ISBN (stored as meta)
• Publisher, publication date, page count
• Language assignment
• Subject categories (Thema)
• Collection assignments

Language Variants

For multi-language books, the plugin creates:

• A primary product
• Linked variants for each language
• Clean URLs: /product/book-title/english/, /product/book-title/afrikaans/
• Language switcher buttons on product pages

Custom Post Types

The plugin creates these content types:

Type	Purpose
Contributors	Authors, illustrators, editors, translators
Publishers	Publishing companies
Reviews	Book reviews and endorsements

Taxonomies

Products are organised using:

Taxonomy	Purpose
Collections	Book series and collections
Languages	Product language
Publishers	Publisher name
Thema	Subject categories
Imprints	Publishing imprints

Shortcodes

Use these shortcodes in your theme or page builders:

Language Version Buttons

Display buttons to switch between language versions:

[language_version_buttons]

Or as a text list:

[language_version_buttons display="list"]

Author Display

Show the main author:

[onixfeed_author]

Show all authors as links:

[onixfeed_authors]

Other Contributors

Show illustrators, translators, editors, etc:

[onixfeed_other_contributors]

Collections

Show the collections a book belongs to:

[onixfeed_collections]

Translated Title

For language taxonomy pages, show the translated title:

[onixfeed_translated_title]

Language Support

OnixFeed WooCommerce supports all 11 South African official languages:

Code	Language
eng	English
afr	Afrikaans
zul	isiZulu
xho	isiXhosa
nso	Sepedi (Northern Sotho)
tsn	Setswana
sot	Sesotho (Southern Sotho)
ven	Tshivenḓa
tso	Xitsonga
ssw	siSwati
nbl	isiNdebele

JetEngine Integration

If you have JetEngine installed, the plugin creates advanced relationships:

Relationship	Purpose
Product ↔ Contributors	Links books to multiple authors
Product ↔ Publishers	Links books to publishers
Product ↔ Reviews	Links books to reviews
Contributor ↔ Reviews	Links reviewers to their reviews

This enables powerful queries and displays, such as:

• Author archive pages showing all their books
• Publisher pages with complete catalogs
• Dynamic relationship grids

Tools

Navigate to OnixFeed → Tools for additional features:

Shortcode Instructions

Documentation for all available shortcodes with examples.

Language Translated Titles

Configure how language taxonomy terms display their translated names.

Troubleshooting

Connection Failed

• Check your API URL is correct (include https://)
• Verify your API token is valid
• Ensure your OnixFeed instance is accessible
• Try the Test Connection button

Import Not Starting

• Refresh the CSV file list first
• Ensure files were generated in OnixFeed
• Check WordPress error logs for issues

Missing Cover Images

• Enable Download Cover Images in settings
• Verify source images are accessible
• Check WordPress has write permissions to uploads folder

Products Not Linking

• Import in the correct order (Contributors → Publishers → Reviews → Books)
• Re-import books after importing other content

Language Variants Not Working

• Ensure products have language taxonomy assigned
• Set up upsells between language variants
• Use the [language_version_buttons] shortcode

Best Practices

1. Import order - Always follow the recommended import order
2. Test first - Import a small batch before doing a full sync
3. Regular syncs - Set up automatic sync to keep your store current
4. Backup first - Back up your WordPress database before large imports
5. Check products - Review imported products to ensure quality

---

Previous: ONIX Reference