Copyright © 1999, William Weiland
Provide an easy interface for visitors to refer your site URL to their friends. It uses the Miva SMTP capability. The subject and body of the Tell a Friend message is configurable through the Merchant admin interface. If the customer sends this email when they are on a specific product screen, a second link to the product is included in the email. Also configurable is the customer screen and optional log and store emails.
Use the Merchant admin upload feature to upload the module. Once uploaded, click the Add button to add it to the mall/domain.
In admin, under your store, click on the link for Utilities Configuration Screen. Assign the module and Update it to install it in your store.
Click the link for Mail Generator to enter the configuration settings.
Enter data into the applicable input fields.
Subject
Enter the text you want for the subject of the email that is sent.
Letter Body
Enter the body of the letter, including your store URL you want them to have
as a link.
Store Email (Optional)
Include an email address only if you want to get an email whenever someone
sends a Tell-A-Friend email.
Form Button
Enter the text you want for the text of the button for Tell-A-Friend.
Form Button Image (Optional)
If you want to use a graphic for a button, enter the path, e.g.
graphics/tell.gif
Form Button Location
Choose from among the eight possible locations on the screen to put the button.
In addition to the eight locations, you can combine the mid product screen
location with the nav bar or category column location.
Screen Title
Enter the text you want for the title at the top of the screen.
Font Size, Face, Color
Enter the settings you want for the FONT tag.
Table Background
Enter the color you want for the form the customer sees when entering the
Tell-A-Friend email info.
Flat File Log
You can create a flat file log of each Tell-A-Friend entry. It includes the
date, from email, to email and the product code if it was sent from a specific
product screen. The flat file is stored in the store data directory under a
subdirectory called mailgen. The file name is mailgen.dat, e.g.
Merchant2/00000001/mailgen/mailgen.dat You can periodically retrieve the file
for analysis or crediting those customers who refer people to your site.
It can be deleted and it will start anew with the next Tell-A-Friend entry.
If you are using the Miva Merchant User Interface (mmui) you will need to make some very simple edits to the core files. Be sure to do that with a text editor (NO WYSIWYG editors) such as Programmer's File Editor (PFE) so as not to damage the mv files. ALWAYS BACKUP your unmodified mv files in case you make a mistake.
1) Locate the function UIModule_Dispatch in the mmui.mv file. Include
the following code in the latter half of the function, not near the
beginning of the UIModule_Dispatch function.
<MvIF EXPR = "{ g.Screen EQ 'TELL' }">
<MvDO FILE="{g.Module_Root$'modules/util/mailgen.mv'}" NAME = "l.showtellbutton" VALUE = "{MailGen_Open_Store()}">
<MvIF EXPR = "{g.Action}">
<MvDO FILE="{g.Module_Root$'modules/util/mailgen.mv'}" NAME="l.ok" VALUE="{TellFriend()}">
<MvASSIGN NAME = "l.ok" VALUE = "{ MMUI_StoreFront() }">
<MvELSE>
<MvASSIGN NAME="l.ok" VALUE="{MMUI_Begin_Screen(Stores.d.name $ ': ' $ MailGen.d.screenhdr, 0, 0 )}">
<MvDO FILE="{g.Module_Root$'modules/util/mailgen.mv'}" NAME="l.ok" VALUE="{TellFriend()}">
</TD></TR></TABLE>
<MvFUNCTIONRETURN VALUE = "{ MMUI_Close_Store() }">
</MvIF>
</MvIF>
2) If you want to display the Tell a Friend button below the category
list, you could include the following just before the last </TABLE> tag in
the mmui.mv file's MMUI_Begin_Screen function.
<MvDO FILE="{g.Module_Root$'modules/util/mailgen.mv'}" NAME = "l.showtellbutton" VALUE = "{MailGen_Open_Store()}">
<FORM METHOD = "post" ACTION = "&[ g.sessionurl ]">
<TR><TD>
<INPUT TYPE = "hidden" NAME = "Store_Code" VALUE = "&[ Stores.d.code:entities ]">
<INPUT TYPE = "hidden" NAME = "Screen" VALUE = "TELL">
<MvIF EXPR = "{(g.Screen EQ 'PROD') AND len(g.Product_Code)}">
<INPUT TYPE = "hidden" NAME = "Old_Screen" VALUE = "PROD">
<INPUT TYPE = "hidden" NAME = "Product_Code" VALUE = "&[g.Product_Code:entities];">
</MvIF>
<MvIF EXPR = "{len(MailGen.d.promptbtni)}">
<INPUT TYPE = "image" ALT = "&[MailGen.d.promptbtn:entities]" SRC = "&[MailGen.d.promptbtni:entities]" BORDER = 0>
<MvELSE>
<INPUT TYPE = "submit" NAME = "TellEm" VALUE = "&[MailGen.d.promptbtn:entities]">
</MvIF>
</TD></TR>
</FORM>