• Installing Simple Bundle Product
• Installing Hyvä Theme Compatibility Module
• Uninstalling Simple Bundle Product
• Compatibility
• Introducing Simple Bundle Product
• Backend Configuration
• Simple Bundles on the Storefront 
• Integrations 
• Advanced Subscription Product for Magento 2
• Add Free Product to Cart for Magento 2

Magento 2 Simple Bundle Product simplifies the creation of bundle products by minimizing the number of configuration options. Admins can add bundles to new orders without additional settings. Customers can add bundles to their cart without any preliminary customization.

Installing Simple Bundle Product

Command Line Installation

1. Backup your web directory and store database
2. Download the Simple Bundle Product installation package
3. Upload contents of the Simple Bundle Product installation package to your store root directory
4. In SSH console of your server navigate to your store root folder:

cd path_to_the_store_root_folder

run the following command: 

php bin/magento module:enable Aheadworks_Sbp

then:

php bin/magento setup:upgrade

after:

php bin/magento setup:static-content:deploy -f

     5. Flush store cache; log out from the backend and log in again

Composer Installation

If you are installing an extension from Aheadworks for the first time, you need to add our composer repository to your Magento store:

     1. Login to your ssh console and navigate to your store folder:

cd path_to_the_store_root_folder

Run the following commands:

composer config repositories.aheadworks composer https://dist.aheadworks.com/

After the command was executed successfully, you can use the composer to install the products.

To install the extension:

     2. Login to your ssh console and navigate to your store folder:

cd path_to_the_store_root_folder

     3. Run the following command to install the latest version of the extension:

composer require aheadworks/module-sbp

if you need to install a specific version, run this command:

composer require aheadworks/module-sbp:<version>

When prompted, enter Public Key (Username) and Private Key (Password):

Both Public Key (Username) and Private Key (Password) can be found in My Projects and Licenses in your personal account on our site:

     4. Enable the extension:

php -f bin/magento module:enable Aheadworks_Sbp

Next, register the extension:

bin/magento setup:upgrade

Recompile your Magento store if you are in the Production mode:

bin/magento setup:di:compile

To verify that the extension is enabled, run this command:

bin/magento module:status

Clean store cache, by running the following command:

bin/magento cache:clean

Log out and Log in the backend again.

To upgrade the extension:

     5. To update or upgrade an extension:

Download the updated extension file. Take note of the module-name and version. Export the contents to your Magento root.

If a composer package exists for the extension, run one of the following.

Update per module name:

composer update aheadworks/module-sbp

Updater per version:

composer require aheadworks/module-sbp:<version>

Run the following commands to upgrade, deploy, and clean the cache. 

php bin/magento setup:upgrade --keep-generated
php bin/magento setup:static-content:deploy
php bin/magento cache:clean

Installing Hyvä Theme Compatibility Module

Starting from Simple Bundle Product version 1.3.6 and its Hyvä Compatibility Module version 1.1.0, the Hyvä Compatibility Module is available only via the Aheadworks Composer repository.

Older versions of the Hyvä Compatibility Module can still be accessed via GitLab.

Installing Hyvä-compatibility module 1.1.0 and newer 

To install Hyvä Compatibility Module 1.1.0 or newer via Aheadworks Composer, run the following command:

composer require aheadworks/module-sbp-hyva

Installing older versions of Hyvä-compatibility module

To install an older version of the Hyvä Compatibility Module, use the following command:

composer require hyva-themes/magento2-aheadworks-sbp

Hyvä-compatibility Modules with CSP Compliance 

Starting from Hyvä Compatibility Module version 1.1.0, all Hyvä compatibility modules are CSP compliant. Older versions remain non-CSP compliant.

Note: The CSP-compliant modules may not be compatible with older versions of Hyvä Theme (1.3.9 and older). Before updating, please verify which version of the Hyvä Theme your store is using.

Uninstalling Simple Bundle Product

Since Magento introduced declarative Database you need to be very carefull when uninstalling or disabling the module.

Manual Removal

1. Disable the module by executing the following commands:

php bin/magento module:disable Aheadworks_Sbp
php bin/magento setup:upgrade

2. Remove the extension files from the following folder:

app/code/Aheadworks/Sbp

Automatic Removal (via Composer)

1. Disable the module by executing the following commands:

php bin/magento module:uninstall Aheadworks_Sbp

Compatibility

The PHP version depends on your current Magento version. Please, refer to your Magento version release notes.

Introducing Simple Bundle Product

The Simple Bundle Product extension makes bundle installation for admins and their purchasing for customers as simple as possible by introducing the following features:

• Excessive bundle setting options are hidden;
• Bundles can be added to backend orders;
• Bundle customization step is eliminated.

Extension Logic

The module adds the new option to the ‘New Product’ page for bundle products. Store admins can instantly switch to a simplified view with fewer settings compared to the native functionality. However, the core Magento logic remained virtually unchanged, meaning that bundles are created and handled by Magento the same way as before. 

In essence, an admin needs to add bundle items in order to create a new bundle product. Once the bundle has been created, the admin can add it to new orders.

On the storefront, customers can now add already configured bundles to their cart without customizing them just like they do this with a simple product type. 

Stock Calculation Logic

From a business perspective, the logic is the same as in with the native Magento bundle products: a merchant can't deliver the bundle if one of the components is missing. So if at least one of the child products goes out of stock, the whole simple bundle product will go out of stock as well. Still, the backorder functionality is supported.

