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 my bug tracking site.

Installation

Upload the footnotes folder and all it's contents to the /wp-content/plugins/ directory
Activate the plugin through the 'Plugins' menu in WordPress.
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¹, like that.

Important note: Make sure you include a space before your opening double parentheses! or the footnote won't work².

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³.

Options

You have a fair few options to do with how the identifier links⁴, footnotes and back-links look which can be found in the WordPress admin area under Options » 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⁵ 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⁶ 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⁷ as you did the first time⁸ 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⁹.

Download

Download it from the official WordPress Plugin Repository.

Feedback and other stuff

WP-Footnotes (v1.0.x) has been tested in a fairly limited set of use-cases¹⁰. It has not been specifically tested for compatibility with any other WordPress Plugins^{these plugins.">11}. I absolutely welcome bug reports, feature requests and other feedback and intend to roll bug fixes into new releases fairly rapidly¹².

WP-Footnotes is free software licensed under the GNU-GPL. You are welcome to redistribute WP-Footnotes under certain conditions. WP-Footnotes comes with ABSOLUTELY NO WARRANTY.

Your very own footnote! [↩]
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)). [↩]
Yes, that means you can, if you like, continue using the old mark-up
```
<footnote>
```
like this
```
</footnote>
```
. [↩]
That's the little number bit. [↩]
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. [↩]
That is, between each
```

```
tag. [↩]
Like this. [↩]
Like this. [↩]
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. [↩]
Specifically, only WordPress 2.1.1 and 2.1.2. [↩]
Although I haven't yet had any problems on this website with these plugins. [↩]
Much more rapidly than in the past. [↩]

Comments

How do you activate the smooth scroll feature?

Hi Christian. The latest release of the plugin doesn't include the smooth scroll feature, sorry.

Hey, does this work for WP2.7? I wish I had discovered this plugin earlier!

Thanks so much for a great plug-in! I just installed it and it seems to work fine - very useful.

-- David

Hi there, this is an absolutely great plugin！It looks so simple yet elegant. Thanks for your effort.

Just installed it and it works fine. The idea with the double parentheses doesn't conflict with any other plugins. Well done!

Brilliant plugin, exactly what I was looking for. Thanks!

I am experiencing a bug. In Wordpress plugin section, I have this message:

blockquote>Warning: Invalid argument supplied for foreach() in /membri/deviantdark/wp-content/plugins/wp-footnotes/footnotes.php on line 259

This happens with version 3.2 and 3.3. How should i fix it? Thanks :)

So does this work with 2.7?

This is AWESOME! I just got it to work after reading this page for the first time. It's beaaaaaaaaautiful. Thanks for creating this! I'm so happy...

Oh, by the way, this is my first post with the plugin showing how great it is!!!

I doubt I'm the only one to have encountered this because the problem is reproducible every time. Assume you have some content in a WP editor window and you want to use it in another post. You'd create a new post and paste the content in there and publish, wouldn't you? Well, by doing this, the underlying space characters are lost, footnotes can't find them and no footnotes appear. Instead your content contains all the text in your footnotes in double parentheses ((like so)). How ugly! Anyway, after some playing around, I've found a workaround which isn't ideal but will serve for now. I'm not sure if you need the Tiny MCE Advanced plugin or whether it's part of the WP distribution but look for a button entitled 'Paste as plain text'. Use that to paste any content where you want to keep your footnotes and they should appear correctly when you next publish. Needless to say, it's not perfect, and if you've used any text formatting in your post, that needs to be re-applied. If it's quicker to retype the footnotes, do that. If it's quicker to re-apply the formatting do that, but it seems you can't have your cake and eat it. (That'd just be silly wouldn't it?).

Cheerio.

Pete.

Hi Pete,

Thanks for the comment. Unfortunately, there's not much I can do about that from a plugin perspective. It's just TinyMCE/WordPress behaving badly. Sorry.

It appears that WP-Footnotes does not support nesting of footnotes. For example:

I want to reference this ((this first footnote also needs a footnote ((because sometimes things get complicated)) ))

Do you think you'll support this in a future version?

