{"id":308123,"date":"2026-05-14T08:35:31","date_gmt":"2026-05-14T08:35:31","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/category-bogo-offer\/"},"modified":"2026-05-26T05:04:32","modified_gmt":"2026-05-26T05:04:32","slug":"vsw-bogo-offer-on-category","status":"publish","type":"plugin","link":"https:\/\/cn.wordpress.org\/plugins\/vsw-bogo-offer-on-category\/","author":23180396,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.1","stable_tag":"1.0.1","tested":"7.0","requires":"5.8","requires_php":"7.4","requires_plugins":null,"header_name":"Vsw Bogo Offer On Category","header_author":"Vaibhav Singh Web","header_description":"Flexible Buy X Get Y Free promotions per WooCommerce product category. Supports B1G1, B1G2, B2G2, B3G3, and more. The cheapest qualifying items in each deal group are discounted to zero automatically.","assets_banners_color":"585884","last_updated":"2026-05-26 05:04:32","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/wordpress.org\/plugins\/vsw-bogo-offer-on-category\/","header_author_uri":"https:\/\/profiles.wordpress.org\/vaibhavsweb","rating":5,"author_block_rating":0,"active_installs":0,"downloads":173,"num_ratings":1,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"vaibhavsweb","date":"2026-05-22 04:57:53"},"1.0.1":{"tag":"1.0.1","author":"vaibhavsweb","date":"2026-05-26 05:04:32"}},"upgrade_notice":{"1.0.0":"

Initial release \u2014 no upgrade steps required.<\/p>","1.0.1":"

Fixed Bugs In Cart<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":1},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3531742,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3531742,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3531742,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3531742,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0","1.0.1"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3531742,"resolution":"1","location":"assets","locale":"","width":1361,"height":830},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3531742,"resolution":"2","location":"assets","locale":"","width":1429,"height":848}},"screenshots":{"1":"Admin Rules List \u2014 all active BOGO rules shown as cards with deal type badge, category, and visual dot preview (purple = paid, green = free).","2":"Add New Rule page \u2014 step-by-step category picker and deal type selector with live preview showing the exact cart label.","3":"Mini-cart sidebar \u2014 Hurray! red banner appears instantly after qualifying items are added, showing savings and free items.","4":"Full cart page \u2014 free item shows \u20b90.00 with strikethrough original price, BOGO badge under product name, and correct cart total."}},"plugin_section":[],"plugin_tags":[13477,132597,331,182383,286],"plugin_category":[45],"plugin_contributors":[262876],"plugin_business_model":[],"class_list":["post-308123","plugin","type-plugin","status-publish","hentry","plugin_tags-bogo","plugin_tags-buy-one-get-one","plugin_tags-discount","plugin_tags-free-product","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-vaibhavsweb","plugin_committers-vaibhavsweb"],"banners":{"banner":"https:\/\/ps.w.org\/vsw-bogo-offer-on-category\/assets\/banner-772x250.png?rev=3531742","banner_2x":"https:\/\/ps.w.org\/vsw-bogo-offer-on-category\/assets\/banner-1544x500.png?rev=3531742","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/vsw-bogo-offer-on-category\/assets\/icon-128x128.png?rev=3531742","icon_2x":"https:\/\/ps.w.org\/vsw-bogo-offer-on-category\/assets\/icon-256x256.png?rev=3531742","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/vsw-bogo-offer-on-category\/assets\/screenshot-1.png?rev=3531742","caption":"Admin Rules List \u2014 all active BOGO rules shown as cards with deal type badge, category, and visual dot preview (purple = paid, green = free)."},{"src":"https:\/\/ps.w.org\/vsw-bogo-offer-on-category\/assets\/screenshot-2.png?rev=3531742","caption":"Add New Rule page \u2014 step-by-step category picker and deal type selector with live preview showing the exact cart label."}],"raw_content":"\n

VSW Bogo Offer On Category<\/strong> lets you run powerful Buy X Get Y Free promotions on your WooCommerce store, configured per product category. No coupon codes, no complex setup \u2014 just pick a category, choose a deal type, and the plugin does the rest automatically.<\/p>\n\n

