Copyright © 2006, William Weiland
This module contains a few script functions that can be used directly in the store morph page templates. See the product page for more info on the functions currently available.
1) In admin, click Add Modules link (fig 2)
2) Click the file upload button
3) Browse to find the toolkit.mvc file on your hard drive and upload (fig 3)
4) Click Add to add it to the domain
5) Then in admin click on the plus to the left of Stores
6) Click the plus to the left of your store name
7) Click on the word Utilities under your store (fig 8)
8) Check the box next to the Emporium Plus Tool Kit
9) Click Update
10) Click Pages link to get to the User Interface (fig 4)
11) Click Items link at the top of the User Interface page (fig 5)
12) Click the Add Item button (fig 6)
13) Enter toolkit for the code
14) Look up and scroll to the last page of items and Emporium Plus Tool Kit should be at the end of the list of items
15) Select Emporium Plus Tool Kit
16) Click the Add button to assign the module
17) In the utility configuration screen, you can view the example function code for the currently supported functions after you have entered the order number and where you purchased the license from. Beginning with Tool Kit version 5.052 you will also need to supply a license activation key before viewing the functions. This is not the license key you may have received when you purchased the license, as some vendors have their own license system. This license key is obtained directly from Emporium Plus. If you purchased from Emporium Plus, the key may have been included in the delivery email. If you purchased from other than the Emporium Plus store or it was not in the Emporium Plus delivery email, you can get it by clicking the link to "Request License Key" in the module's admin screen. 1) enter your order number and where you got it, 2) click Update, 3) request the key. Make sure the order number, domain, email address to send the key to and store code are correctly inserted in the request form. The license key is based on three of these elements. If you provided that info, the key will be sent back to you. After entering the key and saving, the module will be available for use in your store. The license info is stored in the cim_lic.dbf and cim_lic.mvx which are in your data "export" directory. Do not delete those files or you will have to re-enter your order number and license key in the module's admin. Remember, the license activation key is required for the module to work. If you update the module from an older version, be sure to check the license key to make sure it is in place and valid.
18) The Tool Kit works closely with the built in Custom Fields module. Most stores already have the Custom Fields module assigned to the store. If you do not, go to admin and click the word Utilities. Put a check in the box next to Custom Fields and click the Update button.
This module is frequently updated with new features. If you got it from Emporium Plus or MivaCentral, you can get the latest version at the update page. If you got it from Design Extend, you can get the latest version at their support page. You will need the order number and domain. Once you update the module from an older version, be sure to check the license activation key to make sure it is in place and valid in the module's admin screen. Here is a tutorial on updating the tool kit.
Click the Items link for the pages you want the functions to work on, scroll down to the "toolkit" item name and assign it to the pages (fig 7). Then within the pages you can use the tokens listed on the module's admin > store > utility > Tool Kit admin screen. I frequently add new functions to the module. Your version of the module has only the functions listed in the module's admin screen. You can check at Emporium Plus to see all of the features in the current version of the module. If you see new features you want, the update for 5x is free for your first 60 days after purchase. After that the update price is very low. IMPORTANT: Another reason to check at the Emporium Plus product page is it includes many examples and links to additional pages which are not included in the module's admin screen; e.g. shipping calculator, full mini-basket, balloon tool tips, expanded category, contact form/page sending, etc.
Q: I am getting the following error after I cleaned out my data directory Merchant5/s01/export/
Runtime error in /Merchant2/5.00/modules/util/toolkit.mvc @[00000017:00000954]: toolkit.mv: Line 2509: MvOPEN: Error opening 'Merchant5/s01/export/toolkitsave.dbf': No such file or directory
A: This only applies to Tool Kit version older than 5.163. While this rarely happens, it has occurred so I'm posting the fix here. There is a file that is used by the toolkit that must not be deleted. You can get a fresh copy of the file at http://www.emporiumplus.com/download/toolkitdbf.zip Unzip, then FTP it back to your data export directory. Make sure you FTP in binary mode.
