wpavatar/includes/wpcy-compatibility.php

<?php
/**
 * WPAvatar 兼容性修复
 *
 * 用于处理与其他插件的兼容性问题
 */

namespace WPAvatar;

class Compatibility {
	/**
	 * 初始化兼容性修复
	 */
	public static function init() {
		// 在所有插件加载后、主题初始化前运行
		add_action( 'after_setup_theme', array( __CLASS__, 'handle_wp_china_yes_compatibility' ), 5 );

		// 处理与 Marketing 和 Shortcode 类之间的兼容性
		add_action( 'init', array( __CLASS__, 'handle_shortcode_compatibility' ), 1 );
	}

	/**
	 * 处理与 WP-China-Yes 插件的兼容性
	 */
	public static function handle_wp_china_yes_compatibility() {
		// 检查 WP-China-Yes 插件是否激活
		if ( self::is_wp_china_yes_active() ) {
			// 移除 WP-China-Yes 的头像替换过滤器
			self::remove_wp_china_yes_filters();

			// 重新初始化 WPAvatar 的 Cravatar 功能，使用更高的优先级
			self::reinitialize_wpavatar_filters();

			// 可选：添加管理界面通知
			if ( is_admin() ) {
				add_action( 'admin_notices', array( __CLASS__, 'admin_compatibility_notice' ) );
			}
		}
	}

	/**
	 * 处理 Marketing 和 Shortcode 类之间的简码兼容性
	 */
	public static function handle_shortcode_compatibility() {
		// 确保只处理一次
		static $done = false;
		if ( $done ) {
			return;
		}
		$done = true;

		// 移除 Marketing 类中可能与 Shortcode 类冲突的简码定义
		remove_shortcode( 'wpavatar' );
		remove_shortcode( 'wpavatar_username' );
		remove_filter( 'walker_nav_menu_start_el', array( '\WPAvatar\Marketing', 'menu_item_replace' ), 10 );

		// 重新添加 Shortcode 类的简码
		add_shortcode( 'wpavatar', array( '\WPAvatar\Shortcode', 'render_avatar' ) );
		add_shortcode( 'wpavatar_username', array( '\WPAvatar\Shortcode', 'render_username' ) );
		add_filter( 'walker_nav_menu_start_el', array( '\WPAvatar\Shortcode', 'menu_item_replace' ), 10, 4 );
	}

	/**
	 * 检查 WP-China-Yes 插件是否激活
	 */
	private static function is_wp_china_yes_active() {
		return class_exists( 'WenPai\\ChinaYes\\Service\\Super' ) ||
				defined( 'CHINA_YES_VERSION' ) ||
				function_exists( 'WenPai\\ChinaYes\\get_settings' );
	}

	/**
	 * 移除 WP-China-Yes 的头像替换过滤器
	 */
	private static function remove_wp_china_yes_filters() {
		// 找到可能的 Super 类实例
		global $wp_filter;

		$filters_to_check = array(
			'get_avatar_url',
			'um_user_avatar_url_filter',
			'bp_gravatar_url',
			'user_profile_picture_description',
			'avatar_defaults',
		);

		foreach ( $filters_to_check as $filter_name ) {
			if ( isset( $wp_filter[ $filter_name ] ) ) {
				foreach ( $wp_filter[ $filter_name ]->callbacks as $priority => $callbacks ) {
					foreach ( $callbacks as $callback_key => $callback_data ) {
						if ( is_array( $callback_data['function'] ) &&
							is_object( $callback_data['function'][0] ) &&
							get_class( $callback_data['function'][0] ) === 'WenPai\\ChinaYes\\Service\\Super' ) {

							$method_name = $callback_data['function'][1];
							remove_filter( $filter_name, array( $callback_data['function'][0], $method_name ), $priority );
						}
					}
				}
			}
		}
	}

	/**
	 * 重新初始化 WPAvatar 的 Cravatar 过滤器，使用更高的优先级
	 */
	private static function reinitialize_wpavatar_filters() {
		if ( wpavatar_get_option( 'wpavatar_enable_cravatar', true ) ) {
			// 使用高优先级再次添加过滤器
			add_filter( 'um_user_avatar_url_filter', array( '\WPAvatar\Cravatar', 'replace_avatar_url' ), 9999 );
			add_filter( 'bp_gravatar_url', array( '\WPAvatar\Cravatar', 'replace_avatar_url' ), 9999 );
			add_filter( 'user_profile_picture_description', array( '\WPAvatar\Cravatar', 'modify_profile_picture_description' ), 9999 );

			// 确保 get_avatar_url 过滤器的优先级高于其他插件
			remove_filter( 'get_avatar_url', array( '\WPAvatar\Cravatar', 'get_avatar_url' ), 999 );
			add_filter( 'get_avatar_url', array( '\WPAvatar\Cravatar', 'get_avatar_url' ), 9999, 2 );
		}
	}

	/**
	 * 管理界面兼容性通知
	 */
	public static function admin_compatibility_notice() {
		$screen = get_current_screen();
		if ( $screen && $screen->id === 'settings_page_wpavatar-settings' ) {
			echo '<div class="notice notice-info is-dismissible">';
			echo '<p>检测到文派叶子 🍃（WPCY.COM）插件，WPAvatar 生态组件兼容补丁已生效，确保文派头像设置优先。</p>';
			echo '</div>';
		}
	}
}