--- a/wp/wp-content/plugins/option-tree/includes/ot-functions-docs-page.php Mon Oct 14 18:30:03 2019 +0200
+++ b/wp/wp-content/plugins/option-tree/includes/ot-functions-docs-page.php Mon Oct 14 18:35:50 2019 +0200
@@ -1,190 +1,242 @@
-<?php if ( ! defined( 'OT_VERSION' ) ) exit( 'No direct script access allowed' );
+<?php
/**
- * OptionTree documentation page functions.
+ * OptionTree Documentation Page Functions.
*
- * @package OptionTree
- * @author Derek Herman <derek@valendesigns.com>
- * @copyright Copyright (c) 2013, Derek Herman
- * @since 2.0
+ * @package OptionTree
*/
-/**
- * Creating Options option type.
- *
- * @return string
- *
- * @access public
- * @since 2.0
- */
-if ( ! function_exists( 'ot_type_creating_options' ) ) {
-
- function ot_type_creating_options() {
-
- /* format setting outer wrapper */
- echo '<div class="format-setting type-textblock wide-desc">';
-
- /* description */
- echo '<div class="description">';
-
- echo '<h4>'. __( 'Label', 'option-tree' ) . ':</h4>';
- echo '<p>' . __( 'The Label field should be a short but descriptive block of text 100 characters or less with no HTML.', 'option-tree' ) . '</p>';
-
- echo '<h4>'. __( 'ID', 'option-tree' ) . ':</h4>';
- echo '<p>' . __( 'The ID field is a unique alphanumeric key used to differentiate each theme option (underscores are acceptable). Also, the plugin will change all text you write in this field to lowercase and replace spaces and special characters with an underscore automatically.', 'option-tree' ) . '</p>';
-
- echo '<h4>'. __( 'Type', 'option-tree' ) . ':</h4>';
- echo '<p>' . __( 'You are required to choose one of the supported option types when creating a new option. Here is a list of the available option types. For more information about each type click the <code>Option Types</code> tab to the left.', 'option-tree' ) . '</p>';
-
- echo '<ul class="docs-ul">';
- foreach( ot_option_types_array() as $key => $value )
- echo '<li>' . $value . '</li>';
- echo '</ul>';
-
- echo '<h4>'. __( 'Description', 'option-tree' ) . ':</h4>';
- echo '<p>' . __( 'Enter a detailed description for the users to read on the Theme Options page, HTML is allowed. This is also where you enter content for both the Textblock & Textblock Titled option types.', 'option-tree' ) . '</p>';
-
- echo '<h4>'. __( 'Choices', 'option-tree' ) . ':</h4>';
- echo '<p>' . __( 'Click the "Add Choice" button to add an item to the choices array. This will only affect the following option types: Checkbox, Radio, Select & Select Image.', 'option-tree' ) . '</p>';
-
- echo '<h4>'. __( 'Settings', 'option-tree' ) . ':</h4>';
- echo '<p>' . __( 'Click the "Add Setting" button found inside a newly created setting to add an item to the settings array. This will only affect the List Item type.', 'option-tree' ) . '</p>';
-
- echo '<h4>'. __( 'Standard', 'option-tree' ) . ':</h4>';
- echo '<p>' . __( 'Setting the standard value for your option only works for some option types. Those types are one that have a single string value saved to them and not an array of values.', 'option-tree' ) . '</p>';
-
- echo '<h4>'. __( 'Rows', 'option-tree' ) . ':</h4>';
- echo '<p>' . __( 'Enter a numeric value for the number of rows in your textarea. This will only affect the following option types: CSS, Textarea, & Textarea Simple.', 'option-tree' ) . '</p>';
-
- echo '<h4>'. __( 'Post Type', 'option-tree' ) . ':</h4>';
- echo '<p>' . __( 'Add a comma separated list of post type like <code>post,page</code>. This will only affect the following option types: Custom Post Type Checkbox, & Custom Post Type Select. Below are the default post types available with WordPress and that are also compatible with OptionTree. You can also add your own custom <code>post_type</code>. At this time <code>any</code> does not seem to return results properly and is something I plan on looking into.', 'option-tree' ) . '</p>';
-
- echo '<ul class="docs-ul">';
- echo '<li><code>post</code></li>';
- echo '<li><code>page</code></li>';
- echo '<li><code>attachment</code></li>';
- echo '</ul>';
-
- echo '<h4>'. __( 'Taxonomy', 'option-tree' ) . ':</h4>';
- echo '<p>' . __( 'Add a comma separated list of any registered taxonomy like <code>category,post_tag</code>. This will only affect the following option types: Taxonomy Checkbox, & Taxonomy Select.', 'option-tree' ) . '</p>';
-
- echo '<h4>'. __( 'Min, Max, & Step', 'option-tree' ) . ':</h4>';
- echo '<p>' . __( 'Add a comma separated list of options in the following format <code>0,100,1</code> (slide from <code>0-100</code> in intervals of <code>1</code>). The three values represent the minimum, maximum, and step options and will only affect the Numeric Slider option type.', 'option-tree' ) . '</p>';
-
- echo '<h4>'. __( 'CSS Class', 'option-tree' ) . ':</h4>';
- echo '<p>' . __( 'Add and optional class to any option type.', 'option-tree' ) . '</p>';
-
- echo '<h4>'. __( 'Condition', 'option-tree' ) . ':</h4>';
- echo '<p>' . sprintf( __( 'Add a comma separated list (no spaces) of conditions in which the field will be visible, leave this setting empty to always show the field. In these examples, %s is a placeholder for your condition, which can be in the form of %s.', 'option-tree' ), '<code>value</code>', '<code>field_id:is(value)</code>, <code>field_id:not(value)</code>, <code>field_id:contains(value)</code>, <code>field_id:less_than(value)</code>, <code>field_id:less_than_or_equal_to(value)</code>, <code>field_id:greater_than(value)</code>, or <code>field_id:greater_than_or_equal_to(value)</code>' ) . '</p>';
-
- echo '<h4>'. __( 'Operator', 'option-tree' ) . ':</h4>';
- echo '<p>' . sprintf( __( 'Choose the logical operator to compute the result of the conditions. Your options are %s and %s.', 'option-tree' ), '<code>and</code>', '<code>or</code>' ) . '</p>';
-
- echo '</div>';
-
- echo '</div>';
-
- }
-
+if ( ! defined( 'OT_VERSION' ) ) {
+ exit( 'No direct script access allowed' );
}
-/**
- * ot_get_option() option type.
- *
- * This is a callback function to display text about ot_get_option().
- *
- * @return string
- *
- * @access public
- * @since 2.0
- */
+if ( ! function_exists( 'ot_type_creating_options' ) ) {
+
+ /**
+ * Creating Options option type.
+ *
+ * @access public
+ * @since 2.0
+ */
+ function ot_type_creating_options() {
+
+ // Format setting outer wrapper.
+ echo '<div class="format-setting type-textblock wide-desc">';
+
+ // Description.
+ echo '<div class="description">';
+
+ echo '<h4>' . esc_html__( 'Label', 'option-tree' ) . ':</h4>';
+ echo '<p>' . esc_html__( 'The Label field should be a short but descriptive block of text 100 characters or less with no HTML.', 'option-tree' ) . '</p>';
+
+ echo '<h4>' . esc_html__( 'ID', 'option-tree' ) . ':</h4>';
+ echo '<p>' . esc_html__( 'The ID field is a unique alphanumeric key used to differentiate each theme option (underscores are acceptable). Also, the plugin will change all text you write in this field to lowercase and replace spaces and special characters with an underscore automatically.', 'option-tree' ) . '</p>';
+
+ echo '<h4>' . esc_html__( 'Type', 'option-tree' ) . ':</h4>';
+
+ /* translators: %s: option type tab */
+ $string = esc_html__( 'You are required to choose one of the supported option types when creating a new option. Here is a list of the available option types. For more information about each type click the %s tab to the left.', 'option-tree' );
+ echo '<p>' . sprintf( $string, '<code>' . esc_html__( 'Option Types', 'option-tree' ) . '</code>' ) . '</p>'; // phpcs:ignore
+
+ echo '<ul class="docs-ul">';
+ foreach ( ot_option_types_array() as $key => $value ) {
+ echo '<li>' . $value . '</li>'; // phpcs:ignore
+ }
+ echo '</ul>';
+
+ echo '<h4>' . esc_html__( 'Description', 'option-tree' ) . ':</h4>';
+ echo '<p>' . esc_html__( 'Enter a detailed description for the users to read on the Theme Options page, HTML is allowed. This is also where you enter content for both the Textblock & Textblock Titled option types.', 'option-tree' ) . '</p>';
+
+ echo '<h4>' . esc_html__( 'Choices', 'option-tree' ) . ':</h4>';
+ echo '<p>' . esc_html__( 'Click the "Add Choice" button to add an item to the choices array. This will only affect the following option types: Checkbox, Radio, Select & Select Image.', 'option-tree' ) . '</p>';
+
+ echo '<h4>' . esc_html__( 'Settings', 'option-tree' ) . ':</h4>';
+ echo '<p>' . esc_html__( 'Click the "Add Setting" button found inside a newly created setting to add an item to the settings array. This will only affect the List Item type.', 'option-tree' ) . '</p>';
+
+ echo '<h4>' . esc_html__( 'Standard', 'option-tree' ) . ':</h4>';
+ echo '<p>' . esc_html__( 'Setting the standard value for your option only works for some option types. Those types are one that have a single string value saved to them and not an array of values.', 'option-tree' ) . '</p>';
+
+ echo '<h4>' . esc_html__( 'Rows', 'option-tree' ) . ':</h4>';
+ echo '<p>' . esc_html__( 'Enter a numeric value for the number of rows in your textarea. This will only affect the following option types: CSS, Textarea, & Textarea Simple.', 'option-tree' ) . '</p>';
+
+ echo '<h4>' . esc_html__( 'Post Type', 'option-tree' ) . ':</h4>';
+
+ /* translators: %1$s: example value, %2$s: post_type, %3$s: using any as a value */
+ $string = esc_html__( 'Add a comma separated list of post type like %1$s. This will only affect the following option types: Custom Post Type Checkbox, & Custom Post Type Select. Below are the default post types available with WordPress and that are also compatible with OptionTree. You can also add your own custom %2$s. At this time %3$s does not seem to return results properly and is something I plan on looking into.', 'option-tree' );
+ echo '<p>' . sprintf( $string, '<code>post,page</code>', '<code>post_type</code>', '<code>any</code>' ) . '</p>'; // phpcs:ignore
+
+ echo '<ul class="docs-ul">';
+ echo '<li><code>post</code></li>';
+ echo '<li><code>page</code></li>';
+ echo '<li><code>attachment</code></li>';
+ echo '</ul>';
+
+ echo '<h4>' . esc_html__( 'Taxonomy', 'option-tree' ) . ':</h4>';
+
+ /* translators: %s: example value */
+ $string = esc_html__( 'Add a comma separated list of any registered taxonomy like %s. This will only affect the following option types: Taxonomy Checkbox, & Taxonomy Select.', 'option-tree' );
+ echo '<p>' . sprintf( $string, '<code>category,post_tag</code>' ) . '</p>'; // phpcs:ignore
+
+ echo '<h4>' . esc_html__( 'Min, Max, & Step', 'option-tree' ) . ':</h4>';
+
+ /* translators: %1$s: format, %2$s: range, %3$s: interval minimum */
+ $string = esc_html__( 'Add a comma separated list of options in the following format %1$s (slide from %2$s in intervals of %3$s). The three values represent the minimum, maximum, and step options and will only affect the Numeric Slider option type.', 'option-tree' );
+ echo '<p>' . sprintf( $string, '<code>0,100,1</code>', '<code>0-100</code>', '<code>1</code>' ) . '</p>'; // phpcs:ignore
+
+ echo '<h4>' . esc_html__( 'CSS Class', 'option-tree' ) . ':</h4>';
+ echo '<p>' . esc_html__( 'Add and optional class to any option type.', 'option-tree' ) . '</p>';
+
+ echo '<h4>' . esc_html__( 'Condition', 'option-tree' ) . ':</h4>';
+
+ /* translators: %1$s: example (value) placeholder, %2$s: list of condition examples */
+ $string = esc_html__( 'Add a comma separated list (no spaces) of conditions in which the field will be visible, leave this setting empty to always show the field. In these examples, %1$s is a placeholder for your condition, which can be in the form of %2$s.', 'option-tree' );
+ echo '<p>' . sprintf( $string, '<code>value</code>', '<code>field_id:is(value)</code>, <code>field_id:not(value)</code>, <code>field_id:contains(value)</code>, <code>field_id:less_than(value)</code>, <code>field_id:less_than_or_equal_to(value)</code>, <code>field_id:greater_than(value)</code>, or <code>field_id:greater_than_or_equal_to(value)</code>' ) . '</p>'; // phpcs:ignore
+
+ echo '<h4>' . esc_html__( 'Operator', 'option-tree' ) . ':</h4>';
+
+ /* translators: %1$s: and value, %2$s: or value */
+ $string = esc_html__( 'Choose the logical operator to compute the result of the conditions. Your options are %1$s and %2$s.', 'option-tree' );
+ echo '<p>' . sprintf( $string, '<code>and</code>', '<code>or</code>' ) . '</p>'; // phpcs:ignore
+
+ echo '</div>';
+
+ echo '</div>';
+ }
+}
+
if ( ! function_exists( 'ot_type_option_types' ) ) {
-
- function ot_type_option_types() {
-
- /* format setting outer wrapper */
- echo '<div class="format-setting type-textblock wide-desc">';
-
- /* description */
- echo '<div class="description">';
-
- echo '<h4>'. __( 'Background', 'option-tree' ) . ':</h4>';
- echo '<p>' . sprintf( __( 'The Background option type is for adding background styles to your theme either dynamically via the CSS option type below or manually with %s. The Background option type has filters that allow you to remove fields or change the defaults. For example, you can filter %s to remove unwanted fields from all Background options or an individual one. You can also filter %s. These filters allow you to fine tune the select lists for your specific needs.', 'option-tree' ), '<code>ot_get_option()</code>', '<code>ot_recognized_background_fields</code>', '<code>ot_recognized_background_repeat</code>, <code>ot_recognized_background_attachment</code>, <code>ot_recognized_background_position</code>, ' . __( 'and', 'option-tree' ) . ' <code>ot_type_background_size_choices</code>' ) . '</p>';
-
- echo '<h4>'. __( 'Border', 'option-tree' ) . ':</h4>';
- echo '<p>' . sprintf( __( 'The Border option type is used to set width, unit, style, and color values. The text input excepts a numerical value and the unit select lets you choose the unit of measurement to add to that value. Currently the default units are %s, %s, %s, and %s. However, you can change them with the %s filter. The style select lets you choose the border style. The default styles are %s, %s, %s, %s, %s, %s, %s, and %s. However, you can change them with the %s filter. The colorpicker saves a hexadecimal color code.', 'option-tree' ), '<code>px</code>', '<code>%</code>', '<code>em</code>', '<code>pt</code>', '<code>ot_recognized_border_unit_types</code>', '<code>hidden</code>', '<code>dashed</code>', '<code>solid</code>', '<code>double</code>', '<code>groove</code>', '<code>ridge</code>', '<code>inset</code>', '<code>outset</code>', '<code>ot_recognized_border_style_types</code>' ) . '</p>';
-
- echo '<h4>'. __( 'Box Shadow', 'option-tree' ) . ':</h4>';
- echo '<p>' . sprintf( __( 'The Box Shadow option type is used to set %s, %s, %s, %s, %s, and %s values.', 'option-tree' ), '<code>inset</code>', '<code>offset-x</code>', '<code>offset-y</code>', '<code>blur-radius</code>', '<code>spread-radius</code>', '<code>color</code>' ) . '</p>';
-
- echo '<h4>'. __( 'Category Checkbox', 'option-tree' ) . ':</h4>';
- echo '<p>' . __( 'The Category Checkbox option type displays a list of category IDs. It allows the user to check multiple category IDs and will return that value as an array for use in a custom function or loop.', 'option-tree' ) . '</p>';
-
- echo '<h4>'. __( 'Category Select', 'option-tree' ) . ':</h4>';
- echo '<p>' . __( 'The Category Select option type displays a list of category IDs. It allows the user to select only one category ID and will return that value for use in a custom function or loop.', 'option-tree' ) . '</p>';
-
- echo '<h4>'. __( 'Checkbox', 'option-tree' ) . ':</h4>';
- echo '<p>' . __( 'The Checkbox option type displays a group of choices. It allows the user to check multiple choices and will return that value as an array for use in a custom function or loop.', 'option-tree' ) . '</p>';
-
- echo '<h4>'. __( 'Colorpicker', 'option-tree' ) . ':</h4>';
- echo '<p>' . __( 'The Colorpicker option type saves a hexadecimal color code for use in CSS. Use it to modify the color of something in your theme.', 'option-tree' ) . '</p>';
-
- echo '<h4>'. __( 'Colorpicker Opacity', 'option-tree' ) . ':</h4>';
- echo '<p>' . sprintf( __( 'The Colorpicker Opacity option type saves a hexadecimal color code with an opacity value from %s to %s in increments of %s. Though the value is saved as hexadecimal, if used within the CSS option type the color and opacity values will be converted into a valid RGBA CSS value.', 'option-tree' ), '<code>0</code>', '<code>1</code>', '<code>0.01</code>' ) . '</p>';
-
- echo '<h4>'. __( 'CSS', 'option-tree' ) . ':</h4>';
- echo '<p>' . sprintf( __( 'The CSS option type is a textarea that when used properly can add dynamic CSS to your theme from within OptionTree. Unfortunately, due server limitations you will need to create a file named %s at the root level of your theme and change permissions using %s so the server can write to the file. I have had the most success setting this single file to %s but feel free to play around with permissions until everything is working. A good starting point is %s. When the server can save to the file, CSS will automatically be updated when you save your Theme Options.', 'option-tree' ), '<code>dynamic.css</code>', '<code>chmod</code>', '<code>0777</code>', '<code>0666</code>' ) . '</p>';
-
- echo '<p class="aside">' . sprintf( __( 'This example assumes you have an option with the ID of %1$s. Which means this option will automatically insert the value of %1$s into the %2$s when the Theme Options are saved.', 'option-tree' ), '<code>demo_background</code>', '<code>dynamic.css</code>' ) . '</p>';
-
- echo '<p>'. __( 'Input', 'option-tree' ) . ':</p>';
- echo '<pre><code>body {
+
+ /**
+ * The ot_get_option() option type.
+ *
+ * This is a callback function to display text about ot_get_option().
+ *
+ * @access public
+ * @since 2.0
+ */
+ function ot_type_option_types() {
+
+ // Format setting outer wrapper.
+ echo '<div class="format-setting type-textblock wide-desc">';
+
+ // Description.
+ echo '<div class="description">';
+
+ echo '<h4>' . esc_html__( 'Background', 'option-tree' ) . ':</h4>';
+
+ /* translators: %1$s: function name, %2$s: filter name, %3$s: filter name list */
+ $string = esc_html__( 'The Background option type is for adding background styles to your theme either dynamically via the CSS option type below or manually with %1$s. The Background option type has filters that allow you to remove fields or change the defaults. For example, you can filter %2$s to remove unwanted fields from all Background options or an individual one. You can also filter %3$s. These filters allow you to fine tune the select lists for your specific needs.', 'option-tree' );
+ echo '<p>' . sprintf( $string, '<code>ot_get_option()</code>', '<code>ot_recognized_background_fields</code>', '<code>ot_recognized_background_repeat</code>, <code>ot_recognized_background_attachment</code>, <code>ot_recognized_background_position</code>, ' . __( 'and', 'option-tree' ) . ' <code>ot_type_background_size_choices</code>' ) . '</p>'; // phpcs:ignore
+
+ echo '<h4>' . esc_html__( 'Border', 'option-tree' ) . ':</h4>';
+
+ /* translators: %1$s: pixel unit, %2$s: percentage unit, %3$s: em unit, %4$s: point unit, %5$s: filter name, %6$s: hidden, %7$s: dashed, %8$s: solid, %9$s: double, %10$s: groove, %11$s: ridge, %12$s: inset, %13$s: outset, %14$s: filter name */
+ $string = esc_html__( 'The Border option type is used to set width, unit, style, and color values. The text input excepts a numerical value and the unit select lets you choose the unit of measurement to add to that value. Currently the default units are %1$s, %2$s, %3$s, and %4$s. However, you can change them with the %5$s filter. The style select lets you choose the border style. The default styles are %6$s, %7$s, %8$s, %9$s, %10$s, %11$s, %12$s, and %13$s. However, you can change them with the %14$s filter. The colorpicker saves a hexadecimal color code.', 'option-tree' );
+ echo '<p>' . sprintf( $string, '<code>px</code>', '<code>%</code>', '<code>em</code>', '<code>pt</code>', '<code>ot_recognized_border_unit_types</code>', '<code>hidden</code>', '<code>dashed</code>', '<code>solid</code>', '<code>double</code>', '<code>groove</code>', '<code>ridge</code>', '<code>inset</code>', '<code>outset</code>', '<code>ot_recognized_border_style_types</code>' ) . '</p>'; // phpcs:ignore
+
+ echo '<h4>' . esc_html__( 'Box Shadow', 'option-tree' ) . ':</h4>';
+
+ /* translators: %1$s: inset, %2$s: offset-x, %3$s: offset-y, %4$s: blur-radius, %5$s: spread-radius, %6$s: color */
+ $string = esc_html__( 'The Box Shadow option type is used to set %1$s, %2$s, %3$s, %4$s, %5$s, and %6$s values.', 'option-tree' );
+ echo '<p>' . sprintf( $string, '<code>inset</code>', '<code>offset-x</code>', '<code>offset-y</code>', '<code>blur-radius</code>', '<code>spread-radius</code>', '<code>color</code>' ) . '</p>'; // phpcs:ignore
+
+ echo '<h4>' . esc_html__( 'Category Checkbox', 'option-tree' ) . ':</h4>';
+ echo '<p>' . esc_html__( 'The Category Checkbox option type displays a list of category IDs. It allows the user to check multiple category IDs and will return that value as an array for use in a custom function or loop.', 'option-tree' ) . '</p>';
+
+ echo '<h4>' . esc_html__( 'Category Select', 'option-tree' ) . ':</h4>';
+ echo '<p>' . esc_html__( 'The Category Select option type displays a list of category IDs. It allows the user to select only one category ID and will return that value for use in a custom function or loop.', 'option-tree' ) . '</p>';
+
+ echo '<h4>' . esc_html__( 'Checkbox', 'option-tree' ) . ':</h4>';
+ echo '<p>' . esc_html__( 'The Checkbox option type displays a group of choices. It allows the user to check multiple choices and will return that value as an array for use in a custom function or loop.', 'option-tree' ) . '</p>';
+
+ echo '<h4>' . esc_html__( 'Colorpicker', 'option-tree' ) . ':</h4>';
+ echo '<p>' . esc_html__( 'The Colorpicker option type saves a hexadecimal color code for use in CSS. Use it to modify the color of something in your theme.', 'option-tree' ) . '</p>';
+
+ echo '<h4>' . esc_html__( 'Colorpicker Opacity', 'option-tree' ) . ':</h4>';
+
+ /* translators: %1$s: range minimum, %2$s: range maximum, %3$s: minimum increment */
+ $string = esc_html__( 'The Colorpicker Opacity option type saves a hexadecimal color code with an opacity value from %1$s to %2$s in increments of %3$s. Though the value is saved as hexadecimal, if used within the CSS option type the color and opacity values will be converted into a valid RGBA CSS value.', 'option-tree' );
+ echo '<p>' . sprintf( $string, '<code>0</code>', '<code>1</code>', '<code>0.01</code>' ) . '</p>'; // phpcs:ignore
+
+ echo '<h4>' . esc_html__( 'CSS', 'option-tree' ) . ':</h4>';
+
+ /* translators: %1$s: file name, %2$s: command name, %3$s: permission mode, %4$s: permission mode */
+ $string = esc_html__( 'The CSS option type is a textarea that when used properly can add dynamic CSS to your theme from within OptionTree. Unfortunately, due server limitations you will need to create a file named %1$s at the root level of your theme and change permissions using %2$s so the server can write to the file. I have had the most success setting this single file to %3$s but feel free to play around with permissions until everything is working. A good starting point is %4$s. When the server can save to the file, CSS will automatically be updated when you save your Theme Options.', 'option-tree' );
+ echo '<p>' . sprintf( $string, '<code>dynamic.css</code>', '<code>chmod</code>', '<code>0777</code>', '<code>0666</code>' ) . '</p>'; // phpcs:ignore
+
+ /* translators: option ID: pixel unit, %2$s: file name */
+ $string = esc_html__( 'This example assumes you have an option with the ID of %1$s. Which means this option will automatically insert the value of %1$s into the %2$s when the Theme Options are saved.', 'option-tree' );
+ echo '<p class="aside">' . sprintf( $string, '<code>demo_background</code>', '<code>dynamic.css</code>' ) . '</p>'; // phpcs:ignore
+
+ echo '<p>' . esc_html__( 'Input', 'option-tree' ) . ':</p>';
+ echo '<pre><code>body {
{{demo_background}}
background-color: {{demo_background|background-color}};
}</code></pre>';
- echo '<p>'. __( 'Output', 'option-tree' ) . ':</p>';
- echo '<pre><code>/* BEGIN demo_background */
+ echo '<p>' . esc_html__( 'Output', 'option-tree' ) . ':</p>';
+ echo '<pre><code>/* BEGIN demo_background */
body {
background: color image repeat attachment position;
background-color: color;
}
/* END demo_background */</code></pre>';
-
- echo '<h4>'. __( 'Custom Post Type Checkbox', 'option-tree' ) . ':</h4>';
- echo '<p>' . sprintf( __( 'The Custom Post Type Select option type displays a list of IDs from any available WordPress post type or custom post type. It allows the user to check multiple post IDs for use in a custom function or loop. Requires at least one valid %1$s in the %1$s field.', 'option-tree' ), '<code>post_type</code>' ) . '</p>';
-
- echo '<h4>'. __( 'Custom Post Type Select', 'option-tree' ) . ':</h4>';
- echo '<p>' . sprintf( __( 'The Custom Post Type Select option type displays a list of IDs from any available WordPress post type or custom post type. It will return a single post ID for use in a custom function or loop. Requires at least one valid %1$s in the %1$s field.', 'option-tree' ), '<code>post_type</code>' ) . '</p>';
-
- echo '<h4>'. __( 'Date Picker', 'option-tree' ) . ':</h4>';
- echo '<p>' . __( 'The Date Picker option type is tied to a standard form input field which displays a calendar pop-up that allow the user to pick any date when focus is given to the input field. The returned value is a date formatted string.', 'option-tree' ) . '</p>';
-
- echo '<h4>'. __( 'Date Time Picker', 'option-tree' ) . ':</h4>';
- echo '<p>' . __( 'The Date Time Picker option type is tied to a standard form input field which displays a calendar pop-up that allow the user to pick any date and time when focus is given to the input field. The returned value is a date and time formatted string.', 'option-tree' ) . '</p>';
-
- echo '<h4>'. __( 'Dimension', 'option-tree' ) . ':</h4>';
- echo '<p>' . sprintf( __( 'The Dimension option type is used to set width and height values. The text inputs except numerical values and the select lets you choose the unit of measurement to add to that value. Currently the default units are %s, %s, %s, and %s. However, you can change them with the %s filter.', 'option-tree' ), '<code>px</code>', '<code>%</code>', '<code>em</code>', '<code>pt</code>', '<code>ot_recognized_dimension_unit_types</code>' ) . '</p>';
-
- echo '<h4>'. __( 'Gallery', 'option-tree' ) . ':</h4>';
- echo '<p>' . __( 'The Gallery option type saves a comma separated list of image attachment IDs. You will need to create a front-end function to display the images in your theme.', 'option-tree' ) . '</p>';
+
+ echo '<h4>' . esc_html__( 'Custom Post Type Checkbox', 'option-tree' ) . ':</h4>';
+
+ /* translators: %1$s: post_type */
+ $string = esc_html__( 'The Custom Post Type Select option type displays a list of IDs from any available WordPress post type or custom post type. It allows the user to check multiple post IDs for use in a custom function or loop. Requires at least one valid %1$s in the %1$s field.', 'option-tree' );
+ echo '<p>' . sprintf( $string, '<code>post_type</code>' ) . '</p>'; // phpcs:ignore
+
+ echo '<h4>' . esc_html__( 'Custom Post Type Select', 'option-tree' ) . ':</h4>';
+
+ /* translators: %s: post_type */
+ $string = esc_html__( 'The Custom Post Type Select option type displays a list of IDs from any available WordPress post type or custom post type. It will return a single post ID for use in a custom function or loop. Requires at least one valid %1$s in the %1$s field.', 'option-tree' );
+ echo '<p>' . sprintf( $string, '<code>post_type</code>' ) . '</p>'; // phpcs:ignore
+
+ echo '<h4>' . esc_html__( 'Date Picker', 'option-tree' ) . ':</h4>';
+ echo '<p>' . esc_html__( 'The Date Picker option type is tied to a standard form input field which displays a calendar pop-up that allow the user to pick any date when focus is given to the input field. The returned value is a date formatted string.', 'option-tree' ) . '</p>';
+
+ echo '<h4>' . esc_html__( 'Date Time Picker', 'option-tree' ) . ':</h4>';
+ echo '<p>' . esc_html__( 'The Date Time Picker option type is tied to a standard form input field which displays a calendar pop-up that allow the user to pick any date and time when focus is given to the input field. The returned value is a date and time formatted string.', 'option-tree' ) . '</p>';
+
+ echo '<h4>' . esc_html__( 'Dimension', 'option-tree' ) . ':</h4>';
+
+ /* translators: %1$s: pixel unit, %2$s: percentage unit, %3$s: em unit, %4$s: point unit, %5$s: filter name */
+ $string = esc_html__( 'The Dimension option type is used to set width and height values. The text inputs except numerical values and the select lets you choose the unit of measurement to add to that value. Currently the default units are %1$s, %2$s, %3$s, and %4$s. However, you can change them with the %5$s filter.', 'option-tree' );
+ echo '<p>' . sprintf( $string, '<code>px</code>', '<code>%</code>', '<code>em</code>', '<code>pt</code>', '<code>ot_recognized_dimension_unit_types</code>' ) . '</p>'; // phpcs:ignore
+
+ echo '<h4>' . esc_html__( 'Gallery', 'option-tree' ) . ':</h4>';
+ echo '<p>' . esc_html__( 'The Gallery option type saves a comma separated list of image attachment IDs. You will need to create a front-end function to display the images in your theme.', 'option-tree' ) . '</p>';
- echo '<h4>'. __( 'Google Fonts', 'option-tree' ) . ':</h4>';
- echo '<p>' . sprintf( __( 'The Google Fonts option type will dynamically enqueue any number of Google Web Fonts into the document %1$s. As well, once the option has been saved each font family will automatically be inserted into the %2$s array for the Typography option type. You can further modify the font stack by using the %3$s filter, which is passed the %4$s, %5$s, and %6$s parameters. The %6$s parameter is being passed from %7$s, so it will be the ID of a Typography option type. This will allow you to add additional web safe fonts to individual font families on an as-need basis.', 'option-tree' ), '<code>HEAD</code>', '<code>font-family</code>', '<code>ot_google_font_stack</code>', '<code>$font_stack</code>', '<code>$family</code>', '<code>$field_id</code>', '<code>ot_recognized_font_families</code>' ) . '</p>';
+ echo '<h4>' . esc_html__( 'Google Fonts', 'option-tree' ) . ':</h4>';
+
+ /* translators: %1$s: HTML Document HEAD, %2$s: array key, %3$s: filter name, %4$s: parameter name, %5$s: parameter name, %6$s: parameter name, %7$s: function name*/
+ $string = esc_html__( 'The Google Fonts option type will dynamically enqueue any number of Google Web Fonts into the document %1$s. As well, once the option has been saved each font family will automatically be inserted into the %2$s array for the Typography option type. You can further modify the font stack by using the %3$s filter, which is passed the %4$s, %5$s, and %6$s parameters. The %6$s parameter is being passed from %7$s, so it will be the ID of a Typography option type. This will allow you to add additional web safe fonts to individual font families on an as-need basis.', 'option-tree' );
+ echo '<p>' . sprintf( $string, '<code>HEAD</code>', '<code>font-family</code>', '<code>ot_google_font_stack</code>', '<code>$font_stack</code>', '<code>$family</code>', '<code>$field_id</code>', '<code>ot_recognized_font_families</code>' ) . '</p>'; // phpcs:ignore
- echo '<h4>'. __( 'JavaScript', 'option-tree' ) . ':</h4>';
- echo '<p>' . sprintf( __( 'The JavaScript option type is a textarea that uses the %s code editor to highlight your JavaScript and display errors as you type.', 'option-tree' ), '<code>ace.js</code>' ) . '</p>';
+ echo '<h4>' . esc_html__( 'JavaScript', 'option-tree' ) . ':</h4>';
+
+ /* translators: %s: file name */
+ $string = esc_html__( 'The JavaScript option type is a textarea that uses the %s code editor to highlight your JavaScript and display errors as you type.', 'option-tree' );
+ echo '<p>' . sprintf( $string, '<code>ace.js</code>' ) . '</p>'; // phpcs:ignore
+
+ echo '<h4>' . esc_html__( 'Link Color', 'option-tree' ) . ':</h4>';
+ echo '<p>' . esc_html__( 'The Link Color option type is used to set all link color states.', 'option-tree' ) . '</p>';
- echo '<h4>'. __( 'Link Color', 'option-tree' ) . ':</h4>';
- echo '<p>' . __( 'The Link Color option type is used to set all link color states.', 'option-tree' ) . '</p>';
-
- echo '<h4>'. __( 'List Item', 'option-tree' ) . ':</h4>';
- echo '<p>' . __( 'The List Item option type replaced the Slider option type and allows for a great deal of customization. You can add settings to the List Item and those settings will be displayed to the user when they add a new List Item. Typical use is for creating sliding content or blocks of code for custom layouts.', 'option-tree' ) . '</p>';
-
- echo '<h4>'. __( 'Measurement', 'option-tree' ) . ':</h4>';
- echo '<p>' . sprintf( __( 'The Measurement option type is a mix of input and select fields. The text input excepts a value and the select lets you choose the unit of measurement to add to that value. Currently the default units are %s, %s, %s, and %s. However, you can change them with the %s filter.', 'option-tree' ), '<code>px</code>', '<code>%</code>', '<code>em</code>', '<code>pt</code>', '<code>ot_measurement_unit_types</code>' ) . '</p>';
-
- echo '<p>' . sprintf( __( 'Example filter to add new units to the Measurement option type. Added to %s.', 'option-tree' ), '<code>functions.php</code>' ) . '</p>';
- echo '<pre><code>function filter_measurement_unit_types( $array, $field_id ) {
+ echo '<h4>' . esc_html__( 'List Item', 'option-tree' ) . ':</h4>';
+ echo '<p>' . esc_html__( 'The List Item option type replaced the Slider option type and allows for a great deal of customization. You can add settings to the List Item and those settings will be displayed to the user when they add a new List Item. Typical use is for creating sliding content or blocks of code for custom layouts.', 'option-tree' ) . '</p>';
+
+ echo '<h4>' . esc_html__( 'Measurement', 'option-tree' ) . ':</h4>';
+
+ /* translators: %1$s: pixel unit, %2$s: percentage unit, %3$s: em unit, %4$s: point unit, %5$s: filter name */
+ $string = esc_html__( 'The Measurement option type is a mix of input and select fields. The text input excepts a value and the select lets you choose the unit of measurement to add to that value. Currently the default units are %1$s, %2$s, %3$s, and %4$s. However, you can change them with the %5$s filter.', 'option-tree' );
+ echo '<p>' . sprintf( $string, '<code>px</code>', '<code>%</code>', '<code>em</code>', '<code>pt</code>', '<code>ot_measurement_unit_types</code>' ) . '</p>'; // phpcs:ignore
+
+ /* translators: %s: file name */
+ $string = esc_html__( 'Example filter to add new units to the Measurement option type. Added to %s.', 'option-tree' );
+ echo '<p>' . sprintf( $string, '<code>functions.php</code>' ) . '</p>'; // phpcs:ignore
+
+ echo '<pre><code>function filter_measurement_unit_types( $array, $field_id ) {
/* only run the filter on measurement with a field ID of my_measurement */
if ( $field_id == \'my_measurement\' ) {
@@ -196,8 +248,11 @@
}
add_filter( \'ot_measurement_unit_types\', \'filter_measurement_unit_types\', 10, 2 );</code></pre>';
- echo '<p>' . __( 'Example filter to completely change the units in the Measurement option type. Added to <code>functions.php</code>.', 'option-tree' ) . '</p>';
- echo '<pre><code>function filter_measurement_unit_types( $array, $field_id ) {
+ /* translators: %s: file name */
+ $string = esc_html__( 'Example filter to completely change the units in the Measurement option type. Added to %s.', 'option-tree' );
+ echo '<p>' . sprintf( $string, '<code>functions.php</code>' ) . '</p>'; // phpcs:ignore
+
+ echo '<pre><code>function filter_measurement_unit_types( $array, $field_id ) {
/* only run the filter on measurement with a field ID of my_measurement */
if ( $field_id == \'my_measurement\' ) {
@@ -210,33 +265,42 @@
return $array;
}
add_filter( \'ot_measurement_unit_types\', \'filter_measurement_unit_types\', 10, 2 );</code></pre>';
-
- echo '<h4>'. __( 'Numeric Slider', 'option-tree' ) . ':</h4>';
- echo '<p>' . __( 'The Numeric Slider option type displays a jQuery UI slider. It will return a single numerical value for use in a custom function or loop.', 'option-tree' ) . '</p>';
-
- echo '<h4>'. __( 'On/Off', 'option-tree' ) . ':</h4>';
- echo '<p>' . sprintf( __( 'The On/Off option type displays a simple switch that can be used to turn things on or off. The saved return value is either %s or %s.', 'option-tree' ), '<code>on</code>', '<code>off</code>' ) . '</p>';
-
- echo '<h4>'. __( 'Page Checkbox', 'option-tree' ) . ':</h4>';
- echo '<p>' . __( 'The Page Checkbox option type displays a list of page IDs. It allows the user to check multiple page IDs for use in a custom function or loop.', 'option-tree' ) . '</p>';
-
- echo '<h4>'. __( 'Page Select', 'option-tree' ) . ':</h4>';
- echo '<p>' . __( 'The Page Select option type displays a list of page IDs. It will return a single page ID for use in a custom function or loop.', 'option-tree' ) . '</p>';
-
- echo '<h4>'. __( 'Post Checkbox', 'option-tree' ) . ':</h4>';
- echo '<p>' . __( 'The Post Checkbox option type displays a list of post IDs. It allows the user to check multiple post IDs for use in a custom function or loop.', 'option-tree' ) . '</p>';
-
- echo '<h4>'. __( 'Post Select', 'option-tree' ) . ':</h4>';
- echo '<p>' . __( 'The Post Select option type displays a list of post IDs. It will return a single post ID for use in a custom function or loop.', 'option-tree' ) . '</p>';
-
- echo '<h4>'. __( 'Radio', 'option-tree' ) . ':</h4>';
- echo '<p>' . __( 'The Radio option type displays a group of choices. It allows the user to choose one and will return that value as a string for use in a custom function or loop.', 'option-tree' ) . '</p>';
-
- echo '<h4>'. __( 'Radio Image', 'option-tree' ) . ':</h4>';
- echo '<p>' . sprintf( __( 'the Radio Images option type is primarily used for layouts. However, you can filter the image list using %s. As well, you can add your own custom images using the choices array.', 'option-tree' ), '<code>ot_radio_images</code>' ) . '</p>';
-
- echo '<p>' . __( 'This example executes the <code>ot_radio_images</code> filter on layout images attached to the <code>my_radio_images</code> field. Added to <code>functions.php</code>.', 'option-tree' ) . '</p>';
- echo '<pre><code>function filter_radio_images( $array, $field_id ) {
+
+ echo '<h4>' . esc_html__( 'Numeric Slider', 'option-tree' ) . ':</h4>';
+ echo '<p>' . esc_html__( 'The Numeric Slider option type displays a jQuery UI slider. It will return a single numerical value for use in a custom function or loop.', 'option-tree' ) . '</p>';
+
+ echo '<h4>' . esc_html__( 'On/Off', 'option-tree' ) . ':</h4>';
+
+ /* translators: %1$s: on value, %2$s: off value */
+ $string = esc_html__( 'The On/Off option type displays a simple switch that can be used to turn things on or off. The saved return value is either %1$s or %2$s.', 'option-tree' );
+ echo '<p>' . sprintf( $string, '<code>on</code>', '<code>off</code>' ) . '</p>'; // phpcs:ignore
+
+ echo '<h4>' . esc_html__( 'Page Checkbox', 'option-tree' ) . ':</h4>';
+ echo '<p>' . esc_html__( 'The Page Checkbox option type displays a list of page IDs. It allows the user to check multiple page IDs for use in a custom function or loop.', 'option-tree' ) . '</p>';
+
+ echo '<h4>' . esc_html__( 'Page Select', 'option-tree' ) . ':</h4>';
+ echo '<p>' . esc_html__( 'The Page Select option type displays a list of page IDs. It will return a single page ID for use in a custom function or loop.', 'option-tree' ) . '</p>';
+
+ echo '<h4>' . esc_html__( 'Post Checkbox', 'option-tree' ) . ':</h4>';
+ echo '<p>' . esc_html__( 'The Post Checkbox option type displays a list of post IDs. It allows the user to check multiple post IDs for use in a custom function or loop.', 'option-tree' ) . '</p>';
+
+ echo '<h4>' . esc_html__( 'Post Select', 'option-tree' ) . ':</h4>';
+ echo '<p>' . esc_html__( 'The Post Select option type displays a list of post IDs. It will return a single post ID for use in a custom function or loop.', 'option-tree' ) . '</p>';
+
+ echo '<h4>' . esc_html__( 'Radio', 'option-tree' ) . ':</h4>';
+ echo '<p>' . esc_html__( 'The Radio option type displays a group of choices. It allows the user to choose one and will return that value as a string for use in a custom function or loop.', 'option-tree' ) . '</p>';
+
+ echo '<h4>' . esc_html__( 'Radio Image', 'option-tree' ) . ':</h4>';
+
+ /* translators: %s: filter name */
+ $string = esc_html__( 'the Radio Images option type is primarily used for layouts. However, you can filter the image list using %s. As well, you can add your own custom images using the choices array.', 'option-tree' );
+ echo '<p>' . sprintf( $string, '<code>ot_radio_images</code>' ) . '</p>'; // phpcs:ignore
+
+ /* translators: %1$s: filter name, %2$s: field name, %3$s: file name */
+ $string = esc_html__( 'This example executes the %1$s filter on layout images attached to the %2$s field. Added to %3$s.', 'option-tree' );
+ echo '<p>' . sprintf( $string, '<code>ot_radio_images</code>', '<code>my_radio_images</code>', '<code>functions.php</code>' ) . '</p>'; // phpcs:ignore
+
+ echo '<pre><code>function filter_radio_images( $array, $field_id ) {
/* only run the filter where the field ID is my_radio_images */
if ( $field_id == \'my_radio_images\' ) {
@@ -258,48 +322,68 @@
}
add_filter( \'ot_radio_images\', \'filter_radio_images\', 10, 2 );</code></pre>';
-
- echo '<h4>'. __( 'Select', 'option-tree' ) . ':</h4>';
- echo '<p>' . __( 'The Select option type is used to list anything you want that would be chosen from a select list.', 'option-tree' ) . '</p>';
-
- echo '<h4>'. __( 'Sidebar Select', 'option-tree' ) . ':</h4>';
- echo '<p>' . sprintf( __( 'This option type makes it possible for users to select a WordPress registered sidebar to use on a specific area. By using the two provided filters, %s, and %s we can be selective about which sidebars are available on a specific content area.', 'option-tree' ), '<code>ot_recognized_sidebars</code>', '<code>ot_recognized_sidebars_{$field_id}</code>' ) . '</p>';
- echo '<p>' . sprintf( __( 'For example, if we create a WordPress theme that provides the ability to change the Blog Sidebar and we don\'t want to have the footer sidebars available on this area, we can unset those sidebars either manually or by using a regular expression if we have a common name like %s.', 'option-tree' ), '<code>footer-sidebar-$i</code>' ) . '</p>';
-
- echo '<h4>'. __( 'Slider', 'option-tree' ) . ':</h4>';
- echo '<p>' . __( 'The Slider option type is technically deprecated. Use the List Item option type instead, as it\'s infinitely more customizable. Typical use is for creating sliding image content.', 'option-tree' ) . '</p>';
-
- echo '<h4>'. __( 'Social Links', 'option-tree' ) . ':</h4>';
- echo '<p>' . sprintf( __( 'The Social Links option type utilizes a drag & drop interface to create a list of social links. There are a few filters that make extending this option type easy. You can set the %s filter to %s and turn off loading default values. Use the %s filter to change the default values that are loaded. To filter the settings array use the %s filter.', 'option-tree' ), '<code>ot_type_social_links_load_defaults</code>', '<code>false</code>', '<code>ot_type_social_links_defaults</code>', '<code>ot_social_links_settings</code>' ) . '</p>';
-
- echo '<h4>'. __( 'Spacing', 'option-tree' ) . ':</h4>';
- echo '<p>' . sprintf( __( 'The Spacing option type is used to set spacing values such as padding or margin in the form of top, right, bottom, and left. The text inputs except numerical values and the select lets you choose the unit of measurement to add to that value. Currently the default units are %s, %s, %s, and %s. However, you can change them with the %s filter.', 'option-tree' ), '<code>px</code>', '<code>%</code>', '<code>em</code>', '<code>pt</code>', '<code>ot_recognized_spacing_unit_types</code>' ) . '</p>';
-
- echo '<h4>'. __( 'Tab', 'option-tree' ) . ':</h4>';
- echo '<p>' . __( 'The Tab option type will break a section or metabox into tabbed content.', 'option-tree' ) . '</p>';
-
- echo '<h4>'. __( 'Tag Checkbox', 'option-tree' ) . ':</h4>';
- echo '<p>' . __( 'The Tag Checkbox option type displays a list of tag IDs. It allows the user to check multiple tag IDs and will return that value as an array for use in a custom function or loop.', 'option-tree' ) . '</p>';
-
- echo '<h4>'. __( 'Tag Select', 'option-tree' ) . ':</h4>';
- echo '<p>' . __( 'The Tag Select option type displays a list of tag IDs. It allows the user to select only one tag ID and will return that value for use in a custom function or loop.', 'option-tree' ) . '</p>';
-
- echo '<h4>'. __( 'Taxonomy Checkbox', 'option-tree' ) . ':</h4>';
- echo '<p>' . __( 'The Taxonomy Checkbox option type displays a list of taxonomy IDs. It allows the user to check multiple taxonomy IDs and will return that value as an array for use in a custom function or loop.', 'option-tree' ) . '</p>';
-
- echo '<h4>'. __( 'Taxonomy Select', 'option-tree' ) . ':</h4>';
- echo '<p>' . __( 'The Taxonomy Select option type displays a list of taxonomy IDs. It allows the user to select only one taxonomy ID and will return that value for use in a custom function or loop.', 'option-tree' ) . '</p>';
-
- echo '<h4>'. __( 'Text', 'option-tree' ) . ':</h4>';
- echo '<p>' . __( 'The Text option type is used to save string values. For example, any optional or required text that is of reasonably short character length.', 'option-tree' ) . '</p>';
-
- echo '<h4>'. __( 'Textarea', 'option-tree' ) . ':</h4>';
- echo '<p>' . sprintf( __( 'The Textarea option type is a large string value used for custom code or text in the theme and has a WYSIWYG editor that can be filtered to change the how it is displayed. For example, you can filter %s, %s, %s, and %s.', 'option-tree' ), '<code>wpautop</code>', '<code>media_buttons</code>', '<code>tinymce</code>', '<code>quicktags</code>' ) . '</p>';
-
- echo '<p class="aside">' . __( 'Example filters to alter the Textarea option type. Added to <code>functions.php</code>.', 'option-tree' ) . '</p>';
-
- echo '<p>' . __( 'This example keeps WordPress from executing the <code>wpautop</code> filter on the line breaks. The default is <code>true</code> which means it wraps line breaks with an HTML <code>p</code> tag.', 'option-tree' ) . '</p>';
- echo '<pre><code>function filter_textarea_wpautop( $content, $field_id ) {
+
+ echo '<h4>' . esc_html__( 'Select', 'option-tree' ) . ':</h4>';
+ echo '<p>' . esc_html__( 'The Select option type is used to list anything you want that would be chosen from a select list.', 'option-tree' ) . '</p>';
+
+ echo '<h4>' . esc_html__( 'Sidebar Select', 'option-tree' ) . ':</h4>';
+
+ /* translators: %1$s: filter name, %2$s: dynamic filter name with field_id */
+ $string = esc_html__( 'This option type makes it possible for users to select a WordPress registered sidebar to use on a specific area. By using the two provided filters, %1$s, and %2$s we can be selective about which sidebars are available on a specific content area.', 'option-tree' );
+ echo '<p>' . sprintf( $string, '<code>ot_recognized_sidebars</code>', '<code>ot_recognized_sidebars_{$field_id}</code>' ) . '</p>'; // phpcs:ignore
+
+ /* translators: %s: dynamic sidebar name */
+ $string = esc_html__( 'For example, if we create a WordPress theme that provides the ability to change the Blog Sidebar and we don\'t want to have the footer sidebars available on this area, we can unset those sidebars either manually or by using a regular expression if we have a common name like %s.', 'option-tree' );
+ echo '<p>' . sprintf( $string, '<code>footer-sidebar-$i</code>' ) . '</p>'; // phpcs:ignore
+
+ echo '<h4>' . esc_html__( 'Slider', 'option-tree' ) . ':</h4>';
+ echo '<p>' . esc_html__( 'The Slider option type is technically deprecated. Use the List Item option type instead, as it\'s infinitely more customizable. Typical use is for creating sliding image content.', 'option-tree' ) . '</p>';
+
+ echo '<h4>' . esc_html__( 'Social Links', 'option-tree' ) . ':</h4>';
+
+ /* translators: %1$s: filter name, %2$s: boolean value, %3$s: filter name, %4$s: filter name */
+ $string = esc_html__( 'The Social Links option type utilizes a drag & drop interface to create a list of social links. There are a few filters that make extending this option type easy. You can set the %1$s filter to %2$s and turn off loading default values. Use the %3$s filter to change the default values that are loaded. To filter the settings array use the %4$s filter.', 'option-tree' );
+ echo '<p>' . sprintf( $string, '<code>ot_type_social_links_load_defaults</code>', '<code>false</code>', '<code>ot_type_social_links_defaults</code>', '<code>ot_social_links_settings</code>' ) . '</p>'; // phpcs:ignore
+
+ echo '<h4>' . esc_html__( 'Spacing', 'option-tree' ) . ':</h4>';
+
+ /* translators: %1$s: pixel unit, %2$s: percentage unit, %3$s: em unit, %4$s: point unit, %5$s: filter name */
+ $string = esc_html__( 'The Spacing option type is used to set spacing values such as padding or margin in the form of top, right, bottom, and left. The text inputs except numerical values and the select lets you choose the unit of measurement to add to that value. Currently the default units are %1$s, %2$s, %3$s, and %4$s. However, you can change them with the %5$s filter.', 'option-tree' );
+ echo '<p>' . sprintf( $string, '<code>px</code>', '<code>%</code>', '<code>em</code>', '<code>pt</code>', '<code>ot_recognized_spacing_unit_types</code>' ) . '</p>'; // phpcs:ignore
+
+ echo '<h4>' . esc_html__( 'Tab', 'option-tree' ) . ':</h4>';
+ echo '<p>' . esc_html__( 'The Tab option type will break a section or metabox into tabbed content.', 'option-tree' ) . '</p>';
+
+ echo '<h4>' . esc_html__( 'Tag Checkbox', 'option-tree' ) . ':</h4>';
+ echo '<p>' . esc_html__( 'The Tag Checkbox option type displays a list of tag IDs. It allows the user to check multiple tag IDs and will return that value as an array for use in a custom function or loop.', 'option-tree' ) . '</p>';
+
+ echo '<h4>' . esc_html__( 'Tag Select', 'option-tree' ) . ':</h4>';
+ echo '<p>' . esc_html__( 'The Tag Select option type displays a list of tag IDs. It allows the user to select only one tag ID and will return that value for use in a custom function or loop.', 'option-tree' ) . '</p>';
+
+ echo '<h4>' . esc_html__( 'Taxonomy Checkbox', 'option-tree' ) . ':</h4>';
+ echo '<p>' . esc_html__( 'The Taxonomy Checkbox option type displays a list of taxonomy IDs. It allows the user to check multiple taxonomy IDs and will return that value as an array for use in a custom function or loop.', 'option-tree' ) . '</p>';
+
+ echo '<h4>' . esc_html__( 'Taxonomy Select', 'option-tree' ) . ':</h4>';
+ echo '<p>' . esc_html__( 'The Taxonomy Select option type displays a list of taxonomy IDs. It allows the user to select only one taxonomy ID and will return that value for use in a custom function or loop.', 'option-tree' ) . '</p>';
+
+ echo '<h4>' . esc_html__( 'Text', 'option-tree' ) . ':</h4>';
+ echo '<p>' . esc_html__( 'The Text option type is used to save string values. For example, any optional or required text that is of reasonably short character length.', 'option-tree' ) . '</p>';
+
+ echo '<h4>' . esc_html__( 'Textarea', 'option-tree' ) . ':</h4>';
+
+ /* translators: %1$s: filter name, %2$s: filter name, %3$s: filter name, %4$s: filter name */
+ $string = esc_html__( 'The Textarea option type is a large string value used for custom code or text in the theme and has a WYSIWYG editor that can be filtered to change the how it is displayed. For example, you can filter %1$s, %2$s, %3$s, and %4$s.', 'option-tree' );
+ echo '<p>' . sprintf( $string, '<code>wpautop</code>', '<code>media_buttons</code>', '<code>tinymce</code>', '<code>quicktags</code>' ) . '</p>'; // phpcs:ignore
+
+ /* translators: %s: file name */
+ $string = esc_html__( 'Example filters to alter the Textarea option type. Added to %s.', 'option-tree' );
+ echo '<p class="aside">' . sprintf( $string, '<code>functions.php</code>' ) . '</p>'; // phpcs:ignore
+
+ /* translators: %1$s: filter name, %2$s: boolean value, %3$s: paragraph tag */
+ $string = esc_html__( 'This example keeps WordPress from executing the %1$s filter on the line breaks. The default is %2$s which means it wraps line breaks with an HTML %3$s tag.', 'option-tree' );
+ echo '<p>' . sprintf( $string, '<code>wpautop</code>', '<code>true</code>', '<code>p</code>' ) . '</p>'; // phpcs:ignore
+
+ echo '<pre><code>function filter_textarea_wpautop( $content, $field_id ) {
/* only run the filter on the textarea with a field ID of my_textarea */
if ( $field_id == \'my_textarea\' ) {
@@ -311,8 +395,11 @@
}
add_filter( \'ot_wpautop\', \'filter_textarea_wpautop\', 10, 2 );</code></pre>';
- echo '<p>' . __( 'This example keeps WordPress from executing the <code>media_buttons</code> filter on the textarea WYSIWYG. The default is <code>true</code> which means show the buttons.', 'option-tree' ) . '</p>';
- echo '<pre><code>function filter_textarea_media_buttons( $content, $field_id ) {
+ /* translators: %1$s: filter name, %2$s: boolean value */
+ $string = esc_html__( 'This example keeps WordPress from executing the %1$s filter on the textarea WYSIWYG. The default is %2$s which means show the buttons.', 'option-tree' );
+ echo '<p>' . sprintf( $string, '<code>media_buttons</code>', '<code>true</code>' ) . '</p>'; // phpcs:ignore
+
+ echo '<pre><code>function filter_textarea_media_buttons( $content, $field_id ) {
/* only run the filter on the textarea with a field ID of my_textarea */
if ( $field_id == \'my_textarea\' ) {
@@ -323,9 +410,12 @@
}
add_filter( \'ot_media_buttons\', \'filter_textarea_media_buttons\', 10, 2 );</code></pre>';
-
- echo '<p>' . __( 'This example keeps WordPress from executing the <code>tinymce</code> filter on the textarea WYSIWYG. The default is <code>true</code> which means show the tinymce.', 'option-tree' ) . '</p>';
- echo '<pre><code>function filter_textarea_tinymce( $content, $field_id ) {
+
+ /* translators: %1$s: filter name, %2$s: boolean value */
+ $string = esc_html__( 'This example keeps WordPress from executing the %1$s filter on the textarea WYSIWYG. The default is %2$s which means show the tinymce.', 'option-tree' );
+ echo '<p>' . sprintf( $string, '<code>tinymce</code>', '<code>true</code>' ) . '</p>'; // phpcs:ignore
+
+ echo '<pre><code>function filter_textarea_tinymce( $content, $field_id ) {
/* only run the filter on the textarea with a field ID of my_textarea */
if ( $field_id == \'my_textarea\' ) {
@@ -337,8 +427,10 @@
}
add_filter( \'ot_tinymce\', \'filter_textarea_tinymce\', 10, 2 );</code></pre>';
- echo '<p>' . __( 'This example alters the <code>quicktags</code> filter on the textarea WYSIWYG. The default is <code>array( \'buttons\' => \'strong,em,link,block,del,ins,img,ul,ol,li,code,spell,close\' )</code> which means show those quicktags. It also means you can filter in your own custom quicktags.', 'option-tree' ) . '</p>';
- echo '<pre><code>function filter_textarea_quicktags( $content, $field_id ) {
+ /* translators: %1$s: filter name, %2$s: tags list */
+ $string = esc_html__( 'This example alters the %1$s filter on the textarea WYSIWYG. The default is %2$s which means show those quicktags. It also means you can filter in your own custom quicktags.', 'option-tree' );
+ echo '<p>' . sprintf( $string, '<code>quicktags</code>', '<code>array( \'buttons\' => \'strong,em,link,block,del,ins,img,ul,ol,li,code,spell,close\' )</code>' ) . '</p>'; // phpcs:ignore
+ echo '<pre><code>function filter_textarea_quicktags( $content, $field_id ) {
/* only run the filter on the textarea with a field ID of my_textarea */
if ( $field_id == \'my_textarea\' ) {
@@ -352,11 +444,13 @@
}
add_filter( \'ot_quicktags\', \'filter_textarea_quicktags\', 10, 1 );</code></pre>';
- echo '<h4>'. __( 'Textarea Simple', 'option-tree' ) . ':</h4>';
- echo '<p>' . __( 'The Textarea Simple option type is a large string value used for custom code or text in the theme. The Textarea Simple does not have a WYSIWYG editor.', 'option-tree' ) . '</p>';
-
- echo '<p class="aside">' . sprintf( __( 'This example tells WordPress to execute the %s filter on the line breaks. The default is %s which means it does not wraps line breaks with an HTML %s tag. Added to %s.', 'option-tree' ), '<code>wpautop</code>', '<code>false</code>', '<code>p</code>', '<code>functions.php</code>' ) . '</p>';
- echo '<pre><code>function filter_textarea_simple_wpautop( $content, $field_id ) {
+ echo '<h4>' . esc_html__( 'Textarea Simple', 'option-tree' ) . ':</h4>';
+ echo '<p>' . esc_html__( 'The Textarea Simple option type is a large string value used for custom code or text in the theme. The Textarea Simple does not have a WYSIWYG editor.', 'option-tree' ) . '</p>';
+
+ /* translators: %1$s: function name, %2$s: boolean value, %3$s: paragraph tag, %4$s: file name */
+ $string = esc_html__( 'This example tells WordPress to execute the %1$s filter on the line breaks. The default is %2$s which means it does not wraps line breaks with an HTML %3$s tag. Added to %4$s.', 'option-tree' );
+ echo '<p class="aside">' . sprintf( $string, '<code>wpautop</code>', '<code>false</code>', '<code>p</code>', '<code>functions.php</code>' ) . '</p>'; // phpcs:ignore
+ echo '<pre><code>function filter_textarea_simple_wpautop( $content, $field_id ) {
/* only run the filter on the textarea with a field ID of my_textarea */
if ( $field_id == \'my_textarea\' ) {
@@ -367,18 +461,21 @@
}
add_filter( \'ot_wpautop\', \'filter_textarea_simple_wpautop\', 10, 2 );</code></pre>';
-
- echo '<h4>'. __( 'Textblock', 'option-tree' ) . ':</h4>';
- echo '<p>' . __( 'The Textblock option type is used only on the Theme Option page. It will allow you to create & display HTML, but has no title above the text block. You can then use the Textblock to add a more detailed set of instruction on how the options are used in your theme. You would never use this in your themes template files as it does not save a value.', 'option-tree' ) . '</p>';
-
- echo '<h4>'. __( 'Textblock Titled', 'option-tree' ) . ':</h4>';
- echo '<p>' . __( 'The Textblock Titled option type is used only on the Theme Option page. It will allow you to create & display HTML, and has a title above the text block. You can then use the Textblock Titled to add a more detailed set of instruction on how the options are used in your theme. You would never use this in your themes template files as it does not save a value.', 'option-tree' ) . '</p>';
-
- echo '<h4>'. __( 'Typography', 'option-tree' ) . ':</h4>';
- echo '<p>' . sprintf( __( 'The Typography option type is for adding typography styles to your theme either dynamically via the CSS option type above or manually with %s. The Typography option type has filters that allow you to remove fields or change the defaults. For example, you can filter %s to remove unwanted fields from all Background options or an individual one. You can also filter %s. These filters allow you to fine tune the select lists for your specific needs.', 'option-tree' ), '<code>ot_get_option()</code>', '<code>ot_recognized_typography_fields</code>', '<code>ot_recognized_font_families</code>, <code>ot_recognized_font_sizes</code>, <code>ot_recognized_font_styles</code>, <code>ot_recognized_font_variants</code>, <code>ot_recognized_font_weights</code>, <code>ot_recognized_letter_spacing</code>, <code>ot_recognized_line_heights</code>, <code>ot_recognized_text_decorations</code> ' . __( 'and', 'option-tree' ) . ' <code>ot_recognized_text_transformations</code>' ) . '</p>';
-
- echo '<p class="aside">' . __( 'This example would filter <code>ot_recognized_font_families</code> to build your own font stack. Added to <code>functions.php</code>.', 'option-tree' ) . '</p>';
- echo '<pre><code>function filter_ot_recognized_font_families( $array, $field_id ) {
+
+ echo '<h4>' . esc_html__( 'Textblock', 'option-tree' ) . ':</h4>';
+ echo '<p>' . esc_html__( 'The Textblock option type is used only on the Theme Option page. It will allow you to create & display HTML, but has no title above the text block. You can then use the Textblock to add a more detailed set of instruction on how the options are used in your theme. You would never use this in your themes template files as it does not save a value.', 'option-tree' ) . '</p>';
+
+ echo '<h4>' . esc_html__( 'Textblock Titled', 'option-tree' ) . ':</h4>';
+ echo '<p>' . esc_html__( 'The Textblock Titled option type is used only on the Theme Option page. It will allow you to create & display HTML, and has a title above the text block. You can then use the Textblock Titled to add a more detailed set of instruction on how the options are used in your theme. You would never use this in your themes template files as it does not save a value.', 'option-tree' ) . '</p>';
+
+ echo '<h4>' . esc_html__( 'Typography', 'option-tree' ) . ':</h4>';
+
+ /* translators: %1$s: function name, %2$s: filter name, %3$s: filter name list */
+ $string = esc_html__( 'The Typography option type is for adding typography styles to your theme either dynamically via the CSS option type above or manually with %1$s. The Typography option type has filters that allow you to remove fields or change the defaults. For example, you can filter %2$s to remove unwanted fields from all Background options or an individual one. You can also filter %3$s. These filters allow you to fine tune the select lists for your specific needs.', 'option-tree' );
+ echo '<p>' . sprintf( $string, '<code>ot_get_option()</code>', '<code>ot_recognized_typography_fields</code>', '<code>ot_recognized_font_families</code>, <code>ot_recognized_font_sizes</code>, <code>ot_recognized_font_styles</code>, <code>ot_recognized_font_variants</code>, <code>ot_recognized_font_weights</code>, <code>ot_recognized_letter_spacing</code>, <code>ot_recognized_line_heights</code>, <code>ot_recognized_text_decorations</code> ' . esc_html__( 'and', 'option-tree' ) . ' <code>ot_recognized_text_transformations</code>' ) . '</p>'; // phpcs:ignore
+
+ echo '<p class="aside">' . esc_html__( 'This example would filter <code>ot_recognized_font_families</code> to build your own font stack. Added to <code>functions.php</code>.', 'option-tree' ) . '</p>';
+ echo '<pre><code>function filter_ot_recognized_font_families( $array, $field_id ) {
/* only run the filter when the field ID is my_google_fonts_headings */
if ( $field_id == \'my_google_fonts_headings\' ) {
@@ -394,164 +491,163 @@
}
add_filter( \'ot_recognized_font_families\', \'filter_ot_recognized_font_families\', 10, 2 );</code></pre>';
- echo '<h4>'. __( 'Upload', 'option-tree' ) . ':</h4>';
- echo '<p>' . sprintf( __( 'The Upload option type is used to upload any WordPress supported media. After uploading, users are required to press the "%s" button in order to populate the input with the URI of that media. There is one caveat of this feature. If you import the theme options and have uploaded media on one site the old URI will not reflect the URI of your new site. You will have to re-upload or %s any media to your new server and change the URIs if necessary.', 'option-tree' ), apply_filters( 'ot_upload_text', __( 'Send to OptionTree', 'option-tree' ) ), 'FTP' ) . '</p>';
-
- echo '</div>';
-
- echo '</div>';
-
- }
-
+ echo '<h4>' . esc_html__( 'Upload', 'option-tree' ) . ':</h4>';
+
+ /* translators: %1$s: button text, %2$s: the FTP protocol */
+ $string = esc_html__( 'The Upload option type is used to upload any WordPress supported media. After uploading, users are required to press the "%1$s" button in order to populate the input with the URI of that media. There is one caveat of this feature. If you import the theme options and have uploaded media on one site the old URI will not reflect the URI of your new site. You will have to re-upload or %2$s any media to your new server and change the URIs if necessary.', 'option-tree' );
+ echo '<p>' . sprintf( $string, esc_html( apply_filters( 'ot_upload_text', __( 'Send to OptionTree', 'option-tree' ) ) ), 'FTP' ) . '</p>'; // phpcs:ignore
+
+ echo '</div>';
+
+ echo '</div>';
+ }
}
-/**
- * ot_get_option() option type.
- *
- * This is a callback function to display text about ot_get_option().
- *
- * @return string
- *
- * @access public
- * @since 2.0
- */
if ( ! function_exists( 'ot_type_ot_get_option' ) ) {
-
- function ot_type_ot_get_option() {
-
- /* format setting outer wrapper */
- echo '<div class="format-setting type-textblock wide-desc">';
-
- /* description */
- echo '<div class="description">';
-
- echo '<h4>'. __( 'Description', 'option-tree' ) . ':</h4>';
-
- echo '<p>' . __( 'This function returns a value from the "option_tree" array of saved values or the default value supplied. The returned value would be mixed. Meaning it could be a string, integer, boolean, or array.', 'option-tree' ) . '</p>';
-
- echo '<h4>' . __( 'Usage', 'option-tree' ) . ':</h4>';
-
- echo '<p><code><?php ot_get_option( $option_id, $default ); ?></code></p>';
-
- echo '<h4>' . __( 'Parameters', 'option-tree' ) . ':</h4>';
-
- echo '<code>$option_id</code>';
-
- echo '<p>(<em>' . __( 'string', 'option-tree' ) . '</em>) (<em>' . __( 'required', 'option-tree' ) . '</em>) ' . __( 'Enter the options unique identifier.', 'option-tree' ) . '<br />' . __( 'Default:', 'option-tree' ) . ' <em>' . __( 'None', 'option-tree' ) . '</em></p>';
-
- echo '<code>$default</code>';
-
- echo '<p>(<em>' . __( 'string', 'option-tree' ) . '</em>) (<em>' . __( 'optional', 'option-tree' ) . '</em>) ' . __( 'Enter a default return value. This is just incase the request returns null.', 'option-tree' ) . '<br />' . __( 'Default', 'option-tree' ) . ': <em>' . __( 'None', 'option-tree' ) . '</em></p>';
-
- echo '</div>';
-
- echo '</div>';
-
- }
-
+
+ /**
+ * The ot_get_option() option type.
+ *
+ * This is a callback function to display text about ot_get_option().
+ *
+ * @access public
+ * @since 2.0
+ */
+ function ot_type_ot_get_option() {
+
+ // Format setting outer wrapper.
+ echo '<div class="format-setting type-textblock wide-desc">';
+
+ // Description.
+ echo '<div class="description">';
+
+ echo '<h4>' . esc_html__( 'Description', 'option-tree' ) . ':</h4>';
+
+ echo '<p>' . esc_html__( 'This function returns a value from the "option_tree" array of saved values or the default value supplied. The returned value would be mixed. Meaning it could be a string, integer, boolean, or array.', 'option-tree' ) . '</p>';
+
+ echo '<h4>' . esc_html__( 'Usage', 'option-tree' ) . ':</h4>';
+
+ echo '<p><code><?php ot_get_option( $option_id, $default ); ?></code></p>';
+
+ echo '<h4>' . esc_html__( 'Parameters', 'option-tree' ) . ':</h4>';
+
+ echo '<code>$option_id</code>';
+
+ echo '<p>(<em>' . esc_html__( 'string', 'option-tree' ) . '</em>) (<em>' . esc_html__( 'required', 'option-tree' ) . '</em>) ' . esc_html__( 'Enter the options unique identifier.', 'option-tree' ) . '<br />' . esc_html__( 'Default:', 'option-tree' ) . ' <em>' . esc_html__( 'None', 'option-tree' ) . '</em></p>';
+
+ echo '<code>$default</code>';
+
+ echo '<p>(<em>' . esc_html__( 'string', 'option-tree' ) . '</em>) (<em>' . esc_html__( 'optional', 'option-tree' ) . '</em>) ' . esc_html__( 'Enter a default return value. This is just incase the request returns null.', 'option-tree' ) . '<br />' . esc_html__( 'Default', 'option-tree' ) . ': <em>' . esc_html__( 'None', 'option-tree' ) . '</em></p>';
+
+ echo '</div>';
+
+ echo '</div>';
+ }
}
-/**
- * get_option_tree() option type.
- *
- * This is a callback function to display text about get_option_tree().
- *
- * @return string
- *
- * @access public
- * @since 2.0
- */
if ( ! function_exists( 'ot_type_get_option_tree' ) ) {
-
- function ot_type_get_option_tree() {
-
- /* format setting outer wrapper */
- echo '<div class="format-setting type-textblock wide-desc">';
-
- /* description */
- echo '<div class="description">';
-
- echo '<p class="deprecated">' . __( 'This function has been deprecated. That means it has been replaced by a new function or is no longer supported, and may be removed from future versions. All code that uses this function should be converted to use its replacement.', 'option-tree' ) . '</p>';
-
- echo '<p>' . __( 'Use', 'option-tree' ) . '<code>ot_get_option()</code>' . __( 'instead', 'option-tree' ) . '.</p>';
-
- echo '<h4>'. __( 'Description', 'option-tree' ) . ':</h4>';
-
- echo '<p>' . __( 'This function returns, or echos if asked, a value from the "option_tree" array of saved values.', 'option-tree' ) . '</p>';
-
- echo '<h4>' . __( 'Usage', 'option-tree' ) . ':</h4>';
-
- echo '<p><code><?php get_option_tree( $item_id, $options, $echo, $is_array, $offset ); ?></code></p>';
-
- echo '<h4>' . __( 'Parameters', 'option-tree' ) . ':</h4>';
-
- echo '<code>$item_id</code>';
-
- echo '<p>(<em>' . __( 'string', 'option-tree' ) . '</em>) (<em>' . __( 'required', 'option-tree' ) . '</em>) ' . __( 'Enter a unique Option Key to get a returned value or array.', 'option-tree' ) . '<br />' . __( 'Default:', 'option-tree' ) . ' <em>' . __( 'None', 'option-tree' ) . '</em></p>';
-
- echo '<code>$options</code>';
-
- echo '<p>(<em>' . __( 'array', 'option-tree' ) . '</em>) (<em>' . __( 'optional', 'option-tree' ) . '</em>) ' . __( 'Used to cut down on database queries in template files.', 'option-tree' ) . '<br />' . __( 'Default', 'option-tree' ) . ': <em>' . __( 'None', 'option-tree' ) . '</em></p>';
-
- echo '<code>$echo</code>';
-
- echo '<p>(<em>' . __( 'boolean', 'option-tree' ) . '</em>) (<em>' . __( 'optional', 'option-tree' ) . '</em>) ' . __( 'Echo the output.', 'option-tree' ) . '<br />' . __( 'Default', 'option-tree' ) . ': FALSE</p>';
-
- echo '<code>$is_array</code>';
-
- echo '<p>(<em>' . __( 'boolean', 'option-tree' ) . '</em>) (<em>' . __( 'optional', 'option-tree' ) . '</em>) ' . __( 'Used to indicate the $item_id is an array of values.', 'option-tree' ) . '<br />' . __( 'Default', 'option-tree' ) . ': FALSE</p>';
-
- echo '<code>$offset</code>';
-
- echo '<p>(<em>' . __( 'integer', 'option-tree' ) . '</em>) (<em>' . __( 'optional', 'option-tree' ) . '</em>) ' . __( 'Numeric offset key for the $item_id array, -1 will return all values (an array starts at 0).', 'option-tree' ) . '<br />' . __( 'Default', 'option-tree' ) . ': -1</p>';
-
- echo '</div>';
-
- echo '</div>';
-
- }
-
+
+ /**
+ * The get_option_tree() option type.
+ *
+ * This is a callback function to display text about get_option_tree().
+ *
+ * @access public
+ * @since 2.0
+ */
+ function ot_type_get_option_tree() {
+
+ // Format setting outer wrapper.
+ echo '<div class="format-setting type-textblock wide-desc">';
+
+ // Description.
+ echo '<div class="description">';
+
+ echo '<p class="deprecated">' . esc_html__( 'This function has been deprecated. That means it has been replaced by a new function or is no longer supported, and may be removed from future versions. All code that uses this function should be converted to use its replacement.', 'option-tree' ) . '</p>';
+
+ echo '<p>' . esc_html__( 'Use', 'option-tree' ) . '<code>ot_get_option()</code>' . esc_html__( 'instead', 'option-tree' ) . '.</p>';
+
+ echo '<h4>' . esc_html__( 'Description', 'option-tree' ) . ':</h4>';
+
+ echo '<p>' . esc_html__( 'This function returns, or echos if asked, a value from the "option_tree" array of saved values.', 'option-tree' ) . '</p>';
+
+ echo '<h4>' . esc_html__( 'Usage', 'option-tree' ) . ':</h4>';
+
+ echo '<p><code><?php get_option_tree( $item_id, $options, $echo, $is_array, $offset ); ?></code></p>';
+
+ echo '<h4>' . esc_html__( 'Parameters', 'option-tree' ) . ':</h4>';
+
+ echo '<code>$item_id</code>';
+
+ echo '<p>(<em>' . esc_html__( 'string', 'option-tree' ) . '</em>) (<em>' . esc_html__( 'required', 'option-tree' ) . '</em>) ' . esc_html__( 'Enter a unique Option Key to get a returned value or array.', 'option-tree' ) . '<br />' . esc_html__( 'Default:', 'option-tree' ) . ' <em>' . esc_html__( 'None', 'option-tree' ) . '</em></p>';
+
+ echo '<code>$options</code>';
+
+ echo '<p>(<em>' . esc_html__( 'array', 'option-tree' ) . '</em>) (<em>' . esc_html__( 'optional', 'option-tree' ) . '</em>) ' . esc_html__( 'Used to cut down on database queries in template files.', 'option-tree' ) . '<br />' . esc_html__( 'Default', 'option-tree' ) . ': <em>' . esc_html__( 'None', 'option-tree' ) . '</em></p>';
+
+ echo '<code>$echo</code>';
+
+ echo '<p>(<em>' . esc_html__( 'boolean', 'option-tree' ) . '</em>) (<em>' . esc_html__( 'optional', 'option-tree' ) . '</em>) ' . esc_html__( 'Echo the output.', 'option-tree' ) . '<br />' . esc_html__( 'Default', 'option-tree' ) . ': FALSE</p>';
+
+ echo '<code>$is_array</code>';
+
+ echo '<p>(<em>' . esc_html__( 'boolean', 'option-tree' ) . '</em>) (<em>' . esc_html__( 'optional', 'option-tree' ) . '</em>) ' . esc_html__( 'Used to indicate the $item_id is an array of values.', 'option-tree' ) . '<br />' . esc_html__( 'Default', 'option-tree' ) . ': FALSE</p>';
+
+ echo '<code>$offset</code>';
+
+ echo '<p>(<em>' . esc_html__( 'integer', 'option-tree' ) . '</em>) (<em>' . esc_html__( 'optional', 'option-tree' ) . '</em>) ' . esc_html__( 'Numeric offset key for the $item_id array, -1 will return all values (an array starts at 0).', 'option-tree' ) . '<br />' . esc_html__( 'Default', 'option-tree' ) . ': -1</p>';
+
+ echo '</div>';
+
+ echo '</div>';
+ }
}
-/**
- * Examples option type.
- *
- * @return string
- *
- * @access public
- * @since 2.0
- */
if ( ! function_exists( 'ot_type_examples' ) ) {
-
- function ot_type_examples() {
-
- /* format setting outer wrapper */
- echo '<div class="format-setting type-textblock wide-desc">';
-
- /* description */
- echo '<div class="description">';
-
- echo '<p class="aside">' . __( 'If you\'re using the plugin version of OptionTree it is highly recommended to include a <code>function_exists</code> check in your code, as described in the examples below. If you\'ve integrated OptionTree directly into your themes root directory, you will <strong>not</strong> need to wrap your code with <code>function_exists</code>, as you\'re guaranteed to have the <code>ot_get_option()</code> function available.', 'option-tree' ) . '</p>';
-
- echo '<h4>' . __( 'String Examples', 'option-tree' ) . ':</h4>';
-
- echo '<p>' . __( 'Returns the value of <code>test_input</code>.', 'option-tree' ) . '</p>';
-
- echo '<pre><code>if ( function_exists( \'ot_get_option\' ) ) {
+
+ /**
+ * Examples option type.
+ *
+ * @access public
+ * @since 2.0
+ */
+ function ot_type_examples() {
+
+ // Format setting outer wrapper.
+ echo '<div class="format-setting type-textblock wide-desc">';
+
+ // Description.
+ echo '<div class="description">';
+
+ /* translators: %1$s: function name, %2$s: emphasis on not, %3$s: function name, %4$s: function name */
+ $string = esc_html__( 'If you\'re using the plugin version of OptionTree it is highly recommended to include a %1$s check in your code, as described in the examples below. If you\'ve integrated OptionTree directly into your themes root directory, you will %2$s need to wrap your code with %3$s, as you\'re guaranteed to have the %4$s function available.', 'option-tree' );
+ echo '<p class="aside">' . sprintf( $string, '<code>function_exists</code>', '<strong>' . esc_html__( 'not', 'option-tree' ) . '</strong>', '<code>function_exists</code>', '<code>ot_get_option()</code>' ) . '</p>'; // phpcs:ignore
+
+ echo '<h4>' . esc_html__( 'String Examples', 'option-tree' ) . ':</h4>';
+
+ /* translators: %s: option id */
+ $string = esc_html__( 'Returns the value of %s.', 'option-tree' );
+ echo '<p>' . sprintf( $string, '<code>test_input</code>' ) . '</p>'; // phpcs:ignore
+
+ echo '<pre><code>if ( function_exists( \'ot_get_option\' ) ) {
$test_input = ot_get_option( \'test_input\' );
}</code></pre>';
- echo '<p>' . __( 'Returns the value of <code>test_input</code>, but also has a default value if it returns empty.', 'option-tree' ) . '</p>';
-
- echo '<pre><code>if ( function_exists( \'ot_get_option\' ) ) {
+ /* translators: %s: option id */
+ $string = esc_html__( 'Returns the value of %s, but also has a default value if it returns empty.', 'option-tree' );
+ echo '<p>' . sprintf( $string, '<code>test_input</code>' ) . '</p>'; // phpcs:ignore
+
+ echo '<pre><code>if ( function_exists( \'ot_get_option\' ) ) {
$test_input = ot_get_option( \'test_input\', \'default input value goes here.\' );
}</code></pre>';
-
- echo '<h4>' . __( 'Array Examples', 'option-tree' ) . ':</h4>';
-
- echo '<p>' . __( 'Assigns the value of <code>navigation_ids</code> to the variable <code>$ids</code>. It then echos an unordered list of links (navigation) using <code>wp_list_pages()</code>.', 'option-tree' ) . '</p>';
+
+ echo '<h4>' . esc_html__( 'Array Examples', 'option-tree' ) . ':</h4>';
- echo '<pre><code>if ( function_exists( \'ot_get_option\' ) ) {
+ /* translators: %1$s: option id, %2$s: variable name, %3$s: function name */
+ $string = esc_html__( 'Assigns the value of %1$s to the variable %2$s. It then echos an unordered list of links (navigation) using %3$s.', 'option-tree' );
+ echo '<p>' . sprintf( $string, '<code>navigation_ids</code>', '<code>$ids</code>', '<code>wp_list_pages()</code>' ) . '</p>'; // phpcs:ignore
+
+ echo '<pre><code>if ( function_exists( \'ot_get_option\' ) ) {
/* get an array of page id\'s */
$ids = ot_get_option( \'navigation_ids\', array() );
@@ -567,11 +663,13 @@
echo \'</ul>\';
}
-}</code></pre>';
-
- echo '<p>' . __( 'The next two examples demonstrate how to use the <strong>Measurement</strong> option type. The Measurement option type is an array with two key/value pairs. The first is the value of measurement and the second is the unit of measurement.', 'option-tree' ) . '</p>';
-
- echo '<pre><code>if ( function_exists( \'ot_get_option\' ) ) {
+}</code></pre>';
+
+ /* translators: %s: option type name */
+ $string = esc_html__( 'The next two examples demonstrate how to use the %s option type. The Measurement option type is an array with two key/value pairs. The first is the value of measurement and the second is the unit of measurement.', 'option-tree' );
+ echo '<p>' . sprintf( $string, '<strong>' . esc_html__( 'Measurement', 'option-tree' ) . '</strong>' ) . '</p>'; // phpcs:ignore
+
+ echo '<pre><code>if ( function_exists( \'ot_get_option\' ) ) {
/* get the array */
$measurement = ot_get_option( \'measurement_option_type_id\' );
@@ -584,7 +682,7 @@
}</code></pre>';
- echo '<pre><code>if ( function_exists( \'ot_get_option\' ) ) {
+ echo '<pre><code>if ( function_exists( \'ot_get_option\' ) ) {
/* get the array, and have a default just incase */
$measurement = ot_get_option( \'measurement_option_type_id\', array( \'10\', \'px\' ) );
@@ -593,11 +691,11 @@
echo implode( \'\', $measurement );
}
-}</code></pre>';
-
- echo '<p>' . __( 'This example displays a very basic slider loop.', 'option-tree' ) . '</p>';
-
- echo '<pre><code>if ( function_exists( \'ot_get_option\' ) ) {
+}</code></pre>';
+
+ echo '<p>' . esc_html__( 'This example displays a very basic slider loop.', 'option-tree' ) . '</p>';
+
+ echo '<pre><code>if ( function_exists( \'ot_get_option\' ) ) {
/* get the slider array */
$slides = ot_get_option( \'my_slider\', array() );
@@ -613,149 +711,178 @@
}
}</code></pre>';
-
- echo '</div>';
-
- echo '</div>';
-
- }
-
+
+ echo '</div>';
+
+ echo '</div>';
+ }
+}
+if ( ! function_exists( 'ot_type_layouts_overview' ) ) {
+
+ /**
+ * Layouts Overview option type.
+ *
+ * @access public
+ * @since 2.0
+ */
+ function ot_type_layouts_overview() {
+
+ // Format setting outer wrapper.
+ echo '<div class="format-setting type-textblock wide-desc">';
+
+ // Description.
+ echo '<div class="description">';
+
+ echo '<h4>' . esc_html__( 'It\'s Super Simple', 'option-tree' ) . '</h4>';
+
+ echo '<p>' . esc_html__( 'Layouts make your theme awesome! With theme options data that you can save/import/export you can package themes with different color variations, or make it easy to do A/B testing on text and so much more. Basically, you save a snapshot of your data as a layout.', 'option-tree' ) . '</p>';
+
+ echo '<p>' . esc_html__( 'Once you have created all your different layouts, or theme variations, you can save them to a separate text file for repackaging with your theme. Alternatively, you could just make different variations for yourself and change your theme with the click of a button, all without deleting your previous options data.', 'option-tree' ) . '</p>';
+
+ echo '<p class="aside">' . esc_html__( ' Adding a layout is ridiculously easy, follow these steps and you\'ll be on your way to having a WordPress super theme.', 'option-tree' ) . '</p>';
+
+ echo '<h4>' . esc_html__( 'For Developers', 'option-tree' ) . ':</h4>';
+
+ echo '<h5>' . esc_html__( 'Creating a Layout', 'option-tree' ) . ':</h5>';
+ echo '<ul class="docs-ul">';
+
+ /* translators: %s: visual path to the page */
+ $string = esc_html__( 'Go to the %s tab.', 'option-tree' );
+ echo '<li>' . sprintf( $string, '<code>' . esc_html__( 'OptionTree->Settings->Layouts', 'option-tree' ) . '</code>' ) . '</li>'; // phpcs:ignore
+ echo '<li>' . esc_html__( 'Enter a name for your layout in the text field and hit "Save Layouts", you\'ve created your first layout.', 'option-tree' ) . '</li>';
+ echo '<li>' . esc_html__( 'Adding a new layout is as easy as repeating the steps above.', 'option-tree' ) . '</li>';
+ echo '</ul>';
+
+ echo '<h5>' . esc_html__( 'Activating a Layout', 'option-tree' ) . ':</h5>';
+ echo '<ul class="docs-ul">';
+
+ /* translators: %s: visual path to the page */
+ $string = esc_html__( 'Go to the %s tab.', 'option-tree' );
+ echo '<li>' . sprintf( $string, '<code>' . esc_html__( 'OptionTree->Settings->Layouts', 'option-tree' ) . '</code>' ) . '</li>'; // phpcs:ignore
+ echo '<li>' . esc_html__( 'Click on the activate layout button in the actions list.', 'option-tree' ) . '</li>';
+ echo '</ul>';
+
+ echo '<h5>' . esc_html__( 'Deleting a Layout', 'option-tree' ) . ':</h5>';
+ echo '<ul class="docs-ul">';
+
+ /* translators: %s: visual path to the page */
+ $string = esc_html__( 'Go to the %s tab.', 'option-tree' );
+ echo '<li>' . sprintf( $string, '<code>' . esc_html__( 'OptionTree->Settings->Layouts', 'option-tree' ) . '</code>' ) . '</li>'; // phpcs:ignore
+ echo '<li>' . esc_html__( 'Click on the delete layout button in the actions list.', 'option-tree' ) . '</li>';
+ echo '</ul>';
+
+ echo '<h5>' . esc_html__( 'Edit Layout Data', 'option-tree' ) . ':</h5>';
+ echo '<ul class="docs-ul">';
+
+ /* translators: %s: visual path to the page */
+ $string = esc_html__( 'Go to the %s page.', 'option-tree' );
+ echo '<li>' . sprintf( $string, '<code>' . esc_html__( 'Appearance->Theme Options', 'option-tree' ) . '</code>' ) . '</li>'; // phpcs:ignore
+ echo '<li>' . esc_html__( 'Modify and save your theme options and the layout will be updated automatically.', 'option-tree' ) . '</li>';
+ echo '<li>' . esc_html__( 'Saving theme options data will update the currently active layout, so before you start saving make sure you want to modify the current layout.', 'option-tree' ) . '</li>';
+ echo '<li>' . esc_html__( 'If you want to edit a new layout, first create it then save your theme options.', 'option-tree' ) . '</li>';
+ echo '</ul>';
+
+ echo '<h4>' . esc_html__( 'End-Users Mode', 'option-tree' ) . ':</h4>';
+
+ echo '<h5>' . esc_html__( 'Creating a Layout', 'option-tree' ) . ':</h5>';
+ echo '<ul class="docs-ul">';
+
+ /* translators: %s: visual path to the page */
+ $string = esc_html__( 'Go to the %s page.', 'option-tree' );
+ echo '<li>' . sprintf( $string, '<code>' . esc_html__( 'Appearance->Theme Options', 'option-tree' ) . '</code>' ) . '</li>'; // phpcs:ignore
+ echo '<li>' . esc_html__( 'Enter a name for your layout in the text field and hit "New Layout", you\'ve created your first layout.', 'option-tree' ) . '</li>';
+ echo '<li>' . esc_html__( 'Adding a new layout is as easy as repeating the steps above.', 'option-tree' ) . '</li>';
+ echo '</ul>';
+
+ echo '<h5>' . esc_html__( 'Activating a Layout', 'option-tree' ) . ':</h5>';
+ echo '<ul class="docs-ul">';
+
+ /* translators: %s: visual path to the page */
+ $string = esc_html__( 'Go to the %s page.', 'option-tree' );
+ echo '<li>' . sprintf( $string, '<code>' . esc_html__( 'Appearance->Theme Options', 'option-tree' ) . '</code>' ) . '</li>'; // phpcs:ignore
+ echo '<li>' . esc_html__( 'Choose a layout from the select list and click the "Activate Layout" button.', 'option-tree' ) . '</li>';
+ echo '</ul>';
+
+ echo '<h5>' . esc_html__( 'Deleting a Layout', 'option-tree' ) . ':</h5>';
+ echo '<ul class="docs-ul">';
+ echo '<li>' . esc_html__( 'End-Users mode does not allow deleting layouts.', 'option-tree' ) . '</li>';
+ echo '</ul>';
+
+ echo '<h5>' . esc_html__( 'Edit Layout Data', 'option-tree' ) . ':</h5>';
+ echo '<ul class="docs-ul">';
+
+ /* translators: %s: visual path to the page */
+ $string = esc_html__( 'Go to the %s page.', 'option-tree' );
+ echo '<li>' . sprintf( $string, '<code>' . esc_html__( 'Appearance->Theme Options', 'option-tree' ) . '</code>' ) . '</li>'; // phpcs:ignore
+ echo '<li>' . esc_html__( 'Modify and save your theme options and the layout will be updated automatically.', 'option-tree' ) . '</li>';
+ echo '<li>' . esc_html__( 'Saving theme options data will update the currently active layout, so before you start saving make sure you want to modify the current layout.', 'option-tree' ) . '</li>';
+ echo '</ul>';
+
+ echo '</div>';
+
+ echo '</div>';
+ }
}
-/**
- * Layouts Overview option type.
- *
- * @return string
- *
- * @access public
- * @since 2.0
- */
-if ( ! function_exists( 'ot_type_layouts_overview' ) ) {
-
- function ot_type_layouts_overview() {
-
- /* format setting outer wrapper */
- echo '<div class="format-setting type-textblock wide-desc">';
-
- /* description */
- echo '<div class="description">';
-
- echo '<h4>'. __( 'It\'s Super Simple', 'option-tree' ) . '</h4>';
-
- echo '<p>' . __( 'Layouts make your theme awesome! With theme options data that you can save/import/export you can package themes with different color variations, or make it easy to do A/B testing on text and so much more. Basically, you save a snapshot of your data as a layout.', 'option-tree' ) . '</p>';
-
- echo '<p>' . __( 'Once you have created all your different layouts, or theme variations, you can save them to a separate text file for repackaging with your theme. Alternatively, you could just make different variations for yourself and change your theme with the click of a button, all without deleting your previous options data.', 'option-tree' ) . '</p>';
+if ( ! function_exists( 'ot_type_meta_boxes' ) ) {
+
+ /**
+ * Meta Boxes option type.
+ *
+ * @access public
+ * @since 2.0
+ */
+ function ot_type_meta_boxes() {
- echo '<p class="aside">' . __( ' Adding a layout is ridiculously easy, follow these steps and you\'ll be on your way to having a WordPress super theme.', 'option-tree' ) . '</p>';
-
- echo '<h4>' . __( 'For Developers', 'option-tree' ) . ':</h4>';
-
- echo '<h5>' . __( 'Creating a Layout', 'option-tree' ) . ':</h5>';
- echo '<ul class="docs-ul">';
- echo '<li>'. __( 'Go to the <code>OptionTre->Settings->Layouts</code> tab.', 'option-tree' ) . '</li>';
- echo '<li>' . __( 'Enter a name for your layout in the text field and hit "Save Layouts", you\'ve created your first layout.', 'option-tree' ) . '</li>';
- echo '<li>' . __( 'Adding a new layout is as easy as repeating the steps above.', 'option-tree' ) . '</li>';
- echo '</ul>';
-
- echo '<h5>' . __( 'Activating a Layout', 'option-tree' ) . ':</h5>';
- echo '<ul class="docs-ul">';
- echo '<li>'. __( 'Go to the <code>OptionTre->Settings->Layouts</code> tab.', 'option-tree' ) . '</li>';
- echo '<li>' . __( 'Click on the activate layout button in the actions list.', 'option-tree' ) . '</li>';
- echo '</ul>';
-
- echo '<h5>' . __( 'Deleting a Layout', 'option-tree' ) . ':</h5>';
- echo '<ul class="docs-ul">';
- echo '<li>'. __( 'Go to the <code>OptionTre->Settings->Layouts</code> tab.', 'option-tree' ) . '</li>';
- echo '<li>' . __( 'Click on the delete layout button in the actions list.', 'option-tree' ) . '</li>';
- echo '</ul>';
-
- echo '<h5>' . __( 'Edit Layout Data', 'option-tree' ) . ':</h5>';
- echo '<ul class="docs-ul">';
- echo '<li>'. __( 'Go to the <code>Appearance->Theme Options</code> page.', 'option-tree' ) . '</li>';
- echo '<li>' . __( 'Modify and save your theme options and the layout will be updated automatically.', 'option-tree' ) . '</li>';
- echo '<li>' . __( 'Saving theme options data will update the currently active layout, so before you start saving make sure you want to modify the current layout.', 'option-tree' ) . '</li>';
- echo '<li>' . __( 'If you want to edit a new layout, first create it then save your theme options.', 'option-tree' ) . '</li>';
- echo '</ul>';
+ // Format setting outer wrapper.
+ echo '<div class="format-setting type-textblock wide-desc">';
+
+ // Description.
+ echo '<div class="description">';
+
+ echo '<h4>' . esc_html__( 'How-to-guide', 'option-tree' ) . '</h4>';
+
+ /* translators: %1$s: directory name, %2$s: directory name, %3$s: file type */
+ $string = esc_html__( 'There are a few simple steps you need to take in order to use OptionTree\'s built in Meta Box API. In the code below I\'ll show you a basic demo of how to create your very own custom meta box using any number of the option types you have at your disposal. If you would like to see some demo code, there is a directory named %1$s inside the %2$s directory that contains a file named %3$s you can reference.', 'option-tree' );
+ echo '<p>' . sprintf( $string, '<code>theme-mode</code>', '<code>assets</code>', '<code>demo-meta-boxes.php</code>' ) . '</p>'; // phpcs:ignore
- echo '<h4>' . __( 'End-Users Mode', 'option-tree' ) . ':</h4>';
-
- echo '<h5>' . __( 'Creating a Layout', 'option-tree' ) . ':</h5>';
- echo '<ul class="docs-ul">';
- echo '<li>'. __( 'Go to the <code>Appearance->Theme Options</code> page.', 'option-tree' ) . '</li>';
- echo '<li>' . __( 'Enter a name for your layout in the text field and hit "New Layout", you\'ve created your first layout.', 'option-tree' ) . '</li>';
- echo '<li>' . __( 'Adding a new layout is as easy as repeating the steps above.', 'option-tree' ) . '</li>';
- echo '</ul>';
-
- echo '<h5>' . __( 'Activating a Layout', 'option-tree' ) . ':</h5>';
- echo '<ul class="docs-ul">';
- echo '<li>'. __( 'Go to the <code>Appearance->Theme Options</code> page.', 'option-tree' ) . '</li>';
- echo '<li>' . __( 'Choose a layout from the select list and click the "Activate Layout" button.', 'option-tree' ) . '</li>';
- echo '</ul>';
-
- echo '<h5>' . __( 'Deleting a Layout', 'option-tree' ) . ':</h5>';
- echo '<ul class="docs-ul">';
- echo '<li>'. __( 'End-Users mode does not allow deleting layouts.', 'option-tree' ) . '</li>';
- echo '</ul>';
-
- echo '<h5>' . __( 'Edit Layout Data', 'option-tree' ) . ':</h5>';
- echo '<ul class="docs-ul">';
- echo '<li>'. __( 'Go to the <code>Appearance->Theme Options</code> tab.', 'option-tree' ) . '</li>';
- echo '<li>' . __( 'Modify and save your theme options and the layout will be updated automatically.', 'option-tree' ) . '</li>';
- echo '<li>' . __( 'Saving theme options data will update the currently active layout, so before you start saving make sure you want to modify the current layout.', 'option-tree' ) . '</li>';
- echo '</ul>';
-
- echo '</div>';
-
- echo '</div>';
-
- }
-
-}
+ echo '<p>' . esc_html__( 'It\'s important to note that Meta Boxes do not support WYSIWYG editors at this time and if you set one of your options to Textarea it will automatically revert to a Textarea Simple until a valid solution is found. WordPress released this statement regarding the wp_editor() function:', 'option-tree' ) . '</p>';
+
+ echo '<blockquote>' . esc_html__( 'Once instantiated, the WYSIWYG editor cannot be moved around in the DOM. What this means in practical terms, is that you cannot put it in meta-boxes that can be dragged and placed elsewhere on the page.', 'option-tree' ) . '</blockquote>';
+
+ echo '<h5>' . esc_html__( 'Create and include your custom meta boxes file.', 'option-tree' ) . '</h5>';
+
+ echo '<ul class="docs-ul">';
+
+ /* translators: %s: file name */
+ $string = esc_html__( 'Create a file and name it anything you want, maybe %s.', 'option-tree' );
+ echo '<li>' . sprintf( $string, '<code>meta-boxes.php</code>' ) . '</li>'; // phpcs:ignore
-/**
- * Meta Boxes option type.
- *
- * @return string
- *
- * @access public
- * @since 2.0
- */
-if ( ! function_exists( 'ot_type_meta_boxes' ) ) {
-
- function ot_type_meta_boxes() {
-
- /* format setting outer wrapper */
- echo '<div class="format-setting type-textblock wide-desc">';
-
- /* description */
- echo '<div class="description">';
-
- echo '<h4>'. __( 'How-to-guide', 'option-tree' ) . '</h4>';
-
- echo '<p>' . __( 'There are a few simple steps you need to take in order to use OptionTree\'s built in Meta Box API. In the code below I\'ll show you a basic demo of how to create your very own custom meta box using any number of the option types you have at your disposal. If you would like to see some demo code, there is a directory named <code>theme-mode</code> inside the <code>assets</code> directory that contains a file named <code>demo-meta-boxes.php</code> you can reference.', 'option-tree' ) . '</p>';
-
- echo '<p>' . __( 'It\'s important to note that Meta Boxes do not support WYSIWYG editors at this time and if you set one of your options to Textarea it will automatically revert to a Textarea Simple until a valid solution is found. WordPress released this statement regarding the wp_editor() function:', 'option-tree' ) . '</p>';
-
- echo '<blockquote>' . __( 'Once instantiated, the WYSIWYG editor cannot be moved around in the DOM. What this means in practical terms, is that you cannot put it in meta-boxes that can be dragged and placed elsewhere on the page.', 'option-tree' ) . '</blockquote>';
-
- echo '<h5>' . __( 'Create and include your custom meta boxes file.', 'option-tree' ) . '</h5>';
- echo '<ul class="docs-ul">';
- echo '<li>'. __( 'Create a file and name it anything you want, maybe <code>meta-boxes.php</code>.', 'option-tree' ) . '</li>';
- echo '<li>'. __( 'As well, you\'ll probably want to create a directory named <code>includes</code> to put your <code>meta-boxes.php</code> into which will help keep you file structure nice and tidy.', 'option-tree' ) . '</li>';
- echo '<li>' . __( 'Add the following code to your <code>functions.php</code>.', 'option-tree' ) . '</li>';
- echo '</ul>';
-
- echo '<pre><code>/**
+ /* translators: %1$s: directory name, %2$s: file name */
+ $string = esc_html__( 'As well, you\'ll probably want to create a directory named %1$s to put your %2$s into which will help keep you file structure nice and tidy.', 'option-tree' );
+ echo '<li>' . sprintf( $string, '<code>includes</code>', '<code>meta-boxes.php</code>' ) . '</li>'; // phpcs:ignore
+
+ /* translators: %s: file name */
+ $string = esc_html__( 'Add the following code to your %s.', 'option-tree' );
+ echo '<li>' . sprintf( $string, '<code>functions.php</code>' ) . '</li>'; // phpcs:ignore
+
+ echo '</ul>';
+
+ echo '<pre><code>/**
* Meta Boxes
*/
require( trailingslashit( get_template_directory() ) . \'includes/meta-boxes.php\' );
</code></pre>';
-
- echo '<ul class="docs-ul">';
- echo '<li>' . __( 'Add a variation of the following code to your <code>meta-boxes.php</code>. You\'ll obviously need to fill it in with all your custom array values. It\'s important to note here that we use the <code>admin_init</code> filter because if you were to call the <code>ot_register_meta_box</code> function before OptionTree was loaded the sky would fall on your head.', 'option-tree' ) . '</li>';
- echo '</ul>';
-
- echo "<pre><code>/**
+
+ echo '<ul class="docs-ul">';
+
+ /* translators: %1$s: file name, %2$s: hook type, %3$s: function name */
+ $string = esc_html__( 'Add a variation of the following code to your %1$s. You\'ll obviously need to fill it in with all your custom array values. It\'s important to note here that we use the %2$s filter because if you were to call the %3$s function before OptionTree was loaded the sky would fall on your head.', 'option-tree' );
+ echo '<li>' . sprintf( $string, '<code>meta-boxes.php</code>', '<code>admin_init</code>', '<code>ot_register_meta_box</code>' ) . '</li>'; // phpcs:ignore
+
+ echo '</ul>';
+
+ echo "<pre><code>/**
* Initialize the meta boxes.
*/
add_action( 'admin_init', 'custom_meta_boxes' );
@@ -784,46 +911,55 @@
ot_register_meta_box( $my_meta_box );
-}</code></pre>";
-
- echo '</div>';
-
- echo '</div>';
-
- }
-
+}</code></pre>";
+
+ echo '</div>';
+
+ echo '</div>';
+ }
}
-/**
- * Theme Mode option type.
- *
- * @return string
- *
- * @access public
- * @since 2.0
- */
if ( ! function_exists( 'ot_type_theme_mode' ) ) {
-
- function ot_type_theme_mode() {
-
- /* format setting outer wrapper */
- echo '<div class="format-setting type-textblock wide-desc">';
-
- /* description */
- echo '<div class="description">';
-
- echo '<h4>'. __( 'How-to-guide', 'option-tree' ) . '</h4>';
-
- echo '<p>' . __( 'There are a few simple steps you need to take in order to use OptionTree as a theme included module. In the code below I\'ll show you a basic demo of how to include the entire plugin as a module, which will allow you to have the most up-to-date version of OptionTree without ever needing to hack the core of the plugin. If you would like to see some demo code, there is a directory named <code>theme-mode</code> inside the <code>assets</code> directory that contains a file named <code>demo-theme-options.php</code> you can reference.', 'option-tree' ) . '</p>';
-
- echo '<h5>' . __( 'Step 1: Include the plugin & turn on theme mode.', 'option-tree' ) . '</h5>';
- echo '<ul class="docs-ul">';
- echo '<li>' . sprintf( __( 'Download the latest version of %s and unarchive the %s directory.', 'option-tree' ), '<a href="http://wordpress.org/extend/plugins/option-tree/" rel="nofollow" target="_blank">' . __( 'OptionTree', 'option-tree' ) . '</a>', '<code>.zip</code>' ) . '</li>';
- echo '<li>' . sprintf( __( 'Put the %s directory in the root of your theme. For example, the server path would be %s.', 'option-tree' ), '<code>option-tree</code>', '<code>/wp-content/themes/theme-name/option-tree/</code>' ) . '</li>';
- echo '<li>' . sprintf( __( 'Add the following code to the beginning of your %s.', 'option-tree' ), '<code>functions.php</code>' ) . '</li>';
- echo '</ul>';
-
- echo '<pre><code>/**
+
+ /**
+ * Theme Mode option type.
+ *
+ * @access public
+ * @since 2.0
+ */
+ function ot_type_theme_mode() {
+
+ // Format setting outer wrapper.
+ echo '<div class="format-setting type-textblock wide-desc">';
+
+ // Description.
+ echo '<div class="description">';
+
+ echo '<h4>' . esc_html__( 'How-to-guide', 'option-tree' ) . '</h4>';
+
+ /* translators: %1$s: directory name, %2$s: directory name, %3$s: file type */
+ $string = esc_html__( 'There are a few simple steps you need to take in order to use OptionTree as a theme included module. In the code below I\'ll show you a basic demo of how to include the entire plugin as a module, which will allow you to have the most up-to-date version of OptionTree without ever needing to hack the core of the plugin. If you would like to see some demo code, there is a directory named %1$s inside the %2$s directory that contains a file named %3$s you can reference.', 'option-tree' );
+ echo '<p>' . sprintf( $string, '<code>theme-mode</code>', '<code>assets</code>', '<code>demo-theme-options.php</code>' ) . '</p>'; // phpcs:ignore
+
+ echo '<h5>' . esc_html__( 'Step 1: Include the plugin & turn on theme mode.', 'option-tree' ) . '</h5>';
+
+ echo '<ul class="docs-ul">';
+
+ /* translators: %1$s: directory name, %2$s: file type */
+ $string = esc_html__( 'Download the latest version of %1$s and unarchive the %2$s directory.', 'option-tree' );
+ echo '<li>' . sprintf( $string, '<a href="https://wordpress.org/plugins/option-tree/" rel="nofollow" target="_blank">' . esc_html__( 'OptionTree', 'option-tree' ) . '</a>', '<code>.zip</code>' ) . '</li>'; // phpcs:ignore
+
+ /* translators: %1$s: directory name, %2$s: directory path */
+ $string = esc_html__( 'Put the %1$s directory in the root of your theme. For example, the server path would be %2$s.', 'option-tree' );
+ echo '<li>' . sprintf( $string, '<code>option-tree</code>', '<code>/wp-content/themes/theme-name/option-tree/</code>' ) . '</li>'; // phpcs:ignore
+
+ /* translators: %s: file name */
+ $string = esc_html__( 'Add the following code to the beginning of your %s.', 'option-tree' );
+ echo '<li>' . sprintf( $string, '<code>functions.php</code>' ) . '</li>'; // phpcs:ignore
+
+ echo '</ul>';
+
+ echo '<pre><code>/**
* Required: set \'ot_theme_mode\' filter to true.
*/
add_filter( \'ot_theme_mode\', \'__return_true\' );
@@ -833,31 +969,47 @@
*/
require( trailingslashit( get_template_directory() ) . \'option-tree/ot-loader.php\' );
</code></pre>';
-
- echo '<p>' . sprintf( __( 'For a list of all the OptionTree UI display filters refer to the %s file found in the %s directory of this plugin. This file is the starting point for developing themes with Theme Mode.', 'option-tree' ), '<code>demo-functions.php</code>', '<code>/assets/theme-mode/</code>' ) . '</p>';
-
- echo '<p class="aside">' . __( 'You now have OptionTree built into your theme and anytime an update is available replace the old version with the new one.', 'option-tree' ) . '</p>';
-
- echo '<h5>' . __( 'Step 2: Create Theme Options without using the UI Builder.', 'option-tree' ) . '</h5>';
- echo '<ul class="docs-ul">';
- echo '<li>'. __( 'Create a file and name it anything you want, maybe <code>theme-options.php</code>, or use the built in file export to create it for you. Remember, you should always check the file for errors before including it in your theme.', 'option-tree' ) . '</li>';
- echo '<li>'. __( 'As well, you\'ll probably want to create a directory named <code>includes</code> to put your <code>theme-options.php</code> into which will help keep you file structure nice and tidy.', 'option-tree' ) . '</li>';
- echo '<li>' . __( 'Add the following code to your <code>functions.php</code>.', 'option-tree' ) . '</li>';
- echo '</ul>';
-
- echo '<pre><code>/**
+
+ /* translators: %1$s: file name, %2$s: directory path */
+ $string = esc_html__( 'For a list of all the OptionTree UI display filters refer to the %1$s file found in the %2$s directory of this plugin. This file is the starting point for developing themes with Theme Mode.', 'option-tree' );
+ echo '<p>' . sprintf( $string, '<code>demo-functions.php</code>', '<code>/assets/theme-mode/</code>' ) . '</p>'; // phpcs:ignore
+
+ echo '<p class="aside">' . esc_html__( 'You now have OptionTree built into your theme and anytime an update is available replace the old version with the new one.', 'option-tree' ) . '</p>';
+
+ echo '<h5>' . esc_html__( 'Step 2: Create Theme Options without using the UI Builder.', 'option-tree' ) . '</h5>';
+ echo '<ul class="docs-ul">';
+
+ /* translators: %s: file name */
+ $string = esc_html__( 'Create a file and name it anything you want, maybe %s, or use the built in file export to create it for you. Remember, you should always check the file for errors before including it in your theme.', 'option-tree' );
+ echo '<li>' . sprintf( $string, '<code>theme-options.php</code>' ) . '</li>'; // phpcs:ignore
+
+ /* translators: %1$s: directory name, %2$s: file name */
+ $string = esc_html__( 'As well, you\'ll probably want to create a directory named %1$s to put your %2$s into which will help keep you file structure nice and tidy.', 'option-tree' );
+ echo '<li>' . sprintf( $string, '<code>includes</code>', '<code>theme-options.php</code>' ) . '</li>'; // phpcs:ignore
+
+ /* translators: %s: file name */
+ $string = esc_html__( 'Add the following code to your %s.', 'option-tree' );
+ echo '<li>' . sprintf( $string, '<code>functions.php</code>' ) . '</li>'; // phpcs:ignore
+
+ echo '</ul>';
+
+ echo '<pre><code>/**
* Theme Options
*/
require( trailingslashit( get_template_directory() ) . \'includes/theme-options.php\' );
</code></pre>';
-
- echo '<ul class="docs-ul">';
- echo '<li>' . __( 'Add a variation of the following code to your <code>theme-options.php</code>. You\'ll obviously need to fill it in with all your custom array values for contextual help (optional), sections (required), and settings (required).', 'option-tree' ) . '</li>';
- echo '</ul>';
-
- echo '<p>' . __( 'The code below is a boilerplate to get your started. For a full list of the available option types click the "Option Types" tab above. Also a quick note, you don\'t need to put OptionTree in theme mode to manually create options but you will want to hide the docs and settings as each time you load the admin area the settings be written over with the code below if they\'ve changed in any way. However, this ensures your settings do not get tampered with by the end-user.', 'option-tree' ) . '</p>';
-
- echo "<pre><code>/**
+
+ echo '<ul class="docs-ul">';
+
+ /* translators: %s: file name */
+ $string = esc_html__( 'Add a variation of the following code to your %s. You\'ll obviously need to fill it in with all your custom array values for contextual help (optional), sections (required), and settings (required).', 'option-tree' );
+ echo '<li>' . sprintf( $string, '<code>theme-options.php</code>' ) . '</li>'; // phpcs:ignore
+
+ echo '</ul>';
+
+ echo '<p>' . esc_html__( 'The code below is a boilerplate to get your started. For a full list of the available option types click the "Option Types" tab above. Also a quick note, you don\'t need to put OptionTree in theme mode to manually create options but you will want to hide the docs and settings as each time you load the admin area the settings be written over with the code below if they\'ve changed in any way. However, this ensures your settings do not get tampered with by the end-user.', 'option-tree' ) . '</p>';
+
+ echo "<pre><code>/**
* Initialize the options before anything else.
*/
add_action( 'init', 'custom_theme_options', 1 );
@@ -1007,14 +1159,9 @@
}
</code></pre>";
-
- echo '</div>';
-
- echo '</div>';
-
- }
-
+
+ echo '</div>';
+
+ echo '</div>';
+ }
}
-
-/* End of file ot-functions-docs-page.php */
-/* Location: ./includes/ot-functions-docs-page.php */
\ No newline at end of file