Also, referencing does not appear to work (See: http://andrewferguson.net/2008/12/31/year-end-zeitgeist/)

Hello ! It's a very good plugin...! But I have a difficulty : I want to insert a shortcode before notes (in "before" options). Options accept HTML code, but not shortcode or php. It will be possible ? One a big thank you !

Hiya, great plugin! Thanks. Is there a way to turn off the identifyer arrows in the footnote list? Many of my posts aren't long enough to really need them. Or I could change the arrow to the word "locate," but I think that removing the arrow would be best.

Cheers and thanks! Dainis

Hi Dainis, There sure is. Just remove the text from those options on the plugin's options page.

Hi, First, sorry about my English, than;

That's really cool plugin, but I've a problem with it. When I insert foot notes on a paginated post, and, if I were on, for example, 5. page, and I clicked on a footnote, the page was reloading, and directly went to the first page... 'cause I've seen that footnote link (for example) "post_134/#footnote_3_4", but the paginated post's link is on browser, "post_134/4/"... There's missing page number...

Is there any idea about that?

Great plugin!

Unfortunately, the WP-Footnotes plugin is creating a conflicting with another plugin (articles2pdf), where the footnotes are not being correctly displayed (this is a problem with the other plugin).

Therefore, could you please tell me what action/filter I need to call to disable this plugin on specific PHP page?

Thanks in advance,

Mitul

Hi Simon,thanks for your nice work.

But after I activate the WP-Footnotes I got the following error message:

Warning: Cannot modify header information - headers already sent by (output started at F:2.WorkShop0.Virtual OSxampplitehtdocswordpresswp-contentpluginswp-footnotesfootnotes.php:1) in F:2.WorkShop0.Virtual OSxampplitehtdocswordpresswp-contentpluginssubscribe-to-commentssubscribe-to-comments.php on line 817

I really want to have this plugin work, can you help me? Thanks very much.

In the settings page, I see the following error:

Warning: Invalid argument supplied for foreach() in [[My webosite root]]/root/wp-content/plugins/wp-footnotes/footnotes.php on line 258

i don't know how to use it. i can't

thank emeğe sayğı paylaşımlar için tşk

Perfect--thanks. BTW, any chance a footnote can be added to the title of a post?

hi. Thank you for become available.

Hi Simon,

I find it rather annoying that the superscript footnotes are the same size as normal text. It makes every line with a footnote stand out. Where is the parameter I need to change in order to fix this? Thanks alot.

Hi folks. I'm aware there are a few questions backing up here. Sorry, I've been flat out at my new job (and still am). Here are some quick attempts at answers.

@must That's a known limitation of the current version. Hopefully I'll get time to address that in a future version, sorry.

@Mitul Hopefully you've already figured out a solution. If not, I'm afraid I can't be of much help - I just don't have the time right now, sorry.

@jecoso I'm not sure what the problem is there. I'll have to investigate further when I get the time and see if I can fix whatever the bug is in the next version.

@Dion I'll look into it when I get the chance.

@storyteller Have you read the instructions?

@Howie That would be totally possible with a small modification, but I probably won't consider it as a feature since it would break the vast majority of themes.

@Luca You'll need to learn a little bit of CSS. I'd suggest you look into the line-height property.

Thank you very much! It works fine if I increase 'line-height' from 1.4em to 1.8em. But by doing so, I ruin the layout as a whole. Is there some parameter for the 'superscript font size' too? I've tried ctrl+f-ing the stylesheet already, but I don't know any CSS...

Thanks alot again :)

sup {font-size:10px}

Great Plugin! What about highlighting the footnote as it is practiced at Wikipedia?

Hi Nick,

Thanks for the suggestion. You should be able to achieve this just by adding a single line to your CSS file. Try:

.footnotes li:target {background:#aaa;}

Great, thank you very much!

The plug-in still works in WP 2.8 but activating it hoses the Dashboard. (Several other plugins do the same.) Any ideas why?

I'm not sure why that might be, sorry Chris. I'll look into it when I get the chance. Footnotes aren't currently a high priority (clients come first), but I will get to it; the pressure is building.

http://www.cinselseks.com/cinsel-sorunlar

Я думаю, что Вы допускаете ошибку. Могу отстоять свою позицию. Пишите мне в PM, пообщаемся.

the footnotes plugin does not work with the wp-print-plugin. It doesn't show a printable version.

Thanx anyhow!

Очень понравился ваш блог! Подписался на rss. Буду регулярно читать.

I would like to display the footnote content when a user moves his or her mouse to the number superscript link, which I think once worked but no longer does. Does anyone have any suggestions/recommendations?

What a great plugin! Thanks for all the support and info.

Thanks for this amazing Plugin. It works perfect.

To Christiaan:

Just go to http://www.thechetan.com/smoothscrolllinks/ and install this plugin and change footnotes.php lines 215 and 242, in these lines yo'll see anchor links like '' add target="_self" at the end of anchor tag and you'll have like this: '' Smooth effect is done...

Opps sorry i've forget to cancel codes :) '< a href= "'.$id_href.'" id= "'.$id_id.'" class= "footnote-link footnote-identifier-link" title= "'.$id_title.'">' these lines ( 215 and 242 ) will be '< a href= "'.$id_href.'" id= "'.$id_id.'" class= "footnote-link footnote-identifier-link" title= "'.$id_title.'" target= "_self" >'

Thanks ;)

Строительный элемент, соединяющий два узла каркаса, фермы и т. п. Расроложен сообразно диагонали замкнутого контура и обеспечивает жесткость конструкции.

A chto dlya vas vash blog? Vi proffesional’niy blogger ili eto prosto dlya dushi?

hi all,

i am using wp-footnotes and it works very well. there is only one problem: i'm also using "share this"-plugin, which makes a share-link at the end of each post. the footnote displays after the "share this"-link, but I want to have it BEFORE that one. any ideas?

regards, torsten

