ArrayField.php
68 lines
| 1 | <?php |
| 2 | |
| 3 | /** |
| 4 | * Matomo - free/libre analytics platform |
| 5 | * |
| 6 | * @link https://matomo.org |
| 7 | * @license https://www.gnu.org/licenses/gpl-3.0.html GPL v3 or later |
| 8 | */ |
| 9 | namespace Piwik\Settings\FieldConfig; |
| 10 | |
| 11 | /** |
| 12 | * Lets you configure a field for a field array. |
| 13 | * |
| 14 | * Usage: |
| 15 | * |
| 16 | * $field->uiControl = FieldConfig::UI_CONTROL_FIELD_ARRAY; |
| 17 | * $arrayField = new FieldConfig\ArrayField('Index', FieldConfig::UI_CONTROL_TEXT); |
| 18 | * $field->uiControlAttributes['field'] = $field->toArray(); |
| 19 | * |
| 20 | * @api |
| 21 | */ |
| 22 | class ArrayField |
| 23 | { |
| 24 | /** |
| 25 | * Describes what HTML element should be used to manipulate the setting through Piwik's UI. |
| 26 | * |
| 27 | * See {@link Piwik\Plugin\Settings} for a list of supported control types. |
| 28 | * |
| 29 | * @var string |
| 30 | */ |
| 31 | public $uiControl = null; |
| 32 | /** |
| 33 | * Array like ['plugin' => 'MyPlugin', 'component' => 'MyExportedCustomFieldComponent']. For an example see |
| 34 | * "plugins/CorePluginsAdmin/vue/src/FormField/FieldText.vue" |
| 35 | * |
| 36 | * @var string[] |
| 37 | */ |
| 38 | public $customFieldComponent = null; |
| 39 | /** |
| 40 | * This setting's display name, for example, `'Refresh Interval'`. |
| 41 | * |
| 42 | * Be sure to escape any user input as HTML can be used here. |
| 43 | * |
| 44 | * @var string |
| 45 | */ |
| 46 | public $title = ''; |
| 47 | /** |
| 48 | * The list of all available values for this setting. If null, the setting can have any value. |
| 49 | * |
| 50 | * If supplied, this field should be an array mapping available values with their prettified |
| 51 | * display value. Eg, if set to `array('nb_visits' => 'Visits', 'nb_actions' => 'Actions')`, |
| 52 | * the UI will display **Visits** and **Actions**, and when the user selects one, Piwik will |
| 53 | * set the setting to **nb_visits** or **nb_actions** respectively. |
| 54 | * |
| 55 | * @var null|array |
| 56 | */ |
| 57 | public $availableValues = null; |
| 58 | public function __construct($title, $uiControl = 'text') |
| 59 | { |
| 60 | $this->title = $title; |
| 61 | $this->uiControl = $uiControl; |
| 62 | } |
| 63 | public function toArray() |
| 64 | { |
| 65 | return array('title' => $this->title, 'uiControl' => $this->uiControl, 'component' => $this->customFieldComponent, 'availableValues' => $this->availableValues); |
| 66 | } |
| 67 | } |
| 68 |