WordPress.org

Usage

• To create a footnote, use [ref]...[/ref] to wrap the text of your note.

  Example: This is footnoted.[ref]This is the text of the of the footnote.[/ref]

• To create a footnote with a specific unique ID, instead of the one that the plugin will automatically generate for you, use [ref name="..."]...[/ref]

  Example: This is footnoted.[ref name="my-unique-id"]This is the note text.[/ref]

• If you define an ID for a footnote, you can also refer back to the same footnote later on in the document, using the [backref name="..."] shortcode.

  This is footnoted.[ref name="source1"]Source 1[/ref]

  So is this.[ref name="source2"]Source[/ref]

  And this one comes from the same source as the first.[backref name="source1"]

• To force the plugin to display notes at a different location instead of at the bottom of the post, use [references/]

  Example:

  This is footnoted.[ref]Text[/ref]

  As are some[ref]Text[/ref] other things.

  [references/]

  See also: Endnotes.

• If you wish to change how footnotes are styled, you can alter them in your WordPress theme stylesheet, or using JavaScript. The default elements and classes are <a class="footnoted"> for superscript links to footnotes,

<

ol class="footnotes"> for the list of references, and

    ol.footnotes li {
        background: transparent !important;
        padding: 0px !important;
        border: none !important;
        margin: 0.5em 2em !important;
    }

The use of `!important` will ensure that it overrides the default styles
set up by the plugin.

• Alternatively, if you want to change the CSS class which is applied to to the footnotes list, you can do so using the class parameter on [references/]:

  This is a test.[ref]Lewis (2000).[/ref]
  
  <h3>Notes</h3>
  
  [references class="compact" /]
  

  ... which will produce the following HTML:

  <p>This is a test.<sup>[<a href="#test-n-1" class="footnoted"
  id="to-test-n-1">1</a>]</sup></p>
  
  <h3>Notes</h3>
  <ol class="compact">
  <li class="footnote" id="test-n-1"><strong><sup>[1]</sup></strong> Lewis
  (2000). <a class="note-return" href="#to-test-n-1">↩</a></li
  ></ol>
  

  Since the default styling is based on children of ol.footnotes, those styles will not apply, and you can apply whatever styles you wish to the class that you've created.

= Changes from version 2010.0309 to version 2010.0822

=

• Added [backref name="..." /] shortcode allowing you to refer back to a note with an established name

• Eliminated a bug which caused duplicate IDs if you tried to set up multiple sections of footnotes in the same post using repeated [references/] codes.

• Added [references class="foo" /] syntax, allowing user to supply their own class for CSS re-styling purposes.

• Tested for and verified compatibility up to WordPress 3.0.1 and WordPress trunk.

= Changes from version 2010.0306 to version 2010.0309

=

• Eliminates a harmless but potentially annoying source of "Missing argument" warnings from PHP