Extends WordPress' template system to support printer-friendly templates. Works with permalink structures to support nice URLs.
Extends WordPress’ template system to support printer-friendly templates for posts, pages, and custom post types. Uses WP standard template naming to support templates on a post-type basis. Supports printing paged posts on single page. Adds nice URLs for printer-friendly pages.
IMPORTANT: There are certain plugins that may interfere with this plugin’s functionality. See the FAQ for more information.
FAQ
Print links don’t work
First, navigate to Options > Permalinks in WP Admin, click Save Changes, and try again.
If clicking on a print link takes you back to the post or page where the link appeared, see the Known Plugin Conflicts item below.
If, after reviewing the remaining FAQ, you are still experiencing problems, visit http://www.thinkoomph.com/plugins-modules/wp-print-friendly/ and leave a comment detailing the problem.
How should I name print templates?
Print templates should be prefixed with wpf and follow WordPress template conventions from there. To use one template for all contexts unless otherwise specified, name your template wpf.php.
For both built-in and custom post types, wpf-[post type name].php will be used for that post type. To use a template for a single post type object, name your template wpf-[post type name]-[slug].php.
For custom taxonomies, follow the naming conventions for post types.
Similarly, wpf-home.php will load that template for the front page of your site.
The plugin also includes a default template that may suit many needs.
How do I add a print link to my templates?
The function wpf_the_print_link will add a link to the print-friendly version of whatever page it appears on. This function accepts the following arguments:
- $page_link: Set to true to add a link to the current page in a paged post in addition a to a link for the entire post.
- $link_text: Set to text that should appear for the print link. Defaults to Print this post.
- $class: Specifies the CSS class for the print link. Defaults to print_link.
- $page_link_separator: If $page_link is true, specifies what separator will appear between the print link for the entire post and the print link for the current page of the post.
- $page_link_text: If $page_link is true, specifies what text will appear for the print link for the current page. Defaults to Print this page.
- $link_target: If set to “new”, print links will open in a new window.
Known Plugin Conflicts
This plugin is known to conflict with certain plugins, many pertaining to SEO and permalinks. Conflicting plugins include, but are not limited to, the following:
- WordPress SEO by Yoast: This plugin’s
Permalink options, particularly Redirect attachment URL’s to parent post URL and Redirect ugly URL’s to clean permalinks. (Not recommended in many cases!), interfere with WP Print Friendly’s ability to display print templates. Both must be disabled, and the site’s rewrite rules regenerated (by visiting Options > Permalinks and clicking Save Changes), for WP Print Friendly to function.
ChangeLog
0.6.3
0.6.2
0.6.1
- Security update: correct misuse of
add_query_arg() as identified by Sucuri: https://blog.sucuri.net/2015/04/security-advisory-xss-vulnerability-affecting-multiple-wordpress-plugins.html.
0.6
- Revert security hotfixes made in 0.5.3 and address the vulnerabilities in the WordPress way.
- If current user can’t read a private post, don’t display the print template, allowing the standard theme to handle requests.
- If a post is password protected and the viewer hasn’t provided the right password, display the password form and prevent plugin from exposing any information about the post that WordPress doesn’t already.
- When WordPress determines a request is a 404, don’t activate the plugin’s templating functionality.
- Convert the plugin to a singleton.
- Audit entire plugin for translation readyness.
- Correct phpdoc.
0.5.3
- Creates is_protected() method to determine if the print page should be visible to the current user
- Correct security vulnerability allowing both private and password protected posts from being accessed through the print page
- Remove print_url links from the content when the current user does not have the necessary capabilities to view the print page
0.5.2
0.5.1
- Correct construction of query needed in situations where verbose page rules are required.
0.5
- Add additional rewrite rules for situations where verbose page rules are required.
- Disable canonical redirect when print template is requested.
- Update is_print() method to use WordPress API.
- Correct translation string implementation.
- Update code to better conform to WordPress Coding Standards.
0.4.4.1
- Remove unnecessary query_var filter.
0.4.4
0.4.3.3
- Correct error that would display wrong page’s content when printing a single page of a paged post.
- Correct error in link generation for page-specific print links.
- Increase compatibility with View All Post’s Pages plugin.
0.4.3.2
- Resolve PHP notice in options retrieval.
- Add compatibility with View All Post’s Pages plugin (release forthcoming).
0.4.3.1
- Fix bug in options retrieval that caused print links to be added to default post types if no post types were selected.
- Resolve PHP notice when using default permalinks.
0.4.3
- Fix bug in page number function.
- Rewrite endnote link processing, including a refined regex pattern.
- Introduce class property for print slug.
- Correct minor bug in print link generation.
- Add canonical link attribute and nofollow declaration to default template.
0.4.2.2
- Correct generation of custom post type rewrite rules.
0.4.2.1
- Version 0.4.2 omitted the default template.
0.4.2
- Correct page rewrite rules to accomodate situations necessitating verbose rules, such as when the permalink structure starts with
%postname%. Thanks to Wes Herzik at ikonic for discovering and reporting this issue.
0.4.1
- Fix bug that displayed post links automatically on the wrong post types.
0.4
- Child pages now fully supported.
- Generates and registers rewrite rules more efficiently.
- Rewrite setting for all post types and taxonomies are now considered when adding print support.
- Add option to disable endnotes representing links found in content.
- Move copyright and other static elements from content filters to default template.
- Add function to display page numbers when printing single page of post.
- Options page is now fully translation-ready.
- Notices are translation-ready.
- Correct various other bugs, including many related to non-standard permalink structures, custom post types, and custom taxonomies.
0.3.2
- Add option to open print-friendly views in a new window.
0.3.1
- Correct PHP error in
is_print().
0.3
