Version: 0.9
Easily reference another post in your blog using a shortcut, either by id or post slug. The shortcut is replaced with the hyperlinked t
Author: | Scott Reilly (profile at wordpress.org) |
WordPress version required: | 4.7 |
WordPress version tested: | 4.9.6 |
Plugin version: | 4.2 |
Added to WordPress repository: | 21-12-2004 |
Last updated: | 10-06-2018
Warning! This plugin has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.
|
Rating, %: | 0 |
Rated by: | 0 |
Plugin URI: | http://coffee2code.com/wp-plugins/easy-post-t... |
Total downloads: | 10 201 |
Active installs: | 70+ |
Click to start download |
Screenshots
FAQ
Installation Instructions
- Install via the built-in WordPress plugin installer. Or download and unzip
easy-post-to-post-links.zip
inside the plugins directory for your site (typicallywp-content/plugins/
) - Activate the plugin through the ‘Plugins’ admin menu in WordPress
- Go to the
Settings
->Post2Post
admin options page. Optionally customize the settings. - Use the Post-to-Post link syntax in posts to refer to other posts, as needed. (See examples.)
Should I enable legacy tag support?
The “Enable legacy HTML comment-style tag support?” setting controls whether the older, HTML comment style notation (from before v2.0 of the plugin) should be recognized. The “Enable legacy pseudo-shortcode tag support?” setting controls whether the older pseudo-shortcode syntax (from before v3.0 of the plugin) should be recognized You should only enable a particular legacy mode if you’ve used versions of this plugin prior to v3.0 and still want those post-to-post links to work without updating them. If you started using the plugin at v3.0 or later, you do not need to enable legacy support. Unnecessarily enabling legacy tag support will have a negative impact on the performance of your site.
What happens when a post-to-post tag references a post that does not exist?
If no post on your blog matches the value you specified as either a post ID or post slug, then the post-to-post tag in question disappears from the view, having been replaced with an empty string.
Can’t the shortcode be something other than ‘post2post’; perhaps something shorter?
Yes. See the Filters section for an example of code to change the shortcode name. If you are going to make this short of change, it is recommended that you do so before making use of the shortcode in your posts/pages (unless you search and replace all occurrences of the original shortcode in other posts). Out of the box, the plugin only supports a single name for the shortcode.
4.2 (2018-05-10)
Highlights:
- This release consists of minor behind-the-scenes changes.
Details:
- Change: Drop “Easy” from the name (as an unnecessary word and not that the plugin is any less “easy”)
- Change: Update plugin framework to 047
- 047:
- Don’t save default setting values to database on install
- Change “Cheatin’, huh?” error messages to “Something went wrong.”, consistent with WP core
- Note compatibility through WP 4.9+
- Drop compatibility with version of WP older than 4.7
- 046:
- Fix
reset_options()
to reference instance variable$options
- Note compatibility through WP 4.7+
- Update copyright date (2017)
- 045:
- Ensure
reset_options()
resets values saved in the database - 044:
- Add
reset_caches()
to clear caches and memoized data. Use it inreset_options()
andverify_config()
- Add
verify_options()
with logic extracted fromverify_config()
for initializing default option attributes - Add
add_option()
to add a new option to the plugin’s configuration - Add filter ‘sanitized_option_names’ to allow modifying the list of whitelisted option names
- Change: Refactor
get_option_names()
- 043:
- Disregard invalid lines supplied as part of hash option value
- 042:
- Update
disable_update_check()
to check for HTTP and HTTPS for plugin update check API URL - Translate “Donate” in footer message
- New: Add README.md
- Change: Store setting name in constant
- Change: Unit tests:
- Improve option handling and option-related unit tests
- Default
WP_TESTS_DIR
to/tmp/wordpress-tests-lib
in bootstrap rather than erroring out if not defined via environment variable - Enable more error output for unit tests
- Change: Add GitHub link to readme
- Change: Modify formatting of hook name in readme to prevent being uppercased when shown in the Plugin Directory
- Change: Note compatibility through WP 4.9+
- Change: Drop compatibility with versions of WP older than 4.7
- Change: Update copyright date (2018)
- Change: Update installation instruction to prefer built-in installer over .zip file
4.1 (2016-05-26)
- Change: Update plugin framework to 043:
- Fix error message when text replacement field has trailing blank line.
- Change class name to c2c_TextReplace_Plugin_043 to be plugin-specific.
- Disregard invalid lines supplied as part of hash option value.
- Set textdomain using a string instead of a variable.
- Don’t load textdomain from file.
- Change admin page header from ‘h2’ to ‘h1’ tag.
- Add
c2c_plugin_version()
. - Formatting improvements to inline docs.
- Change: Add support for language packs:
- Set textdomain using a string instead of a variable.
- Remove .pot file and /lang subdirectory.
- Remove ‘Domain Path’ from plugin header.
- Change: Prevent direct loading of test file.
- Change: Prevent web invocation of unit test bootstrap.php.
- Change: Explicitly declare methods in unit tests as public.
- New: Add LICENSE file.
- New: Add empty index.php to prevent files from being listed if web server has enabled directory listings.
- Change: Minor code reformatting.
- Change: Note compatibility through WP 4.5+.
- Change: Dropped compatibility with version of WP older than 4.1.
- Change: Update copyright date (2016).
4.0 (2015-03-09)
- Publicly release changes from the not-publicly released v2.0 and v3.0 of the plugin
- Update plugin framework to 039
- Add support for shortcode attributes ‘before’ and ‘after’ to override plugin setting on per-user basis
- Implement a Quicktags button “post2post” that inserts the shortcode into the post editor (Text-mode only)
- Remove support for the broken TinyMCE button (Visual-mode), including files
- Move plugin page examples out from bottom of settings page into help tab
- Add
help_tabs_content()
,contextual_help()
- Remove
show_examples()
,mce_external_plugins()
,mce_buttons()
- Better singleton implementation:
- Add
get_instance()
static method for returning/creating singleton instance - Make static variable ‘instance’ private
- Make constructor protected
- Make class final
- Additional related changes in plugin framework (protected constructor, erroring
__clone()
and__wakeup()
)
- Add
- Add unit tests
- Explicitly declare
activation()
anduninstall()
static - Add checks to prevent execution of code if file is directly accessed
- Re-license as GPLv2 or later (from X11)
- Reformat plugin header
- Add ‘License’ and ‘License URI’ header tags to readme.txt and plugin file
- Use explicit path for require_once()
- Discontinue use of PHP4-style constructor
- Discontinue use of explicit pass-by-reference for objects
- Remove ending PHP close tag
- Minor documentation improvements
- Minor code reformatting (spacing, bracing)
- Change documentation links to wp.org to be https
- Note compatibility through WP 4.1+
- Drop compatibility with version of WP older than 3.6
- Update copyright date (2015)
- Regenerate .pot
- Move .pot to lang/ subdirectory
- Change donate link
- Add assets directory to plugin repository checkout
- Update screenshot
- Move screenshot into repo’s assets directory
- Add banner
- Add icon
3.0
- Add support for and favor ‘post2post’ shortcode to link to posts
- Add filter ‘c2c_post2post_shortcode’ to customize shortcode tag
- Re-implementation by extending C2C_Plugin_025, which adds support for:
- Reset of options to default values
- Better sanitization of input values
- Offload of core/basic functionality to generic plugin framework
- Additional hooks for various stages/places of plugin operation
- Easier localization support
- More
- Add shortcode examples to plugin settings page
- No longer attempt add button to quicktags editor buttonbar (not sure if this will be permanent or not)
- Full localization support
- Add __construct(), activation(), uninstall()
- Rename class from PostToPostLinks to c2c_EasyPostToPostLinks
- Move object instantiation to within the initial if(!class_exists()) check
- Save a static version of itself in class variable $instance
- Add PHPDoc documentation
- Add package info to top of plugin file
- Remove docs from top of plugin file (all that and more are in readme.txt)
- Minor code reformatting (spacing)
- Improve documentation
- Note compatibility through WP 3.2+
- Drop compatibility with versions of WP older than 3.0
- Tweak description
- Update copyright date (2011)
- Add Legacy, Filters, Changelog, and Upgrade Notice sections to readme.txt
- Add screenshot
- Add .pot file
- Add plugin homepage and author links in description in readme.txt
2.0
- Created its own class to encapsulate plugin functionality
- Added admin options page under Options -> Post2Post (or in WP 2.5: Settings -> Post2Post). Options are now saved to database, negating need to customize code within the plugin source file.
- Admin options page also includes documentation and examples
- Added support for new post-to-post tag syntax of [post=”XX”]
(also still works for legacy syntax) - Added support for per-post-to-post-link override of display text, i.e. [post=’25’ title=’this post’]
- Fixed bug that prevented linking to posts vis post slug from working
- Send post’s ID to get_the_title(), not the title
- Utilize get_the_title() to obtain the post’s title, rather than direct retrieval
- Added filter so that content seen via RSS gets filtered
- Filter ‘get_the_except’ instead of ‘the_excerpt’
- Added new admin option ‘enable_legacy’ to control support of legacy syntax
- Changed filter priority level to 9 to trigger before some of WP’s formatting filters
- Added TinyMCE button (w/ custom image) to insert post-to-post link tag into editor. If text is highlighted, it becomes the text=”” value.
- Fixed Quicktags button support; now it also applies to writing and creating pages
- Changed installation instructions
- Added compatibility note
- Updated copyright date and version to 2.0
- Moved into its own subdirectory; added readme.txt and screenshot
- Tested compatibility with WP 2.3.3 and 2.5
1.0
- (Lost to time)
0.9
- Initial release