Title: MH Free Gifts for WooCommerce Author: mediahub Published: 7 اکتبر 2025 Last modified: 3 آگوست 2026 --- جستجوی افزونه‌ها ![](https://ps.w.org/mh-free-gifts-for-woocommerce/assets/icon-256x256.png?rev=3374213) # MH Free Gifts for WooCommerce توسط [mediahub](https://profiles.wordpress.org/mediahub/) [دانلود](https://downloads.wordpress.org/plugin/mh-free-gifts-for-woocommerce.1.1.6.zip) * [جزئیات](https://fa.wordpress.org/plugins/mh-free-gifts-for-woocommerce/#description) * [نقد و بررسی‌ها](https://fa.wordpress.org/plugins/mh-free-gifts-for-woocommerce/#reviews) * [نصب](https://fa.wordpress.org/plugins/mh-free-gifts-for-woocommerce/#installation) * [توسعه](https://fa.wordpress.org/plugins/mh-free-gifts-for-woocommerce/#developers) [پشتیبانی](https://wordpress.org/support/plugin/mh-free-gifts-for-woocommerce/) ## توضیحات **MH Free Gifts for WooCommerce** gives store owners a powerful yet intuitive way to reward customers with complimentary products based on custom cart rules. ### ✨ Key Features * 💯 **COMPLETELY FREE** — no upsells or pro version. 100% functional out of the box. * 🎁 **Add Multiple Free Gift Rules** — create unlimited gift rules with different conditions and products. * 🤖 **Auto-add Single Gift Rules** — automatically add a qualifying gift to the cart when the rule is met, including repeated copies when quantity multiples apply. * 1️⃣ **Optional Non-Stacking Mode** — limit customers to gifts from one eligible rule at a time when multiple rules qualify. * 🔁 **Quantity-Based Gift Multiples** — scale the number of allowed gifts as customers hit higher cart-quantity multiples. * 🎯 **Dependency-Scoped Thresholds** — optionally count quantity and subtotal thresholds against only the matching dependency items instead of the whole cart. * 🧭 **Configurable Checkout Placement** — choose where the free gift section appears on classic WooCommerce checkout. * ✍️ **Custom Gift Text & Sizing** — change main gift labels and control button/ heading font sizes without editing code. * ⚙️ **Smart Rule Conditions & Limits** — restrict by subtotal, quantity, date range, product, or user. * 🧩 **WooCommerce Blocks Support** — supports both classic and block-based cart and checkout, including shared gift-rule logic and block-aware gift panels. * 🚀 **Lightweight & Optimized** — uses a dedicated database table for speed and reliability. ### 🛒 How It Works 1. Define your free gift rules in the admin — choose eligible products, usage limits, and visibility options. 2. Choose whether subtotal and quantity thresholds should use the whole cart or only the dependency-matching products when you want rules like “buy 2 from category X”. 3. Customers who qualify see a responsive **“Choose Your Free Gift”** section on the cart (and optionally checkout) page. 4. Customers can either choose a gift manually or let a single-gift rule auto-add it to the cart at $0. 5. MH Free Gifts handles all validation and limits automatically. Behind the scenes, the plugin intelligently evaluates cart contents, enforces limits, and prevents abuse — creating a **seamless, self-contained gifting experience** that enhances WooCommerce’s promotion capabilities without extra plugins or conflicts. ### Free Gift Admin settings General Settings * **Status** (Active or Disabled) * **Rule Name** (name it something meaningful) – only for admin use * **Description** (describe your rule) – only for admin use * **Select Gifts** (Select 1 or more gifts you would like in your gift rule) * **Auto-add Gift** (Automatically adds the selected gift to the cart when the rule is met. Requires exactly 1 selected gift and uses a base quantity of 1) Display Settings * **Display Gifts On** (Toggle between Cart or Cart/Checkout mode)*** Items Per Row (Cart)** (decide how many items in a row you want displayed) Usage Restrictions * **Product Dependency** (Lock down rule to only allow free gifts to activate if any of these products are in the cart) * **Product Category Dependency**( Limit rule to selected categories) * **Threshold Scope** (Choose whether Cart Subtotal, Cart Quantity, and quantity multiples use the whole purchased cart or only items matching the selected product/category dependencies. Example: if your rule is set to Cart Quantity >= 2 and a category dependency is set, Whole Purchased Cart qualifies with 1 matching item + 1 non-matching item, while Matching Dependency Items Only requires 2 matching items.) * **User Dependency** (Limit the rule to individual customers) * **Registered Users** Only (Only allowed existing customers to activate the rule) * **Number of Gifts Allowed** (Restrict the number of gifts a customer can add to their cart) * **Cart Subtotal** (Is Less Than, Is Greater Than, Is Less Than or Equal To, Is Greater Than or Equal To, Is Equal To) Set you Subtotal threshold amount * **Cart Quantity** (Is Less Than, Is Greater Than, Is Less Than or Equal To, Is Greater Than or Equal To, Is Equal To) Set you Quantity threshold amount *** Repeat Gifts For Quantity Multiples** (Scales the Number of Gifts Allowed for each qualifying Cart Quantity multiple) * **Valid From** (Set valid from date) * **Valid To** (Set valid to date) Usage Limits * **Usage Limit per Rule** (Limits how many time the gift rule can be used) * **Usage Limit per User** (Limits how many times an individual user can use the gift rule) Plugin Settings * **Allow Gift Accumulation**( When disabled, customers can keep gifts from only one eligible rule at a time) *** Checkout Placement** (Choose the classic WooCommerce checkout hook used for the free gift toggle) * **Cart Heading Text** (Customize the main “Choose Your Free Gift” heading) * **Checkout Toggle Text** (Customize the classic checkout toggle label, for example “Free Gift”) * **Checkout Accordion Default State** (Choose whether the classic checkout Free Gift accordion loads open or closed) * **Add Button Text**( Customize the add button label) * **Remove Button Text** (Customize the remove button label) * **Cart Heading Font Size** (Adjust the cart/section heading size) * **Checkout Toggle Font Size** (Adjust the classic checkout toggle size) * **Button Font Size**( Adjust the Add/Remove button text size) * **Button Text / Background / Border Colors**( Style the gift buttons) * **Button Border Size** (Adjust button border thickness)*** Button Border Radius** (Adjust button corner roundness) ### License This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/gpl-2.0.html ## عکس‌های صفحه [⌊The “Choose Your Free Gift” section on the WooCommerce cart page.⌉⌊The “Choose Your Free Gift” section on the WooCommerce cart page.⌉[ The “Choose Your Free Gift” section on the WooCommerce cart page. [⌊Free Gift section at checkout. Can remove & add gifts here also.⌉⌊Free Gift section at checkout. Can remove & add gifts here also.⌉[ Free Gift section at checkout. Can remove & add gifts here also. [⌊Add/Edit Rule page in Admin⌉⌊Add/Edit Rule page in Admin⌉[ Add/Edit Rule page in Admin [⌊Settings for custom button styles⌉⌊Settings for custom button styles⌉[ Settings for custom button styles [[ ## نصب 1. Login to your WordPress admin. 2. Navigate to “Plugins > Add New”. 3. Type “Free Gifts” into the Keyword search box and press the Enter key. 4. Find the “MH Free Gifts for WooCommerce” plugin. Note: the plugin is made by “mediahub”. 5. Click the “Install Now” button. 6. Click the “Activate” button. 7. Navigate to “Free Gifts” to add and maintain free gifts. ## سوالات متداول ### Does it work with WooCommerce Blocks? Yes — MH Free Gifts for WooCommerce supports WooCommerce Cart and Checkout blocks for the core gift-rule logic, manual gift panel, auto-add behavior, and quantity locking. Classic checkout hook placement and toggle settings remain classic-checkout- only. ### Can I create multiple gift rules? Absolutely! You can define unlimited rules, each with unique conditions and eligible products. ### Can I limit gifts per user or order? Yes — the plugin supports per-user and per-rule usage limits. ### Is it really free? Yes! There’s no premium version or upsells. Everything is included for free. ### What do I do if I need help? Support is provided via the WordPress.org forums or through the Mediahub support site. ## نقد و بررسی‌ها ![](https://secure.gravatar.com/avatar/2c05ca1f201ab4355272516a141b9b61cfea73ed1d1dd7c0acc0c0186f7158b5? s=60&d=retro&r=g) ### 󠀁[Excellent and powerful plugin](https://wordpress.org/support/topic/excellent-and-powerful-plugin-2/)󠁿 [ozviewer](https://profiles.wordpress.org/ozviewer/) 16 آگوست 2026 1 پاسخ I did not have a straightforward use case and I tried with other plugins. This was the only one that worked. The quality of the plugin together with the well written guide was very impressive. ![](https://secure.gravatar.com/avatar/14bcf62ed3511f7b1d85679337abefa1da91168df30e58e4f8002126f6b7c147? s=60&d=retro&r=g) ### 󠀁[What I needed!](https://wordpress.org/support/topic/what-i-needed-66/)󠁿 [hamedataei](https://profiles.wordpress.org/hamedataei/) 31 جولای 2026 1 پاسخ This is such a wonderfull plugin and the support is great. thank you for this! ![](https://secure.gravatar.com/avatar/d38e52bd6989b715b87c27b5ecc14e3a8e619a3127b8a81fe04aa5183da08024? s=60&d=retro&r=g) ### 󠀁[The BEST free BOGO free gift plugin!](https://wordpress.org/support/topic/the-best-free-bogo-free-gift-plugin/)󠁿 [john](https://profiles.wordpress.org/johnq8686/) 1 آوریل 2026 I have been using Wordpress for over 10 years. Usually, the developers put the features you really want only in the PRO version. This plugin doesn't even HAVE a pro version! It's entirely free! And even better – the developer included 2 of my feature requests in a few days after posting on the WP support forum! INCREDIBLE SUPPORT. This plugin is incredibly easy to use! This plugin allows you to create free gifts for your customer to choose based on criteria. In my shop, I set up the logic for this plugin as: For every 2 gifts a customer purchases in X product category only, they will get a free product from a list (of my choosing) in the cart/checkout page. They will get 1 gift for 2 items, 2 gifts for 4, 3 for 6, and so on. Many options to tweak. ![](https://secure.gravatar.com/avatar/1847769d3f712dd8441a7d1d5499753017943ea0d0940195124450b80cf91328? s=60&d=retro&r=g) ### 󠀁[Simple & Effective](https://wordpress.org/support/topic/simple-effective-227/)󠁿 [godthor](https://profiles.wordpress.org/godthor/) 29 مارس 2026 It's easy to setup and doesn't hide essential features behind a paywall for a pro version. It just works well without all the BS. [ خواندن تمامی 4 نقد و بررسی‌ ](https://wordpress.org/support/plugin/mh-free-gifts-for-woocommerce/reviews/) ## توسعه دهندگان و همکاران “MH Free Gifts for WooCommerce” نرم افزار متن باز است. افراد زیر در این افزونه مشارکت کرده‌اند. مشارکت کنندگان * [ mediahub ](https://profiles.wordpress.org/mediahub/) [ترجمه “MH Free Gifts for WooCommerce” به زبان شما.](https://translate.wordpress.org/projects/wp-plugins/mh-free-gifts-for-woocommerce) ### علاقه‌ مند به توسعه هستید؟ [کد را مرور کنید](https://plugins.trac.wordpress.org/browser/mh-free-gifts-for-woocommerce/)، [مخزن SVN](https://plugins.svn.wordpress.org/mh-free-gifts-for-woocommerce/) را بررسی کنید، یا از طریق [RSS](https://plugins.trac.wordpress.org/log/mh-free-gifts-for-woocommerce/?limit=100&mode=stop_on_copy&format=rss) در [گزارش توسعه](https://plugins.trac.wordpress.org/log/mh-free-gifts-for-woocommerce/) مشترک شوید. ## گزارش تغییرات #### 1.1.6 (2026-07-31) * [Improved] Classic cart gift additions and removals now refresh through WooCommerce AJAX instead of reloading the full page, with a fallback refresh only if the cart AJAX cycle fails. #### 1.1.5 (2026-07-31) * [Added] New classic checkout setting to have the Free Gift accordion load open by default, helping customers notice available gifts. #### 1.1.4 (2026-07-13) * [Improved] Confirmed compatibility and updated plugin metadata for WordPress 7.0.1. #### 1.1.3 (2026-07-06) * [Fixed] Free gift line items now stay one-time only when subscription plugins are active, preventing customers from switching gifts into recurring subscription items. * [Improved] Subscription purchase selectors are now hidden on free-gift rows in the cart so recurring options are not shown for gifts. * [Fixed] The admin rule form now safely handles new-rule screens without throwing null date warnings. #### 1.1.2 (2026-07-06) * [Fixed] Admin gift-product search now uses a direct WooCommerce-safe lookup for products and variations, preventing 500 errors on some sites when selecting gifts in the rule editor. * [Improved] Variation gifts can now be found by SKU or parent product title in the admin selector, and invalid product rows are skipped safely instead of breaking the AJAX response. #### 1.1.1 (2026-03-31) * [Fixed] Rules can now scope Cart Quantity and Cart Subtotal thresholds to dependency- matching items, so offers such as “buy 2 from category X” no longer qualify with 1 item from category X plus 1 from another category. * [Improved] Quantity-multiple gift scaling now follows the same dependency-scoped quantity basis when that rule option is enabled. * [Improved] The rule editor now includes a Threshold Scope setting and only shows it when product or category dependencies are configured, making quantity-based dependency rules clearer to set up. * [Fixed] Upgraded installs now explicitly add the new Threshold Scope database column if dbDelta misses it, so dependency-scoped quantity and subtotal rules persist correctly after plugin updates. * [Fixed] Rule saves now retry after forcing the latest schema upgrade and show an admin error notice instead of silently failing when the rules table is missing a required column. * [Fixed] Dependency-scoped category rules now correctly recognize variation products by using the parent product categories during rule evaluation. * [Improved] Threshold Scope help text now includes whole-cart versus dependency- only examples so quantity-based category rules are easier to understand. * [Improved] Busy rule-editor help text is now being moved into compact info-icon tooltips, starting with the category dependency and Threshold Scope fields. * [Improved] Expanded compact info-icon tooltips to other long rule-form descriptions, including gift selection, auto-add, cart layout, gift quantity, and quantity- multiple guidance. * [Improved] Threshold Scope tooltip wording has been simplified with shorter whole- cart versus dependency-only examples. #### 1.1.0 (2026-03-26) * [Added] Per-rule Auto-add Gift support for single-gift promotions. * [Added] Global setting to disable gift accumulation so customers can keep gifts from only one eligible rule at a time. * [Added] Per-rule gift quantity multipliers for Cart Quantity thresholds such as 2 items = 1 gift, 4 items = 2 gifts, 6 items = 3 gifts. * [Fixed] Quantity-multiplied gift rules now support selecting multiple copies of the same gift product instead of treating repeated selections as a single gift. * [Fixed] Quantity-based gift multipliers now ignore gift line items in the cart, and the non-accumulation setting now blocks stacking across rules without blocking multiple gifts within the same eligible rule. * [Fixed] Gift eligibility is now re-pruned during the same cart recalculation cycle when cart quantities drop, so excess gifts are removed immediately when the rule no longer allows them. * [Fixed] Rule edits now bump the frontend rules revision so changes such as enabling auto-add gift take effect immediately in cart and checkout sessions. * [Improved] Auto-add rules can now work with Repeat Gifts For Quantity Multiples, automatically adding multiple copies of the single configured gift product as cart quantity increases. * [Added] Checkout placement setting for classic WooCommerce checkout, plus customizable cart/checkout gift labels and button/heading font sizes from the plugin settings page. * [Fixed] Classic checkout gift toggle arrows now point in the correct direction, and the settings live preview now appears lower on the settings page with the button styling controls. * [Fixed] Initial checkout loads and checkout refreshes now keep the Free Gift toggle arrow and expanded/collapsed panel state in sync instead of reopening the panel with the wrong icon state. * [Improved] Classic cart and checkout free-gift rows now hide the $0.00 price display and show a cleaner bold italic “Free gift” label under the product name. * [Improved] WooCommerce Blocks gift rows now match the classic free-gift presentation more closely, block panels can show inactive manual tiers as disabled cards, and rule display location is now respected when rendering cart versus checkout gifts. * [Improved] Confirmed compatibility and updated plugin metadata for WordPress 6.9.4. * [Improved] In non-stacking mode, auto-added gifts now prefer the highest qualifying tier instead of the first matching rule. * [Improved] Auto-added gifts are hidden from the manual selector UI and locked to a quantity of 1. * [Fixed] Registered-users-only rules now stay hidden for guest customers on checkout and AJAX-rendered gift sections. * [Fixed] Variation gifts now map correctly in the cart for selector state and cleanup. #### 1.0.12 (2026-02-08) * [Improved] Gift eligibility calculations to exclude free gifts and respect tax- inclusive totals. * [Improved] Gift grid layout when multiple rules are active. * [Fixed] Incorrect gift rule activation after adding a free gift in some scenarios. #### 1.0.11 (2026-01-15) * [Fixed] Improved rule date handling #### 1.0.10 (2026-01-05) * [Fixed] Cart Evaluation flow upgraded #### 1.0.9 (2025-11-13) * [Fixed] Gift wasn’t being removed from cart when threshold was no longer met * [Fixed] State change fix on checkout page #### 1.0.8 (2025-10-17) * [Added] Category dependancy functionality #### 1.0.7 (2025-10-16) * [Added] Color picker added to color fields [Fixed] Button preview when no radius applied #### 1.0.6 (2025-10-15) * [Added] Button Styling functionality in plugin settings [Fixed] Minor styling tweaks #### 1.0.5 (2025-10-08) * [Fixed] Plugin icon change #### 1.0.4 (2025-10-06) * [Added] Added Support for Woocommerce Blocks #### 1.0.3 (2025-09-24) * [Fixed] Locked the ability for customers to increase quantity on the free product line * [Added] Security enhancements #### 1.0.2 (2025-07-11) * [Fixed] Rules cache was not cleared upon save, resulting in eligible gift rules not showing #### 1.0.1 (2025-06-25) * [Fixed] Save notice missing after successful save #### 1.0.0 (2025-04-05) * Initial release ## اطلاعات * نگارش **1.1.6** * آخرین به‌روزرسانی **2 ماه پیش** * نصب‌های فعال **500+** * نگارش وردپرس ** 6.0 یا بالاتر ** * آزمایش‌شده تا **7.0.7** * نگارش PHP ** 7.4 یا بالاتر ** * زبان * [English (US)](https://wordpress.org/plugins/mh-free-gifts-for-woocommerce/) * برچسب * [buy one get one](https://fa.wordpress.org/plugins/tags/buy-one-get-one/)[free gift](https://fa.wordpress.org/plugins/tags/free-gift/) [free gifts for woocommerce](https://fa.wordpress.org/plugins/tags/free-gifts-for-woocommerce/) [Gift Product Woocommerce](https://fa.wordpress.org/plugins/tags/gift-product-woocommerce/) [WooCommerce gift](https://fa.wordpress.org/plugins/tags/woocommerce-gift/) * [نمایش پیشرفته](https://fa.wordpress.org/plugins/mh-free-gifts-for-woocommerce/advanced/) ## امتیازها 5 از 5 ستاره. * [ امتیاز 4 5-ستاره ](https://wordpress.org/support/plugin/mh-free-gifts-for-woocommerce/reviews/?filter=5) * [ امتیاز 0 4-ستاره ](https://wordpress.org/support/plugin/mh-free-gifts-for-woocommerce/reviews/?filter=4) * [ امتیاز 0 3-ستاره ](https://wordpress.org/support/plugin/mh-free-gifts-for-woocommerce/reviews/?filter=3) * [ امتیاز 0 2-ستاره ](https://wordpress.org/support/plugin/mh-free-gifts-for-woocommerce/reviews/?filter=2) * [ امتیاز 0 1-ستاره ](https://wordpress.org/support/plugin/mh-free-gifts-for-woocommerce/reviews/?filter=1) [بررسی شما](https://wordpress.org/support/plugin/mh-free-gifts-for-woocommerce/reviews/#new-post) [مشاهدهٔ همهٔ بررسی‌ها](https://wordpress.org/support/plugin/mh-free-gifts-for-woocommerce/reviews/) ## مشارکت کنندگان * [ mediahub ](https://profiles.wordpress.org/mediahub/) ## پشتیبانی مشکلات حل شده در دو ماه گذشته: 1 از 1 [مشاهده انجمن پشتیبانی](https://wordpress.org/support/plugin/mh-free-gifts-for-woocommerce/) ## کمک مالی آیا تمایل دارید از پیشرفت این افزونه حمایت کنید؟ [ کمک مالی به این افزونه ](https://ko-fi.com/adk77)