REST API for Relevanssi vs UCP Adapter For WooCommerce

This plugin provides simple REST API for the popular search WordPress search engine – Relevanssi. As far as this plugin provides API for the Relevanssi plugin, it should be installed. Key features Search through posts of a certain type. By default all types. Results in pagination and optional. Sets X-WP-Total header with a total number of records, the same way as the default search API does. Sets X-WP-TotalPages header with a total number of pages, the same way as the default search API does. Multilingual websites support. Both WPML and Polylang are supported, but not tested well, so let me know if you will find any problems. Taxonomy filters are supported now. Some features may be missed, so feel free to report them. Ordering option added. It is also possible to order by meta_key/meta_value/meta_value_num. Brief usage examples https://[your domain]/wp-json/relevanssi/v1/search?keyword=query https://[your domain]/wp-json/relevanssi/v1/search?keyword=query&per_page=5 https://[your domain]/wp-json/relevanssi/v1/search?keyword=query&per_page=5&page=2 Define post type: https://[your domain]/wp-json/relevanssi/v1/search?keyword=query&per_page=5&page=2&type=post Filter by taxonomy/taxonomies: https://[your domain]/wp-json/relevanssi/v1/search?keyword=test&tax_query[0][taxonomy]=category&tax_query[0][field]=id&tax_query[0][terms]=3 https://[your domain]/wp-json/relevanssi/v1/search?keyword=test&tax_query[relation]=AND&tax_query[0][taxonomy]=category&tax_query[0][field]=id&tax_query[0][terms]=3&tax_query[1][taxonomy]=category&tax_query[1][field]=id&tax_query[1][terms]=2 Exclude category via taxonomies: https://[your domain]/wp-json/relevanssi/v1/search?keyword=test&tax_query[0][taxonomy]=category&tax_query[0][field]=id&tax_query[0][terms]=3&tax_query[0][operator]=NOT IN For multilingual websites (WPML & Polylang): https://[your domain]/wp-json/relevanssi/v1/search?keyword=query&lng=en Results in order: https://[your domain]/wp-json/relevanssi/v1/search?keyword=test&type=post&orderby=modified&order=DESC https://[your domain]/wp-json/relevanssi/v1/search?keyword=test&type=post&orderby=modified&order=ASC https://[your domain]/wp-json/relevanssi/v1/search?keyword=test&type=post&meta_key=some_key&orderby=meta_value|meta_value_num&order=ASC Demo website You can try the plugin on our demo website http://demo.erlycoder.com/demo1/. For example, you can try the following request: Basic: http://demo.erlycoder.com/demo1/wp-json/relevanssi/v1/search?keyword=test Order posts by modification time: http://demo.erlycoder.com/demo1/wp-json/relevanssi/v1/search?keyword=test&type=post&orderby=modified&order=DESC http://demo.erlycoder.com/demo1/wp-json/relevanssi/v1/search?keyword=test&type=post&orderby=modified&order=ASC Filter posts by taxonomy (one single category): http://demo.erlycoder.com/demo1/wp-json/relevanssi/v1/search?keyword=test&tax_query[0][taxonomy]=category&tax_query[0][field]=id&tax_query[0][terms]=3 Filter posts by taxonomy (exclude category): [http://demo.erlycoder.com/demo1/wp-json/relevanssi/v1/search?keyword=test&tax_query[0][taxonomy]=category&tax_query[0][field]=id&tax_query[0][terms]=3&tax_query[0][operator]=NOT IN](http://demo.erlycoder.com/demo1/wp-json/relevanssi/v1/search?keyword=test&tax_query[0][taxonomy]=category&tax_query[0][field]=id&tax_query[0][terms]=3&tax_query[0][operator]=NOT IN)

