using Microsoft.AspNetCore.Authorization;
using Microsoft.AspNetCore.Mvc;
using Umbraco.Cms.Core;
using Umbraco.Cms.Core.Models;
using Umbraco.Cms.Core.Services;
using Umbraco.Cms.Web.BackOffice.ModelBinders;
using Umbraco.Cms.Web.Common.Attributes;
using Umbraco.Cms.Web.Common.Authorization;
namespace Umbraco.Cms.Web.BackOffice.Controllers;
[PluginController(Constants.Web.Mvc.BackOfficeApiArea)]
[Authorize(Policy = AuthorizationPolicies.SectionAccessContentOrMedia)]
public class TrackedReferencesController : BackOfficeNotificationsController
{
private readonly ITrackedReferencesService _relationService;
public TrackedReferencesController(ITrackedReferencesService relationService) => _relationService = relationService;
///
/// Gets a page list of tracked references for the current item, so you can see where an item is being used.
///
///
/// Used by info tabs on content, media etc. and for the delete and unpublish of single items.
/// This is basically finding parents of relations.
///
public ActionResult> GetPagedReferences(int id, int pageNumber = 1, int pageSize = 100,
bool filterMustBeIsDependency = false)
{
if (pageNumber <= 0 || pageSize <= 0)
{
return BadRequest("Both pageNumber and pageSize must be greater than zero");
}
return _relationService.GetPagedRelationsForItem(id, pageNumber - 1, pageSize, filterMustBeIsDependency);
}
///
/// Gets a page list of the child nodes of the current item used in any kind of relation.
///
///
/// Used when deleting and unpublishing a single item to check if this item has any descending items that are in any
/// kind of relation.
/// This is basically finding the descending items which are children in relations.
///
public ActionResult> GetPagedDescendantsInReferences(int parentId, int pageNumber = 1,
int pageSize = 100, bool filterMustBeIsDependency = true)
{
if (pageNumber <= 0 || pageSize <= 0)
{
return BadRequest("Both pageNumber and pageSize must be greater than zero");
}
return _relationService.GetPagedDescendantsInReferences(parentId, pageNumber - 1, pageSize,
filterMustBeIsDependency);
}
///
/// Gets a page list of the items used in any kind of relation from selected integer ids.
///
///
/// Used when bulk deleting content/media and bulk unpublishing content (delete and unpublish on List view).
/// This is basically finding children of relations.
///
[HttpGet]
[HttpPost]
public ActionResult> GetPagedReferencedItems([FromJsonPath] int[] ids, int pageNumber = 1,
int pageSize = 100, bool filterMustBeIsDependency = true)
{
if (pageNumber <= 0 || pageSize <= 0)
{
return BadRequest("Both pageNumber and pageSize must be greater than zero");
}
return _relationService.GetPagedItemsWithRelations(ids, pageNumber - 1, pageSize, filterMustBeIsDependency);
}
}