{"id":22983,"date":"2013-04-16T19:29:51","date_gmt":"2013-04-16T19:29:51","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/civil-footnotes\/"},"modified":"2020-02-03T15:53:13","modified_gmt":"2020-02-03T15:53:13","slug":"civil-footnotes","status":"closed","type":"plugin","link":"https:\/\/pe.wordpress.org\/plugins\/civil-footnotes\/","author":11956094,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"2.1","stable_tag":"2.1","tested":"5.3.21","requires":"5.0","requires_php":"7.0","requires_plugins":"","header_name":"Civil Footnotes","header_author":"K. Adam White, Austin Sweeney","header_description":"","assets_banners_color":"c7c7c7","last_updated":"2020-02-03 15:53:13","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/github.com\/kadamwhite\/civil-footnotes","header_author_uri":"https:\/\/www.kadamwhite.com","rating":4.6,"author_block_rating":0,"active_installs":300,"downloads":13799,"num_ratings":8,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":{"2.0":"<p>Civil Footnotes 2.0 supports modern PHP versions and works with the block editor.<\/p>","1.3.1":"<p>This is the last version of Civil Footnotes that supports PHP 5.6.<\/p>"},"ratings":{"1":0,"2":0,"3":"1","4":"1","5":"6"},"assets_icons":[],"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":"698858","resolution":"1544x500","location":"assets","locale":""},"banner-772x250.png":{"filename":"banner-772x250.png","revision":"698772","resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0","1.1","1.2","1.3","1.3.1","2.0","2.1"],"block_files":[],"assets_screenshots":[],"screenshots":[],"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[7530,1850,3843,166,1809],"plugin_category":[46],"plugin_contributors":[83060,140790],"plugin_business_model":[],"class_list":["post-22983","plugin","type-plugin","status-closed","hentry","plugin_tags-footnote","plugin_tags-footnotes","plugin_tags-notes","plugin_tags-posts","plugin_tags-reference","plugin_category-editor-and-writing","plugin_contributors-defomicron","plugin_contributors-kadamwhite","plugin_committers-defomicron","plugin_committers-kadamwhite"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/civil-footnotes_c7c7c7.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"<!--section=description-->\n<p>Civil Footnotes is a WordPress plugin for adding footnotes on your blog. Civil Footnotes parses your posts for notes wrapped in ((double parenthesis)), then extracts that parenthesized text into a footnote list at the end of the post.<\/p>\n\n<p>There are many solutions for managing footnotes within your WordPress website, but Civil Footnotes distinguishes itself from the rest with a simple, readable plain text syntax that works whether you're using the WordPress block editor, a Markdown editor, or the classic editor plugin.<\/p>\n\n<p>The majority of Civil Footnotes\u2019 formatting is taken from the blog <a href=\"https:\/\/daringfireball.net\/\">Daring Fireball<\/a>, which first debuted this style of footnotes <a href=\"http:\/\/daringfireball.net\/2005\/07\/footnotes\">in 2005<\/a>. The key difference is the addition of a <code>title<\/code> attribute to the footnote reference in the text which permits sighted mouse users to efficiently read the note by hovering their cursor over the reference number.<\/p>\n\n<h4>Credits<\/h4>\n\n<p>Civil Footnotes was originally created by <a href=\"https:\/\/defomicron.net\/\">Austin Sweeney<\/a> and is currently maintained by <a href=\"https:\/\/www.kadamwhite.com\">K. Adam White<\/a>.<\/p>\n\n<h3>License &amp; Attribution<\/h3>\n\n<p>This plugin is licensed under the terms of the <a href=\".\/license.txt\">GNU General Public License<\/a> (or \"GPL\"). It is free software; you can redistribute it and\/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.<\/p>\n\n<!--section=installation-->\n<p>The easiest way to install Civil Footnotes is through the Admin section of your WordPress install. Otherwise:<\/p>\n\n<ol>\n<li><p>Download and unzip <code>civil-footnotes.zip<\/code><\/p><\/li>\n<li><p>Upload the <code>civil-footnotes<\/code> folder to the <code>\/wp-content\/plugins\/<\/code> directory of your WordPress install<\/p><\/li>\n<li><p>Activate the plugin through the \u2018Plugins\u2019 menu in WordPress<\/p><\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt>How do I use this plugin?<\/dt>\n<dd><p>To create a footnote in a post, wrap the note in double parenthesis. For example, if I wrapped <code>((this in double parenthesis))<\/code>, Civil Footnotes would interpret that as a footnote and convert it appropriately. This is a vast improvement over previous solutions which required you to manually keep a numbered reference in the text in sync with a note appended to the end.<\/p>\n\n<p>Footnotes can be added to any post or page in WordPress. If you are using a plugin which provides Markdown support for your site, you may also include Markdown formatted text and links within your footnotes.<\/p>\n\n<p>NOTE: You must include a space before the first parenthesis of your footnote; otherwise they will not display. This space will not be included in the final markup.<\/p><\/dd>\n<dt>Why aren\u2019t there any settings?<\/dt>\n<dd><p>Civil Footnotes adheres to the WordPress project\u2019s philosophy of <a href=\"https:\/\/wordpress.org\/about\/philosophy\/#decisions\">\"Decisions, not Options\"<\/a>. As a result there is no user-facing options configuration screen, and Civil Footnotes is designed to work as one might expect right out of the box.<\/p>\n\n<p>If you do wish to change the behavior of the plugin, there are two ways in which a specific theme can alter how the footnotes render in code:<\/p>\n\n<ol>\n<li><p>Your theme may provide custom CSS to style the footnote output. To style the reference numbers, style the <code>&lt;sup&gt;<\/code> tag in CSS. The footnotes at the bottom of a page use two css classes, <code>.footnotes<\/code> and <code>.backlink<\/code>, which may be used to apply additional CSS styling to those elements.<\/p><\/li>\n<li><p>Your theme may specify the format of footnote marker. The available footnote markers are \u2018decimal\u2019, \u2018lower-roman\u2019, \u2018upper-roman\u2019, \u2018lower-alpha\u2019, \u2018upper-alpha\u2019, \u2018lower-greek\u2019, \u2018upper-greek\u2019, and \u2018symbol\u2019. To specify which marker is used on your site, you can add a filter function to the <code>footnotes_style<\/code> hook:<\/p>\n\n<p>\/\/ functions.php\nfunction mytheme_use_roman_numeral_footnotes( $style, $formats ) {\n  return $formats['lower-roman'];\n}\napply_filter( 'footnotes_style', 'mytheme_use_roman_numeral_footnotes', 10, 2 );<\/p><\/li>\n<\/ol>\n\n<p>All available formats are specified in the keys of this filter's <code>$formats<\/code> array.<\/p><\/dd>\n<dt>I found a bug, how can I report it?<\/dt>\n<dd><p>The best way to report a bug is to <a href=\"https:\/\/github.com\/kadamwhite\/civil-footnotes\/issues\/new\">open an issue on the plugin's GitHub repository<\/a> explaining your problem. You can also start a discussion on the <a href=\"http:\/\/wordpress.org\/support\/plugin\/civil-footnotes\">WordPress support forum<\/a>.<\/p><\/dd>\n<dt>May I suggest a new feature?<\/dt>\n<dd><p>Absolutely! We cannot guarantee all feature proposals will be accepted; Civil Footnotes is deliberately lightweight and aims to remain so. If you have a suggestion, however, the best way to request a new feature is to open an issue on the project repository as described above in \"I found a bug.\"<\/p><\/dd>\n<dt>Where can I download archived releases of Civil Footnotes?<\/dt>\n<dd><p>From the <a href=\"https:\/\/github.com\/kadamwhite\/civil-footnotes\/releases\">Releases page<\/a> of the plugin\u2019s GitHub repository.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>2.1<\/h4>\n\n<ul>\n<li>Fixed a bug in v2.0 that prevented HTML from rendering within footnote content.<\/li>\n<\/ul>\n\n<h4>2.0.0<\/h4>\n\n<ul>\n<li>Upgraded plugin for compatibility with PHP versions 7 and up<\/li>\n<li>Introduced <code>footnotes_style<\/code> filter to select roman numerals, symbols, or other non-numeric footnote styles<\/li>\n<li>Modernized &amp; reorganized code for a more efficient footnote rendering experience<\/li>\n<li>Temporarily removed support for de-duplicating identical footnotes.<\/li>\n<li>Temporarily removed support for <code>&lt;!--startnum=5--&gt;<\/code> footnote number overrides.<\/li>\n<\/ul>\n\n<h4>1.3.1<\/h4>\n\n<ul>\n<li>Added a \u2018footnote\u2019 <code>rel<\/code> class to the footnote links<\/li>\n<\/ul>\n\n<h4>1.3<\/h4>\n\n<ul>\n<li>Fixed two PHP errors (thanks to Greg Sullivan)<\/li>\n<li>From now on, identical footnotes will be created as two separate footnotes (as they should be)<\/li>\n<\/ul>\n\n<h4>1.2<\/h4>\n\n<ul>\n<li>Added support for starting footnotes with a different number (e.g. 5)<\/li>\n<li>Add <code>&lt;!--startnum=5--&gt;<\/code> or similar anywhere in the post or page to do so<\/li>\n<li>This is handy for paginated posts<\/li>\n<\/ul>\n\n<h4>1.1<\/h4>\n\n<ul>\n<li>Changed the backlink\u2019s hover text, now more fun and more aligned with DF-style<\/li>\n<li>Added annotations to the plugin file to make it easier to modify output HTML<\/li>\n<li>Revised structure of output creation to make it easier to modify output HTML<\/li>\n<li>Fixed a bug that caused a <code>&lt;\/p&gt;<\/code> tag to not appear in the notes<\/li>\n<\/ul>\n\n<p>This update is recommended for all users running Civil Footnotes 1.0<\/p>\n\n<h4>1.0<\/h4>\n\n<ul>\n<li>First release<\/li>\n<\/ul>","raw_excerpt":"Add footnotes to your site using a simple, easy-to-read inline syntax ((by wrapping footnote content with double-parentheses)).","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/pe.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/22983","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pe.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/pe.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/pe.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=22983"}],"author":[{"embeddable":true,"href":"https:\/\/pe.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/defomicron"}],"wp:attachment":[{"href":"https:\/\/pe.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=22983"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/pe.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=22983"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/pe.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=22983"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/pe.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=22983"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/pe.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=22983"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/pe.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=22983"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}