luyadev/luya

<?php

namespace luya\web;

use luya\helpers\StringHelper;
use luya\helpers\Url;
use yii\base\InvalidConfigException;

/**
 * Generate External Link object.
 *
 * When href is provided without a protocol, for example `//go/there` the slashes are replaced
 * by the current base absolute base URL.
 *
 * @property string $href The external href link will be http ensured on set.
 * @property string $target Returns the link target.
 *
 * @author Basil Suter <basil@nadar.io>
 * @since 1.0.0
 */
class WebsiteLink extends BaseLink
{
    /**
     * @var string The default value which is used for website links is `_blank` you can override this property in order to change the default value.
     */
    public $defaultTarget = '_blank';

    /**
     * @inheritdoc
     */
    public function init()
    {
        parent::init();

        if ($this->href === null) {
            throw new InvalidConfigException('The href attribute can not be empty and must be set trough configuration array.');
        }
    }

    private $_href;

    /**
     * Set the href value for an external link resource.
     *
     * @param string $href The external link href value, the http protcol will be ensured.
     */
    public function setHref($href)
    {
        if (StringHelper::startsWith($href, '//')) {
            $this->_href = Url::base(true) . str_replace('//', '/', $href);
        } elseif (StringHelper::startsWith($href, '#')) {
            // When an anchor link is given, do not modify the link. This can be usefull for one pagers
            $this->_href = $href;
        } else {
            $this->_href = Url::ensureHttp($href);
        }
    }

    /**
     * @inheritdoc
     */
    public function getHref()
    {
        return $this->_href;
    }

    private $_target;

    /**
     * Setter method for the link target.
     *
     * @param string $target A valid html link target attribute value.
     */
    public function setTarget($target)
    {
        $this->_target = $target;
    }

    /**
     * @inheritdoc
     */
    public function getTarget()
    {
        return empty($this->_target) ? $this->defaultTarget : $this->_target;
    }
}