WP Options Importer

常見問題集

為網站匯入 [預設選項] 後，某些外掛的設定無法移轉，應該如何處理？

[預設選項] 是核心程式選項，或這個外掛認為可以安全匯入的選項。使用者可以選取 [指定選項]，便能依據需求手動匯入需要匯入的選項。

我是外掛開發者，你能將我的外掛的設定加入預設選項清單中嗎？

我不能這麼做，但是你可以自己完成。這個外掛為開發者提供 options_import_allowlist 篩選器，讓開發者可以將選項加入這個外掛的預設選項清單中。以下為範例程式碼：

function my_awesome_plugin_options( $options ) {
    $options[] = 'my_awesome_plugin';
    return $options;
}
add_filter( 'options_import_allowlist', 'my_awesome_plugin_options' );

同理可證，如果不想讓使用者匯入某個選項，開發者可以使用 options_import_denylist 篩選器將選項加入封鎖清單中。以下為範例程式碼：

function my_awesome_plugin_denylist_options( $options ) {
    $options[] = 'my_awesome_plugin_edit_lock';
    return $options;
}
add_filter( 'options_import_denylist', 'my_awesome_plugin_denylist_options' );

我營運一個 WordPress 多站網路，有些選項「永遠」不該由子網站的網站管理員匯出或匯入，該如何達到這個目的？

無論是匯出或匯入，多站網路管理員都有兩個限制做法。

匯入

首先，多站網路管理員可以使用 options_import_denylist 篩選器將任何選項納入陣列中 (預設陣列值為空)。如果多站網路的使用者可以存取佈景主題或外掛的程式碼，因為他們可以使用相同的篩選器覆寫多站網路管理員的封鎖清單，因此無法保證百分之百安全。在這類狀況中，可以使用緊急開關停用匯入選項。要使用這項功能，請定義 WP_OPTION_IMPORT_DENYLIST_REGEX 常數 (多站網路管理員可能會想使用於強制使用外掛)，並為其設定規則運算式，而符合該運算式的項目均會略過。以下為範例程式碼：

define( 'WP_OPTION_IMPORT_DENYLIST_REGEX', '/^(home|siteurl)$/' );

匯出

與匯入幾乎相同，對應的篩選器為 options_export_denylist，而其常數為 WP_OPTION_EXPORT_DENYLIST_REGEX。