Tusher Ikbal

<p>ZenCoupon AI Assistant is a powerful WordPress plugin that integrates with WooCommerce and AI providers to help you generate and manage coupons using simple, natural language commands.</p>
<h3>External Services</h3>
<p>This plugin connects to external AI APIs (Groq and Google Gemini) to process natural language commands and generate WooCommerce coupon configurations.</p>
<ul>
<li>Data Sent: User-provided natural language prompts describing coupon requirements. No user personal data, customer data, or store financial data is transmitted.</li>
<li>Groq AI: Service provided by Groq, Inc. Endpoint: https://api.groq.com/openai/v1/chat/completions. <a href="https://groq.com/terms-of-service/" rel="nofollow ugc">Terms of Service</a> | <a href="https://groq.com/privacy-policy/" rel="nofollow ugc">Privacy Policy</a></li>
<li>Google Gemini: Service provided by Google LLC. Endpoint: https://generativelanguage.googleapis.com/v1beta/models/. <a href="https://policies.google.com/terms" rel="nofollow ugc">Terms of Service</a> | <a href="https://policies.google.com/privacy" rel="nofollow ugc">Privacy Policy</a></li>
</ul>
<h3>Features</h3>
<ul>
<li><strong>AI-Powered Coupon Generation:</strong> Create coupons using natural language instructions</li>
<li><strong>Multiple AI Providers:</strong> Support for Groq and Google Gemini AI. Currently working with Groq AI only, others will be added soon.</li>
<li><strong>Easy Management:</strong> List, delete, and manage your AI-generated coupons</li>
<li><strong>Flexible Discount Types:</strong> Percent or fixed amount discounts</li>
<li><strong>Advanced Settings:</strong>
<ul>
<li>Minimum/Maximum cart amounts</li>
<li>Product and category restrictions</li>
<li>Email restrictions</li>
<li>Usage limits per user</li>
<li>Free shipping options</li>
<li>Expiration dates</li>
<li>Exclude sale items</li>
<li>Individual use settings</li>
</ul>
</li>
<li><strong>HPOS Compatible:</strong> Full support for WooCommerce High-Performance Order Storage</li>
<li><strong>REST API:</strong> JSON-RPC 2.0 compatible API for integration</li>
</ul>
<h3>Supported AI Providers</h3>
<p><strong>Groq AI</strong> (Recommended for speed)<br />
* Model: llama3-8b-8192<br />
* Fast inference with excellent accuracy</p>
<h3>Requirements</h3>
<ul>
<li>WordPress 5.0 or higher</li>
<li>PHP 7.4 or higher</li>
<li>WooCommerce 3.0 or higher</li>
<li>Active API key from Groq or Google Gemini</li>
</ul>
<h3>From WordPress Plugin Directory</h3>
<ol>
<li>Go to <strong>Plugins > Add New</strong> in your WordPress admin</li>
<li>Search for “ZenCoupon AI Assistant”</li>
<li>Click <strong>Install Now</strong> and then <strong>Activate</strong></li>
</ol>
<h3>Manual Installation</h3>
<ol>
<li>Download the plugin as a ZIP file</li>
<li>Go to <strong>Plugins > Add New > Upload Plugin</strong></li>
<li>Choose the ZIP file and click <strong>Install Now</strong></li>
<li>Click <strong>Activate Plugin</strong></li>
</ol>
<h3>Configuration</h3>
<h3>1. Get API Keys</h3>
<p><strong>For Groq AI:</strong><br />
* Visit <a href="https://console.groq.com" rel="nofollow ugc">console.groq.com</a><br />
* Create an account or sign in<br />
* Generate an API key</p>
<h3>2. Configure Plugin</h3>
<ol>
<li>In WordPress admin, go to <strong>WordPress Dashboard > ZenCoupon AI</strong></li>
<li>Select your preferred AI provider (Groq or Gemini)</li>
<li>Enter your API key</li>
<li>(Optional) Change the model name</li>
<li>Click <strong>Save Settings</strong></li>
</ol>
<h3>Usage</h3>
<h3>Via REST API</h3>
<p>The plugin provides a JSON-RPC 2.0 compatible REST endpoint at:<br />
    POST /wp-json/zencoupon/v1/mcp</p>
