Difference between revisions of "Download"

From Phoenix Cart User Guide
 
(34 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]]
*When you have created your digital product, name it using lowercase and no spaces.
+
</div>
*Compress it into a zipped folder.
+
 
**Using Windows, right click on the file.
+
*Choose the '''Product Name''' from the pull down menu.
**In the popup menu, go to and click '''Send to > Compressed (zipped) folder'''
+
*Choose the '''Option Name''' from the pull down menu, in this example, '''Download'''.
*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>
+
*Choose the '''Option Value''' from the pull down menu, in this example, '''PDF'''.
*Ensure the file permission settings for the '''download''' folder/directory are set to '''0755'''
+
*Enter a net price adjustment in the '''Value Price''' input box if required.
*Ensure the file permission settings for the '''pub''' folder/directory are set to '''0777'''
+
*Enter a + or - prefix in the '''Prefix''' input box to add or subtract the price adjustment from the product price.
**File permissions can be changed using FileZilla by right clicking on the folder/directory and clicking '''File permissions...''' in the popup menu.
+
*Enter the exact file name of the downloadable file, including the file extension, for example '''.pdf''' in the '''Filename:''' input box.
*Create the new product in your shop in '''Catalog &rarr; Categories/Products''' - see <big>'''[[Categories/Products]]'''</big>
+
*The '''Expiry delay (days)''' and '''Maximum number of downloads''' can be changed from the defaults already set if required.
**Ensure to set the '''Products Weight''' to '''0'''
+
*Click <span style="color:green">'''<big>+</big>'''</span> to save.
*Go to '''Catalog &rarr; Products Attributes'''
+
*Repeat for each Option Name and Option Value you wish to apply to the product.
*Follow the p
+
 
*Choose the product from the '''Product Name''' pull down menu
+
 
*
 
 
----
 
----
 +
==='''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:
 +
 +
<div class="mainpage_box">
 +
[[File:customer-download.jpg|link=|1500px]]
 +
</div>
 +
 +
This link will stay there for the '''Expiry delay (days)''' period.
 +
 +
This restriction is set in '''Localization &rarr; Orders Status'''.
 +
 +
Go to '''Localization &rarr; Orders Status''' to see like this:
 +
 +
<div class="mainpage_box">
 +
[[File:order-status-download.jpg|link=|1500px]]
 +
</div>
 +
 +
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 &rarr; Orders Status'''
 +
*Click '''Pending (default)''' to see this:
 
<div class="mainpage_box">
 
<div class="mainpage_box">
[[File:downloadattributes.png]]
+
[[File:ordersstatus.jpg|link=]]
 
</div>
 
</div>
 +
*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