{"id":8363,"date":"2010-03-08T10:01:45","date_gmt":"2010-03-08T10:01:45","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/footnotes-for-wordpress\/"},"modified":"2016-12-30T16:46:24","modified_gmt":"2016-12-30T16:46:24","slug":"footnotes-for-wordpress","status":"publish","type":"plugin","link":"https:\/\/szl.wordpress.org\/plugins\/footnotes-for-wordpress\/","author":16327,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"2016.1230","stable_tag":"2016.1230","tested":"4.7.33","requires":"2.9","requires_php":"","requires_plugins":"","header_name":"Footnotes for WordPress","header_author":"Charles Johnson","header_description":"","assets_banners_color":"","last_updated":"2016-12-30 16:46:24","external_support_url":"","external_repository_url":"","donate_link":"http:\/\/projects.radgeek.com\/wp-footnotes\/","header_plugin_uri":"http:\/\/projects.radgeek.com\/wp-footnotes.php","header_author_uri":"http:\/\/radgeek.com\/","rating":4,"author_block_rating":0,"active_installs":100,"downloads":10458,"num_ratings":1,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation"],"tags":[],"upgrade_notice":[],"ratings":{"1":0,"2":0,"3":0,"4":"1","5":0},"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["2010.0306","2010.0309","2010.0816","2010.0822","2016.0826","2016.1213","2016.1230"],"block_files":[],"assets_screenshots":{"screenshot-4.png":{"filename":"screenshot-4.png","revision":"1567524","resolution":"4","location":"plugin"},"screenshot-2.png":{"filename":"screenshot-2.png","revision":"1567524","resolution":"2","location":"plugin"},"screenshot-3.png":{"filename":"screenshot-3.png","revision":"1567524","resolution":"3","location":"plugin"},"screenshot-1.png":{"filename":"screenshot-1.png","revision":"1567524","resolution":"1","location":"plugin"}},"screenshots":{"1":"<p>Add inline footnotes with dead-simple shortcode syntax.<\/p>","2":"<p>A note marker with a link to the text of the note will appear next to the footnoted\ntext.<\/p>","3":"<p>The text of the note(s) will appear down the page.<\/p>","4":"<p>For ease of reading, users with JavaScript-enabled browsers can read the text of notes\ninline, without needing to jump down the page or lose their place.<\/p>"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[1850,1975],"plugin_category":[46],"plugin_contributors":[],"plugin_business_model":[],"class_list":["post-8363","plugin","type-plugin","status-publish","hentry","plugin_tags-footnotes","plugin_tags-formatting","plugin_category-editor-and-writing","plugin_committers-radgeek"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/footnotes-for-wordpress.svg","icon_2x":false,"generated":true},"screenshots":[{"src":"https:\/\/ps.w.org\/footnotes-for-wordpress\/trunk\/screenshot-1.png?rev=1567524","caption":"<p>Add inline footnotes with dead-simple shortcode syntax.<\/p>"},{"src":"https:\/\/ps.w.org\/footnotes-for-wordpress\/trunk\/screenshot-2.png?rev=1567524","caption":"<p>A note marker with a link to the text of the note will appear next to the footnoted\ntext.<\/p>"},{"src":"https:\/\/ps.w.org\/footnotes-for-wordpress\/trunk\/screenshot-3.png?rev=1567524","caption":"<p>The text of the note(s) will appear down the page.<\/p>"},{"src":"https:\/\/ps.w.org\/footnotes-for-wordpress\/trunk\/screenshot-4.png?rev=1567524","caption":"<p>For ease of reading, users with JavaScript-enabled browsers can read the text of notes\ninline, without needing to jump down the page or lose their place.<\/p>"}],"raw_content":"<!--section=description-->\n<p>Footnotes for WordPress is a simple plugin designed with a simple aim in mind: to make\nit dead-easy to include decently-formatted footnotes in posts and pages on your\nWordPress blog.<\/p>\n\n<p>The syntax is roughly based on the common MediaWiki syntax for footnotes, but uses the\nWordPress shortcode conventions. So, to include a footnote with the text \"Text,\" you use:<\/p>\n\n<pre><code>This is footnoted.[ref]Text[\/ref]\n<\/code><\/pre>\n\n<p>And that's all you need to do. When you add a footnote, Footnotes for WordPress will\ncreate a note marker at the point that the foonote appears in the text, and includes\nthe text of the footnote in a styled list of notes down the page. When a reader clicks\non the link in a JavaScript-enabled browser, a script included with the plugin will\ncreate a small bubble inline in the text, which pops up over the footnote marker for\neasy reading without losing their place. In non-JavaScript-enabled contexts, clicking\non the footnote marker jumps down the page to the text of the note.<\/p>\n\n<p>The jump is based on an unique anchor which the plugin can automatically generate for\nyou. However, if you want to create a specific ID of your own for the footnote, you\ncan do so using the <code>name=\"...\"<\/code> attribute:<\/p>\n\n<pre><code>This is footnoted.[ref name=\"my-unique-id-1\"]Text[\/ref]\n<\/code><\/pre>\n\n<p>If you define an ID for a footnote, you can also refer back to the same footnote\nlater on in the document, using the <code>[backref name=\"...\"]<\/code> shortcode.<\/p>\n\n<pre><code>This is footnoted.[ref name=\"source1\"]Source 1[\/ref]\n\nSo is this.[ref name=\"source2\"]Source[\/ref]\n\nAnd this one comes from the same source as the first.[backref name=\"source1\"]\n<\/code><\/pre>\n\n<p>Footnotes are numbered, beginning at 1. However, you can change the numbering if you\nso desire using the <code>number=\"...\"<\/code> attribute. For example, I often use this when\nquoting from a book that contains footnotes or endnotes, in order to represent the\nnotes used by the original text.<\/p>\n\n<pre><code>This is footnoted, but footnotes begin at number 42.[ref number=\"42\"]...[\/ref]\n<\/code><\/pre>\n\n<p>You can change the text that is displayed in the note's superscripted link from the\nnote's number to any text or symbol that you choose using the <code>superscript=\"...\"<\/code>\nattribute. For example, to use an asterisk instead of the note number:<\/p>\n\n<pre><code>This is footnoted with a good old asterisk.[ref superscript=\"*\"]...[\/ref]\n<\/code><\/pre>\n\n<p>By default, the list of footnotes appears at the bottom of the post. However, if you\nwish them to appear somewhere above the bottom of the post, for formatting or other\nreasons, you can do so using the <code>[references\/]<\/code> shortcode:<\/p>\n\n<pre><code>This is footnoted.[ref]Text[\/ref]\n\nAs are some[ref]Text[\/ref] other things.\n\n[references\/]\n\nSee also: Endnotes.\n<\/code><\/pre>\n\n<p>Which will cause the two footnotes to appear beneath the second paragraph but above\nthe \"See also:\" text.<\/p>\n\n<h3>Usage<\/h3>\n\n<ul>\n<li><p>To create a footnote, use <code>[ref]...[\/ref]<\/code> to wrap the text of your note.<\/p>\n\n<p>Example: <code>This is footnoted.[ref]This is the text of the of the footnote.[\/ref]<\/code><\/p><\/li>\n<li><p>Normally footnotes use numbered superscripts to indicate the footnote, beginning\nwith 1. You can choose to use symbols instead, like *, **, \u2020, etc. To use custom\ntext for a footnote's superscript, use <code>[ref superscript=\"*\"]...[\/ref]<\/code>, and\nreplace the asterisk with whatever symbol or text you want to use.<\/p><\/li>\n<li><p>Normally footnotes begin at 1 and count up towards infinity. If you want to use\nnumbered subscripts but need to reset the number they count from, use the <code>number<\/code>\nattribute. For example, if you want the current subscript to be numbered 128, and\nfor subsequent subscripts to be numbered 129, 130, etc., use:\n    [ref number=\"128\"]...[\/ref].<\/p><\/li>\n<li><p>To create a footnote with a specific unique ID, instead of the one that the plugin\nwill automatically generate for you, use <code>[ref name=\"...\"]...[\/ref]<\/code><\/p>\n\n<p>Example: <code>This is footnoted.[ref name=\"my-unique-id\"]This is the note text.[\/ref]<\/code><\/p><\/li>\n<li><p>If you define an ID for a footnote, you can also refer back to the same\nfootnote later on in the document, using the <code>[backref name=\"...\"]<\/code>\nshortcode.<\/p>\n\n<p>This is footnoted.[ref name=\"source1\"]Source 1[\/ref]<\/p>\n\n<p>So is this.[ref name=\"source2\"]Source[\/ref]<\/p>\n\n<p>And this one comes from the same source as the first.[backref name=\"source1\"]<\/p><\/li>\n<li><p>To force the plugin to display notes at a different location instead of at the bottom\nof the post, use <code>[references\/]<\/code><\/p>\n\n<p>Example:<\/p>\n\n<p>This is footnoted.[ref]Text[\/ref]<\/p>\n\n<p>As are some[ref]Text[\/ref] other things.<\/p>\n\n<p>[references\/]<\/p>\n\n<p>See also: Endnotes.<\/p><\/li>\n<li><p>If you wish to change how footnotes are styled, you can alter them in your\nWordPress theme stylesheet, or using JavaScript. The default elements and\nclasses are <code>&lt;a class=\"footnoted\"&gt;<\/code> for superscript links to footnotes,<\/p><\/li>\n<\/ul>\n\n<p>&lt;<\/p>\n\n<p>ol class=\"footnotes\"&gt; for the list of references, and\n        <li> for each individual footnote. So, for example, to\n    display footnotes at the bottom in a simple list, rather than in individual\n    boxes with \"Note\" headers, add the following line to your Theme stylesheet:<\/li><\/p>\n\n<pre><code>    ol.footnotes li {\n        background: transparent !important;\n        padding: 0px !important;\n        border: none !important;\n        margin: 0.5em 2em !important;\n    }\n\nThe use of `!important` will ensure that it overrides the default styles\nset up by the plugin.\n<\/code><\/pre>\n\n<ul>\n<li><p>Alternatively, if you want to change the CSS class which is applied to to\nthe footnotes list, you can do so using the <code>class<\/code> parameter on\n    [references\/]:<\/p>\n\n<pre><code>This is a test.[ref]Lewis (2000).[\/ref]\n\n&lt;h3&gt;Notes&lt;\/h3&gt;\n\n[references class=\"compact\" \/]\n<\/code><\/pre>\n\n<p>... which will produce the following HTML:<\/p>\n\n<pre><code>&lt;p&gt;This is a test.&lt;sup&gt;[&lt;a href=\"#test-n-1\" class=\"footnoted\"\nid=\"to-test-n-1\"&gt;1&lt;\/a&gt;]&lt;\/sup&gt;&lt;\/p&gt;\n\n&lt;h3&gt;Notes&lt;\/h3&gt;\n&lt;ol class=\"compact\"&gt;\n&lt;li class=\"footnote\" id=\"test-n-1\"&gt;&lt;strong&gt;&lt;sup&gt;[1]&lt;\/sup&gt;&lt;\/strong&gt; Lewis\n(2000). &lt;a class=\"note-return\" href=\"#to-test-n-1\"&gt;&#x21A9;&lt;\/a&gt;&lt;\/li\n&gt;&lt;\/ol&gt;\n<\/code><\/pre>\n\n<p>Since the default styling is based on children of <code>ol.footnotes<\/code>, those\nstyles will not apply, and you can apply whatever styles you wish to the\nclass that you've created.<\/p>\n\n<h3>Changes from version 2010.0309 to version 2010.0822<\/h3><\/li>\n<li><p>Added <code>[backref name=\"...\" \/]<\/code> shortcode allowing you to refer back to a note with an established name<\/p><\/li>\n<li><p>Eliminated a bug which caused duplicate IDs if you tried to set up multiple sections of footnotes in the same post using repeated <code>[references\/]<\/code> codes.<\/p><\/li>\n<li><p>Added <code>[references class=\"foo\" \/]<\/code> syntax, allowing user to supply their own class for CSS re-styling purposes.<\/p><\/li>\n<li><p>Tested for and verified compatibility up to WordPress 3.0.1 and WordPress trunk.<\/p><\/li>\n<\/ul>\n\n<h3>Changes from version 2010.0306 to version 2010.0309<\/h3>\n\n<ul>\n<li>Eliminates a harmless but potentially annoying source of \"Missing argument\" warnings from PHP<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li><p>Upload the <code>wp-footnotes<\/code> directory to the <code>\/wp-content\/plugins\/<\/code> directory of\nyour WordPress installation.<\/p><\/li>\n<li><p>Activate the plugin through the 'Plugins' panel in the WordPress admin interface<\/p><\/li>\n<li><p>Start writing posts with inline footnotes.<code>[ref]Using this shortcode![\/ref]<\/code><\/p><\/li>\n<\/ol>","raw_excerpt":"Footnotes for WordPress enables easy-to-use fancy footnotes for WordPress posts.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/8363","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=8363"}],"author":[{"embeddable":true,"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/radgeek"}],"wp:attachment":[{"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=8363"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=8363"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=8363"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=8363"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=8363"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/szl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=8363"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}