insideout10 / wordlift-plugin

src/modules/gardening-kg/includes/Term_Entity/Gardening_Kg_Term_Entity_Runner.php

Indentation +124 added lines, -124 removed lines

@@ -9,129 +9,129 @@
 
 class Gardening_Kg_Term_Entity_Runner implements Runner {
 
-	/**
-	 * @var Store $store
-	 */
-	private $store;
-
-	/**
-	 * @var Api_Service
-	 */
-	private $api_service;
-
-	/**
-	 * @paramm Gardening_Kg_Store $store
-	 */
-	public function __construct( Store $store, Api_Service $api_service ) {
-		$this->store       = $store;
-		$this->api_service = $api_service;
-	}
-
-	// phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
-	public function run( $last_id ) {
-		$batch_size = 100;
-		$items      = (array) $this->store->list_items( $last_id, $batch_size );
-
-		foreach ( $items as $item ) {
-			$this->process( $item );
-		}
-
-		// Count the processed items.
-		$count_items = count( $items );
-
-		// We're done, since the number of items is less than the requested qty.
-		if ( $count_items < $batch_size ) {
-			return array( $count_items, null );
-		}
-
-		// Get the last ID.
-		$last_id = end( $items );
-
-		// Finally return the count.
-		return array( $count_items, $last_id );
-	}
-
-	// phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
-	private function process( $item ) {
-		global $wpdb;
-
-		// Get the entity data for non lifted abouts.
-		$id = $wpdb->get_var(
-			$wpdb->prepare(
-				"SELECT id FROM {$wpdb->prefix}wl_entities WHERE content_id = %d AND content_type = %d AND about_jsonld IS NULL",
-				$item,
-				Object_Type_Enum::TERM
-			)
-		);
-
-		// Exit if not found.
-		if ( ! isset( $id ) ) {
-			return;
-		}
-
-		// Lift.
-		$term = get_term( $item );
-
-		// Skip if this post must not be processed, e.g. it's not the right post_type, it's not `publish`, ...
-		if ( ! $this->should_process( $term ) ) {
-			return;
-		}
-
-		$title = wp_strip_all_tags( $term->name );
-
-		$response = $this->api_service->request(
-			'POST',
-			'/thirdparty/cafemedia/gardening-kg/matches',
-			array(
-				'accept'       => 'text/plain',
-				'content-type' => 'text/plain',
-			),
-			$title
-		);
-
-		$response_body = $response->get_body();
-		$lines         = explode( "\n", $response_body );
-		$fields        = explode( "\t", $lines[0] );
-		$jsonld        = isset( $fields[1] ) ? trim( $fields[1] ) : '';
-		// No results.
-		if ( empty( $jsonld ) ) {
-			return;
-		}
-
-		// Store the results in the database
-		$wpdb->query(
-			$wpdb->prepare(
-				"UPDATE {$wpdb->prefix}wl_entities SET about_jsonld = %s WHERE id = %d",
-				$fields[1],
-				$item
-			)
-		);
-	}
-
-	private function should_process( $term ) {
-
-		return is_a( $term, 'WP_Term' ) &&
-			in_array(
-				$term->taxonomy,
-				array(
-					'post_tag',
-					'category',
-				),
-				true
-			);
-	}
-
-	/**
-	 * Get the total number of posts to process.
-	 *
-	 * We only count published posts.
-	 *
-	 * @return int
-	 */
-	public function get_total() {
-		global $wpdb;
-
-		return intval( $wpdb->get_var( "SELECT COUNT(1) FROM $wpdb->posts WHERE post_status = 'publish'" ) );
-	}
+    /**
+     * @var Store $store
+     */
+    private $store;
+
+    /**
+     * @var Api_Service
+     */
+    private $api_service;
+
+    /**
+     * @paramm Gardening_Kg_Store $store
+     */
+    public function __construct( Store $store, Api_Service $api_service ) {
+        $this->store       = $store;
+        $this->api_service = $api_service;
+    }
+
+    // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
+    public function run( $last_id ) {
+        $batch_size = 100;
+        $items      = (array) $this->store->list_items( $last_id, $batch_size );
+
+        foreach ( $items as $item ) {
+            $this->process( $item );
+        }
+
+        // Count the processed items.
+        $count_items = count( $items );
+
+        // We're done, since the number of items is less than the requested qty.
+        if ( $count_items < $batch_size ) {
+            return array( $count_items, null );
+        }
+
+        // Get the last ID.
+        $last_id = end( $items );
+
+        // Finally return the count.
+        return array( $count_items, $last_id );
+    }
+
+    // phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
+    private function process( $item ) {
+        global $wpdb;
+
+        // Get the entity data for non lifted abouts.
+        $id = $wpdb->get_var(
+            $wpdb->prepare(
+                "SELECT id FROM {$wpdb->prefix}wl_entities WHERE content_id = %d AND content_type = %d AND about_jsonld IS NULL",
+                $item,
+                Object_Type_Enum::TERM
+            )
+        );
+
+        // Exit if not found.
+        if ( ! isset( $id ) ) {
+            return;
+        }
+
+        // Lift.
+        $term = get_term( $item );
+
+        // Skip if this post must not be processed, e.g. it's not the right post_type, it's not `publish`, ...
+        if ( ! $this->should_process( $term ) ) {
+            return;
+        }
+
+        $title = wp_strip_all_tags( $term->name );
+
+        $response = $this->api_service->request(
+            'POST',
+            '/thirdparty/cafemedia/gardening-kg/matches',
+            array(
+                'accept'       => 'text/plain',
+                'content-type' => 'text/plain',
+            ),
+            $title
+        );
+
+        $response_body = $response->get_body();
+        $lines         = explode( "\n", $response_body );
+        $fields        = explode( "\t", $lines[0] );
+        $jsonld        = isset( $fields[1] ) ? trim( $fields[1] ) : '';
+        // No results.
+        if ( empty( $jsonld ) ) {
+            return;
+        }
+
+        // Store the results in the database
+        $wpdb->query(
+            $wpdb->prepare(
+                "UPDATE {$wpdb->prefix}wl_entities SET about_jsonld = %s WHERE id = %d",
+                $fields[1],
+                $item
+            )
+        );
+    }
+
+    private function should_process( $term ) {
+
+        return is_a( $term, 'WP_Term' ) &&
+            in_array(
+                $term->taxonomy,
+                array(
+                    'post_tag',
+                    'category',
+                ),
+                true
+            );
+    }
+
+    /**
+     * Get the total number of posts to process.
+     *
+     * We only count published posts.
+     *
+     * @return int
+     */
+    public function get_total() {
+        global $wpdb;
+
+        return intval( $wpdb->get_var( "SELECT COUNT(1) FROM $wpdb->posts WHERE post_status = 'publish'" ) );
+    }
 
 }

