,
......
}
]
]
}
```
**How to access the** `customer/order.liquid` **file:** In your Shopify admin, go to *Online Store > Themes*, click **Actions** > **Edit code**, then in the left sidebar, locate and select `customer/order.liquid` under the **Templates** or **Sections** folder (depending on your theme). If this file does not exist, you may need to create it or consult your theme documentation.
We've made this new data available to allow you to directly add the download links to the customer's orders directly inside their customer account.
To include this data on a customer's account, you can include a block of code as shown below. This code should be added to your customer/order.liquid file in the theme editor. This code currently displays as a table (as shown below) with the product info and a direct link to their download page. This table can still be styled by editing your Shopify theme code for this page to suit your personal needs, and if you require any assistance, please [reach out to us](mailto:digital.products@kablecommerce.com) and let us know.
```
{% for kable_line_item in order.metafields.kable.digital_products.line_items %}
{% assign kable_line_item_id = kable_line_item[0] | plus: 0 %}
|
{% if kable_line_item_id == line_item.id %}
{% for file in kable_line_item[1].files %}
{{ file.label }}{% if forloop.last == false %}, {% endif %}
{% endfor %}
{% endif %}
|
{% endfor %}
```
---
### Customizing Delivery Notifications
**URL:** https://docs.linkcase.com/customizing-delivery-notifications
Delivery notifications are sent to customers after they purchase a product that you set up with a digital attachment in the Digital Products app. They’re sent as an SMS if the customer enters their phone number during checkout or as an email otherwise; this is consistent with the behaviour of Shopify order notifications. They contain a link to the [download page](/download-page), instructions on downloading their files, and/or even access codes/license keys if [this feature](/download-restrictions---access-controls) is enabled.
You can customize these settings from within the application by scrolling to the bottom of the "Edit Attachment" page and click edit.
Delivery notifications can be configured to be sent immediately when the order is marked as paid, or later when the order is marked as fulfilled, depending on your workflow preferences. By default, we send it immediately, and mark the order as fulfilled when it is delivered.
You can customize the email and SMS templates from the "Delivery Notifications" page by clicking on the corresponding template type you would like to edit and checking "Customize Email Template" or "Customize SMS Template."
## Customizing Delivery Notifications Templates
Delivery notification templates, both email and SMS, can be fully customized using the [liquid templating language](https://shopify.dev/docs/themes/liquid/reference). Emails are sent as HTML and SMS as plain text. Available liquid variables when customizing these templates are:
### Top level objects and variables
{{ shop }}
{{ order }}
{{ package_items }}
{{ download_page_url }}
{{ access_keys_enabled }}
### Shop
{{ shop.shopify_domain }}
{{ shop.name }}
{{ shop.email }}
{{ shop.customer_email }}
{{ shop.custom_domain }}
### Order
{{ order.shopify_order_id }}
{{ order.order_name }}
{{ order.first_name }}
{{ order.last_name }}
{{ order.email }}
{{ order.phone }}
### Package Item
{{ item.name }}
{{ item.image_url }}
{{ item.total_size }}
{{ item.description }}
{{ item.files }}
### File
{{ file.label }}
{{ file.file_size }}
{{ file.download_duration_limit_enabled }}
{{ file.download_duration_limit_reached }}
{{ file.time_remaining }}
{{ file.seconds_remaining }}
{{ file.download_limit_enabled }}
{{ file.download_limit_reached }}
{{ file.downloads_remaining }}
{{ file.download_url }}
---
### Download Restrictions & Access Controls
**URL:** https://docs.linkcase.com/download-restrictions---access-controls
## Download Limits
In order to add some protection your valuable digital products from malicious users and non-permitted sharing of files, you can enable a limit on the number of times files in an digital product attachment can be downloaded by a customer on their download page. You can also limit the length of time in which a file can be downloaded by the customer after they purchase it.
## Access codes or license keys
To add another layer of protection, you can enable the access codes feature. If enabled, customers will be required to enter a valid access code or license key in order to download the attachment files from the download page.
Access codes can be configured to be automatically generated based on rules such as length of key and characters/digits to use, or you can provide a list of codes/keys to use. Each customer is assigned one random key from the auto generation or from the list, and they can only download the file if that key is provided on the download page.
You can also provide your own list of keys that the application will pull from to be sent to the customer after they purchase to provide them access to their download.
If you have any other questions, please [reach out to us](mailto:digital.products@kablecommerce.com)! We're always happy to help!
---
### Customize the Shopify Order Confirmation Notification Email or SMS
**URL:** https://docs.linkcase.com/customize-the-shopify-order-confirmation-notification-email-or-sms
If you're looking to add some information about the digital attachment and its files to your order confirmation email or to the SMS that Shopify sends to your customers, then this is what you're looking for!
This is an advanced feature that requires some knowledge of the use of the Shopify liquid programming language. If you're unsure how to do this, please [reach out to us](mailto:digital.products@kablecommerce.com), and we'd be happy to help you.
When you create an attachment in the app, the app will automatically create some [metafields](https://help.shopify.com/en/manual/products/metafields) on the product variant that you can [access within the liquid templates](https://shopify.dev/docs/themes/liquid/reference/objects/metafield) of the order confirmation notification. The namespace on the metafields is "kable" and the main object variable is "attachment". The list of variables within this attachment are:
- {{ variant.metafields.kable.attachment.name }} - the label you gave the attachment in the app
- {{ variant.metafields.kable.attachment.tags }} - internal tags for the attachment, comma separated.
- {{ variant.metafields.kable.attachment.download_limit }} - the max number of downloads allowed fo an attachment that you may (or not) have set, if you didn't set it then it will be ignored.
- {{ variant.metafields.kable.attachment.download_duration_limit }} - the length of time an attachment can be downloaded by a customer after purchase that you may (or not) have set, if you didn't set it then it will be ignored.
- {{ variant.metafields.kable.attachment.enabled }} - whether or not the attachment is enabled within the app.
- {{ variant.metafields.kable.attachment.product_name }} - name of the product the attachment is linked to.
- {{ variant.metafields.kable.attachment.variant_name }} - name of the variant the attachment is linked to.
- {{ variant.metafields.kable.attachment.description }} - the description you configured on the attachment in the app.
- {{ variant.metafields.kable.attachment.description }} - the first image from the product the attachment is linked to.
- {{ variant.metafields.kable.attachment.file_count }} - the number of files uploaded for this attachment.
- {{ variant.metafields.kable.attachment.files }} - the list of file objects that you've uploaded to this attachment.
Then, for each file that has been uploaded for the attachment, the available variables are:
- {{ file.label_label }} - the label of the file that you configured in the app.
- {{ file.download_filename }} - the filename used when the customer downloads the file that you configured in the app.
- {{ file.content_type }} - the type of the file (for example, application/pdf).
- {{ file.file_size }} - the size of the file in bytes.
- {{ file.download_url }} - URL template to directly download the file. To use this you must replace "||order_token||" with the {{ token }} variable in your order confirmation email. Use the liquid statement {{ file.download_url | replace: "||order_token||", token }}
- {{ file.download_page_url }} - URL template to download the file deeplink on the download page. To use this you must replace "||order_token||" with the {{ token }} variable in your order confirmation email. Use the liquid statement {{ file.download_url | replace: "||order_token||", token }}
These variant metafields will, in fact, work with any of the Shopify notification templates or within the themes in a similar way.
That's it! Feel free to [contact us](mailto:digital.products@kablecommerce.com) if you have any questions.
**Update Aug. 24, 2020:** Shopify no longer passes the "token" liquid variable through to the notification templates. Use the following to get the order token:
{% assign order_status_url_parts = order_status_url | split: '/' %}
{% assign token = order_status_url_parts[5] %}
---