前言介紹
- 這款 WordPress 外掛「Plugin Cards」是 2015-05-10 上架。
- 目前有 10 個安裝啟用數。
- 上一次更新是 2015-12-07，距離現在已有 3733 天。超過一年沒更新，安裝要確認版本是否可用。以及後續維護問題！
- 外掛最低要求 WordPress 4.0 以上版本才可以安裝。
- 有 8 人給過評分。
- 還沒有人在論壇上發問，可能目前使用數不多，還沒有什麼大問題。
外掛協作開發者
braad |
外掛標籤
card | repo | cards | search |
內容簡介
外掛 Cards 讓您能夠顯示 WordPress 4.0 風格的卡片，顯示存放於 wordpress.org 儲存庫中的任何外掛相關資訊。這個外掛可以使用所有可以透過 wordpress.org API 西當的自訂查詢，包括：
外掛 Slug
作者
標籤
搜尋關鍵字
瀏覽條件：熱門、最新和測試版
wordpress.org 使用者的最愛清單
透過一個包含篩選器的自訂查詢
此外掛使用與 wp-admin 相同的 wordpress.org API 當您搜尋新外掛時，並盡可能使用管理員 CSS 和核心功能，提供一個特別的庫存體驗。
同時，此外掛包含多數篩選器，您可以進行個性化設定。您可以使用自訂查詢，包含預設未顯示的自訂欄位，使用自訂圖示、自訂外掛 URL，在每個輸出區段中添加或覆蓋顯示信息，用自己的內容代替整個輸出，以及更多其他功能。
此外掛可在Github 上取得，作者也鼓勵使用者提出功能需求和拉取請求。
功能
透過透過 wordpress.org API 支援的所有查詢方式查詢 wordpress.org 外掛庫，包括透過 Slug、作者、標籤、熱門、最新測試版、使用者最愛和搜尋關鍵字查詢
卡片與 WordPress 4.0 官方設計相符
使用 wordpress.org API 取得外掛相關資訊
快取結果，以最小化 API 的負擔
預設包括外掛名稱、圖示、說明、作者連結、星等評分、啟用安裝數量、最後更新時間和相容版本號
優先使用 SVG 外掛圖示，接著是 retina 圖示，最後是常規圖示
使用 WP本機 Dashicons 作為星等評分
能智能響應
可透過 CSS 輕鬆調整卡片外觀
使用提供的篩選器輕鬆調整整個外掛的功能
透過 Plugin Cards，您可以輕鬆地顯示任何用途的自訂外掛列表。
使用方法
此外掛新增了一個短碼 [plugin_cards]，您可以在網站上任何地方使用它來顯示外掛卡片。
以下參數可用於建立查詢：
[plugin_cards slug="easy-digital-downloads"]
[plugin_cards author="markjaquith"]
[plugin_cards user="matt"] // 顯示使用者最愛清單
[plugin_cards tag="slider"]
[plugin_cards browse="popular"]
[plugin_cards browse="new"]
[plugin_cards browse="beta"]
[plugin_cards search="gallery"]
注意：Wordpress.org API 只支援一次查詢一個參數，因此目前短碼中只能包含一個參數來建立查詢。如果這種情況發生了改變，我將為此插件添加支援多個參數進行查詢的功能。
注意：必須使用參數才能啟用此短碼。僅使用 [plugin_cards] 將導致默認失敗。
您還可以使用 max_results 參數來設置最大結果數，例如：
[plugin_cards max_results="10" browse="popular"]
進階使用方法
此外掛包含多個篩選器，您可以使用它們自訂卡片外觀並增加外掛資訊。如果您真的要了解如何使用篩選器，我建議您閱讀代碼。以下是一些範例：
使用自訂查詢
function custom_plugin_cards_query( $custom_query_args, $attr )
{
$custom_query_args['browse'] = 'popular';
$custom_query_args['tag'] = 'slider';
return $custom_query_args;
}
add_filter( 'plugin_cards_query_args', 'custom_plugin_cards_query', 10, 2 );
等等。
原文外掛簡介
Plugin Cards lets you display WordPress 4.0 style cards with plugin information for any plugin that lives on the wordpress.org repository. All of the custom queries that are possible using the wordpress.org API are possible with this plugin, including queries for plugins by:
Slug
Author
Tag
Search term
Brose terms: popular, new, & beta
A wordpress.org user’s favorites list
Any other custom query you pass in via an included filter
This plugin uses the same wordpress.org API that your wp-admin uses when you are searching for new plugins, and it uses as much of the admin CSS and core functionality as possible to bring you a purposefully stock experience.
I have also included a number of filters in the plugin that allow you to customize everything. You can use a custom query, include custom fields not shown by default, use custom icons, use custom plugin urls, add to or override the information shown in each section of the output, override the entire output with your own, and more.
This plugin is on Github and I encourage feature requests and pull requests.
Features
Query the wordpress.org plugin repo by all methods supported by the wordpress.org API, including by slug, author, tag, popular, new, beta, user’s favorites, and search term
Cards match the design introduced in WordPress 4.0
Uses the wordpress.org API to get plugin information
Caches results to minimize hits on the API
Default fields include plugin name, icon, description, author link, star rating, active install count, last updated and compatible up to
Uses SVG plugin icon if available, then retina icon if available, then regular icon
Uses the WP native Dashicons for the star ratings
Intelligently Responsive
Easily customize the look of the cards with CSS
Easily customize the functionality of the entire plugin with provided filters
With Plugin Cards you can easily display a custom list of plugins for any purpose.
Usage
This plugin adds a shortcode [plugin_cards] that you can use to display the plugin cards anywhere on your site.
The following parameters can be used to create your query:
[plugin_cards slug="easy-digital-downloads"]
[plugin_cards author="markjaquith"]
[plugin_cards user="matt"] // Displays user's favorites list
[plugin_cards tag="slider"]
[plugin_cards browse="popular"]
[plugin_cards browse="new"]
[plugin_cards browse="beta"]
[plugin_cards search="gallery"]
Note: The wordpress.org API only supports querying by one parameter at a time, so currently only one parameter can be included in the shortcode to build the query. If this ever changes I will add support for querying by multiple parameters to this plugin.
Note: The parameter is required for the shortcode to work. Simply using [plugin_cards] will result in a silent fail.
You can also set the max number of results using the max_results parameter like this:
[plugin_cards max_results="10" browse="popular"]
Advanced Usage
This plugin includes a number of filters that you can use to customize the display of the cards and add plugin information to the cards. I recommend reading through the code if you really want to understand how the filters can be used. Here are some examples:
Use a custom query
function custom_plugin_cards_query( $custom_query_args, $atts = array(), $fields = array() ) {
// Show the 10 most popular plugins with only certain fields returned
$custom_query_args = array(
'per_page' => 10,
'browse' => 'popular',
'fields' => array(
'banners' => true,
'icons' => false,
'reviews' => true,
'rating' => true,
'num_ratings' => true,
'downloaded' => false,
'active_installs' => false,
'short_description' => false,
'sections' => true,
'downloadlink' => true,
'last_updated' => true,
'homepage' => true,
)
);
return $custom_query_args;
}
add_filter( 'plugin_cards_api_query_args', 'custom_plugin_cards_query', 10, 3 );
Then you’d have to use one of the output filters and some CSS to get the new fields to show on the page. There is a lot that is possible with the plugin_cards_api_query_args filter, too much to cover here, but the key is setting the right main query param and setting the fields that you want returned.
Use custom URLs
function custom_plugin_card_urls( $plugin_url, $plugin = null ) {
// Point URLs to a custom endpoint based on the plugin slug
$plugin_url = 'https://domain.com/custom-plugins/' . esc_attr( $plugin->slug );
// Change the URL of a specific plugin
if ( 'woocommerce' === $plugin->slug ) {
$plugin_url = 'http://www.woothemes.com/woocommerce/';
}
return $plugin_url;
}
add_filter( 'plugin_cards_plugin_url', 'custom_plugin_card_urls', 10, 2 );
The complete list of simple filters that work exactly like plugin_cards_plugin_urls is:
plugin_cards_plugin_url
plugin_cards_plugin_name
plugin_cards_short_description
plugin_cards_plugin_author
There are also some advanced filters that allow you to override the HTML output of entire sections, including:
plugin_cards_plugin_icon
plugin_cards_action_links
plugin_cards_plugin_rating
plugin_cards_last_updated
plugin_cards_install_count
plugin_cards_plugin_compatibility
These filters can be used like this:
Use custom plugin icons
function custom_plugin_card_icons( $plugin_icon, $plugin = null, $plugin_url = '' ) {
// Replace all plugin icons with kittens
$plugin_icon = '
';
// Replace the icon for a specific plugin
if ( 'equal-height-columns' === $plugin->slug ) {
$plugin_icon = '
';
}
return $plugin_icon;
}
add_filter( 'plugin_cards_plugin_icon', 'custom_plugin_card_icons', 10, 3 );
There is also one special filter plugin_cards_cache_expiration that allows you to set how long you want the results of the API request to be cached. The default is 2 hours (expressed as number of seconds).
If you want a hook added just let me know. Pull requests are welcome on Github.
各版本下載點
- 方法一：點下方版本號的連結下載 ZIP 檔案後，登入網站後台左側選單「外掛」的「安裝外掛」，然後選擇上方的「上傳外掛」，把下載回去的 ZIP 外掛打包檔案上傳上去安裝與啟用。
- 方法二：透過「安裝外掛」的畫面右方搜尋功能，搜尋外掛名稱「Plugin Cards」來進行安裝。
（建議使用方法二，確保安裝的版本符合當前運作的 WordPress 環境。
1.0.0 | 1.1.0 | 1.2.0 | 1.2.1 | 1.2.2 | trunk |
延伸相關外掛（你可能也想知道）
GitHub Repository Shortcode 》如果您是使用 GitHub 的程式設計師，為什麼不透過您的 WordPress 博客分享您的編程項目，方法是在任何頁面或帖子上使用短碼添加儲存庫的快照。, 只需安裝這個...。
Repo Widget 》使用 WordPress 短代碼將 GitHub 存儲庫嵌入您的博客中。嵌入的存儲庫將顯示有關存儲庫的最新信息：, , 存儲庫標題, 克隆 URL（HTTP、SSH、GIT）, 存儲庫描述...。
Card For GitHub 》在 WordPress 中添加GitHub仓库卡片的外掛程式。, 功能, , 支援使用簡碼來顯示卡片, 支援小工具(widget), 提供呼叫函式, , 使用方式, 1. 簡碼, [ghCard owner...。
Block Repo Plugin Updates 》🔒 封鎖任何外掛資料夾看起來像是程式碼存儲庫（目前僅有 Git 和 Subversion）的更新。（基於 Block Specific Plugin Updates）, 🛠 此外掛程式僅適用於開發者...。