| @@ -1,19 +1,19 @@ | ||
| 1 | 1 | === Easy Footnotes === |
| 2 | -Contributors: yingling017 | |
| 2 | +Contributors: yingling017, twinpictures | |
| 3 | 3 | Donate link: http://jasonyingling.me |
| 4 | 4 | Tags: footnotes, read, blogging, hover, tooltips, editing, endnotes, Formatting, writing, bibliography, notes, reference |
| 5 | 5 | Requires at least: 3.0.1 |
| 6 | -Tested up to: 4.9.1 | |
| 7 | -Stable tag: 1.0.13 | |
| 6 | +Tested up to: 7.1 | |
| 7 | +Stable tag: 1.1.14 | |
| 8 | 8 | License: GPLv2 or later |
| 9 | 9 | License URI: http://www.gnu.org/licenses/gpl-2.0.html |
| 10 | 10 | |
| 11 | -Easy Footnotes let's you quickly and easily add footnotes throughout your WordPress posts using a simple shortcode in the text editor. | |
| 11 | +Easy Footnotes lets you quickly and easily add footnotes throughout your WordPress posts using a simple shortcode in the text editor. | |
| 12 | 12 | |
| 13 | 13 | == Description == |
| 14 | 14 | |
| 15 | -Easy Footnotes let's you add footnotes throughout your WordPress posts by using the shortcode [note]Footnote content.[/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. | |
| 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 | 16 | |
| 17 | 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 | 18 | |
| 19 | 19 | That's all it takes to start adding footnotes to your WordPress blog! |
| @@ -21,15 +21,15 @@ | ||
| 21 | 21 | == Installation == |
| 22 | 22 | |
| 23 | 23 | 1. Upload the 'easy-footnotes' folder to the '/wp-content/plugins/' directory. |
| 24 | 24 | 2. Activate the plugin through the 'Plugins' menu in WordPress |
| 25 | -3. That's it! Now simply start using the [note]Footnote content goes here.[/note] shortcode within your posts. | |
| 25 | +3. That's it! Now simply start using the [efn_note]Footnote content goes here.[/efn_note] shortcode within your posts. | |
| 26 | 26 | |
| 27 | 27 | == Frequently Asked Questions == |
| 28 | 28 | |
| 29 | 29 | = How do I insert a footnote into my post. = |
| 30 | 30 | |
| 31 | -Simply use the shortcode [note]Footnote content goes here[/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. | |
| 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 | 32 | |
| 33 | 33 | = That's awesome! = |
| 34 | 34 | |
| 35 | 35 | I know, but that's not really a question. |
| @@ -37,21 +37,39 @@ | ||
| 37 | 37 | = Oh right, why is that so awesome? = |
| 38 | 38 | |
| 39 | 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 | 40 | |
| 41 | -= Any plans for the future? = | |
| 41 | += How can I change the markup for the footnote label? = | |
| 42 | 42 | |
| 43 | -Yeah, I'll be integrating more of qTip's options for displaying the tooltips. Give users the ability to set their own icons and labels. And much more as I get user feedback. | |
| 43 | +Just use the `efn_footnote_label` filter in your functions.php to edit the output. | |
| 44 | 44 | |
| 45 | -= That sounds great, but I was thinking more personally. You know, are you up to anything tonight? Want to grab some pizza? = | |
| 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> | |
| 46 | 51 | |
| 47 | -How did you even get in here? | |
| 52 | += Can I disable the qTip functionality? = | |
| 48 | 53 | |
| 49 | -= It's cool I'll let myself out. One last question though. Any advice on filling up a new plugins FAQ section? = | |
| 54 | +Place the following code in your functions.php file to disable the qTip features. | |
| 50 | 55 | |
| 51 | -Maecenas sed diam eget risus varius blandit sit amet non magna. Integer posuere erat a ante venenatis dapibus posuere velit aliquet. Maecenas faucibus mollis interdum. | |
| 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> | |
| 52 | 65 | |
| 66 | += How can I reset the footnote count? = | |
| 53 | 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 | + | |
| 54 | 72 | == Screenshots == |
| 55 | 73 | |
| 56 | 74 | 1. Displaying a footnote on hover. |
| 57 | 75 | 2. Several footnotes (feetnote?) at the bottom of the post. |
| @@ -57,8 +75,76 @@ | ||
| 57 | 75 | 2. Several footnotes (feetnote?) at the bottom of the post. |
| 58 | 76 | |
| 59 | 77 | == Changelog == |
| 60 | 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 | + | |
| 61 | 147 | = 1.0.13 = |
| 62 | 148 | * Fixing PHP notice on shortcode when content not found |
| 63 | 149 | |
| 64 | 150 | = 1.0.12 = |
| @@ -98,48 +184,4 @@ | ||
| 98 | 184 | * Footnotes now stay open when moused over for interacting with links |
| 99 | 185 | |
| 100 | 186 | = 1.0.0 = |
| 101 | 187 | * Initial release |
| 102 | - | |
| 103 | -== Upgrade Notice == | |
| 104 | - | |
| 105 | -= 1.0.0 = | |
| 106 | -Initial release | |
| 107 | - | |
| 108 | -= 1.0.1 = | |
| 109 | -Footnotes now stay open when moused over. Allows for adding links into footnotes. | |
| 110 | - | |
| 111 | -= 1.0.2 = | |
| 112 | -I messed up the version tag on 1.0.1. Just upping it 1.0.2 for precautions. | |
| 113 | - | |
| 114 | -= 1.0.3 = | |
| 115 | -Added a 400ms delay to the footnote closing via qTip. This allows the footnote to stay open better when mousing into for access to links. | |
| 116 | - | |
| 117 | -= 1.0.4 = | |
| 118 | -Fixed bug where footnotes were being appended to the end of the content on home pages and ignoring the more tag | |
| 119 | - | |
| 120 | -= 1.0.5 = | |
| 121 | -Updated logic for appending footnotes to the bottom of single posts and pages. Now using is_singular and is_main_query as opposed to just is_single. This allows for appending posts to the bottom of posts, custom post types, and pages. Also fixed logic for numbering posts on the home page when showing multiple posts. Footnotes outside of the single post also now link to the footnote within the single post. | |
| 122 | - | |
| 123 | -= 1.0.6 = | |
| 124 | -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. | |
| 125 | - | |
| 126 | -= 1.0.7 = | |
| 127 | -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 | |
| 128 | - | |
| 129 | -= 1.0.8 = | |
| 130 | -Improved footnote usability on touch devices. | |
| 131 | - | |
| 132 | -= 1.0.9 = | |
| 133 | -Fixed issue causing notice of undefined index on admin screen. Adjustment to how footnote's handle html special chars. | |
| 134 | - | |
| 135 | -= 1.0.10 = | |
| 136 | -Sanitizing inputs | |
| 137 | - | |
| 138 | -= 1.0.11 = | |
| 139 | -Fixed bug to prevent tooltips from opening off the screen | |
| 140 | - | |
| 141 | -= 1.0.12 = | |
| 142 | -Changing how footnotes are numbered to avoid duplicates caused by `the_content` filtering being applied earlier in themes. | |
| 143 | - | |
| 144 | -= 1.0.13 = | |
| 145 | -Fixing PHP notice on shortcode when content not found | |
