In admin, under your store, click on the link for the Utilities. Assign the Save Basket to Giftlist module and Update it to install it in your store.

Click the Save Basket to Giftlist tab to enter the configuration setting. Complete the inputs as applicable.

FTP the help file giftlist.htm to the modules/ui/ directory. You can edit that file to add your own information about the Giftlist.

You'll need to FTP a gif file that signifies add to cart consistent with your site. Name it add2cart.gif and put it in /Merchant2/graphics/ or /Merchant/graphics/ depending where your Merchant 2, 3, or 4 is installed.

The compiled version of this module licensed on or after November 7, 2003 has a new file called cim_new.mvc which you need to install. Install through admin as a store system extension module.

Several edits are required in the mmui.mv file.

1) In the mmui.mv file, function UIModule_Dispatch, include the following code. Put this code in the latter half of the function, not near the beginning of the UIModule_Dispatch function.
<MvIF EXPR = "{ g.Screen EQ 'GIFT' }">
<MvDO FILE="{g.Module_Root$'modules/util/giftlist.mv'}" NAME = "l.showtitle" VALUE = "{GiftList_Open_Store()}">
<MvASSIGN NAME="l.ok" VALUE="{MMUI_Begin_Screen(Stores.d.name $ ':' $ Expire.d.listtitle, 0, 0 )}">
<MvIF EXPR = "{g.Action CIN 'VIEWADPR'}">
<MvASSIGN NAME = "g.myphone" VALUE = "{glosub(rtrim(g.myphone),' ','')}">
<MvASSIGN NAME = "g.myphone" VALUE = "{glosub(g.myphone,'(','')}">
<MvASSIGN NAME = "g.myphone" VALUE = "{glosub(g.myphone,')','')}">
<MvASSIGN NAME = "g.myphone" VALUE = "{glosub(g.myphone,'.','')}">
<MvDO FILE="{g.Module_Root$'modules/util/giftlist.mv'}" NAME="l.ok" VALUE="{Display_Giftlist(toupper(g.fi)$toupper(g.li)$glosub(toupper(g.myphone),'-',''))}">
</MvIF>
<MvIF EXPR = "{g.Action EQ 'ADD'}">
<MvDO FILE="{g.Module_Root$'modules/util/giftlist.mv'}" NAME="l.ok" VALUE="{Save_To_Giftlist()}">
</MvIF>
<MvIF EXPR = "{g.Action EQ 'ADDONE'}">
<MvDO FILE="{g.Module_Root$'modules/util/giftlist.mv'}" NAME="l.ok" VALUE="{Save_One_To_Giftlist_Prompt()}">
</MvIF>
</TD></TR></TABLE>
<MvFUNCTIONRETURN VALUE = "{ MMUI_Close_Store() }">
</MvIF>

2) If you want to give shoppers the ability to save the entire basket to the giftlist with one key press, use this option. In the mmui.mv, function MMUI_DisplayBasket, near the end of the function include the following 7 lines between the last </TABLE> and the </MvIF>. The </TABLE>* and </MvIF>* tags are shown here for orientation.
* </TABLE>
<MvIF EXPR = "{g.Screen EQ 'BASK'}">
<BR>
<TABLE width="100%" border="0">
<TR><TD align="center">
<MvDO FILE="{g.Module_Root$'modules/util/giftlist.mv'}" NAME="l.ok" VALUE="{Basket_Save()}">
</TD></TR></TABLE>
</MvIF>
* </MvIF>

3) If you want to give shoppers the ability to save the product the specific product they are view directly to the giftlist without putting it in the basket first, use this option. In the mmui.mv, function MMUI_ProductDisplay, locate the code that draws the Add to Basket submit button. You will probably want to insert the Save to List button just below the Add button. Be sure it is below the closing </FORM> tag for the Add to Basket button. You will probably want to use the table tags TR and TD to align the button on your page, depending on where you decide to insert the button. Insert the following line at the location you decide.
<MvDO FILE="{g.Module_Root$'modules/util/giftlist.mv'}" NAME = "l.displaybutton" VALUE = "{Save_One_To_Giftlist_Button()}">

