Difference between revisions of "X-Cart:Files"

From X-Cart 4 Classic
Jump to: navigation, search
(Created page with '===Adding downloadable product=== Adding a downloadable product is very to similar to adding an ordinary product, which is described in the [http://www.x-cart.com/xcart_manual/o…')
 
Line 1: Line 1:
===Adding downloadable product===
+
== Files in X-Cart ==
  
Adding a downloadable product is very to similar to adding an ordinary product, which is described in the [http://www.x-cart.com/xcart_manual/online/adding_products.htm Adding Products] section of this manual. The only difference regarding downloadable products is that you must also assign a file to a product using the <u>ESD distribution</u> field in the <u>Product details</u> form in the Admin/Provider area.
+
X-Cart provides a repository where the store staff can keep files; for example, the files of downloadable products (like software or e-books). The store staff can view and manage the contents of this repository using X-Cart's built-in file manager.
  
To assign a file to a product:
+
In X-Cart GOLD, the files repository corresponds to the directory <u>/</u>xcart<u>/files</u>, where <u>/</u>xcart is X-Cart installation directory. This repository is a common file storage space accessible equally to all of the store users with administrator/provider privileges.
  
# Create, import or clone a product as described in the [http://www.x-cart.com/xcart_manual/online/adding_products.htm Adding Products] section of this manual.
+
In X-Cart PRO, the files repository also corresponds to the directory <u>/</u>xcart<u>/files</u>; however, only users with unlimited administrator privileges have the ability to view and manage the contents of this repository in its entirety. For each of the store provider, a separate area is established within the repository beyond which they cannot access. This area corresponds to the directory <u>/</u>xcart<u>/files/</u>provider_login, where <u>/</u>xcart is X-Cart installation directory, and provider_login is the login name of the respective store provider.
# At the <u>Product details</u> page, locate the field <u>ESD Distribution</u>.
 
  
[[Image:egoods.gif|640px]]
+
== Roles in file management ==
  
# Assign a file to the product.
+
If you are an X-Cart GOLD administrator/provider or an X-Cart PRO administrator, you can perform the following tasks using X-Cart's file manager:
  
If the file repository is in the X-Cart root directory (by default the directory /files )
+
* you can view the contents of the store's files repository <u>/</u>xcart<u>/files</u> (See [[#Viewing the Contents of the Files Repository]]).
 +
* you can manage the contents of the store's files repository <u>/</u>xcart<u>/files</u> (See [[#Managing the Contents of the Files Repository]]).
  
# Make sure the file is uploaded to the file repository.
+
If you are an X-Cart PRO provider:
# Click the Browse... button.
 
  
You will see a form that enables you to select a file.
+
* you can view the contents of your area in the store's files repository <u>/</u>xcart<u>/files/</u>provider_login (See [[#Viewing the Contents of the Files Repository]]).
 +
* you can manage the contents of your area in the store's files repository <u>/</u>xcart<u>/files/</u>provider_login (See [[#Managing the Contents of the Files Repository]]).
  
[[Image:egoods_select_a_file.gif|639px]]
+
==Viewing the Contents of the Files Repository==
  
# If necessary, change the directory.
+
==Managing the Contents of the Files Repository==
# Select the required file from the list and click the Select button.
 
 
 
If the file repository is outside the X-Cart root directory, or the file is located on a different server
 
 
 
# Make sure you know the correct URL of the file.
 
# Put the absolute URL of the file into the the <u>ESD Distribution </u>field.
 
 
 
For example, if X-Cart is installed to the directory <u>public_html/xcart/</u> while the files for downloadable products are located in the directory <u>public_html/download/</u>, the URL must look like <u>http://www.example.com/download/product_filename</u> where <u>product_filename</u> is the name of the file, assigned to the product.
 
 
 
# Click the '''Save''' button.
 
 
 
===Processing orders===
 
 
 
Your store customers can pay for downloadable products, using any of the available payment options, including both online and offline methods.
 
 
 
A few minutes after an order with a downloadable product has been processed, a customer, who placed the order, receives an email message with a download key (a link like http://www.example.com/xcart/download.php?id=920e98f7d889eb7781a). The customer must then follow the link and download the product before the key has expired. The expiration period, which is also referred to as TTL (time to live), is defined by the store administrator on the module's configuration page. The TTL countdown for a download key begins immediately after the order has been processed and X-Cart sent a message with the key.
 
 
 
An order is considered to be processed after its status has been changed to "Processed". Order statuses can be changed either manually by the store administrator or automatically according to a response that X-Cart receives from a payment gateway, which actually processes online payments. For a more detailed description of how X-Cart handles orders and order statuses, refer to the [http://www.x-cart.com/xcart_manual/online/orders.htm Orders] section of the manual.
 
 
 
Due to the specificity of how digital products are delivered, the Egoods module enables you to have more control of how orders with digital products are processed: You can disable all online payment methods, which mostly provide for automatic order processing; or you can choose to enable only those payment methods that require manual processing or have the "auth only" mode. The "auth only" option means that a payment gateway does not really withdraw the order total from a customer's credit card, but it only checks whether the sum is available and temporarily freezes this money until a later time, which is limited by the terms and conditions of the payment gateway. The store administrator can then either capture the authorized amount or void it. As soon as the reserved money is captured, the order gets processed and X-Cart sends a download key to the customer.
 
 
 
This way of processing orders that contain downloadable products, as well as using other methods that require manual order processing, allows you to filter suspicious and potentially fraudulent orders and approve only trustworthy purchases.
 
 
 
{{Note1|Important: X-Cart does not automatically change the order status, depending on whether the product has been downloaded or not, as X-Cart does not track that kind of customer activities.}}
 
 
 
===Extending download period===
 
 
 
If necessary, the store administrator can extend the download period for products by prolonging the TTL (time-to-live) limit of download keys.
 
 
 
To prolong the TTL limit of a key:
 
 
 
# Log in to the Admin area.
 
# Open the order details page for the order that contains the download key you want to prolong.
 
# Click the '''Prolong TTL''' button at the bottom of the <u>Order details</u> form.
 
 
 
[[Image:egoods_prolong.gif|640px]]
 
 
 
Clicking on '''Prolong TTL''' will extend the download period of all downloadable products in the order for another period. The length of the period is defined by the store administrator at the module's configuration page. For details, see the [http://www.x-cart.com/xcart_manual/online/egoods1.htm#egoods_config Enabling and Configuring 'Egoods'] section of this manual.
 

Revision as of 22:17, 27 January 2010

Files in X-Cart

X-Cart provides a repository where the store staff can keep files; for example, the files of downloadable products (like software or e-books). The store staff can view and manage the contents of this repository using X-Cart's built-in file manager.

In X-Cart GOLD, the files repository corresponds to the directory /xcart/files, where /xcart is X-Cart installation directory. This repository is a common file storage space accessible equally to all of the store users with administrator/provider privileges.

In X-Cart PRO, the files repository also corresponds to the directory /xcart/files; however, only users with unlimited administrator privileges have the ability to view and manage the contents of this repository in its entirety. For each of the store provider, a separate area is established within the repository beyond which they cannot access. This area corresponds to the directory /xcart/files/provider_login, where /xcart is X-Cart installation directory, and provider_login is the login name of the respective store provider.

Roles in file management

If you are an X-Cart GOLD administrator/provider or an X-Cart PRO administrator, you can perform the following tasks using X-Cart's file manager:

If you are an X-Cart PRO provider:

Viewing the Contents of the Files Repository

Managing the Contents of the Files Repository