traceability update 2.5.5d1

git-svn-id: https://plugins.svn.wordpress.org/footnotes/trunk@2476187 b8457f37-d9ea-0310-8a92-e5e31aec5664
This commit is contained in:
pewgeuges 2021-02-17 09:33:04 +00:00
parent 3a341d36b2
commit d9e23677b0
9 changed files with 83 additions and 63 deletions

View file

@ -679,7 +679,7 @@ class MCI_Footnotes_Layout_Settings extends MCI_Footnotes_LayoutEngine {
"alternative" => $this->addSelectBox(MCI_Footnotes_Settings::C_BOOL_FOOTNOTES_MOUSE_OVER_BOX_ALTERNATIVE, $l_arr_Enabled), "alternative" => $this->addSelectBox(MCI_Footnotes_Settings::C_BOOL_FOOTNOTES_MOUSE_OVER_BOX_ALTERNATIVE, $l_arr_Enabled),
"notice-alternative" => __("Intended to work around a configuration-related tooltip outage.", MCI_Footnotes_Config::C_STR_PLUGIN_NAME), "notice-alternative" => __("Intended to work around a configuration-related tooltip outage.", MCI_Footnotes_Config::C_STR_PLUGIN_NAME),
// The placeholder is the name of the plugin as logogram “footnotes”. // The placeholder is the name of the plugin as logogram “footnotes”.
"description-alternative" => sprintf(__("Some themes inhibit jQuery tooltips. Some may disable CSS transitions as well. Alternative tooltips are triggered by inline JavaScript and animated with CSS transitions. If this option is enabled, %s does not load any external scripts.", MCI_Footnotes_Config::C_STR_PLUGIN_NAME), '<span style="font-style: normal;">' . MCI_Footnotes_Config::C_STR_PLUGIN_PUBLIC_NAME . '</span>'), "description-alternative" => sprintf(__("These alternative tooltips work around a website related jQuery UI outage. They are low-script but use the AMP incompatible onmouseover and onmouseout arguments, along with CSS transitions for fade-in/out. The very small script is inserted after Footnotes internal stylesheet. When this option is enabled, %s does not load jQuery&nbsp;UI nor jQuery&nbsp;Tools.", MCI_Footnotes_Config::C_STR_PLUGIN_NAME), '<span style="font-style: normal;">' . MCI_Footnotes_Config::C_STR_PLUGIN_PUBLIC_NAME . '</span>'),
) )
); );
@ -827,6 +827,8 @@ class MCI_Footnotes_Layout_Settings extends MCI_Footnotes_LayoutEngine {
$l_obj_Template->replace( $l_obj_Template->replace(
array( array(
"description-delimiter" => __("Tooltips can display another content than the footnote entry in the reference container. The trigger is a shortcode in the footnote text separating the tooltip text from the note. That is consistent with what WordPress does for excerpts.", MCI_Footnotes_Config::C_STR_PLUGIN_NAME),
"label-delimiter" => $this->addLabel(MCI_Footnotes_Settings::C_STR_FOOTNOTES_TOOLTIP_EXCERPT_DELIMITER, __("Delimiter for dedicated tooltip text:", MCI_Footnotes_Config::C_STR_PLUGIN_NAME)), "label-delimiter" => $this->addLabel(MCI_Footnotes_Settings::C_STR_FOOTNOTES_TOOLTIP_EXCERPT_DELIMITER, __("Delimiter for dedicated tooltip text:", MCI_Footnotes_Config::C_STR_PLUGIN_NAME)),
"delimiter" => $this->addTextBox(MCI_Footnotes_Settings::C_STR_FOOTNOTES_TOOLTIP_EXCERPT_DELIMITER), "delimiter" => $this->addTextBox(MCI_Footnotes_Settings::C_STR_FOOTNOTES_TOOLTIP_EXCERPT_DELIMITER),
"notice-delimiter" => __("If the delimiter shortcode is present, the tooltip text will be the part before it.", MCI_Footnotes_Config::C_STR_PLUGIN_NAME), "notice-delimiter" => __("If the delimiter shortcode is present, the tooltip text will be the part before it.", MCI_Footnotes_Config::C_STR_PLUGIN_NAME),
@ -839,6 +841,8 @@ class MCI_Footnotes_Layout_Settings extends MCI_Footnotes_LayoutEngine {
"separator" => $this->addTextBox(MCI_Footnotes_Settings::C_STR_FOOTNOTES_TOOLTIP_EXCERPT_MIRROR_SEPARATOR), "separator" => $this->addTextBox(MCI_Footnotes_Settings::C_STR_FOOTNOTES_TOOLTIP_EXCERPT_MIRROR_SEPARATOR),
"notice-separator" => __("May be a simple space, or a line break &lt;br /&gt;, or any string in your language.", MCI_Footnotes_Config::C_STR_PLUGIN_NAME), "notice-separator" => __("May be a simple space, or a line break &lt;br /&gt;, or any string in your language.", MCI_Footnotes_Config::C_STR_PLUGIN_NAME),
"description-mirror" => __("Tooltips, even jQuery-driven, may be hard to consult on mobiles. This option allows to find the tooltip content in the reference container too.", MCI_Footnotes_Config::C_STR_PLUGIN_NAME),
) )
); );
@ -934,7 +938,7 @@ class MCI_Footnotes_Layout_Settings extends MCI_Footnotes_LayoutEngine {
"symbol-options" => $this->addSelectBox(MCI_Footnotes_Settings::C_STR_HYPERLINK_ARROW, MCI_Footnotes_Convert::getArrow()), "symbol-options" => $this->addSelectBox(MCI_Footnotes_Settings::C_STR_HYPERLINK_ARROW, MCI_Footnotes_Convert::getArrow()),
"symbol-custom" => $this->addTextBox(MCI_Footnotes_Settings::C_STR_HYPERLINK_ARROW_USER_DEFINED), "symbol-custom" => $this->addTextBox(MCI_Footnotes_Settings::C_STR_HYPERLINK_ARROW_USER_DEFINED),
"notice-symbol" => __("Your input overrides the selection.", MCI_Footnotes_Config::C_STR_PLUGIN_NAME), "notice-symbol" => __("Your input overrides the selection.", MCI_Footnotes_Config::C_STR_PLUGIN_NAME),
"description-symbol" => __("This setting cannot be moved into the reference container settings, because each tab is saved in a different place, so moving a setting breaks user data. Our apologies for having done so with this setting now moved back to the tab it pre-existed under.", MCI_Footnotes_Config::C_STR_PLUGIN_NAME), "description-symbol" => __("This symbol is used in the reference container. But this setting pre-existed under this tab and cannot be moved to another one.", MCI_Footnotes_Config::C_STR_PLUGIN_NAME),
) )
); );
// display template with replaced placeholders // display template with replaced placeholders

