Title: Ninox – Integration for WooCommerce Author: ninoxnet Published: 2025 年 4 月 7 日 Last modified: 2025 年 7 月 1 日 --- 搜索插件 ![](https://ps.w.org/ninox-integration-for-woocommerce/assets/banner-772x250.png? rev=3267940) ![](https://ps.w.org/ninox-integration-for-woocommerce/assets/icon-256x256.png?rev =3267940) # Ninox – Integration for WooCommerce 作者：[ninoxnet](https://profiles.wordpress.org/ninoxnet/) [下载](https://downloads.wordpress.org/plugin/ninox-integration-for-woocommerce.1.0.3.zip) * [详情](https://cn.wordpress.org/plugins/ninox-integration-for-woocommerce/#description) * [评价](https://cn.wordpress.org/plugins/ninox-integration-for-woocommerce/#reviews) * [安装](https://cn.wordpress.org/plugins/ninox-integration-for-woocommerce/#installation) * [开发进展](https://cn.wordpress.org/plugins/ninox-integration-for-woocommerce/#developers) [支持](https://wordpress.org/support/plugin/ninox-integration-for-woocommerce/) ## 描述 **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 20. force_refresh string Set to ‘true’ to bypass cache and get fresh data. Optional. ### 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 ## 安装 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. ## 常见问题 ### 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. ## 评价 此插件暂无评价。 ## 贡献者及开发者 「Ninox – Integration for WooCommerce」是开源软件。 以下人员对此插件做出了贡献。 贡献者 * [ ninoxnet ](https://profiles.wordpress.org/ninoxnet/) [帮助将「Ninox – Integration for WooCommerce」翻译成简体中文。](https://translate.wordpress.org/projects/wp-plugins/ninox-integration-for-woocommerce) ### 对开发感兴趣吗? 您可以[浏览代码](https://plugins.trac.wordpress.org/browser/ninox-integration-for-woocommerce/)， 查看[SVN仓库](https://plugins.svn.wordpress.org/ninox-integration-for-woocommerce/)， 或通过[RSS](https://plugins.trac.wordpress.org/log/ninox-integration-for-woocommerce/?limit=100&mode=stop_on_copy&format=rss) 订阅[开发日志](https://plugins.trac.wordpress.org/log/ninox-integration-for-woocommerce/)。 ## 更新日志 #### 1.0.3 * Fixed critical issue where deleted product variations were still being returned * Added post_status = ‘publish’ filter to variation queries to exclude trashed variations * Enhanced force_refresh parameter functionality – now properly bypasses cache for real-time data * Added X-Data-Source response header for debugging (shows ‘cache’, ‘fresh-cached’, or ‘fresh-no-cache’) * Improved data integrity by ensuring only active variations are included in API responses #### 1.0.2 * Fixed JSON serialization issues with numeric data types * IDs and stock values are now properly returned as numbers instead of strings * Improved compatibility with .NET and other strongly-typed deserializers * Price fields remain as strings for backward compatibility * Enhanced data type consistency throughout the API response #### 1.0.1 * Added force_refresh parameter to bypass cache when needed * Improved cache key generation to exclude force_refresh parameter * Enhanced cache invalidation system * Performance optimizations in database queries * Better error handling and documentation #### 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 ## 额外信息 * 版本 **1.0.3** * 最后更新：**10 月前** * 活跃安装数量 **20+** * WordPress 版本 ** 6.4 或更高版本 ** * 已测试的最高版本为 **6.7.5** * PHP 版本 ** 7.2 或更高版本 ** * 语言 * [English (US)](https://wordpress.org/plugins/ninox-integration-for-woocommerce/) * 标签 * [ERP](https://cn.wordpress.org/plugins/tags/erp/)[products](https://cn.wordpress.org/plugins/tags/products/) [saas](https://cn.wordpress.org/plugins/tags/saas/)[variants](https://cn.wordpress.org/plugins/tags/variants/) * [高级视图](https://cn.wordpress.org/plugins/ninox-integration-for-woocommerce/advanced/) ## 评级 尚未提交反馈。 [Your review](https://wordpress.org/support/plugin/ninox-integration-for-woocommerce/reviews/#new-post) [查看全部评论](https://wordpress.org/support/plugin/ninox-integration-for-woocommerce/reviews/) ## 贡献者 * [ ninoxnet ](https://profiles.wordpress.org/ninoxnet/) ## 支持 有话要说吗？是否需要帮助？ [查看支持论坛](https://wordpress.org/support/plugin/ninox-integration-for-woocommerce/)