Title: References
Author: shra
Published: <strong>June 22, 2016</strong>
Last modified: February 20, 2025

---

Search plugins

![](https://ps.w.org/references/assets/banner-772x250.png?rev=1441605)

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://ps.w.org/references/assets/icon-256x256.png?rev=1441608)

# References

 By [shra](https://profiles.wordpress.org/shra/)

[Download](https://downloads.wordpress.org/plugin/references.zip)

 * [Details](https://wordpress.org/plugins/references/#description)
 * [Reviews](https://wordpress.org/plugins/references/#reviews)
 *  [Installation](https://wordpress.org/plugins/references/#installation)
 * [Development](https://wordpress.org/plugins/references/#developers)

 [Support](https://wordpress.org/support/plugin/references/)

## Description

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”]

## Screenshots

 * [[
 * 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.

## Installation

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”.

## Reviews

![](https://secure.gravatar.com/avatar/bf1a5206d4d4c5adcbdcb71a85b2182243c6b5c4b568e5bc0f2e18c5f773b9b9?
s=60&d=retro&r=g)

### 󠀁[Nice](https://wordpress.org/support/topic/nice-2458/)󠁿

 [LucasTolle](https://profiles.wordpress.org/lucastolle/) March 28, 2018

Perfect!

 [ Read all 1 review ](https://wordpress.org/support/plugin/references/reviews/)

## Contributors & Developers

“References” is open source software. The following people have contributed to this
plugin.

Contributors

 *   [ shra ](https://profiles.wordpress.org/shra/)

[Translate “References” into your language.](https://translate.wordpress.org/projects/wp-plugins/references)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/references/), check
out the [SVN repository](https://plugins.svn.wordpress.org/references/), or subscribe
to the [development log](https://plugins.trac.wordpress.org/log/references/) by 
[RSS](https://plugins.trac.wordpress.org/log/references/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 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.

## Meta

 *  Version **1.202**
 *  Last updated **1 year ago**
 *  Active installations **30+**
 *  WordPress version ** 3.0 or higher **
 *  Tested up to **6.4.8**
 * Tag
 * [reference](https://wordpress.org/plugins/tags/reference/)
 *  [Advanced View](https://wordpress.org/plugins/references/advanced/)

## Ratings

 5 out of 5 stars.

 *  [  1 5-star review     ](https://wordpress.org/support/plugin/references/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/references/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/references/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/references/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/references/reviews/?filter=1)

[Add my review](https://wordpress.org/support/plugin/references/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/references/reviews/)

## Contributors

 *   [ shra ](https://profiles.wordpress.org/shra/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/references/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](https://shra.ru/2016/06/references-wp-plugin/)