insideout10 / wordlift-plugin

src/includes/class-wordlift-schema-service.php

Indentation +1285 added lines, -1285 removed lines

@@ -18,1290 +18,1290 @@
  */
 class Wordlift_Schema_Service {
 
-	/**
-	 * The 'location created' field name.
-	 *
-	 * @since 3.5.0
-	 */
-	const FIELD_LOCATION_CREATED = 'wl_location_created';
-
-	/**
-	 * The 'topic' field name.
-	 *
-	 * @since 3.5.0
-	 */
-	const FIELD_TOPIC = 'wl_topic';
-
-	/**
-	 * The 'author' field name.
-	 *
-	 * @since 3.1.0
-	 */
-	const FIELD_AUTHOR = 'wl_author';
-
-	/**
-	 * The 'same as' field name.
-	 *
-	 * @since 3.1.0
-	 */
-	const FIELD_SAME_AS = 'entity_same_as';
-
-	/**
-	 * The 'date start' field name.
-	 *
-	 * @since 3.1.0
-	 */
-	const FIELD_DATE_START = 'wl_cal_date_start';
-
-	/**
-	 * The 'date end' field name.
-	 *
-	 * @since 3.1.0
-	 */
-	const FIELD_DATE_END = 'wl_cal_date_end';
-
-	/**
-	 * The 'location' field name.
-	 *
-	 * @since 3.1.0
-	 */
-	const FIELD_LOCATION = 'wl_location';
-
-	/**
-	 * The 'founder' field name.
-	 *
-	 * @since 3.1.0
-	 */
-	const FIELD_FOUNDER = 'wl_founder';
-
-	/**
-	 * The 'knows' field name.
-	 *
-	 * @since 3.1.0
-	 */
-	const FIELD_KNOWS = 'wl_knows';
-
-	/**
-	 * The 'birth date' field name.
-	 *
-	 * @since 3.1.0
-	 */
-	const FIELD_BIRTH_DATE = 'wl_birth_date';
-
-	/**
-	 * The 'birth place' field name.
-	 *
-	 * @since 3.1.0
-	 */
-	const FIELD_BIRTH_PLACE = 'wl_birth_place';
-
-	/**
-	 * The 'latitude' field name.
-	 *
-	 * @since 3.1.0
-	 */
-	const FIELD_GEO_LATITUDE = 'wl_geo_latitude';
-
-	/**
-	 * The 'longitude' field name.
-	 *
-	 * @since 3.1.0
-	 */
-	const FIELD_GEO_LONGITUDE = 'wl_geo_longitude';
-
-	/**
-	 * The 'streetAddress' field name.
-	 *
-	 * @since 3.1.0
-	 */
-	const FIELD_ADDRESS = 'wl_address';
-
-	/**
-	 * The 'postOfficeBoxNumber' field name.
-	 *
-	 * @since 3.3.0
-	 */
-	const FIELD_ADDRESS_PO_BOX = 'wl_address_post_office_box';
-
-	/**
-	 * The 'postalCode' field name.
-	 *
-	 * @since 3.3.0
-	 */
-	const FIELD_ADDRESS_POSTAL_CODE = 'wl_address_postal_code';
-
-	/**
-	 * The 'addressLocality' field name.
-	 *
-	 * @since 3.3.0
-	 */
-	const FIELD_ADDRESS_LOCALITY = 'wl_address_locality';
-	/**
-	 * The 'addressRegion' field name.
-	 *
-	 * @since 3.3.0
-	 */
-	const FIELD_ADDRESS_REGION = 'wl_address_region';
-
-	/**
-	 * The 'addressCountry' field name.
-	 *
-	 * @since 3.3.0
-	 */
-	const FIELD_ADDRESS_COUNTRY = 'wl_address_country';
-
-	/**
-	 * The 'entity type' field name.
-	 *
-	 * @since 3.1.0
-	 */
-	const FIELD_ENTITY_TYPE = 'wl_entity_type_uri';
-
-	/**
-	 * The 'email' field name.
-	 *
-	 * @since 3.2.0
-	 */
-	const FIELD_EMAIL = 'wl_email';
-
-	/**
-	 * The 'affiliation' field name.
-	 *
-	 * @since 3.2.0
-	 */
-	const FIELD_AFFILIATION = 'wl_affiliation';
-
-	/**
-	 * The 'telephone' field name.
-	 *
-	 * @since 3.8.0
-	 */
-	const FIELD_TELEPHONE = 'wl_schema_telephone';
-
-	/**
-	 * The 'legalName' field name.
-	 *
-	 * @since 3.12.0
-	 */
-	const FIELD_LEGAL_NAME = 'wl_schema_legal_name';
-
-	/**
-	 * The 'recipeCuisine' field name.
-	 *
-	 * @since 3.14.0
-	 */
-	const FIELD_RECIPE_CUISINE = 'wl_schema_recipe_cuisine';
-
-	/**
-	 * The 'recipeIngredient' field name.
-	 *
-	 * @since 3.14.0
-	 */
-	const FIELD_RECIPE_INGREDIENT = 'wl_schema_recipe_ingredient';
-
-	/**
-	 * The 'calories' field name.
-	 *
-	 * @since 3.14.0
-	 */
-	const FIELD_NUTRITION_INFO_CALORIES = 'wl_schema_nutrition_information_calories';
-
-	/**
-	 * The 'recipeInstructions' field name.
-	 *
-	 * @since 3.14.0
-	 */
-	const FIELD_RECIPE_INSTRUCTIONS = 'wl_schema_recipe_instructions';
-
-	/**
-	 * The 'recipeYield' field name.
-	 *
-	 * @since 3.14.0
-	 */
-	const FIELD_RECIPE_YIELD = 'wl_schema_recipe_yield';
-
-	/**
-	 * The 'prepTime' field name.
-	 *
-	 * @since 3.14.0
-	 */
-	const FIELD_PREP_TIME = 'wl_schema_prep_time';
-
-	/**
-	 * The 'cookTime' field name.
-	 *
-	 * @since 3.14.0
-	 */
-	const FIELD_COOK_TIME = 'wl_schema_cook_time';
-
-	/**
-	 * The 'totalTime' field name.
-	 *
-	 * @since 3.14.0
-	 */
-	const FIELD_TOTAL_TIME = 'wl_schema_total_time';
-
-	/**
-	 * The 'URI' data type name.
-	 *
-	 * @since 3.1.0
-	 */
-	const DATA_TYPE_URI = 'uri';
-
-	/**
-	 * The 'date' data type name.
-	 *
-	 * @since 3.1.0
-	 */
-	const DATA_TYPE_DATE = 'date';
-
-	/**
-	 * The 'dateTime' data type name.
-	 *
-	 * @since 3.15.0
-	 */
-	const DATA_TYPE_DATE_TIME = 'dateTime';
-
-	/**
-	 * The 'time' data type name.
-	 *
-	 * @since 3.14.0
-	 */
-	const DATA_TYPE_DURATION = 'duration';
-
-	/**
-	 * The 'double' data type name.
-	 *
-	 * @since 3.1.0
-	 */
-	const DATA_TYPE_DOUBLE = 'double';
-
-	/**
-	 * The 'string' data type name.
-	 *
-	 * @since 3.1.0
-	 */
-	const DATA_TYPE_STRING = 'string';
-
-	/**
-	 * The multiline text data type name.
-	 *
-	 * @since 3.14.0
-	 */
-	const DATA_TYPE_MULTILINE = 'multiline';
-
-	/**
-	 * The 'integer' data type name.
-	 *
-	 * @since 3.1.0
-	 */
-	const DATA_TYPE_INTEGER = 'int';
-
-	/**
-	 * The 'boolean' data type name.
-	 *
-	 * @since 3.1.0
-	 */
-	const DATA_TYPE_BOOLEAN = 'bool';
-
-	/**
-	 * The schema.org Event type URI.
-	 *
-	 * @since 3.1.0
-	 */
-	const SCHEMA_EVENT_TYPE = 'http://schema.org/Event';
-
-	/**
-	 * The Schema service singleton instance.
-	 *
-	 * @since  3.1.0
-	 * @access private
-	 * @var \Wordlift_Schema_Service $instance The Schema service singleton instance.
-	 */
-	private static $instance;
-
-	/**
-	 * WordLift's schema.
-	 *
-	 * @since  3.1.0
-	 * @access private
-	 * @var array $schema WordLift's schema.
-	 */
-	private $schema;
-
-	/**
-	 * The Log service.
-	 *
-	 * @since  3.1.0
-	 * @access private
-	 * @var \Wordlift_Log_Service $log The Log service.
-	 */
-	private $log;
-
-	/**
-	 * The {@link Wordlift_Post_Property_Storage_Factory} instance.
-	 *
-	 * @since  3.15.0
-	 * @access private
-	 * @var \Wordlift_Storage_Factory $storage_factory The {@link Wordlift_Post_Property_Storage_Factory} instance.
-	 */
-	private $storage_factory;
-
-	/**
-	 * The {@link Wordlift_Sparql_Tuple_Rendition_Factory} instance.
-	 *
-	 * @since  3.15.0
-	 * @access private
-	 * @var \Wordlift_Sparql_Tuple_Rendition_Factory $rendition_factory The {@link Wordlift_Sparql_Tuple_Rendition_Factory} instance.
-	 */
-	private $rendition_factory;
-
-	/**
-	 * The {@link Wordlift_Configuration_Service} instance.
-	 *
-	 * @since  3.15.0
-	 * @access private
-	 * @var \Wordlift_Configuration_Service $configuration_service The {@link Wordlift_Configuration_Service} instance.
-	 */
-	private $configuration_service;
-
-	/**
-	 * The web site configured language code.
-	 *
-	 * @since  3.15.0
-	 * @access private
-	 * @var string $language_code The web site configured language code.
-	 */
-	private $language_code;
-
-	/**
-	 * Wordlift_Schema_Service constructor.
-	 *
-	 * @since 3.1.0
-	 *
-	 * @param \Wordlift_Storage_Factory                $storage_factory       The {@link Wordlift_Post_Property_Storage_Factory} instance.
-	 * @param \Wordlift_Sparql_Tuple_Rendition_Factory $rendition_factory     The {@link Wordlift_Sparql_Tuple_Rendition_Factory} instance.
-	 * @param \Wordlift_Configuration_Service          $configuration_service The {@link Wordlift_Configuration_Service} instance.
-	 */
-	public function __construct( $storage_factory, $rendition_factory, $configuration_service ) {
-
-		$this->log = Wordlift_Log_Service::get_logger( 'Wordlift_Schema_Service' );
-
-		$this->storage_factory       = $storage_factory;
-		$this->rendition_factory     = $rendition_factory;
-		$this->configuration_service = $configuration_service;
-		$this->language_code         = $this->configuration_service->get_language_code();
-
-		// Set the taxonomy data.
-		// Note: parent types must be defined before child types.
-		$this->schema = array(
-			'article'       => $this->get_article_schema(),
-			'thing'         => $this->get_thing_schema(),
-			'creative-work' => $this->get_creative_work_schema(),
-			'event'         => $this->get_event_schema(),
-			'organization'  => $this->get_organization_schema(),
-			'person'        => $this->get_person_schema(),
-			'place'         => $this->get_place_schema(),
-			'localbusiness' => $this->get_local_business_schema(),
-			'recipe'        => $this->get_recipe_schema(),
-		);
-
-		// Create a singleton instance of the Schema service, useful to provide static functions to global functions.
-		self::$instance = $this;
-
-	}
-
-	/**
-	 * Get a reference to the Schema service.
-	 *
-	 * @since 3.1.0
-	 *
-	 * @return Wordlift_Schema_Service A reference to the Schema service.
-	 */
-	public static function get_instance() {
-
-		return self::$instance;
-	}
-
-	/**
-	 * Get the properties for a field with the specified key. The key is used as
-	 * meta key when the field's value is stored in WordPress meta data table.
-	 *
-	 * @since 3.6.0
-	 *
-	 * @param string $key The field's key.
-	 *
-	 * @return null|array An array of field's properties or null if the field is not found.
-	 */
-	public function get_field( $key ) {
-
-		// Parse each schema's fields until we find the one we're looking for, then
-		// return its properties.
-		foreach ( $this->schema as $_ => $schema ) {
-
-			if ( ! isset( $schema['custom_fields'] ) ) {
-				break;
-			}
-
-			foreach ( $schema['custom_fields'] as $field => $props ) {
-				if ( $key === $field ) {
-					return $props;
-				}
-			}
-		}
-
-		return null;
-	}
-
-	/**
-	 * Get the WordLift's schema.
-	 *
-	 * @param string $name The schema name.
-	 *
-	 * @return array|null An array with the schema configuration or NULL if the schema is not found.
-	 *
-	 * @since 3.1.0
-	 */
-	public function get_schema( $name ) {
-		// Check if the schema exists and, if not, return NULL.
-		if ( ! isset( $this->schema[ $name ] ) ) {
-			return null;
-		}
-
-		// Return the requested schema.
-		return $this->schema[ $name ];
-	}
-
-	/**
-	 * Get the WordLift's schema trough schema type uri.
-	 *
-	 * @param string $uri The schema uri.
-	 *
-	 * @return array|null An array with the schema configuration or NULL if the schema is not found.
-	 *
-	 * @since 3.3.0
-	 */
-	public function get_schema_by_uri( $uri ) {
-
-		foreach ( $this->schema as $name => $schema ) {
-			if ( $schema['uri'] === $uri ) {
-				return $schema;
-			}
-		}
-
-		return null;
-	}
-
-	/**
-	 * Get the 'thing' schema.
-	 *
-	 * @return array An array with the schema configuration.
-	 *
-	 * @since 3.1.0
-	 */
-	private function get_thing_schema() {
-
-		return array(
-			'css_class'     => 'wl-thing',
-			'uri'           => 'http://schema.org/Thing',
-			'same_as'       => array( '*' ),
-			// set as default.
-			'custom_fields' => array(
-				self::FIELD_SAME_AS                            => array(
-					'predicate'   => 'http://schema.org/sameAs',
-					'type'        => self::DATA_TYPE_URI,
-					'export_type' => 'http://schema.org/Thing',
-					'constraints' => array(
-						'cardinality' => INF,
-					),
-					// We need a custom metabox.
-					'input_field' => 'sameas',
-				),
-				// Add the schema:url property.
-				Wordlift_Schema_Url_Property_Service::META_KEY => Wordlift_Schema_Url_Property_Service::get_instance()
-																									  ->get_compat_definition(),
-			),
-			// {{sameAs}} not present in the microdata template,
-			// because it is treated separately in *wl_content_embed_item_microdata*
-			'templates'     => array(
-				'subtitle' => '{{id}}',
-			),
-			'linked_data'   => array(
-				// ### Title to rdfs:label.
-				$this->rendition_factory->create(
-					$this->storage_factory->post_title(),
-					Wordlift_Query_Builder::RDFS_LABEL_URI,
-					null,
-					$this->language_code
-				),
-				// ### Title to dct:title.
-				$this->rendition_factory->create(
-					$this->storage_factory->post_title(),
-					'http://purl.org/dc/terms/title',
-					null,
-					$this->language_code
-				),
-				// ### Alternative title to rdfs:label.
-				$this->rendition_factory->create(
-					$this->storage_factory->post_meta( Wordlift_Entity_Service::ALTERNATIVE_LABEL_META_KEY ),
-					Wordlift_Query_Builder::RDFS_LABEL_URI,
-					null,
-					$this->language_code
-				),
-				// ### Alternative title to dct:title.
-				$this->rendition_factory->create(
-					$this->storage_factory->post_meta( Wordlift_Entity_Service::ALTERNATIVE_LABEL_META_KEY ),
-					'http://purl.org/dc/terms/title',
-					null,
-					$this->language_code
-				),
-				// ### schema:url.
-				$this->rendition_factory->create(
-					$this->storage_factory->url_property(),
-					Wordlift_Query_Builder::SCHEMA_URL_URI,
-					self::DATA_TYPE_URI
-				),
-				// ### schema:description.
-				$this->rendition_factory->create(
-					$this->storage_factory->post_description_no_tags_no_shortcodes(),
-					'http://schema.org/description',
-					null,
-					$this->language_code
-				),
-				// ### owl:sameAs.
-				$this->rendition_factory->create(
-					$this->storage_factory->post_meta( self::FIELD_SAME_AS ),
-					'http://www.w3.org/2002/07/owl#sameAs',
-					self::DATA_TYPE_URI
-				),
-				// ### rdf:type.
-				$this->rendition_factory->create(
-					$this->storage_factory->schema_class( $this ),
-					Wordlift_Query_Builder::RDFS_TYPE_URI,
-					self::DATA_TYPE_URI
-				),
-				// ### schema:image.
-				$this->rendition_factory->create(
-					$this->storage_factory->post_images(),
-					Wordlift_Query_Builder::SCHEMA_IMAGE_URI,
-					self::DATA_TYPE_URI
-				),
-				// ### dct:relation.
-				$this->rendition_factory->create(
-					$this->storage_factory->relations(),
-					Wordlift_Query_Builder::DCTERMS_RELATION_URI,
-					self::DATA_TYPE_URI
-				),
-			),
-		);
-
-	}
-
-	/**
-	 * Get the 'creative work' schema.
-	 *
-	 * @return array An array with the schema configuration.
-	 *
-	 * @since 3.1.0
-	 */
-	private function get_creative_work_schema() {
-
-		$schema = array(
-			'label'         => 'CreativeWork',
-			'description'   => 'A creative work (or a Music Album).',
-			'parents'       => array( 'thing' ),
-			// Give term slug as parent.
-			'css_class'     => 'wl-creative-work',
-			'uri'           => 'http://schema.org/CreativeWork',
-			'same_as'       => array(
-				'http://schema.org/MusicAlbum',
-				'http://schema.org/Product',
-			),
-			'custom_fields' => array(
-				self::FIELD_AUTHOR => array(
-					'predicate'   => 'http://schema.org/author',
-					'type'        => self::DATA_TYPE_URI,
-					'export_type' => 'http://schema.org/Person',
-					'constraints' => array(
-						'uri_type'    => array( 'Person', 'Organization' ),
-						'cardinality' => INF,
-					),
-				),
-			),
-			'linked_data'   => array(
-				// ### schema:author.
-				$this->rendition_factory->create(
-					$this->storage_factory->author_uri(),
-					Wordlift_Query_Builder::SCHEMA_AUTHOR_URI,
-					self::DATA_TYPE_URI
-				),
-			),
-			'templates'     => array(
-				'subtitle' => '{{id}}',
-			),
-		);
-
-		// Merge the custom fields with those provided by the thing schema.
-		$parent_schema           = $this->get_thing_schema();
-		$schema['custom_fields'] = array_merge( $schema['custom_fields'], $parent_schema['custom_fields'] );
-		$schema['linked_data']   = array_merge( $schema['linked_data'], $parent_schema['linked_data'] );
-
-		return $schema;
-	}
-
-	/**
-	 * Get the 'event' schema.
-	 *
-	 * @return array An array with the schema configuration.
-	 *
-	 * @since 3.1.0
-	 */
-	private function get_event_schema() {
-
-		$schema = array(
-			'label'         => 'Event',
-			'description'   => 'An event . ',
-			'parents'       => array( 'thing' ),
-			'css_class'     => 'wl-event',
-			'uri'           => self::SCHEMA_EVENT_TYPE,
-			'same_as'       => array( 'http://dbpedia.org/ontology/Event' ),
-			'custom_fields' => array(
-				self::FIELD_DATE_START => array(
-					'predicate'   => 'http://schema.org/startDate',
-					'type'        => self::DATA_TYPE_DATE,
-					'export_type' => 'xsd:dateTime',
-					'constraints' => '',
-				),
-				self::FIELD_DATE_END   => array(
-					'predicate'   => 'http://schema.org/endDate',
-					'type'        => self::DATA_TYPE_DATE,
-					'export_type' => 'xsd:dateTime',
-					'constraints' => '',
-				),
-				self::FIELD_LOCATION   => array(
-					'predicate'   => 'http://schema.org/location',
-					'type'        => self::DATA_TYPE_URI,
-					'export_type' => 'http://schema.org/PostalAddress',
-					'constraints' => array(
-						'uri_type'    => array( 'Place', 'LocalBusiness' ),
-						'cardinality' => INF,
-					),
-				),
-			),
-			'linked_data'   => array(
-				// ### schema:startDate.
-				$this->rendition_factory->create(
-					$this->storage_factory->post_meta( self::FIELD_DATE_START ),
-					'http://schema.org/startDate',
-					self::DATA_TYPE_DATE_TIME
-				),
-				// ### schema:endDate.
-				$this->rendition_factory->create(
-					$this->storage_factory->post_meta( self::FIELD_DATE_END ),
-					'http://schema.org/endDate',
-					self::DATA_TYPE_DATE_TIME
-				),
-				// ### schema:location.
-				$this->rendition_factory->create(
-					$this->storage_factory->post_meta_to_uri( self::FIELD_LOCATION ),
-					'http://schema.org/location',
-					self::DATA_TYPE_URI
-				),
-			),
-			'templates'     => array(
-				'subtitle' => '{{id}}',
-			),
-		);
-
-		// Merge the custom fields with those provided by the thing schema.
-		$parent_schema           = $this->get_thing_schema();
-		$schema['custom_fields'] = array_merge( $schema['custom_fields'], $parent_schema['custom_fields'] );
-		$schema['linked_data']   = array_merge( $schema['linked_data'], $parent_schema['linked_data'] );
-
-		return $schema;
-	}
-
-	/**
-	 * Get the 'organization' schema.
-	 *
-	 * @return array An array with the schema configuration.
-	 *
-	 * @since 3.1.0
-	 */
-	private function get_organization_schema() {
-
-		$schema = array(
-			'label'         => 'Organization',
-			'description'   => 'An organization, including a government or a newspaper.',
-			'parents'       => array( 'thing' ),
-			'css_class'     => 'wl-organization',
-			'uri'           => 'http://schema.org/Organization',
-			'same_as'       => array(
-				'http://rdf.freebase.com/ns/organization.organization',
-				'http://rdf.freebase.com/ns/government.government',
-				'http://schema.org/Newspaper',
-			),
-			'custom_fields' => array(
-				self::FIELD_LEGAL_NAME          => array(
-					'predicate'   => 'http://schema.org/legalName',
-					'type'        => self::DATA_TYPE_STRING,
-					'export_type' => 'xsd:string',
-					'constraints' => '',
-				),
-				self::FIELD_FOUNDER             => array(
-					'predicate'   => 'http://schema.org/founder',
-					'type'        => self::DATA_TYPE_URI,
-					'export_type' => 'http://schema.org/Person',
-					'constraints' => array(
-						'uri_type'    => 'Person',
-						'cardinality' => INF,
-					),
-				),
-				self::FIELD_ADDRESS             => array(
-					'predicate'   => 'http://schema.org/streetAddress',
-					'type'        => self::DATA_TYPE_STRING,
-					'export_type' => 'xsd:string',
-					'constraints' => '',
-					// To build custom metabox.
-					'input_field' => 'address',
-				),
-				self::FIELD_ADDRESS_PO_BOX      => array(
-					'predicate'   => 'http://schema.org/postOfficeBoxNumber',
-					'type'        => self::DATA_TYPE_STRING,
-					'export_type' => 'xsd:string',
-					'constraints' => '',
-					// To build custom metabox.
-					'input_field' => 'address',
-				),
-				self::FIELD_ADDRESS_POSTAL_CODE => array(
-					'predicate'   => 'http://schema.org/postalCode',
-					'type'        => self::DATA_TYPE_STRING,
-					'export_type' => 'xsd:string',
-					'constraints' => '',
-					// To build custom metabox.
-					'input_field' => 'address',
-				),
-				self::FIELD_ADDRESS_LOCALITY    => array(
-					'predicate'   => 'http://schema.org/addressLocality',
-					'type'        => self::DATA_TYPE_STRING,
-					'export_type' => 'xsd:string',
-					'constraints' => '',
-					// To build custom metabox.
-					'input_field' => 'address',
-				),
-				self::FIELD_ADDRESS_REGION      => array(
-					'predicate'   => 'http://schema.org/addressRegion',
-					'type'        => self::DATA_TYPE_STRING,
-					'export_type' => 'xsd:string',
-					'constraints' => '',
-					// To build custom metabox.
-					'input_field' => 'address',
-				),
-				self::FIELD_ADDRESS_COUNTRY     => array(
-					'predicate'   => 'http://schema.org/addressCountry',
-					'type'        => self::DATA_TYPE_STRING,
-					'export_type' => 'xsd:string',
-					'constraints' => '',
-					// To build custom metabox.
-					'input_field' => 'address',
-				),
-				self::FIELD_EMAIL               => array(
-					'predicate'   => 'http://schema.org/email',
-					'type'        => self::DATA_TYPE_STRING,
-					'export_type' => 'xsd:string',
-					'constraints' => '',
-				),
-				self::FIELD_TELEPHONE           => array(
-					'predicate'   => 'http://schema.org/telephone',
-					'type'        => self::DATA_TYPE_STRING,
-					'export_type' => 'xsd:string',
-					'constraints' => '',
-				),
-			),
-			'linked_data'   => array(
-				// ### schema:legalName.
-				$this->rendition_factory->create(
-					$this->storage_factory->post_meta( self::FIELD_LEGAL_NAME ),
-					'http://schema.org/legalName'
-				),
-				// ### schema:founder.
-				$this->rendition_factory->create(
-					$this->storage_factory->post_meta_to_uri( self::FIELD_FOUNDER ),
-					'http://schema.org/founder',
-					self::DATA_TYPE_URI
-				),
-				// ### schema:email.
-				$this->rendition_factory->create(
-					$this->storage_factory->post_meta( self::FIELD_EMAIL ),
-					'http://schema.org/email'
-				),
-				// ### schema:telephone.
-				$this->rendition_factory->create(
-					$this->storage_factory->post_meta( self::FIELD_TELEPHONE ),
-					'http://schema.org/telephone'
-				),
-			),
-			'templates'     => array(
-				'subtitle' => '{{id}}',
-			),
-		);
-
-		// Merge the custom fields with those provided by the thing schema.
-		$parent_schema           = $this->get_thing_schema();
-		$schema['custom_fields'] = array_merge( $schema['custom_fields'], $parent_schema['custom_fields'] );
-		$schema['linked_data']   = array_merge( $schema['linked_data'], $parent_schema['linked_data'] );
-
-		return $schema;
-	}
-
-	/**
-	 * Get the 'person' schema.
-	 *
-	 * @return array An array with the schema configuration.
-	 *
-	 * @since 3.1.0
-	 */
-	private function get_person_schema() {
-
-		$schema = array(
-			'label'         => 'Person',
-			'description'   => 'A person (or a music artist).',
-			'parents'       => array( 'thing' ),
-			'css_class'     => 'wl-person',
-			'uri'           => 'http://schema.org/Person',
-			'same_as'       => array(
-				'http://rdf.freebase.com/ns/people.person',
-				'http://rdf.freebase.com/ns/music.artist',
-				'http://dbpedia.org/class/yago/LivingPeople',
-			),
-			'custom_fields' => array(
-				self::FIELD_KNOWS       => array(
-					'predicate'   => 'http://schema.org/knows',
-					'type'        => self::DATA_TYPE_URI,
-					'export_type' => 'http://schema.org/Person',
-					'constraints' => array(
-						'uri_type'    => 'Person',
-						'cardinality' => INF,
-					),
-				),
-				self::FIELD_BIRTH_DATE  => array(
-					'predicate'   => 'http://schema.org/birthDate',
-					'type'        => self::DATA_TYPE_DATE,
-					'export_type' => 'xsd:date',
-					'constraints' => '',
-				),
-				self::FIELD_BIRTH_PLACE => array(
-					'predicate'   => 'http://schema.org/birthPlace',
-					'type'        => self::DATA_TYPE_URI,
-					'export_type' => 'http://schema.org/Place',
-					'constraints' => array(
-						'uri_type' => 'Place',
-					),
-				),
-				self::FIELD_AFFILIATION => array(
-					'predicate'   => 'http://schema.org/affiliation',
-					'type'        => self::DATA_TYPE_URI,
-					'export_type' => 'http://schema.org/Organization',
-					'constraints' => array(
-						'uri_type'    => array(
-							'Organization',
-							'LocalBusiness',
-						),
-						'cardinality' => INF,
-					),
-				),
-				self::FIELD_EMAIL       => array(
-					'predicate'   => 'http://schema.org/email',
-					'type'        => self::DATA_TYPE_STRING,
-					'export_type' => 'xsd:string',
-					'constraints' => array(
-						'cardinality' => INF,
-					),
-				),
-			),
-			'linked_data'   => array(
-				// ### schema:knows.
-				$this->rendition_factory->create(
-					$this->storage_factory->post_meta_to_uri( self::FIELD_KNOWS ),
-					'http://schema.org/knows',
-					self::DATA_TYPE_URI
-				),
-				// ### schema:birthDate.
-				$this->rendition_factory->create(
-					$this->storage_factory->post_meta( self::FIELD_BIRTH_DATE ),
-					'http://schema.org/birthDate',
-					self::DATA_TYPE_DATE
-				),
-				// ### schema:birthPlace.
-				$this->rendition_factory->create(
-					$this->storage_factory->post_meta_to_uri( self::FIELD_BIRTH_PLACE ),
-					'http://schema.org/birthPlace',
-					self::DATA_TYPE_URI
-				),
-				// ### schema:affiliation.
-				$this->rendition_factory->create(
-					$this->storage_factory->post_meta_to_uri( self::FIELD_AFFILIATION ),
-					'http://schema.org/affiliation',
-					self::DATA_TYPE_URI
-				),
-				// ### schema:email.
-				$this->rendition_factory->create(
-					$this->storage_factory->post_meta( self::FIELD_EMAIL ),
-					'http://schema.org/email'
-				),
-			),
-			'templates'     => array(
-				'subtitle' => '{{id}}',
-			),
-		);
-
-		// Merge the custom fields with those provided by the thing schema.
-		$parent_schema           = $this->get_thing_schema();
-		$schema['custom_fields'] = array_merge( $schema['custom_fields'], $parent_schema['custom_fields'] );
-		$schema['linked_data']   = array_merge( $schema['linked_data'], $parent_schema['linked_data'] );
-
-		return $schema;
-
-	}
-
-	/**
-	 * Get the 'place' schema.
-	 *
-	 * @return array An array with the schema configuration.
-	 *
-	 * @since 3.1.0
-	 */
-	private function get_place_schema() {
-
-		$schema = array(
-			'label'         => 'Place',
-			'description'   => 'A place.',
-			'parents'       => array( 'thing' ),
-			'css_class'     => 'wl-place',
-			'uri'           => 'http://schema.org/Place',
-			'same_as'       => array(
-				'http://rdf.freebase.com/ns/location.location',
-				'http://www.opengis.net/gml/_Feature',
-			),
-			'custom_fields' => array(
-				self::FIELD_GEO_LATITUDE        => array(
-					'predicate'   => 'http://schema.org/latitude',
-					'type'        => self::DATA_TYPE_DOUBLE,
-					'export_type' => 'xsd:double',
-					'constraints' => '',
-					// To build custom metabox.
-					'input_field' => 'coordinates',
-				),
-				self::FIELD_GEO_LONGITUDE       => array(
-					'predicate'   => 'http://schema.org/longitude',
-					'type'        => self::DATA_TYPE_DOUBLE,
-					'export_type' => 'xsd:double',
-					'constraints' => '',
-					// To build custom metabox.
-					'input_field' => 'coordinates',
-				),
-				self::FIELD_ADDRESS             => array(
-					'predicate'   => 'http://schema.org/streetAddress',
-					'type'        => self::DATA_TYPE_STRING,
-					'export_type' => 'xsd:string',
-					'constraints' => '',
-					// To build custom metabox.
-					'input_field' => 'address',
-				),
-				self::FIELD_ADDRESS_PO_BOX      => array(
-					'predicate'   => 'http://schema.org/postOfficeBoxNumber',
-					'type'        => self::DATA_TYPE_STRING,
-					'export_type' => 'xsd:string',
-					'constraints' => '',
-					// To build custom metabox.
-					'input_field' => 'address',
-				),
-				self::FIELD_ADDRESS_POSTAL_CODE => array(
-					'predicate'   => 'http://schema.org/postalCode',
-					'type'        => self::DATA_TYPE_STRING,
-					'export_type' => 'xsd:string',
-					'constraints' => '',
-					// To build custom metabox.
-					'input_field' => 'address',
-				),
-				self::FIELD_ADDRESS_LOCALITY    => array(
-					'predicate'   => 'http://schema.org/addressLocality',
-					'type'        => self::DATA_TYPE_STRING,
-					'export_type' => 'xsd:string',
-					'constraints' => '',
-					// To build custom metabox.
-					'input_field' => 'address',
-				),
-				self::FIELD_ADDRESS_REGION      => array(
-					'predicate'   => 'http://schema.org/addressRegion',
-					'type'        => self::DATA_TYPE_STRING,
-					'export_type' => 'xsd:string',
-					'constraints' => '',
-					// To build custom metabox.
-					'input_field' => 'address',
-				),
-				self::FIELD_ADDRESS_COUNTRY     => array(
-					'predicate'   => 'http://schema.org/addressCountry',
-					'type'        => self::DATA_TYPE_STRING,
-					'export_type' => 'xsd:string',
-					'constraints' => '',
-					// To build custom metabox.
-					'input_field' => 'address',
-				),
-			),
-			'linked_data'   => array(),
-			'templates'     => array(
-				'subtitle' => '{{id}}',
-			),
-		);
-
-		// Merge the custom fields with those provided by the thing schema.
-		$parent_schema           = $this->get_thing_schema();
-		$schema['custom_fields'] = array_merge( $schema['custom_fields'], $parent_schema['custom_fields'] );
-		$schema['linked_data']   = array_merge( $schema['linked_data'], $parent_schema['linked_data'] );
-
-		return $schema;
-	}
-
-	/**
-	 * Get the 'local business' schema.
-	 *
-	 * @return array An array with the schema configuration.
-	 *
-	 * @since 3.1.0
-	 */
-	private function get_local_business_schema() {
-
-		$schema = array(
-			'label'         => 'LocalBusiness',
-			'description'   => 'A local business.',
-			'parents'       => array( 'place', 'organization' ),
-			'css_class'     => 'wl-local-business',
-			'uri'           => 'http://schema.org/LocalBusiness',
-			'same_as'       => array(
-				'http://rdf.freebase.com/ns/business/business_location',
-				'https://schema.org/Store',
-			),
-			'custom_fields' => array(),
-			'linked_data'   => array(),
-			'templates'     => array(
-				'subtitle' => '{{id}}',
-			),
-		);
-
-		// Merge the custom fields with those provided by the place and organization schema.
-		$place_schema            = $this->get_place_schema();
-		$organization_schema     = $this->get_organization_schema();
-		$schema['custom_fields'] = array_merge( $schema['custom_fields'], $place_schema['custom_fields'], $organization_schema['custom_fields'] );
-		$schema['linked_data']   = array_merge( $schema['linked_data'], $place_schema['linked_data'], $organization_schema['linked_data'] );
-
-		return $schema;
-	}
-
-	/**
-	 * Get the 'recipe' schema.
-	 *
-	 * @return array An array with the schema configuration.
-	 *
-	 * @since 3.14.0
-	 */
-	private function get_recipe_schema() {
-
-		$schema = array(
-			'label'         => 'Recipe',
-			'description'   => 'A Recipe.',
-			'parents'       => array( 'CreativeWork' ),
-			'css_class'     => 'wl-recipe',
-			'uri'           => 'http://schema.org/Recipe',
-			'same_as'       => array(),
-			'templates'     => array(
-				'subtitle' => '{{id}}',
-			),
-			'custom_fields' => array(
-				self::FIELD_RECIPE_CUISINE          => array(
-					'predicate'   => 'http://schema.org/recipeCuisine',
-					'type'        => self::DATA_TYPE_STRING,
-					'export_type' => 'xsd:string',
-					'constraints' => '',
-					'metabox'     => array(
-						'label' => __( 'Recipe cuisine', 'wordlift' ),
-					),
-				),
-				self::FIELD_RECIPE_INGREDIENT       => array(
-					'predicate'   => 'http://schema.org/recipeIngredient',
-					'type'        => self::DATA_TYPE_STRING,
-					'export_type' => 'xsd:string',
-					'constraints' => array(
-						'cardinality' => INF,
-					),
-					'metabox'     => array(
-						'label' => __( 'Recipe ingredient', 'wordlift' ),
-					),
-				),
-				self::FIELD_RECIPE_INSTRUCTIONS     => array(
-					'predicate'   => 'http://schema.org/recipeInstructions',
-					'type'        => self::DATA_TYPE_MULTILINE,
-					'export_type' => 'xsd:string',
-					'constraints' => '',
-					'metabox'     => array(
-						'class' => 'Wordlift_Metabox_Field_Multiline',
-						'label' => __( 'Recipe instructions', 'wordlift' ),
-					),
-				),
-				self::FIELD_RECIPE_YIELD            => array(
-					'predicate'   => 'http://schema.org/recipeYield',
-					'type'        => self::DATA_TYPE_STRING,
-					'export_type' => 'xsd:string',
-					'constraints' => '',
-					'metabox'     => array(
-						'label' => __( 'Recipe number of servings', 'wordlift' ),
-					),
-				),
-				self::FIELD_RECIPE_INGREDIENT       => array(
-					'predicate'   => 'http://schema.org/recipeIngredient',
-					'type'        => self::DATA_TYPE_STRING,
-					'export_type' => 'xsd:string',
-					'constraints' => array(
-						'cardinality' => INF,
-					),
-					'metabox'     => array(
-						'label' => __( 'Recipe ingredient', 'wordlift' ),
-					),
-				),
-				self::FIELD_NUTRITION_INFO_CALORIES => array(
-					'predicate'   => 'http://schema.org/calories',
-					'type'        => self::DATA_TYPE_STRING,
-					'export_type' => 'xsd:string',
-					'constraints' => '',
-					'metabox'     => array(
-						'label' => __( 'Calories (e.g. 240 calories)', 'wordlift' ),
-					),
-				),
-				self::FIELD_PREP_TIME               => array(
-					'predicate'   => 'http://schema.org/prepTime',
-					'type'        => self::DATA_TYPE_DURATION,
-					'export_type' => 'xsd:time',
-					'constraints' => '',
-					'metabox'     => array(
-						'class' => 'Wordlift_Metabox_Field_Duration',
-						'label' => __( 'Recipe preparation time (e.g. 1:30)', 'wordlift' ),
-					),
-				),
-				self::FIELD_COOK_TIME               => array(
-					'predicate'   => 'http://schema.org/cookTime',
-					'type'        => self::DATA_TYPE_DURATION,
-					'export_type' => 'xsd:time',
-					'constraints' => '',
-					'metabox'     => array(
-						'class' => 'Wordlift_Metabox_Field_Duration',
-						'label' => __( 'Recipe cook time (e.g. 1:30)', 'wordlift' ),
-					),
-				),
-				self::FIELD_TOTAL_TIME              => array(
-					'predicate'   => 'http://schema.org/totalTime',
-					'type'        => self::DATA_TYPE_DURATION,
-					'export_type' => 'xsd:time',
-					'constraints' => '',
-					'metabox'     => array(
-						'class' => 'Wordlift_Metabox_Field_Duration',
-						'label' => __( 'Recipe total time (e.g. 1:30)', 'wordlift' ),
-					),
-				),
-			),
-			'linked_data'   => array(
-				// ### schema:recipeCuisine.
-				$this->rendition_factory->create(
-					$this->storage_factory->post_meta( self::FIELD_RECIPE_CUISINE ),
-					'http://schema.org/recipeCuisine'
-				),
-				// ### schema:recipeIngredient.
-				$this->rendition_factory->create(
-					$this->storage_factory->post_meta( self::FIELD_RECIPE_INGREDIENT ),
-					'http://schema.org/recipeIngredient'
-				),
-				// ### schema:prepTime.
-				$this->rendition_factory->create(
-					$this->storage_factory->post_meta( self::FIELD_PREP_TIME ),
-					'http://schema.org/prepTime',
-					self::DATA_TYPE_DURATION
-				),
-				// ### schema:cookTime.
-				$this->rendition_factory->create(
-					$this->storage_factory->post_meta( self::FIELD_COOK_TIME ),
-					'http://schema.org/cookTime',
-					self::DATA_TYPE_DURATION
-				),
-				// ### schema:totalTime.
-				$this->rendition_factory->create(
-					$this->storage_factory->post_meta( self::FIELD_TOTAL_TIME ),
-					'http://schema.org/totalTime',
-					self::DATA_TYPE_DURATION
-				),
-			),
-		);
-
-		// Merge the custom fields with those provided by the parent schema.
-		$parent_schema           = $this->get_creative_work_schema();
-		$schema['custom_fields'] = array_merge( $schema['custom_fields'], $parent_schema['custom_fields'] );
-		$schema['linked_data']   = array_merge( $schema['linked_data'], $parent_schema['linked_data'] );
-
-		return $schema;
-	}
-
-	/**
-	 * Get the 'article' schema.
-	 *
-	 * @return array An array with the schema configuration.
-	 *
-	 * @since 3.15.0
-	 */
-	private function get_article_schema() {
-
-		$schema = array(
-			'label'         => 'Article',
-			'description'   => 'An Article.',
-			'parents'       => array(),
-			'css_class'     => 'wl-article',
-			'uri'           => 'http://schema.org/Article',
-			'same_as'       => array(),
-			'templates'     => array(
-				'subtitle' => '{{id}}',
-			),
-			'custom_fields' => array(),
-			'linked_data'   => array(),
-		);
-
-		return $schema;
-	}
-
-	/**
-	 * Get all the predicates.
-	 *
-	 * @since 3.15.0
-	 *
-	 * @return array An array of predicates.
-	 */
-	public function get_all_predicates() {
-
-		// Get the custom fields.
-		$renditions = array_reduce( $this->schema, function ( $carry, $item ) {
-			return array_merge( $carry, $item['linked_data'] );
-		}, array() );
-
-		// Create a new array of predicates from the custom fields. The initial
-		// array contains just the `http://www.w3.org/1999/02/22-rdf-syntax-ns#type`
-		// (a, rdf:type) predicate (use the full URI).
-		$predicates = array_unique( array_reduce( $renditions, function ( $carry, $item ) {
-			return array_merge( $carry, (array) $item->get_predicate() );
-		}, array() ) );
-
-		/**
-		 * Filter: 'wl_schema_predicates' - Allow third parties to hook and add additional predicates.
-		 *
-		 * @since  3.17.0
-		 * @api arr $predicates Schema.org predicates.
-		 */
-		return apply_filters( 'wl_schema_predicates', $predicates );
-	}
+    /**
+     * The 'location created' field name.
+     *
+     * @since 3.5.0
+     */
+    const FIELD_LOCATION_CREATED = 'wl_location_created';
+
+    /**
+     * The 'topic' field name.
+     *
+     * @since 3.5.0
+     */
+    const FIELD_TOPIC = 'wl_topic';
+
+    /**
+     * The 'author' field name.
+     *
+     * @since 3.1.0
+     */
+    const FIELD_AUTHOR = 'wl_author';
+
+    /**
+     * The 'same as' field name.
+     *
+     * @since 3.1.0
+     */
+    const FIELD_SAME_AS = 'entity_same_as';
+
+    /**
+     * The 'date start' field name.
+     *
+     * @since 3.1.0
+     */
+    const FIELD_DATE_START = 'wl_cal_date_start';
+
+    /**
+     * The 'date end' field name.
+     *
+     * @since 3.1.0
+     */
+    const FIELD_DATE_END = 'wl_cal_date_end';
+
+    /**
+     * The 'location' field name.
+     *
+     * @since 3.1.0
+     */
+    const FIELD_LOCATION = 'wl_location';
+
+    /**
+     * The 'founder' field name.
+     *
+     * @since 3.1.0
+     */
+    const FIELD_FOUNDER = 'wl_founder';
+
+    /**
+     * The 'knows' field name.
+     *
+     * @since 3.1.0
+     */
+    const FIELD_KNOWS = 'wl_knows';
+
+    /**
+     * The 'birth date' field name.
+     *
+     * @since 3.1.0
+     */
+    const FIELD_BIRTH_DATE = 'wl_birth_date';
+
+    /**
+     * The 'birth place' field name.
+     *
+     * @since 3.1.0
+     */
+    const FIELD_BIRTH_PLACE = 'wl_birth_place';
+
+    /**
+     * The 'latitude' field name.
+     *
+     * @since 3.1.0
+     */
+    const FIELD_GEO_LATITUDE = 'wl_geo_latitude';
+
+    /**
+     * The 'longitude' field name.
+     *
+     * @since 3.1.0
+     */
+    const FIELD_GEO_LONGITUDE = 'wl_geo_longitude';
+
+    /**
+     * The 'streetAddress' field name.
+     *
+     * @since 3.1.0
+     */
+    const FIELD_ADDRESS = 'wl_address';
+
+    /**
+     * The 'postOfficeBoxNumber' field name.
+     *
+     * @since 3.3.0
+     */
+    const FIELD_ADDRESS_PO_BOX = 'wl_address_post_office_box';
+
+    /**
+     * The 'postalCode' field name.
+     *
+     * @since 3.3.0
+     */
+    const FIELD_ADDRESS_POSTAL_CODE = 'wl_address_postal_code';
+
+    /**
+     * The 'addressLocality' field name.
+     *
+     * @since 3.3.0
+     */
+    const FIELD_ADDRESS_LOCALITY = 'wl_address_locality';
+    /**
+     * The 'addressRegion' field name.
+     *
+     * @since 3.3.0
+     */
+    const FIELD_ADDRESS_REGION = 'wl_address_region';
+
+    /**
+     * The 'addressCountry' field name.
+     *
+     * @since 3.3.0
+     */
+    const FIELD_ADDRESS_COUNTRY = 'wl_address_country';
+
+    /**
+     * The 'entity type' field name.
+     *
+     * @since 3.1.0
+     */
+    const FIELD_ENTITY_TYPE = 'wl_entity_type_uri';
+
+    /**
+     * The 'email' field name.
+     *
+     * @since 3.2.0
+     */
+    const FIELD_EMAIL = 'wl_email';
+
+    /**
+     * The 'affiliation' field name.
+     *
+     * @since 3.2.0
+     */
+    const FIELD_AFFILIATION = 'wl_affiliation';
+
+    /**
+     * The 'telephone' field name.
+     *
+     * @since 3.8.0
+     */
+    const FIELD_TELEPHONE = 'wl_schema_telephone';
+
+    /**
+     * The 'legalName' field name.
+     *
+     * @since 3.12.0
+     */
+    const FIELD_LEGAL_NAME = 'wl_schema_legal_name';
+
+    /**
+     * The 'recipeCuisine' field name.
+     *
+     * @since 3.14.0
+     */
+    const FIELD_RECIPE_CUISINE = 'wl_schema_recipe_cuisine';
+
+    /**
+     * The 'recipeIngredient' field name.
+     *
+     * @since 3.14.0
+     */
+    const FIELD_RECIPE_INGREDIENT = 'wl_schema_recipe_ingredient';
+
+    /**
+     * The 'calories' field name.
+     *
+     * @since 3.14.0
+     */
+    const FIELD_NUTRITION_INFO_CALORIES = 'wl_schema_nutrition_information_calories';
+
+    /**
+     * The 'recipeInstructions' field name.
+     *
+     * @since 3.14.0
+     */
+    const FIELD_RECIPE_INSTRUCTIONS = 'wl_schema_recipe_instructions';
+
+    /**
+     * The 'recipeYield' field name.
+     *
+     * @since 3.14.0
+     */
+    const FIELD_RECIPE_YIELD = 'wl_schema_recipe_yield';
+
+    /**
+     * The 'prepTime' field name.
+     *
+     * @since 3.14.0
+     */
+    const FIELD_PREP_TIME = 'wl_schema_prep_time';
+
+    /**
+     * The 'cookTime' field name.
+     *
+     * @since 3.14.0
+     */
+    const FIELD_COOK_TIME = 'wl_schema_cook_time';
+
+    /**
+     * The 'totalTime' field name.
+     *
+     * @since 3.14.0
+     */
+    const FIELD_TOTAL_TIME = 'wl_schema_total_time';
+
+    /**
+     * The 'URI' data type name.
+     *
+     * @since 3.1.0
+     */
+    const DATA_TYPE_URI = 'uri';
+
+    /**
+     * The 'date' data type name.
+     *
+     * @since 3.1.0
+     */
+    const DATA_TYPE_DATE = 'date';
+
+    /**
+     * The 'dateTime' data type name.
+     *
+     * @since 3.15.0
+     */
+    const DATA_TYPE_DATE_TIME = 'dateTime';
+
+    /**
+     * The 'time' data type name.
+     *
+     * @since 3.14.0
+     */
+    const DATA_TYPE_DURATION = 'duration';
+
+    /**
+     * The 'double' data type name.
+     *
+     * @since 3.1.0
+     */
+    const DATA_TYPE_DOUBLE = 'double';
+
+    /**
+     * The 'string' data type name.
+     *
+     * @since 3.1.0
+     */
+    const DATA_TYPE_STRING = 'string';
+
+    /**
+     * The multiline text data type name.
+     *
+     * @since 3.14.0
+     */
+    const DATA_TYPE_MULTILINE = 'multiline';
+
+    /**
+     * The 'integer' data type name.
+     *
+     * @since 3.1.0
+     */
+    const DATA_TYPE_INTEGER = 'int';
+
+    /**
+     * The 'boolean' data type name.
+     *
+     * @since 3.1.0
+     */
+    const DATA_TYPE_BOOLEAN = 'bool';
+
+    /**
+     * The schema.org Event type URI.
+     *
+     * @since 3.1.0
+     */
+    const SCHEMA_EVENT_TYPE = 'http://schema.org/Event';
+
+    /**
+     * The Schema service singleton instance.
+     *
+     * @since  3.1.0
+     * @access private
+     * @var \Wordlift_Schema_Service $instance The Schema service singleton instance.
+     */
+    private static $instance;
+
+    /**
+     * WordLift's schema.
+     *
+     * @since  3.1.0
+     * @access private
+     * @var array $schema WordLift's schema.
+     */
+    private $schema;
+
+    /**
+     * The Log service.
+     *
+     * @since  3.1.0
+     * @access private
+     * @var \Wordlift_Log_Service $log The Log service.
+     */
+    private $log;
+
+    /**
+     * The {@link Wordlift_Post_Property_Storage_Factory} instance.
+     *
+     * @since  3.15.0
+     * @access private
+     * @var \Wordlift_Storage_Factory $storage_factory The {@link Wordlift_Post_Property_Storage_Factory} instance.
+     */
+    private $storage_factory;
+
+    /**
+     * The {@link Wordlift_Sparql_Tuple_Rendition_Factory} instance.
+     *
+     * @since  3.15.0
+     * @access private
+     * @var \Wordlift_Sparql_Tuple_Rendition_Factory $rendition_factory The {@link Wordlift_Sparql_Tuple_Rendition_Factory} instance.
+     */
+    private $rendition_factory;
+
+    /**
+     * The {@link Wordlift_Configuration_Service} instance.
+     *
+     * @since  3.15.0
+     * @access private
+     * @var \Wordlift_Configuration_Service $configuration_service The {@link Wordlift_Configuration_Service} instance.
+     */
+    private $configuration_service;
+
+    /**
+     * The web site configured language code.
+     *
+     * @since  3.15.0
+     * @access private
+     * @var string $language_code The web site configured language code.
+     */
+    private $language_code;
+
+    /**
+     * Wordlift_Schema_Service constructor.
+     *
+     * @since 3.1.0
+     *
+     * @param \Wordlift_Storage_Factory                $storage_factory       The {@link Wordlift_Post_Property_Storage_Factory} instance.
+     * @param \Wordlift_Sparql_Tuple_Rendition_Factory $rendition_factory     The {@link Wordlift_Sparql_Tuple_Rendition_Factory} instance.
+     * @param \Wordlift_Configuration_Service          $configuration_service The {@link Wordlift_Configuration_Service} instance.
+     */
+    public function __construct( $storage_factory, $rendition_factory, $configuration_service ) {
+
+        $this->log = Wordlift_Log_Service::get_logger( 'Wordlift_Schema_Service' );
+
+        $this->storage_factory       = $storage_factory;
+        $this->rendition_factory     = $rendition_factory;
+        $this->configuration_service = $configuration_service;
+        $this->language_code         = $this->configuration_service->get_language_code();
+
+        // Set the taxonomy data.
+        // Note: parent types must be defined before child types.
+        $this->schema = array(
+            'article'       => $this->get_article_schema(),
+            'thing'         => $this->get_thing_schema(),
+            'creative-work' => $this->get_creative_work_schema(),
+            'event'         => $this->get_event_schema(),
+            'organization'  => $this->get_organization_schema(),
+            'person'        => $this->get_person_schema(),
+            'place'         => $this->get_place_schema(),
+            'localbusiness' => $this->get_local_business_schema(),
+            'recipe'        => $this->get_recipe_schema(),
+        );
+
+        // Create a singleton instance of the Schema service, useful to provide static functions to global functions.
+        self::$instance = $this;
+
+    }
+
+    /**
+     * Get a reference to the Schema service.
+     *
+     * @since 3.1.0
+     *
+     * @return Wordlift_Schema_Service A reference to the Schema service.
+     */
+    public static function get_instance() {
+
+        return self::$instance;
+    }
+
+    /**
+     * Get the properties for a field with the specified key. The key is used as
+     * meta key when the field's value is stored in WordPress meta data table.
+     *
+     * @since 3.6.0
+     *
+     * @param string $key The field's key.
+     *
+     * @return null|array An array of field's properties or null if the field is not found.
+     */
+    public function get_field( $key ) {
+
+        // Parse each schema's fields until we find the one we're looking for, then
+        // return its properties.
+        foreach ( $this->schema as $_ => $schema ) {
+
+            if ( ! isset( $schema['custom_fields'] ) ) {
+                break;
+            }
+
+            foreach ( $schema['custom_fields'] as $field => $props ) {
+                if ( $key === $field ) {
+                    return $props;
+                }
+            }
+        }
+
+        return null;
+    }
+
+    /**
+     * Get the WordLift's schema.
+     *
+     * @param string $name The schema name.
+     *
+     * @return array|null An array with the schema configuration or NULL if the schema is not found.
+     *
+     * @since 3.1.0
+     */
+    public function get_schema( $name ) {
+        // Check if the schema exists and, if not, return NULL.
+        if ( ! isset( $this->schema[ $name ] ) ) {
+            return null;
+        }
+
+        // Return the requested schema.
+        return $this->schema[ $name ];
+    }
+
+    /**
+     * Get the WordLift's schema trough schema type uri.
+     *
+     * @param string $uri The schema uri.
+     *
+     * @return array|null An array with the schema configuration or NULL if the schema is not found.
+     *
+     * @since 3.3.0
+     */
+    public function get_schema_by_uri( $uri ) {
+
+        foreach ( $this->schema as $name => $schema ) {
+            if ( $schema['uri'] === $uri ) {
+                return $schema;
+            }
+        }
+
+        return null;
+    }
+
+    /**
+     * Get the 'thing' schema.
+     *
+     * @return array An array with the schema configuration.
+     *
+     * @since 3.1.0
+     */
+    private function get_thing_schema() {
+
+        return array(
+            'css_class'     => 'wl-thing',
+            'uri'           => 'http://schema.org/Thing',
+            'same_as'       => array( '*' ),
+            // set as default.
+            'custom_fields' => array(
+                self::FIELD_SAME_AS                            => array(
+                    'predicate'   => 'http://schema.org/sameAs',
+                    'type'        => self::DATA_TYPE_URI,
+                    'export_type' => 'http://schema.org/Thing',
+                    'constraints' => array(
+                        'cardinality' => INF,
+                    ),
+                    // We need a custom metabox.
+                    'input_field' => 'sameas',
+                ),
+                // Add the schema:url property.
+                Wordlift_Schema_Url_Property_Service::META_KEY => Wordlift_Schema_Url_Property_Service::get_instance()
+                                                                                                        ->get_compat_definition(),
+            ),
+            // {{sameAs}} not present in the microdata template,
+            // because it is treated separately in *wl_content_embed_item_microdata*
+            'templates'     => array(
+                'subtitle' => '{{id}}',
+            ),
+            'linked_data'   => array(
+                // ### Title to rdfs:label.
+                $this->rendition_factory->create(
+                    $this->storage_factory->post_title(),
+                    Wordlift_Query_Builder::RDFS_LABEL_URI,
+                    null,
+                    $this->language_code
+                ),
+                // ### Title to dct:title.
+                $this->rendition_factory->create(
+                    $this->storage_factory->post_title(),
+                    'http://purl.org/dc/terms/title',
+                    null,
+                    $this->language_code
+                ),
+                // ### Alternative title to rdfs:label.
+                $this->rendition_factory->create(
+                    $this->storage_factory->post_meta( Wordlift_Entity_Service::ALTERNATIVE_LABEL_META_KEY ),
+                    Wordlift_Query_Builder::RDFS_LABEL_URI,
+                    null,
+                    $this->language_code
+                ),
+                // ### Alternative title to dct:title.
+                $this->rendition_factory->create(
+                    $this->storage_factory->post_meta( Wordlift_Entity_Service::ALTERNATIVE_LABEL_META_KEY ),
+                    'http://purl.org/dc/terms/title',
+                    null,
+                    $this->language_code
+                ),
+                // ### schema:url.
+                $this->rendition_factory->create(
+                    $this->storage_factory->url_property(),
+                    Wordlift_Query_Builder::SCHEMA_URL_URI,
+                    self::DATA_TYPE_URI
+                ),
+                // ### schema:description.
+                $this->rendition_factory->create(
+                    $this->storage_factory->post_description_no_tags_no_shortcodes(),
+                    'http://schema.org/description',
+                    null,
+                    $this->language_code
+                ),
+                // ### owl:sameAs.
+                $this->rendition_factory->create(
+                    $this->storage_factory->post_meta( self::FIELD_SAME_AS ),
+                    'http://www.w3.org/2002/07/owl#sameAs',
+                    self::DATA_TYPE_URI
+                ),
+                // ### rdf:type.
+                $this->rendition_factory->create(
+                    $this->storage_factory->schema_class( $this ),
+                    Wordlift_Query_Builder::RDFS_TYPE_URI,
+                    self::DATA_TYPE_URI
+                ),
+                // ### schema:image.
+                $this->rendition_factory->create(
+                    $this->storage_factory->post_images(),
+                    Wordlift_Query_Builder::SCHEMA_IMAGE_URI,
+                    self::DATA_TYPE_URI
+                ),
+                // ### dct:relation.
+                $this->rendition_factory->create(
+                    $this->storage_factory->relations(),
+                    Wordlift_Query_Builder::DCTERMS_RELATION_URI,
+                    self::DATA_TYPE_URI
+                ),
+            ),
+        );
+
+    }
+
+    /**
+     * Get the 'creative work' schema.
+     *
+     * @return array An array with the schema configuration.
+     *
+     * @since 3.1.0
+     */
+    private function get_creative_work_schema() {
+
+        $schema = array(
+            'label'         => 'CreativeWork',
+            'description'   => 'A creative work (or a Music Album).',
+            'parents'       => array( 'thing' ),
+            // Give term slug as parent.
+            'css_class'     => 'wl-creative-work',
+            'uri'           => 'http://schema.org/CreativeWork',
+            'same_as'       => array(
+                'http://schema.org/MusicAlbum',
+                'http://schema.org/Product',
+            ),
+            'custom_fields' => array(
+                self::FIELD_AUTHOR => array(
+                    'predicate'   => 'http://schema.org/author',
+                    'type'        => self::DATA_TYPE_URI,
+                    'export_type' => 'http://schema.org/Person',
+                    'constraints' => array(
+                        'uri_type'    => array( 'Person', 'Organization' ),
+                        'cardinality' => INF,
+                    ),
+                ),
+            ),
+            'linked_data'   => array(
+                // ### schema:author.
+                $this->rendition_factory->create(
+                    $this->storage_factory->author_uri(),
+                    Wordlift_Query_Builder::SCHEMA_AUTHOR_URI,
+                    self::DATA_TYPE_URI
+                ),
+            ),
+            'templates'     => array(
+                'subtitle' => '{{id}}',
+            ),
+        );
+
+        // Merge the custom fields with those provided by the thing schema.
+        $parent_schema           = $this->get_thing_schema();
+        $schema['custom_fields'] = array_merge( $schema['custom_fields'], $parent_schema['custom_fields'] );
+        $schema['linked_data']   = array_merge( $schema['linked_data'], $parent_schema['linked_data'] );
+
+        return $schema;
+    }
+
+    /**
+     * Get the 'event' schema.
+     *
+     * @return array An array with the schema configuration.
+     *
+     * @since 3.1.0
+     */
+    private function get_event_schema() {
+
+        $schema = array(
+            'label'         => 'Event',
+            'description'   => 'An event . ',
+            'parents'       => array( 'thing' ),
+            'css_class'     => 'wl-event',
+            'uri'           => self::SCHEMA_EVENT_TYPE,
+            'same_as'       => array( 'http://dbpedia.org/ontology/Event' ),
+            'custom_fields' => array(
+                self::FIELD_DATE_START => array(
+                    'predicate'   => 'http://schema.org/startDate',
+                    'type'        => self::DATA_TYPE_DATE,
+                    'export_type' => 'xsd:dateTime',
+                    'constraints' => '',
+                ),
+                self::FIELD_DATE_END   => array(
+                    'predicate'   => 'http://schema.org/endDate',
+                    'type'        => self::DATA_TYPE_DATE,
+                    'export_type' => 'xsd:dateTime',
+                    'constraints' => '',
+                ),
+                self::FIELD_LOCATION   => array(
+                    'predicate'   => 'http://schema.org/location',
+                    'type'        => self::DATA_TYPE_URI,
+                    'export_type' => 'http://schema.org/PostalAddress',
+                    'constraints' => array(
+                        'uri_type'    => array( 'Place', 'LocalBusiness' ),
+                        'cardinality' => INF,
+                    ),
+                ),
+            ),
+            'linked_data'   => array(
+                // ### schema:startDate.
+                $this->rendition_factory->create(
+                    $this->storage_factory->post_meta( self::FIELD_DATE_START ),
+                    'http://schema.org/startDate',
+                    self::DATA_TYPE_DATE_TIME
+                ),
+                // ### schema:endDate.
+                $this->rendition_factory->create(
+                    $this->storage_factory->post_meta( self::FIELD_DATE_END ),
+                    'http://schema.org/endDate',
+                    self::DATA_TYPE_DATE_TIME
+                ),
+                // ### schema:location.
+                $this->rendition_factory->create(
+                    $this->storage_factory->post_meta_to_uri( self::FIELD_LOCATION ),
+                    'http://schema.org/location',
+                    self::DATA_TYPE_URI
+                ),
+            ),
+            'templates'     => array(
+                'subtitle' => '{{id}}',
+            ),
+        );
+
+        // Merge the custom fields with those provided by the thing schema.
+        $parent_schema           = $this->get_thing_schema();
+        $schema['custom_fields'] = array_merge( $schema['custom_fields'], $parent_schema['custom_fields'] );
+        $schema['linked_data']   = array_merge( $schema['linked_data'], $parent_schema['linked_data'] );
+
+        return $schema;
+    }
+
+    /**
+     * Get the 'organization' schema.
+     *
+     * @return array An array with the schema configuration.
+     *
+     * @since 3.1.0
+     */
+    private function get_organization_schema() {
+
+        $schema = array(
+            'label'         => 'Organization',
+            'description'   => 'An organization, including a government or a newspaper.',
+            'parents'       => array( 'thing' ),
+            'css_class'     => 'wl-organization',
+            'uri'           => 'http://schema.org/Organization',
+            'same_as'       => array(
+                'http://rdf.freebase.com/ns/organization.organization',
+                'http://rdf.freebase.com/ns/government.government',
+                'http://schema.org/Newspaper',
+            ),
+            'custom_fields' => array(
+                self::FIELD_LEGAL_NAME          => array(
+                    'predicate'   => 'http://schema.org/legalName',
+                    'type'        => self::DATA_TYPE_STRING,
+                    'export_type' => 'xsd:string',
+                    'constraints' => '',
+                ),
+                self::FIELD_FOUNDER             => array(
+                    'predicate'   => 'http://schema.org/founder',
+                    'type'        => self::DATA_TYPE_URI,
+                    'export_type' => 'http://schema.org/Person',
+                    'constraints' => array(
+                        'uri_type'    => 'Person',
+                        'cardinality' => INF,
+                    ),
+                ),
+                self::FIELD_ADDRESS             => array(
+                    'predicate'   => 'http://schema.org/streetAddress',
+                    'type'        => self::DATA_TYPE_STRING,
+                    'export_type' => 'xsd:string',
+                    'constraints' => '',
+                    // To build custom metabox.
+                    'input_field' => 'address',
+                ),
+                self::FIELD_ADDRESS_PO_BOX      => array(
+                    'predicate'   => 'http://schema.org/postOfficeBoxNumber',
+                    'type'        => self::DATA_TYPE_STRING,
+                    'export_type' => 'xsd:string',
+                    'constraints' => '',
+                    // To build custom metabox.
+                    'input_field' => 'address',
+                ),
+                self::FIELD_ADDRESS_POSTAL_CODE => array(
+                    'predicate'   => 'http://schema.org/postalCode',
+                    'type'        => self::DATA_TYPE_STRING,
+                    'export_type' => 'xsd:string',
+                    'constraints' => '',
+                    // To build custom metabox.
+                    'input_field' => 'address',
+                ),
+                self::FIELD_ADDRESS_LOCALITY    => array(
+                    'predicate'   => 'http://schema.org/addressLocality',
+                    'type'        => self::DATA_TYPE_STRING,
+                    'export_type' => 'xsd:string',
+                    'constraints' => '',
+                    // To build custom metabox.
+                    'input_field' => 'address',
+                ),
+                self::FIELD_ADDRESS_REGION      => array(
+                    'predicate'   => 'http://schema.org/addressRegion',
+                    'type'        => self::DATA_TYPE_STRING,
+                    'export_type' => 'xsd:string',
+                    'constraints' => '',
+                    // To build custom metabox.
+                    'input_field' => 'address',
+                ),
+                self::FIELD_ADDRESS_COUNTRY     => array(
+                    'predicate'   => 'http://schema.org/addressCountry',
+                    'type'        => self::DATA_TYPE_STRING,
+                    'export_type' => 'xsd:string',
+                    'constraints' => '',
+                    // To build custom metabox.
+                    'input_field' => 'address',
+                ),
+                self::FIELD_EMAIL               => array(
+                    'predicate'   => 'http://schema.org/email',
+                    'type'        => self::DATA_TYPE_STRING,
+                    'export_type' => 'xsd:string',
+                    'constraints' => '',
+                ),
+                self::FIELD_TELEPHONE           => array(
+                    'predicate'   => 'http://schema.org/telephone',
+                    'type'        => self::DATA_TYPE_STRING,
+                    'export_type' => 'xsd:string',
+                    'constraints' => '',
+                ),
+            ),
+            'linked_data'   => array(
+                // ### schema:legalName.
+                $this->rendition_factory->create(
+                    $this->storage_factory->post_meta( self::FIELD_LEGAL_NAME ),
+                    'http://schema.org/legalName'
+                ),
+                // ### schema:founder.
+                $this->rendition_factory->create(
+                    $this->storage_factory->post_meta_to_uri( self::FIELD_FOUNDER ),
+                    'http://schema.org/founder',
+                    self::DATA_TYPE_URI
+                ),
+                // ### schema:email.
+                $this->rendition_factory->create(
+                    $this->storage_factory->post_meta( self::FIELD_EMAIL ),
+                    'http://schema.org/email'
+                ),
+                // ### schema:telephone.
+                $this->rendition_factory->create(
+                    $this->storage_factory->post_meta( self::FIELD_TELEPHONE ),
+                    'http://schema.org/telephone'
+                ),
+            ),
+            'templates'     => array(
+                'subtitle' => '{{id}}',
+            ),
+        );
+
+        // Merge the custom fields with those provided by the thing schema.
+        $parent_schema           = $this->get_thing_schema();
+        $schema['custom_fields'] = array_merge( $schema['custom_fields'], $parent_schema['custom_fields'] );
+        $schema['linked_data']   = array_merge( $schema['linked_data'], $parent_schema['linked_data'] );
+
+        return $schema;
+    }
+
+    /**
+     * Get the 'person' schema.
+     *
+     * @return array An array with the schema configuration.
+     *
+     * @since 3.1.0
+     */
+    private function get_person_schema() {
+
+        $schema = array(
+            'label'         => 'Person',
+            'description'   => 'A person (or a music artist).',
+            'parents'       => array( 'thing' ),
+            'css_class'     => 'wl-person',
+            'uri'           => 'http://schema.org/Person',
+            'same_as'       => array(
+                'http://rdf.freebase.com/ns/people.person',
+                'http://rdf.freebase.com/ns/music.artist',
+                'http://dbpedia.org/class/yago/LivingPeople',
+            ),
+            'custom_fields' => array(
+                self::FIELD_KNOWS       => array(
+                    'predicate'   => 'http://schema.org/knows',
+                    'type'        => self::DATA_TYPE_URI,
+                    'export_type' => 'http://schema.org/Person',
+                    'constraints' => array(
+                        'uri_type'    => 'Person',
+                        'cardinality' => INF,
+                    ),
+                ),
+                self::FIELD_BIRTH_DATE  => array(
+                    'predicate'   => 'http://schema.org/birthDate',
+                    'type'        => self::DATA_TYPE_DATE,
+                    'export_type' => 'xsd:date',
+                    'constraints' => '',
+                ),
+                self::FIELD_BIRTH_PLACE => array(
+                    'predicate'   => 'http://schema.org/birthPlace',
+                    'type'        => self::DATA_TYPE_URI,
+                    'export_type' => 'http://schema.org/Place',
+                    'constraints' => array(
+                        'uri_type' => 'Place',
+                    ),
+                ),
+                self::FIELD_AFFILIATION => array(
+                    'predicate'   => 'http://schema.org/affiliation',
+                    'type'        => self::DATA_TYPE_URI,
+                    'export_type' => 'http://schema.org/Organization',
+                    'constraints' => array(
+                        'uri_type'    => array(
+                            'Organization',
+                            'LocalBusiness',
+                        ),
+                        'cardinality' => INF,
+                    ),
+                ),
+                self::FIELD_EMAIL       => array(
+                    'predicate'   => 'http://schema.org/email',
+                    'type'        => self::DATA_TYPE_STRING,
+                    'export_type' => 'xsd:string',
+                    'constraints' => array(
+                        'cardinality' => INF,
+                    ),
+                ),
+            ),
+            'linked_data'   => array(
+                // ### schema:knows.
+                $this->rendition_factory->create(
+                    $this->storage_factory->post_meta_to_uri( self::FIELD_KNOWS ),
+                    'http://schema.org/knows',
+                    self::DATA_TYPE_URI
+                ),
+                // ### schema:birthDate.
+                $this->rendition_factory->create(
+                    $this->storage_factory->post_meta( self::FIELD_BIRTH_DATE ),
+                    'http://schema.org/birthDate',
+                    self::DATA_TYPE_DATE
+                ),
+                // ### schema:birthPlace.
+                $this->rendition_factory->create(
+                    $this->storage_factory->post_meta_to_uri( self::FIELD_BIRTH_PLACE ),
+                    'http://schema.org/birthPlace',
+                    self::DATA_TYPE_URI
+                ),
+                // ### schema:affiliation.
+                $this->rendition_factory->create(
+                    $this->storage_factory->post_meta_to_uri( self::FIELD_AFFILIATION ),
+                    'http://schema.org/affiliation',
+                    self::DATA_TYPE_URI
+                ),
+                // ### schema:email.
+                $this->rendition_factory->create(
+                    $this->storage_factory->post_meta( self::FIELD_EMAIL ),
+                    'http://schema.org/email'
+                ),
+            ),
+            'templates'     => array(
+                'subtitle' => '{{id}}',
+            ),
+        );
+
+        // Merge the custom fields with those provided by the thing schema.
+        $parent_schema           = $this->get_thing_schema();
+        $schema['custom_fields'] = array_merge( $schema['custom_fields'], $parent_schema['custom_fields'] );
+        $schema['linked_data']   = array_merge( $schema['linked_data'], $parent_schema['linked_data'] );
+
+        return $schema;
+
+    }
+
+    /**
+     * Get the 'place' schema.
+     *
+     * @return array An array with the schema configuration.
+     *
+     * @since 3.1.0
+     */
+    private function get_place_schema() {
+
+        $schema = array(
+            'label'         => 'Place',
+            'description'   => 'A place.',
+            'parents'       => array( 'thing' ),
+            'css_class'     => 'wl-place',
+            'uri'           => 'http://schema.org/Place',
+            'same_as'       => array(
+                'http://rdf.freebase.com/ns/location.location',
+                'http://www.opengis.net/gml/_Feature',
+            ),
+            'custom_fields' => array(
+                self::FIELD_GEO_LATITUDE        => array(
+                    'predicate'   => 'http://schema.org/latitude',
+                    'type'        => self::DATA_TYPE_DOUBLE,
+                    'export_type' => 'xsd:double',
+                    'constraints' => '',
+                    // To build custom metabox.
+                    'input_field' => 'coordinates',
+                ),
+                self::FIELD_GEO_LONGITUDE       => array(
+                    'predicate'   => 'http://schema.org/longitude',
+                    'type'        => self::DATA_TYPE_DOUBLE,
+                    'export_type' => 'xsd:double',
+                    'constraints' => '',
+                    // To build custom metabox.
+                    'input_field' => 'coordinates',
+                ),
+                self::FIELD_ADDRESS             => array(
+                    'predicate'   => 'http://schema.org/streetAddress',
+                    'type'        => self::DATA_TYPE_STRING,
+                    'export_type' => 'xsd:string',
+                    'constraints' => '',
+                    // To build custom metabox.
+                    'input_field' => 'address',
+                ),
+                self::FIELD_ADDRESS_PO_BOX      => array(
+                    'predicate'   => 'http://schema.org/postOfficeBoxNumber',
+                    'type'        => self::DATA_TYPE_STRING,
+                    'export_type' => 'xsd:string',
+                    'constraints' => '',
+                    // To build custom metabox.
+                    'input_field' => 'address',
+                ),
+                self::FIELD_ADDRESS_POSTAL_CODE => array(
+                    'predicate'   => 'http://schema.org/postalCode',
+                    'type'        => self::DATA_TYPE_STRING,
+                    'export_type' => 'xsd:string',
+                    'constraints' => '',
+                    // To build custom metabox.
+                    'input_field' => 'address',
+                ),
+                self::FIELD_ADDRESS_LOCALITY    => array(
+                    'predicate'   => 'http://schema.org/addressLocality',
+                    'type'        => self::DATA_TYPE_STRING,
+                    'export_type' => 'xsd:string',
+                    'constraints' => '',
+                    // To build custom metabox.
+                    'input_field' => 'address',
+                ),
+                self::FIELD_ADDRESS_REGION      => array(
+                    'predicate'   => 'http://schema.org/addressRegion',
+                    'type'        => self::DATA_TYPE_STRING,
+                    'export_type' => 'xsd:string',
+                    'constraints' => '',
+                    // To build custom metabox.
+                    'input_field' => 'address',
+                ),
+                self::FIELD_ADDRESS_COUNTRY     => array(
+                    'predicate'   => 'http://schema.org/addressCountry',
+                    'type'        => self::DATA_TYPE_STRING,
+                    'export_type' => 'xsd:string',
+                    'constraints' => '',
+                    // To build custom metabox.
+                    'input_field' => 'address',
+                ),
+            ),
+            'linked_data'   => array(),
+            'templates'     => array(
+                'subtitle' => '{{id}}',
+            ),
+        );
+
+        // Merge the custom fields with those provided by the thing schema.
+        $parent_schema           = $this->get_thing_schema();
+        $schema['custom_fields'] = array_merge( $schema['custom_fields'], $parent_schema['custom_fields'] );
+        $schema['linked_data']   = array_merge( $schema['linked_data'], $parent_schema['linked_data'] );
+
+        return $schema;
+    }
+
+    /**
+     * Get the 'local business' schema.
+     *
+     * @return array An array with the schema configuration.
+     *
+     * @since 3.1.0
+     */
+    private function get_local_business_schema() {
+
+        $schema = array(
+            'label'         => 'LocalBusiness',
+            'description'   => 'A local business.',
+            'parents'       => array( 'place', 'organization' ),
+            'css_class'     => 'wl-local-business',
+            'uri'           => 'http://schema.org/LocalBusiness',
+            'same_as'       => array(
+                'http://rdf.freebase.com/ns/business/business_location',
+                'https://schema.org/Store',
+            ),
+            'custom_fields' => array(),
+            'linked_data'   => array(),
+            'templates'     => array(
+                'subtitle' => '{{id}}',
+            ),
+        );
+
+        // Merge the custom fields with those provided by the place and organization schema.
+        $place_schema            = $this->get_place_schema();
+        $organization_schema     = $this->get_organization_schema();
+        $schema['custom_fields'] = array_merge( $schema['custom_fields'], $place_schema['custom_fields'], $organization_schema['custom_fields'] );
+        $schema['linked_data']   = array_merge( $schema['linked_data'], $place_schema['linked_data'], $organization_schema['linked_data'] );
+
+        return $schema;
+    }
+
+    /**
+     * Get the 'recipe' schema.
+     *
+     * @return array An array with the schema configuration.
+     *
+     * @since 3.14.0
+     */
+    private function get_recipe_schema() {
+
+        $schema = array(
+            'label'         => 'Recipe',
+            'description'   => 'A Recipe.',
+            'parents'       => array( 'CreativeWork' ),
+            'css_class'     => 'wl-recipe',
+            'uri'           => 'http://schema.org/Recipe',
+            'same_as'       => array(),
+            'templates'     => array(
+                'subtitle' => '{{id}}',
+            ),
+            'custom_fields' => array(
+                self::FIELD_RECIPE_CUISINE          => array(
+                    'predicate'   => 'http://schema.org/recipeCuisine',
+                    'type'        => self::DATA_TYPE_STRING,
+                    'export_type' => 'xsd:string',
+                    'constraints' => '',
+                    'metabox'     => array(
+                        'label' => __( 'Recipe cuisine', 'wordlift' ),
+                    ),
+                ),
+                self::FIELD_RECIPE_INGREDIENT       => array(
+                    'predicate'   => 'http://schema.org/recipeIngredient',
+                    'type'        => self::DATA_TYPE_STRING,
+                    'export_type' => 'xsd:string',
+                    'constraints' => array(
+                        'cardinality' => INF,
+                    ),
+                    'metabox'     => array(
+                        'label' => __( 'Recipe ingredient', 'wordlift' ),
+                    ),
+                ),
+                self::FIELD_RECIPE_INSTRUCTIONS     => array(
+                    'predicate'   => 'http://schema.org/recipeInstructions',
+                    'type'        => self::DATA_TYPE_MULTILINE,
+                    'export_type' => 'xsd:string',
+                    'constraints' => '',
+                    'metabox'     => array(
+                        'class' => 'Wordlift_Metabox_Field_Multiline',
+                        'label' => __( 'Recipe instructions', 'wordlift' ),
+                    ),
+                ),
+                self::FIELD_RECIPE_YIELD            => array(
+                    'predicate'   => 'http://schema.org/recipeYield',
+                    'type'        => self::DATA_TYPE_STRING,
+                    'export_type' => 'xsd:string',
+                    'constraints' => '',
+                    'metabox'     => array(
+                        'label' => __( 'Recipe number of servings', 'wordlift' ),
+                    ),
+                ),
+                self::FIELD_RECIPE_INGREDIENT       => array(
+                    'predicate'   => 'http://schema.org/recipeIngredient',
+                    'type'        => self::DATA_TYPE_STRING,
+                    'export_type' => 'xsd:string',
+                    'constraints' => array(
+                        'cardinality' => INF,
+                    ),
+                    'metabox'     => array(
+                        'label' => __( 'Recipe ingredient', 'wordlift' ),
+                    ),
+                ),
+                self::FIELD_NUTRITION_INFO_CALORIES => array(
+                    'predicate'   => 'http://schema.org/calories',
+                    'type'        => self::DATA_TYPE_STRING,
+                    'export_type' => 'xsd:string',
+                    'constraints' => '',
+                    'metabox'     => array(
+                        'label' => __( 'Calories (e.g. 240 calories)', 'wordlift' ),
+                    ),
+                ),
+                self::FIELD_PREP_TIME               => array(
+                    'predicate'   => 'http://schema.org/prepTime',
+                    'type'        => self::DATA_TYPE_DURATION,
+                    'export_type' => 'xsd:time',
+                    'constraints' => '',
+                    'metabox'     => array(
+                        'class' => 'Wordlift_Metabox_Field_Duration',
+                        'label' => __( 'Recipe preparation time (e.g. 1:30)', 'wordlift' ),
+                    ),
+                ),
+                self::FIELD_COOK_TIME               => array(
+                    'predicate'   => 'http://schema.org/cookTime',
+                    'type'        => self::DATA_TYPE_DURATION,
+                    'export_type' => 'xsd:time',
+                    'constraints' => '',
+                    'metabox'     => array(
+                        'class' => 'Wordlift_Metabox_Field_Duration',
+                        'label' => __( 'Recipe cook time (e.g. 1:30)', 'wordlift' ),
+                    ),
+                ),
+                self::FIELD_TOTAL_TIME              => array(
+                    'predicate'   => 'http://schema.org/totalTime',
+                    'type'        => self::DATA_TYPE_DURATION,
+                    'export_type' => 'xsd:time',
+                    'constraints' => '',
+                    'metabox'     => array(
+                        'class' => 'Wordlift_Metabox_Field_Duration',
+                        'label' => __( 'Recipe total time (e.g. 1:30)', 'wordlift' ),
+                    ),
+                ),
+            ),
+            'linked_data'   => array(
+                // ### schema:recipeCuisine.
+                $this->rendition_factory->create(
+                    $this->storage_factory->post_meta( self::FIELD_RECIPE_CUISINE ),
+                    'http://schema.org/recipeCuisine'
+                ),
+                // ### schema:recipeIngredient.
+                $this->rendition_factory->create(
+                    $this->storage_factory->post_meta( self::FIELD_RECIPE_INGREDIENT ),
+                    'http://schema.org/recipeIngredient'
+                ),
+                // ### schema:prepTime.
+                $this->rendition_factory->create(
+                    $this->storage_factory->post_meta( self::FIELD_PREP_TIME ),
+                    'http://schema.org/prepTime',
+                    self::DATA_TYPE_DURATION
+                ),
+                // ### schema:cookTime.
+                $this->rendition_factory->create(
+                    $this->storage_factory->post_meta( self::FIELD_COOK_TIME ),
+                    'http://schema.org/cookTime',
+                    self::DATA_TYPE_DURATION
+                ),
+                // ### schema:totalTime.
+                $this->rendition_factory->create(
+                    $this->storage_factory->post_meta( self::FIELD_TOTAL_TIME ),
+                    'http://schema.org/totalTime',
+                    self::DATA_TYPE_DURATION
+                ),
+            ),
+        );
+
+        // Merge the custom fields with those provided by the parent schema.
+        $parent_schema           = $this->get_creative_work_schema();
+        $schema['custom_fields'] = array_merge( $schema['custom_fields'], $parent_schema['custom_fields'] );
+        $schema['linked_data']   = array_merge( $schema['linked_data'], $parent_schema['linked_data'] );
+
+        return $schema;
+    }
+
+    /**
+     * Get the 'article' schema.
+     *
+     * @return array An array with the schema configuration.
+     *
+     * @since 3.15.0
+     */
+    private function get_article_schema() {
+
+        $schema = array(
+            'label'         => 'Article',
+            'description'   => 'An Article.',
+            'parents'       => array(),
+            'css_class'     => 'wl-article',
+            'uri'           => 'http://schema.org/Article',
+            'same_as'       => array(),
+            'templates'     => array(
+                'subtitle' => '{{id}}',
+            ),
+            'custom_fields' => array(),
+            'linked_data'   => array(),
+        );
+
+        return $schema;
+    }
+
+    /**
+     * Get all the predicates.
+     *
+     * @since 3.15.0
+     *
+     * @return array An array of predicates.
+     */
+    public function get_all_predicates() {
+
+        // Get the custom fields.
+        $renditions = array_reduce( $this->schema, function ( $carry, $item ) {
+            return array_merge( $carry, $item['linked_data'] );
+        }, array() );
+
+        // Create a new array of predicates from the custom fields. The initial
+        // array contains just the `http://www.w3.org/1999/02/22-rdf-syntax-ns#type`
+        // (a, rdf:type) predicate (use the full URI).
+        $predicates = array_unique( array_reduce( $renditions, function ( $carry, $item ) {
+            return array_merge( $carry, (array) $item->get_predicate() );
+        }, array() ) );
+
+        /**
+         * Filter: 'wl_schema_predicates' - Allow third parties to hook and add additional predicates.
+         *
+         * @since  3.17.0
+         * @api arr $predicates Schema.org predicates.
+         */
+        return apply_filters( 'wl_schema_predicates', $predicates );
+    }
 
 }