View file

@ -7,7 +7,7 @@
* @since 1.5.0 14.09.14 10:43 * @since 1.5.0 14.09.14 10:43
* *
* *
* @lastmodified 2021-02-16T0101+0100 * @lastmodified 2021-02-17T1026+0100
* *
* @since 2.0.4 restore arrow settings 2020-11-02T2115+0100 * @since 2.0.4 restore arrow settings 2020-11-02T2115+0100
* @since 2.0.7 remove hook the_post 2020-11-06T1342+0100 * @since 2.0.7 remove hook the_post 2020-11-06T1342+0100
@ -83,11 +83,8 @@ class MCI_Footnotes_Settings {
* @var str * @var str
* The string is converted to Boolean false if 'no', true if 'yes'. * The string is converted to Boolean false if 'no', true if 'yes'.
* @see MCI_Footnotes_Convert::toBool() * @see MCI_Footnotes_Convert::toBool()
* The type in the variable name is useful to hint the intended use * The type in the variable name is useful to show the intention.
* and IMO should therefore not be changed to _STR_ * @todo Eventually change misleading variable names C_BOOL_… to C_STR_… (thats how Hungarian screws things up).
* Else:
* @todo Change misleading variable names C_BOOL_… to C_STR_… (thats how Hungarian screws things up).
* @todo Do not convert strings to Booleans: toBool() fixes empty, or empty() must be used everywhere.
*/ */
const C_BOOL_REFERENCE_CONTAINER_COLLAPSE = "footnote_inputfield_collapse_references"; const C_BOOL_REFERENCE_CONTAINER_COLLAPSE = "footnote_inputfield_collapse_references";
@ -181,6 +178,9 @@ class MCI_Footnotes_Settings {
* *
* @since 2.1.6 This setting removed as irrelevant since priority level settings need permanent visibility. * @since 2.1.6 This setting removed as irrelevant since priority level settings need permanent visibility.
* @date 2020-12-09T2107+0100 * @date 2020-12-09T2107+0100
*
* Since the removal of the the_post hook, the tab is no danger zone any longer.
* All users, not experts only, need to be able to control relative positioning.
*/ */
const C_BOOL_FOOTNOTES_EXPERT_MODE = "footnote_inputfield_enable_expert_mode"; const C_BOOL_FOOTNOTES_EXPERT_MODE = "footnote_inputfield_enable_expert_mode";
@ -190,6 +190,14 @@ class MCI_Footnotes_Settings {
* @author Stefan Herndler * @author Stefan Herndler
* @since 1.5.0 * @since 1.5.0
* @var str * @var str
*
* The default footnote referrer surroundings should be square brackets:
*
* - with respect to baseline footnote referrers new option;
* - as in English or US American typesetting;
* - for better UX thanks to a more button-like appearance;
* - for stylistic consistency with the expand-collapse button.
*
*/ */
const C_STR_FOOTNOTES_STYLING_BEFORE = "footnote_inputfield_custom_styling_before"; const C_STR_FOOTNOTES_STYLING_BEFORE = "footnote_inputfield_custom_styling_before";
@ -223,6 +231,12 @@ class MCI_Footnotes_Settings {
* @link https://wordpress.org/support/topic/footnotes-appearing-in-header/page/2/#post-13632566 * @link https://wordpress.org/support/topic/footnotes-appearing-in-header/page/2/#post-13632566
* *
* @var str * @var str
*
* These alternative tooltips work around a website related jQuery UI
* outage. They are low-script but use the AMP incompatible onmouseover
* and onmouseout arguments, along with CSS transitions for fade-in/out.
* The very small script is inserted after Footnotes internal stylesheet.
*
*/ */
const C_BOOL_FOOTNOTES_MOUSE_OVER_BOX_ALTERNATIVE = "footnote_inputfield_custom_mouse_over_box_alternative"; const C_BOOL_FOOTNOTES_MOUSE_OVER_BOX_ALTERNATIVE = "footnote_inputfield_custom_mouse_over_box_alternative";
@ -678,21 +692,25 @@ class MCI_Footnotes_Settings {
* Settings container key for shortcode syntax validation. * Settings container key for shortcode syntax validation.
* *
* @since 2.4.0 * @since 2.4.0
* @var str * @date 2021-01-01T0616+0100
* *
* 2021-01-01T0616+0100 * @var str
*/ */
const C_BOOL_FOOTNOTE_SHORTCODE_SYNTAX_VALIDATION_ENABLE = "footnotes_inputfield_shortcode_syntax_validation_enable"; const C_BOOL_FOOTNOTE_SHORTCODE_SYNTAX_VALIDATION_ENABLE = "footnotes_inputfield_shortcode_syntax_validation_enable";
/** /**
* Settings container key to enable a backlink tooltip. * Settings container key to enable a backlink tooltip.
* *
* - * - Update: Reference container: Hard backlinks (optional): optional configurable tooltip hinting to use the backbutton instead, thanks to @theroninjedi47 bug report.
* *
* @since 2.5.4 * @since 2.5.4
* *
* @reporter * @reporter @theroninjedi47
* @link * @link https://wordpress.org/support/topic/hyperlinked-footnotes-creating-excessive-back-history/
*
* When hard links are enabled, clicks on the backlinks are logged in the browsing history.
* This tooltip hints to use the backbutton instead, so the history gets streamlined again.
* @link https://wordpress.org/support/topic/making-it-amp-compatible/#post-13837359
* *
* @var str * @var str
*/ */
@ -701,12 +719,12 @@ class MCI_Footnotes_Settings {
/** /**
* Settings container key to configure the backlink tooltip. * Settings container key to configure the backlink tooltip.
* *
* - * - Update: Reference container: Hard backlinks (optional): optional configurable tooltip hinting to use the backbutton instead, thanks to @theroninjedi47 bug report.
* *
* @since 2.5.4 * @since 2.5.4
* *
* @reporter * @reporter @theroninjedi47
* @link * @link https://wordpress.org/support/topic/hyperlinked-footnotes-creating-excessive-back-history/
* *
* @var str * @var str
*/ */
@ -715,12 +733,19 @@ class MCI_Footnotes_Settings {
/** /**
* Settings container key to configure the tooltip excerpt delimiter. * Settings container key to configure the tooltip excerpt delimiter.
* *
* - * - Update: Tooltips: ability to display dedicated content before `[[/tooltip]]`, thanks to @jbj2199 issue report.
* *
* The first implementation used a fixed shortcode provided in the changelog.
* But Footnotes UI design policy is to make shortcodes freely configurable.
* @since 2.5.4 * @since 2.5.4
* *
* @reporter * @reporter @jbj2199
* @link * @link https://wordpress.org/support/topic/change-tooltip-text/
*
* Tooltips can display another content than the footnote entry
* in the reference container. The trigger is a shortcode in
* the footnote text separating the tooltip text from the note.
* That is consistent with what WordPress does for excerpts.
* *
* @var str * @var str
*/ */
@ -729,27 +754,21 @@ class MCI_Footnotes_Settings {
/** /**
* Settings container key to enable mirroring the tooltip excerpt in the reference container. * Settings container key to enable mirroring the tooltip excerpt in the reference container.
* *
* -
*
* @since 2.5.4 * @since 2.5.4
*
* @reporter
* @link
*
* @var str * @var str
*
* Tooltips, even jQuery-driven, may be hard to consult on mobiles.
* This option allows to find the tooltip content in the reference container too.
* @link https://wordpress.org/support/topic/change-tooltip-text/#post-13935050
* But this must not be the default behavior.
* @link https://wordpress.org/support/topic/change-tooltip-text/#post-13935488
*/ */
const C_BOOL_FOOTNOTES_TOOLTIP_EXCERPT_MIRROR_ENABLE = "footnotes_inputfield_tooltip_excerpt_mirror_enable"; const C_BOOL_FOOTNOTES_TOOLTIP_EXCERPT_MIRROR_ENABLE = "footnotes_inputfield_tooltip_excerpt_mirror_enable";
/** /**
* Settings container key to configure the tooltip excerpt separator in the reference container. * Settings container key to configure the tooltip excerpt separator in the reference container.
* *
* -
*
* @since 2.5.4 * @since 2.5.4
*
* @reporter
* @link
*
* @var str * @var str
*/ */
const C_STR_FOOTNOTES_TOOLTIP_EXCERPT_MIRROR_SEPARATOR = "footnotes_inputfield_tooltip_excerpt_mirror_separator"; const C_STR_FOOTNOTES_TOOLTIP_EXCERPT_MIRROR_SEPARATOR = "footnotes_inputfield_tooltip_excerpt_mirror_separator";
@ -894,9 +913,6 @@ class MCI_Footnotes_Settings {
// excerpt should be disabled: // excerpt should be disabled:
self::C_BOOL_FOOTNOTES_IN_EXCERPT => 'no', self::C_BOOL_FOOTNOTES_IN_EXCERPT => 'no',
// since removal of the_post hook, expert mode is no danger zone
// not for experts only; raising awareness about relative positioning
// changed default to 'yes':
self::C_BOOL_FOOTNOTES_EXPERT_MODE => 'yes', self::C_BOOL_FOOTNOTES_EXPERT_MODE => 'yes',
self::C_STR_FOOTNOTES_LOVE => 'no', self::C_STR_FOOTNOTES_LOVE => 'no',
@ -912,18 +928,11 @@ class MCI_Footnotes_Settings {
self::C_BOOL_FOOTNOTES_REFERRER_SUPERSCRIPT_TAGS => 'yes', self::C_BOOL_FOOTNOTES_REFERRER_SUPERSCRIPT_TAGS => 'yes',
// The default footnote referrer surroundings should be square brackets:
// * with respect to baseline footnote referrers new option;
// * as in English or US American typesetting;
// * for better UX thanks to a more button-like appearance;
// * for stylistic consistency with the expand-collapse button;
self::C_STR_FOOTNOTES_STYLING_BEFORE => '[', self::C_STR_FOOTNOTES_STYLING_BEFORE => '[',
self::C_STR_FOOTNOTES_STYLING_AFTER => ']', self::C_STR_FOOTNOTES_STYLING_AFTER => ']',
self::C_BOOL_FOOTNOTES_MOUSE_OVER_BOX_ENABLED => 'yes', self::C_BOOL_FOOTNOTES_MOUSE_OVER_BOX_ENABLED => 'yes',
// alternative, low-script tooltips using CSS for transitions
// in response to user demand for website with jQuery UI outage
self::C_BOOL_FOOTNOTES_MOUSE_OVER_BOX_ALTERNATIVE => 'no', self::C_BOOL_FOOTNOTES_MOUSE_OVER_BOX_ALTERNATIVE => 'no',
// The mouse over content truncation should be enabled by default // The mouse over content truncation should be enabled by default

View file

@ -7,7 +7,7 @@
* Since: 1.0 * Since: 1.0
* *
* @version 2.5.5 * @version 2.5.5
* @lastmodified 2021-02-16T0159+0100 * @lastmodified 2021-02-16T0651+0100
* *
* Classes recommended for Custom CSS: * Classes recommended for Custom CSS:
* @see templates/dashboard/customize-css-new.html * @see templates/dashboard/customize-css-new.html
@ -28,10 +28,10 @@
* *
* Six development stylesheets are concatenated to 12 unified stylesheets. * Six development stylesheets are concatenated to 12 unified stylesheets.
* @see development/csscat.sh * @see development/csscat.sh
* Once these are minified, the temporary files are deleted, to streamline * Once these are minified, the temporary files are deleted to streamline
* the plugins codebase shipped in production. * the plugins codebase.
* The stylesheet file names consist of "footnotes-" and a code showing * The stylesheet file names consist of "footnotes-" and a code showing
* which one of the 5 additional stlesheets enter into its composition: * which additional stlesheets enter into its composition:
* *
* The first part of the code contains 4 letters showing whether tooltips * The first part of the code contains 4 letters showing whether tooltips
* are enabled, and if so, which implementation: jQuery or alternative: * are enabled, and if so, which implementation: jQuery or alternative:
@ -47,9 +47,6 @@
* 2 dev-layout-entry-content.css article without the title * 2 dev-layout-entry-content.css article without the title
* 3 dev-layout-main-content.css the article with its title * 3 dev-layout-main-content.css the article with its title
* *
* So you can easily determine which ones of the formatted stylesheets are
* relevant to your Footnotes installation under the current preferences.
*
* The dashboard stylesheet is minified as-is. * The dashboard stylesheet is minified as-is.
* @see class/dashboard/layout.php * @see class/dashboard/layout.php
* *
@ -124,6 +121,8 @@
* are not hyperlinked, while often the hyperlink text * are not hyperlinked, while often the hyperlink text
* is common language, that mustnt be broken anywhere. * is common language, that mustnt be broken anywhere.
* *
* The span is wrapped around URLs that are not values
* of HTML arguments, parameters or folder names.
* @see class/task.php * @see class/task.php
* *
* These rules arent cross-browser compatible: * These rules arent cross-browser compatible:
@ -132,10 +131,6 @@
* word-wrap: anywhere; * word-wrap: anywhere;
* word-break: break-all; * word-break: break-all;
* *
* These rules turn out useless for the purpose and are commented out:
* word-wrap: break-word;
* overflow-wrap: break-word;
*
* *
* - Bugfix: Reference container, tooltips: URL wrap: enable the 'word-wrap: anywhere' rule, thanks to @rebelc0de bug report. * - Bugfix: Reference container, tooltips: URL wrap: enable the 'word-wrap: anywhere' rule, thanks to @rebelc0de bug report.
* *
@ -143,6 +138,10 @@
* *
* @reporter @rebelc0de * @reporter @rebelc0de
* @link https://wordpress.org/support/topic/footnotes-on-mobile-phones/#post-14037101 * @link https://wordpress.org/support/topic/footnotes-on-mobile-phones/#post-14037101
*
* These rules turn out useless for the purpose and are commented out:
* word-wrap: break-word;
* overflow-wrap: break-word;
*/ */
.footnote_url_wrap { .footnote_url_wrap {

View file

@ -274,9 +274,9 @@ Use case: more extensive information not fitting into a brief
notice after the end of the settings box. notice after the end of the settings box.
*/ */
.footnotes_description { .footnotes_description {
padding: 0 6%; padding: 0 4%;
} }
.footnotes_description p { .footnotes_description p {
font-size: 1.2em; font-size: 1.06em;
font-style: italic; font-style: italic;
} }

View file

@ -4,7 +4,7 @@
Plugin URI: https://wordpress.org/plugins/footnotes/ Plugin URI: https://wordpress.org/plugins/footnotes/
Description: time to bring footnotes to your website! footnotes are known from offline publishing and everybody takes them for granted when reading a magazine. Description: time to bring footnotes to your website! footnotes are known from offline publishing and everybody takes them for granted when reading a magazine.
Author: Mark Cheret Author: Mark Cheret
Version: 2.5.5d0 Version: 2.5.5d1
Author URI: http://cheret.de/plugins/footnotes-2/ Author URI: http://cheret.de/plugins/footnotes-2/
Text Domain: footnotes Text Domain: footnotes
Domain Path: /languages Domain Path: /languages
@ -18,10 +18,10 @@
* @since 2.1.4 * @since 2.1.4
* @since 2.5.3 (Hungarian) * @since 2.5.3 (Hungarian)
* @var str * @var str
* @lastmodified 2021-02-16T0300+0100 * @lastmodified 2021-02-17T1028+0100
* @committer @pewgeuges * @committer @pewgeuges
*/ */
define( 'C_STR_FOOTNOTES_VERSION', '2.5.5d0' ); define( 'C_STR_FOOTNOTES_VERSION', '2.5.5d1' );
/* /*
LICENSE NOTICE LICENSE NOTICE

View file

@ -79,10 +79,12 @@ Visit this swift write-up from a **footnotes** user by the name of **Southwest**
== Changelog == == Changelog ==
= 2.5.5d0 = = 2.5.5 =
- Update: Stylesheets: increase speed and energy efficiency by tailoring stylesheets to the needs of the instance, thanks to @docteurfitness design contribution. - Update: Stylesheets: increase speed and energy efficiency by tailoring stylesheets to the needs of the instance, thanks to @docteurfitness design contribution.
- Bugfix: Stylesheets: minify to shrink the carbon footprint, increase speed and implement best practice, thanks to @docteurfitness issue report. - Bugfix: Stylesheets: minify to shrink the carbon footprint, increase speed and implement best practice, thanks to @docteurfitness issue report.
- Bugfix: Libraries: optimize processes by loading external and internal scripts only if needed, thanks to @docteurfitness issue report. - Bugfix: Libraries: optimize processes by loading external and internal scripts only if needed, thanks to @docteurfitness issue report.
- Update: Dashboard: add or edit descriptions to the tooltips and tooltip text delimiter settings and the backlink symbol configuration setting.
- Update: Dashboard: decrease font size and padding of the descriptions.
= 2.5.4 = = 2.5.4 =
- Bugfix: Referrers: optional fixes to vertical alignment, font size and position (static) for in-theme consistency and cross-theme stability, thanks to @tomturowski bug report. - Bugfix: Referrers: optional fixes to vertical alignment, font size and position (static) for in-theme consistency and cross-theme stability, thanks to @tomturowski bug report.

View file

@ -1,6 +1,3 @@
<div class="footnotes_description">
<p>[[description-symbol]]</p>
</div>
<table class="customize_hyperlink_arrow widefat fixed"> <table class="customize_hyperlink_arrow widefat fixed">
<tbody> <tbody>
<tr> <tr>
@ -13,3 +10,6 @@
</tr> </tr>
</tbody> </tbody>
</table> </table>
<div class="footnotes_description">
<p>[[description-symbol]]</p>
</div>

View file

@ -1,3 +1,6 @@
<div class="footnotes_description">
<p>[[description-delimiter]]</p>
</div>
<table class="mouse_over_box_text widefat fixed"> <table class="mouse_over_box_text widefat fixed">
<tbody> <tbody>
<tr> <tr>
@ -14,3 +17,6 @@
</tr> </tr>
</tbody> </tbody>
</table> </table>
<div class="footnotes_description">
<p>[[description-mirror]]</p>
</div>