Difference between revisions of "Download"

From Phoenix Cart User Guide
 
(27 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>
 +
__TOC__
 +
__FORCETOC__
 +
From admin go to [[File:adminnavbarconfig.png|link=]] '''Configuration &rarr; Download''' to see this:
 +
<div class="mainpage_box">
 +
[[File:download.jpg|link=|1500px]]
 +
</div>
 +
This enables the store to sell downloadable files also known as virtual products.
  
 +
Everything is set, ready to go, edit only if required.
  
From admin go to '''Configuration &rarr; Download''' to see this:
+
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]'''.
<div class="mainpage_box">
 
[[File:download.png|link=]]
 
</div>
 
This enables the shop to sell downloadable digital products.
 
  
 +
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]'''.
  
 
----
 
----
 +
==='''Downloadable File'''===
  
 
+
*Create the downloadable file, name it using lowercase and no spaces.
'''Enable download'''
+
*Upload the file to the '''download''' folder/directory on the host server.
*Click it in the list to select it.
+
*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.
*Click it again to edit.
 
*Change the setting to '''true'''
 
*Click <span class="btn-blue">Save</span>
 
  
  
 
----
 
----
 +
==='''Downloadable Product'''===
 +
===='''Create Product'''====
 +
*Create the new product in your shop in '''Catalog &rarr; Categories/Products''' - see '''[[Categories/Products]]'''
 +
*Ensure to set the '''Products Weight''' to '''0'''
  
 +
===='''Product Attributes'''====
 +
*Go to '''Catalog &rarr; Products Attributes'''
 +
*Click <span class="btn-info">Options</span> button to see like this:
  
'''Download by redirect'''
+
<div class="mainpage_box">
*Click it in the list to select it.
+
[[File:options-download.jpg|link=|1500px]]
*Click it again to edit.
+
</div>
*Change the setting to '''true'''
 
*Click <span class="btn-blue">Save</span>
 
  
 +
*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 <span class="btn-info">Values</span> button to see like this:
*Click it in the list to select it.
+
 
*Click it again to edit.
+
<div class="mainpage_box">
*Change the setting as required.
+
[[File:values-download.jpg|link=|1500px]]
*Click <span class="btn-blue">Save</span>
+
</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 <span class="btn-info">Attributes</span> button to see like this:
*Click it in the list to select it.
+
 
*Click it again to edit.
+
<div class="mainpage_box">
*Change the setting as required
+
[[File:attributes-download.jpg|link=|1500px]]
*Click <span class="btn-blue">Save</span>
+
</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.
  
  
 
----
 
----
 +
==='''Customer Experience'''===
  
 +
When a customer checks out and pays on the store, the order status is then set to '''Pending''' by default.
  
*When you have created your digital product, name it using lowercase and no spaces.
+
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.
*Compress it into a zipped folder.
 
**Using Windows, right click on the file.
 
**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>
 
*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.
 
*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.
 
**File permissions can be changed using FileZilla by right clicking on the folder/directory and clicking '''File permissions...''' in the popup menu.
 
 
 
  
----
+
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:
  
*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|link=]]
+
[[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|link=]]
+
[[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.
 
**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.
 
**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>
 
  
 +
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.
  
*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.
+
*To change the restriction go to '''Localization &rarr; Orders Status'''
*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.
 
*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|link=]]
+
[[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-blue">Save</span>
+
*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