QC: {FIELD-WISH-LIST-ITEM-EXPIRATION-DATE}

The {FIELD-WISH-LIST-ITEM-EXPIRATION-DATE} QuickCode Tag may be used to create a set of dropdown menus, from which a customer may assign an expiration date to a wish list item.

Only the customer who created the wish list, or a store admin, may alter a wish list item's expiration date.

If the customer who created the wish list is logged into their customer account, they may manage their wish lists through the storefront wish list page (http://[storedomain]/wish_list.php).

Store admins may use the Search Wish Lists page (located at [Modules > Wish Lists > Search Wish Lists] to view all wish lists. An individual wish list may be selected to view and edit all of its settings, including the expiration date of wish list items, in the Wish List Editor.

Requirements / Prerequisites

Since {FIELD-WISH-LIST-ITEM-EXPIRATION-DATE} creates an input (the set of dropdown menus), this QuickCode Tag must be placed within a properly formatted HTML form, and the form must include a submit button, in order for the dropdown menus created by {FIELD-WISH-LIST-ITEM-EXPIRATION-DATE} to actually function. If {FIELD-WISH-LIST-ITEM-EXPIRATION-DATE} is not within a property formatted HTML form with a submit button, changes to the values in the dropdown menus will not be applied to the wish list item.

The {FIELD-WISH-LIST-ITEM-EXPIRATION-DATE} QuickCode Tag may be used within the {WISH-LIST-ITEM-BLOCK-BEGIN} {WISH-LIST-ITEM-BLOCK-END} QuickCode Block, in order to display the expiration date dropdown menus for each of the customer's current wish list items. For this use, the {WISH-LIST-ITEM-BLOCK-BEGIN} {WISH-LIST-ITEM-BLOCK-END} QuickCode Block must be contained within the {WISH-LIST-BLOCK-BEGIN}{WISH-LIST-BLOCK-END} QuickCode Block, which in turn must be contained within the {IF-WISH-LIST-OWNER-BEGIN}{IF-WISH-LIST-OWNER-END} QuickCode Block.

The {FIELD-WISH-LIST-ITEM-EXPIRATION-DATE} QuickCode Tag may also be used in an HTML form in the product template (product.tpl), to allow customers to assign an expiration date when adding the product to a wish list. For this use, the form that contains {FIELD-WISH-LIST-ITEM-EXPIRATION-DATE} must also contain {FIELD-WISH-LIST-SELECT} and {FIELD-PRODUCT-QUANTITY}.

It is recommended to always place any content related to wish lists between the {IF-USING-WISH-LISTS-BEGIN} and {IF-USING-WISH-LISTS-END} QuickCode Tags, so that the content will be shown when the store's Wish List Module is enabled, but hidden if the store's Wish List Module is disabled.

Example of Use

1. Add the following code to a storefront template:

Example

{IF-USING-WISH-LISTS-BEGIN}

<h3>Wish Lists</h3>

{IF-WISH-LIST-BEGIN}

{IF-WISH-LIST-OWNER-BEGIN}

<form name="wish_list_form" method="post" action="{THIS-PAGE}">
<h3>Edit your wish lists...</h3><br />

{WISH-LIST-BLOCK-BEGIN}

<li>

{WISH-LIST-ITEM-BLOCK-BEGIN}

<li><strong>Product Name:</strong> {PRODUCT-NAME}</li>

<li><strong>Price:</strong> {PRODUCT-PRICE}</li>

<li><strong>Expiration Date:</strong> {FIELD-WISH-LIST-ITEM-EXPIRATION-DATE}</li>

</ul><br />

{WISH-LIST-ITEM-BLOCK-END}

</li>

<li style="text-align:center;"><a href="{URL-ADD-WISH-LIST-TO-BASKET}">Add entire wish list to my order.</a></li>

</ul><br />

{WISH-LIST-BLOCK-END}

</form>

{IF-WISH-LIST-OWNER-END}

</div>

{IF-WISH-LIST-END}

{IF-USING-WISH-LISTS-END}

<hr />

2. If the store's Wish List Module is enabled -AND- the logged in customer owns two wish lists (named "What I want for my birthday" and "What I want to buy later"), then the following would display:

Example
Wish Lists

Wish List Name: What I want for my birthday
- Product Name: Blue T-Shirt
- Price: $10.00
- Expiration Date:
- Product Name: Blue Sneakers
- Price: $50.00
- Expiration Date:
Add entire wish list to my order.

Wish List Name: What I want to buy later
- Product Name: Red T-Shirt
- Price: $12.00
- Expiration Date:
- Product Name: Red Travel Mug
- Price: $20.00
- Expiration Date:
Add entire wish list to my order.

3. If the store's Wish List Module is enabled -BUT- the current customer does not own any wish lists, then the following would display:

Example
Wish Lists

4. If the store's Wish List Module is not enabled, then the following would display:

Example

Source Code

Source Code Updated:

When a web page using a template that contains this QuickCode Tag is viewed in the storefront, the {FIELD-WISH-LIST-ITEM-EXPIRATION-DATE} QuickCode Tag is changed into the source code below prior to the web page being displayed.