Join Emporium Plus on Facebook and follow us on Twitter for tips, tricks, update alerts, and coupons.   Bookmark and Share Online Support
Emporium Plus Module Installation Documents Index
Code Name 5.x 4.x 3.x 2.x
1AA00068  U Addendum c,e,t Online Online Online Online
1AA00204  U Attribute Prompt vs Code o,t Online Online NA NA
1AA00086  U Auction Contact c NA Online Online In File
1AA00088  U B2B No Tax c,e,t Online Online Online In File
1AA00015  U Base + Number of Items Shipping by State Zone Online Online Online Online
1AA00011  U Base + Number of Items Shipping by World Zone c Online Online Online Online
1AA00030  U Base + Number of Items Shipping by ZIP Code Zone Online Online Online NA
1AA00010  U Base + Number of Items Shipping c NA Online Online Online
1AA00027  U Base + Weight Less Offset Shipping by World Zone c NA Online Online Online
1AA00013  U Base + Weight Shipping by State Zone c Online Online Online Online
1AA00221  U Basket Price Group Recalc Online Online NA NA
1AA00014  U Base + Weight Shipping by World Zone c Online Online Online Online
1AA00202  U Base + Weight Shipping by ZIP Code Zone Online Online NA NA
1AA00041  U Best Seller Display e,t Online Online NA NA
1AA00080  U Buy X Get 1 Free c,e,t Online Online Online Online
1AA00034  U Categories in Basket Screen e,t Online Online Online NA
1AA00075  U Categories in Product List Screen c,e,t Online Online Online Online
1AA00074  U Categories on Product Display Screen c,e,t Online Online Online In File
1AA00009 Category Attribute Import From Flat Files NA Online NA NA
1AA00039  U Category Import and Export of Flat Files Online Online NA NA
1AA00219  U Category Manager Online NA NA NA
1AA00227  U Category Minimums and Maximums Online NA NA NA
1AA00205 Category Specials o,t NA Online NA NA
1AA00216  U Category Tree Online NA NA NA
1AA00064 Check Me Oute,t3 NA Online NA NA
1AA00059  U Contact Manager e,t,oec Online Online Online NA
1AA00007  U Coupon Redemption Module c,e,t Online Online Online In File
1AA00056  U Create Batch by Date Online Online Online NA
1AA00222 Custom Customer Fields Interface Online NA NA NA
1AA00032  U Dimension Pricing Online Online Online NA
1AA00210  U Discount Based on Quantity by Category t3,oec Online Online NA NA
1AA00092  U Edit More - Additional Field Editor c,e,t NA Online Online In File
1AA00224  U Email Address Login and UserName Lookup Online NA NA NA
1AA00081  U Entity Count Pricing Online Online Online In File
1AA00077  U Event Reminder e,t,oec Online Online Online Online
1AA00033  U Export Product Fields and Category Codes to Flat File c NA Online Online In File
1AA00035 Export Product Fields and Combined Category Codes to Flat File c NA Online Online In File
1AA00037  U Export Product Fields and Multiple Category Codes to Flat Files c NA Online Online In File
1AA00031  U Export Wizard - Database to Flat File c Online Online Online Online
1AA00076  U Express Order c,e,t Online Online Online Online
1AA00078  U External Product Purchase c Online Online Online In File
1AA00211  U EZ Batch Report Online Online NA NA
1AA00201 Fast Data Feed (FroogleTM) Online Online Online NA
1AA00052  U Find and Replace NA Online Online NA
1AA00026  U Flat Rate Shipping by State Zone Online Online Online NA
1AA00016  U Flat Rate Shipping by World Zone c Online Online Online Online
1AA00017  U Flat Rate Shipping by ZIP Code Zone Online Online Online NA
1AA00084  U Flexible Product Description c,o,t Online Online Online In File
1AA00085  U Follow-on Contact Online Online Online In File
1AA00082  U Gift List Registry c,e,t Online Online Online Online
1AA00097  U Groupwise Weight Table Shipping by State Zone NA Online NA NA
1AA00098  U Groupwise Weight Table Shipping by World Zone NA Online NA NA
1AA00051  U Image Checker c Online Online Online Online
1AA00006  U Import Attributes and Options From Flat File c Online Online Online In File
1AA00073  U Insurance by Subtotal e,t Online Online Online Online
1AA00055 Inventory Management/Customer and Product Administration c,e (Uncompiled version no longer available at Emporium Plus as a separate product) NA Online In File Online
Online
1AA00055  U Customer and Product Administration c,o,t (Compiled version for Merchant 4.14 and newer) Online Online NA NA
1AA00054  U Kit Maker e,t Online Online Online Online
1AA00091  U Lost and Found Orders Online Online Online NA
1AA00089  U Mail Manager Online Online Online In File
1AA00072  U Mini-basket Display c,e,t Online Online Online In File
1AA00069  U Minimum and Maximum Quantity e,t Online Online Online NA
1AA00018  U Minimum or Percent of Total Shipping by World Zone c NA Online Online Online
1AA00022  U Minimum or Subtotal Shipping by State Zone c Online Online Online Online
1AA00023  U Minimum or Subtotal Shipping by World Zone c Online Online Online Online
1AA00095  U Minimum or Subtotal Shipping by ZIP Code Zone c Online Online Online Online
1AA00020  U Minimum or Subtotal Shipping c NA Online Online Online
1AA00206 Minimum Override o,t NA Online NA NA
1AA00083  U Miscellaneous Fee Online Online Online In File
1AA00043  U No Shipping Module o,t2 NA Online Online NA
1AA00025  U Number of Items (Grouped) or Free Shipping c NA Online Online Online
1AA00019  U Number Table Shipping by World Zone Online Online Online NA
1AA00012  U Number Table Shipping by ZIP Code Zone Online Online Online NA
1AA00225  U Order Custom Fields Online NA NA NA
1AA00215 Override Pricing oec NA Online NA NA
1AA00045  U Payment Method Display e,t NA Online Online NA
1AA00066  U Payment Methods for Groups e,t Online Online NA NA
1AA00004  U PayPal Payment Module for MIVA Merchant c Online Online Online In File
1AA00021  U Percent of Subtotal Shipping with Minimum and Maximum by State Zone NA Online Online NA
1AA00024  U Percent of Subtotal Shipping with Minimum and Maximum by World Zone NA Online Online Online
1AA00038  U Percent Off Based on Quantity by Category e,t,oec Online Online Online NA
1AA00042  U Percent Off Based on Number of Items NA Online Online NA
1AA00044  U Percent Off Subtotal Online Online Online NA
1AA00048  U Percent Off Subtotal by Category Online Online Online NA
1AA00090  U Perpetual Basket Contents Display c,e,t NA Online Online Online
1AA00217  U Phone In Payment Online Online NA NA
1AA00058  U Power Search c,e,t2 Online Online Online In File
1AA00226  U Price Group Manager Online NA NA NA
1AA00036  U Product Quantity Import c Online Online NA NA
1AA00057  U Purchase Order Plus Online Online Online Online
1AA00060  U Rate This c,e,t Online Online Online In File
1AA00049  U Related Product Import and Export of Flat Files Online Online NA NA
1AA00067  U Restock Shelves Online Online NA NA
1AA00208  U Restrict Export o Online Online NA NA
1AA00099  U Shipping by Product by State Zone Online Online Online NA
1AA00071  U Shipping by Product by World Zone Online Online Online NA
1AA00079  U Shipping by Product by ZIP Code Zone Online Online Online NA
1AA00002 Shipping Calculator e,t NA Online NA NA
1AA00047  U Shipping List e,t3 NA Online Online NA
1AA00063  U Shopping Pad e,t NA Online Online NA
1AA00218 Shopzilla Data Feed Online Online NA NA
1AA00061  U Show Baskets Online Online Online NA
1AA00065  U Show Payment Type e,t NA Online Online Online
1AA00050  U Size Pricing Online Online NA NA
1AA00053  U Sort Categories and Products c Online Online Online In File
1AA00203 Sort Related Products o,t NA Online NA NA
1AA00008  U Sort Shipping Plus Free Shipping Option e,t3 Online Online NA NA
1AA00070 Static Catalog Generator c,e,t,oec NA Online Online Online
1AA00046 Subscription Payment via PayPal NA Online Online Online
1AA00001  U Swap Link o,t3 Online Online NA NA
1AA00062  U Tell a Friend c,e,t,oec Online Online Online Online
1AA00220  U Template Data Feed Online Online NA NA
1AA00207 Title Manager e,t NA Online NA NA
1AA00223  U Tool Kit Online NA NA NA
1AA00087  U Volume Pricing e,t Online Online Online In File
1AA00094  U Wait List Manager e,t,oec Online Online Online In File
1AA00028  U Weight Table Shipping by State Zone c Online Online Online Online
1AA00029  U Weight Table Shipping by World Zone c Online Online Online Online
1AA00093  U Weight Table Shipping by ZIP Code Zone Online Online Online Online
1AA00209 Y Feed (Yahoo! Product Search © Yahoo, Inc.) NA Online NA NA

