1 | <?php |
||
14 | class GF_Form extends Form implements \ArrayAccess { |
||
|
|||
15 | |||
16 | /** |
||
17 | * @var string The identifier of the backend used for this form. |
||
18 | * @api |
||
19 | * @since 2.0 |
||
20 | */ |
||
21 | public static $backend = self::BACKEND_GRAVITYFORMS; |
||
22 | |||
23 | /** |
||
24 | * Initialization. |
||
25 | */ |
||
26 | 181 | private function __construct() { |
|
31 | |||
32 | /** |
||
33 | * Construct a \GV\GF_Form instance by ID. |
||
34 | * |
||
35 | * @param int|string $form_id The internal form ID. |
||
36 | * |
||
37 | * @api |
||
38 | * @since 2.0 |
||
39 | * @return \GV\GF_Form|null An instance of this form or null if not found. |
||
40 | */ |
||
41 | 182 | public static function by_id( $form_id ) { |
|
62 | |||
63 | /** |
||
64 | * Construct a \GV\Form instance from a Gravity Forms form array. |
||
65 | * |
||
66 | * @since 2.0.7 |
||
67 | * |
||
68 | * @param array $form The form array |
||
69 | * |
||
70 | * @return \GV\GF_Form|null An instance of this form or null if not found. |
||
71 | */ |
||
72 | public static function from_form( $form ) { |
||
83 | |||
84 | /** |
||
85 | * Get all entries for this form. |
||
86 | * |
||
87 | * @api |
||
88 | * @since 2.0 |
||
89 | * |
||
90 | * @return \GV\Entry_Collection The \GV\Entry_Collection |
||
91 | */ |
||
92 | public function get_entries() { |
||
93 | $entries = new \GV\Entry_Collection(); |
||
94 | |||
95 | $form = &$this; |
||
96 | |||
97 | /** Add the fetcher lazy callback. */ |
||
98 | $entries->add_fetch_callback( function( $filters, $sorts, $offset ) use ( $form ) { |
||
99 | $entries = new \GV\Entry_Collection(); |
||
100 | |||
101 | $search_criteria = array(); |
||
102 | $sorting = array(); |
||
103 | $paging = array(); |
||
104 | |||
105 | /** Apply the filters */ |
||
106 | foreach ( $filters as $filter ) { |
||
107 | $search_criteria = $filter::merge_search_criteria( $search_criteria, $filter->as_search_criteria() ); |
||
108 | } |
||
109 | |||
110 | /** Apply the sorts */ |
||
111 | foreach ( $sorts as $sort ) { |
||
112 | /** Gravity Forms does not have multi-sorting, so just overwrite. */ |
||
113 | $sorting = array( |
||
114 | 'key' => $sort->field->ID, |
||
115 | 'direction' => $sort->direction, |
||
116 | 'is_numeric' => $sort->mode == Entry_Sort::NUMERIC, |
||
117 | ); |
||
118 | } |
||
119 | |||
120 | /** The offset and limit */ |
||
121 | if ( ! empty( $offset->limit ) ) { |
||
122 | $paging['page_size'] = $offset->limit; |
||
123 | } |
||
124 | |||
125 | if ( ! empty( $offset->offset ) ) { |
||
126 | $paging['offset'] = $offset->offset; |
||
127 | } |
||
128 | |||
129 | foreach ( \GFAPI::get_entries( $form->ID, $search_criteria, $sorting, $paging ) as $entry ) { |
||
130 | $entries->add( \GV\GF_Entry::from_entry( $entry ) ); |
||
131 | } |
||
132 | |||
133 | return $entries; |
||
134 | } ); |
||
135 | |||
136 | /** Add the counter lazy callback. */ |
||
137 | $entries->add_count_callback( function( $filters ) use ( $form ) { |
||
138 | $search_criteria = array(); |
||
139 | $sorting = array(); |
||
140 | |||
141 | /** Apply the filters */ |
||
142 | /** @var \GV\GF_Entry_Filter|\GV\Entry_Filter $filter */ |
||
143 | foreach ( $filters as $filter ) { |
||
144 | $search_criteria = $filter::merge_search_criteria( $search_criteria, $filter->as_search_criteria() ); |
||
145 | } |
||
146 | |||
147 | return \GFAPI::count_entries( $form->ID, $search_criteria ); |
||
148 | } ); |
||
149 | |||
150 | return $entries; |
||
151 | } |
||
152 | |||
153 | /** |
||
154 | * Get a \GV\Field by Form and Field ID for this data source. |
||
155 | * |
||
156 | * @param \GV\GF_Form $form The Gravity Form form ID. |
||
157 | * @param int $field_id The Gravity Form field ID for the $form_id. |
||
158 | * |
||
159 | * @return \GV\Field|null The requested field or null if not found. |
||
160 | */ |
||
161 | 3 | public static function get_field( /** varargs */ ) { |
|
175 | |||
176 | /** |
||
177 | * Get an array of GV Fields for this data source |
||
178 | * |
||
179 | * @return \GV\Field[]|array Empty array if no fields |
||
180 | */ |
||
181 | public function get_fields() { |
||
195 | |||
196 | /** |
||
197 | * Proxies. |
||
198 | * |
||
199 | * @param string $key The property to get. |
||
200 | * |
||
201 | * @return mixed |
||
202 | */ |
||
203 | public function __get( $key ) { |
||
204 | switch ( $key ) { |
||
205 | case 'fields': |
||
206 | return $this->get_fields(); |
||
207 | default: |
||
208 | return parent::__get( $key ); |
||
209 | } |
||
210 | } |
||
211 | |||
212 | /** |
||
213 | * ArrayAccess compatibility layer with a Gravity Forms form array. |
||
214 | * |
||
215 | * @internal |
||
216 | * @deprecated |
||
217 | * @since 2.0 |
||
218 | * @return bool Whether the offset exists or not. |
||
219 | */ |
||
220 | 28 | public function offsetExists( $offset ) { |
|
223 | |||
224 | /** |
||
225 | * ArrayAccess compatibility layer with a Gravity Forms form array. |
||
226 | * |
||
227 | * Maps the old keys to the new data; |
||
228 | * |
||
229 | * @internal |
||
230 | * @deprecated |
||
231 | * @since 2.0 |
||
232 | * |
||
233 | * @return mixed The value of the requested form data. |
||
234 | */ |
||
235 | 21 | public function offsetGet( $offset ) { |
|
238 | |||
239 | /** |
||
240 | * ArrayAccess compatibility layer with a Gravity Forms form array. |
||
241 | * |
||
242 | * @internal |
||
243 | * @deprecated |
||
244 | * @since 2.0 |
||
245 | * |
||
246 | * @return void |
||
247 | */ |
||
248 | public function offsetSet( $offset, $value ) { |
||
251 | |||
252 | /** |
||
253 | * ArrayAccess compatibility layer with a Gravity Forms form array. |
||
254 | * |
||
255 | * @internal |
||
256 | * @deprecated |
||
257 | * @since 2.0 |
||
258 | * @return void |
||
259 | */ |
||
260 | public function offsetUnset( $offset ) { |
||
263 | } |
||
264 |