Documentation

MCI_Footnotes_Layout_Settings extends MCI_Footnotes_LayoutEngine

Displays and handles all Settings of the Plugin.

Tags
author

Stefan Herndler

since
1.5.0

Table of Contents

$a_arr_Sections  : array<string|int, mixed>
Stores all Sections for the child sub page.
$a_str_SubPageHook  : null|string
Stores the Hook connection string for the child sub page.
CustomCSS()  : mixed
Displays the custom css box.
CustomCSSMigration()  : mixed
CustomCSSNew()  : mixed
Description()  : mixed
Output the Description of a section. May be overwritten in any section.
displayContent()  : mixed
Displays the content of specific sub page.
Donate()  : mixed
Displays all Donate button to support the developers.
Excerpts()  : mixed
Displays the excerpt setting
getPriority()  : int
Returns a Priority index. Lower numbers have a higher Priority.
Help()  : mixed
Displays a short introduction of the Plugin.
HyperlinkArrow()  : mixed
Displays all settings for the prepended symbol
LookupHooks()  : mixed
Displays available Hooks to look for Footnote short codes.
Love()  : mixed
Displays all settings for 'I love Footnotes'.
MouseOverBox()  : mixed
Displays all settings for the footnotes mouse-over box.
MouseOverBoxAppearance()  : mixed
MouseOverBoxDimensions()  : mixed
MouseOverBoxPosition()  : mixed
MouseOverBoxText()  : mixed
MouseOverBoxTiming()  : mixed
MouseOverBoxTruncation()  : mixed
Numbering()  : mixed
ReferenceContainer()  : mixed
Displays all settings for the reference container.
registerSections()  : mixed
Registers all sections for a sub page.
registerSubPage()  : mixed
Registers a sub page.
Scrolling()  : mixed
StartEnd()  : mixed
Displays all options for the footnotes start and end tag short codes Displays all options for the footnotes numbering Displays all options for the scrolling behavior
Superscript()  : mixed
Displays all settings for the footnote referrers
addCheckbox()  : string
Returns the html tag for an input [type = checkbox].
addColorSelection()  : string
Returns the html tag for an input [type = text] with color selection class.
addLabel()  : string
Returns the html tag for an input/select label.
addLineSpace()  : string
Returns a line break to have a space between two lines.
addMetaBox()  : array<string|int, mixed>
Returns an array describing a meta box.
addNewline()  : string
Returns a line break to start a new line.
addNumBox()  : string
Returns the html tag for an input [type = num].
addSection()  : array<string|int, mixed>
Returns an array describing a sub page section.
addSelectBox()  : string
Returns the html tag for a select box.
addText()  : string
Returns a simple text inside html <span> text.
addTextArea()  : string
Returns the html tag for a text area.
addTextBox()  : string
Returns the html tag for an input [type = text].
getMetaBoxes()  : array<string|int, mixed>
Returns an array of all registered meta boxes for each section of the sub page.
getSections()  : array<string|int, mixed>
Returns an array of all registered sections for the sub page.
getSubPageSlug()  : string
Returns the unique slug of the sub page.
getSubPageTitle()  : string
Returns the title of the sub page.
LoadSetting()  : array<string|int, mixed>
Loads specific setting and returns an array with the keys [id, name, value].
appendScripts()  : mixed
Append javascript and css files for specific sub page.
registerMetaBoxes()  : mixed
Registers all Meta boxes for a sub page.
saveSettings()  : bool
Save all Plugin settings.

Properties

$a_arr_Sections

Stores all Sections for the child sub page.

protected array<string|int, mixed> $a_arr_Sections = array()
Tags
author

Stefan Herndler

since
1.5.0

$a_str_SubPageHook

Stores the Hook connection string for the child sub page.

protected null|string $a_str_SubPageHook = ull
Tags
author

Stefan Herndler

since
1.5.0

Methods

CustomCSS()

Displays the custom css box.

public CustomCSS() : mixed
Tags
author

Stefan Herndler

since
1.5.0

Edited:

since
2.1.6

drop localized notices for CSS classes as the number increased to 16 list directly in the template, as CSS is in English anyway

since
2.2.2

migrate Custom CSS to a dedicated tab 2020-12-15T0506+0100

