This plugin hasn’t been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

This plugin has been closed and is no longer available for download.

Genesis Single Post Navigation

Description

This small and lightweight plugin adds next & previous navigation links on single posts to have some kind of a browse post by post nav style. Using the WordPress core function for previous and next post links these links only appear on single posts. The browsing is chronological. Some blog authors prefer to have such a style to offer their readers some feeling of “book reading…” So the plugin might add some nice effect :). Styling with CSS is possible, please see under FAQ here!

In the css file a Media Query setting was added to avoid the display of these browse links on screens/ viewports with a width smaller than 1100px. You can edit/override this easily via a custom CSS file in your child theme folder, see FAQ.

Finally, since version 1.4+ of the plugin you can reverse the link & arrow direction via defining a little constant in your child theme. Please see the FAQ section here for more info on that.

Also since version 1.4+ of the plugin you can customize the possible parameters of the previous/next post links – these are the same parameters the WordPress functions offers :-). Again, please see FAQ section here for more info on that!

Please note: This plugin requires the Genesis Theme Framework.

Localization

A plugin from deckerweb.de and GenesisThemes

Feedback

  • I am open for your suggestions and feedback – Thank you for using or trying out one of my plugins!
  • Drop me a line @deckerweb on Twitter
  • Follow me on my Facebook page
  • Or follow me on +David Decker on Google Plus πŸ˜‰

More

Plugin Links

Donate

Enjoy using Genesis Single Post Navigation? Please consider making a small donation to support the project’s continued development.

Translations

  • English – default, always included
  • German (de_DE): Deutsch – immer dabei! Download auch via deckerweb.de
  • For custom and update-secure language files please upload them to /wp-content/languages/genesis-single-post-navigation/ (just create this folder) – This enables you to use fully custom translations that won’t be overridden on plugin updates. Also, complete custom English wording is possible with that as well, just use a language file like genesis-single-post-navigation-en_US.mo/.po to achieve that (for creating one see the following tools).

Easy plugin translation platform with GlotPress tool: Translate “Genesis Single Post Navigation”…

Note: All my plugins are internationalized/ translateable by default. This is very important for all users worldwide. So please contribute your language to the plugin to make it even more useful. For translating I recommend the awesome “Codestyling Localization” plugin and for validating the “Poedit Editor”, which works fine on Windows, Mac and Linux.

Screenshots

  • Adding browse next & previous links to single posts of Genesis-powered blogs - 1st example: included default style for light backgrounds
  • Adding browse next & previous links to single posts of Genesis-powered blogs - 2nd example: user customized stylesheet for dark backgrounds

Installation

  1. Upload genesis-single-post-navigation folder to the /wp-content/plugins/ directory — or just upload the ZIP package via ‘Plugins > Add New > Upload’ in your WP Admin
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Visit any single post of your site or blog to see the browse links on the left and right side …
  4. Please note: This small and lightweight plugin has no options page – just activate and you’re good to go :-).
  5. Administrators also note: there’s a help tab on Genesis settings with info & links :).

Own translation/wording: For custom and update-secure language files please upload them to /wp-content/languages/genesis-single-post-navigation/ (just create this folder) – This enables you to use fully custom translations that won’t be overridden on plugin updates. Also, complete custom English wording is possible with that, just use a language file like genesis-single-post-navigation-en_US.mo/.po to achieve that (for creating one see the tools on “Other Notes”).

FAQ

The link styles don’t fit to my site and/or are invisible – what should I do?

Don’t panic. It’s just some css styling – look at the next questions on how you can edit this. Thank you!
(The plugin comes only with one pre-defined style so it cannot fit with any site by default. Thank you for your understanding!)

Can I change the color of the links and/or the link hover behaviour?

Yes, you can!

First alternative: Just look in the packaged CSS file single-post-navigation.dev.css to find out the CSS selectors and rules and then override them via your child theme. In most cases you then have to apply them by adding an !important to the appropiate rule.

Second alternative (HIGHLY recommended!):

(1) Add a stylesheet file gspn-additons.css to your active child theme’s root folder and you’re done. It will be automatically enqueued after the packaged plugin styles so you are able to override them.

(2) To not use the packaged plugin stylesheet at all just add your full own custom GSPN stylesheet gspn-styles.css to your active child theme’s root folder and you’re done. This will be properly enqueued then and NOT the plugin file.

Both ways are really easy and update-secure. Enjoy!

Can I remove or change the styling of the tiny border lines?

Yes, of course! Just the same procedure as above! Look for the documented style settings in the css file. – The alternative via extra .css files is always recommended πŸ™‚

Can I adjust the media query for another display size (or even various sizes) because my site or content width is bigger/ smaller?

Again, that’s possible! Just the same procedure as above! Look for the documented style settings in the css file. – The alternative via extra .css files is always recommended πŸ™‚

Can I swap/reverse the direction of the browsing links?

