Umbraco-CMS/src/Umbraco.Core/Models/IContent.cs

using System;
using System.Collections.Generic;

namespace Umbraco.Cms.Core.Models
{

    /// <summary>
    /// Represents a document.
    /// </summary>
    /// <remarks>
    /// <para>A document can be published, rendered by a template.</para>
    /// </remarks>
    public interface IContent : IContentBase
    {
        /// <summary>
        /// Gets or sets the content schedule
        /// </summary>
        ContentScheduleCollection ContentSchedule { get; set; }

        /// <summary>
        /// Gets or sets the template id used to render the content.
        /// </summary>
        int? TemplateId { get; set; }

        /// <summary>
        /// Gets a value indicating whether the content is published.
        /// </summary>
        /// <remarks>The <see cref="PublishedVersionId"/> property tells you which version of the content is currently published.</remarks>
        bool Published { get; set; }

        PublishedState PublishedState { get; set; }

        /// <summary>
        /// Gets a value indicating whether the content has been edited.
        /// </summary>
        /// <remarks>Will return `true` once unpublished edits have been made after the version with <see cref="PublishedVersionId"/> has been published.</remarks>
        bool Edited { get; set; }

        /// <summary>
        /// Gets the version identifier for the currently published version of the content.
        /// </summary>
        int PublishedVersionId { get; set; }

        /// <summary>
        /// Gets a value indicating whether the content item is a blueprint.
        /// </summary>
        bool Blueprint { get; set; }

        /// <summary>
        /// Gets the template id used to render the published version of the content.
        /// </summary>
        /// <remarks>When editing the content, the template can change, but this will not until the content is published.</remarks>
        int? PublishTemplateId { get; set; }

        /// <summary>
        /// Gets the name of the published version of the content.
        /// </summary>
        /// <remarks>When editing the content, the name can change, but this will not until the content is published.</remarks>
        string PublishName { get; set; }

        /// <summary>
        /// Gets the identifier of the user who published the content.
        /// </summary>
        int? PublisherId { get; set; }

        /// <summary>
        /// Gets the date and time the content was published.
        /// </summary>
        DateTime? PublishDate { get; set; }

        /// <summary>
        /// Gets a value indicating whether a culture is published.
        /// </summary>
        /// <remarks>
        /// <para>A culture becomes published whenever values for this culture are published,
        /// and the content published name for this culture is non-null. It becomes non-published
        /// whenever values for this culture are unpublished.</para>
        /// <para>A culture becomes published as soon as PublishCulture has been invoked,
        /// even though the document might not have been saved yet (and can have no identity).</para>
        /// <para>Does not support the '*' wildcard (returns false).</para>
        /// </remarks>
        bool IsCulturePublished(string culture);

        /// <summary>
        /// Gets the date a culture was published.
        /// </summary>
        DateTime? GetPublishDate(string culture);

        /// <summary>
        /// Gets a value indicated whether a given culture is edited.
        /// </summary>
        /// <remarks>
        /// <para>A culture is edited when it is available, and not published or published but
        /// with changes.</para>
        /// <para>A culture can be edited even though the document might now have been saved yet (and can have no identity).</para>
        /// <para>Does not support the '*' wildcard (returns false).</para>
        /// </remarks>
        bool IsCultureEdited(string culture);

        /// <summary>
        /// Gets the name of the published version of the content for a given culture.
        /// </summary>
        /// <remarks>
        /// <para>When editing the content, the name can change, but this will not until the content is published.</para>
        /// <para>When <paramref name="culture"/> is <c>null</c>, gets the invariant
        /// language, which is the value of the <see cref="PublishName"/> property.</para>
        /// </remarks>
        string GetPublishName(string culture);

        /// <summary>
        /// Gets the published culture infos of the content.
        /// </summary>
        /// <remarks>
        /// <para>Because a dictionary key cannot be <c>null</c> this cannot get the invariant
        /// name, which must be get via the <see cref="PublishName"/> property.</para>
        /// </remarks>
        ContentCultureInfosCollection PublishCultureInfos { get; set; }

        /// <summary>
        /// Gets the published cultures.
        /// </summary>
        IEnumerable<string> PublishedCultures { get; }

        /// <summary>
        /// Gets the edited cultures.
        /// </summary>
        IEnumerable<string> EditedCultures { get; set; }

        /// <summary>
        /// Creates a deep clone of the current entity with its identity/alias and it's property identities reset
        /// </summary>
        /// <returns></returns>
        IContent DeepCloneWithResetIdentities();

    }
}