Merge pull request #16967 from Shadowghost/fix-recently-added-postersHEADmaster

Fix recently added episode links and posters

1 files changed, 51 insertions, 5 deletions

diff --git a/MediaBrowser.Controller/Dto/DtoOptions.cs b/MediaBrowser.Controller/Dto/DtoOptions.cs
index a71cdbd62c..d319feb6b2 100644
--- a/MediaBrowser.Controller/Dto/DtoOptions.cs
+++ b/MediaBrowser.Controller/Dto/DtoOptions.cs
@@ -1,5 +1,3 @@
-#pragma warning disable CS1591
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
@@ -8,13 +6,16 @@ using MediaBrowser.Model.Querying;
 
 namespace MediaBrowser.Controller.Dto
 {
+    /// <summary>
+    /// Options that control which fields and images are populated when building a <see cref="MediaBrowser.Model.Dto.BaseItemDto"/>.
+    /// </summary>
     public class DtoOptions
     {
-        private static readonly ItemFields[] DefaultExcludedFields = new[]
-        {
+        private static readonly ItemFields[] DefaultExcludedFields =
+        [
             ItemFields.SeasonUserData,
             ItemFields.RefreshState
-        };
+        ];
 
         private static readonly ImageType[] AllImageTypes = Enum.GetValues<ImageType>();
 
@@ -22,11 +23,18 @@ namespace MediaBrowser.Controller.Dto
             .Except(DefaultExcludedFields)
             .ToArray();
 
+        /// <summary>
+        /// Initializes a new instance of the <see cref="DtoOptions"/> class with all fields enabled.
+        /// </summary>
         public DtoOptions()
             : this(true)
         {
         }
 
+        /// <summary>
+        /// Initializes a new instance of the <see cref="DtoOptions"/> class.
+        /// </summary>
+        /// <param name="allFields">Whether to populate all available fields.</param>
         public DtoOptions(bool allFields)
         {
             ImageTypeLimit = int.MaxValue;
@@ -38,23 +46,61 @@ namespace MediaBrowser.Controller.Dto
             ImageTypes = AllImageTypes;
         }
 
+        /// <summary>
+        /// Gets or sets the fields to populate on the DTO.
+        /// </summary>
         public IReadOnlyList<ItemFields> Fields { get; set; }
 
+        /// <summary>
+        /// Gets or sets the image types to populate on the DTO.
+        /// </summary>
         public IReadOnlyList<ImageType> ImageTypes { get; set; }
 
+        /// <summary>
+        /// Gets or sets the maximum number of images to return per image type.
+        /// </summary>
         public int ImageTypeLimit { get; set; }
 
+        /// <summary>
+        /// Gets or sets a value indicating whether image information is populated.
+        /// </summary>
         public bool EnableImages { get; set; }
 
+        /// <summary>
+        /// Gets or sets a value indicating whether program recording information is populated.
+        /// </summary>
         public bool AddProgramRecordingInfo { get; set; }
 
+        /// <summary>
+        /// Gets or sets a value indicating whether user data is populated.
+        /// </summary>
         public bool EnableUserData { get; set; }
 
+        /// <summary>
+        /// Gets or sets a value indicating whether the currently airing program is populated.
+        /// </summary>
         public bool AddCurrentProgram { get; set; }
 
+        /// <summary>
+        /// Gets or sets a value indicating whether an episode's portrait poster (its season's primary
+        /// image, falling back to the series') should replace the episode's own (16:9) primary image.
+        /// Used by views that render episodes as poster cards, e.g. "Latest".
+        /// </summary>
+        public bool PreferEpisodeParentPoster { get; set; }
+
+        /// <summary>
+        /// Gets a value indicating whether the specified field is populated.
+        /// </summary>
+        /// <param name="field">The field to check.</param>
+        /// <returns><c>true</c> if the field is populated; otherwise, <c>false</c>.</returns>
         public bool ContainsField(ItemFields field)
             => Fields.Contains(field);
 
+        /// <summary>
+        /// Gets the number of images to return for the specified image type.
+        /// </summary>
+        /// <param name="type">The image type.</param>
+        /// <returns>The image limit for the type, or 0 if the type is not enabled.</returns>
         public int GetImageLimit(ImageType type)
         {
             if (EnableImages && ImageTypes.Contains(type))