Added {index} and {total_items} variables to options fieldtypes

Author: intoeetive

docs/fieldtypes/checkboxes.md

@@ -49,7 +49,7 @@ You can use a single variable for Checkboxes to render a comma-separated list of
 
 ### Variable Pair
 
-Using a variable pair, allows for customization of the output.
+Using a variable pair of field name, allows for customization of the output.
 
     {field_name}
         {item}<br>
@@ -63,7 +63,20 @@ Two
 Three
 ```
 
-By default, `{item}` will render the item's label To access the value and label separately, simply add a `:value` or `:label` modifier to the `{item}` variable:
+The following variables are available inside field's tags pair:
+
+| Variable        | Description                                         |
+| --------------- | --------------------------------------------------- |
+| `{item}`        | Label of selected item                              |
+| `{item:label}`  | Label of selected item                              |
+| `{item:value}`  | Value of selected item                              |
+| `{count}`       | Counter for each of selected items, starting with 1 |
+| `{index}`       | Counter for each of selected items, starting with 0 |
+| `{total_items}` | Total number of selected items                      |
+
+By default, `{item}` will render the item's label.
+
+To access the value and label separately, simply add a `:value` or `:label` modifier to the `{item}` variable:
 
     {field_name}
         Label: {item}<br> {!-- 1 --}
@@ -90,15 +103,17 @@ TIP: **Tip:** It is recommended that you use the value in conditionals, as it ty
 
 TIP: **Tip:** Checkboxes, Multiselect and Selectable Buttons all default to showing the label. Radio Buttons and Selects default to showing the value. 
 
-### Limit Parameter
+### Parameters
+
+#### `limit`
 
 This parameter limits the number of selected items output by the tag. It works for both the single variable, as well as the tag pair.
 
 ```
 {field_name limit="2"} {!-- One,Two --}
 ```
 
-### Markup Parameter
+#### `markup`
 
 As a single tag, a checkbox will display a comma separated list of values. If you want an HTML list, you can use markup="ul" or markup="ol" to change the output to the equivalent html list
 
@@ -112,7 +127,7 @@ Which will render as
         <li>Orange</li>
     </ul>
 
-### Backspace Parameter
+#### `backspace`
 
 When used as a tag pair, checkboxes are a looping pair. Backspacing removes characters (including spaces and line breaks) from the last iteration of the loop. For example, if you put a `<br>` tag after each item you'll have this
 

docs/fieldtypes/multiselect.md

@@ -63,7 +63,21 @@ Two
 Three
 ```
 
-By default, `{item}` will render the item's label. To access the value and label separately, simply add a `:value` or `:label` modifier to the `{item}` variable:
+
+The following variables are available inside field's tags pair:
+
+| Variable        | Description                                         |
+| --------------- | --------------------------------------------------- |
+| `{item}`        | Label of selected item                              |
+| `{item:label}`  | Label of selected item                              |
+| `{item:value}`  | Value of selected item                              |
+| `{count}`       | Counter for each of selected items, starting with 1 |
+| `{index}`       | Counter for each of selected items, starting with 0 |
+| `{total_items}` | Total number of selected items                      |
+
+By default, `{item}` will render the item's label. 
+
+To access the value and label separately, simply add a `:value` or `:label` modifier to the `{item}` variable:
 
     {field_name}
         Label: {item}<br> {!-- One --}
@@ -90,15 +104,17 @@ TIP: **Tip:** It is recommended that you use the value in conditionals, as it ty
 
 TIP: **Tip:** Checkboxes, Multiselect and Selectable Buttons all default to showing the label. Radio Buttons and Selects default to showing the value. 
 
-### Limit Parameter
+### Parameters
+
+#### `limit`
 
 This parameter limits the number of selected items output by the tag. It works for both the single variable, as well as the tag pair.
 
 ```
 {field_name limit="2"} {!-- One,Two --}
 ```
 
-### Markup Parameter
+#### `markup`
 
 As a single tag, a multi select will display a comma separated list of values. If you want an HTML list, you can use markup="ul" or markup="ol" to change the output to the equivalent html list
 
@@ -112,7 +128,7 @@ Which will render as
         <li>Orange</li>
     </ul>
 
-### Backspace Parameter
+#### `backspace`
 
 When used as a tag pair, Multiselect are a looping pair. Backspacing removes characters (including spaces and line breaks) from the last iteration of the loop. For example, if you put a `<br>` tag after each item you'll have this
 

docs/fieldtypes/selectable-buttons.md

@@ -60,7 +60,21 @@ When allowing multiple items to be selected, Selectable Buttons will usually be
         {item}<br>
     {/field_name}
 
-By default, `{item}` will render the item's label. To access the value and label separately, simply add a `:value` or `:label` modifier to the `{item}` variable:
+
+The following variables are available inside field's tags pair:
+
+| Variable        | Description                                         |
+| --------------- | --------------------------------------------------- |
+| `{item}`        | Label of selected item                              |
+| `{item:label}`  | Label of selected item                              |
+| `{item:value}`  | Value of selected item                              |
+| `{count}`       | Counter for each of selected items, starting with 1 |
+| `{index}`       | Counter for each of selected items, starting with 0 |
+| `{total_items}` | Total number of selected items                      |
+
+By default, `{item}` will render the item's label. 
+
+To access the value and label separately, simply add a `:value` or `:label` modifier to the `{item}` variable:
 
     {field_name}
         Label: {item}<br>
@@ -98,11 +112,13 @@ TIP: **Tip:** Checkboxes, Multiselect and Selectable Buttons all default to show
 
 NOTE: **NOTE:** For Select fields used in [Custom Member Fields](control-panel/member-manager.md#custom-member-fields) and [Category Group Details Tab](control-panel/categories.md#details-tab), the modifiers are not currently available in conditionals, and _must_ be based on the value, e.g. `{if some_cat_field == 2}`
 
-### Limit Parameter
+### Parameters
+
+#### `limit`
 
 This parameter limits the number of selected items output by the tag. It works for both the single variable, as well as the tag pair.
 
-### Markup Parameter
+#### `markup`
 
 When allowing for multiple selections, a single tag will display a comma separated list of values. If you want an HTML list, you can use markup="ul" or markup="ol" to change the output to the equivalent html list
 
@@ -116,7 +132,7 @@ Which will render as
         <li>Orange</li>
     </ul>
 
-### Backspace Parameter
+#### `backspace`
 
 Backspacing removes characters (including spaces and line breaks) from the last iteration of the loop when using a variable pair. For example, if you put a `<br>` tag after each item you'll have this