You're currently on:
Français English

Configuring SEOgento in the Magento administration

Summary

Administration

To access the administration of the Seogento plugin , go to System > Configuration, then in the left menu you'll find the SEOgento tab in the Catalog section.

If you get an error or a blank page, check installation instructions

The configuration of the extension Seogento divided into two parts :
The options : adjusts the general features
The Meta Optimisations : allows to define meta tags for individual items (current products and categories)

The options

Delete duplicate on the pager

If this option is activated, it removes the parameter p=1 in the url of the link to the page 1 on a product listing. This option will force the removal of the filter category. It requires the overload of the class Mage_Catalog_Block_Product_List_Toolbar.

Disable the filters empty

Select this option to remove links to the filters that have no products (apparently useless in the version of magento > 1.3, may be useful in certain malformed templates). This option requires the overload of the class Mage_Catalog_Block_Layer_View.

Disable the filter category

The category filter causes a duplicate content. Indeed it does not redirect on the page of the sub-class, but it appends a parameter cat on url. This option will force the removal of the filter category. It requires the overload of the class Mage_Catalog_Block_Layer_View.

Enable attribute links

This option allows to add links on the filterable attributes in the section Additional Informations on a product page. Your customer and the search engines will be redirected to the parent category with a filter preset to this value. This option requires the overload of the class Mage_Catalog_Block_Product_AttributesLink.

Search Product Category

This solves the problem of the product page where the category does not appear.

To explain that, Magento references category of a product page only in some cases:

  • The URL contains the name of the category (if the products are not located in the root category)
  • The client session contains the previously seen url, and probably the name of the category.
  • The http referrer header sent by the client is available and therefore probably also contains the category name.

None of this informations is available during the site course by search engines bots.

It results that your product page has no information about its category. For a good ranking it is necessary to enable this option.

Add the manufacturer on the product name

The product name appears in h2 on the default Magento template. It is therefore important to have a meaningful name. This option will automatically add the product manufacturer (if any) before its name (if that mark is not already present in the product name). It requires the overload of the class Core_Model_Catalog_Product.

Canonical URL

Enable canonical urls

This option enables the addition of the header canonical urls. This will allow the engine to represent different pages as part of a single entity, a single content. The pages of appendices elements, such as customer reviews for a product will be attached to the main page of the item, in this case the product page itself.

Canonical URL by category filter

Allow to push the current URL (with filter parameters) as canonical URL. If this option is disable, the canonical url of the category will be pushed.

Canonical URL by category pager

Allow to push the current URL (with page parameter : p) as canonical URL. If this option is disable, the canonical url of the category will be pushed.

Canonical urls on product review list

Allow to send product canonical url on product review list page. If this option is activate, the canonical url on a product review list page become the product url.

Canonical urls on product review

Allow to send product canonical url on single product review page. If this option is activate, the canonical url on a single product review page (where only one review is displayed) become the product url.

Optimizations Meta

The title tags, meta keywords and meta description are optimized differently depending on the type of page (product page or category page). To resolve this problem, a mask is configurable according to different elements of the current page.

A particular attention is given to the title tag, where you can define two diferent mask. One if your original title is already defined (default title), and the other if it's missed (forced title). If the mask to be analyzed is empty, the original default title of Magento displayed.

The syntax of the mask to consider the dynamic elements is as follows:
((element / property [| property ][...] [option = "value "][...]}}

element available

On a product page:
  • product
  • categories
  • attributes
On a category page:
  • category
  • filters
  • filter

Definition of property :

property is a property of an element. Each element has its own properties.

category and categories has the following property:

  • name
  • meta_title
  • meta_keywords
  • meta_description
  • level
  • product_count
  • image_url
  • and all that correspond the model Mage_Catalog_Model_Category

product has the following property:

  • name
  • meta_title
  • meta_keywords
  • meta_description
  • image_url
  • weight
  • sku
  • price
  • and attributes defined in the administration (use codes product attributes) so anything that match the model Mage_Catalog_Model_Product

attributes has the property of the EAV model for the product concerned and in the current locale (current language).

Its property are organized according to this syntax:

  • <product_attribute_code>_value
  • <product_attribute_code>_label

