networks_pre_query

過濾鉤子
apply_filters_ref_array( 'networks_pre_query', array( $network_data, &$this )
引數
  • (array|int|null) $network_data Return an array of network data to short-circuit WP's network query, the network count as an integer if `$this->query_vars['count']` is set, or null to allow WP to run its normal queries.
    Required:
  • (WP_Network_Query) $query The WP_Network_Query instance, passed by reference.
    Required:
定義位置
相關勾子
terms_pre_queryfound_networks_querysites_pre_querynetwork_home_urlnetwork_site_url
相關方法
network_home_urlnetwork_site_urlwp_reset_querynetwork_admin_urlget_search_querynetwork_step2
引入
5.6.0
棄用
-

networks_pre_query。這個動作鉤子在執行WordPress多站點網路查詢之前被呼叫。你可以用這個鉤子來修改網路查詢的引數。

在查詢發生之前過濾網路資料。

返回非空值以繞過WordPress的預設網路查詢。

此篩選器的預期返回型別取決於請求查詢vars中傳遞的值:

  • When $this->query_vars['count'] is set, the filter should return the network count as an integer.
  • When 'ids' === $this->query_vars['fields'], the filter should return an array of network IDs.
  • Otherwise the filter should return an array of WP_Network objects.

請注意,如果過濾器返回網路資料陣列,它將被分配給當前WP_Network_Query例項的networks屬性。

鼓勵需要分頁資訊的過濾函式設定WP_Network_Query物件的found_networksmax_num_pages財產,這些屬性通過引用傳遞給過濾器。如果WP_Network_Query不執行資料庫查詢,它將沒有足夠的資訊自行生成這些值。

Plain text
Copy to clipboard
Open code in new window
EnlighterJS 3 Syntax Highlighter
$network_data = apply_filters_ref_array( 'networks_pre_query', array( $network_data, &$this ) );
$network_data = apply_filters_ref_array( 'networks_pre_query', array( $network_data, &$this ) );
$network_data = apply_filters_ref_array( 'networks_pre_query', array( $network_data, &$this ) );

常見問題

FAQs
檢視更多 >