105 lines
2.6 KiB
PHP
105 lines
2.6 KiB
PHP
<?php
|
|
|
|
namespace Yoast\WP\SEO\Presenters\Admin;
|
|
|
|
use Yoast\WP\SEO\Config\Badge_Group_Names;
|
|
use Yoast\WP\SEO\Presenters\Abstract_Presenter;
|
|
|
|
/**
|
|
* Represents the presenter class for "New" badges.
|
|
*/
|
|
class Badge_Presenter extends Abstract_Presenter {
|
|
|
|
/**
|
|
* Identifier of the badge.
|
|
*
|
|
* @var string
|
|
*/
|
|
private $id;
|
|
|
|
/**
|
|
* Optional link of the badge.
|
|
*
|
|
* @var string
|
|
*/
|
|
private $link;
|
|
|
|
/**
|
|
* Optional group which the badge belongs to.
|
|
*
|
|
* Each group has a fixed period after which the group will no longer be considered new and the badges will disappear.
|
|
*
|
|
* @var string
|
|
*/
|
|
private $group;
|
|
|
|
/**
|
|
* Optional object storing the group names and expiration versions.
|
|
*
|
|
* The group names set in Yoast SEO are used by default, but they can be overridden to use custom ones for an add-on.
|
|
*
|
|
* @var Badge_Group_Names
|
|
*/
|
|
private $badge_group_names;
|
|
|
|
/**
|
|
* Badge_Presenter constructor.
|
|
*
|
|
* @param string $id Id of the badge.
|
|
* @param string $link Optional link of the badge.
|
|
* @param string $group Optional group which the badge belongs to.
|
|
* @param Badge_Group_Names|null $badge_group_names Optional object storing the group names.
|
|
*/
|
|
public function __construct( $id, $link = '', $group = '', $badge_group_names = null ) {
|
|
$this->id = $id;
|
|
$this->link = $link;
|
|
$this->group = $group;
|
|
|
|
if ( ! $badge_group_names instanceof Badge_Group_Names ) {
|
|
$badge_group_names = new Badge_Group_Names();
|
|
}
|
|
$this->badge_group_names = $badge_group_names;
|
|
}
|
|
|
|
/**
|
|
* Presents the New Badge. If a link has been passed, the badge is presented with the link.
|
|
* Otherwise a static badge is presented.
|
|
*
|
|
* @return string The styled New Badge.
|
|
*/
|
|
public function present() {
|
|
if ( ! $this->is_group_still_new() ) {
|
|
return '';
|
|
}
|
|
|
|
if ( $this->link !== '' ) {
|
|
return \sprintf(
|
|
'<a class="yoast-badge yoast-badge__is-link yoast-new-badge" id="%1$s-new-badge" href="%2$s">%3$s</a>',
|
|
\esc_attr( $this->id ),
|
|
\esc_url( $this->link ),
|
|
\esc_html__( 'New', 'wordpress-seo' )
|
|
);
|
|
}
|
|
|
|
return \sprintf(
|
|
'<span class="yoast-badge yoast-new-badge" id="%1$s-new-badge">%2$s</span>',
|
|
\esc_attr( $this->id ),
|
|
\esc_html__( 'New', 'wordpress-seo' )
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Check whether the new badge should be shown according to the group it is in.
|
|
*
|
|
* @return bool True if still new.
|
|
*/
|
|
public function is_group_still_new() {
|
|
// If there's no group configured, the new badge is always active.
|
|
if ( ! $this->group ) {
|
|
return true;
|
|
}
|
|
|
|
return $this->badge_group_names->is_still_eligible_for_new_badge( $this->group );
|
|
}
|
|
}
|