4) You need to have an input for potential gift givers to enter the code for the recipients gift list. The next three are examples of three ways to accomplish this. You can use one or more options.
- Option 1 - In the mmui.mv file you can insert the following line. I choose to put it in the MMUI_Search function.
In Merchant version 4.x locate the end of the search FORM. You will see the lines marked with an asterisk below. Insert the one line between them.
* </FORM>
<MvDO FILE="{g.Module_Root$'modules/util/giftlist.mv'}" NAME="l.ok" VALUE="{Giftlist_Prompt()}">
* <MvIF EXPR = "{ len( g.Search ) }">
- Option 2 - In the mmui.mv file you can insert the following line. Near the end of the MMUI_Search function you can place the Gift List Prompt form.
In Merchant version 4.x locate the end of the MMUI_Search function. You will see the lines marked with an asterisk below. Insert the one line between them.
* </MvIF>
<MvDO FILE="{g.Module_Root$'modules/util/giftlist.mv'}" NAME="l.ok" VALUE="{Giftlist_Prompt()}">
* <MvIF EXPR = "{ MMUI_Store.d.srch_foot ) }">
- Option 3 - If you want to display the Gift List lookup form below the category list, you could include the following just after the Category_Tree call and before the last </TABLE> tag in the MMUI_Begin_Screen function.
<MvDO FILE="{g.Module_Root$'modules/util/giftlist.mv'}" NAME = "l.showviewbutton" VALUE = "{GiftList_Open_Store()}">
<FORM METHOD = "post" ACTION = "{g.sessionurl}">
<TR><TD>
<INPUT TYPE = "hidden" NAME = "Store_Code" VALUE = "{encodeentities(Stores.d.code)}">
<INPUT TYPE = "hidden" NAME = "Action" VALUE = "VIEW">
<INPUT TYPE = "hidden" NAME = "Screen" VALUE = "GIFT">
<INPUT TYPE = "hidden" NAME = "Module_ID" VALUE = "{encodeentities(g.Module_ID)}">
<INPUT TYPE = "text" NAME="myphone" VALUE="" size="17">
<MvIF EXPR = "{len(Expire.d.viewlisti)}">
<INPUT TYPE = "image" ALT = "{encodeentities(Expire.d.viewlist)}" SRC = "{encodeentities(Expire.d.viewlisti)}" BORDER = 0>
<MvELSE>
<INPUT TYPE = "submit" NAME = "NoSave" VALUE = "{encodeentities(Expire.d.viewlist)}">
</MvIF>
  <MvASSIGN NAME = "l.jsurl" VALUE = "{'JavaScript:PopupHelp(\'' $ Domain.d.base_url $ g.Merchant_Version $ '/modules/ui/giftlist.htm\')'}">
<A TITLE = "Help" HREF = "{l.jsurl}">
<IMG SRC = "{encodeentities(Expire.d.helpgif)}" BORDER = 0></A>
</TD></TR>
</FORM>

5) In order to provide the Javascript help popup you need to add the following code in mmui.mv, MMUI_Begin_Screen function, just before the </HEAD> tag.
<SCRIPT language="JavaScript">
<!--
function PopupHelp(helpfile)
{
window.open( helpfile , 'Help', 'toolbar=no,location=no,directories=no,status=no,scrollbars=yes,resizable=yes,copyhistory=no,width=200,height=150' );
}
// -->
</SCRIPT>

6) If you are going to have attributes in your products which could be put on the giftlist, you'll need to add the following in the mmui.mv UIModule_Product_Attributes function just below the hidden input for quantity.
<INPUT TYPE = "hidden" NAME="myphone" VALUE="{encodeentities(g.myphone)}">
<INPUT TYPE = "hidden" NAME="remove" VALUE="{encodeentities(g.remove)}">
Note: Attributes are not stored directly in the gift list record as attributes. They are placed in the comments field which is stored with the record. For example, the recipient might put something like red, blue or green in the comments field. Then when the buyer views the gift list, they will know what to choose from the available attributes at the time of purchase.