Documentation

Footnotes_Layout_Engine

Class to be extended by page layout sub-classes.

Tags
abstract
since
1.5.0

Table of Contents

$a_arr_sections  : array<string|int, mixed>
Stores all Sections for the child sub-page.
$a_str_sub_page_hook  : null|string
Stores the Hook connection string for the child sub-page.
$plugin_name  : string
The ID of this plugin.
description()  : mixed
Output the description of a section. May be overwritten in any section.
display_content()  : mixed
Displays the content of specific sub-page.
get_priority()  : int
Returns a Priority index. Lower numbers have a higher priority.
register_sections()  : mixed
Registers all sections for a sub-page.
register_sub_page()  : mixed
Registers a sub-page.
add_checkbox()  : string
Constructs the HTML for a checkbox `<input>` element.
add_color_selection()  : string
Constructs the HTML for a text `<input>` element with the colour selection class.
add_label()  : string
Returns the HTML tag for an `<input>`/`<select>` label.
add_meta_box()  : array<string|int, mixed>
Returns an array describing a meta box.
add_num_box()  : string
Constructs the HTML for numeric `<input>` element.
add_section()  : array<string|int, mixed>
Returns an array describing a sub-page section.
add_select_box()  : string
Constructs the HTML for a `<select>` element.
add_text()  : string
Returns a simple text inside HTML `<span>` element.
add_text_box()  : string
Constructs the HTML for a text `<input>` element.
add_textarea()  : string
Constructs the HTML for a `<textarea>` element.
get_meta_boxes()  : array<string|int, mixed>
Returns an array of all registered meta boxes.
get_sections()  : array<string|int, mixed>
Returns an array of all registered sections for a sub-page.
get_sub_page_slug()  : string
Returns the unique slug of the child sub-page.
get_sub_page_title()  : string
Returns the title of the child sub-page.
load_setting()  : array<string|int, mixed>
Loads a specified setting.
append_scripts()  : mixed
Append JavaScript and CSS files for specific sub-page.
register_meta_boxes()  : mixed
Registers all Meta boxes for a sub-page.
save_settings()  : 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
access

protected

since
1.5.0

$a_str_sub_page_hook

Stores the Hook connection string for the child sub-page.

protected null|string $a_str_sub_page_hook = ull
Tags
access

protected

since
1.5.0

Methods

description()

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

public description() : mixed
Tags
since
1.5.0
todo

Required? Should be abstract?

Return values
mixed —

display_content()

Displays the content of specific sub-page.

public display_content() : mixed
Tags
since
1.5.0
todo

Review nonce verification.

Return values
mixed —

get_priority()

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

public abstract get_priority() : int
Tags
abstract
since
1.5.0
Return values
int —

register_sections()

Registers all sections for a sub-page.

public register_sections() : mixed
Tags
since
1.5.0
Return values
mixed —

add_checkbox()

Constructs the HTML for a checkbox `<input>` element.

protected add_checkbox(string $p_str_setting_name) : string
Parameters
$p_str_setting_name : string

Setting key.

Tags
access

protected

since
1.5.0
todo

Refactor HTML generation.

Return values
string —

add_color_selection()

Constructs the HTML for a text `<input>` element with the colour selection class.

protected add_color_selection(string $p_str_setting_name) : string
Parameters
$p_str_setting_name : string

Setting key.

Tags
access

protected

since
1.5.6
todo

Refactor HTML generation.

todo

Use proper colorpicker element.

Return values
string —

add_label()

Returns the HTML tag for an `<input>`/`<select>` label.

protected add_label(string $p_str_setting_name, string $p_str_caption) : string
Parameters
$p_str_setting_name : string

Settings key.

$p_str_caption : string

Label caption.

Tags
access

protected

since
1.5.0
todo

Refactor HTML generation.

Return values
string —

add_meta_box()

Returns an array describing a meta box.

protected add_meta_box(string $p_str_section_id, string $p_str_id, string $p_str_title, string $p_str_callback_function_name) : array<string|int, mixed>
Parameters
$p_str_section_id : string

Parent section ID.

$p_str_id : string

Unique ID suffix.

$p_str_title : string

Title for the meta box.

$p_str_callback_function_name : string

Class method name for callback.

Tags
access

protected

since
1.5.0
todo

Refactor meta boxes into their own class?

todo

Pass actual functions rather than strings?

Return values
array<string|int, mixed> —

{ A dashboard meta box.

@type  string  $parent  Parent section ID.
@type  string  $id  Meta box ID.
@type  string  $title  Meta box title.
@type  string  $callback  Meta box callback function.

}

