Rich Snippets Magento ExtensionUser Guide

�1

Important Notice

MageWorx reserves the right to make corrections, modifications, enhancements, improvements, and other changes to all its products and services at any time and to discontinue any product or service without notice. Customers should obtain the latest relevant information before placing an order and should verify that this information is complete and up-to-date. All products are sold subject to MageWorx terms and conditions of sale supplied at the time of order acknowledgment.

MageWorx warrants performance of its products to the specifications applicable at the time of sale in accordance with the company’s standard warranty. Testing and other quality control techniques are used to the extent MageWorx deems necessary to support this warranty.

MageWorx assumes no liability for applications assistance or customer product design. Customers are responsible for their products and applications using MageWorx components. To minimize the risks associated with customer products and applications, customers should provide adequate design and operating safeguards.

MageWorx does not warrant or represent that any license, either express or implied, is granted under any MageWorx patent right, copyright, mask work right, or other MageWorx intellectual property rights relating to any combination, machine, or process in which MageWorx products or services are used.

Information published by MageWorx regarding third-party products or services does not constitute a license from MageWorx to use such products or services or a warranty or endorsement thereof. Use of such information may require a license from a third party under the patents or other intellectual property of the third party, or a license from MageWorx under the patents or other intellectual property of MageWorx.

Resale of MageWorx products or services with statements different from or beyond the parameters stated by MageWorx for that product or service voids all express and any implied warranties for the associated MageWorx product or service and is an unfair and deceptive business practice. MageWorx is not responsible or liable for any such statements.

All company and brand products and service names are trademarks or registered trademarks of their respective holders.

Copyright © 2015 MageWorx

�2

Table of Contents

Extension Installation……………………………………………………………….…. 4 Installation to a custom template/ theme………………………………………….… 41. Enable Markup Data………………………………………………………………….. 52. Using Markup Data to display Website Info………………………..……………….. 63. Adding Merchant (Seller) Info ……………………………………………………… 94. Breadcrumbs Optimization……………………………………………………………105. CMS Page data Markup……………………………………………………….…….. 106. Product Page data Markup ………………………………………………………….117. Category data Markup ……………..…………………………………………………148. Events data Markup …………………………………………………………………..15

�3

Extension InstallationTo install the Rich Snippets Magento extension, please follow the steps below:

1. Disable the Compilation Mode (if enabled).2. Enable Magento cache (if disabled).3. Log out from Magento Admin panel.4. Unpack the contents of the Extension folder from the package file purchased from

MageWorx to your Magento root folder.5. Log into Magento Admin Panel.6. Go to the System - Cache Management section, select Refresh under the All

Cache drop-down menu and press the Save Cache Settings.7. You can run the Compilation mode back if necessary (not enabled but run it)8. Now go to System - Configuration - MageWorx tab - Extensions & Support

section. If you see Rich Snippets in the list of installed MageWorx extensions, the installation is successful.

Installation to a custom template/ theme

If you use a custom template or theme, you should copy the extension’s layouts, templates and skin files to your custom template or theme. The folders that should be copied:

app/design/frontend/default/default/layout/app/design/frontend/default/default/template/skin/frontend/default/default/css/skin/frontend/default/default/images/

You should copy them to:

app/design/frontend/<your-template>/<your-theme>/layout/app/design/frontend<your-template>/<your-theme>/template/skin/frontend/<your-template>/<your-theme>/css/skin/frontend/<your-template>/<your-theme>/images/

Please note that all these folders already exist in your store and you have to merge them with the folders on your server. Do not overwrite them.

�4

1. Enabling Markup Data

To enable structured data markup, go to System - Configuration - MageWorx - Rich Snippets and select the Yes option in the Enable Markup dropdown.

Also, from here you can disable this functionality for all your pages at once. To do that, select the No option in this menu and click Save to apply the changes.

�5

2. Using Markup Data for to display Website Info

Scroll down to the Website Info section.

This is the place where you can enable marking up your site with Open Graph, Twitter Cards and other Markup tags to take control over how your website info appears in search results and in social media.

Using these tags, you can create a more appealing visual presentation of your site on Facebook, will enrich the standard tweets with additional content, media and links, and make your site stand out in the search results.

Enable in Open Graph — enabling this setting lets you deliver the highest quality posts on Facebook. Adding Open Graph tags to your store will help the Facebook Crawler pick up the right title and description for the shared page, as well as supply them with the most suitable preview image.

Visit this page to learn more about the way Open Graph tags work.

�6

Enable in Twitter Cards — with this feature you can provide a media-rich experience to those who view your Twitter content.

If enabled, the standard Tweet with your site URL will be transformed into the Summary Card and accompanied with an additional title, an extra up-to-200 words description, and an image.

