SEO.Sitemaps
- Master
- Develop
Search engine sitemaps.xml for EPiServer CMS 11 and Commerce 13
Description
This tool allows you to generate xml sitemaps for search engines to better index your EPiServer sites. Although there are several EPiServer sitemap tools available like SearchEngineSitemaps and EPiSiteMap which have inspired this project this tool gives you some additional specific features.
Features
- sitemap generation as a scheduled job
- filtering pages by virtual directories
- ability to include pages that are in a different branch than the one of the start page
- ability to generate sitemaps for mobile pages
- it also supports multi-site and multi-language environments
See the editor guide for more information.
Latest release
The latest version is available on the EPiServer NuGet feed. You can find it by searching the term Geta.SEO.Sitemaps.
Download
From nuget.episerver.com feed.
How to get started?
- Install Sitemap plugin via NuGet in Visual Studio. Ensure that you also install the required dependencies.
Install-Package Geta.SEO.Sitemaps
Install-Package Geta.SEO.Sitemaps.Commerce
- Rebuild your solution.
- Configure sitemap settings and schedule the sitemap generation process. Configuration available at CMS -> Admin Mode -> Search engine sitemap settings. See the editor guide
Enabling multi language support
Add this to your web.config file:
<configuration>
<configSections>
<section name="Geta.SEO.Sitemaps" type="Geta.SEO.Sitemaps.Configuration.SitemapConfigurationSection, Geta.SEO.Sitemaps"/>
</configSections>
<Geta.SEO.Sitemaps>
<settings enableLanguageDropDownInAdmin="true" />
</Geta.SEO.Sitemaps>
</configuration>Dynamic property for specific pages
You can specify page specific sitemap properties (like change frequency, priority or include/disinclude the specific page in any sitemap) for each EPiServer page by defining a dynamic property with type SEOSitemaps (and the same name):
and specify values for the dynamic property:
Adding Sitemap Properties to all content pages
Credits to jarihaa for contributing this.
[UIHint("SeoSitemap")]
[BackingType(typeof(PropertySEOSitemaps))]
public virtual string SEOSitemaps { get; set; }
Set default value
public override void SetDefaultValues(ContentType contentType)
{
base.SetDefaultValues(contentType);
var sitemap = new PropertySEOSitemaps
{
Enabled = false
};
sitemap.Serialize();
this.SEOSitemaps = sitemap.ToString();
}
Ignore page types
Implement the IExcludeFromSitemap interface to ignore page types in the sitemap.
public class OrderConfirmationPage : PageData, IExcludeFromSitemap
Exclude content
If you need more control to exclude content from the sitemap you can make your own implementation of IContentFilter. Make sure to inherit from ContentFilter and call the ShouldExcludeContent method of the base class.
public class SiteContentFilter : ContentFilter
{
public override bool ShouldExcludeContent(IContent content)
{
if (base.ShouldExcludeContent(content))
{
return true;
}
// Custom logic here
return false;
}
}
Register in your DI container.
services.AddTransient<IContentFilter, SiteContentFilter>();
Limitations
- Each sitemap will contain max 50k entries (according to sitemaps.org protocol) so if the site in which you are using this plugin contains more active pages then you should split them over multiple sitemaps (by specifying a different root page or include/avoid paths for each).
Local development setup
See description in shared repository regarding how to setup local development environment.
Docker hostnames
Instead of using the static IP addresses the following hostnames can be used out-of-the-box.
QuickSilver login
Use the default [email protected] user for QuickSilver, see Installation.
Contributing
See CONTRIBUTING.md
Package maintainer
https://github.com/frederikvig