limbo-works / limbo.umbraco.seo

SEO package for Umbraco.

Limbo SEO

Limbo SEO is a package for helping improving the SEO experience in the Umbraco backoffice. While still under development, the package currently includes:

Property Editors

• SEO Preview - eg. like the page will be shown on Google
• Sitemap Frequency Picker - let's editors set the sitemap update frequency of a given page
• Sitemap Page Priority - let's editors specify the page priority of a given page

Other

• Logic for easily building sitemaps - extendable via the ISitemapHelper interface and the SitemapHelper class
• More to come 😎

Installation

The Umbraco 10+ version of this package is only available via NuGet. To install the package, you can use either .NET CLI:

dotnet add package Limbo.Umbraco.Seo --version 3.0.0-beta001

or the older NuGet Package Manager:

Install-Package Limbo.Umbraco.Seo -Version 3.0.0-beta001

Umbraco 9
For the Umbraco 9 version of this package, see the v2/latest branch instead.

Umbraco 8
For the Umbraco 8 version of this package, see the v1/latest branch instead.

Screenshots

Usage

Sitemap

The package contains a WebAPI controller, which by default can be accessed at /umbraco/api/Sitemap/XmlSitemap. The controller outputs the XML sitemap for the site matching the inbound domain, or an error if the domain isn't recognized.

To make the sitemap appear at /sitemap.xml instead, you can add the following IIS rewrite rule:

<rule name="sitemap" stopProcessing="true" patternSyntax="ExactMatch">
  <match url="sitemap.xml" />
  <action type="Rewrite" url="/umbraco/api/sitemap/XmlSitemap" appendQueryString="false" redirectType="Found" statusCode="200" />
</rule>

Under the hood, the XML sitemap generation is handled by the ISitemapHelper interface. The default implementation of the interface is SitemapHelper, but implementation can be overridden using dependency injection.

limbo.umbraco.seo's Issues

Add support for robots.txt

DLL not installed

When I add Limbo SEO to a project (2.0.0-alpha001), the packages files are added but the DLL isn't, even after compilation. If I manually drop the DLL in everything starts working. Guessing there's something wrong with the NuPkg?

This is on Umbraco 9.

Allow configuring sitemap through appsettings.json

Sitemap errors if no hostname is set on root node

If no hostname is set on the root content node (so, most Umbraco instances that contain a single site), the sitemap errors as it insists on finding a root node with domain name matching the current URL (roughly -

Limbo.Umbraco.Seo/src/Limbo.Umbraco.Seo/Sitemaps/SitemapHelper.cs

Line 35 in f80d9ed

IDomain domain = _domainService

). Worse, the error is then suppressed by a try catch and a generic error message returned, nothing logged, so it's not obvious what went wrong.

At the very least this behaviour needs to be clearly documented, but it would be better if the sitemap returned the default site if no match is found by domain and any errors were properly logged (I notice per node errors are also discarded silently and only logged if the DLL is a debug build - guessing this is for performance reasons on large sites, but it's going to make trouble shooting a nightmare. Maybe needs to be configurable?).

Preview styling???

Hey @tnielsenskybruddk

I took the preview implementation from one of our client projects. There seems to be more styles than the view is actually using. Can you remember why?

https://github.com/limbo-works/Limbo.Umbraco.Seo/blob/d6cd30ff4da92f4802a387b1ce28cdc433dc25e2/src/Limbo.Umbraco.Seo/App_Plugins/Limbo.Seo/Styles/Styles.less