Registry Valet Support: (919) 477-2100 (press option 1 for support)
support@agenne.com
Page: 1   2   3   4   Next >>
Registry Valet FAQ
Settings Reference
Optional Postback
Pricing Update System

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 1 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 button in the toolbar to open the code generator page.

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 1 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)

OPTIONS IN DYNAMICALLY GENERATED PAGES

Just like with static pages, dynamically generated add-to-registry forms must contain any options that your customers will need to select such as color, size, finish, etc. And, just like with static page add-to-registry forms, those for dynamically generated forms must have the option selection code removed from your "Add to Cart" form and passed to Registry Valet as standard form fields within the add-to-registry form. Take a look at this example:

<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">

<select name="color">
<option>Red</option>
<option>White</option>
<option>Blue</option>
</select>

<input type="hidden" name="cid" value="8">
<input type="hidden" name="op" value="add">
<input type="hidden" name="image_url" value="http%3A%2F%2Fwww%2Emysite%2Ecom%2Fimages%2Fitem%2Dimage%2Ejpg">
<input type="hidden" name="product_page_url" value="http%3A%2F%2Fwww%2Emysite%2Ecom%2Fitems%2Fmy%2Ditem%2Dpage%2Ehtml">
<input type="hidden" name="item_qty" value="1">
<input type="hidden" name="item_desc" value="My Item Description%3E">
<input type="hidden" name="item_price" value="33.00">
<input type="hidden" name="item_id" value="A17483">
<input type="submit" value="Add to Registry" class="submit">
</form>

Notice that the option selection for "color" is sent to Registry Valet just as it would appear on your dynamically generated item page. The registrant selects the option choices they want (such as the color "Red") and this selection is passed to Registry Valet and saved. This works because Registry Valet examines each field sent to it. Any field not recognized as part of it's own form field set is identified as an option and is re-integrated into your "Add to Cart" form at the time that the registry item list is displayed to a customer. This way, the registrant selects which options they want and the customer who is buying the item for the registrant does not need to make any decisions about options, they will already have been selected by the registrant.




FIELDS THAT ARE PASSED TO YOUR CART SYSTEM
Once there are items in a gift registry and a buyer goes to the registry display 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.




TO RETURN TO THE REGISTRY DISPLAY PAGE FROM YOUR CART

To return to the registry display page (where the items are listed with the "Add to Cart" buttons") once an item has been added to the cart, use the RVR_ID which is passed to the cart by Registry Valet along with your merchant ID to specify which registry and merchant, and add this URL to your cart display page. This can be done as either a form or a link:

http://apps.agenne.com/RegistryDisplay.cfm?cid=000&id=999

(Where 000 is your merchant ID and 999 is the RVR_ID that is passed to the cart)

This code should be added to your shopping cart's "Contents" page.





TO RETURN TO A SPECIFIC PAGE AFTER ADDING AN ITEM TO A REGISTRY

When items are added to a registry, a link is provided at the top of the registry page to "Add Additional Items to My Registry". By default, this link is controlled by the "Catalog Home URL" setting in the Registry Settings section of the administrator. But, what if you want to send the user to a different URL depending upon the item that was added to the registry? For example, the user might want to return to the main category page where the item is displayed, or perhaps it would be best to send them back to the page they were just on.

To send the user to a different URL when an item is added to the registry, include the following hidden field in your Add-to-Registry form:

<input type="hidden" name="Return_Url" value="http://www.MySpecialURL/pagename.html">

Be sure to change the value of the hidden field to the URL you wish to send the user to when they click the "Add Additional Items to My Registry" link.





SAMPLE CODE



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.

(800) 990-5254 FREE Newsletter!   Please enter your email address:
    Privacy Policy    |     Terms of Use    |