File Manager

✏️ Edit File: /home/mklsvubc/sendmaxagency.com/wp-content/plugins/surerank/inc/modules/content-generation/api.php

<?php
/**
 * Content Generation API class
 *
 * Handles content generation related REST API endpoints.
 *
 * @package SureRank\Inc\Modules\Content_Generation
 * @since 1.4.2
 */

namespace SureRank\Inc\Modules\Content_Generation;

use SureRank\Inc\Functions\Send_Json;
use SureRank\Inc\Traits\Get_Instance;
use SureRank\Inc\API\Api_Base;
use WP_REST_Request;
use WP_REST_Server;
use WP_Post;

if ( ! defined( 'ABSPATH' ) ) {
	exit; // Exit if accessed directly.
}

/**
 * Class Api
 *
 * Handles content generation related REST API endpoints.
 */
class Api extends Api_Base {
	use Get_Instance;

/**
	 * Content Generation Controller instance.
	 *
	 * @var Controller
	 * @since 1.4.2
	 */
	private $controller;

/**
	 * Constructor
	 *
	 * @since 1.4.2
	 */
	public function __construct() {
		parent::__construct();
		$this->controller = Controller::get_instance();
	}

/**
	 * Register API routes.
	 *
	 * @since 1.4.2
	 * @return void
	 */
	public function register_routes() {
		$this->register_content_generation_route();
	}

/**
	 * Register index route.
	 *
	 * @since 1.4.2
	 * @return void
	 */
	private function register_content_generation_route() {
		register_rest_route(
			$this->get_api_namespace(),
			'generate-content',
			[
				'methods'             => WP_REST_Server::CREATABLE,
				'callback'            => [ $this, 'generate_content' ],
				'permission_callback' => [ $this, 'validate_permission' ],
				'args'                => [
					'post_id'     => [
						'required'          => false,
						'type'              => 'integer',
						'sanitize_callback' => 'absint',
						'description'       => __( 'Post ID or Term ID whose content needs to be generated (optional)', 'surerank' ),
					],
					'type'        => [
						'required'          => true,
						'type'              => 'string',
						'enum'              => Utils::get_instance()->get_api_types(),
						'sanitize_callback' => 'sanitize_text_field',
						'description'       => __( 'Type of content to generate: page title, page description, social title, social description', 'surerank' ),
						'default'           => 'page_title',
					],
					'is_taxonomy' => [
						'required'          => false,
						'type'              => 'boolean',
						'sanitize_callback' => 'rest_sanitize_boolean',
						'description'       => __( 'Whether the content is for a taxonomy term', 'surerank' ),
						'default'           => false,
					],
				],
				'role_capability'     => 'content_setting',
			]
		);
	}

/**
	 * Generate content for a post.
	 *
	 * @since 1.4.2
	 * @param WP_REST_Request<array<string, mixed>> $request Request object.
	 * @return void
	 */
	public function generate_content( $request ) {
		$post_id     = $request->get_param( 'post_id' );
		$type        = $request->get_param( 'type' );
		$is_taxonomy = $request->get_param( 'is_taxonomy' ) ?? false;

if ( ! in_array( $type, Utils::get_instance()->get_api_types(), true ) ) {
			Send_Json::error(
				[
					'message'     => __( 'Invalid Content Type', 'surerank' ),
					/* translators: %1$s: Valid content types */
					'description' => sprintf( __( 'The content type needs to be one of these types: "%1$s"', 'surerank' ), implode( ', ', Utils::get_instance()->get_api_types() ) ),
					'code'        => 'invalid_content_type',
				]
			);
		}

// If post_id is provided, validate it exists.
		if ( ! empty( $post_id ) ) {
			if ( $is_taxonomy ) {
				$term = get_term( $post_id );

if ( ! $term || is_wp_error( $term ) ) {
					Send_Json::error(
						[
							'message'     => __( 'Invalid term ID', 'surerank' ),
							'description' => __( 'Invalid term ID provided', 'surerank' ),
							'code'        => 'invalid_term_id',
						]
					);
				}
			} else {
				$post = get_post( $post_id );

if ( ! $post || ! $post instanceof WP_Post ) {
					Send_Json::error(
						[
							'message'     => __( 'Invalid post ID', 'surerank' ),
							'description' => __( 'Invalid post ID', 'surerank' ),
							'code'        => 'invalid_post_id',
						]
					);
				}
			}
		}

$inputs = Utils::get_instance()->prepare_content_inputs( $post_id, $is_taxonomy );

$content = $this->controller->generate_content( $inputs, $type );

if ( is_wp_error( $content ) ) {
			Send_Json::error(
				[
					'message'     => $content->get_error_message(),
					'description' => $content->get_error_message(),
					'code'        => $content->get_error_code(),
				]
			);
		}

// Flag for analytics: first AI content generated.
		if ( ! get_option( 'surerank_ai_content_used', false ) ) {
			update_option( 'surerank_ai_content_used', true );
		}

Send_Json::success(
			[
				'content' => $content,
			]
		);
	}

}

Batal

⬅ Naik ke modules 4 item

Nama	Tipe	Ukuran	Diubah	Aksi
🐘api.php	php	4.6 KB	2026-06-26 15:48	✏️ Edit 👁️ View
🐘controller.php	php	2.4 KB	2026-06-26 15:48	✏️ Edit 👁️ View
🐘init.php	php	2 KB	2026-06-26 15:48	✏️ Edit 👁️ View
🐘utils.php	php	3.6 KB	2026-06-26 15:48	✏️ Edit 👁️ View