Wordlift_Entity_Service

Complexity

Total Complexity

55

Size/Duplication

Total Lines	747
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	3

20 Methods

Rating	Name	Duplication	Size	Complexity
A	get_instance()	0	4	1
A	get_rating_max()	0	3	1
A	is_entity()	0	4	1
A	__construct()	0	17	1
B	get_all_related_to_last_50_published_posts()	0	25	3
B	build_uri()	0	46	4
B	is_used()	0	42	4
A	is_internal_uri()	0	4	1
B	get_entity_post_by_uri()	0	41	3
A	save_post()	0	14	3
A	set_alternative_labels()	0	20	4
A	get_alternative_labels()	0	4	1
A	edit_form_before_permalink()	0	21	3
C	in_admin_header()	0	32	7
A	set_rating_for()	0	17	1
B	get_rating_for()	0	25	3
D	calculate_rating_for()	0	75	10
A	convert_raw_score_to_traffic_light()	0	8	2
A	convert_raw_score_to_percentage()	0	4	1
A	get_alternative_label_input()	0	4	1

<?php

/**
 * Provide entity-related services.
 *
 * @since 3.1.0
 */
class Wordlift_Entity_Service {

	/**
	 * The Log service.
	 *
	 * @since 3.2.0
	 * @access private
	 * @var \Wordlift_Log_Service $log_service The Log service.
	 */
	private $log_service;

	/**
	 * The UI service.
	 *
	 * @since 3.2.0
	 * @access private
	 * @var \Wordlift_UI_Service $ui_service The UI service.
	 */
	private $ui_service;

	/**
	 * The Schema service.
	 *
	 * @since 3.3.0
	 * @access private
	 * @var \Wordlift_Schema_Service $schema_service The Schema service.
	 */
	private $schema_service;

	/**
	 * The Notice service.
	 *
	 * @since 3.3.0
	 * @access private
	 * @var \Wordlift_Notice_Service $notice_service The Notice service.
	 */
	private $notice_service;

	/**
	 * The entity post type name.
	 *
	 * @since 3.1.0
	 */
	const TYPE_NAME = 'entity';

	/**
	 * Entity rating max.
	 *
	 * @since 3.3.0
	 */
	const RATING_MAX = 7;
	
	/**
	 * Entity rating score meta key.
	 *
	 * @since 3.3.0
	 */
	const RATING_RAW_SCORE_META_KEY = '_wl_entity_rating_raw_score';
	
	/**
	 * Entity rating warnings meta key.
	 *
	 * @since 3.3.0
	 */
	const RATING_WARNINGS_META_KEY = '_wl_entity_rating_warnings';

	/**
	 * Entity warning has related post identifier.
	 *
	 * @since 3.3.0
	 */
	const RATING_WARNING_HAS_RELATED_POSTS = 'There are no related posts for the current entity.';

	/**
	 * Entity warning has content post identifier.
	 *
	 * @since 3.3.0
	 */
	const RATING_WARNING_HAS_CONTENT_POST = 'This entity has not description.';

	/**
	 * Entity warning has related entities identifier.
	 *
	 * @since 3.3.0
	 */
	const RATING_WARNING_HAS_RELATED_ENTITIES = 'There are no related entities for the current entity.';

	/**
	 * Entity warning is published identifier.
	 *
	 * @since 3.3.0
	 */
	const RATING_WARNING_IS_PUBLISHED = 'This entity is not published. It will not appear within analysis results.';

	/**
	 * Entity warning has thumbnail identifier.
	 *
	 * @since 3.3.0
	 */
	const RATING_WARNING_HAS_THUMBNAIL = 'This entity has no featured image yet.';

	/**
	 * Entity warning has same as identifier.
	 *
	 * @since 3.3.0
	 */
	const RATING_WARNING_HAS_SAME_AS = 'There are no sameAs configured for this entity.';

	/**
	 * Entity warning has completed metadata identifier.
	 *
	 * @since 3.3.0
	 */
	const RATING_WARNING_HAS_COMPLETED_METADATA = 'Schema.org metadata for this entity are not completed.';

	/**
	 * The alternative label meta key.
	 *
	 * @since 3.2.0
	 */
	const ALTERNATIVE_LABEL_META_KEY = '_wl_alt_label';