<h4>Creating a Coupon</h4>
<pre><code>`bash
</code></pre>
<p>curl -X POST <a href="https://yoursite.com/wp-json/zencoupon/v1/mcp" rel="nofollow ugc">https://yoursite.com/wp-json/zencoupon/v1/mcp</a> \<br />
  -H “Content-Type: application/json” \<br />
  -d ‘{<br />
    “jsonrpc”: “2.0”,<br />
    “id”: 1,<br />
    “method”: “create_coupon”,<br />
    “params”: {<br />
      “code”: “SAVE20”,<br />
      “amount”: 20,<br />
      “discount_type”: “percent”,<br />
      “expiry_date”: “2026-12-31”<br />
    }<br />
  }’</p>
<p>Listing Coupons:<br />
 curl -X POST <a href="https://yoursite.com/wp-json/zencoupon/v1/mcp" rel="nofollow ugc">https://yoursite.com/wp-json/zencoupon/v1/mcp</a> \<br />
  -H “Content-Type: application/json” \<br />
  -d ‘{<br />
    “jsonrpc”: “2.0”,<br />
    “id”: 2,<br />
    “method”: “list_coupons”<br />
  }’</p>
<p>Listing AI-Generated Coupons:</p>
<p>curl -X POST <a href="https://yoursite.com/wp-json/zencoupon/v1/mcp" rel="nofollow ugc">https://yoursite.com/wp-json/zencoupon/v1/mcp</a> \<br />
  -H “Content-Type: application/json” \<br />
  -d ‘{<br />
    “jsonrpc”: “2.0”,<br />
    “id”: 3,<br />
    “method”: “list_generated_coupons”<br />
  }’</p>
<p>Deleting a Coupon:<br />
  curl -X POST <a href="https://yoursite.com/wp-json/zencoupon/v1/mcp" rel="nofollow ugc">https://yoursite.com/wp-json/zencoupon/v1/mcp</a> \<br />
  -H “Content-Type: application/json” \<br />
  -d ‘{<br />
    “jsonrpc”: “2.0”,<br />
    “id”: 4,<br />
    “method”: “delete_coupon”,<br />
    “params”: {<br />
      “coupon_id”: 123<br />
    }<br />
  }’</p>
<h3>Coupon Parameters ===ParameterTypeRequiredDescriptioncodestring✓Unique coupon codeamountfloat✓Discount amountdiscount_typestring✓percent, fixed_cart, or fixed_productexpiry_datestringDate in YYYY-MM-DD formatminimum_amountfloatMinimum cart totalmaximum_amountfloatMaximum cart totalexclude_sale_itemsbooleanExclude sale items from discountindividual_usebooleanUse coupon only onceusage_limitintTotal times coupon can be usedusage_limit_per_userintTimes per customerfree_shippingbooleanGrant free shippingemail_restrictionsarrayAllowed customer emailsproduct_idsarraySpecific product IDsexcluded_product_idsarrayExcluded product IDsproduct_categoriesarraySpecific category IDsexcluded_product_categoriesarrayExcluded category IDs</h3>
<h3>Troubleshooting</h3>
<h3>“Missing API Key” Error</h3>
<p>Solution: Ensure you have:</p>
<p>Generated an API key from your chosen AI provider</p>
<p>Entered it in the plugin settings</p>
<p>Saved the settings</p>
<h3>“API returned HTTP 429” (Rate Limited)</h3>
<p>Solution:</p>
<p>The AI provider is rate-limiting your requests</p>
<p>The plugin will automatically retry with exponential backoff</p>
<p>If it persists, try switching AI providers or wait a few minutes</p>
<p>Consider upgrading your API plan with the provider</p>
<h3>“Model not found” Error</h3>
<p>Solution:</p>
<p>The model name may be deprecated</p>
<p>The plugin auto-updates deprecated models to current versions</p>
<p>Try switching between Groq and Gemini to find a working option</p>
<h3>“Invalid JSON Response” Error</h3>
<p>Solution:</p>
<p>The AI model returned unexpected format</p>
<p>This is usually temporary – try again</p>
<p>If persistent, check your API key validity</p>
<p>Consider using a different AI provider</p>
<h3>API Response Examples</h3>
<h3>Success Response</h3>
<p>{<br />
  “jsonrpc”: “2.0”,<br />
  “id”: 1,<br />
  “result”: {<br />
    “coupon_id”: 123,<br />
    “code”: “SAVE20”,<br />
    “amount”: 20,<br />
    “discount_type”: “percent”,<br />
    “message”: “Coupon created successfully.”<br />
  }<br />
}</p>
<h3>Error Response</h3>
<p>{<br />
  “jsonrpc”: “2.0”,<br />
  “id”: 1,<br />
  “error”: {<br />
    “code”: -32600,<br />
    “message”: “Coupon code is required.”<br />
  }<br />
}</p>
<h3>Security</h3>
<p>All API keys are stored encrypted in WordPress options</p>
<p>REST endpoint requires manage_shop_coupons or manage_woocommerce capability</p>
<p>Only authenticated users with proper permissions can access the API</p>
<p>HTTPS is recommended for all API calls</p>
<h3>Performance Tips</h3>
<p>Use Groq AI for faster responses (recommended)</p>
<p>Set lower temperatures (0.0-0.3) for more consistent results</p>
<p>Batch operations when creating multiple coupons</p>
<p>Monitor rate limits and adjust request frequency</p>
<h3>Contributing</h3>
<p>Contributions are welcome! Please fork the repository and submit a pull request.</p>
<h3>1.0.1</h3>
<p>Fixed unique prefix constraints and refactored plugin structure.</p>
<p>Updated text domain to match plugin slug.</p>
<p>Added missing external services disclosure for Groq and Gemini.</p>
<h3>1.0.0</h3>
<p>Initial release</p>
<p>Groq AI integration</p>
<p>WooCommerce HPOS support</p>
<p>REST API endpoint</p>
<p>Coupon management features</p>


ZenCoupon AI Assistant

Generate and manage WooCommerce coupons using AI with natural language commands.

itthinx

Kento

<p>Show coupon discount info using shortcodes. Allows to render coupon information and content conditionally, based on the validity of coupons.</p>
<p>Customers can be motivated to proceed with their purchase, offering them to use specific coupons when the contents in the cart qualify for it, or by offering them to purchase additional items so they can use a coupon.</p>
<p>This extension for <a href="https://woocommerce.com/" rel="nofollow ugc">WooCommerce</a> is a useful addition that is easy to use.</p>
<p>Works great with these premium extensions: <a href="https://woocommerce.com/products/volume-discount-coupons/" rel="nofollow ugc">Volume Discount Coupons</a>, <a href="https://woocommerce.com/products/group-coupons/" rel="nofollow ugc">Group Coupons</a> and <a href="https://www.itthinx.com/shop/woocommerce-coupons-countdown" rel="nofollow ugc">Coupons Countdown</a>.</p>
<h4>Conditional Shortcodes</h4>
<p>It provides the following conditional shortcodes that allow to enclose content which is shown if certain coupons are applied, valid or active:</p>
<pre><code>[coupon_is_active]
[coupon_is_not_active]
[coupon_is_applied]
[coupon_is_not_applied]
[coupon_is_valid]
[coupon_is_not_valid]
</code></pre>
<p>These conditional shortcodes allow to render content if any coupons are applied, valid or active:</p>
<pre><code>[coupon_has_valid]
[coupon_has_not_valid]
[coupon_has_active]
[coupon_has_not_active]
[coupon_has_applied]
[coupon_has_not_applied]
</code></pre>
<h4>Coupon Info Shortcodes</h4>
<p>It also provides shortcodes that allow to render the coupon code, its description and an automatic description of the discount:</p>
<pre><code>[coupon_code] (this one makes sense mostly when used inside one of the conditional shortcodes).
[coupon_description]
[coupon_discount]
[coupon_show]
</code></pre>
<p>A coupon iterator shortcode makes it easy to work with a set of coupons, the enclosed content is rendered for each coupon in sequence. The informational shortcodes can be used inside the content of this shortcode to display details about each coupon code.</p>
<pre><code>[coupon_iterate]
</code></pre>
<p>For example: <code>[coupon_iterate code="test,welcome,20off"][coupon_code] – [coupon_discount][/coupon_iterate]</code></p>
<p>A coupon enumerator shortcode allows to list all or a set of coupons, to show their code, description or discount information, or combinations of those using the <code>[coupon_show]</code> shortcode:</p>
<pre><code>[coupon_enumerate]
</code></pre>
<h4>Documentation</h4>
<p>Please refer to the plugin’s <a href="https://docs.itthinx.com/document/woocommerce-coupon-shortcodes/" rel="nofollow ugc">documentation pages</a> for detailed descriptions.</p>
<h4>Examples</h4>
<p>Show a text when a coupon can be used (active) – this is useful to show promotional info while coupons can be used, as active means that the coupon has not reached its expiration date nor exceeded its usage limits:</p>
<pre><code>[coupon_is_active code="eastereggs"]
Happy Easter!
Use the coupon code [coupon_code] to hop away with a great discount : [coupon_discount]
[/coupon_is_active]
</code></pre>
<p>This is an example of a text shown when a promotion is over:</p>
<pre><code>[coupon_is_not_active code="specialdiscount"]
Our special discount sale has ended. Come back often to see more!
[/coupon_is_not_active]
</code></pre>
<p>Showing a coupon when the cart contents qualify for a coupon to be applied:</p>
<pre><code>[coupon_is_valid code="superdiscount"]
You qualify for a discount!
Use the coupon code [coupon_code] to take advantage of this great discount : [coupon_discount]
[/coupon_is_valid]
</code></pre>
<p>Showing a coupon that is not valid for the current cart and motivating to add items:</p>
<pre><code>[coupon_is_not_valid code="25off"]
If you purchase 5 Widgets, you can use the coupon [coupon_code] to get 25% off your purchase!
[/coupon_is_not_valid]
</code></pre>
<p>Iterate over several coupons and show their discount info:</p>
<pre><code>[coupon_iterate code="test,welcome,20off"]
Use the Coupon Code: [coupon_code] for [coupon_discount]
[/coupon_iterate]
</code></pre>
<p>Iterate over all coupons and show their discount info:</p>
<pre><code>[coupon_iterate code="*"]
Use the Coupon Code: [coupon_code] for [coupon_discount]
[/coupon_iterate]
</code></pre>
<p>Show information about three random coupons, including the coupon code, its description and discount info together on each entry:</p>
<pre><code>[coupon_enumerate code="*" orderby="rand" number="3"]
[coupon_show show="code,description,discount"]
[/coupon_enumerate]
</code></pre>
<p>Show a single random coupon code:</p>
<pre><code>[coupon_enumerate code="*" orderby="rand" number="1"]
[coupon_code]
[/coupon_enumerate]
</code></pre>
<h4>Documentation and Support</h4>
<p>Full usage instructions and help is provided on these pages:</p>
<ul>
<li>The <a href="https://docs.itthinx.com/document/woocommerce-coupon-shortcodes/" rel="nofollow ugc">Documentation</a> pages provide detailed information.</li>
<li>Questions, feedback and suggestions can be posted on the <a href="https://www.itthinx.com/plugins/woocommerce-coupon-shortcodes/" rel="nofollow ugc">Coupon Shortcodes</a> page.</li>
<li>You can contact <a href="https://woocommerce.com/contact-us/" rel="nofollow ugc">WooCommerce Support</a> with your questions related to this extension.</li>
</ul>
<h4>Connect</h4>
<p>Join <a href="https://www.reddit.com/r/itthinx/" rel="nofollow ugc">r/itthinx</a>, follow us on <a href="https://mastodon.social/@itthinx" rel="nofollow ugc">Mastodon</a> or on <a href="https://x.com/itthinx" rel="nofollow ugc">X</a> for related news and information. Visit <a href="https://www.itthinx.com" rel="nofollow ugc">itthinx.com</a> where you can find more free and premium extensions.</p>


Coupon Shortcodes for WooCommerce

Show coupon discount info using shortcodes. Allows to render coupon information and content conditionally, based on the validity of coupons.

ZenCoupon AI Assistant vs Coupon Shortcodes for WooCommerce