| 1 |
=== Easy Footnotes === |
| 2 |
Contributors: yingling017, twinpictures |
| 3 |
Donate link: http://jasonyingling.me |
| 4 |
Tags: footnotes, read, blogging, hover, tooltips, editing, endnotes, Formatting, writing, bibliography, notes, reference |
| 5 |
Requires at least: 3.0.1 |
| 6 |
Tested up to: 7.1 |
| 7 |
Stable tag: 1.1.14 |
| 8 |
License: GPLv2 or later |
| 9 |
License URI: http://www.gnu.org/licenses/gpl-2.0.html |
| 10 |
|
| 11 |
Easy Footnotes lets you quickly and easily add footnotes throughout your WordPress posts using a simple shortcode in the text editor. |
| 12 |
|
| 13 |
== Description == |
| 14 |
|
| 15 |
Easy Footnotes lets you add footnotes throughout your WordPress posts by using the shortcode [efn_note]Footnote content.[/efn_note]. Easy Footnotes will automatically add the number of the footnote where the shortcode was entered and add the full footnote text to the bottom of your post in an ordered list with a corresponding number. |
| 16 |
|
| 17 |
Hovering the footnote label will show the user the full text of the footnote using the jQuery Qtip2 plugin. Clicking on the footnote label will take the user down the page to the corresponding footnote at the bottom of the WordPress post. Each footnote at the bottom of the post has a icon that can be clicked to return to that particular footnote within the post copy. |
| 18 |
|
| 19 |
That's all it takes to start adding footnotes to your WordPress blog! |
| 20 |
|
| 21 |
== Installation == |
| 22 |
|
| 23 |
1. Upload the 'easy-footnotes' folder to the '/wp-content/plugins/' directory. |
| 24 |
2. Activate the plugin through the 'Plugins' menu in WordPress |
| 25 |
3. That's it! Now simply start using the [efn_note]Footnote content goes here.[/efn_note] shortcode within your posts. |
| 26 |
|
| 27 |
== Frequently Asked Questions == |
| 28 |
|
| 29 |
= How do I insert a footnote into my post. = |
| 30 |
|
| 31 |
Simply use the shortcode [efn_note]Footnote content goes here[/efn_note] and Easy Footnotes will enter numeric footnotes into your post that open on hover and take the user to the footnote at the bottom of the page on click. |
| 32 |
|
| 33 |
= That's awesome! = |
| 34 |
|
| 35 |
I know, but that's not really a question. |
| 36 |
|
| 37 |
= Oh right, why is that so awesome? = |
| 38 |
|
| 39 |
Because it's easy. And it's integrated with the qTip2 jQuery plugin to display your footnotes in lovely tooltips on hover. Plus it automatically numbers your footnotes in the order you enter them into your post. |
| 40 |
|
| 41 |
= How can I change the markup for the footnote label? = |
| 42 |
|
| 43 |
Just use the `efn_footnote_label` filter in your functions.php to edit the output. |
| 44 |
|
| 45 |
<pre> |
| 46 |
<code>function efn_change_label_markup( $output, $label ) { |
| 47 |
return '<h5>' . $label . '</h5>'; |
| 48 |
} |
| 49 |
add_filter( 'efn_footnote_label', 'efn_change_label_markup', 10, 2 );</code> |
| 50 |
</pre> |
| 51 |
|
| 52 |
= Can I disable the qTip functionality? = |
| 53 |
|
| 54 |
Place the following code in your functions.php file to disable the qTip features. |
| 55 |
|
| 56 |
<pre> |
| 57 |
<code>function efn_deregister_scripts() { |
| 58 |
wp_deregister_style( 'qtipstyles' ); |
| 59 |
wp_deregister_script( 'imagesloaded' ); |
| 60 |
wp_deregister_script( 'qtip' ); |
| 61 |
wp_deregister_script( 'qtipcall' ); |
| 62 |
} |
| 63 |
add_action( 'wp_enqueue_scripts', 'efn_deregister_scripts' );</code> |
| 64 |
</pre> |
| 65 |
|
| 66 |
= How can I reset the footnote count? = |
| 67 |
|
| 68 |
Use on the beginning of your page with the short code: `[efn_reset][/efn_reset]` |
| 69 |
|
| 70 |
This is a hard reset to fix a bug with themes/plugins using `do_shortcode( get_the_content() )` outside the main loop and causing duplicate footnotes. 1.1.9 should have updates to not require this. |
| 71 |
|
| 72 |
== Screenshots == |
| 73 |
|
| 74 |
1. Displaying a footnote on hover. |
| 75 |
2. Several footnotes (feetnote?) at the bottom of the post. |
| 76 |
|
| 77 |
== Changelog == |
| 78 |
|
| 79 |
= 1.1.14 = |
| 80 |
* Tested with WordPress 7.1. |
| 81 |
|
| 82 |
= 1.1.13 = |
| 83 |
* Fixed textdomain loading issue for WordPress 6.7 compatibility by preventing early translation calls during class construction. |
| 84 |
|
| 85 |
= 1.1.12 = |
| 86 |
* Bugfix for instances where `the_content` is called multiple times in a page. |
| 87 |
|
| 88 |
= 1.1.11 = |
| 89 |
* Made combined footnote functionality from 1.1.9 enabled by a setting to avoid breaking sites that rely on the old behavior. |
| 90 |
* Now can be turned on with "Combine duplicate footnotes" setting in Easy Footnotes settings. |
| 91 |
|
| 92 |
= 1.1.10 = |
| 93 |
* Fixes a bug with sites that called the_content() multiple times not displaying footnotes due to `easy_footnote_reset` running. |
| 94 |
* `easy_footnote_reset` now only runs when an option is activated. This had previously been implemented as a workaround for a bug that was addressed in 1.1.9. |
| 95 |
|
| 96 |
= 1.1.9 = |
| 97 |
* Adds support for duplicate footnotes using the same number |
| 98 |
* Fixes a bug with multiple footnotes showing at the bottom when do_shortcode() is run on the_content outside the main loop. |
| 99 |
* Add better i18n support for the plugin |
| 100 |
* Adds [efn_reset] shortcode to reset the footnote count |
| 101 |
|
| 102 |
= 1.1.8 = |
| 103 |
* WordPress 6.6 support |
| 104 |
|
| 105 |
= 1.1.6 = |
| 106 |
* Removing themes.pizza references |
| 107 |
* WordPress 6.0.2 support |
| 108 |
* PHP 8.0 support |
| 109 |
|
| 110 |
= 1.1.5 = |
| 111 |
* WordPress 5.5 compatability |
| 112 |
|
| 113 |
= 1.1.4 = |
| 114 |
* Fixing typo on FAQ page |
| 115 |
|
| 116 |
= 1.1.3 = |
| 117 |
* Adding div.easy-footnote-title into $footnote_label for filtering with `efn_footnote_label` |
| 118 |
|
| 119 |
= 1.1.2 = |
| 120 |
* Fixed issue with default settings not being set on new installations |
| 121 |
* Added conditional logic check if settings exist to avoid PHP Warnings |
| 122 |
* Fixed undefined index of $efn_output when not using Easy Footnotes label |
| 123 |
|
| 124 |
= 1.1.1 = |
| 125 |
* Added `efn_footnote_list_output` filter for editing entire Easy Footnote output after content |
| 126 |
* Updating SVN to include missing JS file |
| 127 |
|
| 128 |
= 1.1.0 = |
| 129 |
* Improved accessibility for keyboard navigation of footnotes |
| 130 |
* Started improving code to follow WordPress Coding Standards guidelines |
| 131 |
* Added second option for footnotes using `[efn_note]` to phase out non-prefixed `[note]` |
| 132 |
* Added `easy_footnote_label` hook to filter footnote labels |
| 133 |
* Added `before_footnote` and `after_footnote` filters to add content before or after footnote lists after content. |
| 134 |
|
| 135 |
= 1.0.16 = |
| 136 |
* Fixing footnote counts for the last time! (Hopefully) |
| 137 |
* Added post ID to footnote IDs to make them more unique |
| 138 |
* New setting to hide the footnotes after content in Settings > Easy Footnotes |
| 139 |
* Prep for a bigger update and beginning Gutenberg support |
| 140 |
|
| 141 |
= 1.0.15 = |
| 142 |
* Being a noob and not testing a link added in on settings page. It works now. |
| 143 |
|
| 144 |
= 1.0.14 = |
| 145 |
* CSS tweak in admin screen |
| 146 |
|
| 147 |
= 1.0.13 = |
| 148 |
* Fixing PHP notice on shortcode when content not found |
| 149 |
|
| 150 |
= 1.0.12 = |
| 151 |
* Changing how footnotes are numbered to avoid duplicates caused by `the_content` filtering being applied earlier in themes. |
| 152 |
|
| 153 |
= 1.0.11 = |
| 154 |
* Fixed bug to prevent tooltips from opening off the screen |
| 155 |
|
| 156 |
= 1.0.10 = |
| 157 |
* Added in extra sanitization for user inputs within admin |
| 158 |
|
| 159 |
= 1.0.9 = |
| 160 |
* Fixed issue causing notice of undefined index on admin screen. Adjustment to how footnote's handle html special chars. |
| 161 |
|
| 162 |
= 1.0.8 = |
| 163 |
* Added the Qtip2 unfocus event for hiding footnotes on iPad and other touch devices. |
| 164 |
|
| 165 |
= 1.0.7 = |
| 166 |
* Fixed issue where Footnote title was showing on pages without any footnotes once activated through the settings. Also changed the priority of the add_filter('the_content') call to be 20 in order to show above Jetpack Related Posts |
| 167 |
|
| 168 |
= 1.0.6 = |
| 169 |
* Added the ability to insert a title above the footnote section at the bottom of the post content. This is controlled in the Easy Footnotes Settings page that can be found under Settings in the WordPress Dashboard. |
| 170 |
|
| 171 |
= 1.0.5 = |
| 172 |
* Updating logic for appending footnotes to the bottom of posts. Now only appends to single posts, custom post types and pages that are using the main post query. Also fixed footnote count when multiple posts are shown in the content on one page, such as the home page. Footnotes outside of the single post also now link to the footnote within the single post. |
| 173 |
|
| 174 |
= 1.0.4 = |
| 175 |
* Fixed bug where footnotes were being appended to the end of the content on home pages and ignoring the more tag |
| 176 |
|
| 177 |
= 1.0.3 = |
| 178 |
* Added a delay of 400ms to the footnote closing so it stays open better when hovered |
| 179 |
|
| 180 |
= 1.0.2 = |
| 181 |
* I messed up the version tag on 1.0.1. Just upping ti 1.0.2 for precautions. |
| 182 |
|
| 183 |
= 1.0.1 = |
| 184 |
* Footnotes now stay open when moused over for interacting with links |
| 185 |
|
| 186 |
= 1.0.0 = |
| 187 |
* Initial release |
| 188 |
|
