README.md 7.61 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
Erick Hitter committed
7
**Stable tag:** 0.9.2  
8 9 10 11 12 13
**License:** GPLv2 or later  
**License URI:** http://www.gnu.org/licenses/gpl-2.0.html  

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
Erick Hitter committed
54
### 0.9.2 ###
Erick Hitter's avatar
Erick Hitter committed
55
* Compatible with PHP 7.3
Erick Hitter's avatar
Erick Hitter committed
56 57 58
* Introduce PHPCS tests
* Update plugin based on PHPCS results

59 60 61 62 63 64 65 66 67 68 69 70
### 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.

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

### 0.8.1 ###
* Correct translation implementation issue introduced in v0.8.

### 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
71
* Audit entire plugin for translation readiness.
72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108
* Correct phpdoc.

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

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

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

### 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
Erick Hitter committed
109 110 111
### 0.9.2 ###
Adds support for PHP 7.3 and fixes various PHPCS errors, neither of which should impact the plugin's functionality.

112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146
### 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.

### 0.9 ###
Recommended update for anyone hoping to use plugin's filters to modify its behaviour.

### 0.8.1 ###
Recommended upgrade for anyone translating plugin's interface.

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

### 0.7 ###
Further ensures plugins and themes correctly see a "View All" page as full post content.

### 0.6.1 ###
Resolves a problem where requests for view-all templates redirect to the article.

### 0.6 ###
Adds better support for sites that use verbose page rules, resolving situations where requests for view-all template redirect to the post.

### 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 ###
Introduces helper function for wp_link_pages arguments and split filtering from plugin options.