Documentation o wtyczce "SEO-filter"

plugins status – plugin is enabled or disabled. To enable, select the appropriate status and save changes.

URL address generation type – select the type of URL for filter pages. Two options are available: short and simple. Short - the URL is generated based on feature names, with no additional elements added. Simple - the URL is generated based on the feature name, with the prefix "filter" added before the feature name.

Examples:

• Short URL https://site.com/category/shiny/simmetrichnyy/
• Simple URL https://site.com/category/shiny/filter/simmetrichnyy/

Pass URL to Yandex.Metrica – plugin enables Yandex.Metrica tracking for pages created by SEO-filter. If you want to send data about filter pages, select "Yes" from the list. A field "Yandex.Metrica counter number" will appear. You must enter the metric counter number here; otherwise, data will not be sent. You can add a counter number for all Sites or for each Site separately (if different Sites have different counters).

Sitemap – option to add links to the site map for robots.

2 options:

• Standard (links to filter pages are added to the standard sitemap.xml generated by the engine);
• Separate (links to filter pages are added to a separate sitemap located at /filter-sitemap.xml).

Block feature values without products – if there are no products, plugin makes these features inactive.

Consider category filtering settings - If "Yes" is selected, category filtering settings are taken into account. This means filters will only be available for features displayed on the front end. Remaining filters will be hidden on the page.

Product sorting on the default SEO-filter page - defines the product sorting that will be displayed when the filter page loads. It can be inherited from the category or set individually.

HTTP response code on the SEO-filter page if there are no products - select the response in the HTTP headers of the page. This code is primarily useful for proper indexing of pages by search engine robots.

— Site – select the store site for which you want to save rules.

You can set templates for all store sites or for each one individually. If any store site has specific templates, they will override the settings of "Common template for all store sites". 

Site with specified individual templates is highlighted in red.

— Title – field for creating a template for the <title> tag.

— META Description – field for creating a template for the meta description tag.

— META Keywords – field for creating a template for the meta keywords tag.

— H1 header – field for creating a template for the <h1> header.

— Description – field for creating a template for the description.

In this settings section, you can create additional fields for store sites. This is necessary when multiple store sites are used and there are not enough variables for creating templates. The field appears when switching between store sites in the plugins settings.

In this settings section, you can create additional filter fields. This is necessary if variables other than the SEO-name need to be used.

Additional category description fields – this option includes an additional category description field (you need to add the field to the page template; insert the code {$category.additional_description|default:''} into category.html to display it)

Page number – this option places the page number in meta-tags starting from the second page (for categories).

{$seo_name} – SEO name of the feature value

The SEO name is specified for each feature in the settings of the plugins "SEO-filter".

{$value_name} – feature value name

{$value_names[n]} – name of the n-th feature

Replace n with id. Example of use in a theme: {$value_names[1]}

{$feature_name} – feature name

{$category.name} – category name

{$category.seo_name} – category SEO name

Displays the "SEO-name" of the category, which is generated by the "SEO-optimization" plugin.

{$root_category.name} – main category name

Displays the feature name specified in the site administration.

{$parent_category.name} – parent category name

{$parent_categories_names|sep:' '} – page path with space separator

{$filter.products_count} – number of products

{$store_info.name} – store name

{$store_info.phone} – store phone number

Click the "Add field" button

Enter the field name

Save changes. The variable appears in the list of variables.

Now it can be used in the shared theme.

The variable value should be set in the site's Settings.

Go to the "SEO-filter" tab. Click the "Add filter" button.

Check "Enabled" if the option is not already selected.

Select the storefront. If you are using a single storefront or want to set properties for all storefronts, leave this set to "All".

If you want to selectively specify the Storefronts to which the rules should apply, you can select these storefronts by choosing the "Only for" option, or exclude storefronts by choosing the "For all except" option.

Specify the categories for which you want to add filters. As with storefronts, there are two options:

• Only for;
• For all except.

Add feature values.

You can add multiple values.

Edit the "SEO Name" field value. By default, feature values are entered here.

Edit the URL if necessary.

Add custom filtering rules if needed.

Plugin "SEO-filter" allows flexible customization of filter results optimization.

For each filter, you can set several personal value rule options. For example, you may need to set a personal value for all categories and storefronts because the general theme is not suitable, and for one specific category, you need to set meta tag settings.

In the plugins settings, create themes:

Example 1. You need to create 1 feature for the Apple brand so that in every category, when Apple is selected, the brand appears in the title, description, <h1>, and description, and parameters in the link are changed to "Human-readable URL".

Copy the templates to the feature:

Go to the category page (where settings are now located):

If you select "Apple", "Title" and <h1> will be generated according to the theme.

Title, Keywords, and Description have also changed:

Description has changed:

Example 2. You need to add a filter for two values - Apple and Sennheiser.

Enter characteristic templates and save the result. The following image appears in the storefront:

Example 3. For the Apple feature, you need to write a different "Title" that starts with the word "Buy".

Edit the template for the Apple feature. Open the form for personal rules and fill in the "META Title" field (since a personal rule is needed only for "Title"):

Save the personal rule and filter options.

On the page it will look like this:

But if you select other added filters, general themes will be applied:

Example 4. In all categories, when the Apple feature is selected, the title should appear as in Example 3. But for the "Smartphones" category, the "Title" and <h1> should include the additional name "iPhone".

Go to the «SEO-filter» tab.

Open the filter settings for editing. An individual rule has already been set that applies to all categories. Add another one for the "Smartphones" category:

In the "Smartphones" category, Title and <h1> will be formed according to the individual theme:

In other categories, everything will remain unchanged:

Click the "Bulk filter creation" button. A filter generation window will open.

Available options:

• Select categories for which filters should or should not be generated;
• Select characteristics for which you want to generate filters (including any combinations);
• You can set personal tags (title, description, keywords), H1 title, and description;
• View submission history;
• Ability to remove generated filters.

Example: generating filters by one characteristic for all categories

Open the "Bulk filter creation" window.

Select a characteristic.

Here you can customize the filter SEO name and URL. Leaving fields empty will result in automatic data population.

Click the "Create" button.

Result:

Example: generating filters by two characteristics for all categories

Select two characteristics.

Click the "Create" button.

Result:

Example: generating filters by two characteristics for a specific category

Specify the categories for which you want to generate filters.

Select two characteristics. Click the "Create" button.

Result:

Example: generating filters by one characteristic with personal tags specified

Select a characteristic.

Save personal templates.

Click the "Create" button.

Result in the admin panel:

Result on the page before selecting characteristics:

Result on the page after selecting a characteristic

In the source code:

Search by name / Search by URL

Enter the search phrase.

Plugin will filter the results.

Filtering by characteristic

Select the characteristic to filter by.

Plugin will filter the results.

Filtering by number of feature values

Select the number of feature values added to filters. For example, you want to filter only those features to which 1 value has been added. Plugin will filter the results.

Enable / Disable / Delete filters

Select the features you want to perform these actions on.

Enable, disable or delete the selected filters.

Result:

* Configuration instructions for plugins "Brands with pictures and descriptions".

Insert the code {shop_seofilter_productbrands_hook} at the very beginning of the output template on the brand store page: search results in plugins settings "Brands":

To make the functionality work, changes must be made in the project theme. Go to the product.html template (Shop -> Site -> Templates -> product.html).

Find the code for displaying features; it may look like this:

Replace $product.features with shopSeofilterViewHelper::wrapFeatureValues($product.features).