< Summary - Jellyfin

Information
Class: Jellyfin.Api.Controllers.DashboardController
Assembly: Jellyfin.Api
File(s): /srv/git/jellyfin/Jellyfin.Api/Controllers/DashboardController.cs
Line coverage
100%
Covered lines: 25
Uncovered lines: 0
Coverable lines: 25
Total lines: 116
Line coverage: 100%
Branch coverage
100%
Covered branches: 8
Total branches: 8
Branch coverage: 100%
Method coverage

Feature is only available for sponsors

Upgrade to PRO version

Coverage history

Coverage history 0 25 50 75 100 2/13/2026 - 12:11:21 AM Line coverage: 100% (25/25) Branch coverage: 100% (8/8) Total lines: 1155/13/2026 - 12:15:27 AM Line coverage: 100% (25/25) Branch coverage: 100% (8/8) Total lines: 116 2/13/2026 - 12:11:21 AM Line coverage: 100% (25/25) Branch coverage: 100% (8/8) Total lines: 1155/13/2026 - 12:15:27 AM Line coverage: 100% (25/25) Branch coverage: 100% (8/8) Total lines: 116

Coverage delta

Coverage delta 1 -1

Metrics

MethodBranch coverage Crap Score Cyclomatic complexity Line coverage
.ctor(...)100%11100%
GetConfigurationPages(...)100%22100%
GetDashboardConfigurationPage(...)100%44100%
GetConfigPages(...)100%11100%
GetPluginPages(...)100%22100%
GetPluginPages()100%11100%

File(s)

/srv/git/jellyfin/Jellyfin.Api/Controllers/DashboardController.cs

#LineLine coverage
 1using System;
 2using System.Collections.Generic;
 3using System.IO;
 4using System.Linq;
 5using System.Net.Mime;
 6using Jellyfin.Api.Attributes;
 7using Jellyfin.Api.Models;
 8using MediaBrowser.Common.Api;
 9using MediaBrowser.Common.Plugins;
 10using MediaBrowser.Model.Net;
 11using MediaBrowser.Model.Plugins;
 12using Microsoft.AspNetCore.Authorization;
 13using Microsoft.AspNetCore.Http;
 14using Microsoft.AspNetCore.Mvc;
 15using Microsoft.Extensions.Logging;
 16
 17namespace Jellyfin.Api.Controllers;
 18
 19/// <summary>
 20/// The dashboard controller.
 21/// </summary>
 22[Route("")]
 23[Tags("Plugin")]
 24public class DashboardController : BaseJellyfinApiController
 25{
 26    private readonly ILogger<DashboardController> _logger;
 27    private readonly IPluginManager _pluginManager;
 28
 29    /// <summary>
 30    /// Initializes a new instance of the <see cref="DashboardController"/> class.
 31    /// </summary>
 32    /// <param name="logger">Instance of <see cref="ILogger{DashboardController}"/> interface.</param>
 33    /// <param name="pluginManager">Instance of <see cref="IPluginManager"/> interface.</param>
 534    public DashboardController(
 535        ILogger<DashboardController> logger,
 536        IPluginManager pluginManager)
 37    {
 538        _logger = logger;
 539        _pluginManager = pluginManager;
 540    }
 41
 42    /// <summary>
 43    /// Gets the configuration pages.
 44    /// </summary>
 45    /// <param name="enableInMainMenu">Whether to enable in the main menu.</param>
 46    /// <response code="200">ConfigurationPages returned.</response>
 47    /// <response code="404">Server still loading.</response>
 48    /// <returns>An <see cref="IEnumerable{ConfigurationPageInfo}"/> with infos about the plugins.</returns>
 49    [HttpGet("web/ConfigurationPages")]
 50    [Authorize(Policy = Policies.RequiresElevation)]
 51    [ProducesResponseType(StatusCodes.Status200OK)]
 52    [ProducesResponseType(StatusCodes.Status404NotFound)]
 53    public ActionResult<IEnumerable<ConfigurationPageInfo>> GetConfigurationPages(
 54        [FromQuery] bool? enableInMainMenu)
 55    {
 256        var configPages = _pluginManager.Plugins.SelectMany(GetConfigPages).ToList();
 57
 258        if (enableInMainMenu.HasValue)
 59        {
 160            configPages = configPages.Where(p => p.EnableInMainMenu == enableInMainMenu.Value).ToList();
 61        }
 62
 263        return configPages;
 64    }
 65
 66    /// <summary>
 67    /// Gets a dashboard configuration page.
 68    /// </summary>
 69    /// <param name="name">The name of the page.</param>
 70    /// <response code="200">ConfigurationPage returned.</response>
 71    /// <response code="404">Plugin configuration page not found.</response>
 72    /// <returns>The configuration page.</returns>
 73    [HttpGet("web/ConfigurationPage")]
 74    [ProducesResponseType(StatusCodes.Status200OK)]
 75    [ProducesResponseType(StatusCodes.Status404NotFound)]
 76    [ProducesFile(MediaTypeNames.Text.Html, "application/x-javascript")]
 77    public ActionResult GetDashboardConfigurationPage([FromQuery] string? name)
 78    {
 379        var altPage = GetPluginPages().FirstOrDefault(p => string.Equals(p.Item1.Name, name, StringComparison.OrdinalIgn
 380        if (altPage is null)
 81        {
 182            return NotFound();
 83        }
 84
 285        IPlugin plugin = altPage.Item2;
 286        string resourcePath = altPage.Item1.EmbeddedResourcePath;
 287        Stream? stream = plugin.GetType().Assembly.GetManifestResourceStream(resourcePath);
 288        if (stream is null)
 89        {
 190            _logger.LogError("Failed to get resource {Resource} from plugin {Plugin}", resourcePath, plugin.Name);
 191            return NotFound();
 92        }
 93
 194        return File(stream, MimeTypes.GetMimeType(resourcePath));
 95    }
 96
 97    private IEnumerable<ConfigurationPageInfo> GetConfigPages(LocalPlugin plugin)
 98    {
 1699        return GetPluginPages(plugin).Select(i => new ConfigurationPageInfo(plugin.Instance, i.Item1));
 100    }
 101
 102    private IEnumerable<Tuple<PluginPageInfo, IPlugin>> GetPluginPages(LocalPlugin plugin)
 103    {
 38104        if (plugin.Instance is not IHasWebPages hasWebPages)
 105        {
 3106            return Enumerable.Empty<Tuple<PluginPageInfo, IPlugin>>();
 107        }
 108
 35109        return hasWebPages.GetPages().Select(i => new Tuple<PluginPageInfo, IPlugin>(i, plugin.Instance));
 110    }
 111
 112    private IEnumerable<Tuple<PluginPageInfo, IPlugin>> GetPluginPages()
 113    {
 3114        return _pluginManager.Plugins.SelectMany(GetPluginPages);
 115    }
 116}