Miva Merchant is a registered trademark of Miva Merchant. OpenUI, OpenTokens, OpenDesigner, and OpenObjects are trademark of OpenUI Consortium.

Licensing. We license the Emporium Plus modules by domain/mall. Hence, if you have 10 stores under a single mall (merchant.mvc), our modules can be used under the single domain license. No need to purchase multiple module licenses for each of your stores under a single domain/mall. The license is for one domain/mall and cannot be sold, transferred, or re-distributed. If you have a store in a different domain, that would require another license.

MIVA directories - Where are they?

Miva Merchant 2.0 - 4.24 Editing: Editing of the Miva Merchant standard mmui.mv can be as few as a couple lines added to hook a specific function in a module to several different editing locations within the mmui.mv file. If you are using the OpenUI, there will be no need to edit the Miva Corp supplied mmui.mv file because hooks are built into the OpenUI.
If you are running compiled Miva Merchant 4.14-4.24 and need to edit the mmui.mv, you will have to recompile the mmui.mv after editing. This requires that you have the compiler software or a developer with the Miva Merchant Developer's license edits and recompiles the mmui.mv for you. For this reason, most store owners will likely install the OpenUI to eliminate the need to edit and recompile the mmui.mv. I have not updated all of the install documents to reflect the correct path to be used when editing the mmui.mv. If the code insert includes a path with a file name ending in .mv, that should be changed to .mvc. For example
<MvDO FILE="{g.Module_Root$'modules/fulfill/couponrd.mv'}" NAME="l.ok" VALUE="{Coupon_Pass()}">
 would be changed to:
 <MvDO FILE="{g.Module_Root$'modules/fulfill/couponrd.mvc'}" NAME="l.ok" VALUE="{Coupon_Pass()}">