add_num_box()

Constructs the HTML for numeric `<input>` element.

protected add_num_box(string $p_str_setting_name, int $p_in_min, int $p_int_max[, bool $p_bool_deci = false ]) : string
Parameters
$p_str_setting_name : string

Setting key.

$p_in_min : int

Minimum value.

$p_int_max : int

Maximum value.

$p_bool_deci : bool = false

true if float, false if integer. Default false.

Tags
access

protected

since
1.5.0
todo

Refactor HTML generation.

Return values
string —

add_section()

Returns an array describing a sub-page section.

protected add_section(string $p_str_id, string $p_str_title, int $p_int_settings_container_index[, bool $p_bool_has_submit_button = true ]) : array<string|int, mixed>
Parameters
$p_str_id : string

Unique ID suffix.

$p_str_title : string

Title of the section.

$p_int_settings_container_index : int

Settings Container index.

$p_bool_has_submit_button : bool = true

Whether a ‘Submit’ button should be displayed for this section. Default true.

Tags
access

protected

since
1.5.0
todo

Refactor sections into their own class?

Return values
array<string|int, mixed> —

{ A dashboard section.

@type  string  $id  Section ID.
@type  string  $title  Section title.
@type  bool  $submit  Whether the section has a submit button or not.
@type  int  $container  Settings Container index.

}

add_select_box()

Constructs the HTML for a `<select>` element.

protected add_select_box(string $p_str_setting_name, array<string|int, mixed> $p_arr_options) : string
Parameters
$p_str_setting_name : string

Setting key.

$p_arr_options : array<string|int, mixed>

Possible options.

Tags
access

protected

since
1.5.0
todo

Refactor HTML generation.

Return values
string —

add_text()

Returns a simple text inside HTML `<span>` element.

protected add_text(string $p_str_text) : string
Parameters
$p_str_text : string

Message to be surrounded with <span> tags.

Tags
access

protected

since
1.5.0
todo

Refactor HTML generation.

Return values
string —

add_text_box()

Constructs the HTML for a text `<input>` element.

protected add_text_box(string $p_str_setting_name[, int $p_str_max_length = 999 ][, bool $p_bool_readonly = false ][, bool $p_bool_hidden = false ]) : string
Parameters
$p_str_setting_name : string

Setting key.

$p_str_max_length : int = 999

Maximum length of the input. Default length 999 chars.

$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
access

protected

since
1.5.0
todo

Refactor HTML generation.

Return values
string —

add_textarea()

Constructs the HTML for a `<textarea>` element.

protected add_textarea(string $p_str_setting_name) : string
Parameters
$p_str_setting_name : string

Setting key.

Tags
access

protected

since
1.5.0
todo

Refactor HTML generation.

Return values
string —

get_meta_boxes()

Returns an array of all registered meta boxes.

protected abstract get_meta_boxes() : array<string|int, mixed>
Tags
abstract
access

protected

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

get_sections()

Returns an array of all registered sections for a sub-page.

protected abstract get_sections() : array<string|int, mixed>
Tags
abstract
access

protected

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

get_sub_page_slug()

Returns the unique slug of the child sub-page.

protected abstract get_sub_page_slug() : string
Tags
abstract
access

protected

since
1.5.0
Return values
string —

get_sub_page_title()

Returns the title of the child sub-page.

protected abstract get_sub_page_title() : string
Tags
abstract
access

protected

since
1.5.0
Return values
string —

load_setting()

Loads a specified setting.

protected load_setting(string $p_str_setting_key_name) : array<string|int, mixed>
Parameters
$p_str_setting_key_name : string

Setting key.

Tags
access

protected

since
1.5.0
since
2.5.11

Broken due to accidental removal of esc_attr() call.

since
2.6.1

Restore esc_attr() call.

Return values
array<string|int, mixed> —

{ A configurable setting.

@type  string  $id  Setting key.
@type  string  $name  Setting name.
@type  string  $value  Setting value.

}

register_meta_boxes()

Registers all Meta boxes for a sub-page.

private register_meta_boxes(string $p_str_parent_id) : mixed
Parameters
$p_str_parent_id : string

Parent section unique ID.

Tags
access

private

since
1.5.0
Return values
mixed —

save_settings()

Save all plugin settings.

private save_settings() : bool
Tags
access

private

since
1.5.0
todo

Review nonce verification.

Return values
bool —

true on save success, else false.

Search results