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…')
 
m (→‎Roles in file management)
 
(6 intermediate revisions by 2 users not shown)
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 or GOLD PLUS, the files repository is the directory <u>/xcart/files</u>, where <u>/xcart</u> 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 PLATINUM or PRO, the files repository is also the directory <u>/xcart/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>/xcart/files/</u>provider_login, where <u>/xcart</u> 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 or GOLD PLUS administrator/provider or an X-Cart PLATINUM or 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>/xcart/files</u> (See [[#Viewing the Contents of the Files Repository]]).
 +
* you can manage the contents of the store's files repository <u>/xcart/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 PLATINUM or 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>/xcart/files/provider_login</u> (See [[#Viewing the Contents of the Files Repository]]).
 +
* you can manage the contents of your area in the store's files repository <u>/xcart/files/provider_login</u> (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.
+
Depending on the role you perform in the store, you can view the contents of either the store's entire files repository or of your personal area within that 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
+
To view the contents of the files repository / your files repository area, do the following:
  
−
# Make sure you know the correct URL of the file.
+
1. Open X-Cart's file manager. In X-Cart versions 4.4.0 and later, the file manager can be found at Content menu -> Files; in X-Cart versions 4.3.x, the file manager can be found at Management menu -> Files; in earlier versions, the file manager can be found at Administration menu -> Files.
−
# 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.
+
: You should see a dialog box titled '<u>Browse files</u>'.
  
−
# Click the '''Save''' button.
+
: [[Image:browsefiles.gif|592px]]
  
−
===Processing orders===
+
: This is the file manager.
  
−
Your store customers can pay for downloadable products, using any of the available payment options, including both online and offline methods.
+
2. At the top of the '<u>Browse files</u>' dialog box, you should see the contents of the files repository / your files repository area.
  
−
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.
+
The top section of the '<u>Browse files</u>' dialog box is a file browser, you can use it for navigation.
  
−
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.
+
==Managing the Contents of the Files Repository==
  
−
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.
+
Depending on the role you perform in the store, you can manage the contents of either the store's entire files repository or of your personal area within that repository.
  
−
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.
+
=== Creating directories ===
  
−
{{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.}}
+
You can create directories in the files repository / your files repository area.
  
−
===Extending download period===
+
To create a directory, do the following:
  
−
If necessary, the store administrator can extend the download period for products by prolonging the TTL (time-to-live) limit of download keys.
+
# Open X-Cart's file manager.
 +
# Use the file browser at the top of the '<u>Browse files</u>' dialog box to navigate to the location where you wish to create the new directory.
 +
# Into the field '<u>New directory name</u>', enter the desired directory name.
 +
# Click the '''Create''' button.
  
−
To prolong the TTL limit of a key:
+
When you click on '''Create''', the directory is created at the current location. A message is displayed confirming that the directory has been created successfully.
  
−
# Log in to the Admin area.
+
=== Deleting directories ===
−
# 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]]
+
You can delete the directories you no longer need. Deleting a directory deletes all the files and sub-directories under that directory.
  
−
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.
+
To delete a directory:
 +
 
 +
# Open X-Cart's file manager.
 +
# Use the file browser at the top of the '<u>Browse files</u>' dialog box to locate the directory you wish to delete.
 +
# Select the radio button next to the name of this directory.
 +
# Click the '''Delete selected''' button. When prompted, confirm the deletion.
 +
 
 +
When you confirm the deletion, the selected directory is deleted. A message is displayed confirming that the selected directory has been deleted successfully.
 +
 
 +
=== Uploading files  ===
 +
 
 +
You can upload files to the files repository / your files repository area from your local computer.
 +
 
 +
To upload a file:
 +
 
 +
# Open X-Cart's file manager.
 +
# Use the file browser at the top of the '<u>Browse files</u>' dialog box to navigate to the location to which you wish to upload a file.
 +
# Use the '<u>Upload file to the current directory</u>' section of the '<u>Browse file</u>' dialog box to select the file that you wish to be uploaded.
 +
# If you are uploading the file in order to replace its older version residing in the current directory, select the '<u>Replace file if exists</u>' check box.
 +
# Click the '''Upload''' button.
 +
 
 +
When you click on '''Upload''', the file is uploaded to the current directory. A message is displayed confirming that the selected file has been uploaded successfully.
 +
 
 +
=== Copying files  ===
 +
 
 +
You can create copies of files stored in the files repository / your files repository area.
 +
 
 +
To create a copy of a file:
 +
 
 +
# Open X-Cart's file manager.
 +
# Use the file browser at the top of the '<u>Browse files</u>' dialog box to locate the file you wish to copy; for example, '<u>Sample.jpg</u>'.
 +
# Select the radio button next to the name of this file.
 +
# Use the '<u>Copy file name</u>' field to enter a name that you wish to be used for the file copy; for example, '<u>Sample_copy.jpg</u>'.
 +
# Click the '''Copy''' button.
 +
 
 +
When you click on '''Copy''', the file copy is created. A message is displayed confirming that the file has been copied successfully.
 +
 
 +
=== Deleting files  ===
 +
 
 +
You can delete files stored in the files repository / your files repository area.
 +
 
 +
To delete a file:
 +
 
 +
# Open X-Cart's file manager.
 +
# Use the file browser at the top of the '<u>Browse files</u>' dialog box to locate the file you wish to delete.
 +
# Select the radio button next to the name of this file.
 +
# Click the '''Delete selected''' button. When prompted, confirm the deletion.
 +
 
 +
When you confirm the deletion, the selected file is deleted. A message is displayed confirming that the selected file has been deleted successfully.

Latest revision as of 13:34, 9 October 2012

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 or GOLD PLUS, the files repository is 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 PLATINUM or PRO, the files repository is also 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 or GOLD PLUS administrator/provider or an X-Cart PLATINUM or PRO administrator, you can perform the following tasks using X-Cart's file manager:

If you are an X-Cart PLATINUM or PRO provider:

Viewing the Contents of the Files Repository

Depending on the role you perform in the store, you can view the contents of either the store's entire files repository or of your personal area within that repository.

To view the contents of the files repository / your files repository area, do the following:

1. Open X-Cart's file manager. In X-Cart versions 4.4.0 and later, the file manager can be found at Content menu -> Files; in X-Cart versions 4.3.x, the file manager can be found at Management menu -> Files; in earlier versions, the file manager can be found at Administration menu -> Files.

You should see a dialog box titled 'Browse files'.
Browsefiles.gif
This is the file manager.

2. At the top of the 'Browse files' dialog box, you should see the contents of the files repository / your files repository area.

The top section of the 'Browse files' dialog box is a file browser, you can use it for navigation.

Managing the Contents of the Files Repository

Depending on the role you perform in the store, you can manage the contents of either the store's entire files repository or of your personal area within that repository.

Creating directories

You can create directories in the files repository / your files repository area.

To create a directory, do the following:

  1. Open X-Cart's file manager.
  2. Use the file browser at the top of the 'Browse files' dialog box to navigate to the location where you wish to create the new directory.
  3. Into the field 'New directory name', enter the desired directory name.
  4. Click the Create button.

When you click on Create, the directory is created at the current location. A message is displayed confirming that the directory has been created successfully.

Deleting directories

You can delete the directories you no longer need. Deleting a directory deletes all the files and sub-directories under that directory.

To delete a directory:

  1. Open X-Cart's file manager.
  2. Use the file browser at the top of the 'Browse files' dialog box to locate the directory you wish to delete.
  3. Select the radio button next to the name of this directory.
  4. Click the Delete selected button. When prompted, confirm the deletion.

When you confirm the deletion, the selected directory is deleted. A message is displayed confirming that the selected directory has been deleted successfully.

Uploading files

You can upload files to the files repository / your files repository area from your local computer.

To upload a file:

  1. Open X-Cart's file manager.
  2. Use the file browser at the top of the 'Browse files' dialog box to navigate to the location to which you wish to upload a file.
  3. Use the 'Upload file to the current directory' section of the 'Browse file' dialog box to select the file that you wish to be uploaded.
  4. If you are uploading the file in order to replace its older version residing in the current directory, select the 'Replace file if exists' check box.
  5. Click the Upload button.

When you click on Upload, the file is uploaded to the current directory. A message is displayed confirming that the selected file has been uploaded successfully.

Copying files

You can create copies of files stored in the files repository / your files repository area.

To create a copy of a file:

  1. Open X-Cart's file manager.
  2. Use the file browser at the top of the 'Browse files' dialog box to locate the file you wish to copy; for example, 'Sample.jpg'.
  3. Select the radio button next to the name of this file.
  4. Use the 'Copy file name' field to enter a name that you wish to be used for the file copy; for example, 'Sample_copy.jpg'.
  5. Click the Copy button.

When you click on Copy, the file copy is created. A message is displayed confirming that the file has been copied successfully.

Deleting files

You can delete files stored in the files repository / your files repository area.

To delete a file:

  1. Open X-Cart's file manager.
  2. Use the file browser at the top of the 'Browse files' dialog box to locate the file you wish to delete.
  3. Select the radio button next to the name of this file.
  4. Click the Delete selected button. When prompted, confirm the deletion.

When you confirm the deletion, the selected file is deleted. A message is displayed confirming that the selected file has been deleted successfully.

Retrieved from "https://help.x-cart.com/index.php?title=X-Cart:Files&oldid=8919"