Many (but not all) of the online documents are enhanced read files. The code segments in red show the code which you will add to the applicable file if editing is required. When there is code in black, surrounded by red, it is only the red you are adding. The code shown in black is already in the file you are editing. Normally you are going to copy and paste these red segments into the file you are editing. Do not "view source" to copy the segment as the source code has been modified so that it properly displays in an htm file. For example, the < has been converted to &lt; for display purposes. Hence, copy the red segment as you see it in the displayed help file.

Important note about Miva Merchant 5.x modules. Our 5.x modules currently support the default MIVASQL database configuration in Miva Merchant 5.x. They may support MySQL if you are NOT load balancing by placing the scripts on multiple servers and the databases on a single server. As long as the scripts are on one server, the MySQL should work too. A couple highly respected web hosts have commented on this issue.

Version changes. Over time, modules are updated within the numbered version, e.g. 3.00 may get updated to 3.01. When a module is upgraded, the version number prior to the decimal changes, e.g. 3.01 gets upgraded to 4.00. Generally, updates are maintained within the corresponding Merchant version, e.g. 3.xx would be used with Merchant 3.xx. In a few rare cases, we may have created modules which can be used across several versions. You would have received the newer module initially if this was the case. For example, the PayPal module for 4.xx (uncompiled) can be used with Merchant 2.xx, 3.xx and 4.xx (uncompiled). The compiled modules can only be used in compiled Merchant (version 4.14 and newer). Merchant 5.x requires modules specifically written for 5.x. You cannot use the 4.x compiled module in a Merchant 5.x store.

Updates and Upgrades. Modules are updated to add minor features, fix bugs, and improve user interface within the same Miva Merchant version. Modules are upgraded when you change major Miva Merchant versions, e.g. from 4.13 (uncompiled) to 4.14 (compiled), 4.24 to 5.0, 5.0 to 5.5, 5.5 to PR7, to incorporate major API changes. We do not charge a monthly or annual service fee. Updates are sometimes free but probably incur a small fee. New numeric version licenses are sold, often at a price lower than the full price. You will need the original order number and your merchant url. Check your order email, then see the list below for location to update/upgrade.

Recurring charges. As you know, Miva Merchant is charging you a monthly service fee (which began a few months ago) to use their software and receive updated/upgraded versions. Rather than charge you a monthly service fee, we have opted to charge a small update price only at the time you choose to update/upgrade a specific module in a specific domain. This will be far less than a monthly service fee for each module. Do not copy newer modules into other domains you manage without purchasing the update for those other domains. That would be analogous to buying one copy of Window 7 and then copying it to all the computers in your office. Most modules are only upgraded if you are going to use the new features in the module or in conjunction with new features in the core Miva Merchant. Even with extensive changes in the API recently, less than 10% of our module inventory had been effected by those changes. Less than 6% had to be upgraded. In the past, when some Merchant versions changed, e.g. from 4.13 to 4.14 or 4.24 to 5.0, you had to upgrade every one of your 3rd party modules if you wanted to use them in the newer version. This new system represents a significant savings over the previous "upgrade all" system.

Upgrading/updating modules. The install docs are designed to help you install a module and configure the options. However, there are times when you are going to "upgrade" or "update" an existing module. The configuration options are the same whether it is an install or upgrade/update. The upgrade/update process is a bit different from an original install.