Thanks for the great plug-in. Is there a way to create a divider line between the post and the footnotes. I tried some different things in css but can't seem to get it to work.

post footnotes

@Torsten - I also use sharethis. if you haven't figured it out yet, go to the sharethis plug-in options and pick 'no' for the options then follow the link to get the code to past the link where you want it (i.e. after your footnotes). Hope that helps. J.

simon, the numbered referencing doesn't work for me ... nor does it with identical content within the (()). Always comes up with additonal numbers. Usind 2.8.4. Is it just me or a general issue?

PS. Am also using WP-Print and would like for it to function with your Footnotes. So I'd appreciate if you could look into that conflict as well.

Thanks for this great plugin. I have a question. The number referencing doesn't work for me. All the footnotes are displayed with bullet points instead of numbers.

Example, instead of 1.Footnote 1 2.Footnore 2 3.Footnote 3

I get bullet points instead of numbers.

Is there a way to correct this. Thanks.

Well, the ((like this)), ((like this)) doesn't work on your site either. 8 and 9 are the same footnote, but they have distinct numbers.

Hello Simon ! Great plugin ! But I have a little problem with it : Before I installed your plugin, I already had this one : Sociable 3.5 (here's the link if it helps http://blogplay.com/sociable-for-wordpress/ ). My problem is that the footnotes appear at the end of my message, just after the sociable icons. And that doesn't suit my-self at all ! Do you have any idea to arrange that little problem so that the footnotes appear before the other plugins activated on the page ? Here is a screen shot of my blog so that you can see what I mean : http://dan-la-prairie.com/image1.png

Thank you very mush and sorry for my horrible English ;)

Ahem... Me again. After looking in the website page of the plugin I talked about earlier, I founded that I could change the place of that plugin with a code in the php sheet of my theme. So every thing is all-right now. Sorry for the disagreement, I should have looked in it before.

So, again, thank you for your awesome plugin !

@unglauben I suspect it's a problem with your CSS. Make sure your ol list-style-type property isn't something it shouldn't be.

@Odin This site no longer runs WordPress so, therefore doesn't use this plugin.

@Raven Glad you got it sorted.

Pardon the ignorance, but how does one change the color of the numbers?

I experienced that the plugin do not work when the parentheses are inserted in a post copied from MS word, even when using the advanced tools button "paste from word". Problem solved by inserting the text pure text.

Is there a way to change how long the bubble stays up? Or is this a browser-specific issue? I'd like the Footnote popup to stay open as long as the person hovers over it. Thanks!

@Mark Jones - You'll need to play with the CSS for your theme. However there is a field in the footnotes settings where you can add custom CSS.

@Jegindoe - Thanks for letting us know. Pasting from Word almost always causes problems.

@Atlas Crise - It's browser specific I'm afraid. If you're keen you could look into adding some javascript to your theme. There are JS libraries that can take a title tag and produce a more styled popup on mouseover.

Love from Indonesia

I had been using your wp-footnote before I up grade my WP to the 2.8. It worked great. Unfortunately the wp-foot note doesn't work any more. Do you intend to up date your wp foot note so as to my web site worked as it was used to be

br as

Love this plugin!

Works great ... except the hyperlinks when splitting a post into multiple pages.

I like the fact that on new pages of a particular post, the footnotes start over instead of continuing ... Hovering the mouse over the footnotes pulls up the correct notes ... But, clicking on footnote links always send you to the corresponding footnote number ON THE FIRST PAVE, vice the correct current page.

I'm using WordPress 2.8.5 and the latest plugin for footnotes ...

any help would be appreciated ...

Again, love this plugin.

Richard

Please how to get id = "identifierNO." and id="footnoteNO." from 1 beginning rather than the 0 ?

@Augustine - I do intend to update it one eventually, but it's not a high priority. I'd love to hear from anyone who wants to help maintain the plugin.

@Richard - That a confirmed bug and it should see a fix eventually, but (just incase you were) don't hold your breath, sorry.

@havza - There is a setting on the footnotes setting page where you can change the priority of this plugin compared to the others you run. I'd start there.

@taglife - You would have to change the plugin code to achieve that. You're obviously free to do so, but I probably won't since I don't see any reason to.

For those using Sociable/Share This, simply change the priority order to 8 or 9 rather than the default of 10. This will execute Footnotes before the Sociable/Share This plugin. Footnotes should now appear above the Sociable/Share This link bar.

I tried to change colour of the footnotes (as in Wikipedia) but found this did not work using the CSS text box in the plugin settings -- change needs to be done to CSS file itself.

** A great modifier to this plugin would be some kind of text-friendly code like the (( )) that allows you to place the footnotes at the end of the post. This is because if you are using footnotes, chances are you might also be using a Works Cited list. Currently, footnotes appear at the end of any text. It would be more correct to have them appear Works Cited. If you could simply enter something like <FOOTNOTE block=""> and have that call the footnotes, that would also solve all these issues with end-of-post plugins like Sociable and Share This.

And of course, great plugin... thanks..!

Pardon the ignorance, but how does one change the color of the footnotes