wp/wp-content/themes/IN-MOTION-package-u1/option-tree/includes/ot-functions-docs-page.php
author ymh <ymh.work@gmail.com>
Wed, 21 Sep 2022 18:19:35 +0200
changeset 18 be944660c56a
parent 0 d970ebf37754
permissions -rwxr-xr-x
Site enmi version 09/2022
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
     1
<?php if ( ! defined( 'OT_VERSION' ) ) exit( 'No direct script access allowed' );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
     2
/**
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
     3
 * OptionTree documentation page functions.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
     4
 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
     5
 * @package   OptionTree
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
     6
 * @author    Derek Herman <derek@valendesigns.com>
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
     7
 * @copyright Copyright (c) 2012, Derek Herman
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
     8
 * @since     2.0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
     9
 */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    10
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    11
/**
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    12
 * Creating Options option type.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    13
 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    14
 * @return    string
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    15
 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    16
 * @access    public
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    17
 * @since     2.0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    18
 */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    19
if ( ! function_exists( 'ot_type_creating_options' ) ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    20
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    21
  function ot_type_creating_options() {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    22
    
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    23
    /* format setting outer wrapper */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    24
    echo '<div class="format-setting type-textblock wide-desc">';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    25
      
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    26
      /* description */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    27
      echo '<div class="description">';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    28
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    29
        echo '<h4>'. __( 'Label', 'option-tree' ) . ':</h4>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    30
        echo '<p>' . __( 'The Label field should be a short but descriptive block of text 100 characters or less with no HTML.', 'option-tree' ) . '</p>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    31
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    32
        echo '<h4>'. __( 'ID', 'option-tree' ) . ':</h4>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    33
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    34
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    35
        echo '<h4>'. __( 'Type', 'option-tree' ) . ':</h4>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    36
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    37
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    38
        echo '<ul class="docs-ul">';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    39
        foreach( ot_option_types_array() as $key => $value )
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    40
          echo '<li>' . $value . '</li>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    41
        echo '</ul>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    42
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    43
        echo '<h4>'. __( 'Description', 'option-tree' ) . ':</h4>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    44
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    45
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    46
        echo '<h4>'. __( 'Choices', 'option-tree' ) . ':</h4>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    47
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    48
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    49
        echo '<h4>'. __( 'Settings', 'option-tree' ) . ':</h4>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    50
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    51
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    52
        echo '<h4>'. __( 'Standard', 'option-tree' ) . ':</h4>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    53
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    54
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    55
        echo '<h4>'. __( 'Rows', 'option-tree' ) . ':</h4>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    56
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    57
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    58
        echo '<h4>'. __( 'Post Type', 'option-tree' ) . ':</h4>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    59
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    60
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    61
        echo '<ul class="docs-ul">';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    62
          echo '<li><code>post</code></li>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    63
          echo '<li><code>page</code></li>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    64
          echo '<li><code>attachment</code></li>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    65
        echo '</ul>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    66
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    67
        echo '<h4>'. __( 'Taxonomy', 'option-tree' ) . ':</h4>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    68
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    69
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    70
      echo '</div>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    71
      
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    72
    echo '</div>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    73
    
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    74
  }
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    75
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    76
}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    77
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    78
/**
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    79
 * ot_get_option() option type.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    80
 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    81
 * This is a callback function to display text about ot_get_option().
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    82
 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    83
 * @return    string
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    84
 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    85
 * @access    public
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    86
 * @since     2.0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    87
 */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    88