since
2.3.0

say 'copy-paste' instead of 'cut and paste' since cutting is not needed 2020-12-27T1257+0100

since
2.5.1

mention validity while visible, thanks to @rkupadhya bug report

see

templates/dashboard/customize-css.html 2020-12-09T1113+0100

Return values
mixed

CustomCSSMigration()

public CustomCSSMigration() : mixed
Return values
mixed

CustomCSSNew()

public CustomCSSNew() : mixed
Return values
mixed

Description()

Output the Description of a section. May be overwritten in any section.

public Description() : mixed
Tags
author

Stefan Herndler

since
1.5.0
Return values
mixed

displayContent()

Displays the content of specific sub page.

public displayContent() : mixed
Tags
author

Stefan Herndler

since
1.5.0
Return values
mixed

Donate()

Displays all Donate button to support the developers.

public Donate() : mixed
Tags
author

Stefan Herndler

since
1.5.0
Return values
mixed

getPriority()

Returns a Priority index. Lower numbers have a higher Priority.

public getPriority() : int
Tags
author

Stefan Herndler

since
1.5.0
Return values
int

Help()

Displays a short introduction of the Plugin.

public Help() : mixed
Tags
author

Stefan Herndler

since
1.5.0
Return values
mixed

HyperlinkArrow()

Displays all settings for the prepended symbol

public HyperlinkArrow() : mixed
Tags
author

Stefan Herndler

since
1.5.0

Edited heading for v2.0.4

The former 'hyperlink arrow', incompatible with combined identical footnotes, became 'prepended arrow' in v2.0.3 after a user complaint about missing backlinking semantics of the footnote number.

since
2.1.4

moved to Settings > Reference container > Display a backlink symbol

since
2.2.1

and 2.2.4 back here

Return values
mixed

LookupHooks()

Displays available Hooks to look for Footnote short codes.

public LookupHooks() : mixed
Tags
author

Stefan Herndler

since
1.5.5

Edited:

since
2.1.1

priority level setting for the_content 2020-11-16T2152+0100

since
2.1.4

priority level settings for the other hooks 2020-11-19T1421+0100

priority level was initially hard-coded default shows "9223372036854775807" in the numbox empty should be interpreted as PHP_INT_MAX, but a numbox cannot be set to empty: https://github.com/Modernizr/Modernizr/issues/171 define -1 as PHP_INT_MAX instead

since
2.2.9

removed the warning about the widget text hook 2020-12-25T0348+0100

since
2.2.9

added guidance for the widget text hook 2020-12-25T0353+0100

Return values
mixed

Love()

Displays all settings for 'I love Footnotes'.

public Love() : mixed
Tags
author

Stefan Herndler

since
1.5.0

Edited:

since
2.2.0

position-sensitive placeholders to support more locales 2020-12-11T0432+0100

since
2.2.0

more options 2020-12-11T0432+0100

Return values
mixed

MouseOverBox()

Displays all settings for the footnotes mouse-over box.

public MouseOverBox() : mixed
Tags
author

Stefan Herndler

since
1.5.2

Edited:

since
2.2.0

5 parts to address increased settings number

since
2.2.5

position settings for alternative tooltips

Return values
mixed

MouseOverBoxAppearance()

public MouseOverBoxAppearance() : mixed
Return values
mixed

MouseOverBoxDimensions()

public MouseOverBoxDimensions() : mixed
Return values
mixed

MouseOverBoxPosition()

public MouseOverBoxPosition() : mixed
Return values
mixed

MouseOverBoxText()

public MouseOverBoxText() : mixed
Return values
mixed

MouseOverBoxTiming()

public MouseOverBoxTiming() : mixed
Return values
mixed

MouseOverBoxTruncation()

public MouseOverBoxTruncation() : mixed
Return values
mixed

Numbering()

public Numbering() : mixed
Return values
mixed

registerSections()

Registers all sections for a sub page.

public registerSections() : mixed
Tags
author

Stefan Herndler

since
1.5.0
Return values
mixed

registerSubPage()

Registers a sub page.

public registerSubPage() : mixed
Tags
author

Stefan Herndler

since
1.5.0
Return values
mixed

Scrolling()

