WordPress 如何從 admin 中的 users.php 搜索所有用户的 meta

問題描述

在管理區域 (wp-admin /users.php) 中列出的用户頂部的搜索表單受到限制，並且不搜索所有用户元字段，例如生物，即時消息手柄等。我還沒有找到一個可以添加的插件。

有人知道一個插件或一個可以創建的功能，可以擴展這個搜索在_usermeta 數據庫中的所有日期 – 理想情況下甚至由插件或函數創建的額外字段。

最佳解決方案

嗨 @ user2041：

很明顯，如你所知，您需要通過修改用於搜索的 WP_User_Search 類的實例中的值來修改執行的搜索 (您可以在/wp-admin/includes/user.php 找到源代碼，如果您想學習的話) 。

`WP_User_Search` 對象

以下是搜索「TEST」並且沒有任何其他可能影響到的插件時，該對象的 print_r()與 WordPress 3.0.3 類似。

WP_User_Search Object
(
  [results] =>
  [search_term] => TEST
  [page] => 1
  [role] =>
  [raw_page] =>
  [users_per_page] => 50
  [first_user] => 0
  [last_user] =>
  [query_limit] =>  LIMIT 0, 50
  [query_orderby] =>  ORDER BY user_login
  [query_from] =>  FROM wp_users
  [query_where] =>  WHERE 1=1 AND (user_login LIKE '%TEST%' OR user_nicename LIKE '%TEST%' OR user_email LIKE '%TEST%' OR user_url LIKE '%TEST%' OR display_name LIKE '%TEST%')
  [total_users_for_query] => 0
  [too_many_total_users] =>
  [search_errors] =>
  [paging_text] =>
)

`pre_user_search` 鈎

要修改 WP_User_Search 對象的值，您將使用接收當前對象實例的'pre_user_search'鈎子; 我從該鈎子中調用 print_r()來訪問上面顯示的值。

您可以將以下示例複製到主題的 functions.php 文件，或者您可以在 PHP 文件中使用您正在編寫的插件，除了可以在其他字段上搜索之外，還可以搜索用户描述。該功能修改了 $user_search 對象的 query_from 和 query_where 屬性，您需要使用 SQL 才能理解。

仔細修改鈎子中的 SQL

yoursite_pre_user_search()函數中的代碼假定沒有其他插件在它之前修改了 query_where 子句; 如果另一個插件已經修改了 where 子句，以便用"WHERE 1=1 AND ({$description_where} OR"替換'WHERE 1=1 AND ('不再工作，那麼這也將中斷。編寫一個強大的補丁比在這樣修改 SQL 時不能被其他插件所破壞的難得多，但它是什麼。

在鈎子插入 SQL 時添加主要和後跟空格

另請注意，如果在 WordPress 中使用這樣的 SQL，總是一個好主意，包括" INNER JOIN {$wpdb->usermeta} ON "的前導和尾隨空格，否則您的 SQL 查詢可能包含以下"INNER"之前沒有空格，這當然會失敗：" FROM wp_postsINNER JOIN {$wpdb->usermeta} ON "。

使用`"{$wpdb->table_name"}`而不是硬編碼表名稱

接下來一定要始終使用 $wpdb 屬性來引用表名，以防站點將表前綴從'wp_'更改為其他。因此，最好是參考"{$wpdb->users}.ID"(雙引號，而不是單引號)，而不是硬編碼"wp_users.ID"。

僅當搜索條件存在時才將查詢限制為

最後只能通過檢查 WP_User_Search 對象的 search_term 屬性來檢查可以測試的搜索項時修改查詢。

`'pre_user_search'`的 `yoursite_pre_user_search()`功能

add_action('pre_user_search','yoursite_pre_user_search');
function yoursite_pre_user_search($user_search) {
  global $wpdb;
  if (!is_null($user_search->search_term)) {
    $user_search->query_from .= " INNER JOIN {$wpdb->usermeta} ON " .
      "{$wpdb->users}.ID={$wpdb->usermeta}.user_id AND " .
      "{$wpdb->usermeta}.meta_key='description' ";
    $description_where = $wpdb->prepare("{$wpdb->usermeta}.meta_value LIKE '%s'",
      "%{$user_search->search_term}%");
    $user_search->query_where = str_replace('WHERE 1=1 AND (',
      "WHERE 1=1 AND ({$description_where} OR ",$user_search->query_where);
  }
}

搜索每個元 Key-Value 對需要一個 SQL `JOIN`

當然，WordPress 不允許您在 usermeta 字段上搜索的可能原因是每個人都向查詢添加了一個 SQL JOIN，並且具有太多連接的查詢可能會很慢。如果您真的需要搜索許多字段，那麼我將在 usermeta 中創建一個'_search_cache'字段，將所有其他信息收集到一個 usermeta 字段中，以便只需要一個聯接即可搜索。

Meta Keys 中的主要下劃線告訴 WordPress 不顯示

請注意，'_search_cache'的領先下劃線告訴 WordPress 這是一個內部值，而不是向用户顯示的東西。

使用`'profile_update'`和`'user_register'`鈎子創建搜索緩存

因此，您需要分別在保存用户和註冊新用户時觸發的'profile_update'和'user_register'。您可以抓住這些鈎子中的所有元鍵及其值 (但忽略具有串行化或 URL 編碼數組的值)，然後連接它們以使用'_search_cache'鍵存儲為一個長元值。

存儲元數據為`'|'`定界 Key-Value 對

我決定抓住所有的關鍵名字和所有的值，並將它們與冒號 (“:”) 連接成一個大字符串 (“:”)，將鍵與值和垂直條 (“|”) 分開，這樣分離 key-value 對 (我將它們包裝成多個行，所以你可以他們沒有滾動到右邊)：

