QC: {DIGITAL-OBJECT-ZONE-MESSAGE}

The {DIGITAL-OBJECT-ZONE-MESSAGE} QuickCode Tag may be used within the digital_delivery.template.php template to display the zone restriction message for any digital object that is not available to the customer based on the digital object's display zones settings.

Requirements / Prerequisites

The {DIGITAL-OBJECT-ZONE-MESSAGE} QuickCode Tag may only be used within the digital_delivery.template.php template.

For best results, the {DIGITAL-OBJECT-ZONE-MESSAGE} QuickCode Tag should be used between the {IF-DIGITAL-OBJECT-ZONE-MESSAGE-BEGIN} and {IF-DIGITAL-OBJECT-ZONE-MESSAGE-END} QuickCode Tags.

The {DIGITAL-OBJECT-ZONE-MESSAGE} QuickCode Tag (and the {IF-DIGITAL-OBJECT-ZONE-MESSAGE-BEGIN} and {IF-DIGITAL-OBJECT-ZONE-MESSAGE-END} QuickCode Tags) must be located between the {DIGITAL-DELIVERY-FILE-BLOCK-BEGIN} and {DIGITAL-DELIVERY-FILE-BLOCK-END} QuickCode Tags, which must be enclosed within an HTML form.

To review or alter a digital object's Display Zones settings, go to [Modules > Digital Delivery > Search Digital Objects], and click the SID number link or edit button of the digital object in question. In the Digital Object Editor, the Display Zones options include settings to select whether the digital object is displayed to all customers or only to customers in certain zones; to select which geographic areas will have access to the digital object; and to create a zone restriction message that will be displayed to customers outside the allowed geographic areas.

If the digital object is restricted to specific geographic areas in the Display Zones settings, then any customer whose billing address is inside the allowed geographic areas will not see the zone restriction message and will be able to download the digital object. Any customer whose billing address is outside the allowed geographic areas will see the zone restriction message and will not be able to download the digital object.

Example of Use

If the following code is added to the digital_delivery.template.php template:

Code
<form id="download_delivery_form" name="download_delivery_form" method="post" action="{THIS-PAGE}">
<table style="border:1px solid black;">
<caption><b>Download your purchased files:</b></caption>
{DIGITAL-DELIVERY-FILE-BLOCK-BEGIN}
<tr>
<th>File Name: {DIGITAL-OBJECT-NAME}</th>
</tr>
{IF-DIGITAL-OBJECT-ZONE-MESSAGE-BEGIN}
<tr>
<td>{DIGITAL-OBJECT-ZONE-MESSAGE}</td>
</tr>
{IF-DIGITAL-OBJECT-ZONE-MESSAGE-END}
<tr>
<td>{DIGITAL-OBJECT-ACCESS-BUTTON}</td>
</tr>
{DIGITAL-DELIVERY-FILE-BLOCK-END}
</table>
</form>

If a customer in the United States placed an order that included the digital objects named Example PDF (Australia), Example PDF (Canada), and Example PDF (United States)...
And Example PDF (Australia) has the Display Zone set to the country Australia and has the Zone Restriction Message "This file is only available for download in Australia."...
And Example PDF (Canada) has the Display Zone set to the country Canada and has the Zone Restriction Message "This file is only available for download in Canada."...
And Example PDF (US) has the Display Zone set to the country United States and has the Zone Restriction Message "This file is only available for download in the United States."...
Then, when the customer accesses the digital delivery page for that order, the following would display:

**Download your purchased files:**
File Name: Example PDF (Australia)
This file is only available for download in Australia
File Name: Example PDF (Canada)
This file is only available for download in Canada
File Name: Example PDF (United States)

Source Code

Source Code Updated:

When a web page using a template that contains this QuickCode Tag is viewed in the storefront, the {DIGITAL-OBJECT-ZONE-MESSAGE} QuickCode Tag is changed into the source code below prior to the web page being displayed.