X-Cart:Rich Google Search Results - Revision history

Mouse at 13:52, 22 July 2020

2020-07-22T13:52:19Z

Rocky at 11:10, 26 October 2012

2012-10-26T11:10:54Z

Rocky at 11:10, 26 October 2012

2012-10-26T11:10:22Z

Rocky at 11:07, 26 October 2012

2012-10-26T11:07:02Z

Dohtur at 09:03, 26 October 2012

2012-10-26T09:03:18Z

Dohtur at 08:52, 26 October 2012

2012-10-26T08:52:47Z

Dohtur: /* Structure of a sample web page */

2012-10-26T08:10:22Z

‎Structure of a sample web page

Dohtur: /* Configuring the Rich Google Search Results add-on module */

2012-10-26T08:03:28Z

‎Configuring the Rich Google Search Results add-on module

Dohtur at 08:02, 26 October 2012

2012-10-26T08:02:13Z

Show changes

Dohtur: /* Installation for X-Cart 4.4.x - 4.5.x */

2012-10-25T14:23:51Z

‎Installation for X-Cart 4.4.x - 4.5.x

@@ Line 3: / Line 3: @@
 ==Overview==
 ====What X-Cart's Rich Google Search Results add-on module does====
-<u>Rich Google Search Results</u> is an add-on module for X-Cart that enables products to be displayed on a web search results page in an [http://support.google.com/webmasters/bin/answer.py?hl=en&answer=146750 enhanced format] that is more convenient and intuitive for potential buyers. After you install and configure the add-on module, information about the products sold at your store will be included into web search results in the "rich" format as soon as the respective product pages are indexed by the web search engine.
+<u>Rich Google Search Results</u> is an add-on module for X-Cart that enables products to be displayed on a web search results page in an [https://support.google.com/webmasters/bin/answer.py?hl=en&answer=146750 enhanced format] that is more convenient and intuitive for potential buyers. After you install and configure the add-on module, information about the products sold at your store will be included into web search results in the "rich" format as soon as the respective product pages are indexed by the web search engine.
 ====Why use Rich Google Search Results?====
@@ Line 21: / Line 21: @@
 * Prospective customers can see whether reviews are available for the product.
-Although this add-on module is focused in the first place on meeting the [http://support.google.com/webmasters/bin/answer.py?hl=en&answer=99170 Google requirements], it uses the [http://schema.org/ schema.org] format for data, which is recognized by [http://googlewebmastercentral.blogspot.com/2011/06/introducing-schemaorg-search-engines.html other search engines] as well.
+Although this add-on module is focused in the first place on meeting the [https://support.google.com/webmasters/bin/answer.py?hl=en&answer=99170 Google requirements], it uses the [http://schema.org/ schema.org] format for data, which is recognized by [https://googlewebmastercentral.blogspot.com/2011/06/introducing-schemaorg-search-engines.html other search engines] as well.
-The <u>Rich Google Search Results</u> module can be [http://www.x-cart.com/extensions/modules/rich-google-search-results.html purchased] and installed on all X-Cart editions.
+The <u>Rich Google Search Results</u> module can be [https://www.x-cart.com/extensions/modules/rich-google-search-results.html purchased] and installed on all X-Cart editions.
 ==System requirements==
@@ Line 30: / Line 30: @@
 {{Note1|Note: If you do not remember the version of X-Cart on which your store is based, you can look it up in the <u>Environment info</u> section of the [[X-Cart:Summary_Page |Summary]] page in X-Cart Admin area.}}
-Please note that X-Cart versions 4.2.3 and earlier do not support the star ratings feature out of the box (This feature is enabled by X-Cart's built-in module [[X-Cart:Customer Reviews|Customer Reviews]] starting with version 4.3.0; before version 4.3.0, the <u>Customer Reviews</u> module did not support the star ratings feature, but operated with ratings like "excellent", "very good", "good", etc). Accordingly, if you use the <u>Rich Google Search Results</u> add-on module in a store based on X-Cart 4.1.12 or 4.2.3, star ratings will not be included in the 'rich' format search results. However, the star ratings feature can be implemented in X-Cart versions 4.2.3 and earlier by installing the add-on module [http://www.x-cart.com/extensions/modules/advanced-customer-reviews.html Advanced Customer Reviews]. With the star ratings feature enabled by <u>Advanced Customer Reviews</u>, the 'rich' format search results will include star ratings even on versions 4.1.12 and 4.2.3.
+Please note that X-Cart versions 4.2.3 and earlier do not support the star ratings feature out of the box (This feature is enabled by X-Cart's built-in module [[X-Cart:Customer Reviews|Customer Reviews]] starting with version 4.3.0; before version 4.3.0, the <u>Customer Reviews</u> module did not support the star ratings feature, but operated with ratings like "excellent", "very good", "good", etc). Accordingly, if you use the <u>Rich Google Search Results</u> add-on module in a store based on X-Cart 4.1.12 or 4.2.3, star ratings will not be included in the 'rich' format search results. However, the star ratings feature can be implemented in X-Cart versions 4.2.3 and earlier by installing the add-on module [https://www.x-cart.com/extensions/modules/advanced-customer-reviews.html Advanced Customer Reviews]. With the star ratings feature enabled by <u>Advanced Customer Reviews</u>, the 'rich' format search results will include star ratings even on versions 4.1.12 and 4.2.3.
 ==Installing the Rich Google Search Results add-on module==
@@ Line 84: / Line 84: @@
 #: [[Image:Rgsr_settings.png |border]]
 # Adjust the settings on the module configuration page:
-#* '''Code of your primary currency''': 3-letter currency code according to [http://en.wikipedia.org/wiki/ISO_4217 ISO 4217].
+#* '''Code of your primary currency''': 3-letter currency code according to [https://en.wikipedia.org/wiki/ISO_4217 ISO 4217].
 #* '''Use Star rating instead of Socialize Like button''': This setting is available in the Rich Google Search Results add-on module versions 4.4.4 and later. It is intended for merchants who use X-Cart's Socialize module along with X-Cart's Customer Reviews module and Rich Google Search Results add-on. The problem that this setting is intended to solve is that using the Socialize module along with the module Customer Reviews may have some unwanted effects on the display of 'rich' web search results. Specifically, this is related to the Socialize module configuration option ''Use the "Facebook comments" block instead of default X-Cart "Customer Reviews" functionality''. When this option is enabled in the Socialize module configuration settings, the default X-Cart's customer reviews on your store's product details pages (powered by Customer Reviews) are replaced with Facebook comments (powered by Socialize); in addition to that, the default X-Cart's star ratings (powered by Customer Reviews) are also replaced with Facebook Like ratings (powered by Socialize). As a result, Customer Reviews star ratings are not aggregated and, accordingly, cannot be displayed in the 'rich' web search results. Display of Facebook Like ratings is currently not supported by search providers like Google, so merchants using Facebook Like ratings powered by Socialize instead of star ratings powered by Customer Reviews just end up without any ratings displayed in their 'rich' web search results, which is not good - considering how valuable product rating information may be for a potential buyer. The setting ''Use Star rating instead of Socialize Like button'' gives you more control over this situation: enabling this option allows you to keep using the default Customer Reviews star ratings functionality along with the Socialize module’s Facebook comments; this way you will have the default Customer Reviews star ratings included in 'rich' web search results even with the working Socialize module.
 # Click the '''Apply changes''' button to save the changes.

@@ Line 282: / Line 282: @@
 This tag can be added simply by adding the hunk from the patch right after the first div in this template.
-=====./modules/Customer_Reviews/vote_reviews.tpl.patch (for versions 4.4.3 and above)=====
+<b>./modules/Customer_Reviews/vote_reviews.tpl.patch (for versions 4.4.3 and above)</b>
 ''This file contains a patch for compatibility with X-Cart's Socialize module.''

@@ Line 201: / Line 201: @@
 Breadcrumbs are usually displayed in a loop that goes through all the nested categories of a product, so you will need to add this code to the right place of the iteration.
-=====./customer/home.tpl.patch=====
+<b>./customer/home.tpl.patch</b>
 ''This file contains patches for adding the [[File:Itemscope_itemtype_product.png||<itemscope itemtype=”Product”>]] tag.''
@@ Line 219: / Line 219: @@
 </pre>
-=====./customer/main/product.tpl.patch=====
+<b>./customer/main/product.tpl.patch</b>
 ''This file contains patches for the [[File:Itemprop_name.png||<itemprop=”name”>]] and [[File:Itemprop_image.png||<itemprop=”image”>]] tags.''
@@ Line 233: / Line 233: @@
 <div class=”image”><img src=”example.com/images/binary-mom.png” /></div>
 </pre>
-=====./customer/main/product_details.tpl.patch=====
 ''This file contains patches for the [[File:Itemprop_description.png||<itemprop=”description”>]], [[File:Itemprop_id.png||<itemprop=”id”>]] and [[File:Itemprop_offers.png||<itemprop=”offers” itemscope itemtype=”AggregateOffer”>]] tags.''
@@ Line 275: / Line 276: @@
 </pre>
-=====./modules/Customer_Reviews/vote_bar.tpl.patch=====
+<b>./modules/Customer_Reviews/vote_bar.tpl.patch</b>
 ''This file contains patches for adding [[File:Itemprop_aggregaterating.png||<itemprop=”aggregateRating” itemscope itemtype=”aggregateRating”>]] tag.''

@@ Line 180: / Line 180: @@
 ====Description of patches====
-=====./customer/bread_crumbs.tpl.patch=====
+<b>./customer/bread_crumbs.tpl.patch</b>
 ''This file contains patches for adding the [[File:Itemscope_itemtype_breadcrumbs.png||<itemscope itemtype=”Breadcrumbs”>]] tags.''

@@ Line 207: / Line 207: @@
 You should add this tag to the [[File:Div_tag.png||<div>]] or [[File:table_tag.png||<table>]] element that covers all the elements with product details. Have a look at the sample web page structure. Regarding this page, you should apply the [[File:Itemscope_itemtype_product.png||<itemscope itemtype=”Product”>]] tag to the [[File:Div_class_product_details.png||<div class=”product-details”>]] one.
-HERE
+It will still work correctly if you apply this patch to [[File:Div_class_center.png||]], [[File:Div_class_main.png||]] or [[File:Body_tag.png||<body>]] tags, but this approach is not recommended, because if you decide to use other microformats in the future, there might be an interference.
 An example of how this tag can be applied (for the given simple web page) is to replace this piece of code:
@@ Line 256: / Line 256: @@
 </pre>
-HERE2
+Note that if, for some reason, there is no [[File:Div_tag.png||]], [[File:Span_tag.png||<span>]] etc element around your description, you can replace this piece of code:
 <pre>

@@ Line 207: / Line 207: @@
 You should add this tag to the [[File:Div_tag.png||<div>]] or [[File:table_tag.png||<table>]] element that covers all the elements with product details. Have a look at the sample web page structure. Regarding this page, you should apply the [[File:Itemscope_itemtype_product.png||<itemscope itemtype=”Product”>]] tag to the [[File:Div_class_product_details.png||<div class=”product-details”>]] one.
-It will still work correctly if you apply this patch to [[File:Div_class_center.png||<div class=”center”>]], [[File:Div_class_main.png||<div class=”main”>]] or [[File:Body_tag.png||<body>]] tags, but this approach is not recommended, because if you decide to use other microformats in the future, there might be an interference.
+HERE
 An example of how this tag can be applied (for the given simple web page) is to replace this piece of code:
@@ Line 255: / Line 255: @@
 <div class=”count-in-stock”>50</div>
 </pre>
-Note that if, for some reason, there is no [[File:Div_tag.png||<div>]], [[File:Span_tag.png||<span>]] etc element around your description, you can replace this piece of code:
 <pre>
 <div class=”description”{if $active_modules.Rich_Google_Search_Results}{include file="modules/Rich_Google_Search_Results/description_prop.tpl"}{/if}>Sorry mom, but we have

@@ Line 160: / Line 160: @@
 <div class=”product-name”>Binary Mom</div>
 <div class=”image”><img src=”example.com/images/binary-mom.png” /></div>
-<div class=”description”>Sorry mom, but we have neglected you for too long. We know you're either a geek yourself or the proud mother of a geek and it's about time you were
+<div class=”description”>Sorry mom, but we have neglected you for too long. We know
-given the opportunity to show it off. How's about our nice Binary Mom tee? It's a great way to confound those non-geeky types with your binary sweetness.</div>
+you're either a geek yourself or the proud mother of a geek and it's about time you
 <div class=”sku”>SKU17551BIS</div>
 <div class=”price”>$17.99</div>

@@ Line 47: / Line 47: @@
 #: {{Note1|'''Important:''' Make sure you keep the directory structure while unpacking and uploading the distribution package, otherwise some necessary files can be overwritten! }}
 # In a web browser, run the installation script <u>httр://<YOUR_XCART_DOMAIN>/install-rich-gsearch-results.php</u> replacing the variable <u><YOUR_XCART_DOMAIN></u> with the actual domain name of your X-Cart based store.
-# Enter the Auth code, accept the License Agreement and click the Next button.<br />{{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 on the [[X-Cart:Summary_Page |Summary]] page in X-Cart Admin area before the License info subsection. Another way to find out the code is to retrieve the value of the variable $installation_auth_code from the file <u><xcart_dir>include/install.php</u>.}}
+# 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.<br />
 # The installation script patches the files and activates the module. Click '''Next''' to continue the installation.<br />{{Note1|Note: if you are using a custom skin, you will need to manually apply the patches to it. Otherwise, the module will not work in this skin. For more info, see [[X-Cart:How_to_patch_a_3rd_party_skin_after_the_installation_of_the_Rich_Google_Search_Results_module | How to patch a 3rd party skin after the installation of the Rich Google Search Results module]].}}
 # The installation script generates a new system fingerprint. Click '''Next''' to complete the installation.