Jigoshop SEO

Installation

The main zip that you download contain two folders, Plugin and Documentation.

The Plugin folder contains an unzipped version of the plugin (jigoshop-seo folder) and a zipped version (jigoshop-seo.zip). The Documentation folder contains this documentation.

There are two ways to install the plugin: through the Worpress admin panel or upload using FTP.

Remember...

Jigoshop must be installed before you install the Jigoshop SEO Plugin

1. Install using Wordpress Admin Panel

To install the plugin, log into your WordPress admin panel and navigate to: Plugins > Add New.

There will be a sub-menu across the top of the page, click upload

Browse to the plugin folder and select the jigoshop-seo.zip file. Click install now.

After a few seconds, Wordpress should notify you that the plugin was installed successfully and give you the option of activating the plugin.

Clicking Activate Plugin wil activate the plugin immediatley. Alternativley, you can activate the plugin from the Plugins page.

2. Install using FTP

If you have no idea what FTP is or how to log into your hosting using FTP then do not attempt this. Instead install the plugin using the Wordpress Admin Panel as explain above.

Watch out!!!...

Be careful of permissions and file ownership when uploading through FTP. The plugin implements an autmatic update feature which may fail if the file permissions/owernership are not correct resulting in Wordpress being unable to make changes to the files. Uploading the plugin though the Wordpress dashboard (as outlined in the previous section) will ensure all permissions/ownership are correct.

Login into your hosting using your chosen FTP client and browse to your wordpress installation and go to your plugins folder (usually wp-content/plugins). Upload the whole of the jigoshop-seo folder from within the Plugin folder that you downloaded.

Once uploaded, login to your wordpres admin and go to Plugins > Installed Plugins and activate the plugin.


Note...

If you try to activate the plugin when Jigoshop is inactive or deactivate Jigoshop, the plugin will automatically deactivate itself.

Features

The Jigoshop SEO Plugin adds several extra pieces of functionality that will make your Jigoshop shop more optimised for the search engines. These features include:

  • Change/remove Jigoshop default product category base
  • SEO Freindly URLs when using Filters (Layered Navigation)
  • Automatically generated page title and meta description for categories
  • Automatically generated page title and meta description for products
  • Custom page title and meta description for categories
  • Custom page title and meta description for products
  • Noindex/Nofollow individual categories
  • Noindex/Nofollow individual products
  • New SEO layered navigation widget
  • New selected filters widget
  • Improved Breadcrumbs

Features in detail

What Jigoshop Does What the Jigoshop SEO Plugin Does
Product Category Base When browsing a category page in Jigoshop, the URL will be www.mysite.com/product-category/category-name. Gives you the option of changing or removing the product-category part of the URL, giving you a shorter and cleaner looking URL.
SEO Freindly URLs When browsing product using the layered navigation widget, Jigoshop adds the attribute ID to the URL as a parameter, e.g. www.mysite.com/product-category/category-name/?filter_name1=12,13&filter_name2=78 Using the new layered navigation widget, the plugin removes all parameters from the URL and replaces them with the actual name of the attribute. e.g. www.mysite.com/product-category/category-name/filter1/filter2/filter3
Note - You must you the new layered navigation widget for this to work correctly.
Automatically generated meta info for categories The page title for categories will always be the category name. This will stay the same even after selecting filters from the layered navigation widget. There is no meta description. The plugin allows you to set a template for both the page title and the meta description. As the user browses the category page using the filters, the template will be used to generate both the page title and meta description giving you a different page title and meta description for each combination of filter selected.
Automatically generated meta info for products The page title for products will always be the product name. There is no meta description. The plugin allows you to set a template for the page title and meta description for each product which will be used to generate this information when the page is being viewed.
Custom meta info for categories The page title for categories will always be the category name. There is no meta description. In addition to setting a template, you can define a custom static page title and meta description that will be used instead of the generating one.
Custom meta info for products The page title for products will always be the product name. There is no meta description. In addition to setting a template, you can define a custom static page title and meta description that will be used instead of the generating one.
Noindex/Nofollow individual categories There is no option for this in Jigoshop. Set whether the searh engines will index this category page and/or folow the links on this page.
Noindex/Nofollow individual products There is no option for this in Jigoshop. Set whether the searh engines will index this product page and/or folow the links on this page.
New SEO layered nav widget The default layered navigation widget gives unfreindly SEO URLs when filtering products. The new layered navigation widget will output SEO friendly URLs as mentioned above. (see SEO Freindly URLs)
New selected filters widget - Shows what filters have been selected and allows you to remove filters (see the widgets section).
Improved breadcrumbs On category pages, the breadcrumb will only show categories and not filter selected. Breadcrumbs will now show what filters were selected and the order in which they were selected as well as giving the option travelling back up the breadcrumb trail.

