Ninox – Integration for WooCommerce

Description

Ninox – Integration for WooCommerce adds a new REST API endpoint to WooCommerce that returns all products with their complete variation data in a single, optimized request.

This plugin is designed for developers, theme creators, and anyone building custom interfaces or integrations with WooCommerce who needs comprehensive product data including variations.

Key Features

  • Comprehensive Data Access: Get complete product details and all variations in a single API call
  • Performance Optimized: Batch processing and efficient queries to handle large product catalogs
  • Secure Authentication: Supports WooCommerce API key authentication and proper permission validation
  • Well-documented API: Clear documentation with example requests and responses
  • Cache Support: Intelligent caching to improve response times and reduce server load

Use Cases

  • Building custom front-end interfaces for WooCommerce stores
  • Developing mobile applications that need to display product data
  • Creating external integrations with other systems
  • Developing custom reporting tools
  • Any application that needs detailed product variation data

Technical Details

The plugin adds the following endpoint:

/wp-json/wc/v3/products-with-variations

This endpoint handles all the complex database queries needed to retrieve products with their attributes and variations in an efficient way, reducing the number of API calls your application needs to make.

API Documentation

The plugin adds the following endpoint:

Endpoint: /wp-json/wc/v3/products-with-variations
Method: GET
Required Permissions: manage_woocommerce capability or valid API key

Parameters:

Parameter
Type
Description

page
integer
Current page of the collection. Default is 1.

per_page
integer
Maximum number of items to be returned in result set. Default is 10. Max 100.

Example Response:

`json

[
{
“id”: 123,
“name”: “Sample Product”,
“description”: “Product description”,
“short_description”: “Short description”,
“sku”: “SAMPLE-1”,
“price”: “29.99”,
“regular_price”: “39.99”,
“sale_price”: “29.99”,
“stock”: 10,
“stock_status”: “instock”,
“weight”: “”,
“length”: “”,
“width”: “”,
“height”: “”,
“attributes”: [
{
“id”: 1,
“name”: “Size”,
“options”: [“S”, “M”, “L”]
}
],
“variations”: [
{
“id”: 124,
“sku”: “SAMPLE-1-S”,
“price”: “29.99”,
“regular_price”: “29.99”,
“sale_price”: “”,
“stock”: 5,
“stock_status”: “instock”,
“attributes”: [
{
“id”: 1,
“name”: “size”,
“option”: “S”
}
]
}
]
}
]
`

Headers:

When using pagination, the response includes the following headers:

  • X-WP-Total: The total number of products found
  • X-WP-TotalPages: The total number of pages

Privacy Policy

This plugin does not collect, store, or share any user data. It only retrieves product information from your WordPress database through WooCommerce’s API.

No personal information is collected or transmitted to external services. The plugin only accesses the following database information:
– Product details
– Product variations
– Product attributes
– Stock information

All data processing occurs locally within your WordPress installation.

Security

This plugin supports two authentication methods for accessing the REST API endpoint:

  1. WooCommerce API Keys (Basic Authentication)

– Create an API key pair in WooCommerce > Settings > Advanced > REST API
– Use these credentials in the Authorization header as Basic auth
– Format: Authorization: Basic base64(consumer_key:consumer_secret)

  1. WordPress User Authentication

– Users must have ‘manage_woocommerce’ capability
– Supports standard WordPress authentication methods including:
* Session-based authentication
* Cookie-based authentication
* WordPress nonces

All credentials and API keys are stored securely in the WordPress database using WordPress core security standards. No credentials are stored in plain text, and all database queries are properly prepared and sanitized.

Support

If you need help with this plugin, please visit our support forum at:
https://ninoxnet.com/contacto/

For custom development or integration assistance, please contact us at:
info@ninoxnet.com

Installation

  1. Upload the plugin files to the /wp-content/plugins/ninox-integration-for-woocommerce directory, or install the plugin through the WordPress plugins screen directly.
  2. Activate the plugin through the ‘Plugins’ screen in WordPress.
  3. Ensure WooCommerce is installed and activated.
  4. Create a WooCommerce API key with appropriate permissions to access the API.

FAQ

What permissions do I need to use this plugin?

To access the API endpoint, you need to have administrator permissions or a valid WooCommerce API key with proper credentials.

How can I get the authentication credentials?

You can create API keys from the WooCommerce admin panel:
1. Go to WooCommerce > Settings > Advanced > REST API
2. Click “Add key”
3. Set the appropriate permissions (read access is required)
4. Generate the key

How should I format the authentication in my requests?

The plugin accepts basic authentication in the format:
Authorization: Basic base64(consumer_key:consumer_secret)

Is this plugin compatible with WooCommerce blocks?

Yes, this plugin is fully compatible with WooCommerce blocks and other WooCommerce extensions as it only adds a new API endpoint and doesn’t modify any existing WooCommerce functionality.

Will this plugin slow down my site?

No. The plugin only adds a REST API endpoint that is called when specifically requested. It uses efficient database queries and includes caching to maintain good performance even with large product catalogs.

How can I customize the response format?

Currently, the plugin provides a standardized response format. If you need custom fields or a different structure, you can use WordPress filters to modify the output or contact us for custom development.

Does this plugin work with multilingual sites?

Yes, the plugin will return data in the language configured in your WordPress installation.

Does this plugin work with custom product attributes?

Yes, the plugin supports both global and product-specific custom attributes.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Ninox – Integration for WooCommerce” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.0.0

  • Initial release
  • Added REST API endpoint for products with variations
  • Implemented secure authentication
  • Added caching for improved performance
  • Added batch processing for large product catalogs