	/**
	 * The alternative label input template.
	 *
	 * @since 3.2.0
	 */
	// TODO: this should be moved to a class that deals with HTML code.
	const ALTERNATIVE_LABEL_INPUT_TEMPLATE = '<div class="wl-alternative-label">
                <label class="screen-reader-text" id="wl-alternative-label-prompt-text" for="wl-alternative-label">Enter alternative label here</label>
                <input name="wl_alternative_label[]" size="30" value="%s" id="wl-alternative-label" type="text">
                <button class="button wl-delete-button">%s</button>
                </div>';

	/**
	 * A singleton instance of the Entity service.
	 *
	 * @since 3.2.0
	 * @access private
	 * @var \Wordlift_Entity_Service $instance A singleton instance of the Entity service.
	 */
	private static $instance;

	/**
	 * Create a Wordlift_Entity_Service instance.
	 *
	 * @since 3.2.0
	 *
	 * @param \Wordlift_UI_Service $ui_service The UI service.
	 */
	public function __construct( $ui_service, $schema_service, $notice_service ) {

		$this->log_service = Wordlift_Log_Service::get_logger( 'Wordlift_Entity_Service' );

		// Set the UI service.
		$this->ui_service = $ui_service;

		// Set the Schema service.
		$this->schema_service = $schema_service;

		// Set the Schema service.
		$this->notice_service = $notice_service;

		// Set the singleton instance.
		self::$instance = $this;

	}

	/**
	 * Get the singleton instance of the Entity service.
	 *
	 * @since 3.2.0
	 * @return \Wordlift_Entity_Service The singleton instance of the Entity service.
	 */
	public static function get_instance() {

		return self::$instance;
	}

	/**
	 * Get rating max 
	 *
	 * @since 3.3.0
	 *
	 * @return int Max rating according to performed checks.
	 */
	public static function get_rating_max() {
		return self::RATING_MAX;
	}

	/**
	 * Get the entities related to the last 50 posts published on this blog (we're keeping a long function name due to
	 * its specific function).
	 *
	 * @since 3.1.0
	 *
	 * @return array An array of post IDs.
	 */
	public function get_all_related_to_last_50_published_posts() {

		// Global timeline. Get entities from the latest posts.
		$latest_posts_ids = get_posts( array(
			'numberposts' => 50,
			'fields'      => 'ids', //only get post IDs
			'post_type'   => 'post',
			'post_status' => 'publish'
		) );

		if ( empty( $latest_posts_ids ) ) {
			// There are no posts.
			return array();
		}

		// Collect entities related to latest posts
		$entity_ids = array();
		foreach ( $latest_posts_ids as $id ) {
			$entity_ids = array_merge( $entity_ids, wl_core_get_related_entity_ids( $id, array(
				'status' => 'publish'
			) ) );
		}

		return $entity_ids;
	}

	/**
	 * Determines whether a post is an entity or not.
	 *
	 * @since 3.1.0
	 *
	 * @param int $post_id A post id.
	 *
	 * @return bool Return true if the post is an entity otherwise false.
	 */
	public function is_entity( $post_id ) {

		return ( self::TYPE_NAME === get_post_type( $post_id ) );
	}

