Version Description
Download this release
Release Info
Developer | GamerZ |
Plugin | WP-PageNavi |
Version | 2.92 |
Comparing to | |
See all releases |
Code changes from version 2.91 to 2.92
- readme.txt +41 -38
- wp-pagenavi.php +1 -1
readme.txt
CHANGED
@@ -1,30 +1,30 @@
|
|
1 |
-
|
2 |
Contributors: GamerZ, scribu
|
3 |
Donate link: https://lesterchan.net/site/donation/
|
4 |
Tags: navigation, pagination, paging, pages
|
5 |
Requires at least: 3.2
|
6 |
-
Tested up to: 4.
|
7 |
-
Stable tag: 2.
|
8 |
License: GPLv2 or later
|
9 |
License URI: http://www.gnu.org/licenses/gpl-2.0.html
|
10 |
|
11 |
Adds a more advanced paging navigation interface.
|
12 |
|
13 |
-
|
14 |
Want to replace the old *← Older posts | Newer posts →* links with some page links?
|
15 |
|
16 |
This plugin provides the `wp_pagenavi()` template tag which generates fancy pagination links.
|
17 |
|
18 |
-
|
19 |
In your theme, you need to find calls to next_posts_link() and previous_posts_link() and replace them.
|
20 |
|
21 |
In the Twentyten theme, it looks like this:
|
22 |
|
23 |
-
|
24 |
<div class="nav-previous"><?php next_posts_link( __( '<span class="meta-nav">←</span> Older posts', 'twentyten' ) ); ?></div>
|
25 |
<div class="nav-next"><?php previous_posts_link( __( 'Newer posts <span class="meta-nav">→</span>', 'twentyten' ) ); ?></div>
|
26 |
-
|
27 |
-
|
28 |
You would replace those two lines with this:
|
29 |
|
30 |
`<?php wp_pagenavi(); ?>`
|
@@ -39,13 +39,13 @@ and replace it with this:
|
|
39 |
|
40 |
Go to *WP-Admin -> Settings -> PageNavi* for configuration.
|
41 |
|
42 |
-
|
43 |
|
44 |
If you need to configure the CSS style of WP-PageNavi, you can copy the `pagenavi-css.css` file from the plugin directory to your theme's directory and make your modifications there. This way, you won't lose your changes when you update the plugin.
|
45 |
|
46 |
Alternatively, you can uncheck the "Use pagenavi.css?" option from the settings page and add the styles to your theme's style.css file directly.
|
47 |
|
48 |
-
|
49 |
|
50 |
There are [filters](http://codex.wordpress.org/Glossary#Filter) that can be used to change the default class names that are assigned to page navigation elements.
|
51 |
|
@@ -64,7 +64,7 @@ There are [filters](http://codex.wordpress.org/Glossary#Filter) that can be used
|
|
64 |
|
65 |
#### Filter Usage
|
66 |
|
67 |
-
|
68 |
// Simple Usage - 1 callback per filter
|
69 |
add_filter('wp_pagenavi_class_previouspostslink', 'theme_pagination_previouspostslink_class');
|
70 |
add_filter('wp_pagenavi_class_nextpostslink', 'theme_pagination_nextpostslink_class');
|
@@ -102,43 +102,43 @@ function theme_pagination_class($class_name) {
|
|
102 |
}
|
103 |
return $class_name;
|
104 |
}
|
105 |
-
|
106 |
-
|
107 |
-
|
108 |
[![Build Status](https://travis-ci.org/lesterchan/wp-pagenavi.svg?branch=master)](https://travis-ci.org/lesterchan/wp-pagenavi)
|
109 |
|
110 |
-
|
111 |
* [https://github.com/lesterchan/wp-pagenavi](https://github.com/lesterchan/wp-pagenavi "https://github.com/lesterchan/wp-pagenavi")
|
112 |
|
113 |
-
|
114 |
* Plugin icon by [SimpleIcon](http://www.simpleicon.com) from [Flaticon](http://www.flaticon.com)
|
115 |
|
116 |
-
|
117 |
I spent most of my free time creating, updating, maintaining and supporting these plugins, if you really love my plugins and could spare me a couple of bucks, I will really appreciate it. If not feel free to use it without any obligations.
|
118 |
|
119 |
-
|
120 |
|
121 |
1. With Custom Styling
|
122 |
2. Admin - Options Page
|
123 |
|
124 |
-
|
125 |
|
126 |
-
|
127 |
|
128 |
Make sure your host is running PHP 5. The only foolproof way to do this is to add this line to wp-config.php (after the opening `<?php` tag):
|
129 |
|
130 |
`var_dump(PHP_VERSION);`
|
131 |
<br>
|
132 |
|
133 |
-
|
134 |
|
135 |
You're using `query_posts()` wrong. See [The Right Way To use query_posts()](http://scribu.net/wordpress/wp-pagenavi/right-way-to-use-query_posts.html)
|
136 |
|
137 |
-
|
138 |
|
139 |
Yes; read [this tutorial](http://scribu.net/wordpress/wp-pagenavi/wpn-2-74.html)
|
140 |
|
141 |
-
|
142 |
|
143 |
If you are running a multi-language plugin, you will probably want to ignore the strings in the options page.
|
144 |
|
@@ -146,56 +146,59 @@ You can do that like so:
|
|
146 |
|
147 |
`<?php wp_pagenavi( array( 'options' => PageNavi_Core::$options->get_defaults() ) ); ?>`
|
148 |
|
149 |
-
|
150 |
-
|
|
|
|
|
|
|
151 |
* Validate text option against kses
|
152 |
* Update SCB Framework
|
153 |
|
154 |
-
|
155 |
* Remove po/mo files from the plugin
|
156 |
* Use translate.wordpress.org to translate the plugin
|
157 |
|
158 |
-
|
159 |
* FIXED: before and after args
|
160 |
|
161 |
-
|
162 |
* NEW: wrapper_tag option to allow other HTML tag besides DIV and wrapper_class option to allow other class name besides wp-pagenavi. Props @Mahjouba91.
|
163 |
|
164 |
-
|
165 |
* NEW: Added filters for altering class names. Props @bookwyrm
|
166 |
|
167 |
-
|
168 |
* NEW: Uses WordPress native uninstall.php
|
169 |
|
170 |
-
|
171 |
* NEW: Bump to 4.0
|
172 |
* NEW: Added rel=next and rel=previous
|
173 |
|
174 |
-
|
175 |
* FIXED: "Use pagenavi-css.css" & "Always Show Page Navigation" in the options are not being saved
|
176 |
|
177 |
-
|
178 |
* FIXED: Updated scb framework to fix scbAdminPage incompatible error
|
179 |
|
180 |
-
|
181 |
* added 'echo' parameter
|
182 |
* added Estonian and Bengali translations
|
183 |
* updated scbFramework
|
184 |
|
185 |
-
|
186 |
* fixed prev/next links not appearing in some conditions
|
187 |
* added Hebrew, Georgian and Azerbaijani translations
|
188 |
* updated scbFramework
|
189 |
|
190 |
-
|
191 |
* require an explicit type; fixes bugs with multipart pages
|
192 |
|
193 |
-
|
194 |
* support for multi-part pages and user queries
|
195 |
* moved prev/next links before/after first/last links
|
196 |
* [more info](http://scribu.net/wordpress/wp-pagenavi/wpn-2-80.html)
|
197 |
|
198 |
-
|
199 |
* added 'smaller' and 'larger' classes
|
200 |
* added $query arg to wp_pagenavi()
|
201 |
* updated translations
|
1 |
+
# WP-PageNavi
|
2 |
Contributors: GamerZ, scribu
|
3 |
Donate link: https://lesterchan.net/site/donation/
|
4 |
Tags: navigation, pagination, paging, pages
|
5 |
Requires at least: 3.2
|
6 |
+
Tested up to: 4.8
|
7 |
+
Stable tag: 2.92
|
8 |
License: GPLv2 or later
|
9 |
License URI: http://www.gnu.org/licenses/gpl-2.0.html
|
10 |
|
11 |
Adds a more advanced paging navigation interface.
|
12 |
|
13 |
+
## Description
|
14 |
Want to replace the old *← Older posts | Newer posts →* links with some page links?
|
15 |
|
16 |
This plugin provides the `wp_pagenavi()` template tag which generates fancy pagination links.
|
17 |
|
18 |
+
### Usage
|
19 |
In your theme, you need to find calls to next_posts_link() and previous_posts_link() and replace them.
|
20 |
|
21 |
In the Twentyten theme, it looks like this:
|
22 |
|
23 |
+
~~~
|
24 |
<div class="nav-previous"><?php next_posts_link( __( '<span class="meta-nav">←</span> Older posts', 'twentyten' ) ); ?></div>
|
25 |
<div class="nav-next"><?php previous_posts_link( __( 'Newer posts <span class="meta-nav">→</span>', 'twentyten' ) ); ?></div>
|
26 |
+
~~~
|
27 |
+
|
28 |
You would replace those two lines with this:
|
29 |
|
30 |
`<?php wp_pagenavi(); ?>`
|
39 |
|
40 |
Go to *WP-Admin -> Settings -> PageNavi* for configuration.
|
41 |
|
42 |
+
### Changing the CSS
|
43 |
|
44 |
If you need to configure the CSS style of WP-PageNavi, you can copy the `pagenavi-css.css` file from the plugin directory to your theme's directory and make your modifications there. This way, you won't lose your changes when you update the plugin.
|
45 |
|
46 |
Alternatively, you can uncheck the "Use pagenavi.css?" option from the settings page and add the styles to your theme's style.css file directly.
|
47 |
|
48 |
+
### Changing Class Names
|
49 |
|
50 |
There are [filters](http://codex.wordpress.org/Glossary#Filter) that can be used to change the default class names that are assigned to page navigation elements.
|
51 |
|
64 |
|
65 |
#### Filter Usage
|
66 |
|
67 |
+
~~~
|
68 |
// Simple Usage - 1 callback per filter
|
69 |
add_filter('wp_pagenavi_class_previouspostslink', 'theme_pagination_previouspostslink_class');
|
70 |
add_filter('wp_pagenavi_class_nextpostslink', 'theme_pagination_nextpostslink_class');
|
102 |
}
|
103 |
return $class_name;
|
104 |
}
|
105 |
+
~~~
|
106 |
+
|
107 |
+
### Build Status
|
108 |
[![Build Status](https://travis-ci.org/lesterchan/wp-pagenavi.svg?branch=master)](https://travis-ci.org/lesterchan/wp-pagenavi)
|
109 |
|
110 |
+
### Development
|
111 |
* [https://github.com/lesterchan/wp-pagenavi](https://github.com/lesterchan/wp-pagenavi "https://github.com/lesterchan/wp-pagenavi")
|
112 |
|
113 |
+
### Credits
|
114 |
* Plugin icon by [SimpleIcon](http://www.simpleicon.com) from [Flaticon](http://www.flaticon.com)
|
115 |
|
116 |
+
### Donations
|
117 |
I spent most of my free time creating, updating, maintaining and supporting these plugins, if you really love my plugins and could spare me a couple of bucks, I will really appreciate it. If not feel free to use it without any obligations.
|
118 |
|
119 |
+
## Screenshots
|
120 |
|
121 |
1. With Custom Styling
|
122 |
2. Admin - Options Page
|
123 |
|
124 |
+
## Frequently Asked Questions
|
125 |
|
126 |
+
### Error on activation: "Parse error: syntax error, unexpected..."
|
127 |
|
128 |
Make sure your host is running PHP 5. The only foolproof way to do this is to add this line to wp-config.php (after the opening `<?php` tag):
|
129 |
|
130 |
`var_dump(PHP_VERSION);`
|
131 |
<br>
|
132 |
|
133 |
+
### When I go to page 2, I see the same posts as on page 1!
|
134 |
|
135 |
You're using `query_posts()` wrong. See [The Right Way To use query_posts()](http://scribu.net/wordpress/wp-pagenavi/right-way-to-use-query_posts.html)
|
136 |
|
137 |
+
### Does PageNavi work with secondary WP_Query instances?
|
138 |
|
139 |
Yes; read [this tutorial](http://scribu.net/wordpress/wp-pagenavi/wpn-2-74.html)
|
140 |
|
141 |
+
### How do I ignore the options page?
|
142 |
|
143 |
If you are running a multi-language plugin, you will probably want to ignore the strings in the options page.
|
144 |
|
146 |
|
147 |
`<?php wp_pagenavi( array( 'options' => PageNavi_Core::$options->get_defaults() ) ); ?>`
|
148 |
|
149 |
+
## Changelog
|
150 |
+
### 2.92
|
151 |
+
* Add title attr to pages link. Props @Mahjouba91.
|
152 |
+
|
153 |
+
### 2.91
|
154 |
* Validate text option against kses
|
155 |
* Update SCB Framework
|
156 |
|
157 |
+
### 2.90
|
158 |
* Remove po/mo files from the plugin
|
159 |
* Use translate.wordpress.org to translate the plugin
|
160 |
|
161 |
+
### 2.89.1
|
162 |
* FIXED: before and after args
|
163 |
|
164 |
+
### 2.89
|
165 |
* NEW: wrapper_tag option to allow other HTML tag besides DIV and wrapper_class option to allow other class name besides wp-pagenavi. Props @Mahjouba91.
|
166 |
|
167 |
+
### 2.88
|
168 |
* NEW: Added filters for altering class names. Props @bookwyrm
|
169 |
|
170 |
+
### 2.87
|
171 |
* NEW: Uses WordPress native uninstall.php
|
172 |
|
173 |
+
### 2.86
|
174 |
* NEW: Bump to 4.0
|
175 |
* NEW: Added rel=next and rel=previous
|
176 |
|
177 |
+
### 2.85
|
178 |
* FIXED: "Use pagenavi-css.css" & "Always Show Page Navigation" in the options are not being saved
|
179 |
|
180 |
+
### 2.84
|
181 |
* FIXED: Updated scb framework to fix scbAdminPage incompatible error
|
182 |
|
183 |
+
### 2.83
|
184 |
* added 'echo' parameter
|
185 |
* added Estonian and Bengali translations
|
186 |
* updated scbFramework
|
187 |
|
188 |
+
### 2.82
|
189 |
* fixed prev/next links not appearing in some conditions
|
190 |
* added Hebrew, Georgian and Azerbaijani translations
|
191 |
* updated scbFramework
|
192 |
|
193 |
+
### 2.81
|
194 |
* require an explicit type; fixes bugs with multipart pages
|
195 |
|
196 |
+
### 2.80
|
197 |
* support for multi-part pages and user queries
|
198 |
* moved prev/next links before/after first/last links
|
199 |
* [more info](http://scribu.net/wordpress/wp-pagenavi/wpn-2-80.html)
|
200 |
|
201 |
+
### 2.74 (2011-02-17)
|
202 |
* added 'smaller' and 'larger' classes
|
203 |
* added $query arg to wp_pagenavi()
|
204 |
* updated translations
|
wp-pagenavi.php
CHANGED
@@ -3,7 +3,7 @@
|
|
3 |
Plugin Name: WP-PageNavi
|
4 |
Plugin URI: http://lesterchan.net/portfolio/programming/php/
|
5 |
Description: Adds a more advanced paging navigation to your WordPress blog
|
6 |
-
Version: 2.
|
7 |
Author: Lester 'GaMerZ' Chan
|
8 |
Author URI: http://lesterchan.net
|
9 |
Text Domain: wp-pagenavi
|
3 |
Plugin Name: WP-PageNavi
|
4 |
Plugin URI: http://lesterchan.net/portfolio/programming/php/
|
5 |
Description: Adds a more advanced paging navigation to your WordPress blog
|
6 |
+
Version: 2.92
|
7 |
Author: Lester 'GaMerZ' Chan
|
8 |
Author URI: http://lesterchan.net
|
9 |
Text Domain: wp-pagenavi
|