Difference between revisions of "Download"

From Phoenix Cart User Guide
 
(30 intermediate revisions by the same user not shown)
Line 1: Line 1:
<span class="btn-grey"><historylink type="back">&#129032; Back</historylink></span>
+
<div class="btn btn-grey btn-back">{{#fas:arrow-left}} Back</div> <div class="btn btn-grey btn-admin">{{#fas:cog}} Administration</div>
<span class="btn-grey" style="color:#0088dd;">'''[[ADMINISTRATION|&#x1F809; ADMINISTRATION]]'''</span>
 
 
<hr>
 
<hr>
From admin go to '''Configuration &rarr; Download''' to see this:
+
__TOC__
 +
__FORCETOC__
 +
From admin go to [[File:adminnavbarconfig.png|link=]] '''Configuration &rarr; Download''' to see this:
 
<div class="mainpage_box">
 
<div class="mainpage_box">
[[File:download.png]]
+
[[File:download.jpg|link=|1500px]]
 
</div>
 
</div>
This enables the shop to sell downloadable digital products.
+
This enables the store to sell downloadable files also known as virtual products.
 +
 
 +
Everything is set, ready to go, edit only if required.
 +
 
 +
There is an example of this shown in the '''[https://phoenixcart.org/demo/product_info.php?cPath=1_3&sort=1a&products_id=7 CE Phoenix Cart Store Demo]'''.
 +
 
 +
It can also be seen how that was set up in the '''[https://phoenixcart.org/demoadmin/admin/products_attributes.php CE Phoenix Cart Admin Demo]'''.
 +
 
 
----
 
----
'''Enable download'''
+
==='''Downloadable File'''===
*Click it in the list to select it.
+
 
*Click it again to edit.
+
*Create the downloadable file, name it using lowercase and no spaces.
*Change the setting to '''true'''
+
*Upload the file to the '''download''' folder/directory on the host server.
*Click <span class="btn-blue">Save</span>
+
*The setting '''Download by redirect''' passes the file from the '''download''' folder/directory to the '''pub''' folder/directory so it can be downloaded but adds a random folder name so it can not be found by public search.
 +
 
 +
 
 
----
 
----
'''Download by redirect'''
+
==='''Downloadable Product'''===
*Click it in the list to select it.
+
===='''Create Product'''====
*Click it again to edit.
+
*Create the new product in your shop in '''Catalog &rarr; Categories/Products''' - see '''[[Categories/Products]]'''
*Change the setting to '''true'''
+
*Ensure to set the '''Products Weight''' to '''0'''
*Click <span class="btn-blue">Save</span>
+
 
 +
===='''Product Attributes'''====
 +
*Go to '''Catalog &rarr; Products Attributes'''
 +
*Click <span class="btn-info">Options</span> button to see like this:
 +
 
 +
<div class="mainpage_box">
 +
[[File:options-download.jpg|link=|1500px]]
 +
</div>
 +
 
 +
*Enter a new '''Option Name''', for example, '''Download'''.
 +
*Enter a '''Sort Order'''.
 +
*Click <span style="color:green">'''<big>+</big>'''</span> to save.
 +
 
 
----
 
----
'''Expiry delay (days)'''
+
 
*Click it in the list to select it.
+
 
*Click it again to edit.
+
*Click <span class="btn-info">Values</span> button to see like this:
*Change the setting as required.
+
 
*Click <span class="btn-blue">Save</span>
+
<div class="mainpage_box">
 +
[[File:values-download.jpg|link=|1500px]]
 +
</div>
 +
 
 +
*Choose the '''Option Name''' from the pull down menu, for example, '''Download'''.
 +
*Enter an '''Option Value''' in the input box, for example, '''PDF'''.
 +
*Enter a '''Sort Order'''.
 +
*Click <span style="color:green">'''<big>+</big>'''</span> to save.
 +
*Repeat to assign additional Option Values to Option Names, for example, if you have optional downloadable file types.
 +
 
 
----
 
----
'''Maximum number of downloads'''
+
 
*Click it in the list to select it.
+
 
*Click it again to edit.
+
*Click <span class="btn-info">Attributes</span> button to see like this:
*Change the setting as required
+
 
*Click <span class="btn-blue">Save</span>
+
<div class="mainpage_box">
 +
[[File:attributes-download.jpg|link=|1500px]]
 +
</div>
 +
 
 +
*Choose the '''Product Name''' from the pull down menu.
 +
*Choose the '''Option Name''' from the pull down menu, in this example, '''Download'''.
 +
*Choose the '''Option Value''' from the pull down menu, in this example, '''PDF'''.
 +
*Enter a net price adjustment in the '''Value Price''' input box if required.
 +
*Enter a + or - prefix in the '''Prefix''' input box to add or subtract the price adjustment from the product price.
 +
*Enter the exact file name of the downloadable file, including the file extension, for example '''.pdf''' in the '''Filename:''' input box.
 +
*The '''Expiry delay (days)''' and '''Maximum number of downloads''' can be changed from the defaults already set if required.
 +
*Click <span style="color:green">'''<big>+</big>'''</span> to save.
 +
*Repeat for each Option Name and Option Value you wish to apply to the product.
 +
 
 +
 
 
----
 
----
*When you have created your digital product, name it using lowercase and no spaces.
+
==='''Customer Experience'''===
*Compress it into a zipped folder.
+
 
**Using Windows, right click on the file.
+
When a customer checks out and pays on the store, the order status is then set to '''Pending''' by default.
**In the popup menu, go to and click '''Send to > Compressed (zipped) folder'''
+
 
*Upload the zipped folder to the '''download''' folder/directory (found in the top '''htdocs''' directory) on the host server using FTP software - see <big>'''[[FileZilla]]'''</big>
+
The customer will not be able to download the product. This prevents them getting the download for free in case one of your payment options is by deferred payment, for example, by cheque or bank payment.
*Ensure the file permission settings for the '''download''' folder/directory are set to '''0755'''
+
 
**This means search engines will not find your download and the public can not access them for free.
+
When the store owner changes the order status to '''Processing''' or '''Delivered''', the link to download the product will then appear in the customer's order, in their order history, in their profile, when they are logged in on the store.
*Ensure the file permission settings for the '''pub''' folder/directory are set to '''0777'''
+
 
**The setting '''Download by redirect''' passes the file from '''download''' to '''pub''' so it can be downloaded but adds a random folder name so it can not be found by public search.
+
It appears like this:
**File permissions can be changed using FileZilla by right clicking on the folder/directory and clicking '''File permissions...''' in the popup menu.
+
 
----
 
*Create the new product in your shop in '''Catalog &rarr; Categories/Products''' - see <big>'''[[Categories/Products]]'''</big>
 
**Ensure to set the '''Products Weight''' to '''0'''
 
*Go to '''Catalog &rarr; Products Attributes''' to see this:
 
 
<div class="mainpage_box">
 
<div class="mainpage_box">
[[File:downloadoptions.png]]
+
[[File:customer-download.jpg|link=|1500px]]
 
</div>
 
</div>
*'''Product Options'''
+
 
**Enter '''Download''' in the '''Option Name''' input box next to '''en:''' (english)
+
This link will stay there for the '''Expiry delay (days)''' period.
**Click <span class="btn-blue">Insert</span>
+
 
*'''Option Values'''
+
This restriction is set in '''Localization &rarr; Orders Status'''.
**Choose '''Download''' from the '''Option Name''' pull down menu.
+
 
*Enter the file type of your download e.g. '''PDF''' in the '''Option Value''' input box next to '''en:''' (english)
+
Go to '''Localization &rarr; Orders Status''' to see like this:
*Click <span class="btn-blue">Insert</span>
+
 
*Repeat if you have more than one file type option.
 
*'''Product Attributes'''
 
 
<div class="mainpage_box">
 
<div class="mainpage_box">
[[File:downloadattributes.png]]
+
[[File:order-status-download.jpg|link=|1500px]]
 
</div>
 
</div>
**Choose the download product name from the '''Product Name''' pull down menu.
+
 
**Choose '''Download''' from the '''Option Name''' pull down menu.
+
See '''Downloads Status''' for '''Pending (default)''' is disabled, indicated by the red cross.
**Choose the file type e.g. '''PDF''' from the '''Option Value''' pull down menu.
+
 
**Enter the exact file name of the zipped folder, including the '''.zip''' file extension in the '''Filename:''' input box.
+
See '''Downloads Status''' for '''Processing''' and '''Delivered''' is enabled, indicated by the green check/tick.
**The '''Expiry delay (days)''' and '''Maximum number of downloads''' can be changed from the defaults already set if required.
+
 
**Click <span class="btn-blue">Insert</span>
+
If the only payment options require immediate payment, for example, card payment, then this restriction can be changed so the link to download the product will appear on the checkout success page when they have paid so they can download immediately.
----
+
 
*When a customer pays on the shop, the order status is set to '''pending''' - by default, they will not see the link to download the product to prevent them getting the download for free in case one of your payment options is by deferred payment e.g. by cheque.
+
The link will still also appear in their order in their order history in their account and stay there for the '''Expiry delay (days)''' period.
*When the shop owner changes the order status to '''processing''' or '''delivered''', the link to download the product will appear in their order in their order history in their account when they are logged in on the shop and stay there for the '''Expiry delay (days)''' period.
+
 
*If your only payment options require immediate payment e.g. card payment then the default can be changed so the link to download the product will appear on the checkout success page when they have paid so they can download immediately.
+
*To change the restriction go to '''Localization &rarr; Orders Status'''
*The link will also appear in their order in their order history in their account and stay there for the '''Expiry delay (days)''' period.
 
*To change the default go to '''Localization &rarr; Orders Status'''
 
 
*Click '''Pending (default)''' to see this:
 
*Click '''Pending (default)''' to see this:
 
<div class="mainpage_box">
 
<div class="mainpage_box">
[[File:ordersstatus.png]]
+
[[File:ordersstatus.jpg|link=]]
 
</div>
 
</div>
*Tick the box: '''Allow downloads of virtual products at this order status level'''
+
*Select '''Allow downloads of virtual products at this order status level'''
 +
*Click <span class="btn-green">Save</span>
 +
 
 +
The '''Downloads Status''' for '''Pending (default)''' will now be enabled, indicated by a green check/tick.
 +
 
  
  
 
<hr>
 
<hr>
{{Page_In_Progress}}
+
{{Forum}}
 +
{{Pro}}
 
{{Contribute}}
 
{{Contribute}}

Latest revision as of 11:59, 2 November 2024

Back
Administration

From admin go to Adminnavbarconfig.png Configuration → Download to see this:

Download.jpg

This enables the store to sell downloadable files also known as virtual products.

Everything is set, ready to go, edit only if required.

There is an example of this shown in the CE Phoenix Cart Store Demo.

It can also be seen how that was set up in the CE Phoenix Cart Admin Demo.


Downloadable File

  • Create the downloadable file, name it using lowercase and no spaces.
  • Upload the file to the download folder/directory on the host server.
  • The setting Download by redirect passes the file from the download folder/directory to the pub folder/directory so it can be downloaded but adds a random folder name so it can not be found by public search.



Downloadable Product

Create Product

  • Create the new product in your shop in Catalog → Categories/Products - see Categories/Products
  • Ensure to set the Products Weight to 0

Product Attributes

  • Go to Catalog → Products Attributes
  • Click Options button to see like this:

Options-download.jpg

  • Enter a new Option Name, for example, Download.
  • Enter a Sort Order.
  • Click + to save.


  • Click Values button to see like this:

Values-download.jpg

  • Choose the Option Name from the pull down menu, for example, Download.
  • Enter an Option Value in the input box, for example, PDF.
  • Enter a Sort Order.
  • Click + to save.
  • Repeat to assign additional Option Values to Option Names, for example, if you have optional downloadable file types.


  • Click Attributes button to see like this:

Attributes-download.jpg

  • Choose the Product Name from the pull down menu.
  • Choose the Option Name from the pull down menu, in this example, Download.
  • Choose the Option Value from the pull down menu, in this example, PDF.
  • Enter a net price adjustment in the Value Price input box if required.
  • Enter a + or - prefix in the Prefix input box to add or subtract the price adjustment from the product price.
  • Enter the exact file name of the downloadable file, including the file extension, for example .pdf in the Filename: input box.
  • The Expiry delay (days) and Maximum number of downloads can be changed from the defaults already set if required.
  • Click + to save.
  • Repeat for each Option Name and Option Value you wish to apply to the product.



Customer Experience

When a customer checks out and pays on the store, the order status is then set to Pending by default.

The customer will not be able to download the product. This prevents them getting the download for free in case one of your payment options is by deferred payment, for example, by cheque or bank payment.

When the store owner changes the order status to Processing or Delivered, the link to download the product will then appear in the customer's order, in their order history, in their profile, when they are logged in on the store.

It appears like this:

Customer-download.jpg

This link will stay there for the Expiry delay (days) period.

This restriction is set in Localization → Orders Status.

Go to Localization → Orders Status to see like this:

Order-status-download.jpg

See Downloads Status for Pending (default) is disabled, indicated by the red cross.

See Downloads Status for Processing and Delivered is enabled, indicated by the green check/tick.

If the only payment options require immediate payment, for example, card payment, then this restriction can be changed so the link to download the product will appear on the checkout success page when they have paid so they can download immediately.

The link will still also appear in their order in their order history in their account and stay there for the Expiry delay (days) period.

  • To change the restriction go to Localization → Orders Status
  • Click Pending (default) to see this:

Ordersstatus.jpg

  • Select Allow downloads of virtual products at this order status level
  • Click Save

The Downloads Status for Pending (default) will now be enabled, indicated by a green check/tick.



Many Addons and Extensions available in the CE Phoenix Cart Addons Library

If help is needed, support is available in the CE Phoenix Cart Support Forum

Phoenix Cart User Guide, like CE Phoenix Cart, is free to use but is maintained by unpaid volunteers.

Code references are licensed under a Commons Attribution-NonCommercial-ShareAlike 2.0 UK: England & Wales License.
All other content is the reserved Intellectual Property and Copyright of phoenixcart.org