Make sure that you have assigned it to your store as well as installing it with "
Add Module
"
This module requires one license per use. You won't need to repeat the installation, but you will need a different license key to assign it to your new store.
faq
I am getting error unexpected '<' and get no notification at some orders!
Your product codes, names or descriptions contain forbidden characters out of HTML tags, such as
<
, or
>
instead of their HTML entities
<
/
>
. Either replace those characters in the text with their entities (but do not remove your HTML tags, if you have any in the product fields), or select the option
"Don't parse HTML, show tags"
,
MmPSLP
will then ignore the characters.
faq
PRINTING
Why don't my customized colors and/or images print out correctly on my printer?
If you use
Microsoft Outlook
, verify that
MSIE
is set to print the background: in MS Internet Explorer's menu, go to
Tools/Internet Options/Advanced/Printing
and be sure to check the
'Print background colors and images'
option. With other mailers / browsers it should be similar.
faq
Why don't my customized colors and/or images print out correctly on my printer?
If you use
Microsoft Outlook
, verify that
MSIE
is set to print the background: in MS Internet Explorer's menu, go to
Tools/Internet Options/Advanced/Printing
and be sure to have checked the
'Print background colors and images'
option. With other mailers / browsers it should be similar.
faq
How do I change the font size on the printed invoice?
You can set font size and face control in the module's Admin interface in Order Fulfillment Configuration - you can use also the
px
(pixels) and
pt
(points) units.
Additionally, you can make changes in MSIE / Outlook or other clients too. In MSIE, go to
View
/
Text Size
or define a
User Style Sheet
in
Tools
/
Internet Options
/
Accessibility
In Netscape use
Ctrl-[
and
Ctrl-]
and in Opera
+
and
-
keys to increase/decrease the font size.
faq
How can I block the Internet Explorer page header and footer from printing?
Go to
File
»
Page Setup
and delete the
Header and Footer
.
faq
CUSTOMIZING THE LOOK
How do I customize the invoice?
You can change the colors and fonts of the invoice through the Admin form and you can modify the header and the footer of the invoice as much as you want if you respect usual HTML standards. You can use tables, forms, images or any other HTML elements. Feel free to use
Style Sheet directives
within individual tags if you are comfortable with them.
Do not forget to
close all open tags
(font, table, etc..). Use of JavaScript, Flash, Active-X, Real-Audio/Video and other active elements may work with some e-mail clients, bit may be limited with others. Keep in mind that some users turn these options off in their email programs, which may result in the message being rejected.
A hacker-trick for advanced HTML designers
familiar with CSS: the values of the Admin fields for the font parameters are being embedded into the style sheet of the message, so you can add any general CSS blocks here. Try to add a short string and look afterwards into the HTML source of the generated e-mail to see how it works. You are only limited with the length of the field. If there is enough interest I may add a fully editable CSS parameter block in one of the future releases.
faq
Why can't I see the images (or product thumbnails)?
HTML e-mail from the MmHTML modules contains
only hyperlinked graphics
and so the images/thumbnails are hyperlinked to your web site too. This means that the graphics are only visible if the recipient is
online
. A functionality to send the graphics together with the e-mail as an attachment was not made for two main reasons:
-
It is not polite (although this point does not apply in the case of Merchant notification :)
-
Technically it is more difficult. it is not possible with plain Miva Script, it would require an external program, such as my
MimeConv v2
- but that would mean a lot of hassle with installations, because each platform requires another executable binary and individual setup, so the costs for such module, along with the support, would be multiple of the current solution.
faq
How do I change the
background color of my tables
in the header or footer?
You have to use styles to assign the color in the cells:
<TD STYLE="background-color:#DDDDDD">
Better yet, for keeping compatibility with older e-mail clients, use the HTML directive too:
<TD BGCOLOR="#DDDDDD" STYLE="background-color:#DDDDDD">
You can also add an additional Style Sheet into the HTML header in this way, to avoid repeating the color definition in each cell tag and to reduce the e-mail message size:
<STYLE TYPE="text/css">
.myheader TD {background-color:#DDDDDD;}
</STYLE>
</HEAD><BODY>
<table CLASS="myheader">
Of course, you can also add any other CSS definitions, like font formatting. Please note that normally (when not inserting any code into the HTML header) you do not need to put the
</HEAD>
and
<BODY>
tags into the MmHTML user header, but in the case you do, they will be recognized properly by the module.
Do not use
the opening
<HEAD>
nor
<HTML>
tags in the MMPSLP header!
faq
I have already customized preset Miva Merchant column headings on my Miva Merchant pages by editing mmui.mv. Will be able to change these presets in customer/merchant e-mails?
Sure! Very easily. The texts are at the very top of the script in a single variable:
<MvASSIGN NAME="g.MHMC_prdEn" VALUE="Code,Name,Weight,Quantity,Cost,Price/Ea.,Total">
faq
On the screenshots at the bottom it says something like
'generated by Truxoft's notification module'
. Could all these be removed?
Yes, of course!
You can put whatever you want in this place. It is in the header / footer settings.
faq
How do you modify the customer / merchant invoices?
Through the settings of the
MmHTMLc
(truXoft Customer Email), and the
MmHTML
(truxoft Merchant Email) module in the
Order Fulfillment Configuration
.
faq
How do I include background image as in your demo in the invoice?
The simplest way is including a
<BODY BACKGROUND="http://yoursite.com/path/img.gif">
tag into the invoice header.
Note that you
must not
include neither the opening
HTML
and
HEAD
tags, nor the closing
/BODY
,
/HTML
tags neither in the invoice header nor in the footer. Only closing
/HEAD
and opening
BODY
tags are allowed (but not compulsory) in the invoice header.
faq
How do I change the date / time format?
In advanced settings, modify the
Date & Time Format
as needed.
faq
How do I change the time zone?
Go to advanced settings and change the
time zone offset
. Usually it will be either the difference (
in hours
) between GMT and your local time or the difference between your time and the time at the location of your server. Positive numbers increase the time displayed on the invoices.
How can I display the order prices on the packing slips?
You have to go to the MmPSLP properties in
Admin » Stores » store » Order Fulfillment » truXoft Packing Slips » Advanced interface
and check the price columns.
If you need also the order totals and charges below the list, you would need to change one parameter manually in the config database. I did not assume somebody would really need it, but have included it for possible future use. There is no control of the parameter in the admin interface, but if necessary, I'll add it there. Let me know if you want it.
top
How can I hide the Billing address?
In
Admin
»
Stores
» your store »
Customer Fields
»
Billing Information
select
Hidden
. This will hide the Billing Section entirely for the Miva Merchant store.
Additionally, in
MmPSLP
you can hide the billing address in the advanced options independently on the global Miva Merchant settings.
top
How can I hide certain address fields (e.g. fax number, company)?
In
Admin
»
Stores
» your store »
Customer Fields
select
Hidden
at the fields you want to hide. This will hide those fields for the store.
top
As I customize the layout - is there any way to see my changes?
Open the Ultra Batch in another browser window and reload it each time you make a change in the settings. You may want to set a filter so that you see just a single order to make it faster.
top
I want to move the quantity column to the left, next to the part number.
Disable the
Quantity
column in the advanced settings and put the following code into the
User-Defined Column
expression:
OrderItems.d.quantity
top
Is there a way to add the payment type to the Customer Invoice / Packing Slip?
Yes, insert the token
%pay_data%
to the HTML Header or Footer in the module settings. In the same way you can also display the Shipping Method - token %ship_data%.
top
How can I remove the email address (phone, fax, company,...) from the address fields in the notification?
You can disable the e-mail, similarly as any other field in
Admin » Stores »
"your store"
» Customer Fields
, setting it as hidden.
top
Is there a preview available, for testing without submitting new orders?
Yes, the preview exists - if you are owner of the
Ultra Batch
, you can open a short batch report in a separate browser window and can reload the page after each change in MmHTML / MmHTMLc to see the effect immediately without submitting any orders.
top
How can I change the appearance of the attribute text?
Change the definition of the
"Small font size"
in MmPSLP settings. You can change not only the f
ont-size
, but also
font-family
,
font-weight
or other CSS attributes of the font. For example for displaying product attributes in normal font instead of the default italic, you can add the following CSS definition:
font-style: normal;
faq
ADDITIONAL FIELDS
Is it possible to have the SB21 / modStop OrderXtra (or another 4th party module) included in the notification?
Yes, it is.
See above for variables (form fields) available on the last checkout page (e.g. all Addendum fields). The values of some other 4th party module vendors have to be pulled out of the 4th party module data files. This means it must be individually coded for each 4th party module with additional fields. There are two ways available:
-
If you are a Miva Script coder: You create a file called
xmmpslp1.mv
(containing the numeric ID of your store - by default 1) and put these three functions in it:
column()
,
header()
and
footer()
. You can use any Miva Script commands and functions to open the respective files and have them inserted in the respective places of the invoice - both for the notification and the batch reports
. The file is to be place in the same directory as
MmPSLP.mv
(
...modules/fulfill/
)
-
If you do not want to mess with the coding, you can buy the
MmEXT module
that does it for you.
faq
I see the additional fields in Ultra Batch, but nothing comes in the notification.
Be sure that you have followed
MmEXT
installation instructions
correctly, especially the part about the
order of modules
. You can change the expression to display both, the MmEXT generated variables (e.g.
Addendum.var1
) and the form field variables used on the checkout page (e.g.
g.question1
). This way, if the order of modules is wrong, the form field variables will be displayed in the notification and the MmEXT variables in the Ultra Batch reports. However, if the order of the modules is correct, the additional fields would display duplicated (use just the MmEXT variables in that case).
faq
Token %affil_code% does not work. What's wrong?
There is a small bug (or a forgotten feature) in Miva Merchant. It does not write the affiliate code to the respective field in the orders database. If you want to use the token for the affiliate code, you have to add the following code into the
Merchant2/4.xx/lib/db.mv
file. Open it in a text editor (such as
Notepad
) and search for the following block of code (in the v4.12 db.mv it is at line 6574, and a=it is the line 6591 in v4.13):
<MvIF EXPR = "{ g.Features:Affiliates:Enabled }">
<MvDO FILE = "{ g.Module_Feature_AFF_DB }" NAME = "l.ok"
VALUE = "{ Affiliate_Create_Order( l.session_id, l.total ) }">
</MvIF>
Then insert the following modification:
<MvIF EXPR = "{ g.Features:Affiliates:Enabled }">
<MvDO FILE = "{ g.Module_Feature_AFF_DB }" NAME = "l.ok"
VALUE = "{ Affiliate_Create_Order( l.session_id, l.total ) }">
<MvCOMMENT> ### custom modification !!! ### </MvCOMMENT>
<MvASSIGN NAME="Orders.d.affil_code" VALUE="{AffiliateSession.d.affil_code}">
<MvUPDATE NAME="Orders">
<MvCOMMENT> ### end / custom modification !!! ### </MvCOMMENT>
</MvIF>
Please note that the change will have effect only on newly submitted orders.
faq
Can you provide more detailed information on how to use external commands?
Create a file called
...modules/fulfill/xmmpslp1.mv
(containing the real numeric ID of your store instead of 1) and put these three functions in it:
column( )
,
header( )
and
footer( )
. You can use any Miva Script commands and functions to open the respective files and have them inserted in the respective places of the invoice - both for the notification and the batch reports. The functions have no parameters. They should return the text you want to display.
Pointers to the
Order
,
OrderItems
and many other databases are already set in the moment of calling the functions and you should
not
move them.
There is an empty skeleton of such file here:
<MvFUNCTION NAME="header" STANDARDOUTPUTLEVEL="">
enter code to be executed in the header of the notification here
<MvFUNCRETURN VALUE="{l.myText}">
</MvFUNCTION>
<MvFUNCTION NAME="footer" STANDARDOUTPUTLEVEL="">
enter code to be executed in the footer of the notification here
<MvFUNCRETURN VALUE="{l.myText}">
</MvFUNCTION>
<MvFUNCTION NAME="column" STANDARDOUTPUTLEVEL="">
enter code to be executed in the user-defined column of the notification
(will be executed for each product, or (if selected) for each attribute)
<MvFUNCRETURN VALUE="{l.myText}">
</MvFUNCTION>
faq
Can MmPSLP display pins or download info from VikingCoders' modules?
Yes, the module has a built-in interface to VikingCoders'
VC_PIN
and
VC_SOFTGOODS
modules.
Simply put the token
%vc_pin%
, resp.
%vc_softgoods%
into the
Additional Miva Footer - Miva Expression
field (
not
the
HTML footer
!)
Note:
you can also use the
xmmpslp00000001.mv
external file for serving serial numbers or PINs from a flatfile or a database. Contact us if you are interested. Softgoods may be served with the
MmPASS
module for the best results.
top
Troubleshooting
In case of troubles, before contacting the support, please be sure to:
-
read the
FAQ
-
check the
changelog
and
update
the module to the latest version
-
read
known limitation and bugs
top
Wish List
top
Change Log
top