nickname:mikeschinkel|first_name:mikeschinkel|description:This is my bio|
rich_editing:true|comment_shortcuts:false|admin_color:fresh|use_ssl:null|
wp_user_level:10|last_activity:2010-07-28 01:25:46|screen_layout_dashboard:2|
plugins_last_view:recent|screen_layout_post:2|screen_layout_page:2|
business_name:NewClarity LLC|business_description:WordPress Plugin Consulting|
phone:null|last_name:null|aim:null|yim:null|jabber:null|
people_lists_linkedin_url:null

使用 `key:value` 啓用 Meta 專業搜索

按照我們所提供的關鍵字和值可以讓您進行諸如「rich_editing:true」的搜索，以查找具有豐富編輯的所有人，或者搜索「phone:null」以找到沒有電話號碼的用户。

但請注意搜索人工製品

當然，使用這種技術可能會產生不必要的搜索工件，例如搜索”business”，並且每個人都將被列出。如果這是一個問題，那麼你可能不想使用這樣一個精心設計的緩存。

`'profile_update'`和`'user_register'`的 `yoursite_profile_update()`功能

對於函數 yoursite_profile_update()，如上面的 yoursite_pre_user_search()可以複製到您的主題的 functions.php 文件，或者您可以在 PHP 文件中使用您正在編寫的插件：

add_action('profile_update','yoursite_profile_update');
add_action('user_register','yoursite_profile_update');
function yoursite_profile_update($user_id) {
  $metavalues = get_user_metavalues(array($user_id));
  $skip_keys = array(
    'wp_user-settings-time',
    'nav_menu_recently_edited',
    'wp_dashboard_quick_press_last_post_id',
  );
  foreach($metavalues[$user_id] as $index => $meta) {
    if (preg_match('#^a:[0-9]+:{.*}$#ms',$meta->meta_value))
      unset($metavalues[$index]); // Remove any serialized arrays
    else if (preg_match_all('#[^=]+=[^&]&#',"{$meta->meta_value}&",$m)>0)
      unset($metavalues[$index]); // Remove any URL encoded arrays
    else if (in_array($meta->meta_key,$skip_keys))
      unset($metavalues[$index]); // Skip and uninteresting keys
    else if (empty($meta->meta_value)) // Allow searching for empty
      $metavalues[$index] = "{$meta->meta_key }:null";
    else if ($meta->meta_key!='_search_cache') // Allow searching for everything else
      $metavalues[$index] = "{$meta->meta_key }:{$meta->meta_value}";
  }
  $search_cache = implode('|',$metavalues);
  update_user_meta($user_id,'_search_cache',$search_cache);
}

更新了 `yoursite_pre_user_search()`功能，使單個 SQL `JOIN` 能夠搜索所有有趣的元值

當然，對於 yoursite_profile_update()有任何影響，您將需要修改 yoursite_pre_user_search()以使用'_search_cache'元鍵而不是描述，我們在這裏 (與上述相同的注意事項)：

add_action('pre_user_search','yoursite_pre_user_search');
function yoursite_pre_user_search($user_search) {
  global $wpdb;
  if (!is_null($user_search->search_term)) {
    $user_search->query_from .= " INNER JOIN {$wpdb->usermeta} ON " .
      "{$wpdb->users}.ID={$wpdb->usermeta}.user_id AND " .
      "{$wpdb->usermeta}.meta_key='_search_cache' ";
    $meta_where = $wpdb->prepare("{$wpdb->usermeta}.meta_value LIKE '%s'",
      "%{$user_search->search_term}%");
    $user_search->query_where = str_replace('WHERE 1=1 AND (',
      "WHERE 1=1 AND ({$meta_where} OR ",$user_search->query_where);
  }
}

次佳解決方案

我非常感謝 MikeSchinkel 的方法和上面的徹底解釋。這是 super-helpful 。我不能讓它為我工作，因為 pre_user_search 已被棄用，並沒有在 3.2 中實際工作。我試着用 pre_user_query 將其切換出去，但是也沒有。事情是，似乎 $ user_search-> search_term 不工作，所以我只是使用 $ _GET [‘s’] 。我做了一些黑客攻擊，並能在 3.2 中得到這個工作。您唯一需要設置的是可搜索元數據的數組。

//Searching Meta Data in Admin
add_action('pre_user_query','yoursite_pre_user_search');
function yoursite_pre_user_search($user_search) {
    global $wpdb;
    if (!isset($_GET['s'])) return;

    //Enter Your Meta Fields To Query
    $search_array = array("customer_id", "postal_code", "churchorganization_name", "first_name", "last_name");

    $user_search->query_from .= " INNER JOIN {$wpdb->usermeta} ON {$wpdb->users}.ID={$wpdb->usermeta}.user_id AND (";
    for($i=0;$i<count($search_array);$i++) {
        if ($i > 0) $user_search->query_from .= " OR ";
            $user_search->query_from .= "{$wpdb->usermeta}.meta_key='" . $search_array[$i] . "'";
        }
    $user_search->query_from .= ")";
    $custom_where = $wpdb->prepare("{$wpdb->usermeta}.meta_value LIKE '%s'", "%" . $_GET['s'] . "%");
    $user_search->query_where = str_replace('WHERE 1=1 AND (', "WHERE 1=1 AND ({$custom_where} OR ",$user_search->query_where);
}

希望這有助於某人。

參考文獻

How to search all user meta from users.php in the admin

注：本文內容整合自 Google/Baidu/Bing 輔助翻譯的英文資料結果。如果您對結果不滿意，可以加入我們改善翻譯效果：薇曉朵技術論壇。

WordPress 如何從 admin 中的 users.php 搜索所有用户的 meta