Simple Footnotes
This plugin implements basic footnote and endnote functionality for Joomla! articles. It takes footnotes marked within the article text and converts them into HTML anchors.
This plugin was originally derived from a Tips & Notes plugin. I didn’t want my footnotes implemented in CSS and Javascript when Joomla had the power to process them in the backend, so I rewrote it.
Current Version: .1
Version .1 of the footnotes plugin is available from http://joomlacode.org/gf/project/simplefootnotes/frs/.
There is also a feature request and bug tracker system at http://joomlacode.org/gf/project/simplefootnotes/tracker/.
Usage:
Simply place the following marker in the text where a footnote is desired:
{footnote}Put your footnote text here.{/footnote}
The plugin will automagically replace each reference with a sequentially numbered footnote marker (1, 2, 3, and so on) and place the footnote at the bottom of the article.
The plugin also supports endnotes. These are marked this way:
{endnote}Put your endnote text here.{/endnote}
All endnotes, wherever they are placed in the article, are simply moved to the bottom of the article and numbered sequentially. No marker is placed in the text where they were. Note that this is contrary to the typical definition of “endnote,” it was developed because I needed the functionality.
Note: If the article uses a “read more” link, neither footnotes nor endnotes will show up on pages where just the text before the “read more” link is displayed. If an article does not have a “read more” link then notes will show up anywhere the article is displayed.
Further Note: If an article uses pagebreaks to create a multi-page article then footnotes and endnotes will display on whatever page they fall on.
Installation:
- Install the plugin
- Go to your Plugin Manager and enable the plugin
- In Joomla! articles insert footnotes per the instructions above
give a screent shot is doesn’t hurt!!
I don’t quite fully understand how this plugin is supposed to work on the front-end. Is it possible for you to provide a demo?
@Jeff: Unfortunately I don’t currently have the capabilities to provide a demo. But, to appease Eric and help you out, I have added a screenshot of the front-end. Basically it creates an HTML div at the end of the article, gives it a heading of “Footnotes” and places all the footnotes underneath that. Each note in the article text is replaced by an HTML anchor tag that jumps you to the relevant footnote below.
Any chance there’s a version of this for Joomla 1.0 versions?
Nope, sorry…
hi,
this is a great Plugin, but I discovered some strange behaviour:
when displaying the intro of an article on the frontpage, which contains footnotes (in the intro), the footnote-tag is not parsed. It shows {footnote}etc.{/footnote}.
When open the article via click on read more or the tittle, the footnotes work fine.
Actually, here is an example:
What is the reaon for that?
Best regards,
Ricardo Cristof
I there,
I come back with Ricardo’s bug which I need help because I get the some problem. Is there any solution?
Thanks,
It works great. I like it!
@Ricardo: Presumably the Joomla hook that I am using to call the plugin gets processed on page display, but not on front page display. I may look into changing that at some point in the future.
Hey Jim,
it seems to work now! That is really great, thank you very much!
Best regards,
Ricardo Cristof
Just used it for education site with .The educational article becomes more useful with footnotes.
This is great plugin. Thank you very much .Will give it 5 stars on JED .
A request though- it would be nice if the text for the footnote coud be a link to a website.
Thanks once again for a very useful extension!
You should be able to do that. Just include the HTML for the link inside the footnote. Like this: {footnote}<a href=”link.html”>This is my footnote.</a>{/footnote}
Hi,
it’s even easier: simply mark the word/sentence, you want to link and click the “Insert URL”-button.
best regards,
Ricardo Cristof
Ah, good point. I forgot about the WYSIWIG.
Hi, I’ve adapted the plugin for multilingual use: http://podolak.net/en/russian-studies/45-studium/112-simple-footnotes-multilingual
So far html tags () have not worked in footnoted text. Has then been a problem for anyone else?
Greg–they should work. What exactly does your tag look like? Feel free to shoot me an email (using the About page).
Hi,
I have been trying to copy some word documents with endnote & footnotes into Joomla 1.5 but if I take out the formatting from word (clear format) the document width goes all over. If I do it through Text Edit, it looses the footnotes & end notes.
Is your extension going to be able to solve that without manually having to correct it?
This extension does not preserve endnotes and footnotes from word. You will have to put those in manually in the correct spot using the syntax described above.
Do you happen to know how I can accomplish that without doing it manually?
Nope. Word is finicky. Sometimes footnotes copy out correctly, sometimes they don’t. You could try different editors (FCK editor vs. TinyMCE editor vs. other) as they may clean the incoming HTML differently. Joomla! allows you to change the editors via the plugins.
Simple Footnotes definitely won’t do it. It’s designed to easily create footnotes in documents–not import them!
Found the solution!!!!
1. Open Word doc and copy
2. Open Google docs and paste using Command+V
3. Edit html code and delete width, press Update
4. Copy Google doc and paste it in Joomla
:)
Great plugin! would it be possible for you to add a button for editors where you could simply highlight the text you want to footnote, then click the button and the {footnote} {/footnote} would be inserted? Sort of like you see with the page break or read more buttons. Would really speed things up!
Thanks!
-Donald
Good idea. I can give it a go at some point, but it won’t be anytime soon as I’m pretty busy. If you’d like to try, I’d be happy to integrate the code and give you credit.
Believe me I tried, I am now convinced more than ever that I am not much of a coder. I even tried to cobble something together using other plugins based on JC Editor, but no Joy :(
-Donald
I lack a real endnote feture. The endnotes are typically printed separately at the end of a book. In a joomla environment this means that endnotes from many different articles sholud be saved to a single article.
Otherwise this plugin works as expected. For use in non English text you have to change the “inserted headers” footnote and endnote, as well as the word “back”.
Hm… that could be done. Essentially you would specify an article for all endnotes to show up in, and then it would write to that article.
That said, I won’t have time to make that change for quite a while. Hopefully some day…
Ok. But you also have to have an unbroken number serie from more than one article. Thus, the plugin must now the order of the submitting articles so it can sort and count correctly.
The plug-in doesn’t seem to work when I’ve got Uber Page Break working. I’m trying to find a solution that will let me show footnotes, AND have page breaks in K2. Any suggestions for how I can make that happen?
My ISP has updated PHP to version 5.3. As a result, the footnote plg doesn’t work. An update is needed.
(Joomla is not yet fully compatible with the latest php, but the core and most extensions works with error reporting disabled. However footnote doesn’t work at all. The joomla adaptation to new php is only a matter of time. However every single extension has to be checked.)
It does not work with Joomla 1.5.22 but it easily could!
To make it work with this version just remove the last word from file “footnotes.php” in line:
function onBeforeDisplayContent( &$article, &$params, &$limitstart )
- remove $limitstart (the 3rd parameter) and it works just fine.
Great plugin!
Anyone know if this now works with php 5.3+??
Not much hope of development here. The plugin is doomed. Got this message from James Frank:
James Frank
@jamesefrank James Frank
@mibrant01 If you can’t tell, I’m rarely on Twitter. And, unfortunately, no updates. Not doing much Joomla these days.
Now, now, “doomed” is a bit of a strong word. Just because I’m not actively developing it doesn’t mean that it can’t be used. And if a feature’s not there, you’re welcome to contribute or fork the project and add it.