	/**
	 * Build an entity uri for a given title
	 * The uri is composed using a given post_type and a title
	 * If already exists an entity e2 with a given uri a numeric suffix is added
	 * If a schema type is given entities with same label and same type are overridden 
	 *
	 * @since 3.5.0
	 *
	 * @param string $title A post title.
	 * @param string $post_type A post type. Default value is 'entity'
	 * @param string $schema_type A schema org type. 
	 * @param integer $increment_digit A digit used to call recursively the same function.
	 *
	 * @return string Returns an uri.
	 */
	public function build_uri( $title, $post_type, $schema_type = NULL, $increment_digit = 0 ) {
		
		// Get the entity slug suffix digit
		$suffix_digit = $increment_digit + 1;
		// Get a sanitized uri for a given title
		$entity_slug = ( 0 == $increment_digit ) ? 
			wl_sanitize_uri_path( $title ) :
			wl_sanitize_uri_path( $title . '_'. $suffix_digit );

		// Compose a candidated uri
		$new_entity_uri = sprintf( '%s/%s/%s', 
			wl_configuration_get_redlink_dataset_uri(), 
			$post_type, 
			$entity_slug 
		); 
		
		$this->log_service->trace( "Going to check if uri is used [ new_entity_uri :: $new_entity_uri ] [ increment_digit :: $increment_digit ]" );
		
		global $wpdb;

Use of global functionality is not recommended; it makes your code harder to test, and less reusable.

    	// Check if the candidated uri already is used
    	// TODO Get post ids instead of count()
		$stmt = $wpdb->prepare( 
    		"SELECT post_id FROM $wpdb->postmeta WHERE meta_key = %s AND meta_value = %s LIMIT 1", 
    		WL_ENTITY_URL_META_NAME,
    		$new_entity_uri
    	);

    	// Perform the query
		$post_id = $wpdb->get_var( $stmt ); 		
			
		// If the post does not exist, then the new uri is returned 	

There is some trailing whitespace on this line which should be avoided as per coding-style.

		if ( ! is_numeric( $post_id ) ) {
			$this->log_service->trace( "Going to return uri [ new_entity_uri :: $new_entity_uri ]" );
			return $new_entity_uri;
		}
		// If schema_type is equal to schema org type of post x, then the new uri is returned 
		$schema_post_type = wl_entity_type_taxonomy_get_type( $post_id );
			
		if ( $schema_type === $schema_post_type[ 'css_class' ] ) {
			$this->log_service->trace( "An entity with the same title and type already exists! Return uri [ new_entity_uri :: $new_entity_uri ]" );
			return $new_entity_uri;
		}

		// Otherwise the same function is called recorsively
		return $this->build_uri( $title, $post_type, $schema_type, ++$increment_digit );
	}

	public function is_used( $post_id ) {

		if ( FALSE === $this->is_entity( $post_id ) ) {
			return null;
		}
		// Retrieve the post
		$entity = get_post( $post_id ); 

		global $wpdb;

Use of global functionality is not recommended; it makes your code harder to test, and less reusable.

    	// Retrieve Wordlift relation instances table name
    	$table_name = wl_core_get_relation_instances_table_name();

		// Check is it's referenced / related to another post / entity
    	$stmt = $wpdb->prepare( 
    		"SELECT COUNT(*) FROM $table_name WHERE  object_id = %d", 
    		$entity->ID
    	);
		
		// Perform the query
		$relation_instances = (int) $wpdb->get_var( $stmt ); 
		// If there is at least one relation instance for the current entity, then it's used
		if ( 0 < $relation_instances ) {		
			return TRUE;
		}

    	// Check if the entity uri is used as meta_value
		$stmt = $wpdb->prepare( 
    		"SELECT COUNT(*) FROM $wpdb->postmeta WHERE post_id != %d AND meta_value = %s", 
    		$entity->ID,
    		wl_get_entity_uri( $entity->ID )
    	);
    	// Perform the query
		$meta_instances = (int) $wpdb->get_var( $stmt ); 
		
		// If there is at least one meta that refers the current entity uri, then current entity is used
		if ( 0 < $meta_instances ) {
			return TRUE;
		}

		// If we are here, it means the current entity is not used at the moment
		return FALSE;
	}

	/**
	 * Determines whether a given uri is an internal uri or not.
	 *
	 * @since 3.3.2
	 *
	 * @param int $uri An uri.
	 *
	 * @return true if the uri internal to the current dataset otherwise false.
	 */
	public function is_internal_uri( $uri ) {

		return ( 0 === strrpos( $uri, wl_configuration_get_redlink_dataset_uri() ) );
	}

	/**
	 * Find entity posts by the entity URI. Entity as searched by their entity URI or same as.
	 *
	 * @since 3.2.0
	 *
	 * @param string $uri The entity URI.
	 *
	 * @return WP_Post|null A WP_Post instance or null if not found.
	 */
	public function get_entity_post_by_uri( $uri ) {

		$query_args = array(
			'posts_per_page'	=> 1,
			'post_status'		=> 'any',
			'post_type'			=> self::TYPE_NAME,
			'meta_query'		=> array(
				array(
					'key'     => WL_ENTITY_URL_META_NAME,
					'value'   => $uri,
					'compare' => '='
				)
			)
		);

		// Only if the current uri is not an internal uri 
		// entity search is performed also looking at sameAs values
		// This solve issues like https://github.com/insideout10/wordlift-plugin/issues/237
		if ( !$this->is_internal_uri( $uri ) ) {
		
			$query_args[ 'meta_query' ][ 'relation' ] = 'OR';
			$query_args[ 'meta_query' ][] = array(
				'key'     => Wordlift_Schema_Service::FIELD_SAME_AS,
				'value'   => $uri,
				'compare' => '='
			);
		} 

		$query = new WP_Query( $query_args );

		// Get the matching entity posts.
		$posts = $query->get_posts();

		// Return null if no post is found.
		if ( 0 === count( $posts ) ) {
			return null;
		}

		// Return the found post.
		return $posts[0];
	}

