STEP TWO: Generate "Add to Registry" HTML button form NOTE: Registry Valet gift registry software works with BOTH static HTML-based catalog pages AND dynamically generated catalog pages using ASP, PHP, ColdFusion, .NET, and many others. The information below is somewhat targeted toward static HTML based web sites. For dynamically generated catalog pages using ASP, PHP, ColdFusion, .NET, osCommerce, or others, some fields in the "Add to Registry" form must be URL encoded. See below for more information and samples. If your web site's catalog pages are dynamically generated and you need further help or assistance, please contact support at (919) 477-2100 and press option 2 for support. Now, you will use the Registry Valet Code Generator tool to create the small HTML form that will allow visitors to your site to place gift items in their bridal registry, gift registry or wish list. FAQ: Do I have to create a separate "Add to Registry" button for each item on my web site? YES. Each item on your web site must have it's own unique "Add to Registry" form including the item's unique "Add to Cart" form embedded in it. Note that if you intend to use the post-back system, the add-to-cart code must be a form. If you attempt to use a link instead of a form, our system will not be able to insert the appropriate information into your add-to-cart form and the post-back system will not work. NOTE: If your site uses PHP, ColdFusion, ASP, or another web language to dynamically generate your catalog pages from a database, we can help with code that you can embed in your page templates to automatically include the "Add to Registry" button. Scroll down to the bottom of the page for more information and examples. Again, inside the administrator, click on the Code Generator icon in the main menu to enter the code generator page. In the icon menu to the left you will see the HTML Form Generator icon. It looks like this: Click this icon and the code generator form will popup in a new window. If this window does not appear, be sure that your browser allows popups for this page. The window will look similar to this: Now, choose a gift item for sale on your web site that you would like shoppers to be able to place into their gift registry and fill out the form with the required information. Be sure that you do not include a "$" in the item price. Click the "Generate Code" button and the HTML form will be displayed. About the "Add to Cart code" and "Option Selection Code" fields This is the most complicated part of setting up Registry Valet. If you have any questions about this process, please feel free to call or email and we will be happy to help you. Registry Valet Support: (919) 477-2100 and press option 2 for support   support@agenne.com Why do I have to put my "Add to Cart" code into this form? When a registrant places a gift item into their gift registry, they generally want their friends and family to be able to visit their list of items and simply click an "Add to Cart" button to buy a gift item. If you do not include your item's "Add to Cart" form, there will be no way for their friends and family (your customers) to buy a gift from the list. What if I am not selling my items online? There are many reasons why you might not be selling items online, but still need wish list or gift registry software. So, if you are not actually allowing customers to buy online, you can use the "Add to Cart code" field for another purpose! Since the contents of this field are displayed next to each gift in the registry, you can put any text or HTML you like in this field. For example, you might want to have some text such as "In Store Purchase Only", or "Call to buy this gift by phone". You can use any HTML you want, or just type your message. Add to Cart Code Field When a shopper is viewing one of your customers' gift registry lists, you will want there to be an add-to-cart button next to each item. This button will ONLY be displayed using the code that you type or paste into this field. If you leave it blank, there will be no button next to each item in the gift registry list. Each item that you sell on your site probably already has an add-to-cart form so that shoppers can put it into their shopping cart. It is this form that you must type or paste into the "Add to Cart code" field before you click the "Generate" button. If you have gift items that include options such as size, color, etc., see below before you paste anything into this field. OPTION SELECTION Do your items have options such as size, color, monogram, or other options that your customers can choose when adding them to their shopping cart (and gift registry)? If so, in order to make Registry Valet software work with these options correctly, you must remove the option code from the form above and paste it into the Option Selection code field. Here's why: The option selection code, whether radio buttons or dropdown list, will need to be available to the registrant when they place the item into their gift registry. By removing the options and pasting them into the option selection field, they will be included in the standard "Add to Registry" form and is, without encoding. The "Add to Cart" form will be encoded for storage in our database and at the time that a friend or family member visits a registrant's gift registry list, the option selection will be automatically added to the decoded "Add to Cart" form. The point is that the registrant will already have selected the option(s) and those pre-selections will be carried to your cart system just as if someone had added the gift item to the cart with their option choice(s) Most cart software uses either radio buttons or dropdown lists to allow shoppers to select which option they wish. It is this code that you must remove from the add-to-cart form and paste into the Option Selection field. Click for an example of how the Add to Cart Code and Option Selection Code sections must be divided. Note that if you are using Registry Valet as a standalone application (not as part of our GiftSuite software) you will need to also fill in the "Add to Cart" field with the correct HTML to place this gift item into your cart system when a buyer wishes to purchase it from a gift registry. You can then copy this code to the product page on your web site that contains the gift item you chose. Depending upon how you filled in the form, the code will look similar to this: <form action="http://apps.agenne.com/Registry.cfm" method="post"> <input type="hidden" name="addtocart" value="%3Cform%20action%3D%22http%3A%2F%2Fapps%2Eagenne%2Ecom%2Fcart%2Ecfm%22%20method %3D%22post%22%3E%0D%0A%3Cinput%20type%3D%22hidden%22%20name%3D%22cid%22%20value%3D%228%22%3E%0 D%0A%3Cinput%20type%3D%22hidden%22%20name%3D%22op%22%20value%3D%22add%22%3E%0D%0A%3Cinput%20type%3D%22 hidden%22%20name%3D%22item%5Fdesc%22%20value%3D%27My%20Items%27%3E%0D%0A%3Cinput%20type%3D%22hidden %22%20name%3D%22item%5Fprice%22%20value%3D%2299%22%3E%0D%0A%3Cinput%20type%3D%22hidden%22%20name%3D%22 item%5Fid%22%20value%3D%221234%22%3E%0D%0A%3Cinput%20type%3D%22submit%22%20value%3D%22Add%20to%20Cart %22%3E%0D%0A%3C%2Fform%3E"> <input type="hidden" name="cid" value="000"> <input type="hidden" name="op" value="add"> <input type="hidden" name="item_qty" value="1"> <input type="hidden" name="item_desc" value="My%20Item"> <input type="hidden" name="item_price" value="99.00"> <input type="hidden" name="item_id" value="1234"> <input type="submit" value="Add to Registry" class="submit"> </form> Notice the "addtocart" field above (the second line of the form). This is the entire form which was copied and pasted into the "Add to Cart Code" field in the code generator. It has been encoded and placed here as part of the form - don't worry about how it looks, our system generates this automatically. This allows the gift registry software to store the form and display it to your customers (decoded, of course) so that they can put gift items into your cart by simply clicking the button. Notice that the item_desc field is also URL Encoded. If you specify an image URL and a product page URL, these will also be URL encoded. If you checked the "Include Qty Field" checkbox, there will also be an "item_qty" text input field. In the example above, the checkbox was left unchecked so the "item_qty" field is included as an HTML hidden form field with a default quantity of 1. This means that when a shopper clicks the "Add to Registry" button, the quantity that will be placed in their registry will be 1. Also, if you are using our GiftSuite software and the item has a "sold in sets of" quantity, this will be the default quantity in the "item_qty" field. Now, go through the products on your web site and generate the "Add to Registry" forms for each one and place it on the product pages for those gift items. Again, if your catalog system is dynamically generated from a database using ASP, Coldfusion, PHP, .NET or another dynamic language, contact support and we will help you with the html you will need to place on your pages to automatically create the "Add to Registry" forms. IF YOUR PAGES ARE DYNAMICALLY GENERATED If the pages where you need to display the "Add to Registry" form are created dynamically using a language such as ASP, PHP, Coldfusion, Java, .Net or other dynamic language, you will need to place code similar to the following into your page template(s) to correctly generate the "Add to Registry" form. Note that several of the fields must be URL-Encoded. <form action="http://apps.agenne.com/Registry.cfm" method="post"> <input type="hidden" name="addtocart" value="%3Cform%20action%3D%22http%3A%2F%2Fapps%2Eagenne%2Ecom%2Fcart%2Ecfm%22%20method %3D%22post%22%3E%0D%0A%3Cinput%20type%3D%22hidden%22%20name%3D%22cid%22%20value%3D%228%22%3E%0 D%0A%3Cinput%20type%3D%22hidden%22%20name%3D%22op%22%20value%3D%22add%22%3E%0D%0A%3Cinput%20type%3D%22 hidden%22%20name%3D%22item%5Fdesc%22%20value%3D%27My%20Items%27%3E%0D%0A%3Cinput%20type%3D%22hidden %22%20name%3D%22item%5Fprice%22%20value%3D%2299%22%3E%0D%0A%3Cinput%20type%3D%22hidden%22%20name%3D%22 item%5Fid%22%20value%3D%221234%22%3E%0D%0A%3Cinput%20type%3D%22submit%22%20value%3D%22Add%20to%20Cart %22%3E%0D%0A%3C%2Fform%3E"> <input type="hidden" name="cid" value="000"> <input type="hidden" name="op" value="add"> <input type="hidden" name="item_qty" value="1"> <input type="hidden" name="item_desc" value="My%20Item"> <input type="hidden" name="item_price" value="99.00"> <input type="hidden" name="item_id" value="1234"> <input type="submit" value="Add to Registry" class="submit"> </form> Notice the "addtocart" field above (the second line of the form). This is the entire "Add to Cart" form from your cart system. This allows the gift registry software to store the form and display it to your customers (decoded, of course) so that they can put gift items into your cart by simply clicking the button. Notice that the item_desc field is also URL Encoded. If you specify an image URL and a product page URL, these must also be URL encoded. The following fields must be URL encoded: The entire "Add to Cart" form (with option selection code removed) The optional Image URL The optional Product Page URL The item description The item ID (SKU) FIELDS THAT ARE PASSED TO YOUR CART SYSTEM Once there are items in a gift registry and a buyer goes to the registry list page to buy a gift, when they click the "Add to Cart" button, Registry Valet will add some additional variables to the add-to-cart form. There are 3 variables which are always passed. These are used to tell the cart what item was added, which registry it was from, and the name of the registrant. These need to be passed back to Registry Valet using the post-back system if you want to have the registry list updated automatically. See the Posting Back to Registry Valet (optional) for how to execute this post. These 3 fields are: rvl_id - internal ID rvr_id - another internal ID rv_name - Name of the registrant There are also 10 additional fields which can be passed to your shopping cart system. These contain the address information which you can use to automatically populate the shipping address in your cart. rv_shipaddress_firstname rv_shipaddress_lastname rv_shipaddress_company rv_shipaddress_address1 rv_shipaddress_address2 rv_shipaddress_city rv_shipaddress_state rv_shipaddress_zip rv_shipaddress_country rv_shipaddress_phone To enable the passing of these optional address fields, sign in to the administrator and click Registry Settings. Then, change the value of the "Pass Shipping Addr to my cart system" to "Yes". Be sure to click the "Save" button in the toolbar to save this change. SAMPLE CODE PHP Example. ColdFusion Example. osCommerce Example. iFrames Many developers are tempted to use iframes in order to completely control the user experience in customizing our software. This is not a good idea because some browsers won't correctly carry over the browser variables within iFrames. Especially older versions of Internet Explorer As a result, the gift registry software will not function correctly. Always avoid using iframes when creating a custom design. Our applications allow maximum flexibility for design so you should not need to use iframes anyway. Back to Step 1 ("Create New Registry" Page Link) | Continue to Step 3 (Gift Registry Settings and Customization) Registry Valet FAQ