內容簡介
在管理選單使用者頁面上擴展評論計數的資訊
設置頁面可設定標準功能
易於整合 (內含多個/側邊欄和儀表板小工具功能)
可以整合到”現在”方塊中，或顯示為控制台小工具和用戶個人資料頁面
高效能，因為使用者的評論計數在頁面請求中被重複使用
API供開發者使用
完全與https/SSL/TLS站點相容
充分支援多站點網路
乾淨的卸載
此外掛要求：使用者必須註冊並登錄以進行評論 - 因此，Featuring CountComments在允許匿名評論的網誌中將無法正常工作！
請在以下的版本中找到WordPress控制台：
3.3及以上版本 此處
3.2版本 此處
2.8至3.1版本 此處
2.8次要版本 此處
控制台的網站：https://www.bernhard-riedl.com/projects/
作者網站：https://www.bernhard-riedl.com/
注意！-Geek的東西前面! 😉
API
參數可以作為陣列或 URL 查詢類型的字符串 (例如："表示=0＆格式=0") 進行傳遞。請注意，WordPress將所有引數解析為字符串，因此，在查詢類型的字符串中使用布爾值必須是0或1，而在陣列中應使用真正的布爾值。
$featuring_countcomments->count_by_user($params=array())
計算當前已登錄的使用者或具有特定屬性的使用者發表的評論數。
$params：
user_attribute：使用者的屬性之一（符合query_type），例如user_id或WP_User物件; 如果未給出user_attribute，則將回退到當前正在使用的使用者
query_type：對應使用者屬性或WP_User物件的SQL字段；預設值為user_id
user_id
display_name
user_nicename
user_email
user_login
WP_User物件
format：如果設為true （預設值），則使用zero、one、more和thousands_separator屬性格式化輸出；false = 測試純數值的值
zero，one，more：用於格式化輸出-％c將被評論數替換
'zero' => '0則評論'
'one' => '1則評論'
'more' => '%c則評論'
外掛標籤
開發者團隊
原文外掛簡介
extends information on Users page in Admin Menu with comment counts
settings page configurable for standard functions
easy to integrate (ships with multi/sidebar- and dashboard-widget functionality)
possible to integrate in “Right Now” box or to display as widget on the dashboard and on the user’s profile page
high performance because users’ comment counts are re-used within a page-call
API for developers
fully compatible with https/SSL/TLS-sites
fully multisite network compatible
clean uninstall
Requirement for this plugin: Your users have to be registered and logged in to comment – Thus, Featuring CountComments will not work properly in weblogs where anonymous comments are allowed!
Please find the version for WordPress
3.3 and higher here
3.2 here
2.8 to 3.1 here
minor 2.8 here
Plugin’s website: https://www.bernhard-riedl.com/projects/
Author’s website: https://www.bernhard-riedl.com/
Attention! – Geeks’ stuff ahead! 😉
API
Parameters can either be passed as an array or a URL query type string (e.g. “display=0&format=0”). Please note that WordPress parses all arguments as strings, thus booleans have to be 0 or 1 if used in query type strings whereas for arrays real booleans should be used.
$featuring_countcomments->count_by_user($params=array())
Counts the number of comments made by a user who is currently logged in or has a particular attribute.
$params:
user_attribute: one of the user’s attributes (matching query_type), for example, the user_id or a WP_User object; if no user_attribute is given, will fallback to currently logged in user
query_type: corresponding SQL-field of user’s attribute or WP_User object; default is user_id
user_id
display_name
user_nicename
user_email
user_login
WP_User object
format: if set to true (default), the output will be formatted using the attributes zero, one, more and thousands_separator; false = process plain count value
zero, one, more: for formatted output – %c gets replaced with the number of comments
‘zero’ => ‘0 comments’
‘one’ => ‘1 comment’
‘more’ => ‘%c comments’
thousands_separator: divides counts by thousand delimiters; default , => e.g. 1,386
display: if you want to return the count (e.g. for storing it in a variable) instead of echoing it with this function-call, set display to false; default setting is true
The following example outputs the comment count of the user with the registered e-mail address ‘[email protected]’.
'user_email',
'user_attribute' => '[email protected]'
);
$featuring_countcomments->count_by_user($params);
?>
$featuring_countcomments->count_by_comment($params=array())
Counts the number of comments made by a user who wrote a certain comment or the current comment in the comment-loop.
$params:
comment: a comment object or comment id; if empty retrieves current comment
format: if set to true (default), the output will be formatted using the attributes zero, one, more and thousands_separator; false = process plain count value
zero, one, more: for formatted output – %c gets replaced with the number of comments
‘zero’ => ‘0 comments’
‘one’ => ‘1 comment’
‘more’ => ‘%c comments’
thousands_separator: divides counts by thousand delimiters default , => e.g. 1,386
display: if you want to return the count (e.g. for storing it in a variable) instead of echoing it with this function-call, set display to false; default setting is true
in_loop: if set to true (default), the query count for all user who wrote a comment which belongs to the post of the handed over comment will be cached; otherwise the comment count will be retrieved only for the user who posted the comment
The following example outputs the number of comments of the author with the current comment in the comment loop:
count_by_comment();
?>
Shortcodes
How-to for shortcodes
General Example:
Enter the following text anywhere in a post or page to output the comment count of user xyz:
[featuring_countcomments_count_by_user query_type="user_nicename" user_attribute="xyz"] by xyz so far...
Available Shortcode:
featuring_countcomments_count_by_user
Invokes $featuring_countcomments->count_by_user($params).
featuring_countcomments_count_by_comment
Invokes $featuring_countcomments->count_by_comment($params).
Filters
How-To for filters
General Example:
function my_featuring_countcomments_defaults($params=array()) {
$params['query_type'] = 'user_nicename';
return $params;
}
add_filter('featuring_countcomments_defaults', 'my_featuring_countcomments_defaults');
Available Filters:
featuring_countcomments_defaults
In case you want to set the default parameters globally rather than handing them over on every function call, you can add the filter featuring_countcomments_defaults in for example featuring-countcomments.php or your own customization plugin (recommended).
Please note that parameters which you hand over to a function call ($featuring_countcomments->count_by_user or $featuring_countcomments->count_by_comment) will always override the defaults parameters, even if they have been set by a filter or in the admin menu.
featuring_countcomments_dashboard_widget
Receives an array which is used for the dashboard-widget-function call to $featuring_countcomments->count_by_user. display and format will automatically be set to true and user_parameter to null to receive the current user’s count.
featuring_countcomments_dashboard_widget_text
Receives a string which is used in the dashboard-widget. %c will be replaced by the comment count of the user who is currently logged in.
featuring_countcomments_dashboard_right_now
Receives an array which is used for the dashboard-right-now-box-function call to $featuring_countcomments->count_by_user. display and format will automatically be set to true and user_parameter to null to retrieve the comment count of currently logged in user.
featuring_countcomments_dashboard_right_now_text
Receives a string which is used in the right-now box on the dashboard. %c will be replaced by the comment count of the user who is currently logged in.
featuring_countcomments_user_profile
Receives an array which is used for the user-profile-function call to $featuring_countcomments->count_by_user. display and format will automatically be set to true and user_parameter to null to retrieve the comment count of currently logged in user.
featuring_countcomments_user_profile_text
Receives a string which is used in the user’s profile page. %c will be replaced by the comment count of the user who is currently logged in.
featuring_countcomments_users_custom_column
Receives an array which is used for the users-page-function call to $featuring_countcomments->count_by_user. display and format will automatically be set to true and user_parameter to the user-id of each row to retrieve the user’s comment count.
