Bundles

Just the Basics 

 We have provided numerous updates to bundles part of our ecommerce enhancements. These include the refined listing of bundles, compatibility with Faceted Search, support for product variants, optimised bundle stock control and reordering.

What is a bundle?

A bundle is simply a collection of products. Bundles accept the following parameters which may be modified by visiting Transactions => Catalogues on the Core dna Digital Experience Platform:

Pricing and Quantity (Under Details)

• Sign (Can be either plus + or minus -)

• Value (The price modification value)

• Modifier (Can be either dollars $ or a percentage %)
• Price (The cost of the bundle)
• Quantity (The number of bundles in stock)
• Tags (Search tags for the bundle)
• Image (A visual image to represent the bundle)

Products (Under Bundle Products)

Fields:

• Product name. This is an auto-complete, so just start typing and your products will appear. The auto-complete includes products who are unpublished and out of stock. If you add any product who will effect the bundle you will not be able to publish it.

• Product Quantity Per Bundle: The amount of this product for this Bundle. This will be checked on publish.

• Bundled products: This is a listing of all the Products in a Bundle. You can Edit and Delete any entry here.

Related categories (Under Relations)

Price modifiers (Under Pricing)

• Text: The name of this modifier.

• Product code The Product code it applies to.

• Description DescribethisModifier

• Modifiers Sign +/-, value, modifier %/$

• Default access Set the default access for the modifier. Please note, this overwrites the assigned group access.

• Available Groups: For groups Access (None, read, update or all)

Bundle Authority

• Inherit Access (A switch to determine whether or not the bundle will use the access setting of its parent)
• Default access (None, read, update or all) - The bundle will use the default access when no other authority levels have been set

Creating a bundle

To create a bundle, visit Transactions on the Coredna Digital Experience Platform, then select Catalogues->Bundles->Add a New Bundle. Make sure that after you create the bundle you set its status to published and that is has a quantity over 0.

Adding Relations and Variants

On the Coredna Digital Experience Platform, visit Transactions => Catalogues => Products. Search for your product then click edit (be sure to order by all if your product is not visible). Select the Relations tab and add components from your desired categories.

Afterwards select the Variants tab. If this is not visible, visit Transactions => Catalogues => Configure => Manage Configuration and check Use Product Variants. When adding a variant you should be able to see any relations that you have set earlier. Select the appropriate relations and make sure you have positive values for Stock, Minimum Qty and Value.

Bundles In Faceted Search

Bundles are also integrated into Faceted Search By default. They will display like normal products and can be filtered by facets.

Bundle Errors

When you go to publish a Bundle, Various checks are performed to ensure this bundle is good. These checks include:

• Bundle stock check
• Bundle product stock check
• Bundle product stock check with bundle product amount
• Bundle product Publish Check

If any errors are found, they will be shown to the user and the Bundle will not be published. 

Bundle Checks

A Bundle will be set to unpublished on product update, product delete, product unpublish, product checkout and cart checkout. You will be informed when this happens via the UI (except for cart checkout, which will set the Bundle to unpublished if it's requirements are not met)

Bundle checks will also be performed every time a bundle is viewed using view_bundle. If the conditions are not met, then it will be set to published off.

----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

Template Updates

.

Apply the following to allow your site to follow bundles URLS and links

Updating your index template

Open the index file in /modules/prodcatalogue/templates/index.html and add the following code:

Updating your bundle template

Download the revised bundle template here (including updating quantity): bundle.html (legacy version: bundle.html)

Copy and paste bundle.html into /modules/prodcatalogue/templates inside your site directory.

Updating cart template

In order to list bundles other than the products you need to add this under product loop in /modules/prodcataloguecart/templates/index.html:

Also to display the errors (e.g. out of stock quantity) add this on top of the file:

Updating Basket Icon

file: block_cart_header_mini.html

In order to display total items in the cart (basket icon) you need to replace 

With:

In /modules/prodcataloguecart/templates/block_cart_header_mini.html

Also the same as block_cart_review.html you can have list of bundles:

Updating Product Checkout Details

file: block_cart_review.html

If your checkout page uses 'show_cart' function, in the template (which should be located at: modules/prodcataloguecart/templates/block_cart_review.html) of the block function you need to add bundles the same as products:

Updating your results template

Open the file at modules/sitesearch/templates/results.html inside your site directory and replace any of the links to prodcat with the following: 

Viewing bundles and products

Add the following code inside your products template, you will need to check for both products and bundles and show each in the same <ul>

Here is an example products.html with both products and bundles working together, this is only a reference and cannot be copied and pasted into every site.

html document

How to view a bundle in order mail

Update templates/new_order_letter.html with the following code. Clear templates_c.

note: you can use $discount_total instead of $discount to show the discount including shipping. $discount is the amount applied to the product.

Searching for bundles through sitesearch

In order to search bundles on sitesearch, modify the URL search params to: index=prodcat_products+bundles

----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

Bundle Links

.

viewing bundles and products

In order to view bundles and products you must navigate to the following URL:

Example: http://www.yoursite.com/index.php?action=prodcatalogue&form_name=view_bundles_products

• category_id: the category to view (int) (optional)
• start: the start position (int) (optional) (used for pagination)
• per_page how many results to show per page (int) (optional) (used for pagination)
• order specify column to sort on (string) (optional) (used to order results) examples: price, name, tags, date_created

Viewing a single bundles and orders

You may view a bundle by visiting the appropriate url and specifying &bundle_id=id 

Example:http://www.yoursite.com/index.php?action=prodcatalogue&form_name=view_bundle&bundle_id=9

Bundle Reorder

You may view an order by visiting the appropriate url and specifying &order_id=id

Example: http://www.yoursite.com/index.php?action=prodcatalogueorder&form_name=trackorders&order_id=26029

----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------