HardLinksSettingsGroup
extends SettingsGroup
in package
Class defining the hard links settings.
Tags
Table of Contents
- FOOTNOTE_FRAGMENT_ID_SLUG = array('key' => 'footnotes_inputfield_footnote_fragment_id_slug', 'name' => 'Fragment Identifier Slug for Footnotes', 'description' => 'This will show up in the address bar after clicking on a hard-linked footnote referrer.', 'default_value' => 'f', 'type' => 'string', 'input_type' => 'text')
- Settings container key for the fragment ID slug in footnotes.
- FOOTNOTES_BACKLINK_TOOLTIP_ENABLE = array('key' => 'footnotes_inputfield_backlink_tooltip_enable', 'name' => 'Enable Backlink Tooltips', 'description' => 'Hard backlinks get ordinary tooltips hinting to use the backbutton instead to keep it usable.', 'default_value' => true, 'type' => 'boolean', 'input_type' => 'checkbox')
- Settings container key to enable backlink tooltips.
- FOOTNOTES_BACKLINK_TOOLTIP_TEXT = array('key' => 'footnotes_inputfield_backlink_tooltip_text', 'name' => 'Backlink Tooltip Text', 'description' => 'Default text is the keyboard shortcut; may be a localized descriptive hint.', 'default_value' => 'Alt + ←', 'type' => 'string', 'input_type' => 'text')
- Settings container key to configure the backlink tooltip.
- FOOTNOTES_HARD_LINKS_ENABLE = array('key' => 'footnotes_inputfield_hard_links_enable', 'name' => 'Enable Hard Links', 'description' => 'Hard links disable jQuery delays but have the same scroll offset, and allow to share footnotes (accessed if the list is not collapsed by default).', 'default_value' => false, 'type' => 'boolean', 'input_type' => 'checkbox')
- Settings container key to enable hard links.
- GROUP_ID = 'hard-links'
- Setting group ID.
- GROUP_NAME = 'URL Fragment ID Configuration'
- Setting group name.
- HARD_LINK_IDS_SEPARATOR = array('key' => 'footnotes_inputfield_hard_link_ids_separator', 'name' => 'ID Separator', 'description' => 'May be empty or any string, for example _, - or +, to distinguish post number, container number and footnote number.', 'default_value' => '+', 'type' => 'string', 'input_type' => 'text')
- Settings container key for the ID separator in fragment IDs.
- REFERRER_FRAGMENT_ID_SLUG = array('key' => 'footnotes_inputfield_referrer_fragment_id_slug', 'name' => 'Fragment Identifier Slug for Footnote Referrers', 'description' => 'This will show up in the address bar after clicking on a hard-linked backlink.', 'default_value' => 'r', 'type' => 'string', 'input_type' => 'text')
- Settings container key for the fragment ID slug in referrers.
- $options_group_slug : string
- Setting options group slug.
- $section_slug : string
- Setting section slug.
- $setting_classes : array<string|int, mixed>
- The setting classes.
- $settings : array<string|int, mixed>
- The settings in this group.
- $settings_obj : Settings
- The plugin settings object.
- __construct() : mixed
- Constructs the settings section.
- add_settings_fields() : void
- Adds all the settings fields for this group to the admin. dashboard.
- get_options() : array<string|int, mixed>
- Creates an options group from the values of the settings in this section.
- get_setting() : Setting|null
- Retrieve a setting by its key.
- get_setting_value() : mixed
- Get a setting's value by its key.
- set_setting_value() : bool
- Set a setting's value by its key.
- add_setting() : Setting
- Constructs settings from the provided details.
- add_settings() : void
- Add the settings for this settings group.
- load_dependencies() : void
- Load the required dependencies.
- load_values() : void
- Load the values for this settings group.
Constants
FOOTNOTE_FRAGMENT_ID_SLUG
Settings container key for the fragment ID slug in footnotes.
public
array<string|int, mixed>
FOOTNOTE_FRAGMENT_ID_SLUG
= array('key' => 'footnotes_inputfield_footnote_fragment_id_slug', 'name' => 'Fragment Identifier Slug for Footnotes', 'description' => 'This will show up in the address bar after clicking on a hard-linked footnote referrer.', 'default_value' => 'f', 'type' => 'string', 'input_type' => 'text')
Tags
FOOTNOTES_BACKLINK_TOOLTIP_ENABLE
Settings container key to enable backlink tooltips.
public
array<string|int, mixed>
FOOTNOTES_BACKLINK_TOOLTIP_ENABLE
= array('key' => 'footnotes_inputfield_backlink_tooltip_enable', 'name' => 'Enable Backlink Tooltips', 'description' => 'Hard backlinks get ordinary tooltips hinting to use the backbutton instead to keep it usable.', 'default_value' => true, 'type' => 'boolean', 'input_type' => 'checkbox')
When hard links are enabled, clicks on the backlinks are logged in the browsing history, along with clicks on the referrers. This tooltip hints to use the backbutton instead, so the history gets streamlined again. See here for more information.
Tags
FOOTNOTES_BACKLINK_TOOLTIP_TEXT
Settings container key to configure the backlink tooltip.
public
array<string|int, mixed>
FOOTNOTES_BACKLINK_TOOLTIP_TEXT
= array('key' => 'footnotes_inputfield_backlink_tooltip_text', 'name' => 'Backlink Tooltip Text', 'description' => 'Default text is the keyboard shortcut; may be a localized descriptive hint.', 'default_value' => 'Alt + ←', 'type' => 'string', 'input_type' => 'text')
Tags
FOOTNOTES_HARD_LINKS_ENABLE
Settings container key to enable hard links.
public
array<string|int, mixed>
FOOTNOTES_HARD_LINKS_ENABLE
= array('key' => 'footnotes_inputfield_hard_links_enable', 'name' => 'Enable Hard Links', 'description' => 'Hard links disable jQuery delays but have the same scroll offset, and allow to share footnotes (accessed if the list is not collapsed by default).', 'default_value' => false, 'type' => 'boolean', 'input_type' => 'checkbox')
When the alternative reference container is enabled, hard links are too.
Tags
GROUP_ID
Setting group ID.
public
string
GROUP_ID
= 'hard-links'
Tags
GROUP_NAME
Setting group name.
public
string
GROUP_NAME
= 'URL Fragment ID Configuration'
Tags
HARD_LINK_IDS_SEPARATOR
Settings container key for the ID separator in fragment IDs.
public
array<string|int, mixed>
HARD_LINK_IDS_SEPARATOR
= array('key' => 'footnotes_inputfield_hard_link_ids_separator', 'name' => 'ID Separator', 'description' => 'May be empty or any string, for example _, - or +, to distinguish post number, container number and footnote number.', 'default_value' => '+', 'type' => 'string', 'input_type' => 'text')
Tags
REFERRER_FRAGMENT_ID_SLUG
Settings container key for the fragment ID slug in referrers.
public
array<string|int, mixed>
REFERRER_FRAGMENT_ID_SLUG
= array('key' => 'footnotes_inputfield_referrer_fragment_id_slug', 'name' => 'Fragment Identifier Slug for Footnote Referrers', 'description' => 'This will show up in the address bar after clicking on a hard-linked backlink.', 'default_value' => 'r', 'type' => 'string', 'input_type' => 'text')
Tags
Properties
$options_group_slug
Setting options group slug.
protected
string
$options_group_slug
Tags
$section_slug
Setting section slug.
protected
string
$section_slug
Tags
$setting_classes
The setting classes.
protected
array<string|int, mixed>
$setting_classes
Tags
$settings
The settings in this group.
protected
array<string|int, mixed>
$settings
Tags
$settings_obj
The plugin settings object.
protected
Settings
$settings_obj
Tags
Methods
__construct()
Constructs the settings section.
public
__construct(string $options_group_slug, string $section_slug, Settings $settings_obj) : mixed
Parameters
- $options_group_slug : string
- $section_slug : string
- $settings_obj : Settings
Tags
Return values
mixed —add_settings_fields()
Adds all the settings fields for this group to the admin. dashboard.
public
add_settings_fields(SettingsPage $component) : void
Parameters
- $component : SettingsPage
-
The admin. dashboard settings page.
Tags
Return values
void —get_options()
Creates an options group from the values of the settings in this section.
public
get_options() : array<string|int, mixed>
Tags
Return values
array<string|int, mixed> —get_setting()
Retrieve a setting by its key.
public
get_setting(string $setting_key) : Setting|null
Parameters
- $setting_key : string
Tags
Return values
Setting|null —get_setting_value()
Get a setting's value by its key.
public
get_setting_value(string $setting_key) : mixed
Parameters
- $setting_key : string
Tags
Return values
mixed —set_setting_value()
Set a setting's value by its key.
public
set_setting_value(string $setting_key, mixed $value) : bool
Parameters
- $setting_key : string
- $value : mixed
Tags
Return values
bool —add_setting()
Constructs settings from the provided details.
protected
add_setting(array<string, mixed> $setting) : Setting
Parameters
- $setting : array<string, mixed>
-
The setting details.
Tags
Return values
Setting —The constructed setting object.
add_settings()
Add the settings for this settings group.
protected
add_settings(array<string|int, mixed>|false $options) : void
Parameters
- $options : array<string|int, mixed>|false
-
Saved values for the settings in this group. 'False' if none exist.
Tags
Return values
void —load_dependencies()
Load the required dependencies.
protected
load_dependencies() : void
Include the following files that provide the settings for this plugin:
- Setting: defines individual settings.
Tags
Return values
void —load_values()
Load the values for this settings group.
protected
load_values(array<string, mixed>|false $options) : void
Parameters
- $options : array<string, mixed>|false
-
Saved values for the settings in this group. 'False' if none exist.