W3cubDocs

/WordPress

do_block_editor_incompatible_meta_box( mixed $object, array $box )

Function that renders a “fake” meta box with an information message, shown on the block editor, when an incompatible meta box is found.

Parameters

$object

(mixed) (Required) The data object being rendered on this screen.

$box

(array) (Required) Custom formats meta box arguments.

  • 'id'
    (string) Meta box 'id' attribute.
  • 'title'
    (string) Meta box title.
  • 'old_callback'
    (callable) The original callback for this meta box.
  • 'args'
    (array) Extra meta box arguments.

Source

File: wp-admin/includes/template.php 

function do_block_editor_incompatible_meta_box( $object, $box ) {
	$plugin  = _get_plugin_from_callback( $box['old_callback'] );
	$plugins = get_plugins();
	echo '<p>';
	if ( $plugin ) {
		/* translators: %s: The name of the plugin that generated this meta box. */
		printf( __( "This meta box, from the %s plugin, isn't compatible with the block editor." ), "<strong>{$plugin['Name']}</strong>" );
	} else {
		_e( "This meta box isn't compatible with the block editor." );
	}
	echo '</p>';

	if ( empty( $plugins['classic-editor/classic-editor.php'] ) ) {
		if ( current_user_can( 'install_plugins' ) ) {
			echo '<p>';
			printf(
				/* translators: %s: A link to install the Classic Editor plugin. */
				__( 'Please install the <a href="%s">Classic Editor plugin</a> to use this meta box.' ),
				esc_url( wp_nonce_url( self_admin_url( 'plugin-install.php?tab=favorites&user=wordpressdotorg&save=0' ), 'save_wporg_username_' . get_current_user_id() ) )
			);
			echo '</p>';
		}
	} elseif ( is_plugin_inactive( 'classic-editor/classic-editor.php' ) ) {
		if ( current_user_can( 'activate_plugins' ) ) {
			$activate_url = wp_nonce_url( self_admin_url( 'plugins.php?action=activate&plugin=classic-editor/classic-editor.php' ), 'activate-plugin_classic-editor/classic-editor.php' );
			echo '<p>';
			/* translators: %s: A link to activate the Classic Editor plugin. */
			printf( __( 'Please activate the <a href="%s">Classic Editor plugin</a> to use this meta box.' ), esc_url( $activate_url ) );
			echo '</p>';
		}
	} elseif ( $object instanceof WP_Post ) {
		$edit_url = add_query_arg(
			array(
				'classic-editor'         => '',
				'classic-editor__forget' => '',
			),
			get_edit_post_link( $object )
		);
		echo '<p>';
		/* translators: %s: A link to use the Classic Editor plugin. */
		printf( __( 'Please open the <a href="%s">classic editor</a> to use this meta box.' ), esc_url( $edit_url ) );
		echo '</p>';
	}
}

Uses

Uses Description
wp-admin/includes/template.php: _get_plugin_from_callback()

Internal helper function to find the plugin from a meta box callback.
wp-admin/includes/plugin.php: is_plugin_inactive()

Determines whether the plugin is inactive.
wp-admin/includes/plugin.php: get_plugins()

Check the plugins directory and retrieve all plugin files with plugin data.
wp-includes/capabilities.php: current_user_can()

Returns whether the current user has the specified capability.
wp-includes/l10n.php: __()

Retrieve the translation of $text.
wp-includes/l10n.php: _e()

Display translated text.
wp-includes/formatting.php: esc_url()

Checks and cleans a URL.
wp-includes/functions.php: wp_nonce_url()

Retrieve URL with nonce added to URL query.
wp-includes/functions.php: add_query_arg()

Retrieves a modified URL query string.
wp-includes/link-template.php: self_admin_url()

Retrieves the URL to the admin area for either the current site or the network depending on context.
wp-includes/link-template.php: get_edit_post_link()

Retrieves the edit post link for post.
wp-includes/user.php: get_current_user_id()

Get the current user’s ID

Changelog

Version Description
5.0.0 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/do_block_editor_incompatible_meta_box