class-repeater.php
2.29 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
<?php
/**
* Repeater control.
*
* @package Block_Lab
* @copyright Copyright(c) 2020, Block Lab
* @license http://opensource.org/licenses/GPL-2.0 GNU General Public License, version 2 (GPL-2.0)
*/
namespace Block_Lab\Blocks\Controls;
/**
* Class Repeater
*/
class Repeater extends Control_Abstract {
/**
* Control name.
*
* @var string
*/
public $name = 'repeater';
/**
* Field variable type.
*
* The Repeater control is an array of objects, with each row being an object.
* For example, a repeater with one row might be [ { 'example-text': 'Foo', 'example-image': 4232 } ].
*
* @var string
*/
public $type = 'object';
/**
* Repeater constructor.
*/
public function __construct() {
parent::__construct();
$this->label = __( 'Repeater', 'block-lab' );
}
/**
* Register settings.
*
* @return void
*/
public function register_settings() {
$this->settings[] = new Control_Setting( $this->settings_config['help'] );
$this->settings[] = new Control_Setting(
[
'name' => 'min',
'label' => __( 'Minimum Rows', 'block-lab' ),
'type' => 'number_non_negative',
'sanitize' => [ $this, 'sanitize_number' ],
]
);
$this->settings[] = new Control_Setting(
[
'name' => 'max',
'label' => __( 'Maximum Rows', 'block-lab' ),
'type' => 'number_non_negative',
'sanitize' => [ $this, 'sanitize_number' ],
]
);
}
/**
* Remove empty placeholder rows.
*
* @param mixed $value The value to either make available as a variable or echoed on the front-end template.
* @param bool $echo Whether this will be echoed.
* @return mixed $value The value to be made available or echoed on the front-end template.
*/
public function validate( $value, $echo ) {
if ( isset( $value['rows'] ) ) {
foreach ( $value['rows'] as $key => $row ) {
unset( $value['rows'][ $key ][''] );
unset( $value['rows'][ $key ][0] );
}
}
if ( $echo && defined( 'WP_DEBUG' ) && WP_DEBUG ) {
$value = sprintf(
// translators: Placeholders are the opening and closing anchor tags of a link.
__( '⚠️ Please use Block Lab\'s %1$srepeater functions%2$s to display repeater fields in your template.', 'block-lab' ),
'<a href="https://getblocklab.com/docs/fields/repeater/">',
'</a>'
);
}
return $value;
}
}