UCP Adapter For WooCommerce is a powerful WordPress plugin that provides REST API endpoints for Universal Commerce Platform (UCP) integration. It enables seamless communication between your WordPress site and external commerce platforms through secure, standardized API endpoints. Thank you for using our plugin! This add-on connects your WordPress site to the powerful world of WordPress’s Agentic Commerce, allowing you to create automated shopping assistants for your users. 🚀 Core Features Our plugin leverages WordPress’s MCP (Model Context Protocol) servers plugin and the open Universal Commerce Protocol (UCP) standard to enable secure, intelligent commerce actions. Here’s what you can build: Smart Product Discovery: Enable agents to search products across WordPress merchants, apply filters, and display interactive product cards directly within a chat interface on your site. Seamless Checkout: Allow agents to create checkout sessions, collect buyer information, attach payment details, and complete purchases on behalf of users. Order Tracking: After a purchase, agents can track order status, fulfillment updates, and post-purchase events like refunds or returns. 🔗 How It Works The plugin acts as a Platform within the UCP framework, facilitating secure communication between your users (buyers), WordPress Merchants, and payment or credential providers. It implements these key UCP capabilities: Discovery → Checkout: An agent can help a user find a product and instantly retrieve the necessary details to start a checkout session. Checkout Completion: The agent can securely submit the checkout. If further user action is needed, it can gracefully open a web checkout page. Post-Purchase: The agent provides ongoing value by fetching real-time updates on order delivery and status changes. 💡 Use Case Example Imagine a user in your site’s chat asking, “Find me a red coffee mug under $20.” The plugin-powered agent can: * Query the WordPress Catalog across multiple stores. * Return filtered, interactive results. * Guide the user through selecting a variant, adding it to cart, and checking out—all without leaving your WordPress environment. * Get this client https://github.com/dhirajpatra/adk-agent-gcp/tree/main/ai-agents-adk/ucp_recommendation_system to connect your site with AI agent. Key Features Session Management: Create and manage user sessions with automatic expiration REST API Endpoints: Three core endpoints (Session, Update, Complete) for UCP communication Security First: API key authentication, rate limiting, and IP whitelisting Developer Friendly: Clean, extensible code following WordPress coding standards Extensible: Hooks and filters throughout for custom implementations Admin Interface: Easy-to-use settings and session monitoring dashboard Database Storage: Efficient session storage with automatic cleanup REST API Endpoints POST /wp-json/ucp/v1/session – Create a new session PUT /wp-json/ucp/v1/update/{session_id} – Update session data POST /wp-json/ucp/v1/complete/{session_id} – Complete a session GET /wp-json/ucp/v1/status/{session_id} – Check session status GET /wp-json/ucp/v1/sessions – List all sessions GET /wp-json/ucp/v1/product/search – Search for products Use Cases E-commerce platform integration Third-party checkout systems Payment gateway connections Order management systems Multi-platform commerce solutions Developer Resources Build custom UCP adapters for platforms like: * Custom e-commerce solutions * Membership plugins * Digital product handlers * MemberPress API Documentation Create Session Endpoint: POST /wp-json/ucp/v1/session Headers: Content-Type: application/json X-UCP-API-Key: your-api-key Body: json { "platform": "woocommerce", "user_data": { "user_id": 123, "email": "[email protected]" } } Response: json { "success": true, "session_id": "ucp_abc123...", "expires_at": 1234567890, "message": "Session created successfully." } Update Session Endpoint: PUT /wp-json/ucp/v1/update/{session_id} Body: json { "action": "add_item", "data": { "product_id": 456, "quantity": 2 } } Complete Session Endpoint: POST /wp-json/ucp/v1/complete/{session_id} Body: json { "status": "completed", "metadata": { "order_id": 789 } } List Sessions Endpoint: GET /wp-json/ucp/v1/sessions Parameters: * page: Page number (optional, default 1) * limit: Results per page (optional, default 10) Response: json { "success": true, "data": [ { "session_id": "ucp_abc123...", "status": "active", "created_at": "2024-01-01 12:00:00", "expires": 1234567890 } ], "meta": { "page": 1, "limit": 10, "total": 5 } } Product Search Endpoint: GET /wp-json/ucp/v1/product/search Parameters: * search: Search query (required) * page: Page number (optional, default 1) * limit: Results per page (optional, default 10) Response: json { "success": true, "data": [ { "id": 123, "name": "T-Shirt", "price": "20.00", "image": "https://example.com/image.jpg", "permalink": "https://example.com/product/t-shirt" } ], "meta": { "page": 1, "limit": 10, "search": "shirt", "count": 1 } } Actions Available add_item – Add an item to the session update_item – Update an existing item remove_item – Remove an item from the session set_data – Set custom session data Custom actions via filters Privacy Policy UCP Adapter For WooCommerce stores session data temporarily in your WordPress database. This data is automatically cleaned up based on your configured retention settings. The plugin does not send any data to external services. Session data may include: * User identifiers * Platform information * Custom data provided via API calls It is your responsibility to ensure compliance with privacy regulations (GDPR, CCPA, etc.) when using this plugin. Credits Developed with WordPress coding standards and best practices in mind. Support Support Forum: https://wordpress.org/support/plugin/ucp-adapter-for-woocommerce