if ( ! function_exists( 'ot_type_option_types' ) ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    89
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    90
  function ot_type_option_types() {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    91
    
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    92
    /* format setting outer wrapper */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    93
    echo '<div class="format-setting type-textblock wide-desc">';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    94
      
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    95
      /* description */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    96
      echo '<div class="description">';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    97
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    98
        echo '<h4>'. __( 'Background', 'option-tree' ) . ':</h4>';    
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
    99
        echo '<p>' . __( 'The Background option type is for adding background styles to your theme either dynamically via the CSS option type below or manually with <code>ot_get_option()</code>. Background has filters that allow you to change the defaults. For example, you can filter on <code>ot_recognized_background_repeat</code>, <code>ot_recognized_background_attachment</code>, and <code>ot_recognized_background_position</code>. These filters allow you to fine tune the select lists for your specific CSS needs.', 'option-tree' ) . '</p>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   100
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   101
        echo '<h4>'. __( 'Category Select', 'option-tree' ) . ':</h4>';    
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   102
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   103
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   104
        echo '<h4>'. __( 'Category Checkbox', 'option-tree' ) . ':</h4>';      
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   105
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   106
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   107
        echo '<h4>'. __( 'Checkbox', 'option-tree' ) . ':</h4>';       
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   108
        echo '<p>' . __( 'The Checkbox option type is fairly self explanatory. Typically used to ask questions. For example, "Do you want to activate asynchronous Google analytics?" would be a single checkbox with a value of yes. You could have more complex usages but the idea is that you can easily grab the value of the checkbox and use it in you theme. In this situation you would test if the checkbox has a value and execute a block of code if it does and do nothing if it doesn\'t.', 'option-tree' ) . '</p>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   109
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   110
        echo '<h4>'. __( 'Colorpicker', 'option-tree' ) . ':</h4>'; 
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   111
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   112
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   113
        echo '<h4>'. __( 'CSS', 'option-tree' ) . ':</h4>'; 
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   114
        echo '<p>' . __( '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 <code>dynamic.css</code> at the root level of your theme and change permissions using chmod so the server can write to the file. I have had the most success setting this single file to 0777 but feel free to play around with permissions until everything is working. A good starting point is 0666. When the server can save to the file CSS will automatically be updated each time you save your theme options.', 'option-tree' ) . '</p>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   115
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   116
        echo '<p class="aside">' . __( 'An example of the CSS option type: This assumes you have an option with the ID of <code>custom_background_css</code> which will display the saved values for that option.', 'option-tree' ) . '</p>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   117
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   118
        echo '<p>'. __( 'Input', 'option-tree' ) . ':</p>'; 
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   119
        echo '<pre><code>body {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   120
  {{custom_background_css}}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   121
  background-color: {{custom_background_css|background-color}};
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   122
}</code></pre>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   123
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   124
        echo '<p>'. __( 'Output', 'option-tree' ) . ':</p>'; 
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   125
        echo '<pre><code>/* BEGIN custom_background_css */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   126
body {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   127
  background: color image repeat attachment position;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   128
  background-color: color;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   129
}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   130
/* END custom_background_css */</code></pre>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   131
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   132
        echo '<h4>'. __( 'Custom Post Type Select', 'option-tree' ) . ':</h4>'; 
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   133
        echo '<p>' . __( '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 <code>post_type</code> when created in the settings. For some reason <code>any</code> does not work correctly and will looked into in future version.', 'option-tree' ) . '</p>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   134
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   135
        echo '<h4>'. __( 'Custom Post Type Checkbox', 'option-tree' ) . ':</h4>'; 
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   136
        echo '<p>' . __( '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 <code>post_type</code> when created in the settings. For some reason <code>any</code> does not work correctly and will looked into in future version.', 'option-tree' ) . '</p>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   137
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   138
        echo '<h4>'. __( 'List Item', 'option-tree' ) . ':</h4>'; 
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   139
        echo '<p>' . __( 'The list Item replaced the old Slider option type. It 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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   140
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   141
        echo '<h4>'. __( 'Measurement', 'option-tree' ) . ':</h4>'; 
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   142
        echo '<p>' . __( '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 <code>px</code>, <code>%</code>, <code>em</code>, <code>pt</code>. However, you can change them with the <code>ot_measurement_unit_types</code> filter.', 'option-tree' ) . '</p>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   143
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   144
        echo '<p>' . __( 'Example filter to add new units to the Measurement option type. Added to <code>functions.php</code>.', 'option-tree' ) . '</p>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   145
        echo '<pre><code>function filter_measurement_unit_types( $array, $field_id ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   146
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   147
  /* only run the filter on measurement with a field ID of my_measurement */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   148
  if ( $field_id == \'my_measurement\' ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   149
    $array[\'in\'] = \'inches\';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   150
    $array[\'ft\'] = \'feet\';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   151
  }
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   152
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   153
  return $array;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   154
}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   155
add_filter( \'ot_measurement_unit_types\', \'filter_measurement_unit_types\', 10, 2 );</code></pre>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   156
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   157
        echo '<p>' . __( 'Example filter to completely change the units in the Measurement option type. Added to <code>functions.php</code>.', 'option-tree' ) . '</p>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   158
        echo '<pre><code>function filter_measurement_unit_types( $array, $field_id ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   159
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   160
  /* only run the filter on measurement with a field ID of my_measurement */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   161
  if ( $field_id == \'my_measurement\' ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   162
    $array = array(
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   163
      \'in\' => \'inches\',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   164
      \'ft\' => \'feet\'
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   165
    );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   166
  }
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   167
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   168
  return $array;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   169
}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   170
add_filter( \'ot_measurement_unit_types\', \'filter_measurement_unit_types\', 10, 2 );</code></pre>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   171
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   172
        echo '<h4>'. __( 'Page Select', 'option-tree' ) . ':</h4>'; 
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   173
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   174
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   175
        echo '<h4>'. __( 'Page Checkbox', 'option-tree' ) . ':</h4>'; 
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   176
        echo '<p>' . __( 'The Page Select 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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   177
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   178
        echo '<h4>'. __( 'Post Select', 'option-tree' ) . ':</h4>'; 
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   179
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   180
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   181
        echo '<h4>'. __( 'Post Checkbox', 'option-tree' ) . ':</h4>'; 
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   182
        echo '<p>' . __( 'The Post Select 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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   183
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   184
        echo '<h4>'. __( 'Radio', 'option-tree' ) . ':</h4>'; 
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   185
        echo '<p>' . __( 'The Radio option type could ask a question. For example, "Do you want to activate the custom navigation?" could require a yes or no answer with a radio option. In this situation you would test if the radio has a value of \'yes\' and execute a block of code, or if it\'s \'no\' execute a different block of code.', 'option-tree' ) . '</p>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   186
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   187
        echo '<h4>'. __( 'Radio Image', 'option-tree' ) . ':</h4>'; 
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   188
        echo '<p>' . __( 'the Radio Images option type is primarily used for layouts. However, you can filter the image list using <code>ot_radio_images</code>. As well, you can add your own custom images using the choices array.', 'option-tree' ) . '</p>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   189
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   190
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   191
        echo '<pre><code>function filter_radio_images( $array, $field_id ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   192
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   193
  /* only run the filter where the field ID is my_radio_images */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   194
  if ( $field_id == \'my_radio_images\' ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   195
    $array = array(
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   196
      array(
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   197
        \'value\'   => \'left-sidebar\',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   198
        \'label\'   => __( \'Left Sidebar\', \'option-tree\' ),
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   199
        \'src\'     => OT_URL . \'/assets/images/layout/left-sidebar.png\'
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   200
      ),
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   201
      array(
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   202
        \'value\'   => \'right-sidebar\',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   203
        \'label\'   => __( \'Right Sidebar\', \'option-tree\' ),
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   204
        \'src\'     => OT_URL . \'/assets/images/layout/right-sidebar.png\'
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   205
      )
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   206
    );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   207
  }
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   208
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   209
  return $array;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   210
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   211
}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   212
add_filter( \'ot_radio_images\', \'filter_radio_images\', 10, 2 );</code></pre>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   213
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   214
        echo '<h4>'. __( 'Select', 'option-tree' ) . ':</h4>'; 
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   215
        echo '<p>' . __( 'The Select option type is used to list anything you want that would be chosen from a select list.', 'option-tree' ) . '</p>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   216
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   217
        echo '<h4>'. __( 'Slider', 'option-tree' ) . ':</h4>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   218
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   219
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   220
        echo '<h4>'. __( 'Tag Checkbox', 'option-tree' ) . ':</h4>';      
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   221
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   222
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   223
        echo '<h4>'. __( 'Tag Select', 'option-tree' ) . ':</h4>';    
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   224
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   225
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   226
        echo '<h4>'. __( 'Taxonomy Checkbox', 'option-tree' ) . ':</h4>';      
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   227
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   228
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   229
        echo '<h4>'. __( 'Taxonomy Select', 'option-tree' ) . ':</h4>';    
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   230
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   231
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   232
        echo '<h4>'. __( 'Text (Input)', 'option-tree' ) . ':</h4>'; 
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   233
        echo '<p>' . __( 'The Text option type would be used to save a string value. For example, a link to feedburner, your Twitter username, or Google Analytics ID are all good candidates. Any optional or required text that is of reasonably short character length.', 'option-tree' ) . '</p>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   234
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   235
        echo '<h4>'. __( 'Textarea', 'option-tree' ) . ':</h4>'; 
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   236
        echo '<p>' . __( 'The Textarea option type is a large string value used for custom code or text in the theme. The new Textarea has a WYSIWYG editor that can be filtered to change the buttons shown. For example, you can filter on <code>wpautop</code>, <code>media_buttons</code>, <code>tinymce</code>, and <code>quicktags</code>.', 'option-tree' ) . '</p>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   237
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   238
        echo '<p class="aside">' . __( 'Example filters to alter the Textarea option type. Added to <code>functions.php</code>.', 'option-tree' ) . '</p>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   239
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   240
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   241
        echo '<pre><code>function filter_textarea_wpautop( $content, $field_id ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   242
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   243
  /* only run the filter on the textarea with a field ID of my_textarea */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   244
  if ( $field_id == \'my_textarea\' ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   245
    return false;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   246
  }
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   247
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   248
  return $content;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   249
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   250
}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   251
add_filter( \'ot_wpautop\', \'filter_textarea_wpautop\', 10, 1 );</code></pre>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   252
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   253
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   254
        echo '<pre><code>function filter_textarea_media_buttons( $content, $field_id ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   255
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   256
  /* only run the filter on the textarea with a field ID of my_textarea */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   257
  if ( $field_id == \'my_textarea\' ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   258
    return false;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   259
  }
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   260
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   261
  return $content;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   262
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   263
}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   264
add_filter( \'ot_media_buttons\', \'filter_textarea_media_buttons\', 10, 2 );</code></pre>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   265
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   266
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   267
        echo '<pre><code>function filter_textarea_tinymce( $content, $field_id ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   268
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   269
  /* only run the filter on the textarea with a field ID of my_textarea */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   270
  if ( $field_id == \'my_textarea\' ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   271
    return false;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   272
  }
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   273
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   274
  return $content;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   275
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   276
}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   277
add_filter( \'ot_tinymce\', \'filter_textarea_tinymce\', 10, 2 );</code></pre>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   278
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   279
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   280
        echo '<pre><code>function filter_textarea_quicktags( $content, $field_id ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   281
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   282
  /* only run the filter on the textarea with a field ID of my_textarea */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   283
  if ( $field_id == \'my_textarea\' ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   284
    return array( \'buttons\' => \'strong,em,link,block,del,ins,img,ul,ol,li,code,more,spell,close,fullscreen\' );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   285
  } else if ( $field_id == \'my_other_textarea\' ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   286
    return false; /* show no quicktags */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   287
  }
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   288
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   289
  return $content;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   290
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   291
}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   292
add_filter( \'ot_quicktags\', \'filter_textarea_quicktags\', 10, 1 );</code></pre>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   293
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   294
        echo '<h4>'. __( 'Textarea Simple', 'option-tree' ) . ':</h4>'; 
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   295
        echo '<p>' . __( 'The Textarea Simple option type is a large string value used for custom code or text in the theme. The new Textarea Simple does not have a WYSIWYG editor. But you can still filter on <code>wpautop</code>.', 'option-tree' ) . '</p>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   296
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   297
        echo '<p class="aside">' . __( 'This example tells WordPress to execute the <code>wpautop</code> filter on the line breaks. The default is <code>false</code> which means it does not wraps line breaks with an HTML <code>p</code> tag. Added to <code>functions.php</code>.', 'option-tree' ) . '</p>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   298
        echo '<pre><code>function filter_textarea_simple_wpautop( $content, $field_id ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   299
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   300
  /* only run the filter on the textarea with a field ID of my_textarea */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   301
  if ( $field_id == \'my_textarea\' ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   302
    return true;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   303
  }
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   304
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   305
  return $content;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   306
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   307
}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   308
add_filter( \'ot_wpautop\', \'filter_textarea_simple_wpautop\', 10, 2 );</code></pre>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   309
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   310
        echo '<h4>'. __( 'Textblock', 'option-tree' ) . ':</h4>'; 
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   311
        echo '<p>' . __( 'The Textblock option type is used only on the Theme Option page. It will allow you to create & display HTML on your Theme Options page 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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   312
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   313
        echo '<h4>'. __( 'Textblock Titled', 'option-tree' ) . ':</h4>'; 
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   314
        echo '<p>' . __( 'The Textblock Titled option type is used only on the Theme Option page. It will allow you to create & display HTML on your Theme Options page 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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   315
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   316
        echo '<h4>'. __( 'Typography', 'option-tree' ) . ':</h4>';    
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   317
        echo '<p>' . __( 'The Typography option type is for adding typographic styles to your theme either dynamically via the CSS option type below or manually with <code>ot_get_option()</code>. Typography has filters that allow you to change the defaults. For example, you can filter on <code>ot_recognized_font_styles</code>, <code>ot_recognized_font_weights</code>, <code>ot_recognized_font_variants</code>, and <code>ot_recognized_font_families</code>. These filters allow you to fine tune the select lists for your specific CSS needs. The most important one though is <code>ot_recognized_font_families</code> as you can add your Google Fonts to create custom font stacks.', 'option-tree' ) . '</p>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   318
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   319
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   320
        echo '<pre><code>function filter_ot_recognized_font_families( $array, $field_id ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   321
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   322
  /* only run the filter when the field ID is my_google_fonts_headings */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   323
  if ( $field_id == \'my_google_fonts_headings\' ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   324
    $array = array(
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   325
      \'sans-serif\'    => \'sans-serif\',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   326
      \'open-sans\'     => \'"Open Sans", sans-serif\',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   327
      \'droid-sans\'    => \'"Droid Sans", sans-serif\'
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   328
    );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   329
  }
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   330
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   331
  return $array;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   332
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   333
}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   334
add_filter( \'ot_recognized_font_families\', \'filter_ot_recognized_font_families\', 10, 2 );</code></pre>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   335
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   336
        echo '<h4>'. __( 'Upload', 'option-tree' ) . ':</h4>'; 
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   337
        echo '<p>' . __( 'The Upload option type is used to upload any WordPress supported media. After uploading, users are required to press the "Send to OptionTree" 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\'ll have to re-upload or FTP any media to your new server and change the URIs if necessary.', 'option-tree' ) . '</p>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   338
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   339
      echo '</div>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   340
      
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   341
    echo '</div>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   342
    
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   343
  }
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   344
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   345
}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   346
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   347
/**
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   348
 * ot_get_option() option type.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   349
 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   350
 * This is a callback function to display text about ot_get_option().
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   351
 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   352
 * @return    string
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   353
 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   354
 * @access    public
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   355
 * @since     2.0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   356
 */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   357
if ( ! function_exists( 'ot_type_ot_get_option' ) ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   358
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   359
  function ot_type_ot_get_option() {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   360
    
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   361
    /* format setting outer wrapper */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   362
    echo '<div class="format-setting type-textblock wide-desc">';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   363
      
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   364
      /* description */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   365
      echo '<div class="description">';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   366
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   367
        echo '<h4>'. __( 'Description', 'option-tree' ) . ':</h4>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   368
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   369
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   370
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   371
        echo '<h4>' . __( 'Usage', 'option-tree' ) . ':</h4>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   372
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   373
        echo '<p><code>&lt;?php ot_get_option( $option_id, $default ); ?&gt;</code></p>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   374
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   375
        echo '<h4>' . __( 'Parameters', 'option-tree' ) . ':</h4>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   376
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   377
        echo '<code>$option_id</code>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   378
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   379
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   380
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   381
        echo '<code>$default</code>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   382
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   383
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   384
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   385
      echo '</div>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   386
      
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   387
    echo '</div>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   388
    
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   389
  }
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   390
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   391
}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   392
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   393
/**
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   394
 * get_option_tree() option type.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   395
 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   396
 * This is a callback function to display text about get_option_tree().
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   397
 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   398
 * @return    string
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   399
 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   400
 * @access    public
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   401
 * @since     2.0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   402
 */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   403
if ( ! function_exists( 'ot_type_get_option_tree' ) ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   404
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   405
  function ot_type_get_option_tree() {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   406
    
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   407
    /* format setting outer wrapper */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   408
    echo '<div class="format-setting type-textblock wide-desc">';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   409
      
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   410
      /* description */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   411
      echo '<div class="description">';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   412
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   413
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   414
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   415
        echo '<p>' . __( 'Use', 'option-tree' ) . '<code>ot_get_option()</code>' . __( 'instead', 'option-tree' ) . '.</p>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   416
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   417
        echo '<h4>'. __( 'Description', 'option-tree' ) . ':</h4>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   418
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   419
        echo '<p>' . __( 'This function returns, or echos if asked, a value from the "option_tree" array of saved values.', 'option-tree' ) . '</p>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   420
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   421
        echo '<h4>' . __( 'Usage', 'option-tree' ) . ':</h4>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   422
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   423
        echo '<p><code>&lt;?php get_option_tree( $item_id, $options, $echo, $is_array, $offset ); ?&gt;</code></p>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   424
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   425
        echo '<h4>' . __( 'Parameters', 'option-tree' ) . ':</h4>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   426
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   427
        echo '<code>$item_id</code>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   428
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   429
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   430
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   431
        echo '<code>$options</code>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   432
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   433
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   434
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   435
        echo '<code>$echo</code>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   436
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   437
        echo '<p>(<em>' . __( 'boolean', 'option-tree' ) . '</em>) (<em>' . __( 'optional', 'option-tree' ) . '</em>) ' . __( 'Echo the output.', 'option-tree' ) . '<br />' . __( 'Default', 'option-tree' ) . ': FALSE</p>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   438
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   439
        echo '<code>$is_array</code>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   440
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   441
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   442
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   443
        echo '<code>$offset</code>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   444
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   445
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   446
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   447
      echo '</div>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   448
      
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   449
    echo '</div>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   450
    
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   451
  }
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   452
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   453
}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   454
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   455
/**
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   456
 * Examples option type.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   457
 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   458
 * @return    string
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   459
 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   460
 * @access    public
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   461
 * @since     2.0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   462
 */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   463
if ( ! function_exists( 'ot_type_examples' ) ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   464
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   465
  function ot_type_examples() {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   466
    
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   467
    /* format setting outer wrapper */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   468
    echo '<div class="format-setting type-textblock wide-desc">';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   469
      
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   470
      /* description */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   471
      echo '<div class="description">';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   472
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   473
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   474
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   475
        echo '<h4>' . __( 'String Examples', 'option-tree' ) . ':</h4>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   476
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   477
        echo '<p>' . __( 'Returns the value of <code>test_input</code>.', 'option-tree' ) . '</p>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   478
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   479
        echo '<pre><code>if ( function_exists( \'ot_get_option\' ) ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   480
  $test_input = ot_get_option( \'test_input\' );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   481
}</code></pre>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   482
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   483
        echo '<p>' . __( 'Returns the value of <code>test_input</code>, but also has a default value if it returns empty.', 'option-tree' ) . '</p>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   484
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   485
        echo '<pre><code>if ( function_exists( \'ot_get_option\' ) ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   486
  $test_input = ot_get_option( \'test_input\', \'default input value goes here.\' );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   487
}</code></pre>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   488
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   489
        echo '<h4>' . __( 'Array Examples', 'option-tree' ) . ':</h4>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   490
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   491
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   492
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   493
        echo '<pre><code>if ( function_exists( \'ot_get_option\' ) ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   494
  /* get an array of page id\'s */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   495
  $ids = ot_get_option( \'navigation_ids\', array() );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   496
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   497
  /* echo custom navigation using wp_list_pages() */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   498
  if ( ! empty( $ids ) )
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   499
    echo \'&lt;ul&gt;\';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   500
    wp_list_pages(
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   501
      array(
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   502
        \'include\'   => $ids,
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   503
        \'title_li\'  => \'\'
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   504
      )
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   505
    );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   506
    echo \'&lt;/ul&gt;\';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   507
  }
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   508
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   509
}</code></pre>';   
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   510
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   511
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   512
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   513
        echo '<pre><code>if ( function_exists( \'ot_get_option\' ) ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   514
  /* get the array */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   515
  $measurement = ot_get_option( \'measurement_option_type_id\' );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   516
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   517
  /* only echo values if they actually exist, else echo some default value */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   518
  if ( isset( measurement[0] ) && $measurement[1] ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   519
    echo $measurement[0].$measurement[1];
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   520
  } else {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   521
    echo \'10px\';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   522
  }
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   523
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   524
}</code></pre>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   525
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   526
        echo '<pre><code>if ( function_exists( \'ot_get_option\' ) ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   527
  /* get the array, and have a default just incase */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   528
  $measurement = ot_get_option( \'measurement_option_type_id\', array( \'10\', \'px\' ) );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   529
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   530
  /* implode array into a string value */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   531
  if ( ! empty( measurement ) ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   532
    echo implode( \'\', $measurement );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   533
  }
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   534
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   535
}</code></pre>';    
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   536
          
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   537
        echo '<p>' . __( 'This example displays a very basic slider loop.', 'option-tree' ) . '</p>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   538
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   539
        echo '<pre><code>if ( function_exists( \'ot_get_option\' ) ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   540
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   541
  /* get the slider array */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   542
  $slides = ot_get_option( \'my_slider\', array() );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   543
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   544
  if ( ! empty( $slides ) ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   545
    foreach( $slides as $slide ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   546
      echo \'
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   547
      &lt;li&gt;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   548
        &lt;a href="\' . $slide[\'link\'] . \'"&gt;&lt;img src="\' . $slide[\'image\'] . \'" alt="\' . $slide[\'title\'] . \'" /&gt;&lt;/a&gt;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   549
        &lt;div class="description">\' . $slide[\'description\'] . \'&lt;/div&gt;
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   550
      &lt;/li&gt;\';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   551
    }
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   552
  }
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   553
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   554
}</code></pre>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   555
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   556
      echo '</div>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   557
      
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   558
    echo '</div>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   559
    
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   560
  }
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   561
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   562
}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   563
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   564
/**
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   565
 * Layouts Overview option type.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   566
 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   567
 * @return    string
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   568
 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   569
 * @access    public
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   570
 * @since     2.0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   571
 */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   572
if ( ! function_exists( 'ot_type_layouts_overview' ) ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   573
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   574
  function ot_type_layouts_overview() {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   575
    
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   576
    /* format setting outer wrapper */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   577
    echo '<div class="format-setting type-textblock wide-desc">';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   578
      
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   579
      /* description */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   580
      echo '<div class="description">';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   581
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   582
        echo '<h4>'. __( 'It\'s Super Simple', 'option-tree' ) . '</h4>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   583
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   584
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   585
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   586
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   587
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   588
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   589
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   590
        echo '<h4>' . __( 'For Developers', 'option-tree' ) . ':</h4>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   591
        echo '<p>' . __( '', 'option-tree' ) . '</p>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   592
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   593
        echo '<h5>' . __( 'Creating a Layout', 'option-tree' ) . ':</h5>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   594
        echo '<ul class="docs-ul">';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   595
          echo '<li>'. __( 'Go to the <code>OptionTre->Settings->Layouts</code> tab.', 'option-tree' ) . '</li>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   596
          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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   597
          echo '<li>' . __( 'Adding a new layout is as easy as repeating the steps above.', 'option-tree' ) . '</li>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   598
        echo '</ul>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   599
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   600
        echo '<h5>' . __( 'Activating a Layout', 'option-tree' ) . ':</h5>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   601
        echo '<ul class="docs-ul">';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   602
          echo '<li>'. __( 'Go to the <code>OptionTre->Settings->Layouts</code> tab.', 'option-tree' ) . '</li>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   603
          echo '<li>' . __( 'Click on the activate layout button in the actions list.', 'option-tree' ) . '</li>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   604
        echo '</ul>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   605
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   606
        echo '<h5>' . __( 'Deleting a Layout', 'option-tree' ) . ':</h5>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   607
        echo '<ul class="docs-ul">';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   608
          echo '<li>'. __( 'Go to the <code>OptionTre->Settings->Layouts</code> tab.', 'option-tree' ) . '</li>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   609
          echo '<li>' . __( 'Click on the delete layout button in the actions list.', 'option-tree' ) . '</li>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   610
        echo '</ul>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   611
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   612
        echo '<h5>' . __( 'Edit Layout Data', 'option-tree' ) . ':</h5>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   613
        echo '<ul class="docs-ul">';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   614
          echo '<li>'. __( 'Go to the <code>Appearance->Theme Options</code> page.', 'option-tree' ) . '</li>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   615
          echo '<li>' . __( 'Modify and save your theme options and the layout will be updated automatically.', 'option-tree' ) . '</li>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   616
          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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   617
          echo '<li>' . __( 'If you want to edit a new layout, first create it then save your theme options.', 'option-tree' ) . '</li>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   618
        echo '</ul>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   619
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   620
        echo '<h4>' . __( 'End-Users Mode', 'option-tree' ) . ':</h4>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   621
        echo '<p>' . __( '', 'option-tree' ) . '</p>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   622
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   623
        echo '<h5>' . __( 'Creating a Layout', 'option-tree' ) . ':</h5>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   624
        echo '<ul class="docs-ul">';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   625
          echo '<li>'. __( 'Go to the <code>Appearance->Theme Options</code> page.', 'option-tree' ) . '</li>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   626
          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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   627
          echo '<li>' . __( 'Adding a new layout is as easy as repeating the steps above.', 'option-tree' ) . '</li>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   628
        echo '</ul>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   629
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   630
        echo '<h5>' . __( 'Activating a Layout', 'option-tree' ) . ':</h5>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   631
        echo '<ul class="docs-ul">';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   632
          echo '<li>'. __( 'Go to the <code>Appearance->Theme Options</code> page.', 'option-tree' ) . '</li>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   633
          echo '<li>' . __( 'Choose a layout from the select list and click the "Activate Layout" button.', 'option-tree' ) . '</li>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   634
        echo '</ul>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   635
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   636
        echo '<h5>' . __( 'Deleting a Layout', 'option-tree' ) . ':</h5>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   637
        echo '<ul class="docs-ul">';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   638
          echo '<li>'. __( 'End-Users mode does not allow deleting layouts.', 'option-tree' ) . '</li>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   639
        echo '</ul>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   640
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   641
        echo '<h5>' . __( 'Edit Layout Data', 'option-tree' ) . ':</h5>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   642
        echo '<ul class="docs-ul">';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   643
          echo '<li>'. __( 'Go to the <code>Appearance->Theme Options</code> tab.', 'option-tree' ) . '</li>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   644
          echo '<li>' . __( 'Modify and save your theme options and the layout will be updated automatically.', 'option-tree' ) . '</li>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   645
          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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   646
        echo '</ul>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   647
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   648
      echo '</div>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   649
      
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   650
    echo '</div>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   651
    
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   652
  }
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   653
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   654
}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   655
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   656
/**
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   657
 * Meta Boxes option type.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   658
 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   659
 * @return    string
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   660
 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   661
 * @access    public
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   662
 * @since     2.0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   663
 */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   664
if ( ! function_exists( 'ot_type_meta_boxes' ) ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   665
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   666
  function ot_type_meta_boxes() {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   667
    
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   668
    /* format setting outer wrapper */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   669
    echo '<div class="format-setting type-textblock wide-desc">';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   670
      
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   671
      /* description */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   672
      echo '<div class="description">';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   673
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   674
        echo '<h4>'. __( 'How-to-guide', 'option-tree' ) . '</h4>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   675
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   676
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   677
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   678
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   679
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   680
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   681
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   682
        echo '<h5>' . __( 'Create and include your custom meta boxes file.', 'option-tree' ) . '</h5>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   683
        echo '<ul class="docs-ul">';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   684
          echo '<li>'. __( 'Create a file and name it anything you want, maybe <code>meta-boxes.php</code>.', 'option-tree' ) . '</li>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   685
          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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   686
          echo '<li>' . __( 'Add the following code to your <code>functions.php</code>.', 'option-tree' ) . '</li>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   687
        echo '</ul>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   688
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   689
        echo '<pre><code>/**
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   690
 * Meta Boxes
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   691
 */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   692
include_once( \'includes/meta-boxes.php\' );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   693
</code></pre>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   694
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   695
        echo '<ul class="docs-ul">';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   696
          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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   697
        echo '</ul>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   698
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   699
        echo "<pre><code>/**
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   700
 * Initialize the meta boxes. 
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   701
 */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   702
add_action( 'admin_init', 'custom_meta_boxes' );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   703
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   704
function custom_meta_boxes() {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   705
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   706
  &#36;my_meta_box = array(
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   707
    'id'        => 'my_meta_box',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   708
    'title'     => 'My Meta Box',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   709
    'desc'      => '',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   710
    'pages'     => array( 'post' ),
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   711
    'context'   => 'normal',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   712
    'priority'  => 'high',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   713
    'fields'    => array(
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   714
      array(
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   715
        'id'          => 'background',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   716
        'label'       => 'Background',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   717
        'desc'        => '',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   718
        'std'         => '',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   719
        'type'        => 'background',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   720
        'class'       => '',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   721
        'choices'     => array()
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   722
      )
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   723
    )
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   724
  );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   725
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   726
  ot_register_meta_box( &#36;my_meta_box );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   727
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   728
}</code></pre>";  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   729
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   730
      echo '</div>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   731
      
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   732
    echo '</div>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   733
    
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   734
  }
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   735
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   736
}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   737
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   738
/**
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   739
 * Theme Mode option type.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   740
 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   741
 * @return    string
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   742
 *
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   743
 * @access    public
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   744
 * @since     2.0
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   745
 */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   746
if ( ! function_exists( 'ot_type_theme_mode' ) ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   747
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   748
  function ot_type_theme_mode() {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   749
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   750
    /* format setting outer wrapper */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   751
    echo '<div class="format-setting type-textblock wide-desc">';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   752
      
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   753
      /* description */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   754
      echo '<div class="description">';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   755
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   756
        echo '<h4>'. __( 'How-to-guide', 'option-tree' ) . '</h4>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   757
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   758
        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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   759
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   760
        echo '<h5>' . __( 'Step 1: Include the plugin & turn on theme mode.', 'option-tree' ) . '</h5>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   761
        echo '<ul class="docs-ul">';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   762
          echo '<li>'. __( 'Download the latest version of <a href="http://wordpress.org/extend/plugins/option-tree/" rel="nofollow" target="_blank">OptionTree</a>.', 'option-tree' ) . '</li>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   763
          echo '<li>' . __( 'Unpack the ZIP archive.', 'option-tree' ) . '</li>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   764
          echo '<li>' . __( 'Put the <code>option-tree</code> directory in the root of your theme. For example, the server path would be <code>/wp-content/themes/theme-name/option-tree/</code>.', 'option-tree' ) . '</li>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   765
          echo '<li>' . __( 'Add the following code to the beginning of your <code>functions.php</code>.', 'option-tree' ) . '</li>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   766
        echo '</ul>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   767
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   768
        echo '<pre><code>/**
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   769
 * Optional: set \'ot_show_pages\' filter to false.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   770
 * This will hide the settings & documentation pages.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   771
 */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   772
add_filter( \'ot_show_pages\', \'__return_false\' );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   773
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   774
/**
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   775
 * Optional: set \'ot_show_new_layout\' filter to false.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   776
 * This will hide the "New Layout" section on the Theme Options page.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   777
 */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   778
add_filter( \'ot_show_new_layout\', \'__return_false\' );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   779
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   780
/**
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   781
 * Required: set \'ot_theme_mode\' filter to true.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   782
 */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   783
add_filter( \'ot_theme_mode\', \'__return_true\' );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   784
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   785
/**
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   786
 * Required: include OptionTree.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   787
 */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   788
include_once( \'option-tree/ot-loader.php\' );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   789
</code></pre>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   790
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   791
        echo '<p class="aside">' . __( 'It\'s that simple! You now have OptionTree built into your theme and anytime there\'s an update to the plugin you just replace the old version and you\'re good to go..', 'option-tree' ) . '</p>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   792
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   793
        echo '<h5>' . __( 'Step 2: Create Theme Options without using the UI Builder.', 'option-tree' ) . '</h5>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   794
        echo '<ul class="docs-ul">';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   795
          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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   796
          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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   797
          echo '<li>' . __( 'Add the following code to your <code>functions.php</code>.', 'option-tree' ) . '</li>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   798
        echo '</ul>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   799
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   800
        echo '<pre><code>/**
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   801
 * Theme Options
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   802
 */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   803
include_once( \'includes/theme-options.php\' );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   804
</code></pre>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   805
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   806
        echo '<ul class="docs-ul">';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   807
          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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   808
        echo '</ul>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   809
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   810
        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 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>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   811
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   812
        echo "<pre><code>/**
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   813
 * Initialize the options before anything else. 
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   814
 */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   815
add_action( 'admin_init', 'custom_theme_options', 1 );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   816
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   817
/**
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   818
 * Build the custom settings & update OptionTree.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   819
 */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   820
function custom_theme_options() {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   821
  /**
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   822
   * Get a copy of the saved settings array. 
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   823
   */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   824
  &#36;saved_settings = get_option( 'option_tree_settings', array() );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   825
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   826
  /**
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   827
   * Custom settings array that will eventually be 
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   828
   * passes to the OptionTree Settings API Class.
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   829
   */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   830
  &#36;custom_settings = array(
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   831
    'contextual_help' => array(
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   832
      'content'       => array( 
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   833
        array(
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   834
          'id'        => 'general_help',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   835
          'title'     => 'General',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   836
          'content'   => '&lt;p&gt;Help content goes here!&lt;/p&gt;'
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   837
        )
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   838
      ),
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   839
      'sidebar'       => '&lt;p&gt;Sidebar content goes here!&lt;/p&gt;',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   840
    ),
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   841
    'sections'        => array(
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   842
      array(
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   843
        'id'          => 'general',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   844
        'title'       => 'General'
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   845
      )
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   846
    ),
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   847
    'settings'        => array(
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   848
      array(
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   849
        'id'          => 'my_checkbox',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   850
        'label'       => 'Checkbox',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   851
        'desc'        => '',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   852
        'std'         => '',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   853
        'type'        => 'checkbox',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   854
        'section'     => 'general',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   855
        'class'       => '',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   856
        'choices'     => array(
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   857
          array( 
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   858
            'value' => 'yes',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   859
            'label' => 'Yes' 
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   860
          )
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   861
        )
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   862
      ),
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   863
      array(
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   864
        'id'          => 'my_layout',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   865
        'label'       => 'Layout',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   866
        'desc'        => 'Choose a layout for your theme',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   867
        'std'         => 'right-sidebar',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   868
        'type'        => 'radio-image',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   869
        'section'     => 'general',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   870
        'class'       => '',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   871
        'choices'     => array(
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   872
          array(
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   873
            'value'   => 'left-sidebar',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   874
            'label'   => 'Left Sidebar',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   875
            'src'     => OT_URL . '/assets/images/layout/left-sidebar.png'
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   876
          ),
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   877
          array(
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   878
            'value'   => 'right-sidebar',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   879
            'label'   => 'Right Sidebar',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   880
            'src'     => OT_URL . '/assets/images/layout/right-sidebar.png'
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   881
          ),
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   882
          array(
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   883
            'value'   => 'full-width',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   884
            'label'   => 'Full Width (no sidebar)',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   885
            'src'     => OT_URL . '/assets/images/layout/full-width.png'
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   886
          ),
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   887
          array(
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   888
            'value'   => 'dual-sidebar',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   889
            'label'   => __( 'Dual Sidebar', 'option-tree' ),
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   890
            'src'     => OT_URL . '/assets/images/layout/dual-sidebar.png'
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   891
          ),
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   892
          array(
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   893
            'value'   => 'left-dual-sidebar',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   894
            'label'   => __( 'Left Dual Sidebar', 'option-tree' ),
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   895
            'src'     => OT_URL . '/assets/images/layout/left-dual-sidebar.png'
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   896
          ),
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   897
          array(
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   898
            'value'   => 'right-dual-sidebar',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   899
            'label'   => __( 'Right Dual Sidebar', 'option-tree' ),
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   900
            'src'     => OT_URL . '/assets/images/layout/right-dual-sidebar.png'
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   901
          )
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   902
        )
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   903
      ),
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   904
      array(
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   905
        'id'          => 'my_slider',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   906
        'label'       => 'Images',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   907
        'desc'        => '',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   908
        'std'         => '',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   909
        'type'        => 'list-item',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   910
        'section'     => 'general',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   911
        'class'       => '',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   912
        'choices'     => array(),
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   913
        'settings'    => array(
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   914
          array(
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   915
            'id'      => 'slider_image',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   916
            'label'   => 'Image',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   917
            'desc'    => '',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   918
            'std'     => '',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   919
            'type'    => 'upload',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   920
            'class'   => '',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   921
            'choices' => array()
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   922
          ),
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   923
          array(
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   924
            'id'      => 'slider_link',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   925
            'label'   => 'Link to Post',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   926
            'desc'    => 'Enter the posts url.',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   927
            'std'     => '',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   928
            'type'    => 'text',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   929
            'class'   => '',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   930
            'choices' => array()
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   931
          ),
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   932
          array(
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   933
            'id'      => 'slider_description',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   934
            'label'   => 'Description',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   935
            'desc'    => 'This text is used to add fancy captions in the slider.',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   936
            'std'     => '',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   937
            'type'    => 'textarea',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   938
            'class'   => '',
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   939
            'choices' => array()
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   940
          )
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   941
        )
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   942
      )
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   943
    )
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   944
  );
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   945
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   946
  /* settings are not the same update the DB */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   947
  if ( &#36;saved_settings !== &#36;custom_settings ) {
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   948
    update_option( 'option_tree_settings', &#36;custom_settings ); 
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   949
  }
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   950
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   951
}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   952
</code></pre>";
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   953
        
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   954
      echo '</div>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   955
      
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   956
    echo '</div>';
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   957
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   958
  }
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   959
  
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   960
}
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   961
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   962
/* End of file ot-functions-docs-page.php */
d970ebf37754 first import
ymh <ymh.work@gmail.com>
parents:
diff changeset
   963
/* Location: ./includes/ot-functions-docs-page.php */