Spacing +22 added lines, -22 removed lines

@@ -22,37 +22,37 @@ 
 	/**
 	 * @paramm Gardening_Kg_Store $store
 	 */
-	public function __construct( Store $store, Api_Service $api_service ) {
+	public function __construct(Store $store, Api_Service $api_service) {
 		$this->store       = $store;
 		$this->api_service = $api_service;
 	}
 
 	// phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
-	public function run( $last_id ) {
+	public function run($last_id) {
 		$batch_size = 100;
-		$items      = (array) $this->store->list_items( $last_id, $batch_size );
+		$items      = (array) $this->store->list_items($last_id, $batch_size);
 
-		foreach ( $items as $item ) {
-			$this->process( $item );
+		foreach ($items as $item) {
+			$this->process($item);
 		}
 
 		// Count the processed items.
-		$count_items = count( $items );
+		$count_items = count($items);
 
 		// We're done, since the number of items is less than the requested qty.
-		if ( $count_items < $batch_size ) {
-			return array( $count_items, null );
+		if ($count_items < $batch_size) {
+			return array($count_items, null);
 		}
 
 		// Get the last ID.
-		$last_id = end( $items );
+		$last_id = end($items);
 
 		// Finally return the count.
-		return array( $count_items, $last_id );
+		return array($count_items, $last_id);
 	}
 
 	// phpcs:ignore VariableAnalysis.CodeAnalysis.VariableAnalysis.UnusedVariable
-	private function process( $item ) {
+	private function process($item) {
 		global $wpdb;
 
 		// Get the entity data for non lifted abouts.
@@ -65,19 +65,19 @@ 
 		);
 
 		// Exit if not found.
-		if ( ! isset( $id ) ) {
+		if ( ! isset($id)) {
 			return;
 		}
 
 		// Lift.
-		$term = get_term( $item );
+		$term = get_term($item);
 
 		// Skip if this post must not be processed, e.g. it's not the right post_type, it's not `publish`, ...
-		if ( ! $this->should_process( $term ) ) {
+		if ( ! $this->should_process($term)) {
 			return;
 		}
 
-		$title = wp_strip_all_tags( $term->name );
+		$title = wp_strip_all_tags($term->name);
 
 		$response = $this->api_service->request(
 			'POST',
@@ -90,11 +90,11 @@ 
 		);
 
 		$response_body = $response->get_body();
-		$lines         = explode( "\n", $response_body );
-		$fields        = explode( "\t", $lines[0] );
-		$jsonld        = isset( $fields[1] ) ? trim( $fields[1] ) : '';
+		$lines         = explode("\n", $response_body);
+		$fields        = explode("\t", $lines[0]);
+		$jsonld        = isset($fields[1]) ? trim($fields[1]) : '';
 		// No results.
-		if ( empty( $jsonld ) ) {
+		if (empty($jsonld)) {
 			return;
 		}
 
@@ -108,9 +108,9 @@ 
 		);
 	}
 
-	private function should_process( $term ) {
+	private function should_process($term) {
 
-		return is_a( $term, 'WP_Term' ) &&
+		return is_a($term, 'WP_Term') &&
 			in_array(
 				$term->taxonomy,
 				array(
@@ -131,7 +131,7 @@ 
 	public function get_total() {
 		global $wpdb;
 
-		return intval( $wpdb->get_var( "SELECT COUNT(1) FROM $wpdb->posts WHERE post_status = 'publish'" ) );
+		return intval($wpdb->get_var("SELECT COUNT(1) FROM $wpdb->posts WHERE post_status = 'publish'"));
 	}
 
 }

src/modules/dashboard/includes/Term_Entity_Match/Term_Entity_Match_Rest_Controller.php

Indentation +198 added lines, -198 removed lines

@@ -11,203 +11,203 @@
 
 class Term_Entity_Match_Rest_Controller extends \WP_REST_Controller {
 
-	private $match_service;
-
-	public function __construct( $match_service ) {
-		$this->match_service = $match_service;
-	}
-
-	public function register_hooks() {
-		add_action( 'rest_api_init', array( $this, 'register_routes' ) );
-	}
-
-	/**
-	 * Register the routes for the objects of the controller.
-	 */
-	public function register_routes() {
-
-		// Get term matches by taxonomy name
-		register_rest_route(
-			'wordlift/v1',
-			'/term-matches',
-			array(
-				'methods'             => 'GET',
-				'callback'            => array( $this, 'get_term_matches' ),
-				'args'                => array(
-					'cursor'     => array(
-						'type'              => 'string',
-						'default'           => Cursor::EMPTY_CURSOR_AS_BASE64_STRING,
-						'validate_callback' => 'rest_validate_request_arg',
-						'sanitize_callback' => array( Cursor::class, 'rest_sanitize_request_arg' ),
-					),
-					'limit'      => array(
-						'type'              => 'integer',
-						'validate_callback' => 'rest_validate_request_arg',
-						'default'           => 10,
-						'minimum'           => 1,
-						'maximum'           => 100,
-						'sanitize_callback' => 'absint',
-					),
-					'taxonomies' => array(
-						'type'              => 'array',
-						'validate_callback' => 'rest_validate_request_arg',
-					),
-					'has_match'  => array(
-						'type'              => 'boolean',
-						'required'          => false,
-						'validate_callback' => 'rest_validate_request_arg',
-					),
-				),
-				'permission_callback' => function () {
-					return current_user_can( 'manage_options' );
-				},
-			)
-		);
-
-		// Create a new match for a term
-		register_rest_route(
-			'/wordlift/v1',
-			'/term-matches/(?P<term_id>\d+)/matches',
-			array(
-				'methods'             => 'POST',
-				'callback'            => array( $this, 'create_term_match' ),
-				'args'                => array(
-					'term_id' => array(
-						'required'          => true,
-						'validate_callback' => 'rest_validate_request_arg',
-					),
-				),
-				'permission_callback' => function () {
-					return current_user_can( 'manage_options' );
-				},
-			)
-		);
-
-		// Update an existing term match
-		register_rest_route(
-			'/wordlift/v1',
-			'/term-matches/(?P<term_id>\d+)/matches/(?P<match_id>\d+)',
-			array(
-				'methods'             => 'PUT',
-				'callback'            => array( $this, 'update_term_match' ),
-				'args'                => array(
-					'term_id'  => array(
-						'required'          => true,
-						'validate_callback' => 'rest_validate_request_arg',
-					),
-					'match_id' => array(
-						'required'          => true,
-						'validate_callback' => 'rest_validate_request_arg',
-					),
-				),
-				'permission_callback' => function () {
-
-					return current_user_can( 'manage_options' );
-				},
-			)
-		);
-	}
-
-	/**
-	 * Get the term matches by taxonomy name.
-	 *
-	 * @var $request \WP_REST_Request
-	 */
-	public function get_term_matches( $request ) {
-
-		$cursor = $request->get_param( 'cursor' );
-		if ( $request->has_param( 'limit' ) ) {
-			$cursor['limit'] = $request->get_param( 'limit' );
-		}
-		if ( $request->has_param( 'sort' ) ) {
-			$cursor['sort'] = $request->get_param( 'sort' );
-		}
-		if ( $request->has_param( 'taxonomies' ) ) {
-			$cursor['query']['taxonomies'] = $request->get_param( 'taxonomies' );
-		}
-		if ( $request->has_param( 'has_match' ) ) {
-			$cursor['query']['has_match'] = $request->get_param( 'has_match' );
-		}
-
-		// Query.
-		$taxonomies = isset( $cursor['query']['taxonomies'] ) ? $cursor['query']['taxonomies'] : apply_filters(
-			'wl_dashboard__post_entity_match__taxonomies',
-			array(
-				'post_tag',
-				'category',
-			)
-		);
-
-		$has_match = isset( $cursor['query']['has_match'] ) ? $cursor['query']['has_match'] : null;
-
-		$items = $this->match_service->list_items(
-			array(
-				// Query
-				'taxonomies' => $taxonomies,
-				'has_match'  => $has_match,
-				// Cursor-Pagination
-				'position'   => $cursor['position'],
-				'element'    => $cursor['element'],
-				'direction'  => $cursor['direction'],
-				// `+1` to check if we have other results.
-				'limit'      => $cursor['limit'] + 1,
-				'sort'       => $cursor['sort'],
-			)
-		);
-
-		return new Cursor_Page(
-			$items,
-			$cursor['position'],
-			$cursor['element'],
-			$cursor['direction'],
-			$cursor['sort'],
-			$cursor['limit'],
-			$cursor['query']
-		);
-	}
-
-	/**
-	 * Create a new match for a term.
-	 *
-	 * @var $request \WP_REST_Request
-	 */
-	public function create_term_match( $request ) {
-
-		$term_id = $request->get_param( 'term_id' );
-
-		// If we dont have a entry on the match table, then add one.
-		$content_id = Wordpress_Content_Id::create_term( $term_id );
-		if ( ! Wordpress_Content_Service::get_instance()
-										->get_entity_id( $content_id ) ) {
-			$uri = Entity_Uri_Generator::create_uri( $content_id->get_type(), $content_id->get_id() );
-			Wordpress_Content_Service::get_instance()->set_entity_id( $content_id, $uri );
-		}
-
-		$match_id = $this->match_service->get_id(
-			$term_id,
-			Object_Type_Enum::TERM
-		);
-
-		return $this->match_service->set_jsonld(
-			$term_id,
-			Object_Type_Enum::TERM,
-			$match_id,
-			$request->get_json_params()
-		);
-
-	}
-
-	/**
-	 * @var $request \WP_REST_Request
-	 */
-	public function update_term_match( $request ) {
-
-		return $this->match_service->set_jsonld(
-			$request->get_param( 'term_id' ),
-			Object_Type_Enum::TERM,
-			$request->get_param( 'match_id' ),
-			$request->get_json_params()
-		);
-	}
+    private $match_service;
+
+    public function __construct( $match_service ) {
+        $this->match_service = $match_service;
+    }
+
+    public function register_hooks() {
+        add_action( 'rest_api_init', array( $this, 'register_routes' ) );
+    }
+
+    /**
+     * Register the routes for the objects of the controller.
+     */
+    public function register_routes() {
+
+        // Get term matches by taxonomy name
+        register_rest_route(
+            'wordlift/v1',
+            '/term-matches',
+            array(
+                'methods'             => 'GET',
+                'callback'            => array( $this, 'get_term_matches' ),
+                'args'                => array(
+                    'cursor'     => array(
+                        'type'              => 'string',
+                        'default'           => Cursor::EMPTY_CURSOR_AS_BASE64_STRING,
+                        'validate_callback' => 'rest_validate_request_arg',
+                        'sanitize_callback' => array( Cursor::class, 'rest_sanitize_request_arg' ),
+                    ),
+                    'limit'      => array(
+                        'type'              => 'integer',
+                        'validate_callback' => 'rest_validate_request_arg',
+                        'default'           => 10,
+                        'minimum'           => 1,
+                        'maximum'           => 100,
+                        'sanitize_callback' => 'absint',
+                    ),
+                    'taxonomies' => array(
+                        'type'              => 'array',
+                        'validate_callback' => 'rest_validate_request_arg',
+                    ),
+                    'has_match'  => array(
+                        'type'              => 'boolean',
+                        'required'          => false,
+                        'validate_callback' => 'rest_validate_request_arg',
+                    ),
+                ),
+                'permission_callback' => function () {
+                    return current_user_can( 'manage_options' );
+                },
+            )
+        );
+
+        // Create a new match for a term
+        register_rest_route(
+            '/wordlift/v1',
+            '/term-matches/(?P<term_id>\d+)/matches',
+            array(
+                'methods'             => 'POST',
+                'callback'            => array( $this, 'create_term_match' ),
+                'args'                => array(
+                    'term_id' => array(
+                        'required'          => true,
+                        'validate_callback' => 'rest_validate_request_arg',
+                    ),
+                ),
+                'permission_callback' => function () {
+                    return current_user_can( 'manage_options' );
+                },
+            )
+        );
+
+        // Update an existing term match
+        register_rest_route(
+            '/wordlift/v1',
+            '/term-matches/(?P<term_id>\d+)/matches/(?P<match_id>\d+)',
+            array(
+                'methods'             => 'PUT',
+                'callback'            => array( $this, 'update_term_match' ),
+                'args'                => array(
+                    'term_id'  => array(
+                        'required'          => true,
+                        'validate_callback' => 'rest_validate_request_arg',
+                    ),
+                    'match_id' => array(
+                        'required'          => true,
+                        'validate_callback' => 'rest_validate_request_arg',
+                    ),
+                ),
+                'permission_callback' => function () {
+
+                    return current_user_can( 'manage_options' );
+                },
+            )
+        );
+    }
+
+    /**
+     * Get the term matches by taxonomy name.
+     *
+     * @var $request \WP_REST_Request
+     */
+    public function get_term_matches( $request ) {
+
+        $cursor = $request->get_param( 'cursor' );
+        if ( $request->has_param( 'limit' ) ) {
+            $cursor['limit'] = $request->get_param( 'limit' );
+        }
+        if ( $request->has_param( 'sort' ) ) {
+            $cursor['sort'] = $request->get_param( 'sort' );
+        }
+        if ( $request->has_param( 'taxonomies' ) ) {
+            $cursor['query']['taxonomies'] = $request->get_param( 'taxonomies' );
+        }
+        if ( $request->has_param( 'has_match' ) ) {
+            $cursor['query']['has_match'] = $request->get_param( 'has_match' );
+        }
+
+        // Query.
+        $taxonomies = isset( $cursor['query']['taxonomies'] ) ? $cursor['query']['taxonomies'] : apply_filters(
+            'wl_dashboard__post_entity_match__taxonomies',
+            array(
+                'post_tag',
+                'category',
+            )
+        );
+
+        $has_match = isset( $cursor['query']['has_match'] ) ? $cursor['query']['has_match'] : null;
+
+        $items = $this->match_service->list_items(
+            array(
+                // Query
+                'taxonomies' => $taxonomies,
+                'has_match'  => $has_match,
+                // Cursor-Pagination
+                'position'   => $cursor['position'],
+                'element'    => $cursor['element'],
+                'direction'  => $cursor['direction'],
+                // `+1` to check if we have other results.
+                'limit'      => $cursor['limit'] + 1,
+                'sort'       => $cursor['sort'],
+            )
+        );
+
+        return new Cursor_Page(
+            $items,
+            $cursor['position'],
+            $cursor['element'],
+            $cursor['direction'],
+            $cursor['sort'],
+            $cursor['limit'],
+            $cursor['query']
+        );
+    }
+
+    /**
+     * Create a new match for a term.
+     *
+     * @var $request \WP_REST_Request
+     */
+    public function create_term_match( $request ) {
+
+        $term_id = $request->get_param( 'term_id' );
+
+        // If we dont have a entry on the match table, then add one.
+        $content_id = Wordpress_Content_Id::create_term( $term_id );
+        if ( ! Wordpress_Content_Service::get_instance()
+                                        ->get_entity_id( $content_id ) ) {
+            $uri = Entity_Uri_Generator::create_uri( $content_id->get_type(), $content_id->get_id() );
+            Wordpress_Content_Service::get_instance()->set_entity_id( $content_id, $uri );
+        }
+
+        $match_id = $this->match_service->get_id(
+            $term_id,
+            Object_Type_Enum::TERM
+        );
+
+        return $this->match_service->set_jsonld(
+            $term_id,
+            Object_Type_Enum::TERM,
+            $match_id,
+            $request->get_json_params()
+        );
+
+    }
+
+    /**
+     * @var $request \WP_REST_Request
+     */
+    public function update_term_match( $request ) {
+
+        return $this->match_service->set_jsonld(
+            $request->get_param( 'term_id' ),
+            Object_Type_Enum::TERM,
+            $request->get_param( 'match_id' ),
+            $request->get_json_params()
+        );
+    }
 
 }

src/modules/dashboard/includes/Term_Entity_Match/Term_Entity_Match_Service.php

Indentation +50 added lines, -50 removed lines

@@ -7,55 +7,55 @@
 
 class Term_Entity_Match_Service extends Match_Service {
 
-	public function list_items( $args ) {
-		global $wpdb;
-
-		$params = wp_parse_args(
-			$args,
-			array(
-				'position'  => null,
-				'element'   => 'INCLUDED',
-				'direction' => 'ASCENDING',
-				'limit'     => 10,
-				'sort'      => '+id',
-				// Query.
-				'taxonomy'  => null,
-				'has_match' => null,
-			)
-		);
-
-		/**
-		 * @var $sort Sort
-		 */
-		$sort = new Sort( $params['sort'] );
-
-		$query_builder = new Query_Builder(
-			$params,
-			$sort
-		);
-		$query         = $query_builder
-			->get();
-
-		$items = $wpdb->get_results(
-		// Each function above is preparing `$sql` by using `$wpdb->prepare`.
-		// phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared
-			$wpdb->prepare( $query, Object_Type_Enum::TERM )
-		);
-
-		$sort->apply( $items );
-
-		return $this->map( $items );
-	}
-
-	private function map( array $items ) {
-		return array_map(
-			function ( $item ) {
-				$data             = json_decode( $item->match_jsonld, true );
-				$item->match_name = $data && is_array( $data ) && array_key_exists( 'name', $data ) ? $data['name'] : null;
-				return $item;
-			},
-			$items
-		);
-	}
+    public function list_items( $args ) {
+        global $wpdb;
+
+        $params = wp_parse_args(
+            $args,
+            array(
+                'position'  => null,
+                'element'   => 'INCLUDED',
+                'direction' => 'ASCENDING',
+                'limit'     => 10,
+                'sort'      => '+id',
+                // Query.
+                'taxonomy'  => null,
+                'has_match' => null,
+            )
+        );
+
+        /**
+         * @var $sort Sort
+         */
+        $sort = new Sort( $params['sort'] );
+
+        $query_builder = new Query_Builder(
+            $params,
+            $sort
+        );
+        $query         = $query_builder
+            ->get();
+
+        $items = $wpdb->get_results(
+        // Each function above is preparing `$sql` by using `$wpdb->prepare`.
+        // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared
+            $wpdb->prepare( $query, Object_Type_Enum::TERM )
+        );
+
+        $sort->apply( $items );
+
+        return $this->map( $items );
+    }
+
+    private function map( array $items ) {
+        return array_map(
+            function ( $item ) {
+                $data             = json_decode( $item->match_jsonld, true );
+                $item->match_name = $data && is_array( $data ) && array_key_exists( 'name', $data ) ? $data['name'] : null;
+                return $item;
+            },
+            $items
+        );
+    }
 
 }

src/modules/dashboard/includes/Match/Match_Query_Builder.php

Indentation +106 added lines, -106 removed lines

@@ -5,111 +5,111 @@
 use Wordlift\Assertions;
 
 abstract class Match_Query_Builder {
-	/**
-	 * @var array
-	 */
-	protected $params;
-	/**
-	 * @var Match_Sort
-	 */
-	protected $sort;
-
-	protected $sql = '';
-
-	/**
-	 * @param $params array
-	 * @param $sort Match_Sort
-	 *
-	 * @throws \Exception Throws Exception if the parameters arent of right type.
-	 */
-	public function __construct( $params, $sort ) {
-
-		Assertions::is_array( $params );
-		Assertions::is_a( $sort, Match_Sort::class );
-
-		$this->params = $params;
-		$this->sort   = $sort;
-	}
-
-	/**
-	 * This method should build the query from params and sort object,
-	 * then return the prepared query.
-	 *
-	 * @return string
-	 */
-	public function get() {
-		$this->build();
-
-		return $this->sql;
-	}
-
-	/**
-	 * @return void
-	 */
-	abstract protected function build();
-
-	/**
-	 * Apply the sort for the cursor.
-	 *
-	 * @return Match_Query_Builder
-	 */
-	protected function cursor() {
-		global $wpdb;
-
-		// If there is no position set, the condition doesnt need to be applied
-		// This is necessary in case of `last` and `first` attribute.
-		if ( empty( $this->params['position'] ) ) {
-			return $this;
-		}
-
-		$tmp_sql             = " AND {$this->sort->get_field_name()} ";
-		$is_included         = ( $this->params['element'] !== 'EXCLUDED' );
-		$is_ascending        = ( $this->params['direction'] !== 'DESCENDING' );
-		$is_sorted_ascending = $this->sort->is_ascending();
-		switch ( array( $is_ascending, $is_sorted_ascending ) ) {
-			case array( true, true ):   // Forward & Ascending Order
-			case array( false, false ): // Backward & Descending Order
-				$tmp_sql .= ' >';
-				break;
-			case array( true, false ):  // Forward & Ascending Order
-			case array( false, true ):  // Backward & Descending Order
-				$tmp_sql .= ' <';
-				break;
-		}
-		if ( $is_included ) {
-			$tmp_sql .= '=';
-		}
-		$tmp_sql .= ' %s';
-
-		// `$tmp_sql` is built dynamically in this function
-		// phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared
-		$this->sql .= $wpdb->prepare( $tmp_sql, $this->params['position'] );
-		return $this;
-	}
-
-	protected function has_match() {
-		$value = $this->params['has_match'];
-
-		if ( true === $value ) {
-			$this->sql .= ' AND e.about_jsonld IS NOT NULL ';
-		} elseif ( false === $value ) {
-			$this->sql .= ' AND e.about_jsonld IS NULL ';
-		}
-
-		return $this;
-	}
-
-	protected function limit() {
-		$limit = $this->params['limit'];
-		global $wpdb;
-		$this->sql .= $wpdb->prepare( ' LIMIT %d', $limit );
-		return $this;
-	}
-
-	protected function order_by() {
-		$direction  = $this->params['direction'];
-		$this->sql .= $this->sort->get_orderby_clause( $direction );
-		return $this;
-	}
+    /**
+     * @var array
+     */
+    protected $params;
+    /**
+     * @var Match_Sort
+     */
+    protected $sort;
+
+    protected $sql = '';
+
+    /**
+     * @param $params array
+     * @param $sort Match_Sort
+     *
+     * @throws \Exception Throws Exception if the parameters arent of right type.
+     */
+    public function __construct( $params, $sort ) {
+
+        Assertions::is_array( $params );
+        Assertions::is_a( $sort, Match_Sort::class );
+
+        $this->params = $params;
+        $this->sort   = $sort;
+    }
+
+    /**
+     * This method should build the query from params and sort object,
+     * then return the prepared query.
+     *
+     * @return string
+     */
+    public function get() {
+        $this->build();
+
+        return $this->sql;
+    }
+
+    /**
+     * @return void
+     */
+    abstract protected function build();
+
+    /**
+     * Apply the sort for the cursor.
+     *
+     * @return Match_Query_Builder
+     */
+    protected function cursor() {
+        global $wpdb;
+
+        // If there is no position set, the condition doesnt need to be applied
+        // This is necessary in case of `last` and `first` attribute.
+        if ( empty( $this->params['position'] ) ) {
+            return $this;
+        }
+
+        $tmp_sql             = " AND {$this->sort->get_field_name()} ";
+        $is_included         = ( $this->params['element'] !== 'EXCLUDED' );
+        $is_ascending        = ( $this->params['direction'] !== 'DESCENDING' );
+        $is_sorted_ascending = $this->sort->is_ascending();
+        switch ( array( $is_ascending, $is_sorted_ascending ) ) {
+            case array( true, true ):   // Forward & Ascending Order
+            case array( false, false ): // Backward & Descending Order
+                $tmp_sql .= ' >';
+                break;
+            case array( true, false ):  // Forward & Ascending Order
+            case array( false, true ):  // Backward & Descending Order
+                $tmp_sql .= ' <';
+                break;
+        }
+        if ( $is_included ) {
+            $tmp_sql .= '=';
+        }
+        $tmp_sql .= ' %s';
+
+        // `$tmp_sql` is built dynamically in this function
+        // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared
+        $this->sql .= $wpdb->prepare( $tmp_sql, $this->params['position'] );
+        return $this;
+    }
+
+    protected function has_match() {
+        $value = $this->params['has_match'];
+
+        if ( true === $value ) {
+            $this->sql .= ' AND e.about_jsonld IS NOT NULL ';
+        } elseif ( false === $value ) {
+            $this->sql .= ' AND e.about_jsonld IS NULL ';
+        }
+
+        return $this;
+    }
+
+    protected function limit() {
+        $limit = $this->params['limit'];
+        global $wpdb;
+        $this->sql .= $wpdb->prepare( ' LIMIT %d', $limit );
+        return $this;
+    }
+
+    protected function order_by() {
+        $direction  = $this->params['direction'];
+        $this->sql .= $this->sort->get_orderby_clause( $direction );
+        return $this;
+    }
 
 }

Spacing +17 added lines, -17 removed lines

@@ -22,10 +22,10 @@ 
 	 *
 	 * @throws \Exception Throws Exception if the parameters arent of right type.
 	 */
-	public function __construct( $params, $sort ) {
+	public function __construct($params, $sort) {
 
-		Assertions::is_array( $params );
-		Assertions::is_a( $sort, Match_Sort::class );
+		Assertions::is_array($params);
+		Assertions::is_a($sort, Match_Sort::class);
 
 		$this->params = $params;
 		$this->sort   = $sort;
@@ -58,41 +58,41 @@ 
 
 		// If there is no position set, the condition doesnt need to be applied
 		// This is necessary in case of `last` and `first` attribute.
-		if ( empty( $this->params['position'] ) ) {
+		if (empty($this->params['position'])) {
 			return $this;
 		}
 
 		$tmp_sql             = " AND {$this->sort->get_field_name()} ";
-		$is_included         = ( $this->params['element'] !== 'EXCLUDED' );
-		$is_ascending        = ( $this->params['direction'] !== 'DESCENDING' );
+		$is_included         = ($this->params['element'] !== 'EXCLUDED');
+		$is_ascending        = ($this->params['direction'] !== 'DESCENDING');
 		$is_sorted_ascending = $this->sort->is_ascending();
-		switch ( array( $is_ascending, $is_sorted_ascending ) ) {
-			case array( true, true ):   // Forward & Ascending Order
-			case array( false, false ): // Backward & Descending Order
+		switch (array($is_ascending, $is_sorted_ascending)) {
+			case array(true, true):   // Forward & Ascending Order
+			case array(false, false): // Backward & Descending Order
 				$tmp_sql .= ' >';
 				break;
-			case array( true, false ):  // Forward & Ascending Order
-			case array( false, true ):  // Backward & Descending Order
+			case array(true, false):  // Forward & Ascending Order
+			case array(false, true):  // Backward & Descending Order
 				$tmp_sql .= ' <';
 				break;
 		}
-		if ( $is_included ) {
+		if ($is_included) {
 			$tmp_sql .= '=';
 		}
 		$tmp_sql .= ' %s';
 
 		// `$tmp_sql` is built dynamically in this function
 		// phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared
-		$this->sql .= $wpdb->prepare( $tmp_sql, $this->params['position'] );
+		$this->sql .= $wpdb->prepare($tmp_sql, $this->params['position']);
 		return $this;
 	}
 
 	protected function has_match() {
 		$value = $this->params['has_match'];
 
-		if ( true === $value ) {
+		if (true === $value) {
 			$this->sql .= ' AND e.about_jsonld IS NOT NULL ';
-		} elseif ( false === $value ) {
+		} elseif (false === $value) {
 			$this->sql .= ' AND e.about_jsonld IS NULL ';
 		}
 
@@ -102,13 +102,13 @@ 
 	protected function limit() {
 		$limit = $this->params['limit'];
 		global $wpdb;
-		$this->sql .= $wpdb->prepare( ' LIMIT %d', $limit );
+		$this->sql .= $wpdb->prepare(' LIMIT %d', $limit);
 		return $this;
 	}
 
 	protected function order_by() {
 		$direction  = $this->params['direction'];
-		$this->sql .= $this->sort->get_orderby_clause( $direction );
+		$this->sql .= $this->sort->get_orderby_clause($direction);
 		return $this;
 	}
 

src/modules/dashboard/includes/Post_Entity_Match/Post_Entity_Match_Service.php

Indentation +57 added lines, -57 removed lines

@@ -8,71 +8,71 @@
 
 class Post_Entity_Match_Service extends Match_Service {
 
-	public function list_items( $args ) {
-		global $wpdb;
+    public function list_items( $args ) {
+        global $wpdb;
 
-		$params = wp_parse_args(
-			$args,
-			array(
-				'position'  => null,
-				'element'   => 'INCLUDED',
-				'direction' => 'ASCENDING',
-				'limit'     => 10,
-				'sort'      => '+id',
-				'post_type' => null,
-				'has_match' => null,
-			)
-		);
-		/**
-		 * @var $sort Sort
-		 */
-		$sort = new Sort( $params['sort'] );
+        $params = wp_parse_args(
+            $args,
+            array(
+                'position'  => null,
+                'element'   => 'INCLUDED',
+                'direction' => 'ASCENDING',
+                'limit'     => 10,
+                'sort'      => '+id',
+                'post_type' => null,
+                'has_match' => null,
+            )
+        );
+        /**
+         * @var $sort Sort
+         */
+        $sort = new Sort( $params['sort'] );
 
-		$query_builder = new Query_Builder(
-			$params,
-			$sort
-		);
+        $query_builder = new Query_Builder(
+            $params,
+            $sort
+        );
 
-		$items = $wpdb->get_results(
-			// Each function above is preparing `$sql` by using `$wpdb->prepare`.
-			// phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared
-			$wpdb->prepare( $query_builder->get(), Object_Type_Enum::POST )
-		);
+        $items = $wpdb->get_results(
+            // Each function above is preparing `$sql` by using `$wpdb->prepare`.
+            // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared
+            $wpdb->prepare( $query_builder->get(), Object_Type_Enum::POST )
+        );
 
-		$sort->apply( $items );
+        $sort->apply( $items );
 
-		return $this->map( $items );
-	}
+        return $this->map( $items );
+    }
 
-	/** Returns an array of rows where each row contains
-	 * 'post_title' => The title of the post
-	 * 'id'   => The id of the post
-	 * 'post_link' => The edit post link
-	 * 'parent_post_title' => The title of the post linked to this post via wprm_parent_post_id property
-	 * ( this is only applicable when the post is wprm_recipe, returns null if not present )
-	 * 'parent_post_id'  => The id of the linked parent post.
-	 * 'parent_post_link' => The link to parent post.
-	 * 'match_jsonld' => The matched `about_jsonld` column from wl_entities.
-	 * 'match_id' => This id points to id column of wl_entities table.
-	 */
-	private function map( array $items ) {
-		return array_map(
-			function ( $item ) {
-				$data             = json_decode( $item->match_jsonld, true );
-				$item->match_name = $data && is_array( $data ) && array_key_exists( 'name', $data ) ? $data['name'] : null;
+    /** Returns an array of rows where each row contains
+     * 'post_title' => The title of the post
+     * 'id'   => The id of the post
+     * 'post_link' => The edit post link
+     * 'parent_post_title' => The title of the post linked to this post via wprm_parent_post_id property
+     * ( this is only applicable when the post is wprm_recipe, returns null if not present )
+     * 'parent_post_id'  => The id of the linked parent post.
+     * 'parent_post_link' => The link to parent post.
+     * 'match_jsonld' => The matched `about_jsonld` column from wl_entities.
+     * 'match_id' => This id points to id column of wl_entities table.
+     */
+    private function map( array $items ) {
+        return array_map(
+            function ( $item ) {
+                $data             = json_decode( $item->match_jsonld, true );
+                $item->match_name = $data && is_array( $data ) && array_key_exists( 'name', $data ) ? $data['name'] : null;
 
-				if ( $item->id ) {
-					$item->post_link = get_edit_post_link( $item->id, 'ui' );
-				}
+                if ( $item->id ) {
+                    $item->post_link = get_edit_post_link( $item->id, 'ui' );
+                }
 
-				if ( $item->parent_post_id ) {
-					$item->parent_post_link = get_edit_post_link( $item->parent_post_id, 'ui' );
-				}
+                if ( $item->parent_post_id ) {
+                    $item->parent_post_link = get_edit_post_link( $item->parent_post_id, 'ui' );
+                }
 
-				return $item;
-			},
-			$items
-		);
-	}
+                return $item;
+            },
+            $items
+        );
+    }
 
 }

src/modules/dashboard/includes/Post_Entity_Match/Post_Entity_Match_Rest_Controller.php

Indentation +200 added lines, -200 removed lines

@@ -11,204 +11,204 @@
 
 class Post_Entity_Match_Rest_Controller extends \WP_REST_Controller {
 
-	/**
-	 * @var Post_Entity_Match_Service
-	 */
-	private $match_service;
-
-	public function __construct( $match_service ) {
-		$this->match_service = $match_service;
-	}
-
-	public function register_hooks() {
-		add_action( 'rest_api_init', array( $this, 'register_routes' ) );
-	}
-
-	/**
-	 * Register the routes for the objects of the controller.
-	 */
-	public function register_routes() {
-
-		// Get term matches by taxonomy name
-		register_rest_route(
-			'wordlift/v1',
-			'/post-matches',
-			array(
-				'methods'             => 'GET',
-				'callback'            => array( $this, 'get_post_matches' ),
-				'args'                => array(
-					'cursor'     => array(
-						'type'              => 'string',
-						'default'           => Cursor::EMPTY_CURSOR_AS_BASE64_STRING,
-						'validate_callback' => 'rest_validate_request_arg',
-						'sanitize_callback' => array( Cursor::class, 'rest_sanitize_request_arg' ),
-					),
-					'limit'      => array(
-						'type'              => 'integer',
-						'validate_callback' => 'rest_validate_request_arg',
-						'default'           => 10,
-						'minimum'           => 1,
-						'maximum'           => 100,
-						'sanitize_callback' => 'absint',
-					),
-					'post_types' => array(
-						'type'              => 'array',
-						'validate_callback' => 'rest_validate_request_arg',
-					),
-					'has_match'  => array(
-						'type'              => 'boolean',
-						'required'          => false,
-						'validate_callback' => 'rest_validate_request_arg',
-					),
-				),
-				'permission_callback' => function () {
-					return current_user_can( 'manage_options' );
-				},
-			)
-		);
-
-		// Create a new match for a post
-		register_rest_route(
-			'wordlift/v1',
-			'/post-matches/(?P<post_id>\d+)/matches',
-			array(
-				'methods'             => 'POST',
-				'callback'            => array( $this, 'create_post_match' ),
-				'args'                => array(
-					'post_id' => array(
-						'required'          => true,
-						'validate_callback' => 'rest_validate_request_arg',
-					),
-				),
-				'permission_callback' => function () {
-					return current_user_can( 'manage_options' );
-				},
-			)
-		);
-
-		// Update an existing post match
-		register_rest_route(
-			'wordlift/v1',
-			'/post-matches/(?P<post_id>\d+)/matches/(?P<match_id>\d+)',
-			array(
-				'methods'             => 'PUT',
-				'callback'            => array( $this, 'update_post_match' ),
-				'args'                => array(
-					'post_id'  => array(
-						'required'          => true,
-						'validate_callback' => 'rest_validate_request_arg',
-					),
-					'match_id' => array(
-						'required'          => true,
-						'validate_callback' => 'rest_validate_request_arg',
-					),
-				),
-				'permission_callback' => function () {
-
-					return current_user_can( 'manage_options' );
-				},
-			)
-		);
-
-	}
-
-	/**
-	 * Get the term matches by taxonomy name.
-	 *
-	 * @var $request \WP_REST_Request
-	 */
-	public function get_post_matches( $request ) {
-
-		$cursor = $request->get_param( 'cursor' );
-		if ( $request->has_param( 'limit' ) ) {
-			$cursor['limit'] = $request->get_param( 'limit' );
-		}
-		if ( $request->has_param( 'sort' ) ) {
-			$cursor['sort'] = $request->get_param( 'sort' );
-		}
-		if ( $request->has_param( 'post_types' ) ) {
-			$cursor['query']['post_types'] = $request->get_param( 'post_types' );
-		}
-		if ( $request->has_param( 'has_match' ) ) {
-			$cursor['query']['has_match'] = $request->get_param( 'has_match' );
-		}
-
-		// Query.
-		$post_types = isset( $cursor['query']['post_types'] ) ? $cursor['query']['post_types'] : apply_filters(
-			'wl_dashboard__post_entity_match__post_types',
-			array(
-				'post',
-				'page',
-			)
-		);
-		$has_match  = isset( $cursor['query']['has_match'] ) ? $cursor['query']['has_match'] : null;
-
-		$items = $this->match_service->list_items(
-			array(
-				// Query
-				'post_types' => $post_types,
-				'has_match'  => $has_match,
-				// Cursor-Pagination
-				'position'   => $cursor['position'],
-				'element'    => $cursor['element'],
-				'direction'  => $cursor['direction'],
-				// `+1` to check if we have other results.
-				'limit'      => $cursor['limit'] + 1,
-				'sort'       => $cursor['sort'],
-			)
-		);
-
-		return new Cursor_Page(
-			$items,
-			$cursor['position'],
-			$cursor['element'],
-			$cursor['direction'],
-			$cursor['sort'],
-			$cursor['limit'],
-			$cursor['query']
-		);
-	}
-
-	/**
-	 * Create a new match for a post.
-	 *
-	 * @var $request \WP_REST_Request
-	 */
-	public function create_post_match( $request ) {
-		$post_id = $request->get_param( 'post_id' );
-
-		// If we dont have a entry on the match table, then add one.
-		$content_id = Wordpress_Content_Id::create_post( $post_id );
-		if ( ! Wordpress_Content_Service::get_instance()
-										->get_entity_id( $content_id ) ) {
-			$uri = Entity_Uri_Generator::create_uri( $content_id->get_type(), $content_id->get_id() );
-			Wordpress_Content_Service::get_instance()->set_entity_id( $content_id, $uri );
-		}
-
-		$match_id = $this->match_service->get_id(
-			$post_id,
-			Object_Type_Enum::POST
-		);
-
-		return $this->match_service->set_jsonld(
-			$post_id,
-			Object_Type_Enum::POST,
-			$match_id,
-			$request->get_json_params()
-		);
-
-	}
-
-	/**
-	 * @var $request \WP_REST_Request
-	 */
-	public function update_post_match( $request ) {
-
-		return $this->match_service->set_jsonld(
-			$request->get_param( 'post_id' ),
-			Object_Type_Enum::POST,
-			$request->get_param( 'match_id' ),
-			$request->get_json_params()
-		);
-	}
+    /**
+     * @var Post_Entity_Match_Service
+     */
+    private $match_service;
+
+    public function __construct( $match_service ) {
+        $this->match_service = $match_service;
+    }
+
+    public function register_hooks() {
+        add_action( 'rest_api_init', array( $this, 'register_routes' ) );
+    }
+
+    /**
+     * Register the routes for the objects of the controller.
+     */
+    public function register_routes() {
+
+        // Get term matches by taxonomy name
+        register_rest_route(
+            'wordlift/v1',
+            '/post-matches',
+            array(
+                'methods'             => 'GET',
+                'callback'            => array( $this, 'get_post_matches' ),
+                'args'                => array(
+                    'cursor'     => array(
+                        'type'              => 'string',
+                        'default'           => Cursor::EMPTY_CURSOR_AS_BASE64_STRING,
+                        'validate_callback' => 'rest_validate_request_arg',
+                        'sanitize_callback' => array( Cursor::class, 'rest_sanitize_request_arg' ),
+                    ),
+                    'limit'      => array(
+                        'type'              => 'integer',
+                        'validate_callback' => 'rest_validate_request_arg',
+                        'default'           => 10,
+                        'minimum'           => 1,
+                        'maximum'           => 100,
+                        'sanitize_callback' => 'absint',
+                    ),
+                    'post_types' => array(
+                        'type'              => 'array',
+                        'validate_callback' => 'rest_validate_request_arg',
+                    ),
+                    'has_match'  => array(
+                        'type'              => 'boolean',
+                        'required'          => false,
+                        'validate_callback' => 'rest_validate_request_arg',
+                    ),
+                ),
+                'permission_callback' => function () {
+                    return current_user_can( 'manage_options' );
+                },
+            )
+        );
+
+        // Create a new match for a post
+        register_rest_route(
+            'wordlift/v1',
+            '/post-matches/(?P<post_id>\d+)/matches',
+            array(
+                'methods'             => 'POST',
+                'callback'            => array( $this, 'create_post_match' ),
+                'args'                => array(
+                    'post_id' => array(
+                        'required'          => true,
+                        'validate_callback' => 'rest_validate_request_arg',
+                    ),
+                ),
+                'permission_callback' => function () {
+                    return current_user_can( 'manage_options' );
+                },
+            )
+        );
+
+        // Update an existing post match
+        register_rest_route(
+            'wordlift/v1',
+            '/post-matches/(?P<post_id>\d+)/matches/(?P<match_id>\d+)',
+            array(
+                'methods'             => 'PUT',
+                'callback'            => array( $this, 'update_post_match' ),
+                'args'                => array(
+                    'post_id'  => array(
+                        'required'          => true,
+                        'validate_callback' => 'rest_validate_request_arg',
+                    ),
+                    'match_id' => array(
+                        'required'          => true,
+                        'validate_callback' => 'rest_validate_request_arg',
+                    ),
+                ),
+                'permission_callback' => function () {
+
+                    return current_user_can( 'manage_options' );
+                },
+            )
+        );
+
+    }
+
+    /**
+     * Get the term matches by taxonomy name.
+     *
+     * @var $request \WP_REST_Request
+     */
+    public function get_post_matches( $request ) {
+
+        $cursor = $request->get_param( 'cursor' );
+        if ( $request->has_param( 'limit' ) ) {
+            $cursor['limit'] = $request->get_param( 'limit' );
+        }
+        if ( $request->has_param( 'sort' ) ) {
+            $cursor['sort'] = $request->get_param( 'sort' );
+        }
+        if ( $request->has_param( 'post_types' ) ) {
+            $cursor['query']['post_types'] = $request->get_param( 'post_types' );
+        }
+        if ( $request->has_param( 'has_match' ) ) {
+            $cursor['query']['has_match'] = $request->get_param( 'has_match' );
+        }
+
+        // Query.
+        $post_types = isset( $cursor['query']['post_types'] ) ? $cursor['query']['post_types'] : apply_filters(
+            'wl_dashboard__post_entity_match__post_types',
+            array(
+                'post',
+                'page',
+            )
+        );
+        $has_match  = isset( $cursor['query']['has_match'] ) ? $cursor['query']['has_match'] : null;
+
+        $items = $this->match_service->list_items(
+            array(
+                // Query
+                'post_types' => $post_types,
+                'has_match'  => $has_match,
+                // Cursor-Pagination
+                'position'   => $cursor['position'],
+                'element'    => $cursor['element'],
+                'direction'  => $cursor['direction'],
+                // `+1` to check if we have other results.
+                'limit'      => $cursor['limit'] + 1,
+                'sort'       => $cursor['sort'],
+            )
+        );
+
+        return new Cursor_Page(
+            $items,
+            $cursor['position'],
+            $cursor['element'],
+            $cursor['direction'],
+            $cursor['sort'],
+            $cursor['limit'],
+            $cursor['query']
+        );
+    }
+
+    /**
+     * Create a new match for a post.
+     *
+     * @var $request \WP_REST_Request
+     */
+    public function create_post_match( $request ) {
+        $post_id = $request->get_param( 'post_id' );
+
+        // If we dont have a entry on the match table, then add one.
+        $content_id = Wordpress_Content_Id::create_post( $post_id );
+        if ( ! Wordpress_Content_Service::get_instance()
+                                        ->get_entity_id( $content_id ) ) {
+            $uri = Entity_Uri_Generator::create_uri( $content_id->get_type(), $content_id->get_id() );
+            Wordpress_Content_Service::get_instance()->set_entity_id( $content_id, $uri );
+        }
+
+        $match_id = $this->match_service->get_id(
+            $post_id,
+            Object_Type_Enum::POST
+        );
+
+        return $this->match_service->set_jsonld(
+            $post_id,
+            Object_Type_Enum::POST,
+            $match_id,
+            $request->get_json_params()
+        );
+
+    }
+
+    /**
+     * @var $request \WP_REST_Request
+     */
+    public function update_post_match( $request ) {
+
+        return $this->match_service->set_jsonld(
+            $request->get_param( 'post_id' ),
+            Object_Type_Enum::POST,
+            $request->get_param( 'match_id' ),
+            $request->get_json_params()
+        );
+    }
 }