/public-post-preview

Enables you to give a link to anonymous users for public preview of a post before it is published.

Primary LanguagePHP

Public Post Preview

WordPress plugin to enable you to give a link to anonymous users for public preview of a post (or any other public post type) before it is published.

Have you ever been writing a post with the help of someone who does not have access to your blog and needed to give them the ability to preview it before publishing? This plugin takes care of that by generating an URL with an expiring nonce that can be given out for public preview.

This plugin was previously maintained by Matt Martz and was an idea of Jonathan Dingman. Thanks to Hans Dinkelberg for his photo.

Installation

Note: There will be NO settings page.

For an automatic installation through WordPress:

  1. Go to the 'Add New' plugins screen in your WordPress admin area
  2. Search for 'Public Post Preview'
  3. Click 'Install Now' and activate the plugin

For a manual installation via FTP:

  1. Upload the public-post-preview directory to the /wp-content/plugins/ directory
  2. Activate the plugin through the 'Plugins' screen in your WordPress admin area

To upload the plugin through WordPress, instead of FTP:

  1. Upload the downloaded zip file on the 'Add New' plugins screen (see the 'Upload' tab) in your WordPress admin area and activate.

Usage

  • To enable a public post preview check the box below the edit post box.
  • The link will be displayed if the checkbox is checked, just copy and share the link with your friends.
  • To disable a preview just uncheck the box.

Frequently Asked Questions

I can't find the option for preview links. Where is it?

The checkbox is only available for non-published posts and once a post was saved as a draft.

After some time the preview link returns the message "The link has been expired!". Why?

The plugin generates an URL with an expiring nonce. By default a link "lives" 48 hours. After 48 hours the link is expired and you need to copy and share a new link which is automatically generated on the same place under the editor.

48 hours are not enough to me. Can I extend the nonce time?

Yes, of course. You can use the filter ppp_nonce_life. Example for 5 days:

add_filter( 'ppp_nonce_life', 'my_nonce_life' );
function my_nonce_life() {
	return 60 * 60 * 24 * 5; // 5 days
}

Or use the Public Post Preview Configurator.

Changelog

2.6.0 (2017-04-27):

  • Make DS_Public_Post_Preview::get_preview_link() public. Props @rcstr.
  • Send no-cache headers for public post previews.

2.5.0 (2016-04-05):

  • Auto select preview link on focus. Props @JeroenSormani.
  • Remove preview status from posts which are trashed or after scheduled posts are published.
  • Add support for paged posts.

2.4.1 (2015-10-13):

2.4 (2014-08-21):

  • Supports EditFlow and custom statuses
  • Disables comments and pings during public post preview
  • Adds Public Preview to the list of display states used in the Posts list table
  • Prevents flickering of link box on Post edit while loading

2.3 (2013-11-18):

  • Introduces a filter ppp_preview_link. With the filter you can adjust the preview link.
  • If a post has gone live, redirect to it's proper permalink.
  • Adds the query var _ppp to WordPress SEO by Yoast whitelist.

2.2 (2013-03-15):

  • Based on user feedback: Removed the extra metabox and added preview link to the main Publish metabox.
  • Only show the checkbox if the post status/post type is good.
  • Requires WordPress 3.5

2.1.1 (2012-09-19):

  • Sorry for the new update. Through a change in 2.1 a filter was applied to each query. The misplaced "The link has been expired!" message is now gone. Props Aki Björklund and Jonathan Channon.

2.1 (2012-09-16):

  • Introduces a filter ppp_nonce_life. With the filter you can adjust the expiration of a link. By default a link has a lifetime of 48 hours.
  • In some situations (still not sure when) the preview link is rewritten as a permalink which results in an error. The plugin now works in this situations too.

2.0.1 (2012-07-25):

  • Makes the preview link copyable again

2.0 (2012-07-23):

  • Support for all public post types
  • Saves public preview status via an AJAX request
  • I18n
  • Requires at least WordPress 3.3

1.3 (2009-06-30):

  • Hook in earlier in the post selection process to fix PHP notices
  • Add uninstall functionality to remove options from the options table

1.2 (2009-03-30):

  • Fix preview URL for scheduled posts on sites with a permalink other than default activated.

1.1 (2009-03-11):

  • Don't limit public previews to posts in draft or pending status. Just exclude posts in publish status.

1.0 (2009-02-20):

  • Initial Public Release