Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/scribu/wp-smarter-navigation

A WordPress plugin that generates previous & next post links based on referrer.
https://github.com/scribu/wp-smarter-navigation

wordpress

Last synced: 3 months ago
JSON representation

A WordPress plugin that generates previous & next post links based on referrer.

Awesome Lists containing this project

README 

        
=== Smarter Navigation ===

Contributors: scribu, versusbassz

Tags: navigation, previous, next, referrer

Requires at least: 3.2

Tested up to: 3.5

Stable tag: 1.4

License: GPLv2 or later

License URI: http://www.gnu.org/licenses/gpl-2.0.html



Generates more specific previous / next post links based on referrer.



== Description ==



When displaying a single post, you might want to show links to the previous and next posts in the same category.



That's fine; WordPress let's you do this with `previous_post_link()` and `next_post_link()`.



But what if that post is in multiple categories?



What if the user came to that post from a tag page or from an author page? Wouldn't it make more sense to display previous / next posts from that particular set?



Well, you can do this with a similar pair of functions, provided by this plugin: `previous_post_smart()` and `next_post_smart()`.



Here's how it works:



Whenever a visitor goes to an archive page (category, tag, date, author, search etc.), the plugin notes which archive it is in a browser cookie.



Then, if the visitor goes to a single post from that archive page, the plugin generates the prev / next links based on the information in the cookie.



Links: [Plugin News](http://scribu.net/wordpress/smarter-navigation) | [Author's Site](http://scribu.net)



== Installation ==



1. Unzip the archive and put the folder into your plugins folder (/wp-content/plugins/).

1. Activate the plugin from the Plugins admin menu.



= Basic usage =



Go to your theme directory and open single.php.



Replace 



`previous_post_link(` with `previous_post_smart(` 



and



`next_post_link(` with `next_post_smart(`



= Referrer link =



If you also want to display a link back to the list of posts, add this line (also in single.php):



``



= Posts with multiple categories =



If you want for example to [higlight the category](http://wordpress.org/support/topic/366588) that the user came from, you can use `get_referrer_category()` to retrieve the category object.



For further reference, all the template tags are located in [smarter-navigation/template-tags.php](http://plugins.trac.wordpress.org/browser/smarter-navigation/trunk/template-tags.php).



== Frequently Asked Questions ==



= "Parse error: syntax error, unexpected..." Help! =



Make sure your host is running PHP 5. Add this line to wp-config.php to check:



`var_dump(PHP_VERSION);`



== Changelog ==



= 1.4 =

* added support for custom taxonomies. props badfeather

* fixed strict standards errors. props badfeather



= 1.3.2 =

* fix case when plugin worked incorrect with pagination



= 1.3.1 =

* fix case when multiple browser tabs are involved

* fix case when multiple posts have the exact same date



= 1.3 =

* store query vars in cookie instead of individual post ids

* fix referer link

* [more info](http://scribu.net/wordpress/smarter-navigation/sn-1-3.html)



= 1.2.1 =

* enable $in_same_cat by default



= 1.2 =

* moved to PHP5 syntax

* added get_referrer_category() and get_referrer_url() template tags

* added $in_same_cat and $excluded_categories arguments to previous_post_smart() & next_post_smart()

* [more info](http://scribu.net/wordpress/smarter-navigation/sn-1-2.html)



= 1.1.2 =

* added $fallback parameter to *_post_smart()



= 1.1.1 =

* better SQL limit



= 1.1 =

* handles posts split on multiple pages

* better behaviour when multiple tabs open

* [more info](http://scribu.net/wordpress/smarter-navigation/sn-1-1.html)



= 1.0 =

* initial release

* [more info](http://scribu.net/wordpress/smarter-navigation/sn-1-0.html)