Setup

Once installed, the plugin will add a few extra options to various parts of Jigoshop. The global settings for the plguin can be seen within the Jigoshop settings page.

The plugin will add a new tab called 'SEO' which will hold all global settings for the plugin.

The SEO tab is split into three sections: Jigoshop SEO Settings, Global Category Meta Settings and Global Product Meta Settings. Each sectio goes ito more details below.

Jigoshop SEO Settings

The Jigoshop SEO Settings section holds general settings that arn't specific to categories or products. A description of each setting within this section is given below.

Product Category Base

The product category base is used in the url when browsing a category page. By default, Jigoshop shows product-category. E.g. www.mysite.com/product-category/category-name

You can change this to whatever you want by inputting something in this field. Leaving this blank will remove the category base completely from the URL. E.g. www.mysite.com/category-name

Remember...

The category base must only comprise of letters (lowercase), numbers, hypens(-) and underscores(_).

Update...

If you are using Jigoshop 1.2 or above, you will only have the option of removing the product category base since changing the base was added as a core feature in Jigoshop 1.2.

Enable Jigoshop SEO Breadcrumbs

The Jigoshop SEO Breadcrumbs are different to the built in breadcrumbs that Jigoshop uses. The Jigoshop SEO breadcrumbs add the filters selected from the layered navigation widget into the breadcrumb trail so the user knows exactly how the got to the current page.

If set to 'Yes', the Jigoshop SEO breadcrumbs will be shown instead of the default breadcrumbs. Note however, that the Jigoshop SEO breadcrumbs will only output on category pages instead of the default breadcrumbs. On all other pages, the default breadcrumbs will be shown.

Global Category Meta Settings

The Global Category Settings govern what and how the plugin will handle meta data for categories only. These setting wil apply to all categories but can be changed/disabled within the individual category edit page. Each setting is explained below.

Note...

'Meta Data' refers to data that is output in the < head > section of the page and include the page title (the title seen in the browsers bar, or tab), the meta description (which is used in search engines results page) and meta robots tag (which tells search engine robot how to hanle that page).

Enable Category Meta Data

Set whether the plugin will handle meta data for categories.The plugin will only handle the outputting of page titles and meta description for categories if this is set to 'Yes'. Setting this to 'No' will disable this for all categories regardless of what is set in each individual categorys settings.

Category Meta Setting

Here you determine how the plugin will output pages titles and meta descriptions for categories.
Settings this to 'Template' will make the plugin generate the page title and meta description for categories using the template provided in the 'Category Page title template' and 'Category Meta Description Template' settings.
Setting this to custom will make the plugin use whatever you have set the page title and meta description to be in each category.

Note...

This setting will be overriden by whatever is set in each individual category. Only if the individual category option is set to 'Global' will this setting be used.

Category Page Title Template

The template that will be used when generating category page titles. Any combination of tags and text can be used to make up the title. Available tags are shown below the 'Category Meta Description Template' field.

Category Meta Description Template

The template that will be used when generating category meta description. Any combination of tags and text can be used to make up the description. Available tags are shown below this field.

Global Product Meta Settings

Similar to the category settings, the Global Product Settings determince how the plugin will handle meta data for products only. Again, these settings will apply to all products but can be changed/disabled within each product. Each setting is explained below.

Enable Product Meta Data

The plugin will only handle the outputting of page titles and meta description for products if this is set to 'Yes'.

Product Meta Setting

Here you determine how the plugin will output pages titles and meta descriptions for products.
Settings this to 'Template' will make the plugin generate the page title and meta description for products using the template provided in the 'Product Page title template' and 'Product Meta Description Template' settings.
Setting this to custom will make the plugin use whatever you have set the page title and meta description to be in each product.

