This plugin allows to create SEO meta content for multi-lingual websites.
It also generates a multi-lingual sitemap.xml file based on desired CMS pages and others.
CMS pages, Static pages and Rainlab Blog Posts and Category pages are supported out of the box. Custom models can be easily extended. Sitemap functionality is forked from Rainlab Sitemap plugin.
Using the multilanguage SEO component
After adding the component to your layout you need to create the metas for each page.
It supports mapping of model data (using an event) so you can use your current data for SEO purposes without having to enter it again for each page.
You can import and export SEO data to CSV.
Sitemap generator
This plugin will generate a sitemap.xml file based on desired CMS pages and others. The generated sitemap follows Google guidelines for multi-lingual sitemaps.
Viewing the sitemap
Once this plugin the sitemap has been configured, it can be viewed by accessing the file relative to the website base path. For example, if the website is hosted at http://example.com it can be viewed by opening this URL:
http://example.com/sitemap.xml
You should add this url to your robots.txt file.
Managing a sitemap definition
The sitemap is managed by selecting Sitemap from the Seo plugin menu. There is a single sitemap definition for each theme and it will be created automatically.
A sitemap definition can contain multiple items and each item has a number of properties. There are common properties for all item types, and some properties depend on the item type. The common item properties are Priority and Change frequency. The Priority defines the priority of this item relative to other items in the sitemap. The Change frequency defines how frequently the page is likely to change. Depending on the selected item type you might need to provide other properties of the item. The available properties are described below.
Reference
A drop-down list of objects the item should refer to. The list content depends on the item type. For the Static page item type the list displays all static pages defined in the system. For the Blog category item type the list displays a list of blog categories.
CMS Page
This drop-down is available for item types that require a special CMS page to refer to. For example, the Blog category item type requires a CMS page that hosts the blogPosts component. The CMS Page drop-down for this item type will only display pages that include this component.
Standard item types
The available item types depend on the installed plugins, but there are some basic item types that are supported out of the box.
URL
Items of this type are links to a specific fixed URL. That could be an URL of an or internal page. Items of this type don't have any other properties - just the title and URL.
CMS page
Items of this type refer to CMS pages. The page should be selected in the Reference drop-down list described below.
Custom item types
Other plugins can supply new item types. Some are supported out of the box:
Rainlab Pages plugin
This plugin supplies two new item types:
Static page
Items of this type refer to static pages. The static page should be selected in the Reference drop-down.
All static pages
Items of this type expand to create links to all static pages defined in the theme.
Rainlab Blog plugin
This plugin supplies four new item types:
Blog category
An item of this type represents a link to a specific blog category. The category should be selected in the Reference drop-down. This type also requires selecting a CMS page that outputs a blog category.
All blog categories
An item of this type expands into multiple items representing all blog existing categories. This type also requires selecting a CMS page.
Blog post
An item of this type represents a link to a specific blog post. The post should be selected in the Reference drop-down. This type also requires selecting a CMS page that outputs a blog post.
All blog posts
An item of this type expands into multiple items representing all blog existing posts. This type also requires selecting a CMS page.
Registering new sitemap definition item types
The Sitemap plugin shares the same events for registering item types as the Pages plugin. See the documentation provided by this plugin for more information.
Using the multilanguage SEO component
First you must place the Seo component in theme layout head section.
The component has two configurable properties called "prepend" and "append", if you fill them, the content will be prepended/appended to all pages titles. For example, if the page title is "Projects" and the append property is "| Site Name", the page title will show "Projects | Site Name".
description = "Default layout" [localePicker] forceUrl = 1 ... [seo] append = "| Site Name" == <!DOCTYPE html> ...
Then you should create a SEO register for every page in your theme. Fill the title, description, (optional) keywords and (optional) image in each language.
Finally, show the metas in your layout like this:
<title>{{ this.page.meta_title }}</title>
<meta name="description" content="{{ this.page.meta_description }}" />
<meta name="keywords" content="{{ this.page.meta_keywords }}" />
<meta name="title" content="{{ this.page.meta_title }}" />
<meta property="og:title" content="{{ this.page.meta_title }}" />
<meta property="og:description" content="{{ this.page.meta_description }}" />
{% if this.page.seo_image %}
<meta property="og:image" content="{{ this.page.seo_image.getPath() }}" />
{% endif %}
Support for static pages plugin
If you use Rainlab.Pages plugin, you can also create SEO data for this static pages. You will need to add the SEO component to the static layout.
Support for Blog plugin
Blog plugin Post and Category pages are automatically supported. After installing the Blog plugin and creating post and category pages, just select the types "Blog Post" or "Blog Category" from the Type dropdown, then select one of the pages and fill the data.
Support for custom models
You can create SEO Data for your own models.
Your plugin has to listen to the following events that Rainlab.Pages uses to build dynamic menus:
pages.menuitem.listTypeevent handler should return a list of types of objects that can have SEO data attached.pages.menuitem.getTypeInfoevent handler returns all items for a type of object.
An example of this listeners (this code is simplified for this plugin purposes, more data needs to be returned for Rainlab.Pages menu to work):
public function boot()
{
Event::listen('pages.menuitem.listTypes', function() {
return [
'acme-post' => 'Post page',
];
});
Event::listen('pages.menuitem.getTypeInfo', function($type) {
if ($type == 'acme-post')
return YourModel::getMenuTypeInfo($type);
});
}
In YourModel the implementation might look like this (this code is simplified for this plugin purposes, more data needs to be returned for Rainlab.Pages menu to work):
public static function getMenuTypeInfo($type)
{
$result = [];
if ($type == 'acme-post') {
$references = [];
$posts = self::get();
foreach ($posts as $post) {
$references[$post->id] = $post->title;
}
$result = [
'references' => $references
];
}
return $result;
}
To see your model SEO on the frontend, you will need to use the component SeoModel in your page:
[seoModel] pageType='acme-post' pageProperty='post'
The property pageType should be the same YourModel property $seoPageType
The property pageProperty tells the plugin in which page property can find your model. It's usually filled by a component on the onRun method:
public function onRun()
{
$slug = $this->param('slug');
$post = new YourModel;
$post = YourModel::where('slug', $slug)->first();
$this->page['post'] = $post;
}
If you already use some fields in your model for SEO purposes, you can map them listening to utopigs.seo.mapSeoData event:
Event::listen('utopigs.seo.mapSeoData', function($type, $reference) {
if ($type == 'acme-post') {
return YourModel::mapSeoData($reference);
}
});
In YourModel, one possible implementation might look like this:
public static function mapSeoData($reference)
{
$item = self::find($reference);
$seo_data = [
'title' => $item->title,
'description' => str_limit(strip_tags($item->description), 155),
'image' => $item->image,
];
return $seo_data;
}
Extending your own models
A SEO tab with easier access to SEO data creation can be attached to your model. You need to implement the Seo Model Behavior in your model class:
class Post
{
public $implement = ['Utopigs.Seo.Behaviors.SeoModel'];
//required: menu item type that your plugin expects in pages.menuitem.getTypeInfo event
public $seoPageType = 'acme-post';
//optional: where to put the SEO tab, default is 'primary'
public $seoTab = 'secondary';
}
This code will insert a new tab in your models for previewing, creating or editing the SEO data.
Sitemap generator
This plugin will generate a sitemap.xml file based on desired CMS pages and others. The generated sitemap follows Google guidelines for multi-lingual sitemaps.
Viewing the sitemap
Once this plugin the sitemap has been configured, it can be viewed by accessing the file relative to the website base path. For example, if the website is hosted at http://example.com it can be viewed by opening this URL:
http://example.com/sitemap.xml
You should add this url to your robots.txt file.
Managing a sitemap definition
The sitemap is managed by selecting Sitemap from the Seo plugin menu. There is a single sitemap definition for each theme and it will be created automatically.
A sitemap definition can contain multiple items and each item has a number of properties. There are common properties for all item types, and some properties depend on the item type. The common item properties are Priority and Change frequency. The Priority defines the priority of this item relative to other items in the sitemap. The Change frequency defines how frequently the page is likely to change. Depending on the selected item type you might need to provide other properties of the item. The available properties are described below.
Reference
A drop-down list of objects the item should refer to. The list content depends on the item type. For the Static page item type the list displays all static pages defined in the system. For the Blog category item type the list displays a list of blog categories.
CMS Page
This drop-down is available for item types that require a special CMS page to refer to. For example, the Blog category item type requires a CMS page that hosts the blogPosts component. The CMS Page drop-down for this item type will only display pages that include this component.
Standard item types
The available item types depend on the installed plugins, but there are some basic item types that are supported out of the box.
URL
Items of this type are links to a specific fixed URL. That could be an URL of an or internal page. Items of this type don't have any other properties - just the title and URL.
CMS page
Items of this type refer to CMS pages. The page should be selected in the Reference drop-down list described below.
Custom item types
Other plugins can supply new item types. Some are supported out of the box:
Rainlab Pages plugin
This plugin supplies two new item types:
Static page
Items of this type refer to static pages. The static page should be selected in the Reference drop-down.
All static pages
Items of this type expand to create links to all static pages defined in the theme.
Rainlab Blog plugin
This plugin supplies four new item types:
Blog category
An item of this type represents a link to a specific blog category. The category should be selected in the Reference drop-down. This type also requires selecting a CMS page that outputs a blog category.
All blog categories
An item of this type expands into multiple items representing all blog existing categories. This type also requires selecting a CMS page.
Blog post
An item of this type represents a link to a specific blog post. The post should be selected in the Reference drop-down. This type also requires selecting a CMS page that outputs a blog post.
All blog posts
An item of this type expands into multiple items representing all blog existing posts. This type also requires selecting a CMS page.
Registering new sitemap definition item types
The Sitemap plugin shares the same events for registering item types as the Pages plugin. See the documentation provided by this plugin for more information.
When resolving an item, via the pages.menuitem.resolveItem event handler, each item should return an extra key in the array called mtime. This should be a Date object (see Carbon\Carbon) or a timestamp value compatible with PHP's date() function and represent the last time the link was modified.
Each item should also append all alternate language (including the default language) urls in the array called alternate_locale_urls.
Expected result format:
Array (
[url] => http://example.com/en/blog/article/article-slug-in-english
[mtime] => '2018-12-01T14:08:09+00:00',
[alternate_locale_urls] => Array (
[en] => http://example.com/en/blog/article/article-slug-in-english
[en] => http://example.com/es/blog/articulo/article-slug-in-spanish
)
)
Example of how to do this in your own models (simplified):
protected static function resolveMenuItem($item, $url, $theme)
{
if ($item->type == 'acme-post') {
$post = self::find($item->reference);
$page = Page::loadCached($theme, $item->cmsPage);
$defaultLocale = \RainLab\Translate\Models\Locale::getDefault()->code;
$pageUrl = \Utopigs\Seo\Models\Sitemap::getPageLocaleUrl($page, $post, $defaultLocale, ['slug' => 'slug']);
$alternateLocales = array_keys(\RainLab\Translate\Models\Locale::listEnabled());
if (count($alternateLocales) > 1) {
foreach ($alternateLocales as $locale) {
$result['alternate_locale_urls'][$locale] = \Utopigs\Seo\Models\Sitemap::getPageLocaleUrl($page, $menuItem, $locale, ['slug' => 'slug']);
}
}
$result['title'] = $post->title;
$result['url'] = $pageUrl;
$result['mtime'] = $post->updated_at;
return $result;
}
return [$result];
}
-
Lucas Zamora
Found the plugin useful on 13 May, 2019
The required permits must be handled better, but well!
-
Utopig Studio, SCCL author
Replied on 13 May, 2019
You are welcome to make your suggestions
-
Fedor Headman
Found the plugin useful on 24 Feb, 2019
Nice plugin, especially for use with models
-
Gerald Schandl
Found the plugin useful on 23 Feb, 2019
This is a great plugin
-
| 1.1.20 |
Compatibility fixes for October v3.7 Oct 18, 2024 |
|---|---|
| 1.1.19 |
Fix bug with translations in october 3 Jul 28, 2024 |
| 1.1.18 |
Fix sitemap generation for october 3 Jun 30, 2024 |
| 1.1.17 |
Fix for external images (urls) Apr 03, 2024 |
| 1.1.16 |
getSeoPageType method to override fixed property dynamically Mar 18, 2024 |
| 1.1.15 |
Allow to remove the append or prepend text in the title of pages with SEO data Mar 14, 2024 |
| 1.1.14 |
Fixes in demo data import for October CMS 3.6 Mar 10, 2024 |
| 1.1.13 |
Fix bugs in October CMS v2 Mar 09, 2024 |
| 1.1.12 |
Fix sitemaps in October CMS v3 Jan 23, 2024 |
| 1.1.11 |
Compatibility with October CMS v3 Dec 04, 2023 |
| 1.1.10 |
Fix redirect on create and update SEO data May 23, 2022 |
| 1.1.9 |
Fixes saving in October CMS v2 Nov 03, 2021 |
| 1.1.8 |
Added Russian localization Sep 30, 2021 |
| 1.1.7 |
Add translations for catalan Dec 01, 2020 |
| 1.1.6 |
Try to retrieve image from defaults if not specified Jun 06, 2019 |
| 1.1.5 |
Fix bug with nested categories Jun 06, 2019 |
| 1.1.4 |
Fix bug model image not showing Jun 06, 2019 |
| 1.1.3 |
Add a sitemap-debug.xml that renders ok (using https protocol for the namespace attributes) to be able to debug sitemap issues visually May 09, 2019 |
| 1.1.2 |
Undo last change to fix Google Search Console sitemap fetch issues May 08, 2019 |
| 1.1.1 |
Fix browser render issue Mar 12, 2019 |
| 1.1.0 |
Add sitemap functionality Dec 29, 2018 |
| 1.0.2 |
Fix bug with elements with nested items Dec 15, 2018 |
| 1.0.1 |
First version of Utopigs Seo plugin Nov 21, 2018 |
This plugin is an upgrade of ML Seo plugin, which will be discontinued. An export funcion has been added to ML Seo, so you can export your data, install this plugin, import it with just a click, change the layout component and start using Utopigs Seo.