QC: {IF-WISH-LIST-OWNER-BEGIN}

The {IF-WISH-LIST-OWNER-BEGIN} QuickCode Tag may be used in combination with the {IF-WISH-LIST-OWNER-END} QuickCode Tag within any storefront template to show or hide content based on whether or not any wish lists associated with the current shopping session are "owned" by the current visitor.

A wish list may be associcated with the current shopping session if either of the following conditions are true:

the website visitor has entered the public access code corresponding to a public wish list
the website visitor is logged into a customer account which owns at least one wish list

By default, a wish list is "owned" by the customer who created the wish list. However, store admins may change the ownership of wish lists from the Search Wish Lists page and the Wish List Editor. Each wish list may only be owned by one customer. Only the customer who owns the wish list, or a store admin, may edit the wish list.

Content between {IF-WISH-LIST-OWNER-BEGIN} and {IF-WISH-LIST-OWNER-END} will be displayed if the wish list(s) associated with the current shopping session is owned by the current visitor. The visitor must be logged into his or her customer account in order to be recognized by the shopping cart as the wish list owner.

If the {ELSE} QuickCode Tag is inserted between {IF-WISH-LIST-OWNER-BEGIN} and {IF-WISH-LIST-OWNER-END}, then content between {IF-WISH-LIST-OWNER-BEGIN} and {ELSE} will be shown if the current visitor owns the wish list(s) associated with the current shopping session, and content between {ELSE} and {IF-WISH-LIST-OWNER-END} will be shown if the current visitor does not own the wish list(s) associated with the current shopping session (or is not logged into his or her customer account and so cannot be identified as the wish list owner).

Requirements / Prerequisites

The {IF-WISH-LIST-OWNER-BEGIN} QuickCode Tag must be used in combination with the {IF-WISH-LIST-OWNER-END} QuickCode Tag.

The {ELSE} QuickCode Tag may optionally be used between {IF-WISH-LIST-OWNER-BEGIN} and {IF-WISH-LIST-OWNER-END}.

It is recommended to place {IF-WISH-LIST-OWNER-BEGIN} and {IF-WISH-LIST-OWNER-END} between {IF-WISH-LIST-BEGIN} and {IF-WISH-LIST-END}, so that the shopping cart will not try to check for a wish list owner, when no wish list is yet associated with the shopping session.

It is also 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

Add the following code to a storefront template:

Example
<h3>Wish Lists</h3><br />

{IF-USING-WISH-LISTS-BEGIN}

<strong>View a wish list by entering its Public Access Code in the field below.</strong><br />

<p style="text-align:center;">{FIELD-WISH-LIST-ACCESS-CODE}</p>

</form>

</div>

{IF-WISH-LIST-BEGIN}

<br />

{IF-WISH-LIST-OWNER-BEGIN}

<h4>Edit your wish lists...</h4>

{WISH-LIST-BLOCK-BEGIN}

<strong>Wish List Name: {FIELD-WISH-LIST-NAME}</strong><br />

Is this wish list public? {FIELD-WISH-LIST-IS-PUBLIC}<br />

Delete this wish list? {FIELD-WISH-LIST-DELETE}<br />

{WISH-LIST-ITEM-BLOCK-BEGIN}

<li>{PRODUCT-NAME}</li>

{WISH-LIST-ITEM-BLOCK-END}

</ul>

<a href="{URL-ADD-WISH-LIST-TO-BASKET}">Add entire Wish List to my order.</a><br />

</div><br />

{WISH-LIST-BLOCK-END}

</form>

</div>

{ELSE}

<h4>Viewing Wish List: {WISH-LIST-NAME}</h4><br />

<em>Access Code: {WISH-LIST-ACCESS-CODE}</em><br />

{WISH-LIST-ITEM-BLOCK-BEGIN}

<li>{PRODUCT-NAME}</li>

{WISH-LIST-ITEM-BLOCK-END}

</ul>

<a href="{URL-ADD-WISH-LIST-TO-BASKET}">Add entire Wish List to my order.</a>

</div>

{IF-WISH-LIST-OWNER-END}

</div>

{IF-WISH-LIST-END}

{ELSE}

<em>Wish Lists are not enabled at this time.</em>

{IF-USING-WISH-LISTS-END}

If the store's Wish List Module is enabled -AND- the current visitor is logged into his or her customer account -AND- has not entered the public access code of a specific wish list -AND- and has 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

View a wish list by entering its Public Access Code in the field below.

Edit your wish lists...

Wish List Name:
Is this wish list public?
Delete this wish list?

Blue Sneakers

Add entire Wish List to my order.

Wish List Name:
Is this wish list public?
Delete this wish list?

Red T-shirt

Red Travel Mug

Add entire Wish List to my order.

If the store's Wish List Module is enabled -AND- the current visitor is logged into his or her customer account -AND- has entered the public access code of a friend's wish list (named "Bill's Wish List"), then the following would display:

Example
Wish Lists

View a wish list by entering its Public Access Code in the field below.

Viewing Wish List: Bill's Wish List
Access Code: 1a111b123c456d789f0000g1h2222i3j

Green T-shirt

Checkered Sneakers

Add entire Wish List to my order.

If the store's Wish List Module is enabled -BUT- the current visitor has not entered the public access code to view a specific wish list -AND- either is not logged into a customer account -OR- is logged into a customer account that does not have any wish lists, then the following would display:

Example
Wish Lists

View a wish list by entering its Public Access Code in the field below.

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

Example
Wish Lists

Wish Lists are not enabled at this time.

Source Code

Source Code Updated:

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