Remember...

This setting will be overriden by whatever is set in each individual product. Only if the individual product option is set to 'Global' will this setting be used.

Product Page Title Template

The template that will be used when generating product page titles. Any combination of tags and text can be used to make up the title. Available tags are shown below the 'Product Meta Description Template' field.

Product Meta Description Template

The template that will be used when generating product meta description. Any combination of tags and text can be used to make up the description. Available tags are shown below this field.

Category Options

The plugin will add a few SEO settings fields to the category edit page. A description of those settings is below:

Enabled/Option

Disabled - Page titles and meta description will not be shown for this category, even if the 'Enable Category Meta Data' global setting is set to 'Yes'.
Global - Set by default. This will use whatever is set in the global 'Category Meta Setting'.
Template - This will use the templates for page title and meta description set in the global 'Category Page Title Template' and 'Category Meta Description Template' setting.
Custom - This will use whatever is input in the Page Title and Meta Description fields in the cateogry edit page.

Note...

This setting of override whatever is set in the global 'Category Meta Setting'.
Page Title

The custom page title for this category. Will only be used if the category option or the global option are set to 'Custom'

Meta Description

The custom meta description for this category. Will only be used if the category option or the global option are set to 'Custom'

Noindex this category

Set whether the search engines index this category page

Nofollow this category

Set whether the search engines follow links on this category page.

Product Options

The plugin will add a new 'SEO' tab on the product edit page. A description of its settings are below:

Enabled/Option

Disabled - Page titles and meta description will not be shown for this product, even if the 'Enable Product Meta Data' global setting is set to 'Yes'.
Global - Set by default. This will use whatever is set in the global 'Product Meta Setting'.
Template - This will use the templates for page title and meta description set in the global 'Product Page Title Template' and 'Product Meta Description Template' setting.
Custom - This will use whatever is input in the Page Title and Meta Description fields in the product edit page.

Note...

This setting of override whatever is set in the global 'Product Meta Setting'.
Page Title

The custom page title for this product. Will only be used if the product option or the global option are set to 'Custom'

Meta Description

The custom meta description for this category. Will only be used if the product option or the global option are set to 'Custom'

Noindex this product

Set whether search engines will index this product page.

Nofollow this product

Set whether search engines will follow links on this category page.

Widgets

The plugin will add 2 custom widgets.

Jigoshop SEO Layered Navigation Widget

The Jigoshop SEO layered navigation widget is similar to the default Jigoshop layered navigation widget. However, where as the default layered navigation widgets allows you to select multiple filters from a single attribute (e.g. red and green from the color attribute), the Jigoshop SEO layered navigation widget limits this to just a single filter per attribute. When a filter has been selected from an attribute, it wil no longer show up. Alternativly, the filter will show up in the Selected Filters Widget (see below) giving the user the option of deselecting that filter.

Rather than add IDs and parameters to the URL (like the default layered navigation widget), the Jigoshop SEO layered navigation widget will create SEO freindly urls based on the filters selected. e.g. www.mysite.com/category/filter1/filter2/filter3

Order of filters in URL

The filters will be ordered alphabetically (by attribute name) when the URL is created.

Why limit it to just one filter?

The Layered Navigation is to be used to provided the user with a way of filtering down their product selection to get to the products that they want. Each time a filter is selected, the number of products returned should decrease hence allowing the user to drill down to a specific set of products of their specification.

Why make the widget disappear after a filter is selected?

Once a filter is selected, the widget showing that attribute will no longer be shown. The reason for this is simply to stop the user from thinking that other filters from within the same attribute can still be selected.
We still needed a way to allow the user to clear their chosen filters, hence the Jigoshop SEO Selected Filters Widget (see below).

Remember...

The Jigoshop SEO layered navigation widget is the base for SEO friendly URLS and the improved breadcrumbs. For these features to work you MUST use the Jigoshop SEO layered navigation widget instead of the default Jigoshop layered nav widget.

Jigoshop SEO Selected Filters Widget

Each time a filter is selected, it will show up in this widget allowing the user to clear that one filter and widen their product search. If no filters have been selected yet, then this widget will not show up.