Difference between revisions of "X-Cart:FCommerce Go"

From X-Cart 4 Classic
Jump to: navigation, search
(Created page with '== Overview == With '''f-Commerce Go''', you can add your X-Cart based store to your Facebook page with just a few mouse clicks. Millions of users all over the world literally …')
 
 
(32 intermediate revisions by 6 users not shown)
Line 1: Line 1:
 
== Overview ==
 
== Overview ==
  
With '''f-Commerce Go''', you can add your X-Cart based store to your Facebook page with just a few mouse clicks.
+
With '''fCommerce Go''', you can add your X-Cart based store to your Facebook page with just a few mouse clicks.
  
 
Millions of users all over the world literally fell in love with Facebook; some have made Facebook their browser’s home page. For others it’s the only place online they would visit during an entire day. So, bringing your products to their target audience by simply adding a storefront to your Facebook page is a way to boost your sales effortlessly and cheap or totally free: just message your friends or buddies who have liked your FB page with the storefront tab. Finally, you can take advantage of Facebook Advertisement, which costs just a few cents.
 
Millions of users all over the world literally fell in love with Facebook; some have made Facebook their browser’s home page. For others it’s the only place online they would visit during an entire day. So, bringing your products to their target audience by simply adding a storefront to your Facebook page is a way to boost your sales effortlessly and cheap or totally free: just message your friends or buddies who have liked your FB page with the storefront tab. Finally, you can take advantage of Facebook Advertisement, which costs just a few cents.
Line 7: Line 7:
 
On top of that, a storefront on Facebook allows users to shop for their favorite products, share their thoughts and leave comments without leaving their favorite the Facebook website and thus build up a community of happy customers advocating your brand all over the Net.
 
On top of that, a storefront on Facebook allows users to shop for their favorite products, share their thoughts and leave comments without leaving their favorite the Facebook website and thus build up a community of happy customers advocating your brand all over the Net.
  
Summing it up, your key benefits with f-Commerce Go:
+
Summing it up, your key benefits with fCommerce Go:
  
 
* It boosts sales.
 
* It boosts sales.
Line 15: Line 15:
 
And here is what it looks like:
 
And here is what it looks like:
  
: [[Image:XC_FBtab-01.png]]
+
: [[Image:XC_FBshop-01.png]]
 +
 
 +
 
 +
<youtube>3UxCtypNy5Q</youtube>
 +
 
 +
Starting with X-Cart version 4.5.3, fCommerce Go is available as a built-in module in all X-Cart editions. It does not require installation and can be enabled in the <u>Modules</u> section of X-Cart Admin area.
 +
 
 +
For X-Cart versions 4.1.0-4.5.2, fCommerce Go is available as an add-on module which can be [http://www.x-cart.com/extensions/modules/fcommerce-go.html purchased] separately. The instructions below will guide you through the process of installing the fCommerce Go add-on module in your store.
  
 
== System requirements ==
 
== System requirements ==
  
To be able to successfully install and use the f-Commerce Go module, you must have a working copy of X-Cart version 4.1.0 through 4.4.x, Gold or Pro editions, already installed on your server.
+
To be able to successfully install and use the fCommerce Go module, you need a working copy of X-Cart GOLD or PRO v4.1.0-4.5.2 installed on your server.
  
{{Note1|Note: If you do not remember the version of your copy of X-Cart, you can find it in the <u>Summary/Environment info</u> section of the X-Cart Admin area (select <u>Administration</u> -> <u>Summary</u>) on the menu.}}
+
{{Note1|Note: If you do not remember the version of your copy of X-Cart, you can find it in the <u>Environment info</u> section of the [[X-Cart:Summary_Page |Summary]] page in X-Cart Admin area.}}
  
 
== Installing ==
 
== Installing ==
  
These instructions on both installing and removing the f-Commerce Go module are the same for both X-Cart Gold and X-Cart Pro.
+
=== Obtaining the latest version ===
 
 
=== Obtaining latest version ===
 
  
'''To obtain the latest version of f-Commerce Go:'''
+
'''To obtain the latest version of fCommerce Go:'''
  
1. Sign in to your [https://secure.qtmsoft.com/ Qualiteam Account].
+
1. Sign in to your [http://secure.x-cart.com/ Qualiteam Account].
  
2. In the File Area section, find the f-Commerce Go distribution package and download it to your computer.
+
2. In the File Area section, find the fCommerce Go distribution package and download it to your computer.
  
The distribution package is archived in the file fcomercego-x.y.z.tgz, where x, y and z indicate the version of the module. Make sure the version of the module matches the version of your copy of X-Cart.
+
The distribution package is archived in the file fcommerce-xcart-x.y.z.tgz, where x, y and z indicate the version of the module. Make sure the version of the module matches the version of your copy of X-Cart.
  
{{Note1|For instructions on '''''upgrading''''' to the latest version, please refer to [[X-Cart:Facebook_Tab_Upgrades|f-Commerce Go Upgrades]].}}
+
{{Note1|For instructions on '''''upgrading''''' to the latest version, please refer to [[X-Cart:FCommerce_Go_Upgrades|fCommerce Go Upgrades]].}}
  
 
=== Installation steps ===
 
=== Installation steps ===
  
{{Note1|For instructions on installing f-Commerce Go manually, please read [[X-Cart:Facebook_Tab_Manual_Installation|f-Commerce Go Manual Installation]].}}
+
{{Note1|For instructions on installing fCommerce Go manually, please read [[X-Cart:FCommerce_Go_Manual_Installation|fCommerce Go Manual Installation]].}}
  
'''To install the f-Commerce Go module:'''
+
'''To install the fCommerce Go module:'''
  
 
1. Copy the distribution package you have downloaded to the X-Cart root directory on your server or hosting account.
 
1. Copy the distribution package you have downloaded to the X-Cart root directory on your server or hosting account.
Line 49: Line 54:
 
* If you use a Windows-based server or a UNIX-based server without terminal access:
 
* If you use a Windows-based server or a UNIX-based server without terminal access:
  
: a) Extract the contents of the archive with the f-Commerce Go module files to a directory on your system using your favorite compression program (WinZIP or any other archiver that supports  TAR files).
+
: a) Extract the contents of the archive with the fCommerce Go module files to a directory on your system using your favorite compression program (WinZIP or any other archiver that supports  TAR files).
  
 
: b) Use an FTP client to upload all the files extracted from the archive (retaining the directory structure) to the X-Cart root directory on your server or hosting account.
 
: b) Use an FTP client to upload all the files extracted from the archive (retaining the directory structure) to the X-Cart root directory on your server or hosting account.
Line 55: Line 60:
 
* If you use a UNIX-based server with terminal access:
 
* If you use a UNIX-based server with terminal access:
  
: a) Use an FTP client to upload the archive with the f-Commerce Go module distribution package to the X-Cart root directory on your server or  hosting account.
+
: a) Use an FTP client to upload the archive with the fCommerce Go module distribution package to the X-Cart root directory on your server or  hosting account.
  
 
: b) Decompress the package by typing the following command:
 
: b) Decompress the package by typing the following command:
  
<pre>tar -xzvf fcomercego-x.y.z.tgz</pre>
+
<pre>tar -xzvf fcommerce-xcart-x.y.z.tgz</pre>
  
 
{{Note1|Important: Make sure to maintain the directory structure while unpacking and uploading the distribution package; otherwise, some critical files can be overwritten! }}
 
{{Note1|Important: Make sure to maintain the directory structure while unpacking and uploading the distribution package; otherwise, some critical files can be overwritten! }}
  
2. In a web browser, run the installation script at httр://www.example.com/install-fcomercego.php, replacing the variable www.example.com with the real domain name, where your X-Cart is installed.
+
2. In a web browser, run the installation script at httр://www.example.com/install-fcommerce.php, replacing the variable www.example.com with the real domain name, where your X-Cart is installed.
 
 
3. Enter the Auth code, accept the License Agreement and click the '''Next''' button.
 
  
{{Note|The Auth code is a random code that was generated after you installed your copy of X-Cart. If you do not remember the Auth code, find it in the Summary section of the X-Cart Admin area (select <u>Tools</u>-><u>Summary</u> on the administration menu), right over the License info subsection. Another way to find out the code is to retrieve the value of the $installation_auth_code variable from the file <u><xcart_dir>/config.php</u> .}}
+
3. Enter the [[X-Cart:FAQs#What_is_Auth_code_and_where_can_I_find_it.3F|Auth code]], accept the License Agreement and click the '''Next''' button.
  
 
4. The installation script copies the files and activates the module. Click the '''Next '''button to continue.
 
4. The installation script copies the files and activates the module. Click the '''Next '''button to continue.
Line 74: Line 77:
  
 
{{Note|In certain server environments, the module could fail to install properly due to incorrect initial permission settings.}}
 
{{Note|In certain server environments, the module could fail to install properly due to incorrect initial permission settings.}}
 
'''To make sure that your module is installed properly:'''
 
 
1. Log in to the X-Cart Admin area and make sure that f-Commerce Go module is enabled in the Modules section (select <u>Settings</u> -> <u>Modules</u> on the administration menu).
 
 
2. Open <u>httр://www.example.com/fb_tab/index.php</u>, replacing the variable www.example.com with the real domain name, where your X-Cart is installed.
 
 
If you can see the tab/products data from your store on your f-Commerce Go (like on the image below), that means that the installation is completed successfully:
 
 
: [[Image:XC_FBtab-success.png]]
 
 
If you get a blank page, try following this advice - [[X-Cart:Facebook_Tab_Frequently_Asked_Questions#I_have_installed_f-Commerce Go.2C_but_the_page_is_blank|I installed f-Commerce Go, but the page is blank]]. If you have any error on the page, contact our support team to investigate the issue.
 
  
 
=== Removal steps ===
 
=== Removal steps ===
  
{{Note1|Follow this instruction only if you would like to remove the f-Commerce Go module from your store.}}
+
{{Note1|Follow this instruction only if you would like to remove the fCommerce Go module from your store.}}
  
'''To uninstall the f-Commerce Go module:'''
+
'''To uninstall the fCommerce Go module:'''
  
1. In a web browser, run the installation script at http://www.example.com/install-fcomercego.php replacing the "www.example.com" with the real domain name, where your X-Cart is installed.
+
1. In a web browser, run the installation script at http://www.example.com/install-fcommerce.php replacing the "www.example.com" with the real domain name, where your X-Cart is installed.
  
2. Choose the <u>Uninstall the module</u> option, enter the Auth code, accept the License Agreement and click the '''Next''' button.
+
2. Choose the <u>Uninstall the module</u> option, enter the [[X-Cart:FAQs#What_is_Auth_code_and_where_can_I_find_it.3F|Auth code]], accept the License Agreement and click the '''Next''' button.
  
{{Note1|Note: The Auth code is a random code that was generated after you installed your copy of X-Cart. If you do not remember the Auth code, find it in the Summary section of the X-Cart Admin area (select <u>Tools</u>-><u>Summary</u> on the administration menu), right over the License info subsection. Another way to find out the code is to retrieve the value of the $installation_auth_code variable from the file <u><xcart_dir>include/install.php</u> .}}
+
3. Once the installation script has removed the fCommerce Go module files and deactivated the module, click the '''Next''' button to complete the uninstallation.
 
 
3. Once the installation script has removed the f-Commerce Go module files and deactivated the module, click the '''Next''' button to complete the uninstallation.
 
  
 
4. On the ''Uninstallation complete'' screen, click '''Next''' to leave the Wizard.
 
4. On the ''Uninstallation complete'' screen, click '''Next''' to leave the Wizard.
Line 107: Line 96:
 
== Configuring ==
 
== Configuring ==
  
To set up f-Commerce Go, enable and configure it in X-Cart and then add the tab to your Facebook page.
+
To set up fCommerce Go, enable and configure it in X-Cart and then add the tab to your Facebook page.
  
 
=== Enabling in X-Cart ===
 
=== Enabling in X-Cart ===
  
Once you have installed the f-Commerce Go module, enable it in the X-Cart Admin area.
+
Once you have installed the fCommerce Go module, enable it in the X-Cart Admin area.
  
'''To enable f-Commerce Go in X-Cart:'''
+
'''To enable fCommerce Go in X-Cart:'''
  
 
1. Log in to the X-Cart Admin area and go to the <u>Modules</u> section (select <u>Settings</u> -> <u>Modules</u> on the administration menu).
 
1. Log in to the X-Cart Admin area and go to the <u>Modules</u> section (select <u>Settings</u> -> <u>Modules</u> on the administration menu).
  
2. On the list of modules, find the "f-Commerce Go" item and select the check box by the item's name.
+
2. On the list of modules, find the "fCommerce Go" item and select the check box by the item's name.
  
 
3. Scroll down to the bottom of the page and click the '''Apply changes''' button to apply the changes.
 
3. Scroll down to the bottom of the page and click the '''Apply changes''' button to apply the changes.
  
:[[Image:XC_FBtab-02.png]]
+
:[[Image:XC_FBshop-02.png]]
  
 
=== Configuring settings ===
 
=== Configuring settings ===
  
'''To configure f-Commerce Go settings:'''
+
'''To configure fCommerce Go settings:'''
  
 
1. Log in to the Admin area and open the Modules page by selecting <u>Settings</u> -> <u>Modules</u> on the menu.
 
1. Log in to the Admin area and open the Modules page by selecting <u>Settings</u> -> <u>Modules</u> on the menu.
  
2. Scroll down until you see the f-Commerce Go item and then click on the <u>Configure</u> link by the item.
+
2. Scroll down until you see the fCommerce Go item and then click on the <u>Configure</u> link by the item.
  
This opens a page with options and settings for the f-Commerce Go module.
+
This opens a page with options and settings for the fCommerce Go module.
  
:[[Image:XC_FBtab-03.png]]
+
:[[Image:XC_FBshop-03.png]]
  
4. Enter your Facebook user profile ID, then select the products to be displayed on your f-Commerce Go and then click the '''Apply changes''' button.
+
4. Select the categories to be shown on Facebook.
  
{{Note|To obtain your Facebook user profile ID, open the [http://apps.facebook.com/xcart_shop/index.php f-Commerce Go application] page and then click on the Get my Profile ID link at the bottom of the page. You must be signed in to Facebook to be able to get your profile ID.}}
+
5. Adjust the settings in the Advanced settings section as necessary.
 +
:[[Image:XC_FBshop-031.png]]
  
=== Advanced options ===
+
'''Configure home page'''
  
; Facebook user profile ID : Entering your Facebook user ID adds the Like button to each product displayed on your page. The ID links the Like button's clicks statistics with a specific user.
+
* <u>Show bestsellers on home page</u> - toggles the bestsellers module on the home page.
  
; Bestsellers tabs settings : Bestseller appearance settings:
+
* <u>Show Featured products on home page</u> - toggles the Featured products module on the home page.
  
: '''''Show the store bestsellers in a separate tab''''' - enables the Bestsellers tab on the page.
+
* <u>Show category thumbnails</u> - toggles category thumbnails on the home page.
  
: '''''Bestsellers tab name in Facebook''''' - bestsellers tab caption. Name it any way you like: Featured, Deals, Most Popular, etc.
+
'''Welcome text on home page tab'''
  
: '''''Number of products in bestsellers list''''' - maximum number of products to be shown on the bestsellers list.
+
* For general visitors - customize your welcome message to new visitors.
  
{{Note|Entering a number of products greater than 15 with a non-empty Facebook user profile ID may cause difficulties with showing the page on Facebook, as retrieving data for a great number of products from Facebook servers may cause a delay that exceeds the server's response or page load timeout. With the Like buttons disabled, still avoid entering values greater than 50 to ensure good performance.
+
* For people who liked your page - customize welcome message for your fans (optional).
}}
 
  
: '''''Bestsellers products list type''''' - select the layout for your product list: Simple matrix or Detailed list. The Simple matrix format shows the product image and the price; the Detailed list shows all that plus the detailed description of the product options.
+
'''Images options'''
 +
{{Note|Leave these settings as default unless you know for sure how you are going to change them.}}
  
{{Note|The same settings apply to the Featured Products tab.}}
+
* Adjust image options. Image dimensions are set in pixels.
  
; Categories tabs settings : Category appearance settings; similar to the Bestsellers and Featured tab settings. The categories display all the products belonging to the categories and their subcategories. f-Commerce Go ignores the categories' enabled/disabled status; instead, the categories can be turned on/off with the check box by the category name on the module configuration page.
+
:[[Image:XC_FBshop-032.png]]
 +
 
 +
6. Click the '''Apply changes''' button to save changes.
  
 
=== Adding to Facebook ===
 
=== Adding to Facebook ===
  
'''To add f-Commerce Go to your page on Facebook:'''
+
'''To add fCommerce Go to your page on Facebook:'''
  
1. Make sure that you use Facebook as ''personal profile'' by turning off the "Facebook as Page" feature when associating pages with f-Commerce Go.
+
1. Make sure that you use Facebook as ''personal profile'' by turning off the "Facebook as Page" feature when associating pages with fCommerce Go.
  
2. On the [http://apps.facebook.com/xcart_shop/index.php f-Commerce Go application] page, enter the full URL of your X-Cart store and then click the '''Apply'''button.
+
2. On the [https://apps.facebook.com/f-commerce-go/ fCommerce Go application] page, click the '''Connect your store''' button.
 +
:[[Image:XC_FBshop-04.png]]
  
3. If the URL is marked valid (green indicator), click the '''Select pages''' button and select the page to add the X-Cart store to.
+
3. On the application authorization page that appears, allow fCommerce Go to publish its data on Facebook.
  
4. On the next page that appears, click the '''Add X-Cart Shop''' button to add your store to your page on Facebook.
+
:[[Image:XC_FBshop-05.png]]
  
:[[Image:XC_FBtab-04.png]]
+
4. On the permissions page that appears, authorize the application to use your Facebook pages by clicking the '''Allow''' button.
  
5. Once pages are matched with f-Commerce Go, you can switch back to the "Facebook as Page" mode.
+
:[[Image:XC_FBshop-06.png]]
  
== FAQ ==
+
5. On the fCommerce Go setup page, enter your web store URL and then click the '''Apply''' button.
 +
{{Note|Make sure that the '''fCommerce Go''' module is already installed in your web store.}}
  
===How can I stay up to date with news and updates on the f-Commerce Go application?===
+
6. Select the pages on Facebook where the catalog is to be added.
  
We post all the news about the f-Commerce Go module on the [http://www.facebook.com/apps/application.php?id=136267806421194 application profile page] on Facebook.
+
:[[Image:XC_FBshop-07.png]]
  
If you want to get e-mail notifications of all the posts published on that page's wall, just click the "Like" button on that app-profile page or on the[https://apps.facebook.com/xcart_shop/ canvas page of the application].
+
7. Once the pages are set, you can view the page with the catalog by clicking the '''View page''' button.
  
===How can I track sales or any stats from f-Commerce Go?===
+
== FAQ ==
 
 
You can track your stats if you integrate X-Cart with Google Analytics. You'll be able to see visitors coming from Facebook and track their sales using the "E-Commerce" section in your Google Analytics account.
 
 
 
===How can I add the tab to my profile page?===
 
  
Facebook does not allow adding application tabs to profile pages. You can add the tab only to community/business Facebook pages.
+
===How can I stay up to date with news and updates on the fCommerce Go application?===
  
However, you can convert your personal profile to a business page; see http://www.facebook.com/help/?page=18918. Keep in mind that once you have converted your profile to a Page, you can't revert this change.
+
We post all the news about the fCommerce Go module on the [http://www.facebook.com/apps/application.php?id=136267806421194 application profile page] on Facebook.
  
===I cannot use FB-app due to a permanent redirect===
+
If you want to get e-mail notifications of all the posts published on that page's wall, just click the "Like" button on that app-profile page or on the [https://apps.facebook.com/xcart_shop/ canvas page of the application].
 
 
Probably you are surfing with the "Facebook as a page" feature enabled. Switch back you your personal profile and then add the tab to the required pages. When you are done, you can switch back to using the "Facebook as a page" feature.
 
  
 
===The tab doesn't appear on my pages. Why?===
 
===The tab doesn't appear on my pages. Why?===
Line 205: Line 193:
  
 
In this popup, you can also rename your tab.
 
In this popup, you can also rename your tab.
 
===Can not add  f-Commerce Go to my page on Facebook. How do I solve the problem?===
 
 
<u>Problem:</u> I am following the steps to [[X-Cart:Facebook_Tab#Adding_to_Facebook | add f-Commerce Go to my  page on Facebook]], specifically trying to set URL and click "Apply", but it goes to https page with no response.
 
 
<u>Solution:</u> There are some problems with HTTPS surfing on Facebook. So, we recommend you the following ways to sort this issue out:
 
 
1. Turn on Secure Browsing - https://www.facebook.com/help/?faq=215897678434749
 
 
Since FB-app uses the HTTPS protocol, we recommend enabling this feature for your profile.
 
 
2. Ask any other person to add f-Commerce Go to your page:
 
* Ask him to ''Like'' your page.
 
* Make him an admin of the page using his profile email (he should give it to you beforehand).
 
* Ask him to add f-Commerce Go via our application.
 
  
 
===How can I rename the tab?===
 
===How can I rename the tab?===
Line 225: Line 198:
 
Click on the "Edit info" link on your community page and then select the "Apps" link on the menu at the left. Find the "X-Cart Shop" application in the central area and then click on the "Edit settings" link. In the popup box that appears, enter the desired name and then click the "Save" button.
 
Click on the "Edit info" link on your community page and then select the "Apps" link on the menu at the left. Find the "X-Cart Shop" application in the central area and then click on the "Edit settings" link. In the popup box that appears, enter the desired name and then click the "Save" button.
  
===I have installed f-Commerce Go, but the page is blank===
+
=== How can I track orders placed from Facebook? ===
 
 
Your http://www.example.com/fb_tab/index.php page is blank?
 
 
 
Probably, the reason is in the incorrect permissions set for the templates on your server. Please make sure that the templates are copied properly:
 
 
 
* for X-Cart 4.1.x-4.3.x - the "<x-cart>/skin1/modules/Facebook_Tab" directory exists and is not empty
 
 
 
* for X-Cart 4.4.x - the "<x-cart>/skin/common_files/modules/Facebook_Tab" directory exists and is not empty
 
  
If the directory is empty, copy the respective files from the "<x-cart>/fb_tab/templates/modules/" directory to the directories that are empty.
+
You can track the sales using X-Cart's standard "Orders search" feature.
  
In these examples, <tt><x-cart></tt> stands for the directory, where your  X-Cart is installed.
+
1. Open the Orders page at <u>http://your_store/admin/orders.php</u>
  
===How to show hidden products on f-Commerce Go?===
+
2. Click the "<u>More search options</u>" link.
  
A disabled product appears neither in the web store nor on FB-Tab. However, a category does.
+
3. Select the "'''Orders with products added in Facebook'''" item on the "Order features" list.
  
So, create a new category, then add a few active products to it, then disable this category for the web store, but enable it for the Tab on the module configuration page in the admin area.
+
4. Configure other search options as necessary.
  
===How to make the products tab default for all users?===
+
5. Click the "'''Search'''" button.
  
Facebook doesn't allow to set a certain page tab as landing page for visitors who already "like" that page (or for page owners). Instead, those visitors see the first page tab on the list (usually the "Wall" tab).
+
Moreover, even if orders are searched without that option selected, all the found records that contain products added on FB will be marked with a blue "F" label.
But new visitors and people who do not yet "like" the page see the tab set as "Default Landing Tab" by the page admin. For more information, please refer to these pages:
 
* https://www.facebook.com/help/?faq=14899
 
* https://www.facebook.com/help/?faq=18299
 
  
Following Facebook's logic, it is supposed that people who already "like" your page are familiar with that page and can easily find necessary information on it.
+
=== How do I change the tab name and the picture? ===
  
By the way, you can move the "Online Shop" link up in the left navigation pane.
+
1. Open your FB-page settings (<u>Admin panel</u> -> <u>Manage</u> -> <u>Edit Page</u>).
  
===How to make Special Offer only for products shown on f-Commerce Go?===
+
2. Select the "'''Apps'''" item on the menu to the left.
  
Here is the workaround:
+
3. Find the "'''fCommerce Go'''" record on the "Added apps" list.
  
1. Create a category, then disable it for the customer-side (on the category settings page), but enable it for Facebook (on the f-Commerce Go module's admin page).
+
4. Click the "<u>Edit Settings</u>" link under that record. The settings include: <u>Tab (remove)</u>, <u>Custom Tab Image</u>, and <u>Custom Tab Name</u>. Feel free to change them as necessary. Just a quick recommendation on tab image: prepare a suitable image with the 111x74 px size prior to performing the replacement.
2. Add products to this category on the edit products page.
 
3. Create a special offer for this category.
 
  
To show the note about the offer on f-Commerce Go, you can edit the 'skin1/modules/Facebook_Tab/customer/home.tpl' or 'skin1/modules/Facebook_Tab/customer/products.tpl'.
+
=== How do I make a third party addon working with fCommerceGo? ===
  
=== What kinds of products can I show and advertise via the f-Commerce Go module? ===
+
1. Edit the "'''modules/fCommerce_Go/third_parties.php'''" script.
  
Here is the [https://www.facebook.com/help/?page=122121444536221 Content Guidelines] for Facebook pages. Make sure that your page complies with these requirements.
+
2. Add your third-party addon's include part code there, e.g.:
 +
<pre>
 +
// Begin Module_ID //
 +
/*
 +
if ($active_modules['Module_ID'])
 +
require $xcart_dir . "/modules/Module_ID/required_file.php";
 +
*/
 +
// End Module_ID //
 +
</pre>
  
[https://www.facebook.com/help/?faq=150193685051184 Here] you can learn more about adding an age-based restriction to your content.
+
3. In the added code, change "'''Module_ID'''" and "'''required_file.php'''" to actual name and uncomment the code, e.g.:
 +
<pre>
 +
// Begin alteredCart_On_Sale //
 +
if ($active_modules['alteredCart_On_Sale'])
 +
require $xcart_dir . "/modules/alteredCart_On_Sale/onsale_sessions.php";
 +
// End alteredCart_On_Sale //
 +
</pre>
  
== Getting help ==
+
=== How do I test connection between my X-Cart store and fCommerceGo? ===
  
For more information and further assistance, please refer to:
+
Use this URL: http://www.example.com/xcart/fcommerce.php?fb_debug=1&is_installed=1
  
* [http://www.qtmsoft.com/support.html Qualiteam support service]
+
where http://www.example.com/xcart/ should be replaced with your actual X-Cart's URL.
  
* [http://www.x-cart.com/fwd.html?url=https://secure.qtmsoft.com Support helpdesk]
+
==Related pages==
 +
* [[X-Cart:FCommerce_Go_Manual_Installation|FCommerce Go Manual Installation]]
 +
* [[X-Cart:FCommerce_Go_Upgrades|FCommerce Go Upgrades]]
  
* [http://www.x-cart.com/fwd.html?url=http://forum.x-cart.com Community forums]
+
==See also==
 +
* [[X-Cart:How to Add Facebook Pixel Code to X-Cart Pages | How to Add Facebook Pixel Code to X-Cart Pages]]
  
* [http://help.qtmsoft.com/ Knowledge base]
+
[[Category:X-Cart user manual]]
 +
[[Category:X-Cart modules]]
 +
[[Category:X-Cart video tutorials]]

Latest revision as of 13:34, 27 February 2019

Overview

With fCommerce Go, you can add your X-Cart based store to your Facebook page with just a few mouse clicks.

Millions of users all over the world literally fell in love with Facebook; some have made Facebook their browser’s home page. For others it’s the only place online they would visit during an entire day. So, bringing your products to their target audience by simply adding a storefront to your Facebook page is a way to boost your sales effortlessly and cheap or totally free: just message your friends or buddies who have liked your FB page with the storefront tab. Finally, you can take advantage of Facebook Advertisement, which costs just a few cents.

On top of that, a storefront on Facebook allows users to shop for their favorite products, share their thoughts and leave comments without leaving their favorite the Facebook website and thus build up a community of happy customers advocating your brand all over the Net.

Summing it up, your key benefits with fCommerce Go:

  • It boosts sales.
  • It builds community around your brand.
  • It saves promotion and marketing money.

And here is what it looks like:

XC FBshop-01.png


Starting with X-Cart version 4.5.3, fCommerce Go is available as a built-in module in all X-Cart editions. It does not require installation and can be enabled in the Modules section of X-Cart Admin area.

For X-Cart versions 4.1.0-4.5.2, fCommerce Go is available as an add-on module which can be purchased separately. The instructions below will guide you through the process of installing the fCommerce Go add-on module in your store.

System requirements

To be able to successfully install and use the fCommerce Go module, you need a working copy of X-Cart GOLD or PRO v4.1.0-4.5.2 installed on your server.

Note: If you do not remember the version of your copy of X-Cart, you can find it in the Environment info section of the Summary page in X-Cart Admin area.

Installing

Obtaining the latest version

To obtain the latest version of fCommerce Go:

1. Sign in to your Qualiteam Account.

2. In the File Area section, find the fCommerce Go distribution package and download it to your computer.

The distribution package is archived in the file fcommerce-xcart-x.y.z.tgz, where x, y and z indicate the version of the module. Make sure the version of the module matches the version of your copy of X-Cart.

For instructions on upgrading to the latest version, please refer to fCommerce Go Upgrades.

Installation steps

For instructions on installing fCommerce Go manually, please read fCommerce Go Manual Installation.

To install the fCommerce Go module:

1. Copy the distribution package you have downloaded to the X-Cart root directory on your server or hosting account.

  • If you use a Windows-based server or a UNIX-based server without terminal access:
a) Extract the contents of the archive with the fCommerce Go module files to a directory on your system using your favorite compression program (WinZIP or any other archiver that supports TAR files).
b) Use an FTP client to upload all the files extracted from the archive (retaining the directory structure) to the X-Cart root directory on your server or hosting account.
  • If you use a UNIX-based server with terminal access:
a) Use an FTP client to upload the archive with the fCommerce Go module distribution package to the X-Cart root directory on your server or hosting account.
b) Decompress the package by typing the following command:
tar -xzvf fcommerce-xcart-x.y.z.tgz
Important: Make sure to maintain the directory structure while unpacking and uploading the distribution package; otherwise, some critical files can be overwritten!

2. In a web browser, run the installation script at httр://www.example.com/install-fcommerce.php, replacing the variable www.example.com with the real domain name, where your X-Cart is installed.

3. Enter the Auth code, accept the License Agreement and click the Next button.

4. The installation script copies the files and activates the module. Click the Next button to continue.

5. The installation script generates a new system fingerprint. Click the Next button to complete the installation.

Note: In certain server environments, the module could fail to install properly due to incorrect initial permission settings.

Removal steps

Follow this instruction only if you would like to remove the fCommerce Go module from your store.

To uninstall the fCommerce Go module:

1. In a web browser, run the installation script at http://www.example.com/install-fcommerce.php replacing the "www.example.com" with the real domain name, where your X-Cart is installed.

2. Choose the Uninstall the module option, enter the Auth code, accept the License Agreement and click the Next button.

3. Once the installation script has removed the fCommerce Go module files and deactivated the module, click the Next button to complete the uninstallation.

4. On the Uninstallation complete screen, click Next to leave the Wizard.

Important: After you have uninstalled the module, make sure to remove the module's distribution package from your web directory as well.

Configuring

To set up fCommerce Go, enable and configure it in X-Cart and then add the tab to your Facebook page.

Enabling in X-Cart

Once you have installed the fCommerce Go module, enable it in the X-Cart Admin area.

To enable fCommerce Go in X-Cart:

1. Log in to the X-Cart Admin area and go to the Modules section (select Settings -> Modules on the administration menu).

2. On the list of modules, find the "fCommerce Go" item and select the check box by the item's name.

3. Scroll down to the bottom of the page and click the Apply changes button to apply the changes.

XC FBshop-02.png

Configuring settings

To configure fCommerce Go settings:

1. Log in to the Admin area and open the Modules page by selecting Settings -> Modules on the menu.

2. Scroll down until you see the fCommerce Go item and then click on the Configure link by the item.

This opens a page with options and settings for the fCommerce Go module.

XC FBshop-03.png

4. Select the categories to be shown on Facebook.

5. Adjust the settings in the Advanced settings section as necessary.

XC FBshop-031.png

Configure home page

  • Show bestsellers on home page - toggles the bestsellers module on the home page.
  • Show Featured products on home page - toggles the Featured products module on the home page.
  • Show category thumbnails - toggles category thumbnails on the home page.

Welcome text on home page tab

  • For general visitors - customize your welcome message to new visitors.
  • For people who liked your page - customize welcome message for your fans (optional).

Images options

Note: Leave these settings as default unless you know for sure how you are going to change them.
  • Adjust image options. Image dimensions are set in pixels.
XC FBshop-032.png

6. Click the Apply changes button to save changes.

Adding to Facebook

To add fCommerce Go to your page on Facebook:

1. Make sure that you use Facebook as personal profile by turning off the "Facebook as Page" feature when associating pages with fCommerce Go.

2. On the fCommerce Go application page, click the Connect your store button.

XC FBshop-04.png

3. On the application authorization page that appears, allow fCommerce Go to publish its data on Facebook.

XC FBshop-05.png

4. On the permissions page that appears, authorize the application to use your Facebook pages by clicking the Allow button.

XC FBshop-06.png

5. On the fCommerce Go setup page, enter your web store URL and then click the Apply button.

Note: Make sure that the fCommerce Go module is already installed in your web store.

6. Select the pages on Facebook where the catalog is to be added.

XC FBshop-07.png

7. Once the pages are set, you can view the page with the catalog by clicking the View page button.

FAQ

How can I stay up to date with news and updates on the fCommerce Go application?

We post all the news about the fCommerce Go module on the application profile page on Facebook.

If you want to get e-mail notifications of all the posts published on that page's wall, just click the "Like" button on that app-profile page or on the canvas page of the application.

The tab doesn't appear on my pages. Why?

Make sure that you are adding the products tab to community or business pages, and your pages are listed in "The pages where X-Cart products tab is already added:" section of the FB-application. If the list is empty, it means that the tab isn't added to any of your pages.

However, if the list is not empty, and the tab still fails to appear, click on the "Edit page apps" link of the required page. Then find the "X-Cart Shop" application in the central area and then click on the "Edit settings" link. Now, add the tab in the popup box that appears.

In this popup, you can also rename your tab.

How can I rename the tab?

Click on the "Edit info" link on your community page and then select the "Apps" link on the menu at the left. Find the "X-Cart Shop" application in the central area and then click on the "Edit settings" link. In the popup box that appears, enter the desired name and then click the "Save" button.

How can I track orders placed from Facebook?

You can track the sales using X-Cart's standard "Orders search" feature.

1. Open the Orders page at http://your_store/admin/orders.php

2. Click the "More search options" link.

3. Select the "Orders with products added in Facebook" item on the "Order features" list.

4. Configure other search options as necessary.

5. Click the "Search" button.

Moreover, even if orders are searched without that option selected, all the found records that contain products added on FB will be marked with a blue "F" label.

How do I change the tab name and the picture?

1. Open your FB-page settings (Admin panel -> Manage -> Edit Page).

2. Select the "Apps" item on the menu to the left.

3. Find the "fCommerce Go" record on the "Added apps" list.

4. Click the "Edit Settings" link under that record. The settings include: Tab (remove), Custom Tab Image, and Custom Tab Name. Feel free to change them as necessary. Just a quick recommendation on tab image: prepare a suitable image with the 111x74 px size prior to performing the replacement.

How do I make a third party addon working with fCommerceGo?

1. Edit the "modules/fCommerce_Go/third_parties.php" script.

2. Add your third-party addon's include part code there, e.g.:

// Begin Module_ID //
/*
if ($active_modules['Module_ID'])
require $xcart_dir . "/modules/Module_ID/required_file.php";
*/
// End Module_ID //

3. In the added code, change "Module_ID" and "required_file.php" to actual name and uncomment the code, e.g.:

// Begin alteredCart_On_Sale //
if ($active_modules['alteredCart_On_Sale'])
require $xcart_dir . "/modules/alteredCart_On_Sale/onsale_sessions.php";
// End alteredCart_On_Sale //

How do I test connection between my X-Cart store and fCommerceGo?

Use this URL: http://www.example.com/xcart/fcommerce.php?fb_debug=1&is_installed=1

where http://www.example.com/xcart/ should be replaced with your actual X-Cart's URL.

Related pages

See also