silverstripe-cms/code/Controllers/SilverStripeNavigatorItem_Unversioned.php

<?php

namespace SilverStripe\CMS\Controllers;

use SilverStripe\CMS\Controllers\SilverStripeNavigatorItem;
use SilverStripe\Core\Config\Config;
use SilverStripe\Core\Convert;
use SilverStripe\Dev\Deprecation;
use SilverStripe\ORM\CMSPreviewable;
use SilverStripe\Security\Member;
use SilverStripe\Versioned\Versioned;

/**
 * Class will be moved from `silverstripe/cms` to `silverstripe/admin`.
 * @deprecated 4.13.0 Will be renamed SilverStripe\Admin\Navigator\SilverStripeNavigatorItem_Unversioned
 */
class SilverStripeNavigatorItem_Unversioned extends SilverStripeNavigatorItem
{
    public function __construct(CMSPreviewable $record)
    {
        Deprecation::withNoReplacement(function () {
            Deprecation::notice(
                '4.13.0',
                'Will be renamed SilverStripe\Admin\Navigator\SilverStripeNavigatorItem_Unversioned',
                Deprecation::SCOPE_CLASS
            );
        });
        parent::__construct($record);
    }

    public function getHTML()
    {
        $recordLink = Convert::raw2att($this->getLink());
        $linkTitle = _t('SilverStripe\\CMS\\Controllers\\ContentController.UNVERSIONEDPREVIEW', 'Preview');
        return "<a class=\"current\" href=\"$recordLink\">$linkTitle</a>";
    }

    public function getLink()
    {
        return $this->getRecord()->PreviewLink() ?? '';
    }

    public function getTitle()
    {
        return  _t(
            'SilverStripe\\CMS\\Controllers\\ContentController.UNVERSIONEDPREVIEW',
            'Preview',
            'Used for the Switch between states (if any other other states are added). Needs to be a short label'
        );
    }

    /**
     * True if the record doesn't have the Versioned extension and is configured to display this item.
     *
     * @param Member $member
     * @return bool
     */
    public function canView($member = null)
    {
        return (
            $this->recordIsUnversioned()
            && $this->showUnversionedLink()
            && $this->getLink()
        );
    }

    private function recordIsUnversioned(): bool
    {
        $record = $this->getRecord();
        // If the record has the Versioned extension, it can be considered unversioned
        // for the purposes of this class if it has no stages and is not archived.
        if ($record->hasExtension(Versioned::class)) {
            return (!$record->hasStages()) && !$this->isArchived();
        }
        // Completely unversioned.
        return true;
    }

    /**
     * True if the record is configured to display this item.
     *
     * @return bool
     */
    public function showUnversionedLink(): bool
    {
        return (bool) Config::inst()->get(get_class($this->record), 'show_unversioned_preview_link');
    }

    /**
     * This item is always active, as there are unlikely to be other preview states available for the record.
     *
     * @return bool
     */
    public function isActive()
    {
        return true;
    }
}