Viking Coders Miva Merchant Module Support and FAQ - Most Recent FAQ Entries:

I have the UPS Custom Integration configured so that customers select on the OINF screen (customer information) whether or not their address is residential and commercial. If they select "commercial" they see the correct shipping in the shipping selection list but on the page after that (OPAY- Payment Information) they see the residential charge. Why?

Fri, 11 Jul 2008 14:21:00 GMT

This is being caused by the Shipping Supermod module.� If you make that module inactive (by going to it's page under >Modules and unchecking the "active" box) the UPS shipping rates will again be correctly displayed.

The problem lies in the way the Shipping Supermod does what it does.� Instead of letting each individual shipping module calculate shipping, the Shipping Supermod intercepts the process. The first time it displays the shipping to the commercial customer the rates are correct (the Shipping Supermod correctly contacts the UPS Custom Integration to have it calculate shipping at that point and the "residential" option is correctly handled.�� However, after the customer selects a shipping method and proceeds to the payment information page the Shipping Supermod "breaks".� It deviates from the way Merchant normally handles the saving of the shipping method.� Instead of passing this responsibility on to the UPS Custom Integration as it should, it instead calculates the shipping rates all over again, but this time since it's being done at the wrong place, the "residential" option is lost and the address is treated as commercial.

To work around this add e item:

<mvt:item name="brokups_carry" param="" />l;

to your OSEL page (Shipping/Payment selection screen) and make sure that you have the item "brokups_carry" assigned to that page.� This token adds a hidden form field to hold the "residential" selection that the customer made on the previous screen so that when the Shipping Supermod recalculates shipping it will be available to it.� And you'll need to make sure using the latest version of the UPS Custom Integration module file (always a good idea).

I would like to conditionally display something for a product but only if the current level is '3'. How do I do this?

Thu, 03 Jul 2008 21:37:00 GMT

To get this functionality, use the token/item:

This will define a global variable consisting of:

g.BROK_INVENTORY:tracking
g.BROK_INVENTORY:product_id
g.BROK_INVENTORY:attr_string
g.BROK_INVENTORY:error
g.BROK_INVENTORY:count
g.BROK_INVENTORY:level
g.BROK_INVENTORY:level_name
g.BROK_INVENTORY:short_message
g.BROK_INVENTORY:long_message
g.BROK_INVENTORY:attr_message
g.BROK_INVENTORY:permit_sale
g.BROK_INVENTORY:permit_display

You can then test the variable's values such as:

the level is 3

or display a value with:

&mvt:global:BROK_INVENTORY:level_name;

which will display the current level's name.

Keep in mind that you'll need to use the item

at a point in the template where an individual product's information is being displayed.� For example, it won't be properly defined in the global header and footer (at least not consistently) but could be used inside the:

in the "Basket Contents" template field of the BASK screen since in that iterator a specific product is being handled.

Is there any way to configure specific global headers and footers for each affiliate that will show up any time a customer they referred is shopping in the store?

Mon, 02 Jun 2008 22:28:00 GMT

There is a sub-tab for each individual affiliate (and also on the main "Options" tab where defaults can be set) that permits particular "design settings" to be configured for that affiliate (and as a default on the main "Options" tab).� Soon these "design settings" will include most of the store's configuration options (such as fonts, colors, etc.) but currently only the Global Header and Footer are supported.

You'll find the fields to specify the header and footer on the "Design Settings" tabs.

Once configured, the global header and footer can be displayed with the token:

&mvt:global:AffiliateData:GLOBAL_HEADER;

which will NOT process any tokens in the field.�� In the alternative, you can have the Affiliate Manager process the field for the same tokens that are available for use in the invoice by using the item:

(in both of those cases you� would display the global footer by changing GLOBAL_HEADER to GLOBAL_FOOTER).

In addition, the module sets a global variable:

g.AffiliateData:use_design

which will have a value of 1 if the module has been configured to use the Design Settings (currently just the global header and footer) for that affiliate.�� So you can conditionally display the global header by checking that variable.� For example, to display the affiliate's global header if that affiliate has been configured to use the design settings and to display the default global header if not you would put the conditional around the standard global_header token:

��

Similarly, for the footer:

��

If you want the Affiliate's header/footer to display on only some pages, then the above approach is the one to take (i.e. replacing the global_header and global_footer items with the conditional)� On the other hand, if you want the Affilate's global header/footer to display on every page in your store then instead of modifying each page's template you could modify only the templates for the global header and footer. You can edit them by clicking on the "Global Header & Footer" tab on any page� in the 'Pages" section of your store's admin (the same templates will apply to every page that uses the global_header and global_footer items; by default, I think that's every page in stock Merchant).

In the Global Header template you would replace the contents with:

contents of default global header

and in the Global Footer template:

contents of default global footer

Of course, anything that would be common to the Affiliate' headers & footers and the global header & footer can be outside of that conditional so that it will always display.

To determine if the affiliate specific design settings should be used, the module first checks to see if the individual affiliate is configured on it's "Design Settings" tab to use the settings.� If not, it checks to see if default "Use design settings?" option is set (on the "Design Settings" tab under "Options").� If that is set, the module uses the settings configured on that tab, if not, then the module does not display anything for the design settings.

To get a bit more detailed on how the "design settings" feature works will require more technical detail.� The "design settings" feature actually sets a global structure variable g.AffiliateData which contains all of the referring affiliate's data in it (you'll obviously want to be careful what of the affiliate's data you expose to your customers).� For example, the affiliate's first name is set in the variable:

g.AffiliateData:fname

and this can be displayed in the template,without token processing, with the token

&mvt:global:AffiliateData:fname;

and with token processing with the item:

NOTE that for the item to work you'll need to make sure that the module's item, BROK_AFFILIATES is assigned to the template in which you're using it.

I pay my affiliates with gift certificates from your Gift Certificate Manager module. I would like to give my affiliates the ability to view the certificates that they received for payment is this possible?

Thu, 29 May 2008 14:42:00 GMT

�

(You can find the Gift Certificate Manager module here ).

�Yes, as of version 4.33c, the Affiliate Manager� - Affiliate Login, module will display an extra tab "Certificates" in it's admin if the Gift Certificate Manager is installed.� On that tab, you can configure the html used for the main certificates page (in the "Certificates page template") as well as the template used to list the certificates (in the "Certificates Listing template").

You can add a link to this new page by adding the token:

%certsbutton%

to your main page template (in the "Main page template" field on the "Main Page" tab).� The button image (if any) and alt text (which will be used in lieu of the image to create the link if no image is configured) can be set at the bottom of the "Main" tab.

In my store I added an additional cell to the table which displays the buttons so that it looked like:

In the "Certificates Listing template" you can use the following tokens to dispaly the key's information:

%key% �� the certificate's key
%expire%�� the certificate's expiration date
%balance%�� the certificate's balance
%start%�� the "start date" (aka "issue date" if that wasn't changed in admin) of the certificate

%certlink% �� displays the url to "view the link", used like: View Certificate
%for%�� the recipient's name
%address1%
%address2%
%note%��
%foremail%�� the recipient's email addresss

All of the tokens available for the main page are currently in the "Certificates page template" field but if you have any additional tokens you'd like to see available there let me know.

Is there any way to add a negative number to the basket total, for example, to give a discount to a customer?

Thu, 22 May 2008 17:51:00 GMT

Yes, you can do this with the "special items" feature (described here ). It will let you add an item to the basket which has a negative price.� Of course you can also manually change the price of products once they have been added to the basket to give a discount specific to a particular product.

%ordersbutton%

%hitsbutton%

%duebutton%

%paidbutton%

%certsbutton%