Generic instructions for updating from one version of a Merchant 5.x module to a newer version:
You make same version module updates by selecting admin > global settings > modules (or admin > modules if your version is older than 5.5). Then in the right screen input, search on the module code. I named my modules so the module code is the first part of the module name (less the .mvc). For example, toolkit.mvc would have a module code of toolkit Next, click the edit button to the right of the module listing. Check "Usage Count (Number of Stores)". It must be higher than 0 if it is other than an import or export module. It should be equal to or greater than the number of stores using it in your Miva Merchant if it is a shipping, payment, order fulfillment, utility or system extension module. If it is not, you must stop and do not update the module. We will have to figure out why it is 0 and repair that. If ok, run the file upload, making sure to check the box for overwrite. Then click the Update. DON'T FORGET TO CLICK THE UPDATE. After updating, go to the module's admin screen and make sure everything looks correct, i.e. no errors, license info, etc. The order number needs to be the order number from the original purchase of the module license for this major version number. So if you got the license for 5.x two years ago, then that is the order number to put in the input. If you later buy an update license, keep that new order number for your records but do not insert it in the module's input. If there is a license key input and it says "request license key" and the input is blank, you must click that request license key link and request the key. If a license key is required you will see a message of 240 hours remaining and it will count down until it expires. So while you don't need to get the key immediately, don't wait until the last day before it expires. Also make sure features related to the module are still working.

Upgrade to Merchant 5.x from 4.x or older:
The upgrade from an earlier (1.x to 4.x) version of Merchant to Merchant 5.x is significantly different. Merchant 5.x requires a fresh install even if you had been using the module in your 1-4.x store. VERY IMPORTANT: You MUST update to the latest module version for your Merchant 4.14-4.24 (compiled) store if you want to keep your previous settings. Get the most recent 4.x (compiled) module version from the store you got the original license purchase at (Emporium Plus, Design Extend, MvCool, MIVACentral). Your 4.14-4.24 store must use the standard data directory configuration in order for the 5.x module to properly find and move your old data. Also, the volume pricing, miscellaneous fee, and followon contact modules require that you export their data from the 4.x store to a flat file so the data can be imported into the 5.x store. Once you have updated your 4.x (compiled) module, you can install the 5.x module in your 5.x store. You will add the 5.x module as a new install. If your previous Merchant version is 4.13 or older, you will not be able to move your module's old data to the 5.x store. It will require re-entering the module data after the 5.x module is installed. If it is in a 4.13 or older store, you will need to uninstall the module from the older store before installing in the 5.x store if they are in the same domain.

Upgrade to Merchant 2.x, 3.x, and 4.x:
1) Start your Merchant Admin
2) Select the link "Modules"
3) Scroll down to the link that matches the name of the module you are upgrading
4) Click on that link
5) Select the image for file upload
6) Enter the path on your PC that the file is on and click the overwrite checkbox
7) Upload the file
8) Click the update button
9) Now go to the store configuration screen for the module and enter the configuration settings as discussed in the installation document for the specific module

Warning: Unassigning modules in Merchant 5.x:
There is a bug in some versions of Merchant 5 related to unassigning modules. If you unassign any multi-feature module (when one of the features is component), it will delete the module's database but not remove it from the store. That is a major MM5 bug and has been reported. You are supposed to unassign it in reverse order of install. First you MUST remove every token on every page for the module. You need to remove it from the items list from every page that it is in the items list. Then you need to remove it from the master items list. Then you can unassign it from the primary menu. If you do it out of order, you will likely get an error that the database is missing and will be stuck. You cannot just go back and do the steps you missed and all will be well. In most cases you will need to do the steps you missed, then try assigning and unassigning the module under its primary menu. You can also try going to admin:modules and searching for the module. When you click the Edit button, it will tell you how many stores it is in. If it is 0, you should be able to click the Delete button and remove the module from the store. Make sure it is only the module you are removing from the store. Since unassigning a multi-featured module is so complex, you probably should think twice before unassigning a module. Ask yourself, why are you unassigning? Is there something not working? If that is the reason, request support from the vendor before unassigning.

Missing component module and missing database errors in Merchant 5.x:
If you get a missing component module or missing database error, there are steps you can take to remedy the situation. See the info doc on this subject.

Online Support: In addition to the install docs, the module product pages often have screen shots from admin and merchant which provide visual help on how the module is setup and functions. If AFTER reading and implementing the install notes and reviewing the product page, you have a problem, please use our Support System to contact us. Don't forget to include your order number (not license key) and full Merchant url. Direct emails may go unanswered or there may be long delays before an email in one of our mailboxes is discovered. DO NOT EMAIL DIRECTLY. Please use the Support System . If you have a serious error (e.g. store is down), you can inactivate a module under admin > modules while waiting for support by unchecking the Active box and clicking Update.


Copyright © 1996-2010 William Weiland. All Rights Reserved.
Inquiries | Privacy | Site Map | Master List