public Scrolling() : mixed
Return values
mixed

StartEnd()

Displays all options for the footnotes start and end tag short codes Displays all options for the footnotes numbering Displays all options for the scrolling behavior

public StartEnd() : mixed
Tags
author

Stefan Herndler

since
1.5.0

Edited heading 2020-12-12T1412+0100

since
2.2.0

start/end short codes: more predefined options 2020-12-12T1412+0100

since
2.2.0

3 boxes for clarity 2020-12-12T1422+0100

since
2.2.5

support for Ibid. notation thanks to @meglio 2020-12-17T2019+0100

since
2.4.0

added warning about Block Editor escapement disruption 2021-01-02T2324+0100

since
2.4.0

removed the HTML comment tag option 2021-01-02T2325+0100

since
2.5.0

Shortcode syntax validation: add more information around the setting, thanks to @andreasra

link
https://wordpress.org/support/topic/doesnt-work-with-mailpoet/
link
https://wordpress.org/support/topic/add-support-for-ibid-notation/
link
https://wordpress.org/support/topic/warning-unbalanced-footnote-start-tag-short-code-before/
Return values
mixed

Superscript()

Displays all settings for the footnote referrers

public Superscript() : mixed
Tags
author

Stefan Herndler

since
1.5.0

Edited heading 2020-12-12T1513+0100

since
2.1.1

option for superscript (optionally baseline referrers)

since
2.2.0

option for link element moved here 2020-12-12T1514+0100

Return values
mixed

addCheckbox()

Returns the html tag for an input [type = checkbox].

protected addCheckbox(string $p_str_SettingName) : string
Parameters
$p_str_SettingName : string

Name of the Settings key to pre load the input field.

Tags
author

Stefan Herndler

since
1.5.0
Return values
string

addColorSelection()

Returns the html tag for an input [type = text] with color selection class.

protected addColorSelection(string $p_str_SettingName) : string
Parameters
$p_str_SettingName : string

Name of the Settings key to pre load the input field.

Tags
author

Stefan Herndler

since
1.5.6
Return values
string

addLabel()

Returns the html tag for an input/select label.

protected addLabel(string $p_str_SettingName, string $p_str_Caption) : string
Parameters
$p_str_SettingName : string

Name of the Settings key to connect the Label with the input/select field.

$p_str_Caption : string

Label caption.

Tags
author

Stefan Herndler

since
1.5.0
since
2.1.6

no colon

Return values
string

Edited 2020-12-01T0159+0100..

addLineSpace()

Returns a line break to have a space between two lines.

protected addLineSpace() : string
Tags
author

Stefan Herndler

since
1.5.0
Return values
string

addMetaBox()

Returns an array describing a meta box.

protected addMetaBox(string $p_str_SectionID, string $p_str_ID, string $p_str_Title, string $p_str_CallbackFunctionName) : array<string|int, mixed>
Parameters
$p_str_SectionID : string

Parent Section ID.

$p_str_ID : string

Unique ID suffix.

$p_str_Title : string

Title for the meta box.

$p_str_CallbackFunctionName : string

Class method name for callback.

Tags
author

Stefan Herndler

since
1.5.0
Return values
array<string|int, mixed>

meta box description to be able to append a meta box to the output.

addNewline()

Returns a line break to start a new line.

protected addNewline() : string
Tags
author

Stefan Herndler

since
1.5.0
Return values
string

addNumBox()

Returns the html tag for an input [type = num].

protected addNumBox(string $p_str_SettingName, int $p_in_Min, int $p_int_Max[, bool $p_bool_Deci = false ]) : string
Parameters
$p_str_SettingName : string

Name of the Settings key to pre load the input field.

$p_in_Min : int

Minimum value.

$p_int_Max : int

Maximum value.

$p_bool_Deci : bool = false

true if 0.1 steps and floating to string, false if integer (default)

Tags
author

Stefan Herndler

since
1.5.0
since
2.1.4

step argument and number_format() to allow decimals 2020-12-03T0631+0100..2020-12-12T1110+0100

Return values
string

Edited:

addSection()

Returns an array describing a sub page section.

protected addSection(string $p_str_ID, string $p_str_Title, int $p_int_SettingsContainerIndex[, bool $p_bool_hasSubmitButton = true ]) : array<string|int, mixed>
Parameters
$p_str_ID : string

