Pagebar adds a nice page bar to your blog posts, multipaged posts and paged comments.
Pagebar adds a nice page bar to your blog posts, multipaged posts and paged comments:
The option page is devided into three tabs (postbar, multipagebar, commentbar) for the three different pagebar types. You need to have Javascript enabled in your browser for the option page to work! They all share some basic settings and got some specific settings, explained in the next chapters.
— Shared basic settings —
Left
Number of links displayed on the left of the bar. If this number is 0 no left links are displayed at all.
Center
The number of links displayed in the middle of the bar. This should be an odd number. If an even number is entered, pagebar will display one more link than entered. If this number is 0 no left links are displayed at all.
+Right
Number of links displayed on the right of the bar. if this number is 0 no right links are displayed at all.
Leading text
Text to be displayed in front of the bar. A space is automatically added after the text. You can use the tokens in this field.
Standard page
Text to be displayed on all pages but the current. You can use the tokens.
Current page
Text to be displayed on the current page. You can use the tokens.
First page
Text to be displayed for the first page.
Last page
Text to be displayed for the last page.
Connector
Text to be displayed between the left/center and center/right area. If left empty, “…” is displayed.
Previous
Text to be displayed for the link to the previous page. If left empty, “<” is displayed. You can additionally define if the Previous link is always displayed, never displayed or if it is done automatically.
Next
Text to be displayed for the link to the previous page. If left empty, “>” is displayed. You can additionally define if the Next link is always displayed, never displayed or if it is done automatically.
Tooltip text
Text to display in tooltips. You can use the tokens.
Display
Actually display tooltips?
Stylesheet
You can define the necessary CSS definitions in two places:
— Specific pagebar settings —
Automatic insertion
If you would like to get pagebar inserted in the blog automatically you need to select this option and additionally the position where to insert pagebar (see next section).
Positioning
If you have selected automatic insertion you can select where to insert the pagebar:
Integration
You can remove the standard wordpress navigation manually or by setting the “remove old navigation” checkbox.
Remove standard navigation: Remove the standard navigation text of WordPress. This only works if the author of your currently used theme hasn’t changed the CSS class of the standard navigation (“.navigation” that is).
(If “Automatic insertion” is not selected these options are disabled.)
— Specific multipagebar settings —
Inherit settings
If you check this option all basic options will be inherited from the postbar settings. Additionally all these options are removed from the multipagebar settings tab.
All pages link
pagebar gives you the possibility to display all parts of a multipaged post. Checking this setting will add a link behind the pagebar allowing the user to display all parts.
All pages label
Text display for the “All pages link”.
— Specific commentbar options —
+Inherit settings
If you check this option all basic options will be inherited from the postbar settings. Additionally all these options are removed from the commentbar settings tab.
— Tokens —
Tokens can be used in any display area of pagebar. If it makes sense where you want to use it, you have to decide by yourself.
{page} -> Page number
{total} -> Total number of pages
{current} -> Current page number
Since v2.60 pagebar contains some actions: pagebar_before/pagebar_after, postbar_before/postbar_after, multipagebar_before/multipagebar_after,
commentbar_before/commentbar_after:
[pagebar_before]
“>
[postbar_before]
1 2 3 4 5 6 7 8 9
[postbar_after]
[pagebar_after]
Make sure you have PHP 5 installed, which is required for this plugin!!!
Copy files
Unpack the archive and copy the files into a directory called “pagebar” in
your plugin directory (usually …/wp-content-plugins/). Copy the file “pagebar.css”
into your themes directory or copy the content to the theme’s “style.css” file.
Adding postbar to your blog posts
There are two ways of inserting postbar into you blog:
Automatic installation
If you have a simple blog (e.g. the default theme) you can easily add postbar by selecting �Automagic insertion� in the options page. Then you can select where you want the postbar to appear:
+Manual installation
If the automatic insertion is not suitable for your blog because your theme has more than one posting loop you can add postbar manually to your blog by editing some of your themes files. Simply add the following code directly behind The Loop in your index.php and search.php:
if (function_exists('postbar')) postbar();
Of course you may want to configure postbar to your needs using the option page and by editing the pagebar.css style file.
Adding pagebar to your multipaged posts
This pagebar can not be displayed automatically so you have to edit the file “page.php”. If your theme contains the standard navigation for multipaged posts you first have to delete the following code:
wp_link_pages(array('before' => '<p><strong>' . __('Pages:', 'kubrick') . '</strong> ', 'after' => '</p>', 'next_or_number' => 'number'));
(The code does not have to look necessarily exactly the same, this example is from the WordPress default theme.) Then you can add the multipagebar to your pages:
if (function_exists('multipagebar')) multipagebar();
You can customize the display of your multipagebar by editing the settings in the Multipagebar tab on the pagebar option page.
Adding pagebar to your paged comments
This pagebar can not be added automatically (there is no action indicating the end of the comment loop) so you have to edit the file “comments.php”. If your theme contains the standard navigation for paged comments you first have to delete the following code:
(The code does not have to look necessarily exactly the same, this example is from the WordPress default theme.) Then you can add the commentbar to your pages:
if (function_exists('commentbar')) commentbar();
pagebar v2.5+ introduces a new database structure for its settings. Formerly there was only one entry in “wp_options” called “pagebar”. Since there are now three different pagebars (“postbar”, “commentbar” and “multipagebar”), the options are splitted into three entries (“postbar”, “commentbar” and “multipagebar” respectively).
After installation (either through WordPress update or manually per FTP) pagebar copies the settings stored in “pagebar” to the new “postbar” entry and sets “commentbar” and “multipagebar” to inherit the settings so everything should look fine without manual interference. The “commentbar” and “multipagebar” have to be installed manually though.
Simply edit style.css, pagebar.css, or whatever CSS file your defintions are stored:
.pagebar {
…
text-align: center;
…
}
*fixed: non administrators could change settings
Added Belarussian translation. Thanks to Ilya of www.fatcow.com