QC: {DIGITAL-OBJECT-REMAINING-ACCESS-NUMBER}

The {DIGITAL-OBJECT-REMAINING-ACCESS-NUMBER} QuickCode Tag may be used within the digital_delivery.template.php template to display how many download attempts are still allowed for each digital object on the digital delivery storefront page.

Requirements / Prerequisites

The {DIGITAL-OBJECT-REMAINING-ACCESS-NUMBER} QuickCode Tag may only be used within the digital_delivery.template.php template, 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.

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>
<tr>
<td>Access Limit: {DIGITAL-OBJECT-TOTAL-ACCESS-NUMBER}</td>
</tr>
<tr>
<td>Current Attempts: {DIGITAL-OBJECT-CURRENT-ACCESS-NUMBER}</td>
</tr>
<tr>
<td bgcolor="#ccffff">Remaining Attempts: {DIGITAL-OBJECT-REMAINING-ACCESS-NUMBER}</td>
</tr>
<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, each of which has a three download attempt shelf life, when the customer accessed the digital delivery page for that order, the following would display:

Download your purchased files:
File Name: Example PDF
Access Limit: 3
Current Attempts: 0
Remaining Attempts: 3

File Name: Example MP3
Access Limit: 3
Current Attempts: 0
Remaining Attempts: 3

File Name: Example ZIP
Access Limit: 3
Current Attempts: 0
Remaining Attempts: 3

If the customer had already downloaded Example PDF once and Example ZIP twice, the following would display:

Download your purchased files:
File Name: Example PDF
Access Limit: 3
Current Attempts: 1
Remaining Attempts: 2

File Name: Example MP3
Access Limit: 3
Current Attempts: 0
Remaining Attempts: 3

File Name: Example ZIP
Access Limit: 3
Current Attempts: 2
Remaining Attempts: 1

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-REMAINING-ACCESS-NUMBER} QuickCode Tag is changed into the source code below prior to the web page being displayed.