函数文档

maybe_disable_link_manager()

💡 云策文档标注

概述

maybe_disable_link_manager() 是一个 WordPress 函数,用于在升级时根据数据库链接状态自动禁用 Link Manager。它检查数据库版本和链接存在性,若无链接则更新选项以禁用管理器。

关键要点

  • 函数在 WordPress 升级过程中执行,条件包括数据库版本 >= 22006、Link Manager 已启用且数据库中无链接记录。
  • 通过 update_option() 将 'link_manager_enabled' 选项设置为 0 来禁用 Link Manager。
  • 依赖 get_option() 和 wpdb::get_var() 来检查当前状态和数据库查询。

代码示例

function maybe_disable_link_manager() {
    global $wp_current_db_version, $wpdb;

    if ( $wp_current_db_version >= 22006 && get_option( 'link_manager_enabled' ) && ! $wpdb->get_var( "SELECT link_id FROM $wpdb->links LIMIT 1" ) ) {
        update_option( 'link_manager_enabled', 0 );
    }
}

注意事项

  • 此函数自 WordPress 3.5.0 版本引入,主要用于升级时的自动化处理。
  • 仅在满足所有条件时才会执行禁用操作,确保不会误禁用有链接的站点。

📄 原文内容

Disables the Link Manager on upgrade if, at the time of upgrade, no links exist in the DB.

Source

function maybe_disable_link_manager() {
	global $wp_current_db_version, $wpdb;

	if ( $wp_current_db_version >= 22006 && get_option( 'link_manager_enabled' ) && ! $wpdb->get_var( "SELECT link_id FROM $wpdb->links LIMIT 1" ) ) {
		update_option( 'link_manager_enabled', 0 );
	}
}

Changelog

Version Description
3.5.0 Introduced.