Plugin: pagebar (Used by 10 domains)

Pagebar adds a nice page bar to your blog posts, multipaged posts and paged comments:

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.

The option pages

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:

  • 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 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

Actions

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]

Credits

• Lester Chan for his initial idea for this plugin.
• Lise of liseweb.fr for her French translation.
• Michael Preuß for his ” rel = nofollow ” suggestion and for telling me not to include it!
• Monika TS for making me aware of the multiple loops problem.
• Mike of trash-wissen..de for pointing out the feed problem.
• Joern of diekretschmars.de for his various comments and ideas.
• Marco of mafia-daily.com for pointing out problem with theme editor.
• Thomas (koehntopp.com) for his bug report on name collisions.
• chipmint.com for the new default design
• Borisa Djuraskovic for his Serbian translation
• D. Schilling and B. Kau for their i18n support