	/**
	 * Fires once a post has been saved.
	 *
	 * @since 3.2.0
	 *
	 * @param int $post_id Post ID.
	 * @param WP_Post $post Post object.
	 * @param bool $update Whether this is an existing post being updated or not.
	 */
	public function save_post( $post_id, $post, $update ) {

The parameter $post is not used and could be removed.

The parameter $update is not used and could be removed.

save_post uses the super-global variable $_REQUEST which is generally not recommended.

		// If it's not an entity, return.
		if ( ! $this->is_entity( $post_id ) ) {
			return;
		}

		// Get the alt labels from the request (or empty array).
		$alt_labels = isset( $_REQUEST['wl_alternative_label'] ) ? $_REQUEST['wl_alternative_label'] : array();

		// Set the alternative labels.
		$this->set_alternative_labels( $post_id, $alt_labels );

	}

	/**
	 * Set the alternative labels.
	 *
	 * @since 3.2.0
	 *
	 * @param int $post_id The post id.
	 * @param array $alt_labels An array of labels.
	 */
	public function set_alternative_labels( $post_id, $alt_labels ) {
		
		// Force $alt_labels to be an array
		if( !is_array( $alt_labels ) ) {
			$alt_labels = array( $alt_labels );
		}

		$this->log_service->debug( "Setting alternative labels [ post id :: $post_id ][ alt labels :: " . implode( ',', $alt_labels ) . " ]" );

		// Delete all the existing alternate labels.
		delete_post_meta( $post_id, self::ALTERNATIVE_LABEL_META_KEY );
		
		// Set the alternative labels.
		foreach ( $alt_labels as $alt_label ) {
			if ( ! empty( $alt_label ) ) {
				add_post_meta( $post_id, self::ALTERNATIVE_LABEL_META_KEY, $alt_label );
			}
		}

	}

	/**
	 * Retrieve the alternate labels.
	 *
	 * @since 3.2.0
	 *
	 * @param int $post_id Post id.
	 *
	 * @return mixed An array  of alternative labels.
	 */
	public function get_alternative_labels( $post_id ) {

		return get_post_meta( $post_id, self::ALTERNATIVE_LABEL_META_KEY );
	}

	/**
	 * Fires before the permalink field in the edit form (this event is available in WP from 4.1.0).
	 *
	 * @since 3.2.0
	 *
	 * @param WP_Post $post Post object.
	 */
	public function edit_form_before_permalink( $post ) {

		// If it's not an entity, return.
		if ( ! $this->is_entity( $post->ID ) ) {
			return;
		}

		// Print the input template.
		$this->ui_service->print_template( 'wl-tmpl-alternative-label-input', $this->get_alternative_label_input() );

		// Print all the currently set alternative labels.
		foreach ( $this->get_alternative_labels( $post->ID ) as $alt_label ) {

			echo $this->get_alternative_label_input( $alt_label );

		};

		// Print the button.
		$this->ui_service->print_button( 'wl-add-alternative-labels-button', __( 'Add more titles', 'wordlift' ) );

	}

	/**
	 * Add admin notices for the current entity depending on the current rating.
	 *
	 * @since 3.3.0
	 *
	 * @param WP_Post $post Post object.

There is no parameter named $post. Was it maybe removed?

	 */
	public function in_admin_header() {

		// Return safely if get_current_screen() is not defined (yet)
		if ( FALSE === function_exists( 'get_current_screen' ) ) {
			return;
		}
		
		$screen = get_current_screen();
		// If there is any valid screen nothing to do
		if ( NULL === $screen ) {
			return $clauses;

The variable $clauses does not exist. Did you forget to declare it?

		}

		// If you're not in the entity post edit page, return.
		if ( self::TYPE_NAME !== $screen->id ) {
			return;
		}
		// Retrieve the current global post
		global $post;

Use of global functionality is not recommended; it makes your code harder to test, and less reusable.

		// If it's not an entity, return.
		if ( ! $this->is_entity( $post->ID ) ) {
			return;
		}
		// Retrieve an updated rating for the current entity
		$rating = $this->get_rating_for( $post->ID, true );
		// If there is at least 1 warning
		if ( isset( $rating[ 'warnings' ] ) && 0 < count( $rating[ 'warnings' ] ) ) {
			// TODO - Pass Wordlift_Notice_Service trough the service constructor 
			$this->notice_service->add_suggestion( $rating[ 'warnings' ] );
		}
		
	}
	
