Advance Pagebar

Description:

Pagebar adds a nice page bar to your blog posts, multipaged posts

Features:

* Optional automatic insertion if page on all post pages (blog, search, tags, …)

* Full control of pagebar by manual insertion into the templates.

* Better pagination for multipaged posts and pages

* “Display all” link for multipaged posts.

* Extremely customizable.

* Compatible with WordPress v2.9, 3.01 and WordPress nightly.

Installation:

* 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 “advance-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

- manual

+ 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:

- Front of postings

- Behind postings

- Footer

+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:

<div>

<div class=”alignleft”><?php previous_comments_link() ?></div>

<div class=”alignright”><?php next_comments_link() ?></div>

</div>

(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();`

* Upgrading from earlier versions

Important: the old “pagebar()” function has been renamed to “postbar()” since this seems to describe its function better. Nevertheless the old “pagebar()” function is and will be an alias.

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).<br/>

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.

FAQ’s:

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, “&lt;” 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, “&gt;” 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?</td>

+ Stylesheet

You can define the necessary CSS definitions in two places:

- in the style.css file of the current theme

- in a seperate file in the current theme’s directory. The name of the file can be defined here.

– 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:

- Front of postings -> Front of first posting

- Behind postings -> After the last posting

- Footer -> In the footer (footer.php)

(If “Automatic insertion” is not selected these options are disbled.)

+ Integration

You can remove the standard wordpress navigation manually or by setting the “remove old navigation” checkbox.

Remove&nbsp;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&nbsp;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

2.) How do I center pagebar?

Simply edit style.css, pagebar.css, or whatever CSS file your defintions are stored:

.pagebar {

text-align: center;

}

Like the plugin?

If you are impressed with the plugin and would like to give back, here are some ways you can support this plugin:

  • Rate this plugin 5 stars in WordPress Plugin Directory.
  • Buy me a cup of coffee or two.
  • Spread the word about my plugin by writing about it on your blog, tweeting, digging, stumbling, etc.

Download:

Donations (Thank you!):

All donors giving $75 or more will automatically get a do-follow link on this list (this page is PR5!) for 180 days! It’s my way of saying, “Thank you for your generous support”. (need more reasons to donate?)

If you are going to donate $75 or more please mail to 111plugins@gmail.com with your donation details so that I can put your link on this page in the donors section.

Donors:

Bob form blogform-4/24/2010

Chetan form Vitbuzz -5/29/2010


Related Posts Plugin for WordPress, Blogger...

Incoming search terms:

Leave a Reply