You are here

Home » API reference » Commerce Product Bundle 7

README.txt in Commerce Product Bundle 7

Same filename and directory in other branches
  1. 7.2 README.txt
Commerce Product Bundle
-----------------------

This module provides for Drupal Commerce a product bundling functionality.

You can define products that consists of other  products. The customer can 
select from different  sub products. This is similar to the core attribute 
functionality with the difference that the customer can select  multiple 
products in on one page.

The bundle  is then  represented by  one order line item.  This allows the
maximum  compatibility  with  other  modules  such as  shipping or payment 
modules. 

The module is in alpha stage and under development. So do not expect a production
ready version. At the moment use it for testing purposes only. If you find any
bugs - and you will, please file an issue.
http://drupal.org/project/issues/commerce_product_bundle


Installation
------------
Install the  module  as  usual.  

1) Setup a product type
Learn more about product types, products and product display in drupal commerce
http://www.drupalcommerce.org/node/289

2) Add at least two Product Reference Fields to the product type. 

3) Go to the Administer Display Tab in the product type admin form.
http://www.example.com/admin/commerce/products/types/YOUR-PRODUCT-TYPE/display
Set the display formatter at all product reference fields to 
'product bundle: add to cart form'.

4) Add a product with the new product type, and choose your referenced products.

5) Go and create an new product display content type, if you do not have one.
http://www.drupalcommerce.org/node/293
Add a product reference field, that can reference Products from your 
in Step 1) created Product Type.

6) Create a product display node and add a reference to the product you just
created in Step 4)

You're done.

-----

Some technical Details explained. A rough impression of how this module work.

- We add a new field to the product entity (reference field).
- On render the add to cart form, we check if there exists any product reference field with the 
  bundle product formatter.
- Then we render inside of the add to cart a form that is nearly equivalent to the original add to 
   the card form for each sub product.
- On a selection of the product (ajax call), we update the price by rules.
- On a add to cart action we add a new line item for the product reference field. We relate the sub 
  product line items to this parent line item. We do not relate them to the order, 
  because then in the order total they were counted twice.

Sponsored by www.customweb.ch

File

README.txt
View source 
  1. Commerce Product Bundle

  2. -----------------------

  3. 

  4. This module provides for Drupal Commerce a product bundling functionality.

  5. 

  6. You can define products that consists of other  products. The customer can 

  7. select from different  sub products. This is similar to the core attribute 

  8. functionality with the difference that the customer can select  multiple 

  9. products in on one page.

  10. 

  11. The bundle  is then  represented by  one order line item.  This allows the

  12. maximum  compatibility  with  other  modules  such as  shipping or payment 

  13. modules. 

  14. 

  15. The module is in alpha stage and under development. So do not expect a production

  16. ready version. At the moment use it for testing purposes only. If you find any

  17. bugs - and you will, please file an issue.

  18. http://drupal.org/project/issues/commerce_product_bundle

  19. 

  20. 

  21. Installation

  22. ------------

  23. Install the  module  as  usual.  

  24. 

  25. 1) Setup a product type

  26. Learn more about product types, products and product display in drupal commerce

  27. http://www.drupalcommerce.org/node/289

  28. 

  29. 2) Add at least two Product Reference Fields to the product type. 

  30. 

  31. 3) Go to the Administer Display Tab in the product type admin form.

  32. http://www.example.com/admin/commerce/products/types/YOUR-PRODUCT-TYPE/display

  33. Set the display formatter at all product reference fields to 

  34. 'product bundle: add to cart form'.

  35. 

  36. 4) Add a product with the new product type, and choose your referenced products.

  37. 

  38. 5) Go and create an new product display content type, if you do not have one.

  39. http://www.drupalcommerce.org/node/293

  40. Add a product reference field, that can reference Products from your 

  41. in Step 1) created Product Type.

  42. 

  43. 6) Create a product display node and add a reference to the product you just

  44. created in Step 4)

  45. 

  46. You're done.

  47. 

  48. -----

  49. 

  50. Some technical Details explained. A rough impression of how this module work.

  51. 

  52. - We add a new field to the product entity (reference field).

  53. - On render the add to cart form, we check if there exists any product reference field with the 

  54.   bundle product formatter.

  55. - Then we render inside of the add to cart a form that is nearly equivalent to the original add to 

  56.    the card form for each sub product.

  57. - On a selection of the product (ajax call), we update the price by rules.

  58. - On a add to cart action we add a new line item for the product reference field. We relate the sub 

  59.   product line items to this parent line item. We do not relate them to the order, 

  60.   because then in the order total they were counted twice.

  61. 

  62. Sponsored by www.customweb.ch