wp-api-menus.php

<?php
/**
 * Plugin Name: WP REST API Menus
 * Plugin URI: https://github.com/unfulvio/wp-api-menus
 * Description: Extends WP API with WordPress menu routes.
 * Version: 1.4.0
 * Requires at least: 5.8
 * Tested up to: 5.9.1
 * Requires PHP: 5.6
 * Author: Fulvio Notarstefano
 * Author URI: https://github.com/unfulvio
 * Text Domain: wp-api-menus
 *
 * @package WP_API_Menus
 */

/**
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License, version 2 or, at
 * your discretion, any later version, as published by the Free
 * Software Foundation.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
 */

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

// WP API v1.
include_once 'includes/wp-api-menus-v1.php';
// WP API v2.
include_once 'includes/wp-api-menus-v2.php';

if ( ! function_exists( 'wp_rest_menus_init' ) ) :
	/**
	 * Init JSON REST API Menu routes.
	 *
	 * @since 1.0.0
	 */
	function wp_rest_menus_init() {

		if ( ! defined( 'JSON_API_VERSION' ) &&
		     ! in_array( 'json-rest-api/plugin.php', get_option( 'active_plugins', array() ) )
		) {
			$class = new WP_REST_Menus();
			add_filter( 'rest_api_init', array( $class, 'register_routes' ) );
		} else {
			$class = new WP_JSON_Menus();
			add_filter( 'json_endpoints', array( $class, 'register_routes' ) );
		}
	}

	add_action( 'init', 'wp_rest_menus_init' );
endif;

if ( ! function_exists( '_wp_rest_menus_doing_it_wrong' ) ) :
	/**
	 * Mark a function as "deprecated" using doing_it_wrong().
	 *
	 * @param string $function
	 * @param string $route
	 * @param string $replacement
	 *
	 * @access private
	 * @since 1.4.0
	 * @uses _doing_it_wrong()
	 */
	function _wp_rest_menus_doing_it_wrong( $function, $route, $replacement ) {
		if (
			_wp_rest_menus_allow_legacy_menus() ||
			is_wp_version_compatible( '5.9' ) && _wp_rest_menus_allow_legacy_menus()
		) {
			return;
		}

		_doing_it_wrong(
			$function,
			sprintf(
			/* translators: 1: The REST API route namespace, 2: The plugin version. */
				__( 'The REST API Menu route %1$s is "deprecated". Please use WordPres cores menu route replacement found in WP >= 5.9: %2$s' ),
				sprintf('<code>%1$s%2$s</code>', WP_REST_Menus::get_plugin_namespace(), $route),
				'<code>' . $replacement . '</code>'
			),
			'1.4.0'
		);
	}
endif;

if ( ! function_exists( '_wp_rest_menus_allow_legacy_menus' ) ) :
	/**
	 * Allow legacy menus "filter".
	 *
	 * @return bool
	 * @since 1.4.0
	 * @access private
	 */
	function _wp_rest_menus_allow_legacy_menus() {
		/**
		 * Allow legacy menus.
		 *
		 * @param bool $allow_legacy_menus
		 *
		 * @return bool
		 */
		return apply_filters( 'rest_menus_allow_legacy_menus', false ) === true;
	}
endif;