readme.txt 7.42 KB
Newer Older
1 2 3 4 5
=== View All Post's Pages ===
Contributors: ethitter, thinkoomph
Donate link: http://www.thinkoomph.com/plugins-modules/view-all-posts-pages/
Tags: view all, pages, paged, paged post, multipage, single view, single page, wp_link_pages, nextpage, next page, quicktag
Requires at least: 3.2.1
Erick Hitter's avatar
Erick Hitter committed
6
Tested up to: 5.1
Erick Hitter's avatar
v0.9.1  
Erick Hitter committed
7
Stable tag: 0.9.1
Erick Hitter's avatar
License  
Erick Hitter committed
8 9
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
10 11 12 13

Provides a "view all" (single page) option for content paged using WordPress' <!--nextpage--> Quicktag (multipage posts).
== Description ==

Erick Hitter's avatar
Erick Hitter committed
14 15
**This plugin is not yet compatible with WordPress 5.2.**

16 17 18 19 20 21 22 23 24 25 26 27 28 29
Provides a "view all" (single page) option for posts, pages, and custom post types paged using WordPress' <a href="http://codex.wordpress.org/Write_Post_SubPanel#Quicktags" target="_blank"><code>&lt;!--nextpage--&gt;</code> Quicktag</a> (multipage posts).

Your theme must use `wp_link_pages()` to generate post page links, or you must use either the automatic or manual link capabilities provided in the plugin.

**IMPORTANT**: There are certain plugins that may interfere with this plugin's functionality. See the **FAQ** for more information.

== Installation ==

1. Upload view-all-posts-pages.php to /wp-content/plugins/.
2. Activate plugin through the WordPress Plugins menu.
3. Navigate to Options > Permalinks and click *Save Changes* to update navigation.

== Frequently Asked Questions ==

Erick Hitter's avatar
Erick Hitter committed
30 31 32 33
= I upgraded to WordPress 5.2 and this plugin stopped working. =

WordPress 5.2 updated the function that's used to retrieve post content, defeating this plugin's method of creating the view-all output. Progress towards a 5.2-compatible approach will be tracked at [https://git.ethitter.com/wp-plugins/view-all-posts-pages/issues/1](https://git.ethitter.com/wp-plugins/view-all-posts-pages/issues/1).

34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53
= Links don't work =
First, navigate to Options > Permalinks in WP Admin, click *Save Changes*, and try again.

If clicking on a 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/view-all-posts-pages/](http://www.thinkoomph.com/plugins-modules/view-all-posts-pages/) and leave a comment detailing the problem.

= How do I add a link to my template? =
The function `vapp_the_link` will add a link to the full-content version of whatever page it appears on. This function accepts the following arguments:

* **$link_text**: Set to text that should appear for the link. Defaults to *View All*.
* **$class**: Specifies the CSS class for the link. Defaults to *vapp*.

= 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 View All Post's Pages' ability to display full content. Both must be disabled, and the site's rewrite rules regenerated (by visiting Options > Permalinks and clicking *Save Changes*), for View All Post's Pages to function.

== Changelog ==

Erick Hitter's avatar
PHPCS  
Erick Hitter committed
54 55 56 57
= 0.9.2 =
* Introduce PHPCS tests
* Update plugin based on PHPCS results

Erick Hitter's avatar
v0.9.1  
Erick Hitter committed
58 59 60
= 0.9.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.

61 62 63
= 0.9 =
* Move conditional registration of some filters to `init`, both to ensure external code can interact with filters and to avoid PHP notices.

64 65 66
= 0.8.1 =
* Correct translation implementation issue introduced in v0.8.

67 68 69
= 0.8 =
* When WordPress determines a request is a 404, don't activate the plugin's functionality.
* Convert the plugin to a singleton.
Erick Hitter's avatar
Erick Hitter committed
70
* Audit entire plugin for translation readiness.
71 72
* Correct phpdoc.

Erick Hitter's avatar
Erick Hitter committed
73 74 75
= 0.7 =
* Further ensure that WordPress doesn't think a post is paged when viewing the full post content unpaged. Ensures that code checking the `$multipage` variable will function properly. Props @batmoo.

76 77 78
= 0.6.1 =
* Revert change in is_view_all() method made in version 0.6 as it breaks the method, rendering the plugin inoperable.

Erick Hitter's avatar
Erick Hitter committed
79 80 81 82 83 84
= 0.6 =
* 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.

85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107
= 0.5 =
* Change how post content is modified for View All display. Rather than using the `the_content` filter, global variables are overridden in the `the_post` action. Ensures that infinite loops don't result from shortcode processing and other uses of the `the_content` filter. Props to the WordPress.com VIP Support team (batmoo) and stevenkword.
* Introduces the `vapp_display_link` filter to allow plugins and themes to suppress the automatic View All link on specific posts. Return `false` to suppress the link. Filter also passes post ID, plugin options, and post object.

= 0.4.1 =
* Eliminate use of plugins_loaded action since plugin has no dependencies on other plugins. All code previously located in the associated method has been moved to the class's constructor. Props danielbachhuber.

= 0.4 =
* Add filter to disable rewrite rules notice.
* Apply esc_html() to link text during output.
* Update code to conform to WordPress Coding Standards.

= 0.3 =
* Simplify rewrite rule creation, resolving 404 errors in most cases.

= 0.2 =
* Change how wp_link_pages arguments are filtered to better support as-needed filtering.

= 0.1 =
* Initial release

== Upgrade Notice ==

Erick Hitter's avatar
PHPCS  
Erick Hitter committed
108 109 110
= 0.9.2 =
Adds support for PHP 7.3 and fixes various PHPCS errors, neither of which should impact the plugin's functionality.

Erick Hitter's avatar
v0.9.1  
Erick Hitter committed
111 112 113
= 0.9.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.

114 115 116
= 0.9 =
Recommended update for anyone hoping to use plugin's filters to modify its behaviour.

117 118 119
= 0.8.1 =
Recommended upgrade for anyone translating plugin's interface.

120 121 122
= 0.8 =
Plugin won't unnecessarily execute its functionality if no posts are available and is now more thoroughly translatable.

Erick Hitter's avatar
Erick Hitter committed
123 124 125
= 0.7 =
Further ensures plugins and themes correctly see a "View All" page as full post content.

126 127 128
= 0.6.1 =
Resolves a problem where requests for view-all templates redirect to the article.

Erick Hitter's avatar
Erick Hitter committed
129
= 0.6 =
130
Adds better support for sites that use verbose page rules, resolving situations where requests for view-all template redirect to the post.
Erick Hitter's avatar
Erick Hitter committed
131

132 133 134 135 136 137 138 139 140 141 142 143 144
= 0.5 =
Infinite loops may result from previous method used to display entire post's content for the View All display. This update eliminates that possibility by using the the_post action rather than the the_content filter. Props to the WordPress.com VIP Support team (batmoo) and stevenkword.

= 0.4.1 =
Eliminates use of plugins_loaded action since plugin has no dependencies on other plugins. All code previously located in the associated method has been moved to the class's constructor. props danielbachhuber.

= 0.4 =
Adds filter to disable rewrite rules notice. Also applies esc_html() to link text when output since HTML isn't permitted in the link text.

= 0.3 =
Simplifies rewrite rules, resolving 404 errors in most cases.

= 0.2 =
Erick Hitter's avatar
Erick Hitter committed
145
Introduces helper function for wp_link_pages arguments and split filtering from plugin options.