Documentation

LoveSettingsGroup extends SettingsGroup
in package

Class defining the footnote love settings.

Tags
since
2.8.0

Table of Contents

FOOTNOTES_LOVE  = array('key' => 'footnote_inputfield_love', 'name' => 'Tell the world you're using the plugin!', 'default_value' => 'no', 'type' => 'string', 'input_type' => 'select', 'input_options' => array( // Logo only. 'text-3' => self::PLUGIN_SYMBOL, // Logo followed by heart symbol. 'text-4' => self::PLUGIN_SYMBOL . ' ' . self::LOVE_SYMBOL, // Logo preceded by heart symbol. 'text-5' => self::LOVE_SYMBOL . ' ' . self::PLUGIN_SYMBOL, // Translators: 2: heart symbol 1: footnotes logogram. 'text-1' => 'I ' . self::LOVE_SYMBOL . ' ' . self::PLUGIN_SYMBOL, // Translators: %s: Footnotes plugin logo. 'text-6' => 'This website uses ' . self::PLUGIN_SYMBOL, // Translators: %s: Footnotes plugin logo. 'text-7' => 'This website uses the ' . self::PLUGIN_SYMBOL . ' plugin', // Translators: %s: Footnotes plugin logo. 'text-2' => 'This website uses the awesome ' . self::PLUGIN_SYMBOL . ' plugin', 'random' => 'randomly determined display of either mention', // Translators: 1: Plugin logo.2: heart symbol. 'no' => 'no display of any mention in the footer', ))
Settings container key for the ‘I love footnotes’ text.
FOOTNOTES_NO_LOVE_SLUG  = array('key' => 'footnote_inputfield_no_love_slug', 'name' => 'Shortcode to inhibit the display of the ' . self::PLUGIN_SYMBOL . ' mention on specific pages', 'default_value' => '[[no footnotes: love]]', 'type' => 'string', 'input_type' => 'text')
Settings container key for the shortcode to NOT display the ‘LOVE ME’ slug on certain pages.
GROUP_ID  = 'love'
Setting group ID.
GROUP_NAME  = self::PLUGIN_SYMBOL . ' ' . self::LOVE_SYMBOL
Setting group name.
LOVE_SYMBOL  = '<span style="color:#ff6d3b; font-weight:bold;">&hearts;</span>'
The HTML 'love' symbol.
PLUGIN_SYMBOL  = '<span class="footnotes_logo footnotes_logo_part1">foot</span><span class="footnotes_logo footnotes_logo_part2">notes</span>'
The HTML Plugin logogram.
$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>
get_setting()  : Setting|null
get_setting_value()  : mixed
set_setting_value()  : bool
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

FOOTNOTES_LOVE

Settings container key for the ‘I love footnotes’ text.

public array<string|int, mixed> FOOTNOTES_LOVE = array('key' => 'footnote_inputfield_love', 'name' => 'Tell the world you're using the plugin!', 'default_value' => 'no', 'type' => 'string', 'input_type' => 'select', 'input_options' => array( // Logo only. 'text-3' => self::PLUGIN_SYMBOL, // Logo followed by heart symbol. 'text-4' => self::PLUGIN_SYMBOL . ' ' . self::LOVE_SYMBOL, // Logo preceded by heart symbol. 'text-5' => self::LOVE_SYMBOL . ' ' . self::PLUGIN_SYMBOL, // Translators: 2: heart symbol 1: footnotes logogram. 'text-1' => 'I ' . self::LOVE_SYMBOL . ' ' . self::PLUGIN_SYMBOL, // Translators: %s: Footnotes plugin logo. 'text-6' => 'This website uses ' . self::PLUGIN_SYMBOL, // Translators: %s: Footnotes plugin logo. 'text-7' => 'This website uses the ' . self::PLUGIN_SYMBOL . ' plugin', // Translators: %s: Footnotes plugin logo. 'text-2' => 'This website uses the awesome ' . self::PLUGIN_SYMBOL . ' plugin', 'random' => 'randomly determined display of either mention', // Translators: 1: Plugin logo.2: heart symbol. 'no' => 'no display of any mention in the footer', ))
Tags
since
1.5.0
since
2.8.0

Move from Settings to ReferenceContainerSettingsGroup. Convert from string to array.

FOOTNOTES_NO_LOVE_SLUG

Settings container key for the shortcode to NOT display the ‘LOVE ME’ slug on certain pages.

public array<string|int, mixed> FOOTNOTES_NO_LOVE_SLUG = array('key' => 'footnote_inputfield_no_love_slug', 'name' => 'Shortcode to inhibit the display of the ' . self::PLUGIN_SYMBOL . ' mention on specific pages', 'default_value' => '[[no footnotes: love]]', 'type' => 'string', 'input_type' => 'text')
Tags
since
1.5.0
since
2.8.0

Move from Config to ReferenceContainerSettingsGroup. Rename from NO_LOVE_SLUG to FOOTNOTES_NO_LOVE_SLUG. Convert from string to array.

GROUP_NAME

Setting group name.

public string GROUP_NAME = self::PLUGIN_SYMBOL . ' ' . self::LOVE_SYMBOL
Tags
since
2.8.0

LOVE_SYMBOL

The HTML 'love' symbol.

public string LOVE_SYMBOL = '<span style="color:#ff6d3b; font-weight:bold;">&hearts;</span>'
Tags
since
2.8.0

PLUGIN_SYMBOL

The HTML Plugin logogram.

public string PLUGIN_SYMBOL = '<span class="footnotes_logo footnotes_logo_part1">foot</span><span class="footnotes_logo footnotes_logo_part2">notes</span>'
Tags
since
2.8.0

Properties

$options_group_slug

Setting options group slug.

protected string $options_group_slug
Tags
since
2.8.0

$setting_classes

The setting classes.

protected array<string|int, mixed> $setting_classes
Tags
since
2.8.0

$settings

The settings in this group.

protected array<string|int, mixed> $settings
Tags
since
2.8.0

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
since
2.8.0
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
since
2.8.0
Return values
void

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
since
2.8.0
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
see
SettingsGroup::add_settings()
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
since
2.8.0
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.

Tags
since
2.8.0
todo

Remove settings from options group when not found.

Return values
void

Search results