=== pagebar === Contributors: Lutz Schroeer Donate link: http://elektroelch.de Tags: navigation, navi, page Requires at least: 2.0 Tested up to: 2.3 Stable tag: trunk Adds a nice page bar for selecting indivual pages instead of just the previous or next page. == Description == Pagebar adds a nice page bar for selecting indivual pages instead of just the previous or next page. After activation you have a nice navigation bar instead of the old "Previous page" and "Next page" links: == Features == * Optional automatic insertion of pagebar on all pages (posts, search, tags, ...) * Still full control if pagebar through manual insertion into the template * Works with nearly all plugins (Simple Tags, UTW, ...) * Extremely customisable * Compatible with WP 2.1, 2.2, 2.3 and WP nightly == Installation == * Copy files Unpack the archive and copy the files into a directory called pagebar2 in your plugin directory (normally .../wp-content/plugins/). Copy the file "pagebar.css" into your theme's directory. That's it! * Adding to blog There are two ways of inserting pagebar into you blog: * automatic * manual + Automatic installation If you have a simple blog (e.g. the default theme) you can easily add pagebar by selecting "Automagic insertion" in the options page.Then you can select where you want the pagebar 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 pagebar 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: Of course you may want to configure pagebar to your needs using the option page and by editing the pagebar.css style file. == The option page == The option page allows you to tweak the pagebar to your needs. There are a number of predefined layouts which you can import. -- Display -- + Left Number of links displayed on the left of the bar. if this number is 0 no left links are displayed at all (see figure xxx). + Center The number of links displayed in the middle of the bar (2). This should be an odd number. If an even number is entered, pagebar will display one more link than entered. + Right Number of links displayed on the left of the bar. if this number is 0 no left links are displayed at all (see figure xxx). + Leading text Text to be displayed in front of the bar. A space is automatically added after the text. + 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. -- Tooltips -- + Tooltips Text to display in tooltips. You can use the tokens. + Display Actually display tooltips? -- 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 ("« Previous entry", "Next entry »"). 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 disbled.) -- 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, too. == 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 == Credits == * Lester Chan for his initial idea for this plugin * Michael Preuß for his "rel=nofollow" suggestion and for telling me not to include it! * Moniko TS for making me aware of the multiple loops problem. * Mike of trash-wissen.de for pointing out the feed problem.