	/**
	 * Set rating for a given entity
	 *
	 * @since 3.3.0
	 *
	 * @param int $post_id The entity post id.
	 *
	 * @return int An array representing the rating obj.
	 */
	public function set_rating_for( $post_id ) {

		// Calculate rating for the given post
		$rating = $this->calculate_rating_for( $post_id );
		// Store the rating on db as post meta
		// Please notice that RATING_RAW_SCORE_META_KEY 
		// is saved on a different meta to allow score sorting
		// Both meta are managed as unique
		// https://codex.wordpress.org/Function_Reference/update_post_meta
		update_post_meta( $post_id, self::RATING_RAW_SCORE_META_KEY, $rating[ 'raw_score' ] );
		update_post_meta( $post_id, self::RATING_WARNINGS_META_KEY, $rating[ 'warnings' ] );
		
		$this->log_service->trace( sprintf( "Rating set for [ post_id :: $post_id ] [ rating :: %s ]", $rating[ 'raw_score' ]  ) );
		
		// Finally returns the rating 
		return $rating;
	}
	/**
	 * Get or calculate rating for a given entity
	 *
	 * @since 3.3.0
	 *
	 * @param int $post_id The entity post id.
	 * @param $force_reload $warnings_needed If true, detailed warnings collection is provided with the rating obj.

The doc-type $force_reload could not be parsed: Unknown type name "$force_reload" at position 0. (view supported doc-types)

There is no parameter named $warnings_needed. Was it maybe removed?

	 *
	 * @return int An array representing the rating obj.
	 */
	public function get_rating_for( $post_id, $force_reload = false ) {
		
		// If forced reload is required or rating is missing ..
		if ( $force_reload ) {
			$this->log_service->trace( "Force rating reload [ post_id :: $post_id ]" );
			return $this->set_rating_for( $post_id );
		}
		
		$current_raw_score = get_post_meta( $post_id, self::RATING_RAW_SCORE_META_KEY, true );  
			
		if ( ! is_numeric( $current_raw_score ) ) {
			$this->log_service->trace( "Rating missing for [ post_id :: $post_id ] [ current_raw_score :: $current_raw_score ]" );
			return $this->set_rating_for( $post_id );
		}
		$current_warnings = get_post_meta( $post_id, self::RATING_WARNINGS_META_KEY, true );  
		
		// Finally return score and warnings
		return array( 
			'raw_score'				=> $current_raw_score,
			'traffic_light_score'	=> $this->convert_raw_score_to_traffic_light( $current_raw_score ),
			'percentage_score'		=> $this->convert_raw_score_to_percentage( $current_raw_score ),
			'warnings'				=> $current_warnings, 
		);

	}
	/**
	 * Calculate rating for a given entity
	 * Rating depends from following criteria
	 *
	 * 1. Is the current entity related to at least 1 post?
	 * 2. Is the current entity content post not empty?
	 * 3. Is the current entity related to at least 1 entity?
	 * 4. Is the entity published? 
	 * 5. There is a a thumbnail associated to the entity?
	 * 6. Has the entity a sameas defined?
	 * 7. Are all schema.org required metadata compiled?
	 *
	 * Each positive check means +1 in terms of rating score
	 *
	 * @since 3.3.0
	 *
	 * @param int $post_id The entity post id.
	 *
	 * @return int An array representing the rating obj.
	 */
	public function calculate_rating_for( $post_id ) {
		
		// If it's not an entity, return.
		if ( ! $this->is_entity( $post_id ) ) {
			return;
		}
		// Retrieve the post object
		$post = get_post( $post_id );
		// Rating value
		$score = 0;
		// Store warning messages
		$warnings = array();

		// Is the current entity related to at least 1 post?
		( 0 < count( wl_core_get_related_post_ids( $post->ID ) ) ) ?
			$score++ : 
			array_push( $warnings, __( self::RATING_WARNING_HAS_RELATED_POSTS, 'wordlift' ) );
		
		// Is the post content not empty?
		( ! empty( $post->post_content ) ) ?
			$score++ :
			array_push( $warnings, __( self::RATING_WARNING_HAS_CONTENT_POST, 'wordlift' ) );
		
		// Is the current entity related to at least 1 entity?
		// Was the current entity already disambiguated?
		( 0 < count( wl_core_get_related_entity_ids( $post->ID ) ) ) ?
			$score++ :
			array_push( $warnings, __( self::RATING_WARNING_HAS_RELATED_ENTITIES, 'wordlift' ) );
		
		// Is the entity published?
		( 'publish' === get_post_status( $post->ID ) ) ?
			$score++ :
			array_push( $warnings, __( self::RATING_WARNING_IS_PUBLISHED, 'wordlift' ) );
		
		// Has a thumbnail?
		( has_post_thumbnail( $post->ID ) ) ?
			$score++ :
			array_push( $warnings, __( self::RATING_WARNING_HAS_THUMBNAIL, 'wordlift' ) );
		
		// Get all post meta keys for the current post		
		global $wpdb;

Use of global functionality is not recommended; it makes your code harder to test, and less reusable.

		$query = $wpdb->prepare( 
			"SELECT DISTINCT(meta_key) FROM $wpdb->postmeta  WHERE post_id = %d", $post->ID 
		);
		
		// Check intersection between available meta keys 
		// and expected ones arrays to detect missing values
		$available_meta_keys = $wpdb->get_col( $query );

		// If each expected key is contained in available keys array ...
		( in_array( Wordlift_Schema_Service::FIELD_SAME_AS, $available_meta_keys ) ) ?
			$score++ :
			array_push( $warnings, __( self::RATING_WARNING_HAS_SAME_AS, 'wordlift' ) );
		
		$schema = wl_entity_type_taxonomy_get_type( $post_id );

		$expected_meta_keys = ( null === $schema[ 'custom_fields' ] ) ? 
			array() : 
			array_keys( $schema[ 'custom_fields' ] );

		$intersection = array_intersect( $expected_meta_keys, $available_meta_keys );
		// If each expected key is contained in available keys array ...
		( count( $intersection ) === count( $expected_meta_keys ) ) ?
			$score++ :
			array_push( $warnings, __( self::RATING_WARNING_HAS_COMPLETED_METADATA, 'wordlift' ) );
		
		// Finally return score and warnings
		return array( 
			'raw_score'				=> $score,
			'traffic_light_score'	=> $this->convert_raw_score_to_traffic_light( $score ),
			'percentage_score'		=> $this->convert_raw_score_to_percentage( $score ),
			'warnings'				=> $warnings, 
		);

	}

