该插件尚未通过WordPress的最新3个主要版本进行测试。 当与较新版本的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.