Ecreo.Essentials.FrontpageUrl

Ecreo.Essentials.FrontpageUrl er en Umbraco URL provider til setups, hvor en site-node indeholder generelle indstillinger, og en underside vælges som egentlig forside.

Når forsiden vælges via en content picker på site-noden, sørger URL provideren for, at links til forsiden genereres som roden af sitet (/) i stedet for forsidens egen underside-URL.

Installation

Installer pakken i dit Umbraco-projekt:

dotnet add package Ecreo.Essentials.FrontpageUrl

Pakken registrerer sine services via en Umbraco composer, så den kræver normalt ikke ændringer i Program.cs.

Konfiguration

Pakken læser konfiguration fra Ecreo:Essentials:FrontpageUrl:

{
  "Ecreo": {
    "Essentials": {
      "FrontpageUrl": {
        "Enabled": true,
        "SiteContentTypeAliases": ["site", "siteNode"],
        "FrontpagePropertyAlias": "umbracoInternalRedirectId"
      }
    }
  }
}

Options

Option	Standard	Beskrivelse
Enabled	true	Slår URL provideren til/fra.
SiteContentTypeAliases	["site", "siteNode"]	Dokumenttypealiaser der behandles som site-noder.
FrontpagePropertyAlias	umbracoInternalRedirectId	Property alias på site-noden, der peger på forsiden.
CacheKey	Ecreo.Essentials.FrontpageUrl.FrontpageIds	Cache key til interne frontpage opslag.

SiteContentTypeAlias findes stadig i options, men er markeret obsolete. Brug SiteContentTypeAliases.

Hvis picker-værdien mangler, bruges første child med template som forside.

Opslaget understøtter fallback til language og default language.

Multi-site

Tilføj alle site-node aliases i SiteContentTypeAliases.

{
  "Ecreo": {
    "Essentials": {
      "FrontpageUrl": {
        "SiteContentTypeAliases": ["site", "campaignSite"],
        "FrontpagePropertyAlias": "frontpage"
      }
    }
  }
}

FrontpageUrlHelper

FrontpageUrlHelper registreres som singleton og kan injectes, hvis projektkode skal afgøre om en node er valgt som forside:

var isFrontpage = frontpageUrlHelper.IsFrontpage(content.Key, culture);

Cache over valgte forsider nulstilles, når en site-node publiceres.

Appsettings schema

Pakken leverer et JSON schema til IntelliSense. Se opsætning og konfigurationssektioner.