Spacing +75 added lines, -75 removed lines

@@ -383,9 +383,9 @@ 
 	 * @param \Wordlift_Sparql_Tuple_Rendition_Factory $rendition_factory     The {@link Wordlift_Sparql_Tuple_Rendition_Factory} instance.
 	 * @param \Wordlift_Configuration_Service          $configuration_service The {@link Wordlift_Configuration_Service} instance.
 	 */
-	public function __construct( $storage_factory, $rendition_factory, $configuration_service ) {
+	public function __construct($storage_factory, $rendition_factory, $configuration_service) {
 
-		$this->log = Wordlift_Log_Service::get_logger( 'Wordlift_Schema_Service' );
+		$this->log = Wordlift_Log_Service::get_logger('Wordlift_Schema_Service');
 
 		$this->storage_factory       = $storage_factory;
 		$this->rendition_factory     = $rendition_factory;
@@ -433,18 +433,18 @@ 
 	 *
 	 * @return null|array An array of field's properties or null if the field is not found.
 	 */
-	public function get_field( $key ) {
+	public function get_field($key) {
 
 		// Parse each schema's fields until we find the one we're looking for, then
 		// return its properties.
-		foreach ( $this->schema as $_ => $schema ) {
+		foreach ($this->schema as $_ => $schema) {
 
-			if ( ! isset( $schema['custom_fields'] ) ) {
+			if ( ! isset($schema['custom_fields'])) {
 				break;
 			}
 
-			foreach ( $schema['custom_fields'] as $field => $props ) {
-				if ( $key === $field ) {
+			foreach ($schema['custom_fields'] as $field => $props) {
+				if ($key === $field) {
 					return $props;
 				}
 			}
@@ -462,14 +462,14 @@ 
 	 *
 	 * @since 3.1.0
 	 */
-	public function get_schema( $name ) {
+	public function get_schema($name) {
 		// Check if the schema exists and, if not, return NULL.
-		if ( ! isset( $this->schema[ $name ] ) ) {
+		if ( ! isset($this->schema[$name])) {
 			return null;
 		}
 
 		// Return the requested schema.
-		return $this->schema[ $name ];
+		return $this->schema[$name];
 	}
 
 	/**
@@ -481,10 +481,10 @@ 
 	 *
 	 * @since 3.3.0
 	 */
-	public function get_schema_by_uri( $uri ) {
+	public function get_schema_by_uri($uri) {
 
-		foreach ( $this->schema as $name => $schema ) {
-			if ( $schema['uri'] === $uri ) {
+		foreach ($this->schema as $name => $schema) {
+			if ($schema['uri'] === $uri) {
 				return $schema;
 			}
 		}
@@ -504,7 +504,7 @@ 
 		return array(
 			'css_class'     => 'wl-thing',
 			'uri'           => 'http://schema.org/Thing',
-			'same_as'       => array( '*' ),
+			'same_as'       => array('*'),
 			// set as default.
 			'custom_fields' => array(
 				self::FIELD_SAME_AS                            => array(
@@ -543,14 +543,14 @@ 
 				),
 				// ### Alternative title to rdfs:label.
 				$this->rendition_factory->create(
-					$this->storage_factory->post_meta( Wordlift_Entity_Service::ALTERNATIVE_LABEL_META_KEY ),
+					$this->storage_factory->post_meta(Wordlift_Entity_Service::ALTERNATIVE_LABEL_META_KEY),
 					Wordlift_Query_Builder::RDFS_LABEL_URI,
 					null,
 					$this->language_code
 				),
 				// ### Alternative title to dct:title.
 				$this->rendition_factory->create(
-					$this->storage_factory->post_meta( Wordlift_Entity_Service::ALTERNATIVE_LABEL_META_KEY ),
+					$this->storage_factory->post_meta(Wordlift_Entity_Service::ALTERNATIVE_LABEL_META_KEY),
 					'http://purl.org/dc/terms/title',
 					null,
 					$this->language_code
@@ -570,13 +570,13 @@ 
 				),
 				// ### owl:sameAs.
 				$this->rendition_factory->create(
-					$this->storage_factory->post_meta( self::FIELD_SAME_AS ),
+					$this->storage_factory->post_meta(self::FIELD_SAME_AS),
 					'http://www.w3.org/2002/07/owl#sameAs',
 					self::DATA_TYPE_URI
 				),
 				// ### rdf:type.
 				$this->rendition_factory->create(
-					$this->storage_factory->schema_class( $this ),
+					$this->storage_factory->schema_class($this),
 					Wordlift_Query_Builder::RDFS_TYPE_URI,
 					self::DATA_TYPE_URI
 				),
@@ -609,7 +609,7 @@ 
 		$schema = array(
 			'label'         => 'CreativeWork',
 			'description'   => 'A creative work (or a Music Album).',
-			'parents'       => array( 'thing' ),
+			'parents'       => array('thing'),
 			// Give term slug as parent.
 			'css_class'     => 'wl-creative-work',
 			'uri'           => 'http://schema.org/CreativeWork',
@@ -623,7 +623,7 @@ 
 					'type'        => self::DATA_TYPE_URI,
 					'export_type' => 'http://schema.org/Person',
 					'constraints' => array(
-						'uri_type'    => array( 'Person', 'Organization' ),
+						'uri_type'    => array('Person', 'Organization'),
 						'cardinality' => INF,
 					),
 				),
@@ -643,8 +643,8 @@ 
 
 		// Merge the custom fields with those provided by the thing schema.
 		$parent_schema           = $this->get_thing_schema();
-		$schema['custom_fields'] = array_merge( $schema['custom_fields'], $parent_schema['custom_fields'] );
-		$schema['linked_data']   = array_merge( $schema['linked_data'], $parent_schema['linked_data'] );
+		$schema['custom_fields'] = array_merge($schema['custom_fields'], $parent_schema['custom_fields']);
+		$schema['linked_data']   = array_merge($schema['linked_data'], $parent_schema['linked_data']);
 
 		return $schema;
 	}
@@ -661,10 +661,10 @@ 
 		$schema = array(
 			'label'         => 'Event',
 			'description'   => 'An event . ',
-			'parents'       => array( 'thing' ),
+			'parents'       => array('thing'),
 			'css_class'     => 'wl-event',
 			'uri'           => self::SCHEMA_EVENT_TYPE,
-			'same_as'       => array( 'http://dbpedia.org/ontology/Event' ),
+			'same_as'       => array('http://dbpedia.org/ontology/Event'),
 			'custom_fields' => array(
 				self::FIELD_DATE_START => array(
 					'predicate'   => 'http://schema.org/startDate',
@@ -683,7 +683,7 @@ 
 					'type'        => self::DATA_TYPE_URI,
 					'export_type' => 'http://schema.org/PostalAddress',
 					'constraints' => array(
-						'uri_type'    => array( 'Place', 'LocalBusiness' ),
+						'uri_type'    => array('Place', 'LocalBusiness'),
 						'cardinality' => INF,
 					),
 				),
@@ -691,19 +691,19 @@ 
 			'linked_data'   => array(
 				// ### schema:startDate.
 				$this->rendition_factory->create(
-					$this->storage_factory->post_meta( self::FIELD_DATE_START ),
+					$this->storage_factory->post_meta(self::FIELD_DATE_START),
 					'http://schema.org/startDate',
 					self::DATA_TYPE_DATE_TIME
 				),
 				// ### schema:endDate.
 				$this->rendition_factory->create(
-					$this->storage_factory->post_meta( self::FIELD_DATE_END ),
+					$this->storage_factory->post_meta(self::FIELD_DATE_END),
 					'http://schema.org/endDate',
 					self::DATA_TYPE_DATE_TIME
 				),
 				// ### schema:location.
 				$this->rendition_factory->create(
-					$this->storage_factory->post_meta_to_uri( self::FIELD_LOCATION ),
+					$this->storage_factory->post_meta_to_uri(self::FIELD_LOCATION),
 					'http://schema.org/location',
 					self::DATA_TYPE_URI
 				),
@@ -715,8 +715,8 @@ 
 
 		// Merge the custom fields with those provided by the thing schema.
 		$parent_schema           = $this->get_thing_schema();
-		$schema['custom_fields'] = array_merge( $schema['custom_fields'], $parent_schema['custom_fields'] );
-		$schema['linked_data']   = array_merge( $schema['linked_data'], $parent_schema['linked_data'] );
+		$schema['custom_fields'] = array_merge($schema['custom_fields'], $parent_schema['custom_fields']);
+		$schema['linked_data']   = array_merge($schema['linked_data'], $parent_schema['linked_data']);
 
 		return $schema;
 	}
@@ -733,7 +733,7 @@ 
 		$schema = array(
 			'label'         => 'Organization',
 			'description'   => 'An organization, including a government or a newspaper.',
-			'parents'       => array( 'thing' ),
+			'parents'       => array('thing'),
 			'css_class'     => 'wl-organization',
 			'uri'           => 'http://schema.org/Organization',
 			'same_as'       => array(
@@ -821,23 +821,23 @@ 
 			'linked_data'   => array(
 				// ### schema:legalName.
 				$this->rendition_factory->create(
-					$this->storage_factory->post_meta( self::FIELD_LEGAL_NAME ),
+					$this->storage_factory->post_meta(self::FIELD_LEGAL_NAME),
 					'http://schema.org/legalName'
 				),
 				// ### schema:founder.
 				$this->rendition_factory->create(
-					$this->storage_factory->post_meta_to_uri( self::FIELD_FOUNDER ),
+					$this->storage_factory->post_meta_to_uri(self::FIELD_FOUNDER),
 					'http://schema.org/founder',
 					self::DATA_TYPE_URI
 				),
 				// ### schema:email.
 				$this->rendition_factory->create(
-					$this->storage_factory->post_meta( self::FIELD_EMAIL ),
+					$this->storage_factory->post_meta(self::FIELD_EMAIL),
 					'http://schema.org/email'
 				),
 				// ### schema:telephone.
 				$this->rendition_factory->create(
-					$this->storage_factory->post_meta( self::FIELD_TELEPHONE ),
+					$this->storage_factory->post_meta(self::FIELD_TELEPHONE),
 					'http://schema.org/telephone'
 				),
 			),
@@ -848,8 +848,8 @@ 
 
 		// Merge the custom fields with those provided by the thing schema.
 		$parent_schema           = $this->get_thing_schema();
-		$schema['custom_fields'] = array_merge( $schema['custom_fields'], $parent_schema['custom_fields'] );
-		$schema['linked_data']   = array_merge( $schema['linked_data'], $parent_schema['linked_data'] );
+		$schema['custom_fields'] = array_merge($schema['custom_fields'], $parent_schema['custom_fields']);
+		$schema['linked_data']   = array_merge($schema['linked_data'], $parent_schema['linked_data']);
 
 		return $schema;
 	}
@@ -866,7 +866,7 @@ 
 		$schema = array(
 			'label'         => 'Person',
 			'description'   => 'A person (or a music artist).',
-			'parents'       => array( 'thing' ),
+			'parents'       => array('thing'),
 			'css_class'     => 'wl-person',
 			'uri'           => 'http://schema.org/Person',
 			'same_as'       => array(
@@ -922,31 +922,31 @@ 
 			'linked_data'   => array(
 				// ### schema:knows.
 				$this->rendition_factory->create(
-					$this->storage_factory->post_meta_to_uri( self::FIELD_KNOWS ),
+					$this->storage_factory->post_meta_to_uri(self::FIELD_KNOWS),
 					'http://schema.org/knows',
 					self::DATA_TYPE_URI
 				),
 				// ### schema:birthDate.
 				$this->rendition_factory->create(
-					$this->storage_factory->post_meta( self::FIELD_BIRTH_DATE ),
+					$this->storage_factory->post_meta(self::FIELD_BIRTH_DATE),
 					'http://schema.org/birthDate',
 					self::DATA_TYPE_DATE
 				),
 				// ### schema:birthPlace.
 				$this->rendition_factory->create(
-					$this->storage_factory->post_meta_to_uri( self::FIELD_BIRTH_PLACE ),
+					$this->storage_factory->post_meta_to_uri(self::FIELD_BIRTH_PLACE),
 					'http://schema.org/birthPlace',
 					self::DATA_TYPE_URI
 				),
 				// ### schema:affiliation.
 				$this->rendition_factory->create(
-					$this->storage_factory->post_meta_to_uri( self::FIELD_AFFILIATION ),
+					$this->storage_factory->post_meta_to_uri(self::FIELD_AFFILIATION),
 					'http://schema.org/affiliation',
 					self::DATA_TYPE_URI
 				),
 				// ### schema:email.
 				$this->rendition_factory->create(
-					$this->storage_factory->post_meta( self::FIELD_EMAIL ),
+					$this->storage_factory->post_meta(self::FIELD_EMAIL),
 					'http://schema.org/email'
 				),
 			),
@@ -957,8 +957,8 @@ 
 
 		// Merge the custom fields with those provided by the thing schema.
 		$parent_schema           = $this->get_thing_schema();
-		$schema['custom_fields'] = array_merge( $schema['custom_fields'], $parent_schema['custom_fields'] );
-		$schema['linked_data']   = array_merge( $schema['linked_data'], $parent_schema['linked_data'] );
+		$schema['custom_fields'] = array_merge($schema['custom_fields'], $parent_schema['custom_fields']);
+		$schema['linked_data']   = array_merge($schema['linked_data'], $parent_schema['linked_data']);
 
 		return $schema;
 
@@ -976,7 +976,7 @@ 
 		$schema = array(
 			'label'         => 'Place',
 			'description'   => 'A place.',
-			'parents'       => array( 'thing' ),
+			'parents'       => array('thing'),
 			'css_class'     => 'wl-place',
 			'uri'           => 'http://schema.org/Place',
 			'same_as'       => array(
@@ -1057,8 +1057,8 @@ 
 
 		// Merge the custom fields with those provided by the thing schema.
 		$parent_schema           = $this->get_thing_schema();
-		$schema['custom_fields'] = array_merge( $schema['custom_fields'], $parent_schema['custom_fields'] );
-		$schema['linked_data']   = array_merge( $schema['linked_data'], $parent_schema['linked_data'] );
+		$schema['custom_fields'] = array_merge($schema['custom_fields'], $parent_schema['custom_fields']);
+		$schema['linked_data']   = array_merge($schema['linked_data'], $parent_schema['linked_data']);
 
 		return $schema;
 	}
@@ -1075,7 +1075,7 @@ 
 		$schema = array(
 			'label'         => 'LocalBusiness',
 			'description'   => 'A local business.',
-			'parents'       => array( 'place', 'organization' ),
+			'parents'       => array('place', 'organization'),
 			'css_class'     => 'wl-local-business',
 			'uri'           => 'http://schema.org/LocalBusiness',
 			'same_as'       => array(
@@ -1092,8 +1092,8 @@ 
 		// Merge the custom fields with those provided by the place and organization schema.
 		$place_schema            = $this->get_place_schema();
 		$organization_schema     = $this->get_organization_schema();
-		$schema['custom_fields'] = array_merge( $schema['custom_fields'], $place_schema['custom_fields'], $organization_schema['custom_fields'] );
-		$schema['linked_data']   = array_merge( $schema['linked_data'], $place_schema['linked_data'], $organization_schema['linked_data'] );
+		$schema['custom_fields'] = array_merge($schema['custom_fields'], $place_schema['custom_fields'], $organization_schema['custom_fields']);
+		$schema['linked_data']   = array_merge($schema['linked_data'], $place_schema['linked_data'], $organization_schema['linked_data']);
 
 		return $schema;
 	}
@@ -1110,7 +1110,7 @@ 
 		$schema = array(
 			'label'         => 'Recipe',
 			'description'   => 'A Recipe.',
-			'parents'       => array( 'CreativeWork' ),
+			'parents'       => array('CreativeWork'),
 			'css_class'     => 'wl-recipe',
 			'uri'           => 'http://schema.org/Recipe',
 			'same_as'       => array(),
@@ -1124,7 +1124,7 @@ 
 					'export_type' => 'xsd:string',
 					'constraints' => '',
 					'metabox'     => array(
-						'label' => __( 'Recipe cuisine', 'wordlift' ),
+						'label' => __('Recipe cuisine', 'wordlift'),
 					),
 				),
 				self::FIELD_RECIPE_INGREDIENT       => array(
@@ -1135,7 +1135,7 @@ 
 						'cardinality' => INF,
 					),
 					'metabox'     => array(
-						'label' => __( 'Recipe ingredient', 'wordlift' ),
+						'label' => __('Recipe ingredient', 'wordlift'),
 					),
 				),
 				self::FIELD_RECIPE_INSTRUCTIONS     => array(
@@ -1145,7 +1145,7 @@ 
 					'constraints' => '',
 					'metabox'     => array(
 						'class' => 'Wordlift_Metabox_Field_Multiline',
-						'label' => __( 'Recipe instructions', 'wordlift' ),
+						'label' => __('Recipe instructions', 'wordlift'),
 					),
 				),
 				self::FIELD_RECIPE_YIELD            => array(
@@ -1154,7 +1154,7 @@ 
 					'export_type' => 'xsd:string',
 					'constraints' => '',
 					'metabox'     => array(
-						'label' => __( 'Recipe number of servings', 'wordlift' ),
+						'label' => __('Recipe number of servings', 'wordlift'),
 					),
 				),
 				self::FIELD_RECIPE_INGREDIENT       => array(
@@ -1165,7 +1165,7 @@ 
 						'cardinality' => INF,
 					),
 					'metabox'     => array(
-						'label' => __( 'Recipe ingredient', 'wordlift' ),
+						'label' => __('Recipe ingredient', 'wordlift'),
 					),
 				),
 				self::FIELD_NUTRITION_INFO_CALORIES => array(
@@ -1174,7 +1174,7 @@ 
 					'export_type' => 'xsd:string',
 					'constraints' => '',
 					'metabox'     => array(
-						'label' => __( 'Calories (e.g. 240 calories)', 'wordlift' ),
+						'label' => __('Calories (e.g. 240 calories)', 'wordlift'),
 					),
 				),
 				self::FIELD_PREP_TIME               => array(
@@ -1184,7 +1184,7 @@ 
 					'constraints' => '',
 					'metabox'     => array(
 						'class' => 'Wordlift_Metabox_Field_Duration',
-						'label' => __( 'Recipe preparation time (e.g. 1:30)', 'wordlift' ),
+						'label' => __('Recipe preparation time (e.g. 1:30)', 'wordlift'),
 					),
 				),
 				self::FIELD_COOK_TIME               => array(
@@ -1194,7 +1194,7 @@ 
 					'constraints' => '',
 					'metabox'     => array(
 						'class' => 'Wordlift_Metabox_Field_Duration',
-						'label' => __( 'Recipe cook time (e.g. 1:30)', 'wordlift' ),
+						'label' => __('Recipe cook time (e.g. 1:30)', 'wordlift'),
 					),
 				),
 				self::FIELD_TOTAL_TIME              => array(
@@ -1204,36 +1204,36 @@ 
 					'constraints' => '',
 					'metabox'     => array(
 						'class' => 'Wordlift_Metabox_Field_Duration',
-						'label' => __( 'Recipe total time (e.g. 1:30)', 'wordlift' ),
+						'label' => __('Recipe total time (e.g. 1:30)', 'wordlift'),
 					),
 				),
 			),
 			'linked_data'   => array(
 				// ### schema:recipeCuisine.
 				$this->rendition_factory->create(
-					$this->storage_factory->post_meta( self::FIELD_RECIPE_CUISINE ),
+					$this->storage_factory->post_meta(self::FIELD_RECIPE_CUISINE),
 					'http://schema.org/recipeCuisine'
 				),
 				// ### schema:recipeIngredient.
 				$this->rendition_factory->create(
-					$this->storage_factory->post_meta( self::FIELD_RECIPE_INGREDIENT ),
+					$this->storage_factory->post_meta(self::FIELD_RECIPE_INGREDIENT),
 					'http://schema.org/recipeIngredient'
 				),
 				// ### schema:prepTime.
 				$this->rendition_factory->create(
-					$this->storage_factory->post_meta( self::FIELD_PREP_TIME ),
+					$this->storage_factory->post_meta(self::FIELD_PREP_TIME),
 					'http://schema.org/prepTime',
 					self::DATA_TYPE_DURATION
 				),
 				// ### schema:cookTime.
 				$this->rendition_factory->create(
-					$this->storage_factory->post_meta( self::FIELD_COOK_TIME ),
+					$this->storage_factory->post_meta(self::FIELD_COOK_TIME),
 					'http://schema.org/cookTime',
 					self::DATA_TYPE_DURATION
 				),
 				// ### schema:totalTime.
 				$this->rendition_factory->create(
-					$this->storage_factory->post_meta( self::FIELD_TOTAL_TIME ),
+					$this->storage_factory->post_meta(self::FIELD_TOTAL_TIME),
 					'http://schema.org/totalTime',
 					self::DATA_TYPE_DURATION
 				),
@@ -1242,8 +1242,8 @@ 
 
 		// Merge the custom fields with those provided by the parent schema.
 		$parent_schema           = $this->get_creative_work_schema();
-		$schema['custom_fields'] = array_merge( $schema['custom_fields'], $parent_schema['custom_fields'] );
-		$schema['linked_data']   = array_merge( $schema['linked_data'], $parent_schema['linked_data'] );
+		$schema['custom_fields'] = array_merge($schema['custom_fields'], $parent_schema['custom_fields']);
+		$schema['linked_data']   = array_merge($schema['linked_data'], $parent_schema['linked_data']);
 
 		return $schema;
 	}
@@ -1284,16 +1284,16 @@ 
 	public function get_all_predicates() {
 
 		// Get the custom fields.
-		$renditions = array_reduce( $this->schema, function ( $carry, $item ) {
-			return array_merge( $carry, $item['linked_data'] );
-		}, array() );
+		$renditions = array_reduce($this->schema, function($carry, $item) {
+			return array_merge($carry, $item['linked_data']);
+		}, array());
 
 		// Create a new array of predicates from the custom fields. The initial
 		// array contains just the `http://www.w3.org/1999/02/22-rdf-syntax-ns#type`
 		// (a, rdf:type) predicate (use the full URI).
-		$predicates = array_unique( array_reduce( $renditions, function ( $carry, $item ) {
-			return array_merge( $carry, (array) $item->get_predicate() );
-		}, array() ) );
+		$predicates = array_unique(array_reduce($renditions, function($carry, $item) {
+			return array_merge($carry, (array) $item->get_predicate());
+		}, array()));
 
 		/**
 		 * Filter: 'wl_schema_predicates' - Allow third parties to hook and add additional predicates.
@@ -1301,7 +1301,7 @@ 
 		 * @since  3.17.0
 		 * @api arr $predicates Schema.org predicates.
 		 */
-		return apply_filters( 'wl_schema_predicates', $predicates );
+		return apply_filters('wl_schema_predicates', $predicates);
 	}
 
 }

src/includes/class-wordlift-linked-data-service.php

Indentation +282 added lines, -282 removed lines

@@ -18,287 +18,287 @@
  */
 class Wordlift_Linked_Data_Service {
 
-	/**
-	 * A {@link Wordlift_Log_Service} instance.
-	 *
-	 * @since  3.15.0
-	 * @access private
-	 * @var \Wordlift_Log_Service $log A {@link Wordlift_Log_Service} instance.
-	 */
-	private $log;
-
-	/**
-	 * The {@link Wordlift_Entity_Service} instance.
-	 *
-	 * @since  3.15.0
-	 * @access private
-	 * @var \Wordlift_Entity_Service $entity_service The {@link Wordlift_Entity_Service} instance.
-	 */
-	private $entity_service;
-
-	/**
-	 * The {@link Wordlift_Entity_Type_Service} instance.
-	 *
-	 * @since  3.15.0
-	 * @access private
-	 * @var \Wordlift_Entity_Type_Service $entity_type_service The {@link Wordlift_Entity_Type_Service} instance.
-	 */
-	private $entity_type_service;
-
-	/**
-	 * The {@link Wordlift_Schema_Service} instance.
-	 *
-	 * @since  3.15.0
-	 * @access private
-	 * @var \Wordlift_Schema_Service $schema_service The {@link Wordlift_Schema_Service} instance.
-	 */
-	private $schema_service;
-
-	/**
-	 * The {@link Wordlift_Linked_Data_Service} singleton instance.
-	 *
-	 * @since  3.15.0
-	 * @access private
-	 * @var \Wordlift_Linked_Data_Service $instance The {@link Wordlift_Linked_Data_Service} singleton instance.
-	 */
-	private static $instance;
-
-	/**
-	 * The {@link Wordlift_Sparql_Service} instance.
-	 *
-	 * @since  3.15.0
-	 * @access private
-	 * @var \Wordlift_Sparql_Service $sparql_service The {@link Wordlift_Sparql_Service} instance.
-	 */
-	private $sparql_service;
-
-	/**
-	 * Create a {@link Wordlift_Linked_Data_Service} instance.
-	 *
-	 * @since 3.15.0
-	 *
-	 * @param \Wordlift_Entity_Service      $entity_service      The {@link Wordlift_Entity_Service} instance.
-	 * @param \Wordlift_Entity_Type_Service $entity_type_service The {@link Wordlift_Entity_Type_Service} instance.
-	 * @param \Wordlift_Schema_Service      $schema_service      The {@link Wordlift_Schema_Service} instance.
-	 * @param \Wordlift_Sparql_Service      $sparql_service      The {@link Wordlift_Sparql_Service} instance.
-	 */
-	public function __construct( $entity_service, $entity_type_service, $schema_service, $sparql_service ) {
-
-		$this->log = Wordlift_Log_Service::get_logger( 'Wordlift_Linked_Data_Service' );
-
-		$this->entity_service      = $entity_service;
-		$this->entity_type_service = $entity_type_service;
-		$this->schema_service      = $schema_service;
-		$this->sparql_service      = $sparql_service;
-
-		self::$instance = $this;
-
-	}
-
-	/**
-	 * Get the singleton instance of {@link Wordlift_Linked_Data_Service}.
-	 *
-	 * @since 3.15.0
-	 *
-	 * @return Wordlift_Linked_Data_Service The singleton instance of <a href='psi_element://Wordlift_Linked_Data_Service'>Wordlift_Linked_Data_Service</a>.
-	 */
-	public static function get_instance() {
-
-		return self::$instance;
-	}
-
-	/**
-	 * Push a {@link WP_Post} to the Linked Data store.
-	 *
-	 * If the {@link WP_Post} is an entity and it's not of the `Article` type,
-	 * then it is pushed to the remote Linked Data store.
-	 *
-	 * @since 3.15.0
-	 *
-	 * @param int $post_id The {@link WP_Post}'s id.
-	 */
-	public function push( $post_id ) {
-
-		$this->log->debug( "Pushing post $post_id..." );
-
-		// Bail out if it's not an entity: we do NOT publish non entities or
-		// entities of type `Article`s.
-		if ( ! $this->entity_service->is_entity( $post_id ) ) {
-			$this->log->debug( "Post $post_id is not an entity." );
-
-			return;
-		}
-
-		// Get the post and push it to the Linked Data store.
-		$this->do_push( $post_id );
-
-		// Reindex the triple store if buffering is turned off.
-		if ( false === WL_ENABLE_SPARQL_UPDATE_QUERIES_BUFFERING ) {
-			wordlift_reindex_triple_store();
-		}
-
-	}
-
-	/**
-	 * Remove the specified {@link WP_Post} from the Linked Data.
-	 *
-	 * @since 3.15.0
-	 *
-	 * @param int $post_id The {@link WP_Post}'s id.
-	 */
-	public function remove( $post_id ) {
-
-		// Get the delete statements.
-		$deletes      = $this->get_delete_statements( $post_id );
-		$delete_query = implode( "\n", $deletes );
-		$this->sparql_service->execute( $delete_query );
-
-	}
-
-	/**
-	 * Push an entity to the Linked Data store.
-	 *
-	 * @since 3.15.0
-	 *
-	 * @param int $post_id The {@link WP_Post}'s id.
-	 */
-	private function do_push( $post_id ) {
-		$this->log->debug( "Doing post $post_id push..." );
-
-		// Get the post.
-		$post = get_post( $post_id );
-
-		// Bail out if the post isn't found.
-		if ( null === $post ) {
-			$this->log->warn( "Post $post_id not found." );
-
-			return;
-		}
-
-		// Bail out if the post isn't published.
-		if ( 'publish' !== $post->post_status ) {
-			$this->log->info( "Post $post_id not published." );
-
-			return;
-		}
-
-		// Bail out if the URI isn't valid.
-		if ( ! $this->has_valid_uri( $post_id ) ) {
-			$this->log->warn( "Post $post_id URI invalid." );
-
-			return;
-		}
-
-		// First remove the post data.
-		$this->remove( $post_id );
-
-		// Get the insert statements.
-		$insert_tuples     = $this->get_insert_tuples( $post_id );
-		$insert_query_body = implode( "\n", $insert_tuples );
-		$insert_query      = "INSERT DATA { $insert_query_body };";
-		$this->sparql_service->execute( $insert_query );
-
-	}
-
-	/**
-	 * Check if an entity's {@link WP_Post} has a valid URI.
-	 *
-	 * @since 3.15.0
-	 *
-	 * @param int $post_id The entity's {@link WP_Post}'s id.
-	 *
-	 * @return bool True if the URI is valid otherwise false.
-	 */
-	private function has_valid_uri( $post_id ) {
-
-		// Get the entity's URI.
-		$uri = $this->entity_service->get_uri( $post_id );
-
-		// If the URI isn't found, return false.
-		if ( null === $uri ) {
-			return false;
-		}
-
-		// If the URI ends with a trailing slash, return false.
-		if ( '/' === substr( $uri, - 1 ) ) {
-			return false;
-		}
-
-		// URI is valid.
-		return true;
-	}
-
-	/**
-	 * Get the delete statements.
-	 *
-	 * @since 3.15.0
-	 *
-	 * @param int $post_id The {@link WP_Post}'s id.
-	 *
-	 * @return array An array of delete statements.
-	 */
-	private function get_delete_statements( $post_id ) {
-
-		// Get the entity URI.
-		$uri = $this->entity_service->get_uri( $post_id );
-
-		// Prepare the delete statements with the entity as subject.
-		$as_subject = array_map( function ( $item ) use ( $uri ) {
-			return Wordlift_Query_Builder
-				::new_instance()
-				->delete()
-				->statement( $uri, $item, '?o' )
-				->build();
-		}, $this->schema_service->get_all_predicates() );
-
-		// Prepare the delete statements with the entity as object.
-		$as_object = array_map( function ( $item ) use ( $uri ) {
-			return Wordlift_Query_Builder
-				::new_instance()
-				->delete()
-				->statement( '?s', $item, $uri, Wordlift_Query_Builder::OBJECT_URI )
-				->build();
-		}, $this->schema_service->get_all_predicates() );
-
-		// Merge the delete statements and return them.
-		return array_merge( $as_subject, $as_object );
-	}
-
-	/**
-	 * Get the SPARQL insert tuples ( ?s ?p ?o ) for the specified {@link WP_Post}.
-	 *
-	 * @since 3.15.0
-	 *
-	 * @param int $post_id The {@link WP_Post}'s id.
-	 *
-	 * @return array An array of insert tuples.
-	 */
-	private function get_insert_tuples( $post_id ) {
-
-		// Get the entity type.
-		$type = $this->entity_type_service->get( $post_id );
-
-		/**
-		 * Filter: 'wl_tuple_properties' - Allow third parties to hook and add additional tuples.
-		 *
-		 * @since 3.17.0
-		 * @api   arr $type['linked_data'] A {@link Wordlift_Sparql_Tuple_Rendition} instances.
-		 * @api   \Wordlift_Entity_Type_Service $entity_type_service The {@link Wordlift_Entity_Type_Service} instance.
-		 * @api   int $post_id The {@link WP_Post}'s id.
-		 */
-		$properties = apply_filters( 'wl_tuple_properties', $type['linked_data'], $this->entity_service, $post_id );
-
-		// Accumulate the tuples.
-		$tuples = array();
-		/** @var Wordlift_Sparql_Tuple_Rendition $property A {@link Wordlift_Sparql_Tuple_Rendition} instance. */
-		foreach ( $properties as $property ) {
-			foreach ( $property->get( $post_id ) as $tuple ) {
-				$tuples[] = $tuple;
-			}
-		}
-
-		// Finally return the tuples.
-		return $tuples;
-	}
+    /**
+     * A {@link Wordlift_Log_Service} instance.
+     *
+     * @since  3.15.0
+     * @access private
+     * @var \Wordlift_Log_Service $log A {@link Wordlift_Log_Service} instance.
+     */
+    private $log;
+
+    /**
+     * The {@link Wordlift_Entity_Service} instance.
+     *
+     * @since  3.15.0
+     * @access private
+     * @var \Wordlift_Entity_Service $entity_service The {@link Wordlift_Entity_Service} instance.
+     */
+    private $entity_service;
+
+    /**
+     * The {@link Wordlift_Entity_Type_Service} instance.
+     *
+     * @since  3.15.0
+     * @access private
+     * @var \Wordlift_Entity_Type_Service $entity_type_service The {@link Wordlift_Entity_Type_Service} instance.
+     */
+    private $entity_type_service;
+
+    /**
+     * The {@link Wordlift_Schema_Service} instance.
+     *
+     * @since  3.15.0
+     * @access private
+     * @var \Wordlift_Schema_Service $schema_service The {@link Wordlift_Schema_Service} instance.
+     */
+    private $schema_service;
+
+    /**
+     * The {@link Wordlift_Linked_Data_Service} singleton instance.
+     *
+     * @since  3.15.0
+     * @access private
+     * @var \Wordlift_Linked_Data_Service $instance The {@link Wordlift_Linked_Data_Service} singleton instance.
+     */
+    private static $instance;
+
+    /**
+     * The {@link Wordlift_Sparql_Service} instance.
+     *
+     * @since  3.15.0
+     * @access private
+     * @var \Wordlift_Sparql_Service $sparql_service The {@link Wordlift_Sparql_Service} instance.
+     */
+    private $sparql_service;
+
+    /**
+     * Create a {@link Wordlift_Linked_Data_Service} instance.
+     *
+     * @since 3.15.0
+     *
+     * @param \Wordlift_Entity_Service      $entity_service      The {@link Wordlift_Entity_Service} instance.
+     * @param \Wordlift_Entity_Type_Service $entity_type_service The {@link Wordlift_Entity_Type_Service} instance.
+     * @param \Wordlift_Schema_Service      $schema_service      The {@link Wordlift_Schema_Service} instance.
+     * @param \Wordlift_Sparql_Service      $sparql_service      The {@link Wordlift_Sparql_Service} instance.
+     */
+    public function __construct( $entity_service, $entity_type_service, $schema_service, $sparql_service ) {
+
+        $this->log = Wordlift_Log_Service::get_logger( 'Wordlift_Linked_Data_Service' );
+
+        $this->entity_service      = $entity_service;
+        $this->entity_type_service = $entity_type_service;
+        $this->schema_service      = $schema_service;
+        $this->sparql_service      = $sparql_service;
+
+        self::$instance = $this;
+
+    }
+
+    /**
+     * Get the singleton instance of {@link Wordlift_Linked_Data_Service}.
+     *
+     * @since 3.15.0
+     *
+     * @return Wordlift_Linked_Data_Service The singleton instance of <a href='psi_element://Wordlift_Linked_Data_Service'>Wordlift_Linked_Data_Service</a>.
+     */
+    public static function get_instance() {
+
+        return self::$instance;
+    }
+
+    /**
+     * Push a {@link WP_Post} to the Linked Data store.
+     *
+     * If the {@link WP_Post} is an entity and it's not of the `Article` type,
+     * then it is pushed to the remote Linked Data store.
+     *
+     * @since 3.15.0
+     *
+     * @param int $post_id The {@link WP_Post}'s id.
+     */
+    public function push( $post_id ) {
+
+        $this->log->debug( "Pushing post $post_id..." );
+
+        // Bail out if it's not an entity: we do NOT publish non entities or
+        // entities of type `Article`s.
+        if ( ! $this->entity_service->is_entity( $post_id ) ) {
+            $this->log->debug( "Post $post_id is not an entity." );
+
+            return;
+        }
+
+        // Get the post and push it to the Linked Data store.
+        $this->do_push( $post_id );
+
+        // Reindex the triple store if buffering is turned off.
+        if ( false === WL_ENABLE_SPARQL_UPDATE_QUERIES_BUFFERING ) {
+            wordlift_reindex_triple_store();
+        }
+
+    }
+
+    /**
+     * Remove the specified {@link WP_Post} from the Linked Data.
+     *
+     * @since 3.15.0
+     *
+     * @param int $post_id The {@link WP_Post}'s id.
+     */
+    public function remove( $post_id ) {
+
+        // Get the delete statements.
+        $deletes      = $this->get_delete_statements( $post_id );
+        $delete_query = implode( "\n", $deletes );
+        $this->sparql_service->execute( $delete_query );
+
+    }
+
+    /**
+     * Push an entity to the Linked Data store.
+     *
+     * @since 3.15.0
+     *
+     * @param int $post_id The {@link WP_Post}'s id.
+     */
+    private function do_push( $post_id ) {
+        $this->log->debug( "Doing post $post_id push..." );
+
+        // Get the post.
+        $post = get_post( $post_id );
+
+        // Bail out if the post isn't found.
+        if ( null === $post ) {
+            $this->log->warn( "Post $post_id not found." );
+
+            return;
+        }
+
+        // Bail out if the post isn't published.
+        if ( 'publish' !== $post->post_status ) {
+            $this->log->info( "Post $post_id not published." );
+
+            return;
+        }
+
+        // Bail out if the URI isn't valid.
+        if ( ! $this->has_valid_uri( $post_id ) ) {
+            $this->log->warn( "Post $post_id URI invalid." );
+
+            return;
+        }
+
+        // First remove the post data.
+        $this->remove( $post_id );
+
+        // Get the insert statements.
+        $insert_tuples     = $this->get_insert_tuples( $post_id );
+        $insert_query_body = implode( "\n", $insert_tuples );
+        $insert_query      = "INSERT DATA { $insert_query_body };";
+        $this->sparql_service->execute( $insert_query );
+
+    }
+
+    /**
+     * Check if an entity's {@link WP_Post} has a valid URI.
+     *
+     * @since 3.15.0
+     *
+     * @param int $post_id The entity's {@link WP_Post}'s id.
+     *
+     * @return bool True if the URI is valid otherwise false.
+     */
+    private function has_valid_uri( $post_id ) {
+
+        // Get the entity's URI.
+        $uri = $this->entity_service->get_uri( $post_id );
+
+        // If the URI isn't found, return false.
+        if ( null === $uri ) {
+            return false;
+        }
+
+        // If the URI ends with a trailing slash, return false.
+        if ( '/' === substr( $uri, - 1 ) ) {
+            return false;
+        }
+
+        // URI is valid.
+        return true;
+    }
+
+    /**
+     * Get the delete statements.
+     *
+     * @since 3.15.0
+     *
+     * @param int $post_id The {@link WP_Post}'s id.
+     *
+     * @return array An array of delete statements.
+     */
+    private function get_delete_statements( $post_id ) {
+
+        // Get the entity URI.
+        $uri = $this->entity_service->get_uri( $post_id );
+
+        // Prepare the delete statements with the entity as subject.
+        $as_subject = array_map( function ( $item ) use ( $uri ) {
+            return Wordlift_Query_Builder
+                ::new_instance()
+                ->delete()
+                ->statement( $uri, $item, '?o' )
+                ->build();
+        }, $this->schema_service->get_all_predicates() );
+
+        // Prepare the delete statements with the entity as object.
+        $as_object = array_map( function ( $item ) use ( $uri ) {
+            return Wordlift_Query_Builder
+                ::new_instance()
+                ->delete()
+                ->statement( '?s', $item, $uri, Wordlift_Query_Builder::OBJECT_URI )
+                ->build();
+        }, $this->schema_service->get_all_predicates() );
+
+        // Merge the delete statements and return them.
+        return array_merge( $as_subject, $as_object );
+    }
+
+    /**
+     * Get the SPARQL insert tuples ( ?s ?p ?o ) for the specified {@link WP_Post}.
+     *
+     * @since 3.15.0
+     *
+     * @param int $post_id The {@link WP_Post}'s id.
+     *
+     * @return array An array of insert tuples.
+     */
+    private function get_insert_tuples( $post_id ) {
+
+        // Get the entity type.
+        $type = $this->entity_type_service->get( $post_id );
+
+        /**
+         * Filter: 'wl_tuple_properties' - Allow third parties to hook and add additional tuples.
+         *
+         * @since 3.17.0
+         * @api   arr $type['linked_data'] A {@link Wordlift_Sparql_Tuple_Rendition} instances.
+         * @api   \Wordlift_Entity_Type_Service $entity_type_service The {@link Wordlift_Entity_Type_Service} instance.
+         * @api   int $post_id The {@link WP_Post}'s id.
+         */
+        $properties = apply_filters( 'wl_tuple_properties', $type['linked_data'], $this->entity_service, $post_id );
+
+        // Accumulate the tuples.
+        $tuples = array();
+        /** @var Wordlift_Sparql_Tuple_Rendition $property A {@link Wordlift_Sparql_Tuple_Rendition} instance. */
+        foreach ( $properties as $property ) {
+            foreach ( $property->get( $post_id ) as $tuple ) {
+                $tuples[] = $tuple;
+            }
+        }
+
+        // Finally return the tuples.
+        return $tuples;
+    }
 
 }

Spacing +43 added lines, -43 removed lines

@@ -82,9 +82,9 @@ 
 	 * @param \Wordlift_Schema_Service      $schema_service      The {@link Wordlift_Schema_Service} instance.
 	 * @param \Wordlift_Sparql_Service      $sparql_service      The {@link Wordlift_Sparql_Service} instance.
 	 */
-	public function __construct( $entity_service, $entity_type_service, $schema_service, $sparql_service ) {
+	public function __construct($entity_service, $entity_type_service, $schema_service, $sparql_service) {
 
-		$this->log = Wordlift_Log_Service::get_logger( 'Wordlift_Linked_Data_Service' );
+		$this->log = Wordlift_Log_Service::get_logger('Wordlift_Linked_Data_Service');
 
 		$this->entity_service      = $entity_service;
 		$this->entity_type_service = $entity_type_service;
@@ -117,23 +117,23 @@ 
 	 *
 	 * @param int $post_id The {@link WP_Post}'s id.
 	 */
-	public function push( $post_id ) {
+	public function push($post_id) {
 
-		$this->log->debug( "Pushing post $post_id..." );
+		$this->log->debug("Pushing post $post_id...");
 
 		// Bail out if it's not an entity: we do NOT publish non entities or
 		// entities of type `Article`s.
-		if ( ! $this->entity_service->is_entity( $post_id ) ) {
-			$this->log->debug( "Post $post_id is not an entity." );
+		if ( ! $this->entity_service->is_entity($post_id)) {
+			$this->log->debug("Post $post_id is not an entity.");
 
 			return;
 		}
 
 		// Get the post and push it to the Linked Data store.
-		$this->do_push( $post_id );
+		$this->do_push($post_id);
 
 		// Reindex the triple store if buffering is turned off.
-		if ( false === WL_ENABLE_SPARQL_UPDATE_QUERIES_BUFFERING ) {
+		if (false === WL_ENABLE_SPARQL_UPDATE_QUERIES_BUFFERING) {
 			wordlift_reindex_triple_store();
 		}
 
@@ -146,12 +146,12 @@ 
 	 *
 	 * @param int $post_id The {@link WP_Post}'s id.
 	 */
-	public function remove( $post_id ) {
+	public function remove($post_id) {
 
 		// Get the delete statements.
-		$deletes      = $this->get_delete_statements( $post_id );
-		$delete_query = implode( "\n", $deletes );
-		$this->sparql_service->execute( $delete_query );
+		$deletes      = $this->get_delete_statements($post_id);
+		$delete_query = implode("\n", $deletes);
+		$this->sparql_service->execute($delete_query);
 
 	}
 
@@ -162,41 +162,41 @@ 
 	 *
 	 * @param int $post_id The {@link WP_Post}'s id.
 	 */
-	private function do_push( $post_id ) {
-		$this->log->debug( "Doing post $post_id push..." );
+	private function do_push($post_id) {
+		$this->log->debug("Doing post $post_id push...");
 
 		// Get the post.
-		$post = get_post( $post_id );
+		$post = get_post($post_id);
 
 		// Bail out if the post isn't found.
-		if ( null === $post ) {
-			$this->log->warn( "Post $post_id not found." );
+		if (null === $post) {
+			$this->log->warn("Post $post_id not found.");
 
 			return;
 		}
 
 		// Bail out if the post isn't published.
-		if ( 'publish' !== $post->post_status ) {
-			$this->log->info( "Post $post_id not published." );
+		if ('publish' !== $post->post_status) {
+			$this->log->info("Post $post_id not published.");
 
 			return;
 		}
 
 		// Bail out if the URI isn't valid.
-		if ( ! $this->has_valid_uri( $post_id ) ) {
-			$this->log->warn( "Post $post_id URI invalid." );
+		if ( ! $this->has_valid_uri($post_id)) {
+			$this->log->warn("Post $post_id URI invalid.");
 
 			return;
 		}
 
 		// First remove the post data.
-		$this->remove( $post_id );
+		$this->remove($post_id);
 
 		// Get the insert statements.
-		$insert_tuples     = $this->get_insert_tuples( $post_id );
-		$insert_query_body = implode( "\n", $insert_tuples );
+		$insert_tuples     = $this->get_insert_tuples($post_id);
+		$insert_query_body = implode("\n", $insert_tuples);
 		$insert_query      = "INSERT DATA { $insert_query_body };";
-		$this->sparql_service->execute( $insert_query );
+		$this->sparql_service->execute($insert_query);
 
 	}
 
@@ -209,18 +209,18 @@ 
 	 *
 	 * @return bool True if the URI is valid otherwise false.
 	 */
-	private function has_valid_uri( $post_id ) {
+	private function has_valid_uri($post_id) {
 
 		// Get the entity's URI.
-		$uri = $this->entity_service->get_uri( $post_id );
+		$uri = $this->entity_service->get_uri($post_id);
 
 		// If the URI isn't found, return false.
-		if ( null === $uri ) {
+		if (null === $uri) {
 			return false;
 		}
 
 		// If the URI ends with a trailing slash, return false.
-		if ( '/' === substr( $uri, - 1 ) ) {
+		if ('/' === substr($uri, - 1)) {
 			return false;
 		}
 
@@ -237,31 +237,31 @@ 
 	 *
 	 * @return array An array of delete statements.
 	 */
-	private function get_delete_statements( $post_id ) {
+	private function get_delete_statements($post_id) {
 
 		// Get the entity URI.
-		$uri = $this->entity_service->get_uri( $post_id );
+		$uri = $this->entity_service->get_uri($post_id);
 
 		// Prepare the delete statements with the entity as subject.
-		$as_subject = array_map( function ( $item ) use ( $uri ) {
+		$as_subject = array_map(function($item) use ($uri) {
 			return Wordlift_Query_Builder
 				::new_instance()
 				->delete()
-				->statement( $uri, $item, '?o' )
+				->statement($uri, $item, '?o')
 				->build();
-		}, $this->schema_service->get_all_predicates() );
+		}, $this->schema_service->get_all_predicates());
 
 		// Prepare the delete statements with the entity as object.
-		$as_object = array_map( function ( $item ) use ( $uri ) {
+		$as_object = array_map(function($item) use ($uri) {
 			return Wordlift_Query_Builder
 				::new_instance()
 				->delete()
-				->statement( '?s', $item, $uri, Wordlift_Query_Builder::OBJECT_URI )
+				->statement('?s', $item, $uri, Wordlift_Query_Builder::OBJECT_URI)
 				->build();
-		}, $this->schema_service->get_all_predicates() );
+		}, $this->schema_service->get_all_predicates());
 
 		// Merge the delete statements and return them.
-		return array_merge( $as_subject, $as_object );
+		return array_merge($as_subject, $as_object);
 	}
 
 	/**
@@ -273,10 +273,10 @@ 
 	 *
 	 * @return array An array of insert tuples.
 	 */
-	private function get_insert_tuples( $post_id ) {
+	private function get_insert_tuples($post_id) {
 
 		// Get the entity type.
-		$type = $this->entity_type_service->get( $post_id );
+		$type = $this->entity_type_service->get($post_id);
 
 		/**
 		 * Filter: 'wl_tuple_properties' - Allow third parties to hook and add additional tuples.
@@ -286,13 +286,13 @@ 
 		 * @api   \Wordlift_Entity_Type_Service $entity_type_service The {@link Wordlift_Entity_Type_Service} instance.
 		 * @api   int $post_id The {@link WP_Post}'s id.
 		 */
-		$properties = apply_filters( 'wl_tuple_properties', $type['linked_data'], $this->entity_service, $post_id );
+		$properties = apply_filters('wl_tuple_properties', $type['linked_data'], $this->entity_service, $post_id);
 
 		// Accumulate the tuples.
 		$tuples = array();
 		/** @var Wordlift_Sparql_Tuple_Rendition $property A {@link Wordlift_Sparql_Tuple_Rendition} instance. */
-		foreach ( $properties as $property ) {
-			foreach ( $property->get( $post_id ) as $tuple ) {
+		foreach ($properties as $property) {
+			foreach ($property->get($post_id) as $tuple) {
 				$tuples[] = $tuple;
 			}
 		}

src/includes/class-wordlift-sparql-service.php

Indentation +290 added lines, -290 removed lines

@@ -18,298 +18,298 @@
  */
 class Wordlift_Sparql_Service {
 
-	/**
-	 * A {@link Wordlift_Log_Service} instance.
-	 *
-	 * @since  3.6.0
-	 * @access private
-	 * @var \Wordlift_Log_Service $log A {@link Wordlift_Log_Service} instance.
-	 */
-	private static $log;
-
-	/**
-	 * The {@link Wordlift_Sparql_Service} singleton instance.
-	 *
-	 * @since  3.6.0
-	 * @access private
-	 * @var \Wordlift_Sparql_Service $instance The {@link Wordlift_Sparql_Service} singleton instance.
-	 */
-	private static $instance;
-
-	/**
-	 * Create a {@link Wordlift_Sparql_Service} instance.
-	 *
-	 * @since 3.6.0
-	 */
-	public function __construct() {
-
-		self::$log = Wordlift_Log_Service::get_logger( 'Wordlift_Sparql_Service' );
-
-		self::$instance = $this;
-
-	}
-
-	/**
-	 * Get the singleton instance of the {@link Wordlift_Sparql_Service}.
-	 *
-	 * @since 3.6.0
-	 * @return \Wordlift_Sparql_Service
-	 */
-	public static function get_instance() {
-
-		return self::$instance;
-	}
-
-	/**
-	 * Queue a SPARQL statement for execution.
-	 *
-	 * @since 3.6.0
-	 *
-	 * @param string $stmt  The SPARQL statement.
-	 * @param bool   $queue Whether to queue the statement for asynchronous
-	 *                      execution.
-	 */
-	public function execute( $stmt, $queue = WL_ENABLE_SPARQL_UPDATE_QUERIES_BUFFERING ) {
-
-		rl_execute_sparql_update_query( $stmt, $queue );
-
-	}
-
-	/**
-	 * Run the SPARQL queries buffered for the specified request id.
-	 *
-	 * @since 3.13.2
-	 *
-	 * @param string $request_id A unique request id.
-	 */
-	public function run_sparql_query( $request_id ) {
-
-		self::$log->debug( "Running SPARQL queries..." );
-
-		// Look for a free temporary filename.
-		for ( $index = 1; $index < PHP_INT_MAX; $index ++ ) {
-			$filename = WL_TEMP_DIR . $request_id . "-$index.sparql";
-
-			// Bail out if there are no files left.
-			if ( ! file_exists( $filename ) ) {
-				break;
-			}
-
-			self::$log->debug( "Running SPARQL from $filename..." );
-
-			// Get the query saved in the file.
-			$query = file_get_contents( $filename );
-
-			// Execute the SPARQL query.
-			rl_execute_sparql_update_query( $query, false );
-
-			// Delete the temporary file.
-			unlink( $filename );
-		}
-
-		// Reindex the triple store.
-		wordlift_reindex_triple_store();
-
-	}
-
-	/**
-	 * Queue a SPARQL statement for asynchronous execution.
-	 *
-	 * @since 3.13.2
-	 *
-	 * @param string $stmt The SPARQL statement.
-	 */
-	public function queue( $stmt ) {
-
-		// Get a temporary filename.
-		$filename = $this->get_temporary_file_for_sparql();
-
-		self::$log->debug( "Buffering SPARQL to file $filename..." );
-
-		// Write the contents to the temporary filename.
-		file_put_contents( $filename, $stmt . "\n", FILE_APPEND );
-
-	}
-
-	/**
-	 * Get a temporary filename where to store SPARQL queries.
-	 *
-	 * @since 3.13.2
-	 *
-	 * @return string The filename.
-	 * @throws Exception An exception is thrown if there are already 1.000
-	 *                   temporary files for this request.
-	 */
-	private function get_temporary_file_for_sparql() {
-
-		// Look for a free temporary filename.
-		for ( $index = 1; $index < PHP_INT_MAX; $index ++ ) {
-			$filename = WL_TEMP_DIR . WL_REQUEST_ID . "-$index.sparql";
-
-			if ( ! file_exists( $filename ) ) {
-
-				// Only if this it the first buffered SPARQL, then launch the
-				// action which will be handled by the Async Task. The Async
-				// Task will take care of all the buffered files _on shutdown_.
-				if ( 1 === $index ) {
-					do_action( 'wl_run_sparql_query', WL_REQUEST_ID );
-				}
-
-				// Return the temporary filename.
-				return $filename;
-			}
-		}
+    /**
+     * A {@link Wordlift_Log_Service} instance.
+     *
+     * @since  3.6.0
+     * @access private
+     * @var \Wordlift_Log_Service $log A {@link Wordlift_Log_Service} instance.
+     */
+    private static $log;
+
+    /**
+     * The {@link Wordlift_Sparql_Service} singleton instance.
+     *
+     * @since  3.6.0
+     * @access private
+     * @var \Wordlift_Sparql_Service $instance The {@link Wordlift_Sparql_Service} singleton instance.
+     */
+    private static $instance;
+
+    /**
+     * Create a {@link Wordlift_Sparql_Service} instance.
+     *
+     * @since 3.6.0
+     */
+    public function __construct() {
+
+        self::$log = Wordlift_Log_Service::get_logger( 'Wordlift_Sparql_Service' );
+
+        self::$instance = $this;
+
+    }
+
+    /**
+     * Get the singleton instance of the {@link Wordlift_Sparql_Service}.
+     *
+     * @since 3.6.0
+     * @return \Wordlift_Sparql_Service
+     */
+    public static function get_instance() {
+
+        return self::$instance;
+    }
+
+    /**
+     * Queue a SPARQL statement for execution.
+     *
+     * @since 3.6.0
+     *
+     * @param string $stmt  The SPARQL statement.
+     * @param bool   $queue Whether to queue the statement for asynchronous
+     *                      execution.
+     */
+    public function execute( $stmt, $queue = WL_ENABLE_SPARQL_UPDATE_QUERIES_BUFFERING ) {
+
+        rl_execute_sparql_update_query( $stmt, $queue );
+
+    }
+
+    /**
+     * Run the SPARQL queries buffered for the specified request id.
+     *
+     * @since 3.13.2
+     *
+     * @param string $request_id A unique request id.
+     */
+    public function run_sparql_query( $request_id ) {
+
+        self::$log->debug( "Running SPARQL queries..." );
+
+        // Look for a free temporary filename.
+        for ( $index = 1; $index < PHP_INT_MAX; $index ++ ) {
+            $filename = WL_TEMP_DIR . $request_id . "-$index.sparql";
+
+            // Bail out if there are no files left.
+            if ( ! file_exists( $filename ) ) {
+                break;
+            }
+
+            self::$log->debug( "Running SPARQL from $filename..." );
+
+            // Get the query saved in the file.
+            $query = file_get_contents( $filename );
+
+            // Execute the SPARQL query.
+            rl_execute_sparql_update_query( $query, false );
+
+            // Delete the temporary file.
+            unlink( $filename );
+        }
+
+        // Reindex the triple store.
+        wordlift_reindex_triple_store();
+
+    }
+
+    /**
+     * Queue a SPARQL statement for asynchronous execution.
+     *
+     * @since 3.13.2
+     *
+     * @param string $stmt The SPARQL statement.
+     */
+    public function queue( $stmt ) {
+
+        // Get a temporary filename.
+        $filename = $this->get_temporary_file_for_sparql();
+
+        self::$log->debug( "Buffering SPARQL to file $filename..." );
+
+        // Write the contents to the temporary filename.
+        file_put_contents( $filename, $stmt . "\n", FILE_APPEND );
+
+    }
+
+    /**
+     * Get a temporary filename where to store SPARQL queries.
+     *
+     * @since 3.13.2
+     *
+     * @return string The filename.
+     * @throws Exception An exception is thrown if there are already 1.000
+     *                   temporary files for this request.
+     */
+    private function get_temporary_file_for_sparql() {
+
+        // Look for a free temporary filename.
+        for ( $index = 1; $index < PHP_INT_MAX; $index ++ ) {
+            $filename = WL_TEMP_DIR . WL_REQUEST_ID . "-$index.sparql";
+
+            if ( ! file_exists( $filename ) ) {
+
+                // Only if this it the first buffered SPARQL, then launch the
+                // action which will be handled by the Async Task. The Async
+                // Task will take care of all the buffered files _on shutdown_.
+                if ( 1 === $index ) {
+                    do_action( 'wl_run_sparql_query', WL_REQUEST_ID );
+                }
+
+                // Return the temporary filename.
+                return $filename;
+            }
+        }
 
-		throw new Exception( 'Cannot create a temporary file [ ' . WL_TEMP_DIR . WL_REQUEST_ID . ' ].' );
-	}
-
-	/**
-	 * Execute the SELECT query.
-	 *
-	 * @since 3.12.2
-	 *
-	 * @param string $query The SELECT query to execute.
-	 *
-	 * @return WP_Error|array The response or WP_Error on failure.
-	 */
-	public function select( $query ) {
-
-		// Prepare the SPARQL statement by prepending the default namespaces.
-		$sparql = rl_sparql_prefixes() . "\n" . $query;
-
-		// Get the SPARQL SELECT URL.
-		$url = wl_configuration_get_query_select_url() . urlencode( $sparql );
+        throw new Exception( 'Cannot create a temporary file [ ' . WL_TEMP_DIR . WL_REQUEST_ID . ' ].' );
+    }
+
+    /**
+     * Execute the SELECT query.
+     *
+     * @since 3.12.2
+     *
+     * @param string $query The SELECT query to execute.
+     *
+     * @return WP_Error|array The response or WP_Error on failure.
+     */
+    public function select( $query ) {
+
+        // Prepare the SPARQL statement by prepending the default namespaces.
+        $sparql = rl_sparql_prefixes() . "\n" . $query;
+
+        // Get the SPARQL SELECT URL.
+        $url = wl_configuration_get_query_select_url() . urlencode( $sparql );
 
-		/**
-		 * Filter: 'wl_sparql_query_http_args' - Allow third parties to hook and add additional HTTP args.
-		 *
-		 * @since 3.17.0
-		 * @api   arr Current http options.
-		 */
-		$args = apply_filters( 'wl_sparql_query_http_args', unserialize( WL_REDLINK_API_HTTP_OPTIONS ) );
-
-		return wp_remote_get( $url, $args );
-	}
-
-	/**
-	 * Formats the provided value according to the specified type in order to
-	 * insert the value using SPARQL. The value is also escaped.
-	 *
-	 * @since 3.6.0
-	 *
-	 * @param string      $value    The value.
-	 * @param string      $type     The value type.
-	 * @param string|null $language The language tag or null if not set.
-	 *
-	 * @return string The formatted value for SPARQL statements.
-	 */
-	public static function format( $value, $type = null, $language = null ) {
-
-		// see https://www.w3.org/TR/sparql11-query/.
-
-		switch ( $type ) {
-
-			case Wordlift_Schema_Service::DATA_TYPE_BOOLEAN:
-				// SPARQL supports 'true' and 'false', so we evaluate the $value
-				// and return true/false accordingly.
-				return $value ? 'true' : 'false';
-
-			case Wordlift_Schema_Service::DATA_TYPE_DATE:
-				$date       = date_create_from_format( 'Y/m/d', $value );
-				$date_value = date_format( $date, 'Y-m-d' );
-
-				return sprintf( '"%s"^^xsd:date', self::escape( $date_value ) );
-
-			case Wordlift_Schema_Service::DATA_TYPE_DATE_TIME:
-				$date       = date_create_from_format( 'Y/m/d H:i', $value );
-				$date_value = date_format( $date, 'Y-m-d\TH:i:00' );
-
-				return sprintf( '"%s"^^xsd:dateTime', self::escape( $date_value ) );
-
-			case Wordlift_Schema_Service::DATA_TYPE_DURATION:
-				$time       = date_create_from_format( 'H:i', $value );
-				$time_value = sprintf( 'PT%dH%dM', date_format( $time, 'H' ), intval( date_format( $time, 'i' ) ) );
-
-				return sprintf( '"%s"^^xsd:duration', self::escape( $time_value ) );
-
-			case Wordlift_Schema_Service::DATA_TYPE_DOUBLE:
-				return sprintf( '"%s"^^xsd:double', self::escape( $value ) );
-
-			case Wordlift_Schema_Service::DATA_TYPE_INTEGER:
-				return sprintf( '"%s"^^xsd:integer', self::escape( $value ) );
-
-			case Wordlift_Schema_Service::DATA_TYPE_STRING:
-				return sprintf( '"%s"^^xsd:string', self::escape( $value ) );
-
-			case Wordlift_Schema_Service::DATA_TYPE_URI:
-				return sprintf( '<%s>', self::escape_uri( $value ) );
-
-			case null:
-				$language_tag = ( null !== $language ? "@$language" : '' );
-
-				return sprintf( '"%s"%s', self::escape( $value ), $language_tag );
-
-			default:
-
-				self::$log->warn( "Unknown data type [ type :: $type ]" );
-
-				// Try to insert the value anyway.
-				return sprintf( '"%s"', self::escape( $value ) );
-		}
-
-	}
-
-	/**
-	 * Escapes an URI for a SPARQL statement.
-	 *
-	 * @since 3.6.0
-	 *
-	 * @param string $uri The URI to escape.
-	 *
-	 * @return string The escaped URI.
-	 */
-	public static function escape_uri( $uri ) {
-
-		// Should we validate the IRI?
-		// http://www.w3.org/TR/sparql11-query/#QSynIRI
-
-		$uri = str_replace( '<', '\<', $uri );
-		$uri = str_replace( '>', '\>', $uri );
-
-		return $uri;
-	}
-
-	/**
-	 * Escapes a string for a SPARQL statement.
-	 *
-	 * @since 3.6.0
-	 *
-	 * @param string $string The string to escape.
-	 *
-	 * @return string The escaped string.
-	 */
-	public static function escape( $string ) {
-
-		// see http://www.w3.org/TR/rdf-sparql-query/
-		//    '\t'	U+0009 (tab)
-		//    '\n'	U+000A (line feed)
-		//    '\r'	U+000D (carriage return)
-		//    '\b'	U+0008 (backspace)
-		//    '\f'	U+000C (form feed)
-		//    '\"'	U+0022 (quotation mark, double quote mark)
-		//    "\'"	U+0027 (apostrophe-quote, single quote mark)
-		//    '\\'	U+005C (backslash)
-
-		$string = str_replace( '\\', '\\\\', $string );
-		$string = str_replace( '\'', '\\\'', $string );
-		$string = str_replace( '"', '\\"', $string );
-		$string = str_replace( "\f", '\\f', $string );
-		$string = str_replace( "\b", '\\b', $string );
-		$string = str_replace( "\r", '\\r', $string );
-		$string = str_replace( "\n", '\\n', $string );
-		$string = str_replace( "\t", '\\t', $string );
+        /**
+         * Filter: 'wl_sparql_query_http_args' - Allow third parties to hook and add additional HTTP args.
+         *
+         * @since 3.17.0
+         * @api   arr Current http options.
+         */
+        $args = apply_filters( 'wl_sparql_query_http_args', unserialize( WL_REDLINK_API_HTTP_OPTIONS ) );
+
+        return wp_remote_get( $url, $args );
+    }
+
+    /**
+     * Formats the provided value according to the specified type in order to
+     * insert the value using SPARQL. The value is also escaped.
+     *
+     * @since 3.6.0
+     *
+     * @param string      $value    The value.
+     * @param string      $type     The value type.
+     * @param string|null $language The language tag or null if not set.
+     *
+     * @return string The formatted value for SPARQL statements.
+     */
+    public static function format( $value, $type = null, $language = null ) {
+
+        // see https://www.w3.org/TR/sparql11-query/.
+
+        switch ( $type ) {
+
+            case Wordlift_Schema_Service::DATA_TYPE_BOOLEAN:
+                // SPARQL supports 'true' and 'false', so we evaluate the $value
+                // and return true/false accordingly.
+                return $value ? 'true' : 'false';
+
+            case Wordlift_Schema_Service::DATA_TYPE_DATE:
+                $date       = date_create_from_format( 'Y/m/d', $value );
+                $date_value = date_format( $date, 'Y-m-d' );
+
+                return sprintf( '"%s"^^xsd:date', self::escape( $date_value ) );
+
+            case Wordlift_Schema_Service::DATA_TYPE_DATE_TIME:
+                $date       = date_create_from_format( 'Y/m/d H:i', $value );
+                $date_value = date_format( $date, 'Y-m-d\TH:i:00' );
+
+                return sprintf( '"%s"^^xsd:dateTime', self::escape( $date_value ) );
+
+            case Wordlift_Schema_Service::DATA_TYPE_DURATION:
+                $time       = date_create_from_format( 'H:i', $value );
+                $time_value = sprintf( 'PT%dH%dM', date_format( $time, 'H' ), intval( date_format( $time, 'i' ) ) );
+
+                return sprintf( '"%s"^^xsd:duration', self::escape( $time_value ) );
+
+            case Wordlift_Schema_Service::DATA_TYPE_DOUBLE:
+                return sprintf( '"%s"^^xsd:double', self::escape( $value ) );
+
+            case Wordlift_Schema_Service::DATA_TYPE_INTEGER:
+                return sprintf( '"%s"^^xsd:integer', self::escape( $value ) );
+
+            case Wordlift_Schema_Service::DATA_TYPE_STRING:
+                return sprintf( '"%s"^^xsd:string', self::escape( $value ) );
+
+            case Wordlift_Schema_Service::DATA_TYPE_URI:
+                return sprintf( '<%s>', self::escape_uri( $value ) );
+
+            case null:
+                $language_tag = ( null !== $language ? "@$language" : '' );
+
+                return sprintf( '"%s"%s', self::escape( $value ), $language_tag );
+
+            default:
+
+                self::$log->warn( "Unknown data type [ type :: $type ]" );
+
+                // Try to insert the value anyway.
+                return sprintf( '"%s"', self::escape( $value ) );
+        }
+
+    }
+
+    /**
+     * Escapes an URI for a SPARQL statement.
+     *
+     * @since 3.6.0
+     *
+     * @param string $uri The URI to escape.
+     *
+     * @return string The escaped URI.
+     */
+    public static function escape_uri( $uri ) {
+
+        // Should we validate the IRI?
+        // http://www.w3.org/TR/sparql11-query/#QSynIRI
+
+        $uri = str_replace( '<', '\<', $uri );
+        $uri = str_replace( '>', '\>', $uri );
+
+        return $uri;
+    }
+
+    /**
+     * Escapes a string for a SPARQL statement.
+     *
+     * @since 3.6.0
+     *
+     * @param string $string The string to escape.
+     *
+     * @return string The escaped string.
+     */
+    public static function escape( $string ) {
+
+        // see http://www.w3.org/TR/rdf-sparql-query/
+        //    '\t'	U+0009 (tab)
+        //    '\n'	U+000A (line feed)
+        //    '\r'	U+000D (carriage return)
+        //    '\b'	U+0008 (backspace)
+        //    '\f'	U+000C (form feed)
+        //    '\"'	U+0022 (quotation mark, double quote mark)
+        //    "\'"	U+0027 (apostrophe-quote, single quote mark)
+        //    '\\'	U+005C (backslash)
+
+        $string = str_replace( '\\', '\\\\', $string );
+        $string = str_replace( '\'', '\\\'', $string );
+        $string = str_replace( '"', '\\"', $string );
+        $string = str_replace( "\f", '\\f', $string );
+        $string = str_replace( "\b", '\\b', $string );
+        $string = str_replace( "\r", '\\r', $string );
+        $string = str_replace( "\n", '\\n', $string );
+        $string = str_replace( "\t", '\\t', $string );
 
-		return $string;
-	}
+        return $string;
+    }
 
 }

Spacing +57 added lines, -57 removed lines

@@ -43,7 +43,7 @@ 
 	 */
 	public function __construct() {
 
-		self::$log = Wordlift_Log_Service::get_logger( 'Wordlift_Sparql_Service' );
+		self::$log = Wordlift_Log_Service::get_logger('Wordlift_Sparql_Service');
 
 		self::$instance = $this;
 
@@ -69,9 +69,9 @@ 
 	 * @param bool   $queue Whether to queue the statement for asynchronous
 	 *                      execution.
 	 */
-	public function execute( $stmt, $queue = WL_ENABLE_SPARQL_UPDATE_QUERIES_BUFFERING ) {
+	public function execute($stmt, $queue = WL_ENABLE_SPARQL_UPDATE_QUERIES_BUFFERING) {
 
-		rl_execute_sparql_update_query( $stmt, $queue );
+		rl_execute_sparql_update_query($stmt, $queue);
 
 	}
 
@@ -82,29 +82,29 @@ 
 	 *
 	 * @param string $request_id A unique request id.
 	 */
-	public function run_sparql_query( $request_id ) {
+	public function run_sparql_query($request_id) {
 
-		self::$log->debug( "Running SPARQL queries..." );
+		self::$log->debug("Running SPARQL queries...");
 
 		// Look for a free temporary filename.
-		for ( $index = 1; $index < PHP_INT_MAX; $index ++ ) {
-			$filename = WL_TEMP_DIR . $request_id . "-$index.sparql";
+		for ($index = 1; $index < PHP_INT_MAX; $index++) {
+			$filename = WL_TEMP_DIR.$request_id."-$index.sparql";
 
 			// Bail out if there are no files left.
-			if ( ! file_exists( $filename ) ) {
+			if ( ! file_exists($filename)) {
 				break;
 			}
 
-			self::$log->debug( "Running SPARQL from $filename..." );
+			self::$log->debug("Running SPARQL from $filename...");
 
 			// Get the query saved in the file.
-			$query = file_get_contents( $filename );
+			$query = file_get_contents($filename);
 
 			// Execute the SPARQL query.
-			rl_execute_sparql_update_query( $query, false );
+			rl_execute_sparql_update_query($query, false);
 
 			// Delete the temporary file.
-			unlink( $filename );
+			unlink($filename);
 		}
 
 		// Reindex the triple store.
@@ -119,15 +119,15 @@ 
 	 *
 	 * @param string $stmt The SPARQL statement.
 	 */
-	public function queue( $stmt ) {
+	public function queue($stmt) {
 
 		// Get a temporary filename.
 		$filename = $this->get_temporary_file_for_sparql();
 
-		self::$log->debug( "Buffering SPARQL to file $filename..." );
+		self::$log->debug("Buffering SPARQL to file $filename...");
 
 		// Write the contents to the temporary filename.
-		file_put_contents( $filename, $stmt . "\n", FILE_APPEND );
+		file_put_contents($filename, $stmt."\n", FILE_APPEND);
 
 	}
 
@@ -143,16 +143,16 @@ 
 	private function get_temporary_file_for_sparql() {
 
 		// Look for a free temporary filename.
-		for ( $index = 1; $index < PHP_INT_MAX; $index ++ ) {
-			$filename = WL_TEMP_DIR . WL_REQUEST_ID . "-$index.sparql";
+		for ($index = 1; $index < PHP_INT_MAX; $index++) {
+			$filename = WL_TEMP_DIR.WL_REQUEST_ID."-$index.sparql";
 
-			if ( ! file_exists( $filename ) ) {
+			if ( ! file_exists($filename)) {
 
 				// Only if this it the first buffered SPARQL, then launch the
 				// action which will be handled by the Async Task. The Async
 				// Task will take care of all the buffered files _on shutdown_.
-				if ( 1 === $index ) {
-					do_action( 'wl_run_sparql_query', WL_REQUEST_ID );
+				if (1 === $index) {
+					do_action('wl_run_sparql_query', WL_REQUEST_ID);
 				}
 
 				// Return the temporary filename.
@@ -160,7 +160,7 @@ 
 			}
 		}
 
-		throw new Exception( 'Cannot create a temporary file [ ' . WL_TEMP_DIR . WL_REQUEST_ID . ' ].' );
+		throw new Exception('Cannot create a temporary file [ '.WL_TEMP_DIR.WL_REQUEST_ID.' ].');
 	}
 
 	/**
@@ -172,13 +172,13 @@ 
 	 *
 	 * @return WP_Error|array The response or WP_Error on failure.
 	 */
-	public function select( $query ) {
+	public function select($query) {
 
 		// Prepare the SPARQL statement by prepending the default namespaces.
-		$sparql = rl_sparql_prefixes() . "\n" . $query;
+		$sparql = rl_sparql_prefixes()."\n".$query;
 
 		// Get the SPARQL SELECT URL.
-		$url = wl_configuration_get_query_select_url() . urlencode( $sparql );
+		$url = wl_configuration_get_query_select_url().urlencode($sparql);
 
 		/**
 		 * Filter: 'wl_sparql_query_http_args' - Allow third parties to hook and add additional HTTP args.
@@ -186,9 +186,9 @@ 
 		 * @since 3.17.0
 		 * @api   arr Current http options.
 		 */
-		$args = apply_filters( 'wl_sparql_query_http_args', unserialize( WL_REDLINK_API_HTTP_OPTIONS ) );
+		$args = apply_filters('wl_sparql_query_http_args', unserialize(WL_REDLINK_API_HTTP_OPTIONS));
 
-		return wp_remote_get( $url, $args );
+		return wp_remote_get($url, $args);
 	}
 
 	/**
@@ -203,11 +203,11 @@ 
 	 *
 	 * @return string The formatted value for SPARQL statements.
 	 */
-	public static function format( $value, $type = null, $language = null ) {
+	public static function format($value, $type = null, $language = null) {
 
 		// see https://www.w3.org/TR/sparql11-query/.
 
-		switch ( $type ) {
+		switch ($type) {
 
 			case Wordlift_Schema_Service::DATA_TYPE_BOOLEAN:
 				// SPARQL supports 'true' and 'false', so we evaluate the $value
@@ -215,46 +215,46 @@ 
 				return $value ? 'true' : 'false';
 
 			case Wordlift_Schema_Service::DATA_TYPE_DATE:
-				$date       = date_create_from_format( 'Y/m/d', $value );
-				$date_value = date_format( $date, 'Y-m-d' );
+				$date       = date_create_from_format('Y/m/d', $value);
+				$date_value = date_format($date, 'Y-m-d');
 
-				return sprintf( '"%s"^^xsd:date', self::escape( $date_value ) );
+				return sprintf('"%s"^^xsd:date', self::escape($date_value));
 
 			case Wordlift_Schema_Service::DATA_TYPE_DATE_TIME:
-				$date       = date_create_from_format( 'Y/m/d H:i', $value );
-				$date_value = date_format( $date, 'Y-m-d\TH:i:00' );
+				$date       = date_create_from_format('Y/m/d H:i', $value);
+				$date_value = date_format($date, 'Y-m-d\TH:i:00');
 
-				return sprintf( '"%s"^^xsd:dateTime', self::escape( $date_value ) );
+				return sprintf('"%s"^^xsd:dateTime', self::escape($date_value));
 
 			case Wordlift_Schema_Service::DATA_TYPE_DURATION:
-				$time       = date_create_from_format( 'H:i', $value );
-				$time_value = sprintf( 'PT%dH%dM', date_format( $time, 'H' ), intval( date_format( $time, 'i' ) ) );
+				$time       = date_create_from_format('H:i', $value);
+				$time_value = sprintf('PT%dH%dM', date_format($time, 'H'), intval(date_format($time, 'i')));
 
-				return sprintf( '"%s"^^xsd:duration', self::escape( $time_value ) );
+				return sprintf('"%s"^^xsd:duration', self::escape($time_value));
 
 			case Wordlift_Schema_Service::DATA_TYPE_DOUBLE:
-				return sprintf( '"%s"^^xsd:double', self::escape( $value ) );
+				return sprintf('"%s"^^xsd:double', self::escape($value));
 
 			case Wordlift_Schema_Service::DATA_TYPE_INTEGER:
-				return sprintf( '"%s"^^xsd:integer', self::escape( $value ) );
+				return sprintf('"%s"^^xsd:integer', self::escape($value));
 
 			case Wordlift_Schema_Service::DATA_TYPE_STRING:
-				return sprintf( '"%s"^^xsd:string', self::escape( $value ) );
+				return sprintf('"%s"^^xsd:string', self::escape($value));
 
 			case Wordlift_Schema_Service::DATA_TYPE_URI:
-				return sprintf( '<%s>', self::escape_uri( $value ) );
+				return sprintf('<%s>', self::escape_uri($value));
 
 			case null:
-				$language_tag = ( null !== $language ? "@$language" : '' );
+				$language_tag = (null !== $language ? "@$language" : '');
 
-				return sprintf( '"%s"%s', self::escape( $value ), $language_tag );
+				return sprintf('"%s"%s', self::escape($value), $language_tag);
 
 			default:
 
-				self::$log->warn( "Unknown data type [ type :: $type ]" );
+				self::$log->warn("Unknown data type [ type :: $type ]");
 
 				// Try to insert the value anyway.
-				return sprintf( '"%s"', self::escape( $value ) );
+				return sprintf('"%s"', self::escape($value));
 		}
 
 	}
@@ -268,13 +268,13 @@ 
 	 *
 	 * @return string The escaped URI.
 	 */
-	public static function escape_uri( $uri ) {
+	public static function escape_uri($uri) {
 
 		// Should we validate the IRI?
 		// http://www.w3.org/TR/sparql11-query/#QSynIRI
 
-		$uri = str_replace( '<', '\<', $uri );
-		$uri = str_replace( '>', '\>', $uri );
+		$uri = str_replace('<', '\<', $uri);
+		$uri = str_replace('>', '\>', $uri);
 
 		return $uri;
 	}
@@ -288,7 +288,7 @@ 
 	 *
 	 * @return string The escaped string.
 	 */
-	public static function escape( $string ) {
+	public static function escape($string) {
 
 		// see http://www.w3.org/TR/rdf-sparql-query/
 		//    '\t'	U+0009 (tab)
@@ -300,14 +300,14 @@ 
 		//    "\'"	U+0027 (apostrophe-quote, single quote mark)
 		//    '\\'	U+005C (backslash)
 
-		$string = str_replace( '\\', '\\\\', $string );
-		$string = str_replace( '\'', '\\\'', $string );
-		$string = str_replace( '"', '\\"', $string );
-		$string = str_replace( "\f", '\\f', $string );
-		$string = str_replace( "\b", '\\b', $string );
-		$string = str_replace( "\r", '\\r', $string );
-		$string = str_replace( "\n", '\\n', $string );
-		$string = str_replace( "\t", '\\t', $string );
+		$string = str_replace('\\', '\\\\', $string);
+		$string = str_replace('\'', '\\\'', $string);
+		$string = str_replace('"', '\\"', $string);
+		$string = str_replace("\f", '\\f', $string);
+		$string = str_replace("\b", '\\b', $string);
+		$string = str_replace("\r", '\\r', $string);
+		$string = str_replace("\n", '\\n', $string);
+		$string = str_replace("\t", '\\t', $string);
 
 		return $string;
 	}