Warning: Config Groups are an incredibly powerful feature in Cartweaver 4 and offer enormous potential to customize what the Cartweaver 4 Admin can do, but altering the Config Groups from their default configuration is not within the scope of this documentation and is for advanced users. Altering the Config Groups is not supported, so doing so is at the users risk. It is recommended to leave the Config Groups in their default settings and configuration.
The Configuration Group page lists the different Config Groups that are part of Cartweaver. With the config tables in the Cartweaver database, you can simply add groups or items to the standard Cartweaver config tables. The options will then magically appear in the admin, and resetting the application would provide all of those values in the Application scope for the site. The developer can then access the config information from the Application scope instead of relying on local variables in CWTagGlobalSettings, your static config file, or wherever else you may have normally created a configuration value. Examples of possible developer-defined configuration groups might be for Display Colors, Access Levels, Customer Preferences, etc.
To add a new Config Group, type a name, a sort level, and whether or not to show the merchant. If you choose not to show to the merchant, the Config Group will be accessible only to the developer, such as the Debug Settings group that ships with Cartweaver.
Drilling down from Config Groups, the Config Items page allows you to set the various database-driven configuration items that are part of Cartweaver. In order to show the Configuration Items page, you must have the development Debug password, as set in the Application.cfm file. You reach the config.cfm page by adding ?debug=yourpassword to the URL while in the admin. The Config Groups link will appear in the navigation menu, and you will have access to adjust the configuration. New configuration items can also be added to aid in your development. Each configuration item has its own help icon for more information, but the following gives you a brief overview of the items that are available:
Company info contains information about the company that will appear in the footer in a Cartweaver site, and is also used for confirmation emails and other instances where the company name, address, or email address are used in the site. More information on Company Info can be found here.
Debug settings allow you to view variables used on each page or in the site during development or during debugging. This is entirely independent of any ColdFusion debugging that is available on the server. You can choose to enable or disable debugging and choose which variables you want to display. Variable dumps are displayed at the bottom of the page if debugging is turned on.
The discount settings allow you to enable or disable discounts in the store, and also allow you to display a separate item in the cart for discount, and to show the discount descriptions if available.
Display settings encompass configuration items that show or hide aspects of the pages in the store. You can choose to show your results pages using multiple columns or single items on a page, how many items to display, and whether or not to show small images in the shopping cart. There is also an item that allows you to display a popup image on the Details page. If used, popup images must be uploaded using the administration section. Categories/Secondary Categories can also be related using the configuration item "Relate Categories/Secondaries". When this is checked, dropdown lists showing categories and secondaries become related based on products that are associated with the categories.
Anything that doesn't fit into one of the Config Groups goes here. The Cartweaver version number is also stored here. This can aid the developer when contacting the Cartweaver team for support.
Shipping can be charged based on weight or cost, and can be enabled here. Also, you can choose to charge a base rate and an amount based on location. The actual shipping costs are entered using the separate Shipping menu item.
Settings related to tax are shown here, such as the ability to store and display a Tax ID number, show separate tax amounts on line items in the cart, and whether or not to charge tax on shipping.
Configuration Group Help
The Config Group page allows you to define or edit individual configuration groups, along with the items within that group. The group name will appear in the menu under Store Settings. From this page, you can also add new items to the group. To add an item, you need the following:
- Friendly Name: the user-friendly name that will show for the config item.
- Variable Name: the machine-friendly variable name (no spaces/special characters) that will become an Application variable in the application.
- Sort Order: the relative sort order of the item (integer).
- Form Type: the type of field you want to use for the config item. Your config item might be a flag (checkbox), choice (list or radio buttons), or a text item.
- Initial Value: the initial value to use for the configuration item.
- Possible Values: name/value pairs of possible values used in selection lists, checkbox groups, and radio items.
- Description: a description of what the config item does, which shows under the help icon when clicked.
- Show Merchant: should the merchant see this item? If unchecked, it will be a developer-only item.
Also on this page, you can drill down into already defined items and edit them.