	/**
	 * Get as rating as input and convert in a traffic-light rating
	 *
	 * @since 3.3.0
	 *
	 * @param int $score The rating score for a given entity.
	 *
	 * @return string The input HTML code.
	 */
	private function convert_raw_score_to_traffic_light( $score ) {
		// RATING_MAX : $score = 3 : x 
		// See http://php.net/manual/en/function.round.php
		$rating = round( ( $score * 3 ) / self::get_rating_max(), 0, PHP_ROUND_HALF_UP );
		// If rating is 0, return 1, otherwise return rating
		return ( 0 == $rating ) ? 1 : $rating; 

	}

	/**
	 * Get as rating as input and convert in a traffic-light rating
	 *
	 * @since 3.3.0
	 *
	 * @param int $score The rating score for a given entity.
	 *
	 * @return string The input HTML code.
	 */
	public function convert_raw_score_to_percentage( $score ) {
		// RATING_MAX : $score = 100 : x 
		return round( ( $score * 100) / self::get_rating_max(), 0, PHP_ROUND_HALF_UP );
	}

	/**
	 * Get the alternative label input HTML code.
	 *
	 * @since 3.2.0
	 *
	 * @param string $value The input value.
	 *
	 * @return string The input HTML code.
	 */
	private function get_alternative_label_input( $value = '' ) {

		return sprintf( self::ALTERNATIVE_LABEL_INPUT_TEMPLATE, esc_attr( $value ), __( 'Delete', 'wordlift' ) );
	}
}