萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> CMS 教學

WordPress 判斷插件是否啟用的標準代碼片段(is_plugin_active)

核心函數

WordPress 提供 is_plugin_active( $plugin_basename ) 函數檢測插件啟用狀態,需引入 wp-admin/includes/plugin.php。

完整代碼示例

<?php
// 必須引入,否則函數未定義
include_once( ABSPATH . 'wp-admin/includes/plugin.php' );

// 插件基礎路徑格式:插件目錄名/主文件名.php
$plugin_basename = 'plugin-directory/plugin-file.php'; // 修改為目標插件

if ( is_plugin_active( $plugin_basename ) ) {
    // 插件已啟用:執行依賴該插件的邏輯
    echo '插件已啟用,可以安全調用其功能。';
} else {
    // 插件未啟用:降級處理或提示用戶
    echo '請先啟用「目標插件」以使用此功能。';
}
?>

關鍵點

  • $plugin_basename 不是插件名稱,而是 相對 wp-content/plugins/ 的路徑。
    例:WooCommerce 主文件為 woocommerce/woocommerce.php,則參數為 'woocommerce/woocommerce.php'。
  • 僅在前台主題模板、插件文件、functions.php 中使用;在 wp-admin/ 後台文件中可直接調用無需 include。
  • 若在 functions.php 中過早調用(如 plugins_loaded 之前),可能檢測不到,建議掛載到 init 或更晚的 Hook。

進階:獲取所有已啟用插件列表

<?php
include_once( ABSPATH . 'wp-admin/includes/plugin.php' );
$active_plugins = get_option( 'active_plugins' ); // 返回插件 basename 數組
foreach ( $active_plugins as $plugin ) {
    echo $plugin . '<br>';
}
?>

應用場景

  • 主題集成特定插件功能(如 WooCommerce、Contact Form 7),優雅降級。
  • 插件之間的依賴檢查。
  • 後台設置頁根據插件啟用狀態顯示/隱藏選項。
copyright © 萬盛學電腦網 all rights reserved