WP-Footnotes (a plugin for WordPress)

Trying to figure out how to use the WordPress Footnotes plugin? You've come to the right place. If you've got feedback send it in »

Feature requests and bug reports should be recorded on the WordPress Plugins Trac system (make sure you select wp-footnotes as the component).

Installation

  1. Download it from the official WordPress Plugin Repository.
  2. Upload the footnotes folder and all it's contents to the /wp-content/plugins/ directory
  3. Activate the plugin through the 'Plugins' menu in WordPress.
  4. You're good to go!

Usage

Creating a footnote is dead simple, just include it with double parentheses ((Your very own footnote!)), like that. With the WP-Footnotes plugin enabled the previous sentence will end up looking like this:

Creating a footnote is dead simple, just include it with double parentheses ((Your very own footnote!)), like that.

Important note: Make sure you include a space before your opening double parentheses! or the footnote won't work ((This was a deliberate decision made when writing the second version of footnotes (v0.9) so that if WP-Footnotes was to stop working for some unholy reason, it wouldn't end up looking((really silly)), but only ((kind of silly)).)).

Old School

Back in the day when the very first version of WP-Footnotes was released the mark-up used was a little different. If you're one of those people who was around back then, rest assured that an upgrade won't make your posts using the old mark-up look totally stupid. In fact they will look exactly as they're supposed to, footnotes and all ((Yes, that means you can, if you like, continue using the old mark-up <footnote>like this</footnote>.)).

Options

You have a fair few options to do with how the identifier links ((That's the little number bit.)), footnotes and back-links look which can be found in the WordPress admin area under Settings » Footnotes. Most of the options are fairly self explanatory.

Other Features

Paginated Posts

Some of you seem to like paginating post, which at this point is kind of problematic. By default each page of your post will have it's own set of footnotes at the bottom and the numbering will start again from 1 for each page.

At this point the only way to get around that ((This problem could be solved much more elegantly if WordPress provided one or two more filter hooks for manipulating the post content at different points in the stack.)) is to know how many posts are on each page and tell WP-Footnotes what number you want the list to start at for each of the pages. So at some point on each page ((That is, between each <!--nextpage--> tag.)) you need to add a tag to let WP-Footnotes know what number the footnotes on this page should start at. The tag should look like this <!--startnum=5--> where "5" is the number you want the footnotes for this page to start at.

Referencing

Sometimes it's useful to be able to refer to a previous footnote a second (or third, or fourth...) time. To do this, you can either simply insert the exact same text ((Like this.)) as you did the first time ((Like this.)) and identifier should simply reference the previous note. Alternatively, if you don't want to do all that typing again, you can construct a footnote like this: ((ref:1)). and the identifier will reference the footnote with the given number ((Even though it's a little more typing, using the exact text method is much more robust. The number referencing will not work across multiple pages in a paged post (but will work within the page). Also, if you use the number referencing system you risk them identifying the incorrect footnote if you go back and insert a new footnote and forget to change the referenced number.)).

Download

Download it from the official WordPress Plugin Repository.