X-Cart:Files - Revision history

Dohtur: /* Roles in file management */

2012-10-09T09:34:23Z

‎Roles in file management

Dohtur: /* Files in X-Cart */

2012-10-09T09:31:38Z

‎Files in X-Cart

Dohtur: /* Viewing the Contents of the Files Repository */

2012-08-01T10:29:33Z

‎Viewing the Contents of the Files Repository

Admin: /* Managing the Contents of the Files Repository */

2010-01-27T18:44:51Z

‎Managing the Contents of the Files Repository

Admin at 18:41, 27 January 2010

2010-01-27T18:41:48Z

Admin at 18:23, 27 January 2010

2010-01-27T18:23:50Z

Admin at 18:17, 27 January 2010

2010-01-27T18:17:47Z

Admin: 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…'

2010-01-27T18:15:44Z

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…'

New page

===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/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 ESD distribution field in the Product details form in the Admin/Provider area.

To assign a file to a product:

# 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.
# At the Product details page, locate the field ESD Distribution.

[[Image:egoods.gif|640px]]

# Assign a file to the product.

If the file repository is in the X-Cart root directory (by default the directory /files )

# Make sure the file is uploaded to the file repository.
# Click the Browse... button.

You will see a form that enables you to select a file.

[[Image:egoods_select_a_file.gif|639px]]

# If necessary, change the directory.
# 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 ESD Distribution field.

For example, if X-Cart is installed to the directory public_html/xcart/ while the files for downloadable products are located in the directory public_html/download/, the URL must look like http://www.example.com/download/product_filename where product_filename 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 Order details 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.

@@ Line 9: / Line 9: @@
 == 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 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:
 * 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]]).
-If you are an X-Cart PRO provider:
+If you are an X-Cart PLATINUM or PRO provider:
 * 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]]).

@@ Line 3: / Line 3: @@
 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 <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.
+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.
-In X-Cart PRO, the files repository also corresponds to 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.
+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.
 == Roles in file management ==

@@ Line 25: / Line 25: @@
 To view the contents of the files repository / your files repository area, do the following:
-. Open X-Cart's file manager: click on <u>Files</u> in the <u>Management menu</u>.
+. 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 '<u>Browse files</u>'.

@@ Line 41: / Line 41: @@
 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 in the files repository / your files repository area ===
+=== Creating directories ===
 You can create directories in the files repository / your files repository area.
@@ Line 54: / Line 54: @@
 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 from the files repository / your files repository area ===
+=== Deleting directories ===
 You can delete the directories you no longer need. Deleting a directory deletes all the files and sub-directories under that directory.
@@ Line 67: / Line 67: @@
 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 to the files repository / your files repository area ===
+=== Uploading files  ===
 You can upload files to the files repository / your files repository area from your local computer.
@@ Line 81: / Line 81: @@
 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.
-=== Creating copies of files stored in the files repository / your files repository area ===
+=== Copying files  ===
 You can create copies of files stored in the files repository / your files repository area.
@@ Line 95: / Line 95: @@
 When you click on '''Copy''', the file copy is created. A message is displayed confirming that the file has been copied successfully.
-=== Deleting files from the files repository / your files repository area ===
+=== Deleting files  ===
 You can delete files stored in the files repository / your files repository area.

← Older revision		Revision as of 18:41, 27 January 2010
Line 20:		Line 20:

	==Viewing the Contents of the Files Repository==		==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: click on <u>Files</u> in the <u>Management menu</u>.
		+
		+	: You should see a dialog box titled '<u>Browse files</u>'.
		+
		+	: [[Image:browsefiles.gif\|592px]]
		+
		+	: This is the file manager.
		+
		+	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.
		+
		+	The top section of the '<u>Browse files</u>' dialog box is a file browser, you can use it for navigation.

	==Managing the Contents of the Files Repository==		==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 in the files repository / your files repository area ===
		+
		+	You can create directories in the files repository / your files repository area.
		+
		+	To create a directory, do the following:
		+
		+	# 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.
		+
		+	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 from the files repository / your files repository area ===
		+
		+	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:
		+
		+	# 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 to the files repository / your files repository area ===
		+
		+	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.
		+
		+	=== Creating copies of files stored in the files repository / your files repository area ===
		+
		+	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 from the files repository / your files repository area ===
		+
		+	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.

@@ 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.
-[[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]]).
-# Make sure the file is uploaded to the file repository.
+If you are an X-Cart PRO provider:
-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]]).
-[[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==