Additionally, you can enter your Twitter name - it will be shown under the card’s title. The feature comes useful if you share something under your company account, but want to let your audience know who is posting.

Visit this page to learn more about Twitter Cards.

Enable Rich Snippets — the feature adds extra info about your store (a store name/ description) in the search results.

Also, the extension is capable of adding the search field (Sitelinks Search Box), so people can search your website right from the search results page. Follow this link to learn more about this functionality.

�7

These are the settings you need to enable to add your website info and the onsite search field:

IMPORTANT

Note that the website info will be added by the JSON-LD method.

Basically, JSON-LD is a data-linking format used for the embedding of markup data in a script tag. The biggest advantage is that it lets you entirely separate the markup data from the HTML code. So one doesn’t need to tweak the actual HTML elements, when using it.

Visit this page to learn more about JSON-LD Schema.Org method.

�8

3. Optimizing Merchant (Seller) Info

The next group of settings lets you markup the seller info. You can select to show your business type (according to Schema.Org), add a store name, description, and social links.

Additionally, you can add your personal details, such as a telephone number, fax and location (state/ region, street, and ZIP code).

�9

4. Breadcrumbs Optimization

Scroll down to the next block of settings to optimize breadcrumbs for rich snippets. Note that you can use different breadcrumbs optimization methods:

• HTML injection (by inserting tags right into the page code)• Javascript (using the JSON-LD data-linking format)

5. CMS Page Data Markup

Next, you may select enabling the Open Graph protocol and Twitter Cards for you CMS pages.

�10

6. Product Page Data Markup

In this block of settings you can optimize your site markup to display prices, reviews, ratings, availability of your products. These values can be included in your Facebook posts, Twitter Product Cards and search engine rich snippets.

NOTE: by default, the product entity will include the following attributes: product name, preview image, rating, price, availability and website language.

�11

The extension also lets you notify Google of extra attribute to include into rich snippets. Such as:

• Category• Color• Manufacturer• Brand• Model• Gtin• Weight• Dimensions• Condition

�12

Also, under these settings you can choose which payment and delivery methods to include, add SKU, and define best rating (numeric scale, such as 1 to 5 star).

NOTE: In case the best rating field is left blank, “5” is set by default.

If SKUs, payment and delivery methods are not chosen, the extension uses the default ones.

�13

7. Category Page Data Markup

Our extension marks up category pages in the way search engines understand. It includes the list of items, and the basic product markup. It’s all is fully compliant with Google’s guidelines and results in this type of rich snippets:

Select the Yes option to enable rich snippets on category pages (note that the JSON: LD method will be used in this case).

Additionally, if there is NOINDEX meta robots tag on some of your category pages (e.g. layered navigation pages with applied filters), you can can hide markup tags there.

�14

To inform search engines about your special product offers, make sure you enable the Show Product Offers option.

�15

8. Events Data Markup

Events that meet Google’s policy guidelines may be eligible for Rich Snippets in search results.

The extension lets you notify Google about the details of the organized public events, such as a musical gig, exhibition, food fest, marathon, etc. Also, this functionality will be of great help if you sell bus, ferry, airplane tickets.

To enable this functionality, please scroll down to the bottom of the Rich Snippet settings. Also, from here you can select which attribute sets will be used in your rich snippet events.

�16

Below, you can specify your event type (according to Schema.Org), best rating, description, location, address, etc. attribute codes.

When done with the settings, click OK for the changes to take into effect.

IMPORTANT NOTICE If you have optimized your data markup correctly, you will see how many pages the rich snippets were detected on in your Google Webmaster Tools under Account – Optimization – Structured Data.

You can find more details about the rich snippets here.

NOTE: Please mind that the Price is a mandatory attribute for the rich snippets. If you hide your product prices for the not logged-in visitors, Google won’t display rich snippets for your eCommerce store.

�17

NEED MORE SEO EXTENSIONS?

Take a look at other Mageworx SEO extensions for the Magento platform here.

GOT QUESTIONS?

MageWorx offers FREE lifetime support and updates for any extension developed for Magento. Need support on MageWorx extension usage, feel free submit a ticket here: http://support.mageworx.com

NEED PRO MAGENTO SEO CONFIGURATION?

If you would like to save time on configuring our SEO extensions, you may ask our SEO professionals to take care of this. Our specialists will analyze your store specifics and adjust the software for the best SEO effect. Click here to learn more about our Magento SEO Configuration service.

GETTING HELP WITH MAGENTO

MageWorx offers outstanding services developing custom tailored solutions for Magento platform to attain your eCommerce objectives. Our professional impassioned team provides profound and custom oriented development of your project in a short timeframe. You are most welcome to contact us at sales@mageworx.com

Copyright © 2015 MageWorx

�18