Skip to content

Admin (OrchardCore.Admin)

The Admin module provides an admin dashboard for your site.

Custom Admin prefix

If you want to specify another prefix in the urls to access the admin section, you can change it by using this option in the appsettings.json:

  "OrchardCore": {
    "OrchardCore_Admin": {
      "AdminUrlPrefix": "YourCustomAdminUrl"
      }
    }

Customize Admin branding

By default, OrchardCore logo and site name are displayed in the top navbar.

You can change it by overriding 'AdminBranding' shape, either from a custom admin theme or using Admin Templates feature.
You can also use this shape to define admin favicon.

Here are samples using logo and favicon from media module.

{% assign favicon_url = 'favicon.ico' | asset_url %}
{% zone "HeadMeta" %}
    {% link rel:'shortcut icon', type:'image/x-icon', src:favicon_url %}
{% endzone %}
{% a area: 'OrchardCore.Admin', controller: 'Admin' , action: 'Index', class: 'ta-navbar-brand' %}
    <div class="d-flex align-items-center">
        <img src="{{ 'logo.png' | asset_url }}" alt="{{ Site.SiteName }}" class="pe-2" />
        <span>{{ Site.SiteName }}</span>
    </div>
{% enda %}

<zone name="HeadMeta">
    <link asp-src="~/media/favicon.ico" type="image/x-icon" rel="shortcut icon" />
</zone>
<a class="ta-navbar-brand" asp-route-area="OrchardCore.Admin" asp-controller="Admin" asp-action="Index">
    <div class="d-flex align-items-center">
        <img src=@Url.Content("~/media/logo.png") alt="@Site.SiteName" class="pe-2" />
        <span>@Site.SiteName</span>
    </div>
</a>

The navigation bar shape is available in two display types Detail for the frontend and DetailAdmin for the backend admin. If you wish to add a menu item to the navigation bar, simply create a display driver for Navbar.

As an illustration, we inject the Visit Site link into DetailAdmin display type using a display driver as outlined below:

public class VisitSiteNavbarDisplayDriver : DisplayDriver<Navbar>
{
    public override IDisplayResult Display(Navbar model)
    {
        return View("VisitSiteNavbarItem", model)
            .Location("DetailAdmin", "Content:20");
    }
}

You can change it by overriding 'VisitSiteNavbarItem' shape, either from a custom admin theme or using Admin Templates feature. 

<li class="nav-item">
    <a href="{{ '~' | absolute_url }}" class="nav-link" data-bs-toggle="tooltip" data-bs-placement="bottom" title="{{ "Visit Site" | t }}" role="button">
        <i class="fa-solid fa-fw fa-external-link" aria-hidden="true"></i>
    </a>
</li>

<li class="nav-item">
    <a href="@Url.Content("~/")" class="nav-link" data-bs-toggle="tooltip" data-bs-placement="bottom" title="@T["Visit Site"]" role="button">
        <i class="fa-solid fa-fw fa-external-link" aria-hidden="true"></i>
    </a>
</li>