filters has the property

  • name
  • label
  • request_var
  • (whatever correspond the model Mage_Catalog_Model_Layer_Filter_Item)

filter has the property of the EAV model for the product concerned , like attributes.

Its property are organized according to this syntax:

  • <filter_request_var>_value
  • <filter_request_var>_label

Definition of option

The "option" allows to customize the current output of the mask through separators, prefixes, suffixes ... here's the list. The value between parenthesis is the default framed single quotes.

  • separator (' - ')
    defined a top level separator
    example: {{categories/name separator="" length="2"}}
    display: category1 ! Category2
  • prepend ('')
    add a prefix to the result of the mask if the mask value.
    example: {{filters/name prepend="*"}}
    show whether there has 1 filter: *filter1
    and will show if there are 2 filters: *filter1 - filter2
  • append ('')
    add a suffix to the result of the mask if the mask had a value.
    example: {{filters/append name="*"}}
    show whether there has 1 filter: filter1*
    and will show if there are 2 filters: filter1 - filter2*
  • default ('')
    if the mask is undefined, the value of this property will be displayed
    example: {{category/meta_title default="cat"}}
    display if the category is not defined: cat
  • offset ('0')
    if the mask for an element that can be an array of values as the categories or filters, then the mask begins to nth offset. If offset is negative then it will count the value from the end.
    example: {{category/name offset="1"}}
    display: category2
  • length ('1')
    if the mask for an element that can be an array of values, the mask display length values. If length is negative, then it will just go the length-th value from the end.
    Example: {{category/name length="3"}}
    display: category1 - Category2 - category3
    Combined with the offset option, it is useful to view the categories and subcategories ( {{category/name offset="-3" length="3"}} ), or only the subcategory ( eg : {{category/name offset="-1"}} )
  • reverse ('0')
    if the mask for an element that can be an array of values, the values are in reverse order.
    Example: {{category/name reverse="1" length="2" separator=" in "}}
    display: category2 in category1
  • subseparator (' : ')
    if the mask is for several attributes, the attributes are separated by this value.
    example: {{filters/name|label subseparator=" > " length="2"}}
    display: filter1 > value1 - filter2 > value2
  • subprepend ('')
    if the mask is for several attributes, this value will be added at the beginning of each attribute group.
    Example: {{category/name subprepend="+" length="-2"}}
    display (if there are 5 categories): +category1 +category2 +category3
  • subappend ('')
    if the mask is for several elements, this value will be added at the end of each attribute group.
    Example: {{filter/name|label subappend="/" offset="-2" length="2"}}
    display (if there are 3 filters): /filter2 : value2 - /filter3 : value3
  • word_count ('0')
    If this value is higher than 0 and lower than the count of words mask, the mask will be cutted at the number of words specified.
    Example : {{product/name word_count="3"}}
    display : Sony VAIO VGN (else VAIO VGN-TXN27N/B 11.1" Notebook PC)
  • word_endcut ('')
    If This value is defined and the word_count parameter is applied, the mask will ended with the value.
    Example : {{product/name word_count="3" word_endcut="..."}}
    display : Sony VAIO VGN... (else VAIO VGN-TXN27N/B 11.1" Notebook PC)
  • word_separator (' .,!?:;_\\/-')
    This value define the split separator used by the word_count parameter for cut to words.
    Example : {{product/name word_count="3" word_separator=" A"}}
    display : Sony VAIO (else VAIO VGN-TXN27N/B 11.1" Notebook PC)

Use the replacement function

This feature allows you to replace parts of the text when display dynamic optimization.

So you can consider meaningful sentences rather than simple following expressions.

For example the result of your title on some pages will be Category1 - Color: Black.
Set a regular expression replacement: /color\s*:\s*(\w+)/i" replaced by "$1 color".
"Category1 - Color: Black" will become "Category1 - Black color".

The regular expressions are Perl type (they are used in the function preg_replace)
It must start with / and end with / (if omitted then they are added) optionally followed by a list of options.
example: /abc/i (i : case insensitivity option) find all the strings that match abc, ABC, Abc, abc, ABC, ...

For more info on regular expressions, see wikipedia or php manual

Examples :

Some examples of masks on product pages :
  • {{categories/name offset="-2" length="2" reverse="1" separator=" <- "}}
    Display le name of the 2 last category of the breadcrumb, sperated with «<-»
  • {{attributes/color _value default="sans couleur" prepend="de couleur "}}
    Display the color attribute value prefixed by « de couleur », or, if it's empty, display « sans couleur »
Other exemples of masks on categorie pages :
  • {{categories/name offset="-1" separator=", "}}
    Display the name of the last category of the breadcrumb (separator is useless here)
  • {{categories/meta_title length="2" separator=" | "}}
    Display the meta title of the 2 first category with | separator
  • {{filter/label separator=" " length="3"}}
    Display the values of the 3 first filters with « » separator
  • {{filter/name|label subseparator=" : " separator=", " length="10"}}
    Display, for the 10 first filters selected, his name and his value separated by « : », and each name-value group will be separed with « , »

Template optimisation with masks

All mask defined to optimizing the metas can be used in the template also. Simply call this function with the mask you want :
Mage::getSingleton('seogento/config_template_meta')->parse('a mask');

URL Rewrite

Rewrite tag URL

Rewrite URL on each page tag and replace it by tag/{tag_name}. For example, The url of the tag "magento" become /tag/magento. This option requires the overload of the class Mage_Tag_Model_Tag.

Prefix of the tag URL rewrite

Change the prefix by default ("tag/") of the tag rewrited URL.

Rewrite URL of category filters

Enable the URL rewriting on the category filters. Allow to transform traditionnal filter parameters to directories.
Example : /category.html?color=2 will turn into /category.html/color-2.

Attention : for the category filter, it becomes a sub-menu. The links will point to the children categories.

The canonical urls are accordingly altered. It requires the overload (rewrite) of the classes Mage_Catalog_Model_Layer_Filter_Item and Mage_Catalog_Block_Layer_State.

This Function add a router called in front controller. It try to find the key-value pairs corresponding to the filters of the detected current category. The separator of key-value pairs is dash ("-"). You can include a dash in the value part, but all dash in the key part will be escaped by an underscore ("_")

Translate the filter keys in URL

If this option is active, the filter keys in URL will be translate in the current language (store locale).
Example : /category.html?color=2 will turn into /category.html/color-2 ("color" is translate to "color").

Translate the filter values in URL

If this option is active, the filter values in URL will be translate in the current language (store locale).
Example : /category.html?color=2 will turn into en /category.html/color-black.

Use the replace functionnality on the filter keys and filter values

Like on the meta titles of products and categories, you can replace a filter key or a filter value.

Category URL suffix in the filter URLs

Allow to remove or move to the end the category URL suffix in a filter URL.
Example : /category.html?color=2 will turn into /category/color-2 or in /category/color-2.html.

Stat Sell

This fonctionnality allow to display relation between a product page and other products. This is based on the orders, the quotes or the visits. This proposes to your customer the other product in relation with the curent product on the product page, this increases the thematic of the page and so the rankin of it.

Active Agregation

Active calculating statistics of product sell. Every 5 min, the cron run a calculation on the visit log and on the order to associate at each product is relation with the other products. The metrics available is on visits, quotes or orders

By default, the Block class showing its relationship ( Xorax_Seogento_Block_Catalog_Product_List_Statsell ) are based on sell statistics (orders). This class is open source, so you can also relying on visits or on quotes to view its product relations.

You can modified its relations between product by going to the editing a product, in the "stat-sell" tab.

Every 5 min the agregation run on the last 5 min. You can tun manualy the agregator with the script in shell/statsell.php in the Seogento directory.
This script is open-source. Run the command-line php -f shell/statsell.php, enter the periode and wait the end of agregation. It's recommanded to disable the "active agregation" option before run this script.

Default Attribute

Select the attribut with which the results relations is displayed. This option can be override in the stat-sell block or in the config xml layout.

Replace the up sell block

If this option is active, the up sell block will be replaced by the stat sell block.

 

Infos / Contact

How referencing Magento with the SEOgento extension?
How use this plugin ?

Newsletter

Newsletter