Source: https://help.x-cart.com/index.php?title=X-Cart:FAQs&diff=15201&oldid=9434
Timestamp: 2018-08-18 00:44:37
Document Index: 500571242

Matched Legal Cases: ['art 4', 'art.27', 'art.27', 'art%27', 'art/41543177', 'art_4', 'art 4', 'art 4']

Revision as of 14:22, 21 November 2012 (view source)
(→‎I have changed domain names of my web-site. How to I set up my X-Cart store to reflect the new domain names?)
Latest revision as of 14:44, 7 February 2018 (view source)
m (→‎I want to move my store to another domain. Is there anything that I must do pertaining to licensing?)
===What is the one-license-one-store rule ?===
# If your store is accessible from multiple domains but the content is the same for each link, this is OK and does not require multiple licenses.
# If your store is accessible from multiple domains but each domain shows a different storefront skin style, this is OK and does not require multiple licenses.
# If your multiple stores are located at sub-domains or in sub-directories of the same domain, the license for each store is required.
# If your store is accessible from multiple domains and your store is customized to show/hide/alter certain part of content based on the domain, the license for each domain is required. In this situation the stores appear to have separate content thereby making them separate stores in the eyes of the license agreement. The content needs to be the same for each domain in order to qualify as a single store.
===What is License URL?===
License URL is a [http://en.wikipedia.org/wiki/Uniform_resource_locator web address] where the license obtained by you permits you to install and run the X-Cart software.
===How to transfer the license to another party?===
X-Cart License agreement allows you to transfer your license to another party. Read [[Using your Qualiteam Account#How to transfer the license to another party?|how to submit a request to transfer your license]].
===How to obtain an additional license?===
You can purchase an additional license in <u>Buy products/services</u> section of your {{QA}}:
- choose the product you require and select the 'Select' checkbox opposite its name;<br />
===I want to move my store to another domain. Is there anything that I must do pertaining to licensing?===
Moving to another domain is possible for X-Cart 4.6 and later. The process is, however, subject to limitations as defined in the [https://www.x-cart.com/license-agreement-classic.html X-Cart Classic license agreement]:
* If the domain name is changed before the first license [http://help.x-cart.com/index.php?title=X-Cart:Licensing#Registering_installed_X-Cart registration], the license URL can be changed as many times as needed.
* After the first license registration, you are permitted to change the domain name in the license URL free of charge only once. Each further license URL change will be subject to license renewal fee.
* Sign in in your {{QA}}.
* Go to the 'My licenses' section.
* Click 'Change URL' link located next to the license. You will be redirected to the "Change license URL" tab.
* Click on the "Change domain" link.
* Enter the new URL in the textfield provided and select the option "I understand that I have to remove the software from old_url within 48 hours after the license is reissued".
* Click 'Change URL'.
===I want to move my store to another folder on my web server. Should I submit the updated URL into your license tracking system?===
In case you are moving your store to another directory within the same domain (e.g. ''mydomain.com/store'' is replaced by ''mydomain.com/newstore''), you should change the license URL in your {{QA}}.
* go to 'My licenses' section;
* click 'Change URL' link located next to the license;
* you will be redirected to the "Change license URL" tab: enter the folder path in the provided input field;
* hit 'Change folder location' button.
==Installation, configuration and basic usage==
===Where do I download X-Cart?===
[http://www.x-cart.com/download.html Click here] to download the latest release of X-Cart GOLD or GOLD PLUS. More files are available in the '''File area''' section of your [https://secure.qtmsoft.com Qualiteam account]. Files are supplied in '''.tgz''' or '''.zip''' archives.
[http://www.x-cart.com/download.html Click here] to download the latest release of X-Cart GOLD or GOLD PLUS. More files are available in the '''File area''' section of your [http://secure.x-cart.com/ Qualiteam account]. Files are supplied in '''.tgz''' or '''.zip''' archives.
===How can I unpack X-Cart distribution archive in Windows?===
Images storage location is defined in the admin back end, "Images Location" page.}}
===I have changed domain names of my web-site. How to I set up my X-Cart store to reflect the new domain names?===
===How to protect my admin area with web authentication system?===
Basically, to provide HTTP basic authentication for admin area via the server configuration, you need to set up <u>.htaccess</u> file in the X-Cart's <u>admin/</u> directory.
1. In X-Cart Admin area, open the [[X-Cart:Summary_Page |Summary]] page.
<pre>htpasswd -c .htpasswd webmaster</pre>
You can modify your auth_code at your discretion by editing the <tt>[xcart_dir]/config.php</tt> file.
===How can I make a local copy of X-Cart?===
[http://youtu.be/cYb-npb7q6Q This video tutorial] by Mike White will guide you through creating a local copy of X-Cart that will run directly on your computer and allow you to make changes and test scenarios quickly and easily.
===How to change storefront skin after the installation is done?===
# Complete the re-installation and check how your store looks now.
===How to replace logo shown on storefront?===
===How to replace the logo shown on the storefront?===
For the default skin, the logo can be changed by altering the following IMG tag located in the '<u>/skin/common_files/customer/head.tpl</u>' template:
For further details and instructions on replacing the logo for other skins, please refer to [[X-Cart:Editing_Skin_Files#Replacing_X-Cart.27s_Logo | Replacing X-Cart's Logo]].
For further details and instructions on replacing the logo for other skins, please refer to [[X-Cart:Editing_Skin_Files#Replacing_X-Cart.27s_Logo | Replacing X-Cart's Logo]]. Changing the logo in Ideal Responsive skin is a bit different; instructions are available in [[X-Cart:Replacing_X-Cart%27s_Logo_in_the_Ideal_Responsive_Skin|Replacing X-Cart's Logo in the Ideal Responsive Skin]].
{{XC 4.5}}
{{Note|For Ideal Comfort skin, the corresponding logo image file and template file are '<u>/skin/ideal_comfort/images/custom/small_logo.gif</u>' and '<u>/skin/ideal_comfort/mail/html/order_invoice.tpl</u>', and the new logo file should be uploaded to the '<u>/skin/ideal_comfort/images/custom</u>' directory. The line of code that should be adjusted in the template files is:
<source><img src="{$AltImagesDir}/custom/small_logo.gif" alt="" /></source>}}
{{XC 4.6}}
{{Note|For Ideal Responsive skin, the corresponding logo image file and template file are '<u>/skin/ideal_responsive/images/custom/small_logo.gif</u>' and '<u>/skin/ideal_responsive/mail/html/order_invoice.tpl</u>', and the new logo file should be uploaded to the '<u>/skin/ideal_responsive/images/custom</u>' directory. The line of code that should be adjusted in the template files is:
Learn more about favicon on [http://en.wikipedia.org/wiki/Favicon Wikipedia].
===How can I remove/replace a favicon in my X-Cart based website?===
To remove the favicon delete the following line in <u><xcart_dir>/skin/common_files/customer/service_head.tpl</u> file:
===How would I insert a YouTube video, so it shows the actual screen to click on, in the front page of the site?===
* [[X-Cart:Editing_Skin_Files|Editing Skin Files]]
* [[X-Cart:Customizing_storefront|Customizing Storefront]]
===How do I change the quality of thumbnail images generated by X-Cart?===
When generating resized images, X-Cart processes images using the "Unsharp masking" tool (https://en.wikipedia.org/wiki/Unsharp_masking#Digital_unsharp_masking).
The parameters of the filter can be adjusted in the file $xcart_dir . '/include/lib/phpunsharpmask.php'<br />
===How do you add a new configuration setting to X-Cart?===
<pre>{$config.Appearance.new_option}</pre>
===My store says "This is a demo store powered by the X-Cart". Does this mean I am using demo version?===
===My store says "This is a demo store powered by the X-Cart". How do I change it?===
# Log in to the admin area
# Go to the "Languages" section
# Select a language in the "Edit language" selectbox.
# Select a language in the "Edit language" select-box
# Select a topic: Text. (‘text’ for :txt_, ‘Errors’ for err_)
# Select a topic: Text ('Text' for txt_, 'Errors' for err_)
# Enter 'txt_welcome' in the 'Apply Filter' field to find the variable and edit its value in the memo field.
# Enter 'txt_welcome' in the 'Apply Filter' field to find the variable and edit its value in the memo field
# Click the '''Update all''' button.
# Click the '''Update all''' button
Also, if you start the [[X-Cart:Customizing_storefront#Using_Webmaster_mode | "Webmaster mode"]], you will be able to edit language variables in an easier way: all you will need is to click the text and edit it.
===How to set up drop shipping?===
If you are planning to transfer customer orders and shipment details to external providers - manufacturers or a wholesalers - who would then ship the ordered products directly to the customers, make sure that the provider country matches the company location country; otherwise, shipping rates returned by the real-time shipping modules may be wrong. To implement providers based in other countries, please contact our [https://secure.qtmsoft.com/ technical support] for customizing your X-Cart software.
If you are planning to transfer customer orders and shipment details to external providers - manufacturers or a wholesalers - who would then ship the ordered products directly to the customers, make sure that the provider country matches the company location country; otherwise, shipping rates returned by the real-time shipping modules may be wrong. To implement providers based in other countries, please contact our [http://secure.x-cart.com/ technical support] for customizing your X-Cart software.
===Does X-Cart support recurring billing?===
Beginning from version 4.4.0 X-Cart comes without [[X-Cart:Subscriptions]] module (due to limitations caused by [[X-Cart:PCI-DSS|PCI-DSS]] standard). To allow recurring transactions you should use an appropriate service offered by the payment gateway or by 3rd-party providers.
Beginning from version 4.4.0 X-Cart comes without [[X-Cart:Subscriptions]] module (due to limitations caused by [[X-Cart:PCI_DSS|PCI DSS]] standard). To allow recurring transactions you should use an appropriate service offered by the payment gateway or by 3rd-party providers.
===How to setup X-Cart in PCI-DSS compliant manner?===
===How to setup X-Cart in PCI DSS compliant manner?===
Please find guidelines at [[X-Cart:PCI-DSS]].
Please find guidelines at [[X-Cart:PCI_DSS]].
===What is "background" payment gateway?===
:http://yourwebsite.com/xcart_dir/admin/convert_database_2_utf8.php
5) Related question on [http://stackoverflow.com/questions/41521696/greek-language-x-cart/41543177#41543177 stackoverflow.com]
===How do I convert my data in CSV file to support UTF-8 encoding?===
Line 557: Line 683:
This field is intended for merchants who use the same merchant account for several online stores. An order prefix helps such merchants to distinguish payments from different stores. After defining an unique order prefix for each of the stores, the merchant can find out from which of the stores this or that payment originated based on the prefix automatically attached to the order ID.
If you do not need this feature, simply leave the field empty.
===How to make PayPal to notify my X-cart store of events related to PayPal transactions?===
Line 569: Line 700:
* http://help.qtmsoft.com/index.php?title=X-Cart:Payment_gateways_(X-Cart_4.4)
* http://help.x-cart.com/index.php?title=X-Cart:Payment_gateways
{{Note | In old X-Cart versions some of the payment gateways do not support 3D Secure (or none of them do). Please refer to [[File:X-CART_CHANGELOG.txt]] to find out in what X-Cart versions and for what payment gateways 3D Secure was implemented.}}
* [[X-Cart:Setting_up_file_permissions | Setting up file permissions for X-Cart]]
===My store was moved to another domain. Is there anything that I must do pertaining to licensing?===
You should change the license URL in your {{QA}}.
* you will be redirected to the "Change license URL" tab: enter the new license URL in the corresponding field there and tick "I understand that I have to remove the software from old_url within 48 hours after the license is reissued" checkbox;
* hit 'Change URL' button.
Line 707: Line 803:
However, some data cannot be transferred during the transfer. In this case you can export the LC db data using phpMyAdmin, and then import that db data into X-Cart using the [[X-Cart:Import-Export_Guide#Importing_Data | Import Tool]].
All files you need are in your [https://secure.qtmsoft.com/customer.php?area=filearea&target=files_explorer File area].
All files you need are in your [http://secure.x-cart.com/customer.php?area=filearea&target=files_explorer File area].
* lc2xc-import-4.3.2.tgz
Line 838: Line 934:
<pre>Your account is temporarily disabled. Please contact the store administrator for details.</pre>
''X-Cart 4.5.5 and later:''
{{Note1|<b>IMPORTANT!</b> Replace the <b>'master'</b> value in the above query statement with your admin login or email!}}
{{Note1|<b>IMPORTANT!</b> Be sure to replace the <b>'master'</b> value in the above query statement with your admin login or email.}}
If you find it difficult to do it yourself - feel free to contact our support team for assistance via your personal [https://secure.qtmsoft.com/ Helpdesk].
If you find it difficult to do it yourself, feel free to contact our support team for assistance via your personal [http://secure.x-cart.com/ Helpdesk].
Additionally, in order to prevent your admin account from being locked/suspended, please review the following [[X-Cart:Security_Options#PCI_DSS_compliance_options | PCI DSS compliance options]] in your X-Cart store back-end, and adjust them if necessary:
Additionally, in order to prevent your admin account from being locked/suspended, please review the [[X-Cart:Security_Options#PCI_DSS_compliance_options | PCI DSS compliance options]] in your X-Cart store's back end and adjust them if necessary:
* Number of failed login attempts after which a user account must be suspended;
Line 860: Line 977:
* [[X-Cart:Applying_Patches#Applying_SQL_Patches | Applying SQL Patches]]
===How do I change or reset my admin password? (I have lost it)===
===How do I change or reset my admin password? (I lost it)===
{{X-Cart:How do I change or reset my admin password? (I lost it)}}
===I have reset my admin password, but still can not log in. What is wrong?===
[http://www.example.com/xcart/admin/home.php http://www.example.com/xcart/admin/home.php]
Try to log in using any account of the "provider" type, or create a temporary account for the purpose of logging in, as suggested in [[X-Cart:FAQs#How_do_I_change_or_reset_my_admin_password.3F_.28I_have_lost_it.29 | this article]] (See instructions for X-Cart GOLD edition specifically).
[http://www.example.com/xcart/admin/help.php?section=Password_Recovery http://www.example.com/xcart/admin/help.php?section=Password_Recovery]
* [[X-Cart:Simple_Mode | Simple Mode]]
* [[X-Cart:Types_of_User_Accounts | Types of User Accounts]]
* [[X-Cart:User_Memberships | User Memberships]]
* [[X-Cart:Understanding_X-Cart | Understanding X-Cart]]
{{Note1|NOTE: "http://www.example.com/xcart/" should be replaced with your actual X-Cart store's URL, for example http://xcart-demo.qtmsoft.com/demo/admin/home.php}}
Should you face any difficulties when getting access to your X-Cart admin area, do not hesitate to contact our support team via your personal [http://secure.x-cart.com/ Helpdesk]. Our support engineers are always ready to help.
===Should I re-generate the blowfish encryption key?===
The respective message in your X-Cart Admin area only advises you to re-generate the key. This is not a mandatory, yet a highly recommended operation, just as changing the login and password that you use for accessing your X-Cart Admin area, FTP, SSH, etc., which you are recommended to change every once in a while. Here is how to [[X-Cart:Advanced_Tools#Re-generate_the_Blowfish_Encryption_Key|re-generate your blowfish encryption key]].
===Is there any way to disable the blowfish encrpytion without knowing the merchant key?===
''X-Cart GOLD or GOLD PLUS edition''
<source>DELETE FROM xcart_customers WHERE login = 'mytempadminlogin';
VALUES ('mytempadminlogin', 'mytempadminpass', 'P');</source>
''X-Cart PLATINUM or PRO edition''
* [[X-Cart:Blowfish#Blowfish key based encryption method|Blowfish key based encryption]]
* [[X-Cart:Advanced_Tools#Re-generate the Blowfish Encryption Key|Advanced Tools: Re-generate the Blowfish Encryption Key]]
VALUES ('mytempadminlogin', 'mytempadminpass', 'A');</source>
* [[X-Cart:Blowfish#Merchant key based encryption method|Merchant key based encryption]]
===Is there a way to restore a lost merchant key?===
<source>DELETE FROM xcart_customers WHERE login = 'myemail@address.com';
===I am not receiving emails from my X-Cart store. How do I fix that?===
VALUES ('myemail@address.com', 'mytempadminpass', 'P');</source>
Generally, when a customer uses the "Contact us", "Send to a friend" and "Ask a question about this product" forms, the customer's email address (for example customer@gmail.com) is placed in the 'From' header of the message being sent. The same happens when a customer submits an order at your X-Cart based store and cart sends the order notification emails to the [[X-Cart:Company_Options#Company_emails | Orders department email address]].
VALUES ('myemail@address.com', 'mytempadminpass', 'A');</source>
* Username: mytempadminlogin (or myemail@address.com)
To solve this problem set up the [[X-Cart:Company_Options#Company_.22From.22_email | 'Company "From" email']] option in your X-Cart admin back-end.
* Password: mytempadminpass
If it still does not help, try enabling another option on the '<u>General settings/Email options</u>' page - [[X-Cart:Email_Options#Basic_email_options | Add additional '-f' parameter to the PHP mail() function]].
If you find it difficult to do it yourself - feel free to request our support team for assistance via your personal [https://secure.qtmsoft.com/ Helpdesk].
To solve the problem, you can set up your X-Cart store to send emails via SMTP instead of PHP mailer: just configure and enable the corresponding [[X-Cart:Email_Options#SMTP_options | SMTP options]] on the '<u>General settings/Email options</u>' page.
* [[X-Cart:FAQs#How_do_I_test_whether_emails_are_actually_sent_from_my_website.3F | How do I test whether emails are actually sent from my website?]]
===How do I test whether emails are actually sent from my website?===
1. Download the [[File:Test_mail.php.txt]], save the downloaded file as 'test_mail.php'.
Should you face any difficulties when getting access to your X-Cart admin area, do not hesitate to contact our support team via your personal [https://secure.qtmsoft.com/ Helpdesk]. Our support engineers are always ready to help.
To solve the problem, try enabling the [[X-Cart:Company_Options#Company_.22From.22_email | 'Company "From" email']] option.
Also, if the mail are being sent with PHP mail and not using any SMTP authentication then the mail is likely going to be sent through open mail relays. These mail relays are usually unmanaged and can develop a queue, and as a result the email stacks and delivery times increase. So, you can try setting up [[X-Cart:Email_Options#SMTP_options | SMTP options]], then the mails will be sent through the SMTP servers instead and will be delivered much quicker and more reliably. Please contact your hosting provider to know if emails can be sent with SMTP authentication on your server.
If changing of your web-server's settings is not possible, or this does not help, please request our support team for assistance in your personal [https://secure.qtmsoft.com/customer.php?area=center&target=customer_info Helpdesk area].
If changing of your web-server's settings is not possible, or this does not help, please request our support team for assistance in your personal [http://secure.x-cart.com/customer.php?area=center&target=customer_info Helpdesk area].
Line 1,134: Line 1,222:
===Google Checkout can not communcate with my X-Cart store. How do I solve this problem?===
* [[X-Cart:Importing_and_Exporting_Data | Importing and Exporting Data]]
Please refer to [[X-Cart:Google_Checkout#Google_Checkout_can_not_communcate_with_my_X-Cart_store._How_do_I_solve_this_problem.3F | X-Cart:Google Checkout. Troubleshooting]].
===I am getting "Cannot write data to the temporary directory..." error. How do I solve this problem?===
Make sure that proper writable permissions are set for the directory <u>var</u> and its subdirectories, and for all files in the the directory <u>var</u> and its subdirectories in your X-Cart installation.
For more information about what permissions must be set for X-Cart files and folders please refer to [[X-Cart:After_the_upgrade#Restoring_File_Permissions | this article]].
===How to set up X-Cart to accept 3 decimal places for shipping charges?===
Download and [[X-Cart:Applying_Patches | apply]] the following patches:
* [[File:3_decimal_shipping_charges.patch]]
* [[File:3_decimal_shipping_charges.sql]]
===I am getting "Not Finished" or "Queued" orders in my X-Cart store, although they are successfully paid via PayPal (Website Payments Standard). How do I solve the problem?===
Make sure Instant Payment Notification option is enabled in your PayPal account settings (see [[X-Cart:PayPal#Putting_PayPal_to_Work_with_X-Cart | "Putting PayPal to Work with X-Cart" section, step 6]]).
===Customers are not automatically returned from PayPal to my X-Cart store after successful payment (Website Payments Standard). How do I solve the problem?===
Make sure Auto Return option is enabled in your PayPal account settings (see [[X-Cart:PayPal#Putting_PayPal_to_Work_with_X-Cart | "Putting PayPal to Work with X-Cart" section, step 7]]).
===None of our products show up and no searches return any results. How do I solve the problem?===
* http://help.x-cart.com/index.php?title=X-Cart:Advanced_Tools#Force_Cache_Generation
* http://www.qtmsoft.com/support/subscription-based-support.html
===How do I enable case-insensitive login for X-Cart 4.3.2?===
* [[File:DIFF_51010.patch | DIFF_51010.patch]]
* [[File:DIFF_51011.patch | DIFF_51011.patch]]
Note, you may need to [[X-Cart:To_apply_a_patch_manually | install these patches manually]].
===Ideal responsive theme inserted a new "Shopping Cart Software" image in the center column just above my own content. See image below. How do I get rid of it?===
:[[File:Xcart_welcome_image.png|border]]
Line 3,441: Line 3,544:
Latest revision as of 14:44, 7 February 2018