STEP TWO: Generate "Add to Registry" HTML button code 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 sample code. If your web site's catalog pages are dynamically generated and you need further help or assistance, please contact Registry Valet 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 add items to 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 add the appropriate information to your add-to-cart code 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 Add-to-Registry HTML Button Form Generator icon. It looks like this: Click this icon and the Add-to-Registry button code generator form will popup in a new window. If this window does not appear, but sure that your browser allows popups for this page. The window will look similar to this: Now, choose an item for sale on your web site that you would like shoppers to be able to add to their registry and fill in the fields on this form with the required information. Be sure that you do not include a "$" in the item price field. Click the "Generate Code" button and the HTML form code 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@registryvalet.com Why do I have to put my "Add to Cart" code into this form? When a registrant adds an item to 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 an item. If you do not include your item's "Add to Cart" form in the code generator, there will be no way for their friends and family (your customers) to buy an item 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 a gift registry or wish list system. 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 item 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 item by phone". You can use any HTML in this field, 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 add-to-cart button will ONLY be displayed by the add-to-cart code that you type or paste into this field. If you leave this field blank, there will be no "Add to Cart" button next to each item in the registry list. Each item that you sell on your site probably already has an add-to-cart form so that shoppers can add that item to their shopping cart. It is this add-to-cart form that you must type or paste into the "Add to Cart code" field before you click the "Generate Code" button. If you have items that include options such as size, color, etc., see below before you paste code into this field. OPTION SELECTION Do your items have options such as size, color, monogram, or other options that your customers can choose when they add an item to their shopping cart (and registry)? If so, in order to make Registry Valet work with these options correctly, you must remove the option code from the add-to-cart 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 add the item to their registry. By removing the option selection code and pasting it into the option selection code field, it will be included in the standard "Add to Registry" form as is, without encoding. The "Add to CART" form will be URL 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 item to the cart with their option choice(s) Most cart systems use 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 GiftSuite) you will need to also fill in the "Add to Cart" field with the correct HTML to add this item to your cart system when a buyer wishes to purchase an item from a gift registry. You can then copy this code to the product page on your web site that contains the 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%0D%0A%3Cinput%20type%3D%22hidden%22%20name%3D%22op%22%20value%3D%22add%22%3E%0D%0A%3Cinput%20type%3D%22hidden%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%22item%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 which was copied and pasted into the "Add to Cart Code" field in the code generator. It has been URL Encoded and placed in this field as part of the Add-to-Registry form - don't worry about how it looks, our system generates this automatically. This allows Registry Valet to store the entire add-to-cart form and display it to your customers (Decoded, of course) so that they can add items to your cart system 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 code 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 GiftSuite and the item has a "sold in sets of" quantity, this will be the default quantity in the "item_qty" field. NOTE: If you are using ASP, PHP, ColdFusion, .NET, or another dynamic language to automatically generate the "Add to Registry" forms on your catalog pages, 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) If you are using plain HTML pages, don't worry about the URL Encoding above, it does not apply to you. Now, go through the products on your web site and generate the "Add to Registry" button code for each one and place it on the product pages for those items. Again, if your catalog system is dynamically generated from a database using ASP, Coldfusion, PHP, .NET or another dynamic language, contact Registry Valet support and we will help you with the code you will need to add to your pages to automatically create the "Add to Registry" forms. SAMPLE CODE Sample PHP code. Sample ColdFusion code. Sample osCommerce code. Back to Step 1 ("Create New Registry" Page Link) | Continue to Step 3 (Registry Settings and Customization) Registry Valet FAQ