這個外掛並未在最新的 3 個 WordPress 主要版本上進行測試。開發者可能不再對這個外掛進行維護或提供技術支援,並可能會與更新版本的 WordPress 產生使用上的相容性問題。

References

外掛說明

This plugin will let you manage the post references. It is like “node reference” in Drupal CMS module functionality.

Use Reference Settings page to configure publications connections.

After configuring step you will see additional metabox(s) on post editor page. Now you can choose articles of referenced post types to attach it to article you edit.

Plugin stores connected article list to post metas. For template you can use, for example, get_post_meta($post->ID, ‘_ref_ID’, true) to receive that list. As ‘ref_ID’ you should use a meta key configured on Referenced settings page earlier.

Plugin allow you to configure widgets to view the list(s) of attached articles.

Plugin API

Plugin has own API which allows you create references from your code (after registering your own post types, etc). All functions are static and available through class REFShraAPI.

Currently there are implemented 5 functions. List of functions is below. More details about API functions, their arguments, examples look in referenece.php.

REFShraAPI::config_load($postType = NULL, $refKey = NULL);
//returns array currently configured REFERENCES.

REFShraAPI::config_add($postType, $refKey, $linkedTypes, $title)
// ADD/update REFERENCE configs.

REFShraAPI::config_remove($postType, $refKey);
// Delete REFERENCE config by pair postType / refKey.

REFShraAPI::get($postID = NULL);
// Get references data by post ID.

REFShraAPI::update($postID = NULL, $refkey, $postIDs);
// Update references data by post ID.

REFShraAPI::find($postID = NULL, $postTypes = array(), $onlyPublished = false);
// Search for article with attached post_id

Shortcode REF

Plugin supports shortcode REF. It allows to show list of referenced articles in any place of your post. Shortcode function implementation allows you customize list and output. Only two attributes are available.

[ref id=”POST_ID” key=”REFERENCE_KEY”]

螢幕擷圖

  • Install References plugin.
  • The References settings page.
  • Build article connections.
  • Configure widget(s).
  • Created widget view.
  • Using REF shortcode in post editor.
  • REF shortcode rendered on frontend.

安裝方式

Best is to install directly from WordPress. If manual installation is required, please make sure that the plugin files are in a folder named “references”, usually “wp-content/plugins”.

使用者評論

閱讀全部 1 則使用者評論

參與者及開發者

以下人員參與了開源軟體〈References〉的開發相關工作。

參與者

將〈References〉外掛本地化為台灣繁體中文版

對開發相關資訊感興趣?

任何人均可瀏覽程式碼、查看 SVN 存放庫,或透過 RSS 訂閱開發記錄

變更記錄

1.2

New API function REFShraAPI::find // returns array of articles where attached given article (as post_id).

1.1

Added implementation referesence list shortdcode – ref.
[ref id=”POST_ID” key=”REFERENCE_KEY”]

Added reference API. You can use in your code static functions of special class REFShraAPI. Now 5 functions are available. More details about API functions, their arguments, examples look in referenece.php.

REFShraAPI::config_load($postType = NULL, $refKey = NULL); //returns array currently configured REFERENCES.

REFShraAPI::config_add($postType, $refKey, $linkedTypes, $title) // ADD/update REFERENCE configs.

REFShraAPI::config_remove($postType, $refKey); // Delete REFERENCE config by pair postType / refKey.

REFShraAPI::get($postID = NULL); // Get references data by post ID.

REFShraAPI::update($postID = NULL, $refkey, $postIDs); // Update references data by post ID.

1.02

Fixed bug with empty value reference case.

1.01

Few cosmetic changes. Main change is next – plugin now allows to manage all post types with show_ui flag instead of post types with public flag.

1.0

Includes an admin page with plugin setting and Widgets.