QC: {IF-DIGITAL-OBJECT-INSTRUCTIONS-BEGIN}

The {IF-DIGITAL-OBJECT-INSTRUCTIONS-BEGIN} QuickCode Tag may be used in combination with the {IF-DIGITAL-OBJECT-INSTRUCTIONS-END} QuickCode Tag within the digital_delivery.template.php template, to display content only if the digital object has instructions.

To review or alter a digital object's instructions, 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 Instructions option displays any current instructions. To add or change the instructions, enter the new instructions in the Instructions text area, then click Save Changes at the bottom of the page. HTML is allowed in the instructions, to add formatting, links, etc.

Requirements / Prerequisites

The {IF-DIGITAL-OBJECT-INSTRUCTIONS-BEGIN} QuickCode Tag may only be used within the digital_delivery.template.php template, must be used in combination with the {IF-DIGITAL-OBJECT-INSTRUCTIONS-END} QuickCode Tag, and must be used between the {DIGITAL-DELIVERY-FILE-BLOCK-BEGIN} and {DIGITAL-DELIVERY-FILE-BLOCK-END} QuickCode Tags, which must be enclosed within an HTML form.

The {ELSE} QuickCode Tag may also be used between the {IF-DIGITAL-OBJECT-INSTRUCTIONS-BEGIN} and {IF-DIGITAL-OBJECT-INSTRUCTIONS-END} QuickCode Tags. With the combination of the {IF-DIGITAL-OBJECT-INSTRUCTIONS-BEGIN} {ELSE} and {IF-DIGITAL-OBJECT-INSTRUCTIONS-END} QuickCode Tags, content between {IF-DIGITAL-OBJECT-INSTRUCTIONS-BEGIN} and {ELSE} will be displayed only for digital objects that do have instructions. Content between {ELSE} and {IF-DIGITAL-OBJECT-INSTRUCTIONS-END} will be displayed only for digital objects that do not have instructions.

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-INSTRUCTIONS-BEGIN}
<tr>

<td bgcolor=#ccffcc">{DIGITAL-OBJECT-INSTRUCTIONS}</td>
</tr>
{ELSE}
<tr>
<td bgcolor="#ccffff">Click the Download button to save this file.</td>
</tr>
{IF-DIGITAL-OBJECT-INSTRUCTIONS-END}
<tr>
<td>{DIGITAL-OBJECT-ACCESS-BUTTON}</td>
</tr>
{DIGITAL-DELIVERY-FILE-BLOCK-END}
</table>
</form>

If a customer placed an order that included the digital objects named Example PDF, Example MP3, and Example ZIP...
and Example PDF does not have any instructions entered in the Digital Object Editor...
and Example MP3 does not have any instructions entered in the Digital Object Editor...
and Example ZIP has the instructions "After downloading, use a program such as WinZip to extract the individual files"...
when the customer accessed the digital delivery page for that order, the following would display:

**Download your purchased files:**
File Name: Example PDF
Click the Download button to save this file.

File Name: Example MP3
Click the Download button to save this file.

File Name: Example ZIP
After downloading, use a program such as WinZip to extract the individual files

Source Code

Source Code Updated:

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