In case if one of the child product for simple bundle product is out of stock and:

If Display Out of Stock Products set to Yes, then:

• parent simple bundle is out of stock;
• both those products are visible in the catalog, but marked as out of stock;
• simple bundle product final price will be displayed with the same full price as it was before changing child to out of stock.

If Display Out of Stock Products set to No, then:

• parent simple bundle is out of stock;
• both those products are invisible in the catalog, but available by direct product link;
• simple bundle product final price will be displayed excluding the price of children products that are out of stock.

Simple bundle price for the first and the second condition will be different because it is normal behavior, caused by specific of the Magento price index.

Integrations:

Add Free Product to Cart

Backend Configuration

Extension Settings

Start with configuring the extension settings under Stores → Configuration → AHEADWORKS EXTENSIONS → Simple Bundle Product.

Here you are presented with one option only: 'Default Title List of Bundle Products'. Specify the appropriate title in the field and click 'Save config' to apply the setting. 

Configuring a Simple Bundle

 Now, let’s create a simple bundle. Traditionally, the bundle is configured in Catalog → Products.

 First, switch to the ‘Simple Bundle’ mode. 

Once you’ve enabled the parameter, the pop-up alert is displayed.

Nothing to worry about - just a warning that the native bundle options will now be unavailable. Click 'Continue' .

Next, scroll down to the ‘Bundle Items’ section to see what changed there.

As you can see, the ‘Add Option’ button is now hidden. The ‘Option Title’ field displays the value you previously indicated in the extension settings. So, all you need to do to is to add the required items to the bundle the same way as in the native solution.

After the bundle is composed, the section will look like this:

In the simplified view, the ‘Input Type’ section is now hidden. It’s automatically set to ‘Checkbox’ and can't be deselected by a customer on a storefront. The ‘Required’ parameter is enabled by default.

Native bundle conversion

You can easily turn native bundles into the simple ones at the backend catalog page.

Select the bundles you want to convert and apply massive action to the products.

Adding Bundles to New Orders

In addition to bundle creation, the module improves the functionality of the ‘New Order’ page.

Let’s see it in action! Go to Sales → Orders and click on the Create New Order button. Select the required customer and start adding products to the order.

Now you can easily add your bundles to new orders. Notice: since the version 1.1.0 you don’t have to configure them additionally - the behavior is the same as with the products of simple type.

Here you are suggested to set the quantity of the bundle product. If you leave the ‘Quantity’ field empty, the quantity will be ‘1’ (default value).

Simple Bundles on the Storefront 

Simple Bundle Product makes the interface of bundle product pages more user-friendly. Check it out!

Bundle items are presented as a list with active links to corresponding item pages.

All the required configuration is already performed for customers.

They just need to add the product to a cart. That’s it! Mind that if you need to use simple bundles along with the native ones, you can do it smoothly. 

Integrations

Advanced Subscription Products for Magento 2

As Simple Bundle Product extension is integrated with Advanced Subscription Products, store admins can now add subscription plans to both regular and simple bundles.

To do so, go to Catalog → Products and open an existing bundle product or create a new one. 

At the bundle product setting page configure the items to your liking and scroll down to the Subscription Options section.

Purchase Type option allows you to choose the most preferable purchase method:

• Only One-Time Purchase (No subscription needed)
• Either One-Time Purchase or Subscription
• Subscription Only

Next, determine whether to Use Product Advanced Pricing or the Configuration Settings by using a yes/no toggle or checkbox, and then add the appropriate Subscription Plan(s) using "Add" button.

In the Subscription Plans option you can:

• Determine which Website the subscription will be displayed on;
• Select the appropriate subscription Plan;
• Set Pricing details.

After all the configurations have been completed, click on the Save button.

Add Free Product to Cart for Magento 2

The integration of Simple Bundle Product with Add Free Product to Cart extension allows store admins to create promotional scenarios and offer gifts and discounts when a bundle product is purchased, as well as offer the simple bundle products themselves as promotional items.

To add promo items to the simple bundle product go to Marketing > Add Free Product to Cart > Rules

On this page, you can view financial metrics that reflect the performance of the campaigns and the details within the Scenarios grid.

To illustrate the integration, let's look at a promotional campaign example:

Backend rules configuration: 

Campaign: Offer customers an Affirm Water bottle or Sprite Foam Yoga Brick for just 1 USD when they purchase a Travel Set simple bundle. 

Scenario: Buy X Get Y 

Rule: Each time a Travel Set simple bundle is added to the cart, the customer will be prompted with a popup to purchase one of the promotional items (Affirm Water bottle or Sprite Foam Yoga Brick) for 1 USD. These promotional items should not be automatically added to the cart but offered through a popup.

On the storefront, promo text is displayed beside the price of the item related to the promo scenario.

Upon adding a promo item to the cart, a popup will appear to offer the promotional product(s) to the customer.

Once the promo product is added, the Cart Summary will show the subtotal, the discounted price, and the total order value.

When using the Coupon scenario, the procedure remains the same, but the customer must enter a specific coupon code at checkout.

Note: the Simple Bundle products can also be added as promo items themselves.

To do this, click the "Add Products" button in the rules settings section.

And then use the filters to select the desired simple bundle as a promotional product.

Product Page