How It Works<\/h4>\n\n
    \n
  1. Go to the top-level BOGO Offers<\/strong> menu in your WordPress admin sidebar.<\/li>\n
  2. Click + Add Rule<\/strong>, select a product category (e.g. ProductCat<\/em>, ProductCat1<\/em>).<\/li>\n
  3. Choose a deal type \u2014 Buy 1 Get 1 Free<\/em>, Buy 1 Get 2 Free<\/em>, Buy 2 Get 2 Free<\/em>, and many more.<\/li>\n
  4. Save. The offer is live immediately \u2014 no page reload needed.<\/li>\n<\/ol>\n\n

    When a customer adds qualifying products from that category to their cart, the plugin automatically identifies the cheapest items and sets their price to \u20b90. The cart, mini-cart sidebar, and checkout all reflect the correct discounted total instantly.<\/p>\n\n

    Supported Deal Types<\/h4>\n\n
      \n
    • Buy 1 Get 1 Free<\/strong> (B1G1) \u2014 Classic BOGO<\/li>\n
    • Buy 1 Get 2 Free<\/strong> (B1G2)<\/li>\n
    • Buy 1 Get 3 Free<\/strong> (B1G3)<\/li>\n
    • Buy 2 Get 1 Free<\/strong> (B2G1)<\/li>\n
    • Buy 2 Get 2 Free<\/strong> (B2G2)<\/li>\n
    • Buy 2 Get 3 Free<\/strong> (B2G3)<\/li>\n
    • Buy 3 Get 1 Free<\/strong> (B3G1)<\/li>\n
    • Buy 3 Get 2 Free<\/strong> (B3G2)<\/li>\n
    • Buy 3 Get 3 Free<\/strong> (B3G3)<\/li>\n
    • Buy 4 Get 3 Free<\/strong> (B4G3)<\/li>\n
    • Buy 4 Get 4 Free<\/strong> (B4G4)<\/li>\n<\/ul>\n\n

      Key Features<\/h4>\n\n
        \n
      • \u2705 Category-based rules<\/strong> \u2014 each rule targets one product category independently<\/li>\n
      • \u2705 Auto cheapest detection<\/strong> \u2014 the cheapest items in each group are always free<\/li>\n
      • \u2705 set_price(0) engine<\/strong> \u2014 free items are truly set to \u20b90, so subtotal, mini-cart, and checkout all show the correct total<\/li>\n
      • \u2705 Works in mini-cart sidebar<\/strong> \u2014 Hurray! banner and \u20b90 price appear in the cart drawer immediately after adding items<\/li>\n
      • \u2705 AJAX-powered<\/strong> \u2014 discount updates without page reload when items are added to cart<\/li>\n
      • \u2705 Quantity scaling<\/strong> \u2014 4 items with B1G1 = 2 free; 6 items with B2G2 = 4 free<\/li>\n
      • \u2705 Multiple simultaneous rules<\/strong> \u2014 run B1G1 on ProductCat and B2G2 on Bangles at the same time<\/li>\n
      • \u2705 Pause \/ resume rules<\/strong> \u2014 temporarily disable a rule without deleting it<\/li>\n
      • \u2705 \"Hurray!\" celebration banner<\/strong> \u2014 animated red card with confetti shown in cart and mini-cart when discount triggers<\/li>\n
      • \u2705 \"Buy X Get Y Free On [Category]\" badge<\/strong> \u2014 shown under the free item's name in the cart<\/li>\n
      • \u2705 Free item price display<\/strong> \u2014 shows \u20b90.00 with strikethrough original price<\/li>\n
      • \u2705 Teaser notice<\/strong> \u2014 purple banner tells customers about available offers before they add enough items<\/li>\n
      • \u2705 Variable product support<\/strong> \u2014 works with simple and variable products<\/li>\n
      • \u2705 HPOS compatible<\/strong> \u2014 WooCommerce High-Performance Order Storage ready<\/li>\n
      • \u2705 Top-level admin menu<\/strong> \u2014 \"BOGO Offers\" appears independently in the WordPress sidebar<\/li>\n
      • \u2705 Translation-ready<\/strong> \u2014 full .pot<\/code> file included<\/li>\n
      • \u2705 No coding required<\/strong><\/li>\n<\/ul>\n\n

        Example Scenarios<\/h4>\n\n

        Buy 1 Get 1 Free on ProductCat:<\/strong>\nCustomer adds Product A (\u20b9799) + ProductCat B (\u20b9399) \u2192 B is free \u2192 Cart total \u20b9799 \u2705<\/p>\n\n

        Buy 2 Get 2 Free on ProductCate:<\/strong>\nCustomer adds 4 Product priced \u20b9600, \u20b9500, \u20b9400, \u20b9300 \u2192 cheapest 2 (\u20b9300 + \u20b9400) free \u2192 Total \u20b91,100 \u2705<\/p>\n\n

        Buy 1 Get 2 Free on ProductCates:<\/strong>\nCustomer adds 3 Product priced \u20b9500, \u20b9300, \u20b9200 \u2192 cheapest 2 (\u20b9200 + \u20b9300) free \u2192 Total \u20b9500 \u2705<\/p>\n\n

        Privacy<\/h4>\n\n

        This plugin does not collect, store, or transmit any personal data. It uses WooCommerce session storage only to cache active discount details within a shopping session.<\/p>\n\n\n

        From the WordPress Plugin Directory (recommended):<\/strong><\/p>\n\n

          \n
        1. Go to Plugins \u2192 Add New<\/strong> in your WordPress admin.<\/li>\n
        2. Search for VSW Bogo Offer On Category<\/strong>.<\/li>\n
        3. Click Install Now<\/strong>, then Activate<\/strong>.<\/li>\n
        4. Go to BOGO Offers \u2192 Add Rule<\/strong> in your sidebar and create your first promotion.<\/li>\n<\/ol>\n\n

          Manual installation:<\/strong><\/p>\n\n

            \n
          1. Download the plugin .zip<\/code> file.<\/li>\n
          2. Go to Plugins \u2192 Add New \u2192 Upload Plugin<\/strong>.<\/li>\n
          3. Upload the .zip<\/code> and click Install Now<\/strong>, then Activate<\/strong>.<\/li>\n
          4. Go to BOGO Offers \u2192 Add Rule<\/strong> to configure.<\/li>\n<\/ol>\n\n

            Requirements:<\/strong><\/p>\n\n

              \n
            • WordPress 5.8 or higher<\/li>\n
            • WooCommerce 6.0 or higher<\/li>\n
            • PHP 7.4 or higher<\/li>\n<\/ul>\n\n\n
              \n

              Does it work with sale prices?<\/h3><\/dt>\n

              Yes. The plugin reads the current effective price (get_price()<\/code>) \u2014 which returns the sale price when a product is on sale \u2014 not the regular\/MRP price. So if a product's sale price is \u20b9799, that's what the discount calculation uses.<\/p><\/dd>\n

              Does it work with variable products?<\/h3><\/dt>\n

              Yes. The plugin correctly identifies the parent product ID for variations when checking category membership, so variable products are fully supported.<\/p><\/dd>\n

              What if a product belongs to multiple categories?<\/h3><\/dt>\n

              The plugin checks each active rule's category independently. A product in two BOGO-enabled categories participates in both calculations. Each rule's discount is applied separately.<\/p><\/dd>\n

              Can I run different deal types for different categories at the same time?<\/h3><\/dt>\n

              Absolutely. Create one rule for Product with B1G1 and another for Bangles with B2G2. Both run independently in the same cart session.<\/p><\/dd>\n

              What happens with 3 items and a B1G1 rule?<\/h3><\/dt>\n

              B1G1 has a group size of 2. With 3 items you get 1 complete group (1 free) and 1 leftover item at full price. Only complete groups trigger the deal.<\/p><\/dd>\n

              Does it update the mini-cart sidebar total?<\/h3><\/dt>\n

              Yes. Because the plugin uses set_price(0)<\/code> on free items (rather than a fee\/coupon approach), WooCommerce naturally recalculates the subtotal correctly everywhere \u2014 full cart page, mini-cart widget, and checkout order review.<\/p><\/dd>\n

              Is the discount compatible with WooCommerce coupons?<\/h3><\/dt>\n

              Yes. The BOGO discount is applied at the price level. WooCommerce coupons work on top of the already-discounted prices.<\/p><\/dd>\n

              Does it support multisite?<\/h3><\/dt>\n

              Yes. Each site on a multisite network has its own independent set of BOGO rules. The uninstall.php<\/code> file cleans up data from all sites on deletion.<\/p><\/dd>\n

              Can I translate the plugin?<\/h3><\/dt>\n

              Yes. All strings use __()<\/code> and esc_html__()<\/code> with the text domain vsw-bogo-offer-on-category<\/code>. A .pot<\/code> file is included in the languages\/<\/code> folder.<\/p><\/dd>\n

              What data does the plugin store?<\/h3><\/dt>\n

              A single WordPress option: cbogo_rules<\/code> (an array of rule definitions). No personal data is stored. Deleting the plugin removes all data via uninstall.php<\/code>.<\/p><\/dd>\n\n<\/dl>\n\n\n

              1.0.0<\/h4>\n\n
                \n
              • Initial release.<\/li>\n
              • 11 deal types: B1G1, B1G2, B1G3, B2G1, B2G2, B2G3, B3G1, B3G2, B3G3, B4G3, B4G4.<\/li>\n
              • Category-based rules with pause\/resume and delete.<\/li>\n
              • Top-level \"BOGO Offers\" WordPress admin menu independent of WooCommerce.<\/li>\n
              • Live preview on Add Rule page.<\/li>\n
              • set_price(0) discount engine \u2014 correct subtotal in mini-cart, cart, and checkout.<\/li>\n
              • Animated \"Hurray!\" red banner in cart and mini-cart sidebar.<\/li>\n
              • Free item badge (\"Buy X Get Y Free On [Category]\") under product name.<\/li>\n
              • \u20b90.00 with strikethrough original price on free cart items.<\/li>\n
              • Teaser notice when offer is available but not yet triggered.<\/li>\n
              • AJAX fragment updates \u2014 discount appears without page reload.<\/li>\n
              • HPOS (High-Performance Order Storage) compatibility.<\/li>\n
              • Multisite support via uninstall.php.<\/li>\n
              • Full i18n with .pot file.<\/li>\n
              • WordPress.org coding standards compliant.<\/li>\n<\/ul>","raw_excerpt":"Flexible Buy X Get Y Free promotions per WooCommerce product category. Supports B1G1, B1G2, B2G2, B3G3 and more. Cheapest item always free automatical …","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/308123","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=308123"}],"author":[{"embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/vaibhavsweb"}],"wp:attachment":[{"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=308123"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=308123"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=308123"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=308123"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=308123"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=308123"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}