You are here

README.txt in Commerce Product Option 7

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

This module adds customizable products option to the "add to cart" form. The approach is generic, 
so all field types / widget can be used. This module is works only for drupal commerce. 

The module provides a field called option set. You can assign to your commerce product. 
Each option set consists of a list of fields. If a product is connected to a option set the add to cart form 
will be extended by the fields of the option sets.

Sponsored by www.customweb.ch

We use the Commerce Product Attributes module to show the selected options in the shopping cart. 
If the customer clicks in the shopping cart on the product link (if the option is activated in the Commerce Product Attributes module),
then she / he can edit the previous selected or entered option set fields.

Setup:
---------------
1) Setup an option set (Administration -> Store > Products > Option Sets)
2) Setup a product type with a option set reference (separate module "Option Set Reference"
    is needed, it is included in this package).
3) Add a new product of the product type with the option set reference field.
4) You will finde a dropdown field with all the available option sets.
     Select your option set in the product and save the product.
5) Add your product to the product display of your choice.
6) !You must change the settings of the add-to-cart-form widget in the 'manage display' tab of your
    product display content type. Disable the option
    'Attempt to combine like products on the same line item in the cart.'.
    See: http://drupal.org/files/screenshot-option.png
7) You have to adjust all views of the cart-block, cart, checkout etc. For details
     see Commerce Product Attributes module.

When and when not to use
-------------------------------------

Please read this carefully. You shouldn't use this module without understanding the consequences.

With plain Commerce, you'd add fields on product types for variations such as size and colour, 
and then create one product for each possible combination. Your product node then needs to 
reference all the products you created that fit together to provide a single 'product' as perceived 
by the customer.

B. with commerce option, you create option sets, which then can have multiple fields. 
You then add an option set reference field to your product. This then means that when you see the 
product 'add to cart' form on the product display node, you get the fields from the option set(s) applied 
to the product displayed.

Example:

- make an option set 'size'
- add a field on it 'size' (the names get repetitive...)
- add select options S, M, X, XL etc
- add an option set ref field to your product type(s)
- the product display node now shows the 'size' field.

It is important to understand that this approach means, you do not have SKU's / Products for each of the
possible options. Therefore you cannot use commerce functionality that is based on this distinction. The
most prominent one you can think of, is stock control. But others may be affected. So use this module
only, if you do not care about these functions.

Documentation on d.o.
http://drupal.org/node/1365984

File

README.txt
View source
  1. Commerce Product Options
  2. --------------------------------------
  3. This module adds customizable products option to the "add to cart" form. The approach is generic,
  4. so all field types / widget can be used. This module is works only for drupal commerce.
  5. The module provides a field called option set. You can assign to your commerce product.
  6. Each option set consists of a list of fields. If a product is connected to a option set the add to cart form
  7. will be extended by the fields of the option sets.
  8. Sponsored by www.customweb.ch
  9. We use the Commerce Product Attributes module to show the selected options in the shopping cart.
  10. If the customer clicks in the shopping cart on the product link (if the option is activated in the Commerce Product Attributes module),
  11. then she / he can edit the previous selected or entered option set fields.
  12. Setup:
  13. ---------------
  14. 1) Setup an option set (Administration -> Store > Products > Option Sets)
  15. 2) Setup a product type with a option set reference (separate module "Option Set Reference"
  16. is needed, it is included in this package).
  17. 3) Add a new product of the product type with the option set reference field.
  18. 4) You will finde a dropdown field with all the available option sets.
  19. Select your option set in the product and save the product.
  20. 5) Add your product to the product display of your choice.
  21. 6) !You must change the settings of the add-to-cart-form widget in the 'manage display' tab of your
  22. product display content type. Disable the option
  23. 'Attempt to combine like products on the same line item in the cart.'.
  24. See: http://drupal.org/files/screenshot-option.png
  25. 7) You have to adjust all views of the cart-block, cart, checkout etc. For details
  26. see Commerce Product Attributes module.
  27. When and when not to use
  28. -------------------------------------
  29. Please read this carefully. You shouldn't use this module without understanding the consequences.
  30. With plain Commerce, you'd add fields on product types for variations such as size and colour,
  31. and then create one product for each possible combination. Your product node then needs to
  32. reference all the products you created that fit together to provide a single 'product' as perceived
  33. by the customer.
  34. B. with commerce option, you create option sets, which then can have multiple fields.
  35. You then add an option set reference field to your product. This then means that when you see the
  36. product 'add to cart' form on the product display node, you get the fields from the option set(s) applied
  37. to the product displayed.
  38. Example:
  39. - make an option set 'size'
  40. - add a field on it 'size' (the names get repetitive...)
  41. - add select options S, M, X, XL etc
  42. - add an option set ref field to your product type(s)
  43. - the product display node now shows the 'size' field.
  44. It is important to understand that this approach means, you do not have SKU's / Products for each of the
  45. possible options. Therefore you cannot use commerce functionality that is based on this distinction. The
  46. most prominent one you can think of, is stock control. But others may be affected. So use this module
  47. only, if you do not care about these functions.
  48. Documentation on d.o.
  49. http://drupal.org/node/1365984