Finally, this is now possible since version 1.4+ of the plugin :). You only have to add one little line of code (a constant) to the functions.php file of your child theme or a functionality plugin. (Only add this if you really want to change the direction of the links & arrows, if not then just DO NOT add it!) Please add the following code:

/**
 * Genesis Single Post Navigation: Reverse link direction
 */
define( 'GSPN_REVERSE_LINK_DIRECTION', TRUE );

Please note: This leads to changing the general direction of the links, really book-like (“next post link” on the right side, “previous post link” on the left side). It also will lead to reversed arrows (the linked strings)!

Can I customize the link string, set to only in the same category and can I exclude categories?

Yes, this is now possible since version 1.4+ of the plugin via custom filters which you can add to your functions.php file of the current theme or child theme. — There’s one filter function for each of the two – “previous post link” and “next post link”:

Changing parameters for “previous post link”:

add_filter( 'gspn_previous_post_link', 'custom_gspn_previous_link' );
/**
 * Genesis Single Post Navigation: Add custom filters for "previous post link"
 */
function custom_gspn_previous_link() {

    $args = array (
        'format'                => '%link',     // Change link format (default: %link)
        'link'                  => '»',   // Change link string (default: »)
        'in_same_cat'           => FALSE,       // Apply only to same category (default: FALSE)
        'excluded_categories'   => ''           // Exclude categories (default: empty)
    );

    previous_post_link( $args['format'], $args['link'], $args['in_same_cat'], $args['excluded_categories'] );
}

You can also get this code from GitHub Gist here // See also WordPress codex for info on the four possible parameters…

If you reversed the link direction (see above FAQ entry) you might change the link string here to: «

Changing parameters for “next post link”:

add_filter( 'gspn_next_post_link', 'custom_gspn_next_link' );
/**
 * Genesis Single Post Navigation: Add custom filters for "next post link"
 */
function custom_gspn_next_link() {

    $args = array (
        'format'                => '%link',     // Change link format (default: %link)
        'link'                  => '«',   // Change link string (default: «)
        'in_same_cat'           => FALSE,       // Apply only to same category (default: FALSE)
        'excluded_categories'   => ''           // Exclude categories (default: empty)
    );

    next_post_link( $args['format'], $args['link'], $args['in_same_cat'], $args['excluded_categories'] );
}

You can also get this code from GitHub Gist here // See also WordPress codex for info on the four possible parameters…

If you reversed the link direction (see above FAQ entry) you might change the link string here to: »

Can I customize the tooltip output?

Yes, this is possible since plugin version 1.5 or higher. There are 4 filters available:

gspn_filter_previous_post_string

  • Default value: Previous post:
  • Example code:

    add_filter( ‘gspn_filter_previous_post_string’, ‘custom_gspn_filter_previous_post_string’ );
    /** Genesis Single Post Navigation: Custom Previous Tooltip String */
    function custom_gspn_filter_previous_post_string() {
    return __( ‘Custom previous post:’, ‘your-child-theme-text-domain’ );
    }

gspn_filter_next_post_string

  • Default value: Next post:
  • Example code:

    add_filter( ‘gspn_filter_next_post_string’, ‘custom_gspn_filter_next_post_string’ );
    /** Genesis Single Post Navigation: Custom Next Tooltip String */
    function custom_gspn_filter_next_post_string() {
    return __( ‘Custom next post:’, ‘your-child-theme-text-domain’ );
    }

gspn_filter_previous_post_tooltip
(the whole tooltip, including get_adjacent_post() function!)

  • Default value: ‘Previous post:’ PLUS title of previous post
  • Example code:

    add_filter( ‘gspn_filter_previous_post_tooltip’, ‘custom_gspn_previous_post_tooltip_output’ );
    /** Genesis Single Post Navigation: Custom Previous Tooltip Output */
    function custom_gspn_previous_post_tooltip_output() {
    $gspn_custom_previous_data = get_adjacent_post( false, ”, true );
    $gspn_custom_previous = __( ‘Custom previous post:’, ‘your-child-theme-text-domain’ ) . ‘ ‘ . esc_attr( get_the_title( $gspn_custom_previous_data ) );
    return $gspn_custom_previous;
    }

Note, for parameters of the get_adjacent_post() function, see the WordPress Codex

gspn_filter_next_post_tooltip
(the whole tooltip, including get_adjacent_post() function!)

  • Default value: ‘Next post:’ PLUS title of next post
  • Example code:

    add_filter( ‘gspn_filter_next_post_tooltip’, ‘custom_gspn_next_post_tooltip_output’ );
    /** Genesis Single Post Navigation: Custom Next Tooltip Output */
    function custom_gspn_next_post_tooltip_output() {
    $gspn_custom_next_data = get_adjacent_post( false, ”, false );
    $gspn_custom_next = __( ‘Custom next post:’, ‘your-child-theme-text-domain’ ) . ‘ ‘ . esc_attr( get_the_title( $gspn_custom_next_data ) );
    return $gspn_custom_next;
    }

