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.

Brian

<blockquote>
<p><strong>Support on WordPress.org</strong> is for troubleshooting bugs and related issues. The forums are monitored and replied to within one week’s time.</p>
<p>If you are looking for direct support please check out <a href="http://cctor.link/JIGHR" rel="nofollow ugc">Coupon Creator Pro</a></p>
</blockquote>
<p><strong>Coupon Creator now includes a Coupon Block to display single coupons or a loop of coupons with options to align and order them.</strong></p>
<p>Create your own coupon with the Coupon Creator for WordPress or upload an image of a coupon instead.</p>
<p><a href="http://cctor.link/IjIV1" rel="nofollow ugc">Check out a demo gallery of Coupon Creator Features!</a></p>
<p>Watch this quick video to see the Coupon Creator in Action:</p>
<p><span class="embed-youtube" style="text-align:center; display: block;"><iframe loading="lazy" class="youtube-player" width="750" height="422" src="https://www.youtube.com/embed/aGoxJ3TBRhk?version=3&rel=1&showsearch=0&showinfo=1&iv_load_policy=1&fs=1&hl=en-US&autohide=2&wmode=transparent" allowfullscreen="true" style="border:0;" sandbox="allow-scripts allow-same-origin allow-popups allow-presentation allow-popups-to-escape-sandbox"></iframe></span></p>
<h4>Coupon Creator Add-ons 3.5 Features Include: (included with Pro Business and higher license levels)</h4>
<ul>
<li>Email Delivery — send coupons directly to visitors via email with templates for all 6 coupon types</li>
<li>Email Gate — require an email address to view a coupon, building your list while distributing deals</li>
<li>Email logging with GDPR-compliant anonymization, configurable retention, and deliverability health checks (SPF, blacklist, SMTP)</li>
<li>Multiprint to select multiple coupons to print all at once</li>
<li>Block Editor Support for couponloop with Vendor and Location Taxonomies</li>
<li>Reveal Code & Dynamic Code Feature</li>
<li>Vendor and Location Taxonomies</li>
<li>Modern, Highlight, Lower Third, and Two-Column Advanced Templates</li>
<li>Create and Display WooCommerce Coupons from the Coupon Creator Editor</li>
</ul>
<h4>Coupon Creator Pro 3.5 Features Include:</h4>
<ul>
<li>Block Editor support for couponloop shortcode and all of its attributes</li>
<li>[couponloop] shortcode, filter bar, and template system, to give you control over customizations without losing changes on updates</li>
<li>Order the filter bar filters and hide any filter per shortcode</li>
<li>Quick and Bulk edits for the expiration and counter fields</li>
<li>Border themes, Dotted Border, Stitched Border, Saw Tooth Border (modern browsers and IE 10+), and None Option</li>
<li>Recurring Expiration; set an expiration for the end of the month and have it automatically change to the end of the next month</li>
<li>X Days expiration to set a period to redeem a coupon from the day of printing it</li>
<li>Range expiration to display a start and end date for the coupon to be valid such as valid 11/11/17 thru 12/11/17</li>
<li>Ability to insert columns and rows into the content editor. Options include, two column combinations, three column combinations, four columns, and rows</li>
<li>Pro Inserter has the ability to search coupons and categories in the dropdown</li>
<li>Visual editor to easily style the term’s content on your site</li>
<li>Display the Print View in a Popup for any coupons and print directly from the Popup</li>
<li>Use the View Shortcodes to display content in the Shortcode View or the Print View only</li>
<li>Set a Counter per coupon to expire the coupon after a limit has been reached or use as an unlimited counter</li>
<li>Change “Expires on:”, “Click to Open in Print View”, and “Print the Coupon” for all coupons</li>
<li>Set coupon size for the Shortcode View and the Print View for all coupons including the Image Coupon</li>
<li>Override “Click to Open in Print View” text and link per coupon</li>
<li>Override “Print the Coupon” text and link per coupon</li>
<li>Disable the Print View per coupon</li>
<li>Add your Google Analytics Code to the Print Template from the Coupon Options</li>
<li>Print Only Text and Images, they show only once a single coupon is printed.</li>
</ul>
<h4>How to Create a Coupon</h4>
<p>Create a coupon by going to the coupon custom post type and filling in all the settings in the custom meta box.</p>
<p>Insert the coupon into a post or page using the shortcode inserter above the content editor.</p>
<p>Coupon displays until the expiration date that is chosen by you or you can check the Ignore Expiration Checkbox and the coupon will display on the site past the expiration date or with no date at all.</p>
<h4>Coupon Creator Shortcode</h4>
<p>The Coupon Shortcode:<br />
    [coupon couponid=”xx” category=”Category Name(optional)” coupon_align=”cctor_aligncenter” name=”Coupon Name”]</p>
<p>Manually replace fields in shortcode:</p>
<p>couponid – replace xx with ID of Coupon custom post</p>
<p>couponalign – align coupon options:  cctor_aligncenter,  cctor_alignnone,  cctor_alignleft, and  cctor_alignright</p>
<p>name -optional and for your reference only</p>
<h4>Coupon Loop</h4>
<p>Set couponid to “loop” to display all coupons. (couponid=”loop”)</p>
<p>All the coupons in the loop will use the same couponalign.</p>
<h4>Coupon Categories</h4>
<p>Assign categories to a coupon using the loop option only to display coupons from a specific category.</p>
<p>category – add the category name to display coupons only from it</p>
<p>For example, if you have a category called “Coupon Home Page”, call it by:</p>
<p>category=”Coupon Home Page”</p>
<h4>Coupon Shortcode Inserter</h4>
<p>Above the post editor, click the “Add Coupon” button to open the inserter.</p>
<p>Select an individual coupon or coupon loop.</p>
<p>If you select the coupon loop, an option will appear to select a coupon category for the loop or you can leave it blank for all coupons (default).</p>
<p>The third option to select is the couponalign.</p>
<p>Once you have all the options selected, press “Insert Coupon” to insert the shortcode into the editor.</p>
<h4>Examples</h4>
<p>Find examples of coupons on the <a href="http://cctor.link/JIGHR" rel="nofollow ugc">Coupon Creator Home Page</a></p>
<h4>Coupons in Text Widgets</h4>
<p>Coupons will work in Sidebar Text Widgets, but you must add</p>
<p>add_filter(‘widget_text’, ‘do_shortcode’);</p>
<p>To your theme’s function.php</p>
<h4>Coupon Options</h4>
<p>On the options page set default colors for new coupons.</p>
<p>Another option for nofollow on the links and templates along with an option to hide the click to print link.</p>
<p>You can add custom css in the options and it will modify both the shortcode coupon and the print template.</p>


Coupon Creator

Stoked: straightforward and easy to use. Nice work!

Does what it says on the tin

Installation and setup was quick and easy. Help documentation is easily accessible, and the developer is responsive and open to feedback. No WP_DEBUG messages and works as expected.

Thanks for this free plugin!

Works as expected

Create coupons to display on your site by using a shortcode.

ZenCoupon AI Assistant vs Coupon Creator