Installation Guide - X-Cart
Contents
1. gts i prodsearch language gt ITEM GOOGLE SHOPPING LANGUAGE lt span gt lt span gt lt end item 1 example gt lt end repeated item specific information gt lt div gt lt END Google Trusted Stores Order gt Google Trusted Stores Badge Code The Google Trusted Stores badge code This code allows the display of the Google Trusted Stores badge on your site This code should be placed on every page of your website lt BEGIN Google Trusted Stores gt lt script type text javascript gt var gts gts gts push id 57483 gts push google_base_offer_id ITEM GOOGLE SHOPPING ID gts push google_base_subaccount_id ITEM GOOGLE SHOPPING ACCOUNT _ID gts push google_base_country ITEM GOOGLE SHOPPING COUNTHY gts push google_base_language ITEM GOOGLE SHOPPING LANGUAGE function var scheme https document location protecol https http var gts document createElement script gts type text javascript gts async true gts src scheme wew googlecoamerce com trustedstores gtap_compiled js var s document getElenentsEyTagName script 0 s parentNode insertBefore gts 5 i lt script gt lt END Google Trusted Stores gt The second part of this page look to the left for a screenshot refers to the code used to send the necessary information related to the pr2. free Check the GTS distribution package With the purchase of GTS module you should have received by e mail or allowed to download the GTS distribution package If you have not received or cannot download the distribution package please contact us The package contains the files needed for the module to work as well as installation instructions The installation directory is called _install and there you will find 2 files one for the database entries and one with installation instructions 4 Is this module all need to become a Google Trusted Store Requirements 1 To successfully install this module you need to have basic knowledge of PHP MySQL and Smarty as well as how to use FTP client program The module installation requires changes to database php scripts and templates If you do not have the knowledge to modify these types of file data please consider our professional installation service 2 Make sure your store X Cart version is covered This module can be installed on X Cart version 4 1 x or up 3 Make sure the distribution package includes files for your store branch version i e if your X Cart version is 4 2 1 you need the directory called 4 2 x from the distribution package 4 You have to have Google Trusted Stores account with Google If you do not have one you can easily register at http www google com trustedstores 5 You also have to have Google Merchant Center account in order to 5 Are there any re
3. how to setup the feeds in your Google Merchant Center account Program Agreements Vv Digitally sign the program and shipping agreements Your Business Information Provide contact and customer service information for Google and for customers Data feeds Set up shipping and cancellation data feeds Code Add the Google Trusted Stores JavaScript code to your site Make sure when setting up the feeds that you specify same filenames and the way of getting these feeds to Google as you have set them up in your X Cart GTS module settings Next step is to let Google know that the Google Trusted Stores code is installed on your site and to check if it works properly Click on the Code tab and you should see a screen similar to this one There are 2 parts of the code that send information to Google first one is used to render the Google Trusted Stores badge see screenshot on the right You can click on the link there if you want to know more about what is required and how Google uses this information Order Confirmation Module Code The Order Confirmation module code This code allows customers to opt in to the program and also transmits the necessary transaction information to Google This code should be placed on your order confirmation page s View instructions for customizing the below values in red lt START Google Trusted Stores Order gt lt div id gts order style display none gt lt start or
4. process by website visitors Installing the GTS module nyc A goa 7 The installation process is described in a file called J install install txt which you can find inside the module J admin aie distribution package Just follow the installation modules i install txt instructions in this file Unzip the distribution package with your favorite zip program and use your FIP client program to upload new and modify existing files The database changes can be applied either from di CFL_Systems i Google_Trusted_Stores i skin di common_files the backend of your X Cart store go to patch upgrade di main page and load the file under SQL patch block or with gt modules phpMyAdmin from within your hosting cPanel account do CFL_Systems These changes are in the file called db patch sql J Google _Trusted_Stores located in the _install directory When applying the database patch and modifying existing files make sure to carefully follow the installation instructions Setting up the GTS module in your X Cart store backend In admin modules make sure the module CFL Systems Google Trusted Stores is active and click on the Configure link to set it up This module enables bestsellers list Note This module requires Advanced Statistics module to be enabled Bestsellers This module allows your customers to quick view main product s information on products list pages v CFL Systems Product Qui
5. Google Trusted Stores for X Cart Installation Guide Google Trusted Stores Your Business Information Provide contact and customer service information for Google and for customers Program Agreements v Digitally sign the program and shipping agreements Data feeds Set up shipping and cancellation data feeds Code Add the Google Trusted Stores JavaScript code to your site CEL Systems i EA KC C3 Google Trusted Stores Module Main Features V Approved by Google Trusted Stores team V Automatic connection to Google Products Search V Easy configuration right from within X Cart admin V Automatic code placement for Google Trusted Stores badge on every page as well as on order confirmation page as required by Google V 3 easy ways to generate and upload required Google Trusted Stores feeds vV Installs as X Cart module so you can easily turn it on off when required V Works with all X Cart versions What does Google say about the GTS module CFL Systems Inc Experience the difference Important notes Google QO Fisted store Based on transactions with The Google Trusted Store 1 Availability on time shipping of issues resolved in under 2 days days to ship average of customers asked for help 2 Encryption Purchase Protection Google s help resolving problems and up to 1 000 of protection for qualifying purchases Trusted 3 Is Google Trusted Stores image by Google Store program
6. cipate in the program and review your customer service The shipping and cancellation feeds your store generates and uploads will allow Google to determine how fast and reliable your shipping is as well as how often and why orders are being cancelled so it s important that you provide this information in a fast and accurate matter Thank you for choosing Google Trusted Stores module Good luck of becoming a Google Trusted Store CFL Systems Inc Experience the difference
7. ck View without having to go to product details page first This will open new page with all Google Trusted Stores options that you can set for this module Although they are pretty much self explanatory here is a brief description of each option and its possible values For most of them you can also find more detailed information on Google Trusted Stores website as well as on the Google Merchant Center website CFL Systems Google Trusted Stores Google Trusted Store ID Using Google Product Search check only if you are using Google Product Search If not checked below items are ignored Product ID from Product Search This value should match the product ID in the data feed you submit to Google Product Search Account ID from Product Search This value should match the account ID you use to submit your product data feed to Google Product Search If you have an MCA account use the subaccount ID associated with that product feed Account country from Product Search This value should match the account country you use to submit your product data feed to Google Product Search Account language from Product Search This value should match the account language you use to submit your product data feed to Google Product Search Order prefix Unit of currency associated with the order The value of the currency parameter must be a three letter ISO 4217 currency code Estimated number of days to ship an order If it s a range o
8. d for this order Run the following url in the browser remember to replace yourdomain with your domain name and XXX with the actual orderid if your cart is installed in a subdirectory add it to url as well https www yourdomain com cart php mode order_message amp orderids XxX You will see result page similar to the screenshot above pay attention to the Google reporting bar at the top it should read passed This page may pass with warnings about the Google Products Search codes missing you can ignore this warnings as they will not affect the code functionality Note that the url has to be a secure one i e starting with https or the test will fail Repeat same test for the rest of the browsers you will have to be logged in as the same customer in the other browsers so you can just copy paste the url from the test Final touches After having the above tests successfully completed on the main page on the Google Trusted Stores click on the button at the bottom of the page to complete the program enrollment The store and the Google Trusted Stores account are now setup to run and accept data for the program At this point forward is up to Google to decide when the store has met the program requirements and to show the Google Trusted Stores badge on the website You are now ready to start submitting data to Google and to upload the required feeds The final page in the Google Trusted Stores account will look sim
9. der and merchant information gt lt span id gts o id gt MERCHANT ORDER ID lt span gt lt span id gts o domain MERCHANT _ORDER_DOMAIN lt span gt lt span id gts o email gt CUSTOMER_EMAIL lt span gt lt span id gts o country gt CUSTOPER COUNTHY lt span gt lt span id gts o currency gt CURRENCYT lt span gt lt span id gts o total gt ORDER TOTAL lt span gt lt span id gts o discounts gt ORDER DISCOUNTS lt span gt lt span id gts o shipping total gt ORDER_SHIPPING lt span gt lt span id gts o tax total gt ORDER_TAX lt span gt lt span id gts o est ship date SORDER EST SHIP_DATE lt span gt lt span id gts o has preorder gt HAS BACKORDER PREORDER lt span gt lt span id gts o has digital gt HAS_DIGITAL_GOODS lt span gt lt end order and merchant information gt lt start repeated item specific information gt lt item example this area repeated for each item in the order gt lt span class gts item gt lt span class gts i name gt ITEM NAME lt span gt lt span class gts i price gt I TEM PRI CE lt span gt lt span class gts i quantity gt ITEM QUANTITY lt span gt lt span class gts i prodsearch id gt ITEM GOOGLE SHOPPING _ID lt span gt lt span class gts i prodsearch store id gt ITEM GOOGLE SHOPPING ACCOUNT _ID lt span gt lt span class gts i prodsearch country gt ITEM GOOGLE SHOPPING COUNTHY lt span gt lt span class
10. f days include the later end of the range 5 days if range is 3 5 days Google Trusted Store FTP username Google Trusted Store FTP password Google Trusted Store shipment feed filename Google Trusted Store cancellation feed filename Auto generate shipment and cancellation feeds every N day s Recommended period is 1 3 days Enter 0 to turn off this functionality Auto upload or have Google fetch the feeds this is active only if above setting is not 0 Recommended to be set to auto upload wi Product code SKU x United States en USD shipping txt cancellation txt Auto upload x REQUIRED You can find this at the top right corner inside your Google Trusted Stores account RECOMMENDED Check this only if you are submitting products feed to Google REQUIRED if GPS above is checked Possible values are Product ID or Product code SKU REQUIRED if GPS above is checked You can find this number next to the account name in your Google Merchant Center account REQUIRED if GPS above is checked Since GTS is currently available to USA only set this to United States REQUIRED if GPS above is checked Since GTS is currently available to USA only this value should be en for English OPTIONAL If you use any order prefix for example in your payment gateway setup in X Cart type it here REQUIRED Since GTS is currently available to USA only this value should be USD REQUIRED Depends o
11. gh your entire checkout process in order to fully test the order confirmation module code You need to test both the Google Trusted Stores badge and the order confirmation module of the domains listed below on the following browser versions e E any version above 8 e Firefox any version Chrome any version If you do not see a preview badge in the bottom right hand corner of the page or a yellow bar at the top of the page validating the JavaScript the code has not been implemented correctly Note Please complete the Businesss Information section before running the JS validator CFL Systems cflsystems com Or use this URL on other browsers https www googlecommerce convtrustedstores testdrive id 5 7483 amp sid 186801 amp tdt 379291 amp sig wuY NWnCwboU Back Now button or copy paste a link in your browser address bar It is easier to use the copy paste as in this case you don t have to open your Google Trusted Stores account in each browser to do the testing After running this test in a browser you will see an output similar to the following screenshot amp Google Trusted Stores Test Drive Passed All validation items have been passed ae e CFL Systems Inc Experience the difference CFL Systems Inc is a private company which specializes in Web Development eCommerce Solutions Web Design and Hosting CFL Systems is trustworthy and reliable and we stand behind our work 100 We treat al
12. ilar to the below screenshot Google Trusted Stores Setup Account No Congratulations You have now successfully applied to become a Google Trusted Store You will be notified when the Google Trusted Stores badge is ready to go live on your site Learn more Your Business Information Provide contact and customer service information for Google and for customers Program Agreements Digitally sign the program and shipping agreements Data feeds Set up shipping and cancellation data feeds Code Add the Google Trusted Stores JavaScript code to your site G EA O C3 Uploading required feeds to Google You are required to upload orders shipment and cancellation feeds to Google on a regular basis if you want to stay in the Google Trusted Stores program The GTS module allows you to do this in 3 ways manual automatic and Google fetch methods In any case you have to have the feeds setup in your Google Merchant Center account as well make sure the filenames as well as the upload method matches the GTS module settings in X Cart 1 Auto upload this is the default and prefer method If you have setup the GTS module to auto upload feeds you have nothing to worry the GTS module will export and upload the required feeds to Google at your specified days period Note you have to have Google FTP account and set it up in the GTS module settings in X Cart to be able to use the auto feeds upload 2 Manual upload If you want to manually gene
13. l our cllents with the respect and care they deserve Creu Googk HOME CATALOG TOOLS amp RESOURCES CUSTOMER eve s Trusted Store x f i ET Over 500 transactions as a Google Trusted Store Ci eee 2 ig a A Reliable Shipping Excellent Service E Sre emer tear a aah ma z 92 on time shipping gt a ara io oana erie iat 1 0 days to ship average awe ec om per variane meaz g mnameacuaers 0905 Purchase Protection L cicale Coupon per i eran ac tonev isd e Google s help f geW ing proBiems and up to 1 000 of protection for qualifying purchases Hs s See details Privacy Policy Verify About Google Trusted Stores Products Bulk Pricing for X Cart Auto populate featured products for X Cart Percent for Wholesale Prices for X Cart Store Locator for X cart Pay attention to the yellow bar at the top where Google will post a message if the test was successful or not Also at the lower right corner of the page Google will show an example of how the badge will look like when the program is activated for the site hover over the badge to see the info popup window Repeat same test for the rest of the browsers Keep these browser s windows open as you will need them to perform the second test order placement confirmation page In order to run the second test you need to be logged in to the site as a customer that has orders Navigate to that customer s account orders page and pick one order you need the orderi
14. n your shipping procedures Note that this is not estimated delivery days but days before you ship an order OPTIONAL Enter FTP account credentials if you want to use the auto upload feature or the manual upload from within admin under Import Export REQUIRED Both feed filenames should match the feed filenames set in your Google Merchant Center account RECOMMENDED Set these options to 1 or 2 days and Auto upload It is Google s preference that the feeds are auto uploaded on a regular basis If you want you can set the days to 0 in this case you have to remember to manually generate and upload the feeds as they are required The installation and setup of the Google Trusted Stores module in X Cart backend is now completed There is one more setup left to do in your Google Trusted Stores account Setting up your Google Trusted Stores account and preparing it to receive data Now when the GTS module is setup in your X Cart backend you have to let Google know about it Login to your Google Trusted Stores account and you should see a screen similar to the one on the right You should have already entered your business information and accepted the program agreement when you created the account Next step would be to setup the feeds and link your Google Trusted Stores account with your Google Merchant Center account Click on the Data feeds tab and follow the instructions there of how to link these 2 accounts and
15. ogram to Google after customer checks out There is nothing for you to do on this page as the GTS module takes care of all this information and includes it on all pages where needed What needs to be done on the Code tab is to test the store with the installed and running GTS module so Google can confirm the code has been installed and is working properly At the top of the page there are 2 links click on the second one called Test Code This will open another page to test the GTS code already placed on the site The site has to be tested using IE Firefox and Chrome browsers as described on that page This test consist of 2 parts first we will test the code for the Google Trusted Stores badge and then we will test the code for after an order is placed This has to be done for each browser separately Also pay attention on any warnings or notes on this page and make sure you have complied to them before running the tests Select the store from the dropdown and you should see a screen similar to the screenshot on the right AS you can see you can either click on Test Set Up Code B Test Code When you ve customized and placed both of the code snippets on your site you can test them to make sure everything is working Clicking Test Now will bring you to the main URL of your site in a testing environment where you can view the Google Trusted Stores badge and go through your checkout process Please proceed throu
16. ram You provide this of course after order has been shipped The GTS module looks for orders with this info and status of Completed when running the shipping feed export On cancelled orders you have to provide reason for cancellation shipping date and tracking number are not required and not taken into consideration The GTS module looks for cancelled orders with status of Declined Failed Cancelled If you have custom order statuses the module s config php file can be modified and adjusted to accept and work with these custom order statuses If you use 3rd party shipping modules you need to make sure they post back to your X Cart store tracking number as this is required by the Google Trusted Stores program After each export the GTS module marks exported orders so they are not re exported the next time the export happens This keeps the feeds from sending repeating information to Google This is it The GTS module and your Google Trusted Stores account are now setup Google will collect Main page Orders management Order 125319 details Order details This section allows you to view order details Status Cancelled e Payment gateway log Tracking number Google Trusted Stores Shipping date Reason if order is being cancelled Order Cancelled by Buyer m Google Trusted Stores information from the site and orders placed as well as allowing your customers to parti
17. rate and upload the required feeds first you need to set the days in GTS settings to 0 to enable this feature You will still need to have the Google FTP credentials in GTS module settings To manually generate and upload the feeds in the backend of the cart go to Import Export page and click on Google Trusted Stores export link The page should look similar to this screenshot page Google Trusted Stores export Google Trusted Stores export In this section See also Import data Generate feeds Download shipment feed Download cancellation feed Upload feeds Export data Froogle GoogleBase export Google Trusted Stores export From this page you can generate the feeds and upload them with a click of a button You can also download the feeds to your local system 3 Google fetch You can also setup Google to fetch the feeds from the directory they are being exported by setting up an url in your Google Merchant Center for the appropriate feeds Mark an order as being ready for Google Trusted Stores upload For each order you can and should set either shipping details or cancellation reason for the GTS module feeds to export correctly On the order details page in admin the GTS module has added a small detailed section where you can provide this information For each order that contains non downloadable products you have to provide tracking number and shipping date as they are required by the Google Trusted Stores prog
18. strictions by the program If at any point you need upload Google Trusted Stores feeds to Google assistance to install setup 6 If planning to use the auto upload functionality of the module you need to or further maintain the have FTP account with Google If you do not have one you can easily create it from within your Google Merchant Center account 7 The GTS module is partially encrypted with ionCube PHP Encoder and licensed to the domain you specify at time of purchase If you do not have concerns please do not ionCube Loader installed on your server or if you are not sure ask your host hesitate to contact us they should be able to help you with this GTS module or if you have any questions or Preparing for the installation The first thing to do before you begin with the installation of the GTS module is to create full backup of your store files and database in case anything goes wrong and you need to revert back changes made by the module s installation You can create files and database backup of your store from your hosting account cPanel If you are not familiar with the process or have doubts you can contact us and we can provide professional assistants You can also backup the database from within your store backend but this is not recommended as it will backup only X Cart stock tables and not any 3rd party tables It is also recommended to close the store while you are installing the module so there is no interruption of the
Download Pdf Manuals
Related Search