README.txt 3.3 KB

123456789101112131415161718192021222324252627282930313233343536373839
  1. Description
  2. ------------
  3. This module integrates two other modules: webform and ubercart. It allows you sell products directly from your webforms. It is particularly suited to be used as part of a registration system.
  4. Requirements
  5. ------------
  6. - Drupal 7.x
  7. - Ubercart 3.1
  8. - Webform 3.17
  9. Installation
  10. -------------
  11. 1. Copy the entire uc_webform directory the Drupal sites/all/modules directory.
  12. 2. Login as an administrator. Enable the module in the "Administer" -> "Site
  13. Building" -> "Modules"
  14. Notes
  15. -----
  16. - For this module to be of any value, you must have already created some products on your site.
  17. - After you install this module, you will have four more component types for a webform: 'product', 'product list', 'hidden product' and 'product grid'. When you add these types of components, you will be asked to select which products you'd like to offer to those filling out the webform. The products you select will be added to your webform.
  18. - When adding a product grid, you may only select products *with* attributes and options. When adding a product or a product list, you may only select products *without* attributes and options.
  19. - When a user selects a product in a webform, the product is automatically added to their cart when the form is submitted.
  20. - If you add a product component to your webform, a hidden 'Order Status' field will be added. The values in this field will correspond to the Ubercart order status of the order that was created by the webform submission. You cannot remove an 'Order Status' component from a webform until you have removed all product components from the webform first.
  21. - The Analysis tab (which is available when viewing results for a particular webform) returns product data for *all* webform submissions. That means that clicking on 'Analysis' will display *all* the submission data for a particular webform regardless of whether or not the user completed the checkout process.
  22. - A new tab called 'Orders' appears when you click on the results for a particular webform. This new page only contains from the 'product' or 'product list' components (product grid information will be added soon) of the given webform, and it only returns data for webform submissions that ended in a completed checkout. This way, you can quickly and easily see how many of a given product was purchased with your webform.
  23. Developer Notes
  24. ---------------
  25. - The structure of the 'no' and 'data' columns in the {webform_submitted_data} table is very important. If the component is a 'product' or a 'product list', the value in the data column where 'no = 0' specifies the type of product data. The options are 'product' (user specifies the quantity they'd like in a textbox), 'checkboxes_product_list' and 'radio_product_list'. If the data refers to 'radio_product_list' and 'checkboxes_product_list', the values corresponding to the 'no' column greater than 0 refer to product node id's. If the data refers to a 'product', then 'no' at 1 is the product node id, and the 'no' at 2 is the product quantity.
  26. - I need to add notes about the data storage of product grid information also.
  27. Support
  28. -------
  29. Please use the issue queue for filing bugs with this module at http://drupal.org/project/issues/uc_webform.
  30. Credits
  31. -------
  32. Authored and maintained by Lucas Weeks (ldweeks).
  33. Sponsored by Atrium Web Services - http://atriumwebservices.com