Unique ID suffix.

$p_str_Title : string

Title of the section.

$p_int_SettingsContainerIndex : int

Settings Container Index.

$p_bool_hasSubmitButton : bool = true

Should a Submit Button be displayed for this section, default: true.

Tags
author

Stefan Herndler

since
1.5.0
Return values
array<string|int, mixed>

Array describing the section.

addSelectBox()

Returns the html tag for a select box.

protected addSelectBox(string $p_str_SettingName, array<string|int, mixed> $p_arr_Options) : string
Parameters
$p_str_SettingName : string

Name of the Settings key to pre select the current value.

$p_arr_Options : array<string|int, mixed>

Possible options to be selected.

Tags
author

Stefan Herndler

since
1.5.0
Return values
string

addText()

Returns a simple text inside html <span> text.

protected addText(string $p_str_Text) : string
Parameters
$p_str_Text : string

Message to be surrounded with simple html tag (span).

Tags
author

Stefan Herndler

since
1.5.0
Return values
string

addTextArea()

Returns the html tag for a text area.

protected addTextArea(string $p_str_SettingName) : string
Parameters
$p_str_SettingName : string

Name of the Settings key to pre fill the text area.

Tags
author

Stefan Herndler

since
1.5.0
Return values
string

addTextBox()

Returns the html tag for an input [type = text].

protected addTextBox(string $p_str_SettingName[, int $p_str_MaxLength = 999 ][, bool $p_bool_Readonly = false ][, bool $p_bool_Hidden = false ]) : string
Parameters
$p_str_SettingName : string

Name of the Settings key to pre load the input field.

$p_str_MaxLength : int = 999

Maximum length of the input, default 999 characters.

$p_bool_Readonly : bool = false

Set the input to be read only, default false.

$p_bool_Hidden : bool = false

Set the input to be hidden, default false.

Tags
author

Stefan Herndler

since
1.5.0
Return values
string

getMetaBoxes()

Returns an array of all registered meta boxes for each section of the sub page.

protected getMetaBoxes() : array<string|int, mixed>
Tags
author

Stefan Herndler

since
1.5.0
since
2.0.0

discontinued

since
2.0.4

restored to meet user demand for arrow symbol semantics

since
2.1.4

discontinued, content moved to Settings > Reference container > Display a backlink symbol

since
2.0.4

to reflect changes in meta box label display since WPv5.5 spans need position:fixed and become unlocalizable fix: logo is kept only in the label that doesn’t need to be translated: Change string "%s styling" to "Footnotes styling" to fix layout in WPv5.5

since
2.1.6

/ 2.2.0 tabs reordered and renamed

see
details

in class/config.php

Return values
array<string|int, mixed>

Edited for 2.0.0 and later.

HyperlinkArrow meta box:

getSubPageSlug()

Returns the unique slug of the sub page.

protected getSubPageSlug() : string
Tags
author

Stefan Herndler

since
1.5.0
Return values
string

getSubPageTitle()

Returns the title of the sub page.

protected getSubPageTitle() : string
Tags
author

Stefan Herndler

since
1.5.0
Return values
string

LoadSetting()

Loads specific setting and returns an array with the keys [id, name, value].

protected LoadSetting(string $p_str_SettingKeyName) : array<string|int, mixed>
Parameters
$p_str_SettingKeyName : string

Settings Array key name.

Tags
author

Stefan Herndler

since
1.5.0
Return values
array<string|int, mixed>

Contains Settings ID, Settings Name and Settings Value.

appendScripts()

Append javascript and css files for specific sub page.

private appendScripts() : mixed
Tags
author

Stefan Herndler

since
1.5.0
Return values
mixed

registerMetaBoxes()

Registers all Meta boxes for a sub page.

private registerMetaBoxes(string $p_str_ParentID) : mixed
Parameters
$p_str_ParentID : string

Parent section unique id.

Tags
author

Stefan Herndler

since
1.5.0
Return values
mixed

saveSettings()

Save all Plugin settings.

private saveSettings() : bool
Tags
author

Stefan Herndler

since
1.5.0
Return values
bool

Search results