Note, for parameters of the get_adjacent_post() function, see the WordPress Codex

Final note: If you don’t like to add your customizations to your child theme’s functions.php file you can also add them to a functionality plugin or an mu-plugin. This way you can also use this better for Multisite environments. In general you are then more independent from child theme changes etc.

All the custom & branding stuff code above can also be found as a Gist on Github: https://gist.github.com/2964538 (you can also add your questions/ feedback there πŸ™‚

Reviews

for framework

Sorry, you can’t activate unless you have installed the Genesis Framework

Read all 2 reviews

Contributors & Developers

“Genesis Single Post Navigation” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.5 (2012-06-21)

  • New features:
    • NEW: Added tooltip display for the arrows, containing the title of the next/ previous post.
    • UPDATE: Improved changing of browsing direction via constant: now the browsing direction is reversed and also natively the direction of both arrows! (Just add: define( 'GSPN_REVERSE_LINK_DIRECTION', TRUE ); to your child theme to achieve this!)
    • NEW: Added own action hook for enqueueing own plugin or custom user stylesheets!
    • NEW: If a GSPN stylesheet file gspn-styles.css is found in your active child theme’s root folder, this will be the used stylesheet – if it’s not there, the packaged plugin stylesheet is being used! This is really handy, if you need to enqueue your own stylesheet and nothing else (i.e. for Multisite purposes…). All update-secure and really easy to handle!
    • NEW: Possible user style additions, additional to the plugin’s default stylesheet: if a GSPN stylesheet file gspn-additions.css is found in your active child theme’s root folder it will be added after the plugin’s default. This way you can add some more rules or override existing selectors/rules. Again, all update-secure and really easy to handle!
    • NEW: Default plugin stylesheet now compressed/minified for improved performance. (To see the un-compressed stylesheet, just open the packaged bonus file single-post-navigation.dev.css)
    • NEW: Added help tab on Genesis admin settings page.
  • Other stuff, maintenance:
    • REMOVED: Removed the update nag message as it was annoying to some users and is no longer needed, because you can use your own stylesheet now, or enqueue additional user styles via our action hook! All in all the new way is more user-friendly, future-proof and using best practices. Enjoy!
    • UPDATE: Simplified Genesis detection on installation, making it much more future-proof and user-friendly.
    • CODE: Minor code improvement: hooked loading call for textdomain into init hook for fullfilling standard
    • CODE: Beside new features, minor code/documentation tweaks and improvements.
    • UPDATE: Changed textdomain from ‘gspn’ to ‘genesis-single-post-navigation’ (= plugin slug!) to fullfill proper WordPress standard and to prepare for upcoming language packs.
    • UPDATE: Updated and improved documention of readme.txt file here.
    • UPDATE: Updated German translations and also the .pot file for all translators!
    • UPDATE: Extended GPL License info in readme.txt as well as main plugin file.
    • NEW: Easy plugin translation platform with GlotPress tool: Translate “Genesis Single Post Navigation”…

1.4 (2012-01-07)

  • Finally: Added possibility to reverse the link direction via a constant added to the child theme – please see FAQ section here for more info
  • Added filters to the plugin which allow now to change the parameters for “previous post link” and “next post link” – all of the 4 parameters for the WordPress template tags/functions could be used – please see FAQ here here for more infoNote: This requires v1.4 or higher of this plugin!
  • General code tweaks, also improved code documentation for newly added filters
  • Added new rules for the customizations to CSS file, improved documentation and code standards
  • Added plugin resource links on plugin list page
  • Enhanced and improved readme.txt file with more info, documention and FAQ entries for customizing the parameters
  • Updated German translations and also the .pot file for all translators!

1.3 (2011-12-14)

  • Fixed possible enqueue issue with stylesheet: replaced deprecated hook with new standard.
  • Updated German translations and also the .pot file for all translators!
  • Tested & proved compatibility with WordPress 3.3 final release πŸ™‚

1.2 (2011-09-30)

  • Optimized CSS3 Media Query: only display the links for displays of 1100px width or bigger
  • Added checks for activated Genesis Framework and its minimum version before allowing plugin to activate
  • Added plugin update nag in WP Admin with advice for existing CSS customizations to be backuped/saved
  • Added localization for the whole plugin, which is pretty much the plugin description section and all messages in WP Admin
  • Added German translations (plus English included by default)
  • For translators: added .pot file to the download package (gspn.pot in /languages/)
  • Improved and documented plugin code
  • Tested & proved compatibility with WordPress 3.3-aortic-dissection πŸ™‚

1.1 (2011-07-14)

  • Added CSS3 Media Query to load only for bigger displays/ viewports
  • Optimized and documented the stylesheet

1.0 (2011-07-01)

  • Initial release