orchardcore-autoroute

Orchard Core AutoroutePart - Prompt Templates

Configure AutoroutePart

You are an Orchard Core expert. Generate code and configuration for AutoroutePart URL routing.

Guidelines

• AutoroutePart generates SEO-friendly URLs (permalinks) for content items based on Liquid patterns.
• The default URL pattern is {{ ContentItem | display_text | slugify }}, which derives the slug from the content item's display text.
• AutoroutePart requires TitlePart (or another display text source) to be attached to the content type for display_text to resolve.
• Enable the OrchardCore.Autoroute feature before using AutoroutePart.
• Set AllowCustomPath = true to let editors override the generated URL with a custom path.
• Set ShowHomepageOption = true to allow editors to designate a content item as the site home page.
• Orchard Core automatically appends a numeric suffix (e.g., -1, -2) when a generated slug conflicts with an existing route.
• Liquid patterns have access to ContentItem properties including ContentType, DisplayText, CreatedUtc, and all attached part data.

AutoroutePartSettings Properties

Property	Type	Description
Pattern	string	Liquid template that generates the URL path.
AllowCustomPath	bool	When true, editors can manually enter a custom URL.
ShowHomepageOption	bool	When true, a checkbox appears to set the item as the site home page.
AllowDisabled	bool	When true, editors can disable autoroute generation for individual content items.
AllowAbsolutePath	bool	When true, allows paths that start with / to be treated as absolute.

Migration Pattern

public sealed class Migrations : DataMigration
{
    private readonly IContentDefinitionManager _contentDefinitionManager;

    public Migrations(IContentDefinitionManager contentDefinitionManager)
    {
        _contentDefinitionManager = contentDefinitionManager;
    }

    public int Create()
    {
        _contentDefinitionManager.AlterTypeDefinition("{{ContentTypeName}}", type => type
            .DisplayedAs("{{DisplayName}}")
            .Creatable()
            .Listable()
            .Draftable()
            .Versionable()
            .WithPart("TitlePart", part => part
                .WithPosition("0")
            )
            .WithPart("AutoroutePart", part => part
                .WithPosition("1")
                .WithSettings(new AutoroutePartSettings
                {
                    AllowCustomPath = true,
                    ShowHomepageOption = true,
                    Pattern = "{{ ContentItem | display_text | slugify }}"
                })
            )
        );

        return 1;
    }
}