WordPress/wp-admin/includes/ms-deprecated.php
desrosj 7d87ce12c8 Networks and Sites: Officially remove global terms.
Global terms was a feature from the WordPress MU days where multisite and single site installs used different code bases.

In WordPress 3.0, WordPress MU was merged into one location and the UI [14854] and “on” switch [14880] for global terms were completely removed.

Even before this merge, global terms was bug infested and unreliable. After [14854]/[14880], the feature was no longer maintained and became increasingly broken as taxonomies progressed without it (term splitting and term meta do not work at all). At this point, the feature has not worked in 12+ years and there’s no hope for saving it.

This deprecates the remaining global terms related code and no-ops the functions.

Global terms, you don’t have to go home, but you can’t stay here.

Props scribu, wonderboymusic, SergeyBiryukov, nacin, pento, desrosj, johnjamesjacoby, johnbillion, dd32.
Fixes #21734.
Built from https://develop.svn.wordpress.org/trunk@54240


git-svn-id: http://core.svn.wordpress.org/trunk@53799 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2022-09-20 02:51:09 +00:00

141 lines
3.7 KiB
PHP

<?php
/**
* Multisite: Deprecated admin functions from past versions and WordPress MU
*
* These functions should not be used and will be removed in a later version.
* It is suggested to use for the alternatives instead when available.
*
* @package WordPress
* @subpackage Deprecated
* @since 3.0.0
*/
/**
* Outputs the WPMU menu.
*
* @deprecated 3.0.0
*/
function wpmu_menu() {
_deprecated_function( __FUNCTION__, '3.0.0' );
// Deprecated. See #11763.
}
/**
* Determines if the available space defined by the admin has been exceeded by the user.
*
* @deprecated 3.0.0 Use is_upload_space_available()
* @see is_upload_space_available()
*/
function wpmu_checkAvailableSpace() {
_deprecated_function( __FUNCTION__, '3.0.0', 'is_upload_space_available()' );
if ( ! is_upload_space_available() ) {
wp_die( sprintf(
/* translators: %s: Allowed space allocation. */
__( 'Sorry, you have used your space allocation of %s. Please delete some files to upload more files.' ),
size_format( get_space_allowed() * MB_IN_BYTES )
) );
}
}
/**
* WPMU options.
*
* @deprecated 3.0.0
*/
function mu_options( $options ) {
_deprecated_function( __FUNCTION__, '3.0.0' );
return $options;
}
/**
* Deprecated functionality for activating a network-only plugin.
*
* @deprecated 3.0.0 Use activate_plugin()
* @see activate_plugin()
*/
function activate_sitewide_plugin() {
_deprecated_function( __FUNCTION__, '3.0.0', 'activate_plugin()' );
return false;
}
/**
* Deprecated functionality for deactivating a network-only plugin.
*
* @deprecated 3.0.0 Use deactivate_plugin()
* @see deactivate_plugin()
*/
function deactivate_sitewide_plugin( $plugin = false ) {
_deprecated_function( __FUNCTION__, '3.0.0', 'deactivate_plugin()' );
}
/**
* Deprecated functionality for determining if the current plugin is network-only.
*
* @deprecated 3.0.0 Use is_network_only_plugin()
* @see is_network_only_plugin()
*/
function is_wpmu_sitewide_plugin( $file ) {
_deprecated_function( __FUNCTION__, '3.0.0', 'is_network_only_plugin()' );
return is_network_only_plugin( $file );
}
/**
* Deprecated functionality for getting themes network-enabled themes.
*
* @deprecated 3.4.0 Use WP_Theme::get_allowed_on_network()
* @see WP_Theme::get_allowed_on_network()
*/
function get_site_allowed_themes() {
_deprecated_function( __FUNCTION__, '3.4.0', 'WP_Theme::get_allowed_on_network()' );
return array_map( 'intval', WP_Theme::get_allowed_on_network() );
}
/**
* Deprecated functionality for getting themes allowed on a specific site.
*
* @deprecated 3.4.0 Use WP_Theme::get_allowed_on_site()
* @see WP_Theme::get_allowed_on_site()
*/
function wpmu_get_blog_allowedthemes( $blog_id = 0 ) {
_deprecated_function( __FUNCTION__, '3.4.0', 'WP_Theme::get_allowed_on_site()' );
return array_map( 'intval', WP_Theme::get_allowed_on_site( $blog_id ) );
}
/**
* Deprecated functionality for determining whether a file is deprecated.
*
* @deprecated 3.5.0
*/
function ms_deprecated_blogs_file() {}
if ( ! function_exists( 'install_global_terms' ) ) :
/**
* Install global terms.
*
* @since 3.0.0
* @since 6.1.0 This function no longer does anything.
* @deprecated 6.1.0
*/
function install_global_terms() {
_deprecated_function( __FUNCTION__, '6.1.0' );
}
endif;
/**
* Synchronizes category and post tag slugs when global terms are enabled.
*
* @since 3.0.0
* @since 6.1.0 This function no longer does anything.
* @deprecated 6.1.0
*
* @param WP_Term|array $term The term.
* @param string $taxonomy The taxonomy for `$term`.
* @return WP_Term|array Always returns `$term`.
*/
function sync_category_tag_slugs( $term, $taxonomy ) {
_deprecated_function( __FUNCTION__, '6.1.0' );
return $term;
}