258e3c6070
Needed to share in a Forum topic where the problem came up incidentally. Must also be shared in the Forum topic of the related bug report. This also contains an escapement reversal (without known incidence on the plugin’s behavior). = 2.6.1 = - Bugfix: Tooltips: Styling: Font color: set to black for maximum contrast with respect to white default background, thanks to 4msc bug report. - Bugfix: Tooltips: Styling: Background color: set default value back to white because empty doesn’t work out as expected. = Branches = Delete the staging branch. Rationale: - It is outdated an cannot be used for staging any more. - It had been made improperly on its own instead of copying from trunk/. - It is undue for the following reasons: - Staging release processes here is too dangerous. - Staging release processes here is too little effective. Staging must not take place in this repository but in another SVN instance. git-svn-id: https://plugins.svn.wordpress.org/footnotes/trunk@2504324 b8457f37-d9ea-0310-8a92-e5e31aec5664
587 lines
19 KiB
PHP
587 lines
19 KiB
PHP
<?php // phpcs:disable WordPress.Files.FileName.InvalidClassFileName, WordPress.Security.ValidatedSanitizedInput.InputNotSanitized, WordPress.Security.EscapeOutput.OutputNotEscaped
|
|
/**
|
|
* Includes Layout Engine for the admin dashboard.
|
|
*
|
|
* @filesource
|
|
* @package footnotes
|
|
* @since 1.5.0
|
|
* @date 12.09.14 10:56
|
|
*
|
|
* @since 2.1.2 add versioning of settings.css for cache busting 2020-11-19T1456+0100
|
|
* @since 2.1.4 automate passing version number for cache busting 2020-11-30T0648+0100
|
|
* @since 2.1.4 optional step argument and support for floating in numbox 2020-12-05T0540+0100
|
|
* @since 2.1.6 fix punctuation-related localization issue in dashboard labels 2020-12-08T1547+0100
|
|
*
|
|
* @since 2.5.5 Bugfix: Stylesheets: minify to shrink the carbon footprint, increase speed and implement best practice, thanks to @docteurfitness issue report.
|
|
*/
|
|
|
|
/**
|
|
* Layout Engine for the administration dashboard.
|
|
*
|
|
* @since 1.5.0
|
|
*/
|
|
abstract class MCI_Footnotes_Layout_Engine {
|
|
|
|
/**
|
|
* Stores the Hook connection string for the child sub page.
|
|
*
|
|
* @since 1.5.0
|
|
* @var null|string
|
|
*/
|
|
protected $a_str_sub_page_hook = null;
|
|
|
|
/**
|
|
* Stores all Sections for the child sub page.
|
|
*
|
|
* @since 1.5.0
|
|
* @var array
|
|
*/
|
|
protected $a_arr_sections = array();
|
|
|
|
/**
|
|
* Returns a Priority index. Lower numbers have a higher Priority.
|
|
*
|
|
* @since 1.5.0
|
|
* @return int
|
|
*/
|
|
abstract public function get_priority();
|
|
|
|
/**
|
|
* Returns the unique slug of the child sub page.
|
|
*
|
|
* @since 1.5.0
|
|
* @return string
|
|
*/
|
|
abstract protected function get_sub_page_slug();
|
|
|
|
/**
|
|
* Returns the title of the child sub page.
|
|
*
|
|
* @since 1.5.0
|
|
* @return string
|
|
*/
|
|
abstract protected function get_sub_page_title();
|
|
|
|
/**
|
|
* Returns an array of all registered sections for a sub page.
|
|
*
|
|
* @since 1.5.0
|
|
* @return array
|
|
*/
|
|
abstract protected function get_sections();
|
|
|
|
/**
|
|
* Returns an array of all registered meta boxes.
|
|
*
|
|
* @since 1.5.0
|
|
* @return array
|
|
*/
|
|
abstract protected function get_meta_boxes();
|
|
|
|
/**
|
|
* Returns an array describing a sub page section.
|
|
*
|
|
* @since 1.5.0
|
|
* @param string $p_str_id Unique ID suffix.
|
|
* @param string $p_str_title Title of the section.
|
|
* @param int $p_int_settings_container_index Settings Container Index.
|
|
* @param bool $p_bool_has_submit_button Should a Submit Button be displayed for this section, default: true.
|
|
* @return array Array describing the section.
|
|
*/
|
|
protected function add_section( $p_str_id, $p_str_title, $p_int_settings_container_index, $p_bool_has_submit_button = true ) {
|
|
return array(
|
|
'id' => MCI_Footnotes_Config::C_STR_PLUGIN_NAME . '-' . $p_str_id,
|
|
'title' => $p_str_title,
|
|
'submit' => $p_bool_has_submit_button,
|
|
'container' => $p_int_settings_container_index,
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Returns an array describing a meta box.
|
|
*
|
|
* @since 1.5.0
|
|
* @param string $p_str_section_id Parent Section ID.
|
|
* @param string $p_str_id Unique ID suffix.
|
|
* @param string $p_str_title Title for the meta box.
|
|
* @param string $p_str_callback_function_name Class method name for callback.
|
|
* @return array meta box description to be able to append a meta box to the output.
|
|
*/
|
|
protected function add_meta_box( $p_str_section_id, $p_str_id, $p_str_title, $p_str_callback_function_name ) {
|
|
return array(
|
|
'parent' => MCI_Footnotes_Config::C_STR_PLUGIN_NAME . '-' . $p_str_section_id,
|
|
'id' => $p_str_id,
|
|
'title' => $p_str_title,
|
|
'callback' => $p_str_callback_function_name,
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Registers a sub page.
|
|
*
|
|
* @since 1.5.0
|
|
*/
|
|
public function register_sub_page() {
|
|
global $submenu;
|
|
|
|
if ( array_key_exists( plugin_basename( MCI_Footnotes_Layout_Init::C_STR_MAIN_MENU_SLUG ), $submenu ) ) {
|
|
foreach ( $submenu[ plugin_basename( MCI_Footnotes_Layout_Init::C_STR_MAIN_MENU_SLUG ) ] as $l_arr_sub_menu ) {
|
|
if ( plugin_basename( MCI_Footnotes_Layout_Init::C_STR_MAIN_MENU_SLUG . $this->get_sub_page_slug() ) === $l_arr_sub_menu[2] ) {
|
|
remove_submenu_page( MCI_Footnotes_Layout_Init::C_STR_MAIN_MENU_SLUG, MCI_Footnotes_Layout_Init::C_STR_MAIN_MENU_SLUG . $this->get_sub_page_slug() );
|
|
}
|
|
}
|
|
}
|
|
|
|
$this->a_str_sub_page_hook = add_submenu_page(
|
|
MCI_Footnotes_Layout_Init::C_STR_MAIN_MENU_SLUG,
|
|
$this->get_sub_page_title(),
|
|
$this->get_sub_page_title(),
|
|
'manage_options',
|
|
MCI_Footnotes_Layout_Init::C_STR_MAIN_MENU_SLUG . $this->get_sub_page_slug(),
|
|
array( $this, 'display_content' )
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Registers all sections for a sub page.
|
|
*
|
|
* @since 1.5.0
|
|
*/
|
|
public function register_sections() {
|
|
foreach ( $this->get_sections() as $l_arr_section ) {
|
|
// Append tab to the tab-array.
|
|
$this->a_arr_sections[ $l_arr_section['id'] ] = $l_arr_section;
|
|
add_settings_section(
|
|
$l_arr_section['id'],
|
|
'',
|
|
array( $this, 'Description' ),
|
|
$l_arr_section['id']
|
|
);
|
|
$this->register_meta_boxes( $l_arr_section['id'] );
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Registers all Meta boxes for a sub page.
|
|
*
|
|
* @since 1.5.0
|
|
* @param string $p_str_parent_id Parent section unique id.
|
|
*/
|
|
private function register_meta_boxes( $p_str_parent_id ) {
|
|
// Iterate through each meta box.
|
|
foreach ( $this->get_meta_boxes() as $l_arr_meta_box ) {
|
|
if ( $p_str_parent_id !== $l_arr_meta_box['parent'] ) {
|
|
continue;
|
|
}
|
|
add_meta_box(
|
|
$p_str_parent_id . '-' . $l_arr_meta_box['id'],
|
|
$l_arr_meta_box['title'],
|
|
array( $this, $l_arr_meta_box['callback'] ),
|
|
$p_str_parent_id,
|
|
'main'
|
|
);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Append javascript and css files for specific sub page.
|
|
*
|
|
* @since 1.5.0
|
|
*/
|
|
private function append_scripts() {
|
|
wp_enqueue_script( 'postbox' );
|
|
wp_enqueue_style( 'wp-color-picker' );
|
|
wp_enqueue_script( 'wp-color-picker' );
|
|
|
|
/**
|
|
* Registers and enqueues the dashboard stylesheet.
|
|
*
|
|
* - Bugfix: Stylesheets: minify to shrink the carbon footprint, increase speed and implement best practice, thanks to @docteurfitness issue report.
|
|
*
|
|
* @since 2.5.5
|
|
* @date 2021-02-14T1928+0100
|
|
*
|
|
* @reporter @docteurfitness
|
|
* @link https://wordpress.org/support/topic/simply-speed-optimisation/
|
|
*
|
|
* See the public stylesheet enqueuing:
|
|
* @see class/init.php
|
|
*
|
|
* added version # after changes started to settings.css from 2.1.2 on.
|
|
* automated update of version number for cache busting.
|
|
* No need to use '-styles' in the handle, as '-css' is appended automatically.
|
|
*/
|
|
if ( true === C_BOOL_CSS_PRODUCTION_MODE ) {
|
|
|
|
wp_register_style( 'mci-footnotes-admin', plugins_url( 'footnotes/css/settings.min.css' ), array(), C_STR_PACKAGE_VERSION );
|
|
|
|
} else {
|
|
|
|
wp_register_style( 'mci-footnotes-admin', plugins_url( 'footnotes/css/settings.css' ), array(), C_STR_PACKAGE_VERSION );
|
|
|
|
}
|
|
|
|
wp_enqueue_style( 'mci-footnotes-admin' );
|
|
}
|
|
|
|
// phpcs:disable WordPress.Security.NonceVerification.Recommended, WordPress.Security.NonceVerification.Missing
|
|
/**
|
|
* Displays the content of specific sub page.
|
|
*
|
|
* @since 1.5.0
|
|
*/
|
|
public function display_content() {
|
|
$this->append_scripts();
|
|
|
|
// TODO: add nonce verification.
|
|
|
|
// Get the current section.
|
|
reset( $this->a_arr_sections );
|
|
$l_str_active_section_id = isset( $_GET['t'] ) ? wp_unslash( $_GET['t'] ) : key( $this->a_arr_sections );
|
|
$l_arr_active_section = $this->a_arr_sections[ $l_str_active_section_id ];
|
|
|
|
// Store settings.
|
|
$l_bool_settings_updated = false;
|
|
if ( array_key_exists( 'save-settings', $_POST ) ) {
|
|
if ( 'save' === $_POST['save-settings'] ) {
|
|
unset( $_POST['save-settings'] );
|
|
unset( $_POST['submit'] );
|
|
$l_bool_settings_updated = $this->save_settings();
|
|
}
|
|
}
|
|
|
|
// Display all sections and highlight the active section.
|
|
echo '<div class="wrap">';
|
|
echo '<h2 class="nav-tab-wrapper">';
|
|
// Iterate through all register sections.
|
|
foreach ( $this->a_arr_sections as $l_str_id => $l_arr_description ) {
|
|
$l_str_tab_active = ( $l_str_id === $l_arr_active_section['id'] ) ? ' nav-tab-active' : '';
|
|
echo sprintf(
|
|
'<a class="nav-tab%s" href="?page=%s&t=%s">%s</a>',
|
|
( $l_str_id === $l_arr_active_section['id'] ) ? ' nav-tab-active' : '',
|
|
MCI_Footnotes_Layout_Init::C_STR_MAIN_MENU_SLUG . $this->get_sub_page_slug(),
|
|
$l_str_id,
|
|
$l_arr_description['title']
|
|
);
|
|
}
|
|
echo '</h2><br/>';
|
|
|
|
if ( $l_bool_settings_updated ) {
|
|
echo sprintf( '<div id="message" class="updated">%s</div>', __( 'Settings saved', 'footnotes' ) );
|
|
}
|
|
|
|
// Form to submit the active section.
|
|
echo '<!--suppress HtmlUnknownTarget --><form method="post" action="">';
|
|
echo '<input type="hidden" name="save-settings" value="save" />';
|
|
// Outputs the settings field of the active section.
|
|
do_settings_sections( $l_arr_active_section['id'] );
|
|
do_meta_boxes( $l_arr_active_section['id'], 'main', null );
|
|
|
|
// Add submit button to active section if defined.
|
|
if ( $l_arr_active_section['submit'] ) {
|
|
submit_button();
|
|
}
|
|
echo '</form>';
|
|
echo '</div>';
|
|
|
|
// Echo JavaScript for the expand/collapse function of the meta boxes.
|
|
echo '<script type="text/javascript">';
|
|
echo 'jQuery(document).ready(function ($) {';
|
|
echo 'jQuery(".mfmmf-color-picker").wpColorPicker();';
|
|
echo "jQuery('.if-js-closed').removeClass('if-js-closed').addClass('closed');";
|
|
echo "postboxes.add_postbox_toggles('" . $this->a_str_sub_page_hook . "');";
|
|
echo '});';
|
|
echo '</script>';
|
|
}
|
|
// phpcs:enable WordPress.Security.NonceVerification.Recommended, WordPress.Security.NonceVerification.Missing
|
|
|
|
// phpcs:disable WordPress.Security.NonceVerification.Recommended, WordPress.Security.NonceVerification.Missing
|
|
/**
|
|
* Save all Plugin settings.
|
|
*
|
|
* @since 1.5.0
|
|
* @return bool
|
|
*/
|
|
private function save_settings() {
|
|
$l_arr_new_settings = array();
|
|
|
|
// TODO: add nonce verification.
|
|
|
|
// Get current section.
|
|
reset( $this->a_arr_sections );
|
|
$l_str_active_section_id = isset( $_GET['t'] ) ? wp_unslash( $_GET['t'] ) : key( $this->a_arr_sections );
|
|
$l_arr_active_section = $this->a_arr_sections[ $l_str_active_section_id ];
|
|
|
|
foreach ( MCI_Footnotes_Settings::instance()->get_defaults( $l_arr_active_section['container'] ) as $l_str_key => $l_mixed_value ) {
|
|
if ( array_key_exists( $l_str_key, $_POST ) ) {
|
|
$l_arr_new_settings[ $l_str_key ] = wp_unslash( $_POST[ $l_str_key ] );
|
|
} else {
|
|
// Setting is not defined in the POST array, define it to avoid the Default value.
|
|
$l_arr_new_settings[ $l_str_key ] = '';
|
|
}
|
|
}
|
|
// Update settings.
|
|
return MCI_Footnotes_Settings::instance()->save_options( $l_arr_active_section['container'], $l_arr_new_settings );
|
|
}
|
|
// phpcs:enable WordPress.Security.NonceVerification.Recommended, WordPress.Security.NonceVerification.Missing
|
|
|
|
/**
|
|
* Output the Description of a section. May be overwritten in any section.
|
|
*
|
|
* @since 1.5.0
|
|
*/
|
|
public function description() {
|
|
// Default no description will be displayed.
|
|
}
|
|
|
|
/**
|
|
* Loads specific setting and returns an array with the keys [id, name, value].
|
|
*
|
|
* @since 1.5.0
|
|
* @param string $p_str_setting_key_name Settings Array key name.
|
|
* @return array Contains Settings ID, Settings Name and Settings Value.
|
|
*
|
|
* @since 2.5.11 Remove escapement function.
|
|
* When refactoring the codebase after 2.5.8, all and every output was escaped.
|
|
* After noticing that the plugin was broken, all escapement functions were removed.
|
|
* @link https://github.com/markcheret/footnotes/pull/50/commits/25c3f2f12eb5de1079e9215bf624ec4289b095a5
|
|
* @link https://github.com/markcheret/footnotes/pull/50#issuecomment-787624123
|
|
* In that process, this instance of esc_attr() was removed too, so the plugin was
|
|
* broken again.
|
|
* @link https://github.com/markcheret/footnotes/pull/50/commits/25c3f2f12eb5de1079e9215bf624ec4289b095a5#diff-a8ed6e859c32a18fc10bbbad3b4dd8ce7f43f2378d29471c7638e314ab30f1bdL349-L354
|
|
*
|
|
* @since 2.5.15 To fix it, the data was escaped in add_select_box() instead.
|
|
* @since 2.6.1 Restore esc_attr() in load_setting().
|
|
* @see add_select_box()
|
|
* This is the only instance of esc_|kses|sanitize in the pre-2.5.11 codebase.
|
|
* Removing this did not fix the quotation mark backslash escapement bug.
|
|
*/
|
|
protected function load_setting( $p_str_setting_key_name ) {
|
|
// Get current section.
|
|
reset( $this->a_arr_sections );
|
|
$p_arr_return = array();
|
|
$p_arr_return['id'] = sprintf( '%s', $p_str_setting_key_name );
|
|
$p_arr_return['name'] = sprintf( '%s', $p_str_setting_key_name );
|
|
$p_arr_return['value'] = esc_attr( MCI_Footnotes_Settings::instance()->get( $p_str_setting_key_name ) );
|
|
return $p_arr_return;
|
|
}
|
|
|
|
/**
|
|
* Returns a line break to start a new line.
|
|
*
|
|
* @since 1.5.0
|
|
* @return string
|
|
*/
|
|
protected function add_newline() {
|
|
return '<br/>';
|
|
}
|
|
|
|
/**
|
|
* Returns a line break to have a space between two lines.
|
|
*
|
|
* @since 1.5.0
|
|
* @return string
|
|
*/
|
|
protected function add_line_space() {
|
|
return '<br/><br/>';
|
|
}
|
|
|
|
/**
|
|
* Returns a simple text inside html <span> text.
|
|
*
|
|
* @since 1.5.0
|
|
* @param string $p_str_text Message to be surrounded with simple html tag (span).
|
|
* @return string
|
|
*/
|
|
protected function add_text( $p_str_text ) {
|
|
return sprintf( '<span>%s</span>', $p_str_text );
|
|
}
|
|
|
|
/**
|
|
* Returns the html tag for an input/select label.
|
|
*
|
|
* @since 1.5.0
|
|
* @param string $p_str_setting_name Name of the Settings key to connect the Label with the input/select field.
|
|
* @param string $p_str_caption Label caption.
|
|
* @return string
|
|
*/
|
|
protected function add_label( $p_str_setting_name, $p_str_caption ) {
|
|
if ( empty( $p_str_caption ) ) {
|
|
return '';
|
|
}
|
|
|
|
/*
|
|
* Remove the colon causing localization issues with French, and with
|
|
* languages not using punctuation at all, and with languages using other
|
|
* punctuation marks instead of colon, e.g. Greek using a raised dot.
|
|
* In French, colon is preceded by a space, forcibly non-breaking, and
|
|
* narrow per new school.
|
|
* Add colon to label strings for inclusion in localization. Colon after
|
|
* label is widely preferred best practice, mandatory per
|
|
* [style guides](https://softwareengineering.stackexchange.com/questions/234546/colons-in-internationalized-ui).
|
|
*/
|
|
return sprintf( '<label for="%s">%s</label>', $p_str_setting_name, $p_str_caption );
|
|
}
|
|
|
|
/**
|
|
* Returns the html tag for an input [type = text].
|
|
*
|
|
* @since 1.5.0
|
|
* @param string $p_str_setting_name Name of the Settings key to pre load the input field.
|
|
* @param int $p_str_max_length Maximum length of the input, default 999 characters.
|
|
* @param bool $p_bool_readonly Set the input to be read only, default false.
|
|
* @param bool $p_bool_hidden Set the input to be hidden, default false.
|
|
* @return string
|
|
*/
|
|
protected function add_text_box( $p_str_setting_name, $p_str_max_length = 999, $p_bool_readonly = false, $p_bool_hidden = false ) {
|
|
$l_str_style = '';
|
|
// Collect data for given settings field.
|
|
$l_arr_data = $this->load_setting( $p_str_setting_name );
|
|
if ( $p_bool_hidden ) {
|
|
$l_str_style .= 'display:none;';
|
|
}
|
|
return sprintf(
|
|
'<input type="text" name="%s" id="%s" maxlength="%d" style="%s" value="%s" %s/>',
|
|
$l_arr_data['name'],
|
|
$l_arr_data['id'],
|
|
$p_str_max_length,
|
|
$l_str_style,
|
|
$l_arr_data['value'],
|
|
$p_bool_readonly ? 'readonly="readonly"' : ''
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Returns the html tag for an input [type = checkbox].
|
|
*
|
|
* @since 1.5.0
|
|
* @param string $p_str_setting_name Name of the Settings key to pre load the input field.
|
|
* @return string
|
|
*/
|
|
protected function add_checkbox( $p_str_setting_name ) {
|
|
// Collect data for given settings field.
|
|
$l_arr_data = $this->load_setting( $p_str_setting_name );
|
|
return sprintf(
|
|
'<input type="checkbox" name="%s" id="%s" %s/>',
|
|
$l_arr_data['name'],
|
|
$l_arr_data['id'],
|
|
MCI_Footnotes_Convert::to_bool( $l_arr_data['value'] ) ? 'checked="checked"' : ''
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Returns the html tag for a select box.
|
|
*
|
|
* @since 1.5.0
|
|
*
|
|
* - Bugfix: Dashboard: Referrers and tooltips: Backlink symbol: debug select box by reverting identity check to equality check, thanks to @lolzim bug report.
|
|
*
|
|
* @reporter @lolzim
|
|
*
|
|
* @since 2.5.13
|
|
* @param string $p_str_setting_name Name of the Settings key to pre select the current value.
|
|
* @param array $p_arr_options Possible options to be selected.
|
|
* @return string
|
|
*
|
|
* @since 2.5.15 Bugfix: Dashboard: General settings: Footnote start and end short codes: debug select box for shortcodes with pointy brackets.
|
|
* @since 2.6.1 Restore esc_attr() in load_setting(), remove htmlspecialchars() here.
|
|
*/
|
|
protected function add_select_box( $p_str_setting_name, $p_arr_options ) {
|
|
// Collect data for given settings field.
|
|
$l_arr_data = $this->load_setting( $p_str_setting_name );
|
|
$l_str_options = '';
|
|
|
|
// Loop through all array keys.
|
|
foreach ( $p_arr_options as $l_str_value => $l_str_caption ) {
|
|
$l_str_options .= sprintf(
|
|
'<option value="%s" %s>%s</option>',
|
|
$l_str_value,
|
|
// Only check for equality, not identity, WRT backlink symbol arrows.
|
|
$l_str_value == $l_arr_data['value'] ? 'selected' : '',
|
|
$l_str_caption
|
|
);
|
|
}
|
|
return sprintf(
|
|
'<select name="%s" id="%s">%s</select>',
|
|
$l_arr_data['name'],
|
|
$l_arr_data['id'],
|
|
$l_str_options
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Returns the html tag for a text area.
|
|
*
|
|
* @since 1.5.0
|
|
* @param string $p_str_setting_name Name of the Settings key to pre fill the text area.
|
|
* @return string
|
|
*/
|
|
protected function add_textarea( $p_str_setting_name ) {
|
|
// Collect data for given settings field.
|
|
$l_arr_data = $this->load_setting( $p_str_setting_name );
|
|
return sprintf(
|
|
'<textarea name="%s" id="%s">%s</textarea>',
|
|
$l_arr_data['name'],
|
|
$l_arr_data['id'],
|
|
$l_arr_data['value']
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Returns the html tag for an input [type = text] with color selection class.
|
|
*
|
|
* @since 1.5.6
|
|
* @param string $p_str_setting_name Name of the Settings key to pre load the input field.
|
|
* @return string
|
|
*/
|
|
protected function add_color_selection( $p_str_setting_name ) {
|
|
// Collect data for given settings field.
|
|
$l_arr_data = $this->load_setting( $p_str_setting_name );
|
|
return sprintf(
|
|
'<input type="text" name="%s" id="%s" class="mfmmf-color-picker" value="%s"/>',
|
|
$l_arr_data['name'],
|
|
$l_arr_data['id'],
|
|
$l_arr_data['value']
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Returns the html tag for an input [type = num].
|
|
*
|
|
* @since 1.5.0
|
|
* @param string $p_str_setting_name Name of the Settings key to pre load the input field.
|
|
* @param int $p_in_min Minimum value.
|
|
* @param int $p_int_max Maximum value.
|
|
* @param bool $p_bool_deci true if 0.1 steps and floating to string, false if integer (default).
|
|
* @return string
|
|
*
|
|
* Edited:
|
|
* @since 2.1.4 step argument and number_format() to allow decimals 2020-12-03T0631+0100..2020-12-12T1110+0100
|
|
*/
|
|
protected function add_num_box( $p_str_setting_name, $p_in_min, $p_int_max, $p_bool_deci = false ) {
|
|
// Collect data for given settings field.
|
|
$l_arr_data = $this->load_setting( $p_str_setting_name );
|
|
|
|
if ( $p_bool_deci ) {
|
|
$l_str_value = number_format( floatval( $l_arr_data['value'] ), 1 );
|
|
return sprintf(
|
|
'<input type="number" name="%s" id="%s" value="%s" step="0.1" min="%d" max="%d"/>',
|
|
$l_arr_data['name'],
|
|
$l_arr_data['id'],
|
|
$l_str_value,
|
|
$p_in_min,
|
|
$p_int_max
|
|
);
|
|
} else {
|
|
return sprintf(
|
|
'<input type="number" name="%s" id="%s" value="%d" min="%d" max="%d"/>',
|
|
$l_arr_data['name'],
|
|
$l_arr_data['id'],
|
|
$l_arr_data['value'],
|
|
$p_in_min,
|
|
$p_int_max
|
|
);
|
|
}
|
|
}
|
|
|
|
}
|