|
1
|
|
|
<?php |
|
2
|
|
|
|
|
3
|
|
|
/** |
|
4
|
|
|
* Pods class. |
|
5
|
|
|
* |
|
6
|
|
|
* @package Pods |
|
7
|
|
|
*/ |
|
8
|
|
|
class Pods implements Iterator { |
|
9
|
|
|
|
|
10
|
|
|
/** |
|
11
|
|
|
* Whether the Pods object is in a PHP Iterator call. |
|
12
|
|
|
* |
|
13
|
|
|
* @var bool |
|
14
|
|
|
*/ |
|
15
|
|
|
private $iterator = false; |
|
16
|
|
|
|
|
17
|
|
|
/** |
|
18
|
|
|
* PodsAPI object. |
|
19
|
|
|
* |
|
20
|
|
|
* @var PodsAPI |
|
21
|
|
|
*/ |
|
22
|
|
|
public $api; |
|
23
|
|
|
|
|
24
|
|
|
/** |
|
25
|
|
|
* PodsData object. |
|
26
|
|
|
* |
|
27
|
|
|
* @var PodsData |
|
28
|
|
|
*/ |
|
29
|
|
|
public $data; |
|
30
|
|
|
|
|
31
|
|
|
/** |
|
32
|
|
|
* PodsData object for additional calls. |
|
33
|
|
|
* |
|
34
|
|
|
* @var PodsData |
|
35
|
|
|
*/ |
|
36
|
|
|
public $alt_data; |
|
37
|
|
|
|
|
38
|
|
|
/** |
|
39
|
|
|
* Array of pod item arrays. |
|
40
|
|
|
* |
|
41
|
|
|
* @var array |
|
42
|
|
|
*/ |
|
43
|
|
|
public $rows; |
|
44
|
|
|
|
|
45
|
|
|
/** |
|
46
|
|
|
* Current pod item array. |
|
47
|
|
|
* |
|
48
|
|
|
* @var array |
|
49
|
|
|
*/ |
|
50
|
|
|
public $row; |
|
51
|
|
|
|
|
52
|
|
|
/** |
|
53
|
|
|
* Row number. |
|
54
|
|
|
* |
|
55
|
|
|
* @var int |
|
56
|
|
|
*/ |
|
57
|
|
|
private $row_number; |
|
58
|
|
|
|
|
59
|
|
|
/** |
|
60
|
|
|
* Override pod item array. |
|
61
|
|
|
* |
|
62
|
|
|
* @var array |
|
63
|
|
|
*/ |
|
64
|
|
|
public $row_override = array(); |
|
65
|
|
|
|
|
66
|
|
|
/** |
|
67
|
|
|
* Whether to display errors on the screen. |
|
68
|
|
|
* |
|
69
|
|
|
* @var bool |
|
70
|
|
|
*/ |
|
71
|
|
|
public $display_errors = true; |
|
72
|
|
|
|
|
73
|
|
|
/** |
|
74
|
|
|
* Current pod information. |
|
75
|
|
|
* |
|
76
|
|
|
* @var array|bool|mixed|null|void |
|
77
|
|
|
*/ |
|
78
|
|
|
public $pod_data; |
|
79
|
|
|
|
|
80
|
|
|
/** |
|
81
|
|
|
* Last used Pods::find() parameters. |
|
82
|
|
|
* |
|
83
|
|
|
* @var array |
|
84
|
|
|
*/ |
|
85
|
|
|
public $params = array(); |
|
86
|
|
|
|
|
87
|
|
|
/** |
|
88
|
|
|
* Current Pod name. |
|
89
|
|
|
* |
|
90
|
|
|
* @var string |
|
91
|
|
|
*/ |
|
92
|
|
|
public $pod; |
|
93
|
|
|
|
|
94
|
|
|
/** |
|
95
|
|
|
* Current Pod ID. |
|
96
|
|
|
* |
|
97
|
|
|
* @var int |
|
98
|
|
|
*/ |
|
99
|
|
|
public $pod_id; |
|
100
|
|
|
|
|
101
|
|
|
/** |
|
102
|
|
|
* Pod fields information. |
|
103
|
|
|
* |
|
104
|
|
|
* @var array |
|
105
|
|
|
*/ |
|
106
|
|
|
public $fields; |
|
107
|
|
|
|
|
108
|
|
|
/** |
|
109
|
|
|
* Last used filters() parameters. |
|
110
|
|
|
* |
|
111
|
|
|
* @var array |
|
112
|
|
|
*/ |
|
113
|
|
|
public $filters = array(); |
|
114
|
|
|
|
|
115
|
|
|
/** |
|
116
|
|
|
* Detail page URL used for Advanced Content Types. |
|
117
|
|
|
* |
|
118
|
|
|
* @var string |
|
119
|
|
|
*/ |
|
120
|
|
|
public $detail_page; |
|
121
|
|
|
|
|
122
|
|
|
/** |
|
123
|
|
|
* Current Item ID. |
|
124
|
|
|
* |
|
125
|
|
|
* @var int |
|
126
|
|
|
*/ |
|
127
|
|
|
public $id; |
|
128
|
|
|
|
|
129
|
|
|
/** |
|
130
|
|
|
* Last used limit from find() lookup. |
|
131
|
|
|
* |
|
132
|
|
|
* @var int |
|
133
|
|
|
*/ |
|
134
|
|
|
public $limit = 15; |
|
135
|
|
|
|
|
136
|
|
|
/** |
|
137
|
|
|
* Last used offset from find() lookup. |
|
138
|
|
|
* |
|
139
|
|
|
* @var int |
|
140
|
|
|
*/ |
|
141
|
|
|
public $offset = 0; |
|
142
|
|
|
|
|
143
|
|
|
/** |
|
144
|
|
|
* Query variable used for pagination number. |
|
145
|
|
|
* |
|
146
|
|
|
* @var string |
|
147
|
|
|
*/ |
|
148
|
|
|
public $page_var = 'pg'; |
|
149
|
|
|
|
|
150
|
|
|
/** |
|
151
|
|
|
* Last used page from find() lookup. |
|
152
|
|
|
* |
|
153
|
|
|
* @var int|mixed |
|
154
|
|
|
*/ |
|
155
|
|
|
public $page = 1; |
|
156
|
|
|
|
|
157
|
|
|
/** |
|
158
|
|
|
* Last used state of whether pagination was enabled from find() lookup. |
|
159
|
|
|
* |
|
160
|
|
|
* @var bool |
|
161
|
|
|
*/ |
|
162
|
|
|
public $pagination = true; |
|
163
|
|
|
|
|
164
|
|
|
/** |
|
165
|
|
|
* Last used state of whether search was enabled from find() lookup. |
|
166
|
|
|
* |
|
167
|
|
|
* @var bool |
|
168
|
|
|
*/ |
|
169
|
|
|
public $search = true; |
|
170
|
|
|
|
|
171
|
|
|
/** |
|
172
|
|
|
* Query variable used for search string. |
|
173
|
|
|
* |
|
174
|
|
|
* @var string |
|
175
|
|
|
*/ |
|
176
|
|
|
public $search_var = 'search'; |
|
177
|
|
|
|
|
178
|
|
|
/** |
|
179
|
|
|
* Search mode (int | text | text_like). |
|
180
|
|
|
* |
|
181
|
|
|
* @var string |
|
182
|
|
|
*/ |
|
183
|
|
|
public $search_mode = 'int'; |
|
184
|
|
|
|
|
185
|
|
|
/** |
|
186
|
|
|
* Total number of records returned from find() lookup. |
|
187
|
|
|
* |
|
188
|
|
|
* @var int |
|
189
|
|
|
*/ |
|
190
|
|
|
public $total = 0; |
|
191
|
|
|
|
|
192
|
|
|
/** |
|
193
|
|
|
* Total number of records found from find() lookup. |
|
194
|
|
|
* |
|
195
|
|
|
* @var int |
|
196
|
|
|
*/ |
|
197
|
|
|
public $total_found = 0; |
|
198
|
|
|
|
|
199
|
|
|
/** |
|
200
|
|
|
* Last used ui options for ui() call. |
|
201
|
|
|
* |
|
202
|
|
|
* @var array |
|
203
|
|
|
*/ |
|
204
|
|
|
public $ui = array(); |
|
|
|
|
|
|
205
|
|
|
|
|
206
|
|
|
/** |
|
207
|
|
|
* Page template to use for SEO feature in Pods Pages. |
|
208
|
|
|
* |
|
209
|
|
|
* @var string |
|
210
|
|
|
*/ |
|
211
|
|
|
public $page_template; |
|
212
|
|
|
|
|
213
|
|
|
/** |
|
214
|
|
|
* Body classes to use for SEO feature in Pods Pages. |
|
215
|
|
|
* |
|
216
|
|
|
* @var array |
|
217
|
|
|
*/ |
|
218
|
|
|
public $body_classes; |
|
219
|
|
|
|
|
220
|
|
|
/** |
|
221
|
|
|
* Meta tags to use for SEO feature in Pods Pages. |
|
222
|
|
|
* |
|
223
|
|
|
* @var array |
|
224
|
|
|
*/ |
|
225
|
|
|
public $meta = array(); |
|
226
|
|
|
|
|
227
|
|
|
/** |
|
228
|
|
|
* Meta properties to use for SEO feature in Pods Pages. |
|
229
|
|
|
* |
|
230
|
|
|
* @var array |
|
231
|
|
|
*/ |
|
232
|
|
|
public $meta_properties = array(); |
|
233
|
|
|
|
|
234
|
|
|
/** |
|
235
|
|
|
* Meta custom HTML to use for SEO feature in Pods Pages. |
|
236
|
|
|
* |
|
237
|
|
|
* @var string |
|
238
|
|
|
*/ |
|
239
|
|
|
public $meta_extra = ''; |
|
240
|
|
|
|
|
241
|
|
|
/** |
|
242
|
|
|
* Last SQL query used by a find() lookup. |
|
243
|
|
|
* |
|
244
|
|
|
* @var string |
|
245
|
|
|
*/ |
|
246
|
|
|
public $sql; |
|
247
|
|
|
|
|
248
|
|
|
/** |
|
249
|
|
|
* Pods_Deprecated object. |
|
250
|
|
|
* |
|
251
|
|
|
* @var Pods_Deprecated |
|
252
|
|
|
*/ |
|
253
|
|
|
public $deprecated; |
|
254
|
|
|
|
|
255
|
|
|
/** |
|
256
|
|
|
* Old Pod name variable. |
|
257
|
|
|
* |
|
258
|
|
|
* @var string |
|
259
|
|
|
* |
|
260
|
|
|
* @deprecated 2.0 |
|
261
|
|
|
*/ |
|
262
|
|
|
public $datatype; |
|
263
|
|
|
|
|
264
|
|
|
/** |
|
265
|
|
|
* Old Pod ID variable. |
|
266
|
|
|
* |
|
267
|
|
|
* @var int |
|
268
|
|
|
* |
|
269
|
|
|
* @deprecated 2.0 |
|
270
|
|
|
*/ |
|
271
|
|
|
public $datatype_id; |
|
272
|
|
|
|
|
273
|
|
|
/** |
|
274
|
|
|
* Constructor - Pods Framework core. |
|
275
|
|
|
* |
|
276
|
|
|
* @param string $pod The pod name. |
|
|
|
|
|
|
277
|
|
|
* @param mixed $id (optional) The ID or slug, to load a single record; Provide array of $params to run 'find'. |
|
278
|
|
|
* |
|
279
|
|
|
* @license http://www.gnu.org/licenses/gpl-2.0.html |
|
280
|
|
|
* @since 1.0.0 |
|
281
|
|
|
* @link https://pods.io/docs/pods/ |
|
282
|
|
|
*/ |
|
283
|
|
|
public function __construct( $pod = null, $id = null ) { |
|
284
|
|
|
|
|
285
|
|
|
if ( null === $pod ) { |
|
286
|
|
|
$queried_object = get_queried_object(); |
|
287
|
|
|
|
|
288
|
|
|
if ( $queried_object ) { |
|
289
|
|
|
$id_lookup = true; |
|
290
|
|
|
|
|
291
|
|
|
if ( isset( $queried_object->post_type ) ) { |
|
292
|
|
|
// Post Type Singular. |
|
293
|
|
|
$pod = $queried_object->post_type; |
|
294
|
|
|
} elseif ( isset( $queried_object->taxonomy ) ) { |
|
295
|
|
|
// Term Archive. |
|
296
|
|
|
$pod = $queried_object->taxonomy; |
|
297
|
|
|
} elseif ( isset( $queried_object->user_login ) ) { |
|
298
|
|
|
// Author Archive. |
|
299
|
|
|
$pod = 'user'; |
|
300
|
|
|
} elseif ( isset( $queried_object->public, $queried_object->name ) ) { |
|
301
|
|
|
// Post Type Archive. |
|
302
|
|
|
$pod = $queried_object->name; |
|
303
|
|
|
|
|
304
|
|
|
$id_lookup = false; |
|
305
|
|
|
} |
|
306
|
|
|
|
|
307
|
|
|
if ( null === $id && $id_lookup ) { |
|
308
|
|
|
$id = get_queried_object_id(); |
|
309
|
|
|
} |
|
310
|
|
|
}//end if |
|
311
|
|
|
}//end if |
|
312
|
|
|
|
|
313
|
|
|
$this->api = pods_api( $pod ); |
|
314
|
|
|
$this->api->display_errors =& $this->display_errors; |
|
315
|
|
|
|
|
316
|
|
|
$this->data = pods_data( $this->api, $id, false ); |
|
317
|
|
|
PodsData::$display_errors =& $this->display_errors; |
|
318
|
|
|
|
|
319
|
|
|
// Set up page variable. |
|
320
|
|
|
if ( pods_strict( false ) ) { |
|
321
|
|
|
$this->page = 1; |
|
322
|
|
|
$this->pagination = false; |
|
323
|
|
|
$this->search = false; |
|
324
|
|
|
} else { |
|
325
|
|
|
// Get the page variable. |
|
326
|
|
|
$this->page = pods_v( $this->page_var, 'get', 1, true ); |
|
327
|
|
|
|
|
328
|
|
|
if ( ! empty( $this->page ) ) { |
|
329
|
|
|
$this->page = max( 1, pods_absint( $this->page ) ); |
|
330
|
|
|
} |
|
331
|
|
|
} |
|
332
|
|
|
|
|
333
|
|
|
// Set default pagination handling to on/off. |
|
334
|
|
|
if ( defined( 'PODS_GLOBAL_POD_PAGINATION' ) ) { |
|
335
|
|
|
if ( ! PODS_GLOBAL_POD_PAGINATION ) { |
|
336
|
|
|
$this->page = 1; |
|
337
|
|
|
$this->pagination = false; |
|
338
|
|
|
} else { |
|
339
|
|
|
$this->pagination = true; |
|
340
|
|
|
} |
|
341
|
|
|
} |
|
342
|
|
|
|
|
343
|
|
|
// Set default search to on/off. |
|
344
|
|
|
if ( defined( 'PODS_GLOBAL_POD_SEARCH' ) ) { |
|
345
|
|
|
if ( PODS_GLOBAL_POD_SEARCH ) { |
|
346
|
|
|
$this->search = true; |
|
347
|
|
|
} else { |
|
348
|
|
|
$this->search = false; |
|
349
|
|
|
} |
|
350
|
|
|
} |
|
351
|
|
|
|
|
352
|
|
|
// Set default search mode. |
|
353
|
|
|
$allowed_search_modes = array( 'int', 'text', 'text_like' ); |
|
354
|
|
|
|
|
355
|
|
|
if ( defined( 'PODS_GLOBAL_POD_SEARCH_MODE' ) && in_array( PODS_GLOBAL_POD_SEARCH_MODE, $allowed_search_modes, true ) ) { |
|
356
|
|
|
$this->search_mode = PODS_GLOBAL_POD_SEARCH_MODE; |
|
357
|
|
|
} |
|
358
|
|
|
|
|
359
|
|
|
// Sync Settings. |
|
360
|
|
|
$this->data->page =& $this->page; |
|
361
|
|
|
$this->data->limit =& $this->limit; |
|
362
|
|
|
$this->data->pagination =& $this->pagination; |
|
363
|
|
|
$this->data->search =& $this->search; |
|
364
|
|
|
$this->data->search_mode =& $this->search_mode; |
|
365
|
|
|
|
|
366
|
|
|
// Sync Pod Data. |
|
367
|
|
|
$this->api->pod_data =& $this->data->pod_data; |
|
368
|
|
|
$this->pod_data =& $this->api->pod_data; |
|
369
|
|
|
$this->api->pod_id =& $this->data->pod_id; |
|
|
|
|
|
|
370
|
|
|
$this->pod_id =& $this->api->pod_id; |
|
371
|
|
|
$this->datatype_id =& $this->pod_id; |
|
|
|
|
|
|
372
|
|
|
$this->api->pod =& $this->data->pod; |
|
373
|
|
|
$this->pod =& $this->api->pod; |
|
374
|
|
|
$this->datatype =& $this->pod; |
|
|
|
|
|
|
375
|
|
|
$this->api->fields =& $this->data->fields; |
|
376
|
|
|
$this->fields =& $this->api->fields; |
|
377
|
|
|
$this->detail_page =& $this->data->detail_page; |
|
378
|
|
|
$this->id =& $this->data->id; |
|
379
|
|
|
$this->row =& $this->data->row; |
|
380
|
|
|
$this->rows =& $this->data->data; |
|
381
|
|
|
$this->row_number =& $this->data->row_number; |
|
382
|
|
|
$this->sql =& $this->data->sql; |
|
383
|
|
|
|
|
384
|
|
|
if ( is_array( $id ) || is_object( $id ) ) { |
|
385
|
|
|
$this->find( $id ); |
|
386
|
|
|
} |
|
387
|
|
|
} |
|
388
|
|
|
|
|
389
|
|
|
/** |
|
390
|
|
|
* Whether this Pod object is valid or not |
|
391
|
|
|
* |
|
392
|
|
|
* @return bool |
|
393
|
|
|
* |
|
394
|
|
|
* @since 2.0 |
|
395
|
|
|
*/ |
|
396
|
|
|
public function valid() { |
|
397
|
|
|
|
|
398
|
|
|
if ( empty( $this->pod_id ) ) { |
|
399
|
|
|
return false; |
|
400
|
|
|
} |
|
401
|
|
|
|
|
402
|
|
|
if ( $this->iterator ) { |
|
403
|
|
|
return isset( $this->rows[ $this->row_number ] ); |
|
404
|
|
|
} |
|
405
|
|
|
|
|
406
|
|
|
return true; |
|
407
|
|
|
} |
|
408
|
|
|
|
|
409
|
|
|
/** |
|
410
|
|
|
* Check if in Iterator mode |
|
411
|
|
|
* |
|
412
|
|
|
* @return bool |
|
413
|
|
|
* |
|
414
|
|
|
* @since 2.3.4 |
|
415
|
|
|
* |
|
416
|
|
|
* @link http://www.php.net/manual/en/class.iterator.php |
|
417
|
|
|
*/ |
|
418
|
|
|
public function is_iterator() { |
|
419
|
|
|
|
|
420
|
|
|
return $this->iterator; |
|
421
|
|
|
} |
|
422
|
|
|
|
|
423
|
|
|
/** |
|
424
|
|
|
* Turn off Iterator mode to off |
|
425
|
|
|
* |
|
426
|
|
|
* @return void |
|
427
|
|
|
* |
|
428
|
|
|
* @since 2.3.4 |
|
429
|
|
|
* |
|
430
|
|
|
* @link http://www.php.net/manual/en/class.iterator.php |
|
431
|
|
|
*/ |
|
432
|
|
|
public function stop_iterator() { |
|
433
|
|
|
|
|
434
|
|
|
$this->iterator = false; |
|
435
|
|
|
|
|
436
|
|
|
} |
|
437
|
|
|
|
|
438
|
|
|
/** |
|
439
|
|
|
* Rewind Iterator |
|
440
|
|
|
* |
|
441
|
|
|
* @since 2.3.4 |
|
442
|
|
|
* |
|
443
|
|
|
* @link http://www.php.net/manual/en/class.iterator.php |
|
444
|
|
|
*/ |
|
445
|
|
|
public function rewind() { |
|
446
|
|
|
|
|
447
|
|
|
if ( ! $this->iterator ) { |
|
448
|
|
|
$this->iterator = true; |
|
449
|
|
|
|
|
450
|
|
|
$this->row_number = 0; |
|
451
|
|
|
} |
|
452
|
|
|
} |
|
453
|
|
|
|
|
454
|
|
|
/** |
|
455
|
|
|
* Get current Iterator row |
|
456
|
|
|
* |
|
457
|
|
|
* @return mixed|boolean |
|
|
|
|
|
|
458
|
|
|
* |
|
459
|
|
|
* @since 2.3.4 |
|
460
|
|
|
* |
|
461
|
|
|
* @link http://www.php.net/manual/en/class.iterator.php |
|
462
|
|
|
*/ |
|
463
|
|
|
public function current() { |
|
464
|
|
|
|
|
465
|
|
|
if ( $this->iterator && $this->fetch() ) { |
|
466
|
|
|
return $this; |
|
467
|
|
|
} |
|
468
|
|
|
|
|
469
|
|
|
return false; |
|
470
|
|
|
} |
|
471
|
|
|
|
|
472
|
|
|
/** |
|
473
|
|
|
* Get current Iterator key |
|
474
|
|
|
* |
|
475
|
|
|
* @return int |
|
476
|
|
|
* |
|
477
|
|
|
* @since 2.3.4 |
|
478
|
|
|
* |
|
479
|
|
|
* @link http://www.php.net/manual/en/class.iterator.php |
|
480
|
|
|
*/ |
|
481
|
|
|
public function key() { |
|
482
|
|
|
|
|
483
|
|
|
return $this->row_number; |
|
484
|
|
|
} |
|
485
|
|
|
|
|
486
|
|
|
/** |
|
487
|
|
|
* Move onto the next Iterator row |
|
488
|
|
|
* |
|
489
|
|
|
* @return void |
|
490
|
|
|
* |
|
491
|
|
|
* @since 2.3.4 |
|
492
|
|
|
* |
|
493
|
|
|
* @link http://www.php.net/manual/en/class.iterator.php |
|
494
|
|
|
*/ |
|
495
|
|
|
public function next() { |
|
496
|
|
|
|
|
497
|
|
|
$this->row_number ++; |
|
498
|
|
|
} |
|
499
|
|
|
|
|
500
|
|
|
/** |
|
501
|
|
|
* Whether a Pod item exists or not when using fetch() or construct with an ID or slug |
|
502
|
|
|
* |
|
503
|
|
|
* @return bool |
|
504
|
|
|
* |
|
505
|
|
|
* @since 2.0 |
|
506
|
|
|
*/ |
|
507
|
|
|
public function exists() { |
|
508
|
|
|
|
|
509
|
|
|
if ( empty( $this->row ) ) { |
|
|
|
|
|
|
510
|
|
|
return false; |
|
511
|
|
|
} |
|
512
|
|
|
|
|
513
|
|
|
return true; |
|
514
|
|
|
} |
|
515
|
|
|
|
|
516
|
|
|
/** |
|
517
|
|
|
* Return an array of all rows returned from a find() call. |
|
518
|
|
|
* |
|
519
|
|
|
* Most of the time, you will want to loop through data using fetch() |
|
520
|
|
|
* instead of using this function. |
|
521
|
|
|
* |
|
522
|
|
|
* @return array|bool An array of all rows returned from a find() call, or false if no items returned |
|
|
|
|
|
|
523
|
|
|
* |
|
524
|
|
|
* @since 2.0 |
|
525
|
|
|
* @link https://pods.io/docs/data/ |
|
526
|
|
|
*/ |
|
527
|
|
|
public function data() { |
|
528
|
|
|
|
|
529
|
|
|
do_action( 'pods_pods_data', $this ); |
|
530
|
|
|
|
|
531
|
|
|
if ( empty( $this->rows ) ) { |
|
532
|
|
|
return false; |
|
533
|
|
|
} |
|
534
|
|
|
|
|
535
|
|
|
return (array) $this->rows; |
|
536
|
|
|
} |
|
537
|
|
|
|
|
538
|
|
|
/** |
|
539
|
|
|
* Return a field input for a specific field |
|
540
|
|
|
* |
|
541
|
|
|
* @param string|array $field Field name or Field data array. |
|
542
|
|
|
* @param string|array|null $input_name Input field name to use (overrides default name). |
|
543
|
|
|
* @param mixed $value Current value to use. |
|
544
|
|
|
* |
|
545
|
|
|
* @return string Field Input HTML |
|
546
|
|
|
* |
|
547
|
|
|
* @since 2.3.10 |
|
548
|
|
|
*/ |
|
549
|
|
|
public function input( $field, $input_name = null, $value = '__null' ) { |
|
550
|
|
|
|
|
551
|
|
|
if ( is_array( $field ) ) { |
|
552
|
|
|
// Field data override. |
|
553
|
|
|
$field_data = $field; |
|
554
|
|
|
|
|
555
|
|
|
$field = pods_v( 'name', $field ); |
|
556
|
|
|
} else { |
|
557
|
|
|
// Get field data from field name. |
|
558
|
|
|
$field_data = $this->fields( $field ); |
|
559
|
|
|
} |
|
560
|
|
|
|
|
561
|
|
|
if ( ! empty( $field_data ) ) { |
|
562
|
|
|
$field_type = pods_v( 'type', $field_data ); |
|
563
|
|
|
|
|
564
|
|
|
if ( empty( $input_name ) ) { |
|
565
|
|
|
$input_name = $field; |
|
566
|
|
|
} |
|
567
|
|
|
|
|
568
|
|
|
if ( '__null' === $value ) { |
|
569
|
|
|
$value = $this->field( array( |
|
570
|
|
|
'name' => $field, |
|
571
|
|
|
'in_form' => true, |
|
572
|
|
|
) ); |
|
573
|
|
|
} |
|
574
|
|
|
|
|
575
|
|
|
return PodsForm::field( $input_name, $value, $field_type, $field_data, $this, $this->id() ); |
|
576
|
|
|
} |
|
577
|
|
|
|
|
578
|
|
|
return ''; |
|
579
|
|
|
|
|
580
|
|
|
} |
|
581
|
|
|
|
|
582
|
|
|
/** |
|
583
|
|
|
* Return field array from a Pod, a field's data, or a field option |
|
584
|
|
|
* |
|
585
|
|
|
* @param null $field Field name. |
|
586
|
|
|
* @param null $option Option name. |
|
587
|
|
|
* |
|
588
|
|
|
* @return bool|mixed |
|
589
|
|
|
* |
|
590
|
|
|
* @since 2.0 |
|
591
|
|
|
*/ |
|
592
|
|
|
public function fields( $field = null, $option = null ) { |
|
593
|
|
|
|
|
594
|
|
|
$field_data = null; |
|
595
|
|
|
|
|
596
|
|
|
if ( empty( $this->fields ) ) { |
|
597
|
|
|
// No fields found. |
|
598
|
|
|
$field_data = array(); |
|
599
|
|
|
} elseif ( empty( $field ) ) { |
|
600
|
|
|
// Return all fields. |
|
601
|
|
|
$field_data = (array) $this->fields; |
|
602
|
|
|
} elseif ( ! isset( $this->fields[ $field ] ) && ! isset( $this->pod_data['object_fields'][ $field ] ) ) { |
|
603
|
|
|
// Field not found. |
|
604
|
|
|
$field_data = array(); |
|
605
|
|
|
} elseif ( empty( $option ) ) { |
|
606
|
|
|
// Return all field data. |
|
607
|
|
|
if ( isset( $this->fields[ $field ] ) ) { |
|
608
|
|
|
$field_data = $this->fields[ $field ]; |
|
609
|
|
|
} elseif ( isset( $this->pod_data['object_fields'] ) ) { |
|
610
|
|
|
$field_data = $this->pod_data['object_fields'][ $field ]; |
|
611
|
|
|
} |
|
612
|
|
|
} else { |
|
613
|
|
|
$options = array(); |
|
614
|
|
|
|
|
615
|
|
|
// Merge options. |
|
616
|
|
|
if ( isset( $this->fields[ $field ] ) ) { |
|
617
|
|
|
$options = array_merge( $this->fields[ $field ], $this->fields[ $field ]['options'] ); |
|
618
|
|
|
} elseif ( isset( $this->pod_data['object_fields'] ) ) { |
|
619
|
|
|
$options = array_merge( $this->pod_data['object_fields'][ $field ], $this->pod_data['object_fields'][ $field ]['options'] ); |
|
620
|
|
|
} |
|
621
|
|
|
|
|
622
|
|
|
if ( 'data' === $option && in_array( pods_v( 'type', $options ), PodsForm::tableless_field_types(), true ) ) { |
|
623
|
|
|
// Get a list of available items from a relationship field. |
|
624
|
|
|
$field_data = PodsForm::field_method( 'pick', 'get_field_data', $options ); |
|
625
|
|
|
} elseif ( isset( $options[ $option ] ) ) { |
|
626
|
|
|
// Return option. |
|
627
|
|
|
$field_data = $options[ $option ]; |
|
628
|
|
|
} |
|
629
|
|
|
}//end if |
|
630
|
|
|
|
|
631
|
|
|
/** |
|
632
|
|
|
* Modify the field data before returning |
|
633
|
|
|
* |
|
634
|
|
|
* @since unknown |
|
635
|
|
|
* |
|
636
|
|
|
* @param array $field_data The data for the field. |
|
637
|
|
|
* @param string|null $field The specific field that data is being return for, if set when method is called or null. |
|
638
|
|
|
* @param string|null $option Value of option param when method was called. Can be used to get a list of available items from a relationship field. |
|
639
|
|
|
* @param Pods|object $this The current Pods class instance. |
|
640
|
|
|
*/ |
|
641
|
|
|
return apply_filters( 'pods_pods_fields', $field_data, $field, $option, $this ); |
|
642
|
|
|
|
|
643
|
|
|
} |
|
644
|
|
|
|
|
645
|
|
|
/** |
|
646
|
|
|
* Return row array for an item |
|
647
|
|
|
* |
|
648
|
|
|
* @return array|false |
|
649
|
|
|
* |
|
650
|
|
|
* @since 2.0 |
|
651
|
|
|
*/ |
|
652
|
|
|
public function row() { |
|
653
|
|
|
|
|
654
|
|
|
do_action( 'pods_pods_row', $this ); |
|
655
|
|
|
|
|
656
|
|
|
if ( ! is_array( $this->row ) ) { |
|
657
|
|
|
return false; |
|
658
|
|
|
} |
|
659
|
|
|
|
|
660
|
|
|
return (array) $this->row; |
|
661
|
|
|
} |
|
662
|
|
|
|
|
663
|
|
|
/** |
|
664
|
|
|
* Return the output for a field. If you want the raw value for use in PHP for custom manipulation, |
|
665
|
|
|
* you will want to use field() instead. This function will automatically convert arrays into a |
|
666
|
|
|
* list of text such as "Rick, John, and Gary" |
|
667
|
|
|
* |
|
668
|
|
|
* @param string|array|object $name The field name, or an associative array of parameters. |
|
669
|
|
|
* @param boolean|array|object $single (optional) For tableless fields, to return an array or the first. |
|
|
|
|
|
|
670
|
|
|
* |
|
671
|
|
|
* @return string|null|false The output from the field, null if the field doesn't exist, false if no value returned |
|
|
|
|
|
|
672
|
|
|
* for tableless fields |
|
673
|
|
|
* @since 2.0 |
|
674
|
|
|
* @link https://pods.io/docs/display/ |
|
675
|
|
|
*/ |
|
676
|
|
|
public function display( $name, $single = null ) { |
|
677
|
|
|
|
|
678
|
|
|
$defaults = array( |
|
679
|
|
|
'name' => $name, |
|
680
|
|
|
'single' => $single, |
|
681
|
|
|
'display' => true, |
|
682
|
|
|
'serial_params' => null, |
|
683
|
|
|
); |
|
684
|
|
|
|
|
685
|
|
|
if ( is_array( $name ) || is_object( $name ) ) { |
|
686
|
|
|
$defaults['name'] = null; |
|
687
|
|
|
|
|
688
|
|
|
$params = (object) array_merge( $defaults, (array) $name ); |
|
689
|
|
|
} elseif ( is_array( $single ) || is_object( $single ) ) { |
|
690
|
|
|
$defaults['single'] = null; |
|
691
|
|
|
|
|
692
|
|
|
$params = (object) array_merge( $defaults, (array) $single ); |
|
693
|
|
|
} else { |
|
694
|
|
|
$params = $defaults; |
|
695
|
|
|
} |
|
696
|
|
|
|
|
697
|
|
|
$params = (object) $params; |
|
698
|
|
|
|
|
699
|
|
|
$value = $this->field( $params ); |
|
700
|
|
|
|
|
701
|
|
|
if ( is_array( $value ) ) { |
|
702
|
|
|
$fields = $this->fields; |
|
703
|
|
|
|
|
704
|
|
|
if ( isset( $this->pod_data['object_fields'] ) ) { |
|
705
|
|
|
$fields = array_merge( $fields, $this->pod_data['object_fields'] ); |
|
706
|
|
|
} |
|
707
|
|
|
|
|
708
|
|
|
$serial_params = array( |
|
709
|
|
|
'field' => $params->name, |
|
710
|
|
|
'fields' => $fields, |
|
711
|
|
|
); |
|
712
|
|
|
|
|
713
|
|
|
if ( ! empty( $params->serial_params ) && is_array( $params->serial_params ) ) { |
|
714
|
|
|
$serial_params = array_merge( $serial_params, $params->serial_params ); |
|
715
|
|
|
} |
|
716
|
|
|
|
|
717
|
|
|
$value = pods_serial_comma( $value, $serial_params ); |
|
718
|
|
|
} |
|
719
|
|
|
|
|
720
|
|
|
return $value; |
|
721
|
|
|
} |
|
722
|
|
|
|
|
723
|
|
|
/** |
|
724
|
|
|
* Return the raw output for a field If you want the raw value for use in PHP for custom manipulation, |
|
725
|
|
|
* you will want to use field() instead. This function will automatically convert arrays into a |
|
726
|
|
|
* list of text such as "Rick, John, and Gary" |
|
727
|
|
|
* |
|
728
|
|
|
* @param string|array|object $name The field name, or an associative array of parameters. |
|
729
|
|
|
* @param boolean|array|object $single (optional) For tableless fields, to return an array or the first. |
|
|
|
|
|
|
730
|
|
|
* |
|
731
|
|
|
* @return string|null|false The output from the field, null if the field doesn't exist, false if no value returned |
|
732
|
|
|
* for tableless fields |
|
733
|
|
|
* @since 2.0 |
|
734
|
|
|
* @link https://pods.io/docs/display/ |
|
735
|
|
|
*/ |
|
736
|
|
|
public function raw( $name, $single = null ) { |
|
737
|
|
|
|
|
738
|
|
|
$defaults = array( |
|
739
|
|
|
'name' => $name, |
|
740
|
|
|
'single' => $single, |
|
741
|
|
|
'raw' => true, |
|
742
|
|
|
); |
|
743
|
|
|
|
|
744
|
|
|
if ( is_array( $name ) || is_object( $name ) ) { |
|
745
|
|
|
$defaults['name'] = null; |
|
746
|
|
|
|
|
747
|
|
|
$params = (object) array_merge( $defaults, (array) $name ); |
|
748
|
|
|
} elseif ( is_array( $single ) || is_object( $single ) ) { |
|
749
|
|
|
$defaults['single'] = null; |
|
750
|
|
|
|
|
751
|
|
|
$params = (object) array_merge( $defaults, (array) $single ); |
|
752
|
|
|
} else { |
|
753
|
|
|
$params = (object) $defaults; |
|
754
|
|
|
} |
|
755
|
|
|
|
|
756
|
|
|
return $this->field( $params ); |
|
757
|
|
|
} |
|
758
|
|
|
|
|
759
|
|
|
/** |
|
760
|
|
|
* Return the value for a field. |
|
761
|
|
|
* |
|
762
|
|
|
* If you are getting a field for output in a theme, most of the time you will want to use display() instead. |
|
763
|
|
|
* |
|
764
|
|
|
* This function will return arrays for relationship and file fields. |
|
765
|
|
|
* |
|
766
|
|
|
* @param string|array|object $name The field name, or an associative array of parameters. |
|
767
|
|
|
* @param boolean|array|object $single For tableless fields, to return the whole array or the just the first item, |
|
|
|
|
|
|
768
|
|
|
* or an associative array of parameters. |
|
769
|
|
|
* @param boolean|array|object $raw Whether to return the raw value, or to run through the field type's display |
|
770
|
|
|
* method, or an associative array of parameters. |
|
771
|
|
|
* |
|
772
|
|
|
* @return mixed|null Value returned depends on the field type, null if the field doesn't exist, false if no value |
|
773
|
|
|
* returned for tableless fields. |
|
774
|
|
|
* @since 2.0 |
|
775
|
|
|
* @link https://pods.io/docs/field/ |
|
776
|
|
|
*/ |
|
777
|
|
|
public function field( $name, $single = null, $raw = false ) { |
|
778
|
|
|
|
|
779
|
|
|
$defaults = array( |
|
780
|
|
|
'name' => $name, |
|
781
|
|
|
'orderby' => null, |
|
782
|
|
|
'single' => $single, |
|
783
|
|
|
'params' => null, |
|
784
|
|
|
'in_form' => false, |
|
785
|
|
|
'raw' => $raw, |
|
786
|
|
|
'raw_display' => false, |
|
787
|
|
|
'display' => false, |
|
788
|
|
|
'get_meta' => false, |
|
789
|
|
|
'output' => null, |
|
790
|
|
|
'deprecated' => false, |
|
791
|
|
|
// extra data to send to field handlers. |
|
792
|
|
|
'args' => array(), |
|
793
|
|
|
); |
|
794
|
|
|
|
|
795
|
|
|
if ( is_object( $name ) ) { |
|
796
|
|
|
$name = get_object_vars( $name ); |
|
797
|
|
|
} |
|
798
|
|
|
|
|
799
|
|
|
if ( is_object( $single ) ) { |
|
800
|
|
|
$single = get_object_vars( $single ); |
|
801
|
|
|
} |
|
802
|
|
|
|
|
803
|
|
|
if ( is_object( $raw ) ) { |
|
804
|
|
|
$raw = get_object_vars( $raw ); |
|
805
|
|
|
} |
|
806
|
|
|
|
|
807
|
|
|
if ( is_array( $name ) ) { |
|
808
|
|
|
$defaults['name'] = null; |
|
809
|
|
|
|
|
810
|
|
|
$params = (object) array_merge( $defaults, (array) $name ); |
|
811
|
|
|
} elseif ( is_array( $single ) ) { |
|
812
|
|
|
$defaults['single'] = null; |
|
813
|
|
|
|
|
814
|
|
|
$params = (object) array_merge( $defaults, (array) $single ); |
|
815
|
|
|
} elseif ( is_array( $raw ) ) { |
|
816
|
|
|
$defaults['raw'] = false; |
|
817
|
|
|
|
|
818
|
|
|
$params = (object) array_merge( $defaults, (array) $raw ); |
|
819
|
|
|
} else { |
|
820
|
|
|
$params = (object) $defaults; |
|
821
|
|
|
}//end if |
|
822
|
|
|
|
|
823
|
|
|
if ( $params->in_form ) { |
|
824
|
|
|
$params->output = 'ids'; |
|
825
|
|
|
} elseif ( null === $params->output ) { |
|
826
|
|
|
/** |
|
827
|
|
|
* Override the way related fields are output |
|
828
|
|
|
* |
|
829
|
|
|
* @param string $output How to output related fields. Default is 'arrays'. Options: ids|names|objects|arrays|pods|find |
|
830
|
|
|
* @param array|object $row Current row being outputted. |
|
831
|
|
|
* @param array $params Params array passed to field(). |
|
832
|
|
|
* @param Pods $this Current Pods object. |
|
833
|
|
|
*/ |
|
834
|
|
|
$params->output = apply_filters( 'pods_pods_field_related_output_type', 'arrays', $this->row, $params, $this ); |
|
835
|
|
|
} |
|
836
|
|
|
|
|
837
|
|
|
if ( in_array( $params->output, array( 'id', 'name', 'object', 'array', 'pod' ), true ) ) { |
|
838
|
|
|
$params->output .= 's'; |
|
839
|
|
|
} |
|
840
|
|
|
|
|
841
|
|
|
// Support old $orderby variable. |
|
842
|
|
|
if ( null !== $params->single && is_string( $params->single ) && empty( $params->orderby ) ) { |
|
843
|
|
|
if ( ! class_exists( 'Pod' ) || Pod::$deprecated_notice ) { |
|
844
|
|
|
pods_deprecated( 'Pods::field', '2.0', 'Use $params[ \'orderby\' ] instead' ); |
|
845
|
|
|
} |
|
846
|
|
|
|
|
847
|
|
|
$params->orderby = $params->single; |
|
848
|
|
|
$params->single = false; |
|
849
|
|
|
} |
|
850
|
|
|
|
|
851
|
|
|
if ( null !== $params->single ) { |
|
852
|
|
|
$params->single = (boolean) $params->single; |
|
853
|
|
|
} |
|
854
|
|
|
|
|
855
|
|
|
$params->name = trim( $params->name ); |
|
856
|
|
|
if ( is_array( $params->name ) || '' === $params->name ) { |
|
857
|
|
|
return null; |
|
858
|
|
|
} |
|
859
|
|
|
|
|
860
|
|
|
$params->full_name = $params->name; |
|
861
|
|
|
|
|
862
|
|
|
$value = null; |
|
863
|
|
|
|
|
864
|
|
|
if ( isset( $this->row_override[ $params->name ] ) ) { |
|
865
|
|
|
$value = $this->row_override[ $params->name ]; |
|
866
|
|
|
} |
|
867
|
|
|
|
|
868
|
|
|
if ( false === $this->row() ) { |
|
869
|
|
|
if ( false !== $this->data() ) { |
|
870
|
|
|
$this->fetch(); |
|
871
|
|
|
} else { |
|
872
|
|
|
return $value; |
|
873
|
|
|
} |
|
874
|
|
|
} |
|
875
|
|
|
|
|
876
|
|
|
if ( $this->data->field_id === $params->name ) { |
|
877
|
|
|
if ( isset( $this->row[ $params->name ] ) ) { |
|
878
|
|
|
return $this->row[ $params->name ]; |
|
879
|
|
|
// @codingStandardsIgnoreLine. |
|
880
|
|
|
} elseif ( null !== $value ) { |
|
881
|
|
|
return $value; |
|
882
|
|
|
} |
|
883
|
|
|
|
|
884
|
|
|
return 0; |
|
885
|
|
|
} |
|
886
|
|
|
|
|
887
|
|
|
$tableless_field_types = PodsForm::tableless_field_types(); |
|
|
|
|
|
|
888
|
|
|
$simple_tableless_objects = PodsForm::simple_tableless_objects(); |
|
|
|
|
|
|
889
|
|
|
|
|
890
|
|
|
$params->traverse = array(); |
|
891
|
|
|
|
|
892
|
|
|
if ( in_array( $params->name, array( |
|
893
|
|
|
'_link', |
|
894
|
|
|
'detail_url', |
|
895
|
|
|
), true ) || ( in_array( $params->name, array( |
|
896
|
|
|
'permalink', |
|
897
|
|
|
'the_permalink', |
|
898
|
|
|
), true ) && in_array( $this->pod_data['type'], array( |
|
899
|
|
|
'post_type', |
|
900
|
|
|
'taxonomy', |
|
901
|
|
|
'media', |
|
902
|
|
|
'user', |
|
903
|
|
|
'comment', |
|
904
|
|
|
), true ) ) ) { |
|
905
|
|
|
if ( 0 < strlen( $this->detail_page ) ) { |
|
906
|
|
|
$value = get_home_url() . '/' . $this->do_magic_tags( $this->detail_page ); |
|
907
|
|
|
} elseif ( in_array( $this->pod_data['type'], array( 'post_type', 'media' ), true ) ) { |
|
908
|
|
|
$value = get_permalink( $this->id() ); |
|
909
|
|
|
} elseif ( 'taxonomy' === $this->pod_data['type'] ) { |
|
910
|
|
|
$value = get_term_link( $this->id(), $this->pod_data['name'] ); |
|
911
|
|
|
} elseif ( 'user' === $this->pod_data['type'] ) { |
|
912
|
|
|
$value = get_author_posts_url( $this->id() ); |
|
913
|
|
|
} elseif ( 'comment' === $this->pod_data['type'] ) { |
|
914
|
|
|
$value = get_comment_link( $this->id() ); |
|
915
|
|
|
} |
|
916
|
|
|
} |
|
917
|
|
|
|
|
918
|
|
|
$field_data = false; |
|
919
|
|
|
$last_field_data = false; |
|
920
|
|
|
$field_type = false; |
|
921
|
|
|
|
|
922
|
|
|
$first_field = explode( '.', $params->name ); |
|
923
|
|
|
$first_field = $first_field[0]; |
|
924
|
|
|
|
|
925
|
|
|
if ( isset( $this->fields[ $first_field ] ) ) { |
|
926
|
|
|
$field_data = $this->fields[ $first_field ]; |
|
927
|
|
|
$field_type = 'field'; |
|
928
|
|
|
} elseif ( ! empty( $this->pod_data['object_fields'] ) ) { |
|
929
|
|
|
if ( isset( $this->pod_data['object_fields'][ $first_field ] ) ) { |
|
930
|
|
|
$field_data = $this->pod_data['object_fields'][ $first_field ]; |
|
931
|
|
|
$field_type = 'object_field'; |
|
932
|
|
|
} else { |
|
933
|
|
|
$object_fields = (array) $this->pod_data['object_fields']; |
|
934
|
|
|
|
|
935
|
|
|
foreach ( $object_fields as $object_field => $object_field_opt ) { |
|
936
|
|
|
if ( in_array( $first_field, $object_field_opt['alias'], true ) ) { |
|
937
|
|
|
if ( $first_field === $params->name ) { |
|
938
|
|
|
$params->name = $object_field; |
|
939
|
|
|
} |
|
940
|
|
|
|
|
941
|
|
|
$first_field = $object_field; |
|
942
|
|
|
$field_data = $object_field_opt; |
|
943
|
|
|
$field_type = 'object_field'; |
|
944
|
|
|
|
|
945
|
|
|
break; |
|
946
|
|
|
} |
|
947
|
|
|
} |
|
948
|
|
|
} |
|
949
|
|
|
}//end if |
|
950
|
|
|
|
|
951
|
|
|
// Simple fields have no other output options. |
|
952
|
|
|
if ( 'pick' === $field_data['type'] && in_array( $field_data['pick_object'], $simple_tableless_objects, true ) ) { |
|
953
|
|
|
$params->output = 'arrays'; |
|
954
|
|
|
} |
|
955
|
|
|
|
|
956
|
|
|
if ( empty( $value ) && in_array( $field_data['type'], $tableless_field_types, true ) ) { |
|
957
|
|
|
$params->raw = true; |
|
958
|
|
|
|
|
959
|
|
|
$value = false; |
|
960
|
|
|
|
|
961
|
|
|
$row_key = sprintf( '_%s_%s', $params->output, $params->name ); |
|
962
|
|
|
|
|
963
|
|
|
if ( 'arrays' !== $params->output && isset( $this->row[ $row_key ] ) ) { |
|
964
|
|
|
$value = $this->row[ '_' . $params->output . '_' . $params->name ]; |
|
965
|
|
|
} elseif ( 'arrays' === $params->output && isset( $this->row[ $params->name ] ) ) { |
|
966
|
|
|
$value = $this->row[ $params->name ]; |
|
967
|
|
|
} |
|
968
|
|
|
|
|
969
|
|
|
if ( false !== $value && ! is_array( $value ) && 'pick' === $field_data['type'] && in_array( $field_data['pick_object'], $simple_tableless_objects, true ) ) { |
|
970
|
|
|
$value = PodsForm::field_method( 'pick', 'simple_value', $params->name, $value, $field_data, $this->pod_data, $this->id(), true ); |
|
971
|
|
|
} |
|
972
|
|
|
} |
|
973
|
|
|
|
|
974
|
|
|
if ( empty( $value ) && isset( $this->row[ $params->name ] ) && ( ! in_array( $field_data['type'], $tableless_field_types, true ) || 'arrays' === $params->output ) ) { |
|
975
|
|
|
if ( empty( $field_data ) || in_array( $field_data['type'], array( |
|
976
|
|
|
'boolean', |
|
977
|
|
|
'number', |
|
978
|
|
|
'currency', |
|
979
|
|
|
), true ) ) { |
|
980
|
|
|
$params->raw = true; |
|
981
|
|
|
} |
|
982
|
|
|
|
|
983
|
|
|
if ( null === $params->single ) { |
|
984
|
|
|
if ( isset( $this->fields[ $params->name ] ) && ! in_array( $this->fields[ $params->name ]['type'], $tableless_field_types, true ) ) { |
|
985
|
|
|
$params->single = true; |
|
986
|
|
|
} else { |
|
987
|
|
|
$params->single = false; |
|
988
|
|
|
} |
|
989
|
|
|
} |
|
990
|
|
|
|
|
991
|
|
|
$value = $this->row[ $params->name ]; |
|
992
|
|
|
} elseif ( empty( $value ) ) { |
|
993
|
|
|
$object_field_found = false; |
|
994
|
|
|
|
|
995
|
|
|
if ( 'object_field' === $field_type ) { |
|
996
|
|
|
$object_field_found = true; |
|
997
|
|
|
|
|
998
|
|
|
if ( isset( $this->row[ $first_field ] ) ) { |
|
999
|
|
|
$value = $this->row[ $first_field ]; |
|
1000
|
|
|
} elseif ( in_array( $field_data['type'], $tableless_field_types, true ) ) { |
|
1001
|
|
|
$this->fields[ $first_field ] = $field_data; |
|
1002
|
|
|
|
|
1003
|
|
|
$object_field_found = false; |
|
1004
|
|
|
} else { |
|
1005
|
|
|
return null; |
|
1006
|
|
|
} |
|
1007
|
|
|
} |
|
1008
|
|
|
|
|
1009
|
|
|
if ( 'post_type' === $this->pod_data['type'] && ! isset( $this->fields[ $params->name ] ) ) { |
|
1010
|
|
|
if ( ! isset( $this->fields['post_thumbnail'] ) && ( 'post_thumbnail' === $params->name || 0 === strpos( $params->name, 'post_thumbnail.' ) ) ) { |
|
1011
|
|
|
$size = 'thumbnail'; |
|
1012
|
|
|
|
|
1013
|
|
|
if ( 0 === strpos( $params->name, 'post_thumbnail.' ) ) { |
|
1014
|
|
|
$field_names = explode( '.', $params->name ); |
|
1015
|
|
|
|
|
1016
|
|
|
if ( isset( $field_names[1] ) ) { |
|
1017
|
|
|
$size = $field_names[1]; |
|
1018
|
|
|
} |
|
1019
|
|
|
} |
|
1020
|
|
|
|
|
1021
|
|
|
// Pods will auto-get the thumbnail ID if this isn't an attachment. |
|
1022
|
|
|
$value = pods_image( $this->id(), $size, 0, null, true ); |
|
1023
|
|
|
|
|
1024
|
|
|
$object_field_found = true; |
|
1025
|
|
|
} elseif ( ! isset( $this->fields['post_thumbnail_url'] ) && ( 'post_thumbnail_url' === $params->name || 0 === strpos( $params->name, 'post_thumbnail_url.' ) ) ) { |
|
1026
|
|
|
$size = 'thumbnail'; |
|
1027
|
|
|
|
|
1028
|
|
|
if ( 0 === strpos( $params->name, 'post_thumbnail_url.' ) ) { |
|
1029
|
|
|
$field_names = explode( '.', $params->name ); |
|
1030
|
|
|
|
|
1031
|
|
|
if ( isset( $field_names[1] ) ) { |
|
1032
|
|
|
$size = $field_names[1]; |
|
1033
|
|
|
} |
|
1034
|
|
|
} |
|
1035
|
|
|
|
|
1036
|
|
|
// Pods will auto-get the thumbnail ID if this isn't an attachment. |
|
1037
|
|
|
$value = pods_image_url( $this->id(), $size, 0, true ); |
|
1038
|
|
|
|
|
1039
|
|
|
$object_field_found = true; |
|
1040
|
|
|
} elseif ( 0 === strpos( $params->name, 'image_attachment.' ) ) { |
|
1041
|
|
|
$size = 'thumbnail'; |
|
1042
|
|
|
|
|
1043
|
|
|
$image_id = 0; |
|
1044
|
|
|
|
|
1045
|
|
|
$field_names = explode( '.', $params->name ); |
|
1046
|
|
|
|
|
1047
|
|
|
if ( isset( $field_names[1] ) ) { |
|
1048
|
|
|
$image_id = $field_names[1]; |
|
1049
|
|
|
} |
|
1050
|
|
|
|
|
1051
|
|
|
if ( isset( $field_names[2] ) ) { |
|
1052
|
|
|
$size = $field_names[2]; |
|
1053
|
|
|
} |
|
1054
|
|
|
|
|
1055
|
|
|
if ( ! empty( $image_id ) ) { |
|
1056
|
|
|
$value = pods_image( $image_id, $size, 0, null, true ); |
|
1057
|
|
|
|
|
1058
|
|
|
if ( ! empty( $value ) ) { |
|
1059
|
|
|
$object_field_found = true; |
|
1060
|
|
|
} |
|
1061
|
|
|
} |
|
1062
|
|
|
} elseif ( 0 === strpos( $params->name, 'image_attachment_url.' ) ) { |
|
1063
|
|
|
$size = 'thumbnail'; |
|
1064
|
|
|
|
|
1065
|
|
|
$image_id = 0; |
|
1066
|
|
|
|
|
1067
|
|
|
$field_names = explode( '.', $params->name ); |
|
1068
|
|
|
|
|
1069
|
|
|
if ( isset( $field_names[1] ) ) { |
|
1070
|
|
|
$image_id = $field_names[1]; |
|
1071
|
|
|
} |
|
1072
|
|
|
|
|
1073
|
|
|
if ( isset( $field_names[2] ) ) { |
|
1074
|
|
|
$size = $field_names[2]; |
|
1075
|
|
|
} |
|
1076
|
|
|
|
|
1077
|
|
|
if ( ! empty( $image_id ) ) { |
|
1078
|
|
|
$value = pods_image_url( $image_id, $size, 0, true ); |
|
1079
|
|
|
|
|
1080
|
|
|
if ( ! empty( $value ) ) { |
|
1081
|
|
|
$object_field_found = true; |
|
1082
|
|
|
} |
|
1083
|
|
|
} |
|
1084
|
|
|
}//end if |
|
1085
|
|
|
} elseif ( 'user' === $this->pod_data['type'] && ! isset( $this->fields[ $params->name ] ) ) { |
|
1086
|
|
|
if ( ! isset( $this->fields['avatar'] ) && ( 'avatar' === $params->name || 0 === strpos( $params->name, 'avatar.' ) ) ) { |
|
1087
|
|
|
$size = null; |
|
1088
|
|
|
|
|
1089
|
|
|
if ( 0 === strpos( $params->name, 'avatar.' ) ) { |
|
1090
|
|
|
$field_names = explode( '.', $params->name ); |
|
1091
|
|
|
|
|
1092
|
|
|
if ( isset( $field_names[1] ) ) { |
|
1093
|
|
|
$size = (int) $field_names[1]; |
|
1094
|
|
|
} |
|
1095
|
|
|
} |
|
1096
|
|
|
|
|
1097
|
|
|
if ( 0 < $size ) { |
|
1098
|
|
|
$value = get_avatar( $this->id(), $size ); |
|
1099
|
|
|
} else { |
|
1100
|
|
|
$value = get_avatar( $this->id() ); |
|
1101
|
|
|
} |
|
1102
|
|
|
|
|
1103
|
|
|
$object_field_found = true; |
|
1104
|
|
|
} |
|
1105
|
|
|
} elseif ( 0 === strpos( $params->name, 'image_attachment.' ) ) { |
|
1106
|
|
|
$size = 'thumbnail'; |
|
1107
|
|
|
|
|
1108
|
|
|
$image_id = 0; |
|
1109
|
|
|
|
|
1110
|
|
|
$field_names = explode( '.', $params->name ); |
|
1111
|
|
|
|
|
1112
|
|
|
if ( isset( $field_names[1] ) ) { |
|
1113
|
|
|
$image_id = $field_names[1]; |
|
1114
|
|
|
} |
|
1115
|
|
|
|
|
1116
|
|
|
if ( isset( $field_names[2] ) ) { |
|
1117
|
|
|
$size = $field_names[2]; |
|
1118
|
|
|
} |
|
1119
|
|
|
|
|
1120
|
|
|
if ( ! empty( $image_id ) ) { |
|
1121
|
|
|
$value = pods_image( $image_id, $size, 0, null, true ); |
|
1122
|
|
|
|
|
1123
|
|
|
if ( ! empty( $value ) ) { |
|
1124
|
|
|
$object_field_found = true; |
|
1125
|
|
|
} |
|
1126
|
|
|
} |
|
1127
|
|
|
} elseif ( 0 === strpos( $params->name, 'image_attachment_url.' ) ) { |
|
1128
|
|
|
$size = 'thumbnail'; |
|
1129
|
|
|
|
|
1130
|
|
|
$image_id = 0; |
|
1131
|
|
|
|
|
1132
|
|
|
$field_names = explode( '.', $params->name ); |
|
1133
|
|
|
|
|
1134
|
|
|
if ( isset( $field_names[1] ) ) { |
|
1135
|
|
|
$image_id = $field_names[1]; |
|
1136
|
|
|
} |
|
1137
|
|
|
|
|
1138
|
|
|
if ( isset( $field_names[2] ) ) { |
|
1139
|
|
|
$size = $field_names[2]; |
|
1140
|
|
|
} |
|
1141
|
|
|
|
|
1142
|
|
|
if ( ! empty( $image_id ) ) { |
|
1143
|
|
|
$value = pods_image_url( $image_id, $size, 0, true ); |
|
1144
|
|
|
|
|
1145
|
|
|
if ( ! empty( $value ) ) { |
|
1146
|
|
|
$object_field_found = true; |
|
1147
|
|
|
} |
|
1148
|
|
|
} |
|
1149
|
|
|
}//end if |
|
1150
|
|
|
|
|
1151
|
|
|
if ( false === $object_field_found ) { |
|
1152
|
|
|
$params->traverse = array( $params->name ); |
|
1153
|
|
|
|
|
1154
|
|
|
if ( false !== strpos( $params->name, '.' ) ) { |
|
1155
|
|
|
$params->traverse = explode( '.', $params->name ); |
|
1156
|
|
|
|
|
1157
|
|
|
$params->name = $params->traverse[0]; |
|
1158
|
|
|
} |
|
1159
|
|
|
|
|
1160
|
|
|
if ( isset( $this->fields[ $params->name ], $this->fields[ $params->name ]['type'] ) ) { |
|
1161
|
|
|
/** |
|
1162
|
|
|
* Modify value returned by field() after its retrieved, but before its validated or formatted |
|
1163
|
|
|
* |
|
1164
|
|
|
* Filter name is set dynamically with name of field: "pods_pods_field_{field_name}" |
|
1165
|
|
|
* |
|
1166
|
|
|
* @since unknown |
|
1167
|
|
|
* |
|
1168
|
|
|
* @param array|string|null $value Value retrieved. |
|
1169
|
|
|
* @param array|object $row Current row being outputted. |
|
1170
|
|
|
* @param array $params Params array passed to field(). |
|
1171
|
|
|
* @param object|Pods $this Current Pods object. |
|
1172
|
|
|
*/ |
|
1173
|
|
|
$v = apply_filters( 'pods_pods_field_' . $this->fields[ $params->name ]['type'], null, $this->fields[ $params->name ], $this->row, $params, $this ); |
|
|
|
|
|
|
1174
|
|
|
|
|
1175
|
|
|
if ( null !== $v ) { |
|
1176
|
|
|
return $v; |
|
1177
|
|
|
} |
|
1178
|
|
|
} |
|
1179
|
|
|
|
|
1180
|
|
|
$simple = false; |
|
1181
|
|
|
|
|
1182
|
|
|
if ( isset( $this->fields[ $params->name ] ) ) { |
|
1183
|
|
|
if ( 'meta' === $this->pod_data['storage'] && ! in_array( $this->fields[ $params->name ]['type'], $tableless_field_types, true ) ) { |
|
1184
|
|
|
$simple = true; |
|
1185
|
|
|
} |
|
1186
|
|
|
|
|
1187
|
|
|
if ( in_array( $this->fields[ $params->name ]['type'], $tableless_field_types, true ) ) { |
|
1188
|
|
|
$params->raw = true; |
|
1189
|
|
|
|
|
1190
|
|
|
if ( 'pick' === $this->fields[ $params->name ]['type'] && in_array( $this->fields[ $params->name ]['pick_object'], $simple_tableless_objects, true ) ) { |
|
1191
|
|
|
$simple = true; |
|
1192
|
|
|
$params->single = true; |
|
1193
|
|
|
} |
|
1194
|
|
|
} elseif ( in_array( $this->fields[ $params->name ]['type'], array( |
|
1195
|
|
|
'boolean', |
|
1196
|
|
|
'number', |
|
1197
|
|
|
'currency', |
|
1198
|
|
|
), true ) ) { |
|
1199
|
|
|
$params->raw = true; |
|
1200
|
|
|
} |
|
1201
|
|
|
} |
|
1202
|
|
|
|
|
1203
|
|
|
$is_field_set = isset( $this->fields[ $params->name ] ); |
|
1204
|
|
|
$is_tableless_field = false; |
|
1205
|
|
|
|
|
1206
|
|
|
if ( $is_field_set ) { |
|
1207
|
|
|
$is_tableless_field = in_array( $this->fields[ $params->name ]['type'], $tableless_field_types, true ); |
|
1208
|
|
|
} |
|
1209
|
|
|
|
|
1210
|
|
|
if ( $simple || ! $is_field_set || ! $is_tableless_field ) { |
|
1211
|
|
|
if ( null === $params->single ) { |
|
1212
|
|
|
if ( $is_field_set && ! $is_tableless_field ) { |
|
1213
|
|
|
$params->single = true; |
|
1214
|
|
|
} else { |
|
1215
|
|
|
$params->single = false; |
|
1216
|
|
|
} |
|
1217
|
|
|
} |
|
1218
|
|
|
|
|
1219
|
|
|
$no_conflict = pods_no_conflict_check( $this->pod_data['type'] ); |
|
1220
|
|
|
|
|
1221
|
|
|
if ( ! $no_conflict ) { |
|
1222
|
|
|
pods_no_conflict_on( $this->pod_data['type'] ); |
|
1223
|
|
|
} |
|
1224
|
|
|
|
|
1225
|
|
|
if ( in_array( $this->pod_data['type'], array( |
|
1226
|
|
|
'post_type', |
|
1227
|
|
|
'media', |
|
1228
|
|
|
'taxonomy', |
|
1229
|
|
|
'user', |
|
1230
|
|
|
'comment', |
|
1231
|
|
|
), true ) ) { |
|
1232
|
|
|
$id = $this->id(); |
|
1233
|
|
|
|
|
1234
|
|
|
$metadata_type = $this->pod_data['type']; |
|
1235
|
|
|
|
|
1236
|
|
|
if ( in_array( $this->pod_data['type'], array( 'post_type', 'media' ), true ) ) { |
|
1237
|
|
|
$metadata_type = 'post'; |
|
1238
|
|
|
|
|
1239
|
|
|
// Support for WPML 'duplicated' translation handling. |
|
1240
|
|
|
if ( did_action( 'wpml_loaded' ) && apply_filters( 'wpml_is_translated_post_type', false, $this->pod_data['name'] ) ) { |
|
1241
|
|
|
$master_post_id = (int) apply_filters( 'wpml_master_post_from_duplicate', $id ); |
|
1242
|
|
|
|
|
1243
|
|
|
if ( 0 < $master_post_id ) { |
|
1244
|
|
|
$id = $master_post_id; |
|
1245
|
|
|
} |
|
1246
|
|
|
} |
|
1247
|
|
|
} elseif ( 'taxonomy' === $this->pod_data['type'] ) { |
|
1248
|
|
|
$metadata_type = 'term'; |
|
1249
|
|
|
} |
|
1250
|
|
|
|
|
1251
|
|
|
$value = get_metadata( $metadata_type, $id, $params->name, $params->single ); |
|
1252
|
|
|
|
|
1253
|
|
|
$single_multi = 'single'; |
|
1254
|
|
|
|
|
1255
|
|
|
if ( $is_field_set ) { |
|
1256
|
|
|
$single_multi = pods_v( $this->fields[ $params->name ]['type'] . '_format_type', $this->fields[ $params->name ]['options'], $single_multi ); |
|
1257
|
|
|
} |
|
1258
|
|
|
|
|
1259
|
|
|
if ( $simple && ! is_array( $value ) && 'single' !== $single_multi ) { |
|
1260
|
|
|
$value = get_metadata( $metadata_type, $id, $params->name ); |
|
1261
|
|
|
} |
|
1262
|
|
|
} elseif ( 'settings' === $this->pod_data['type'] ) { |
|
1263
|
|
|
$value = get_option( $this->pod_data['name'] . '_' . $params->name, null ); |
|
1264
|
|
|
}//end if |
|
1265
|
|
|
|
|
1266
|
|
|
// Handle Simple Relationships. |
|
1267
|
|
|
if ( $simple ) { |
|
1268
|
|
|
if ( null === $params->single ) { |
|
1269
|
|
|
$params->single = false; |
|
1270
|
|
|
} |
|
1271
|
|
|
|
|
1272
|
|
|
$value = PodsForm::field_method( 'pick', 'simple_value', $params->name, $value, $this->fields[ $params->name ], $this->pod_data, $this->id(), true ); |
|
1273
|
|
|
} |
|
1274
|
|
|
|
|
1275
|
|
|
if ( ! $no_conflict ) { |
|
1276
|
|
|
pods_no_conflict_off( $this->pod_data['type'] ); |
|
1277
|
|
|
} |
|
1278
|
|
|
} else { |
|
1279
|
|
|
// Dot-traversal. |
|
1280
|
|
|
$pod = $this->pod; |
|
1281
|
|
|
$ids = array( $this->id() ); |
|
1282
|
|
|
$all_fields = array(); |
|
1283
|
|
|
|
|
1284
|
|
|
$lookup = $params->traverse; |
|
1285
|
|
|
|
|
1286
|
|
|
// Get fields matching traversal names. |
|
1287
|
|
|
if ( ! empty( $lookup ) ) { |
|
1288
|
|
|
$fields = $this->api->load_fields( array( |
|
1289
|
|
|
'name' => $lookup, |
|
1290
|
|
|
'type' => $tableless_field_types, |
|
1291
|
|
|
'object_fields' => true, |
|
1292
|
|
|
// @todo support object fields too. |
|
1293
|
|
|
) ); |
|
1294
|
|
|
|
|
1295
|
|
|
if ( ! empty( $fields ) ) { |
|
1296
|
|
|
foreach ( $fields as $field ) { |
|
1297
|
|
|
if ( ! empty( $field ) ) { |
|
1298
|
|
|
if ( ! isset( $all_fields[ $field['pod'] ] ) ) { |
|
1299
|
|
|
$all_fields[ $field['pod'] ] = array(); |
|
1300
|
|
|
} |
|
1301
|
|
|
|
|
1302
|
|
|
$all_fields[ $field['pod'] ][ $field['name'] ] = $field; |
|
1303
|
|
|
} |
|
1304
|
|
|
} |
|
1305
|
|
|
} |
|
1306
|
|
|
|
|
1307
|
|
|
if ( ! empty( $this->pod_data['object_fields'] ) ) { |
|
1308
|
|
|
$object_fields = (array) $this->pod_data['object_fields']; |
|
1309
|
|
|
|
|
1310
|
|
|
foreach ( $object_fields as $object_field => $object_field_opt ) { |
|
1311
|
|
|
if ( in_array( $object_field_opt['type'], $tableless_field_types, true ) ) { |
|
1312
|
|
|
$all_fields[ $this->pod ][ $object_field ] = $object_field_opt; |
|
1313
|
|
|
} |
|
1314
|
|
|
} |
|
1315
|
|
|
} |
|
1316
|
|
|
}//end if |
|
1317
|
|
|
|
|
1318
|
|
|
$last_type = ''; |
|
1319
|
|
|
$last_object = ''; |
|
1320
|
|
|
$last_pick_val = ''; |
|
1321
|
|
|
|
|
1322
|
|
|
$single_multi = pods_v( $this->fields[ $params->name ]['type'] . '_format_type', $this->fields[ $params->name ]['options'], 'single' ); |
|
1323
|
|
|
|
|
1324
|
|
|
if ( 'multi' === $single_multi ) { |
|
1325
|
|
|
$limit = (int) pods_v( $this->fields[ $params->name ]['type'] . '_limit', $this->fields[ $params->name ]['options'], 0 ); |
|
1326
|
|
|
} else { |
|
1327
|
|
|
$limit = 1; |
|
1328
|
|
|
} |
|
1329
|
|
|
|
|
1330
|
|
|
// Loop through each traversal level. |
|
1331
|
|
|
foreach ( $params->traverse as $key => $field ) { |
|
1332
|
|
|
$last_loop = false; |
|
1333
|
|
|
|
|
1334
|
|
|
if ( count( $params->traverse ) <= ( $key + 1 ) ) { |
|
1335
|
|
|
$last_loop = true; |
|
1336
|
|
|
} |
|
1337
|
|
|
|
|
1338
|
|
|
$field_exists = isset( $all_fields[ $pod ][ $field ] ); |
|
1339
|
|
|
|
|
1340
|
|
|
$simple = false; |
|
1341
|
|
|
$last_options = array(); |
|
1342
|
|
|
|
|
1343
|
|
|
if ( $field_exists && 'pick' === $all_fields[ $pod ][ $field ]['type'] && in_array( $all_fields[ $pod ][ $field ]['pick_object'], $simple_tableless_objects, true ) ) { |
|
1344
|
|
|
$simple = true; |
|
1345
|
|
|
$last_options = $all_fields[ $pod ][ $field ]; |
|
1346
|
|
|
} |
|
1347
|
|
|
|
|
1348
|
|
|
// Tableless handler. |
|
1349
|
|
|
if ( $field_exists && ( ! $simple || ! in_array( $all_fields[ $pod ][ $field ]['type'], array( |
|
1350
|
|
|
'pick', |
|
1351
|
|
|
'taxonomy', |
|
1352
|
|
|
'comment', |
|
1353
|
|
|
), true ) ) ) { |
|
1354
|
|
|
$type = $all_fields[ $pod ][ $field ]['type']; |
|
1355
|
|
|
$pick_object = $all_fields[ $pod ][ $field ]['pick_object']; |
|
1356
|
|
|
$pick_val = $all_fields[ $pod ][ $field ]['pick_val']; |
|
1357
|
|
|
|
|
1358
|
|
|
if ( 'table' === $pick_object ) { |
|
1359
|
|
|
$pick_val = pods_v( 'pick_table', $all_fields[ $pod ][ $field ]['options'], $pick_val, true ); |
|
1360
|
|
|
} elseif ( '__current__' === $pick_val ) { |
|
1361
|
|
|
$pick_val = $pod; |
|
1362
|
|
|
} |
|
1363
|
|
|
|
|
1364
|
|
|
$last_limit = 0; |
|
1365
|
|
|
|
|
1366
|
|
|
if ( in_array( $type, $tableless_field_types, true ) ) { |
|
1367
|
|
|
$single_multi = pods_v( "{$type}_format_type", $all_fields[ $pod ][ $field ]['options'], 'single' ); |
|
1368
|
|
|
|
|
1369
|
|
|
if ( 'multi' === $single_multi ) { |
|
1370
|
|
|
$last_limit = (int) pods_v( "{$type}_limit", $all_fields[ $pod ][ $field ]['options'], 0 ); |
|
1371
|
|
|
} else { |
|
1372
|
|
|
$last_limit = 1; |
|
1373
|
|
|
} |
|
1374
|
|
|
} |
|
1375
|
|
|
|
|
1376
|
|
|
$last_type = $type; |
|
1377
|
|
|
$last_object = $pick_object; |
|
1378
|
|
|
$last_pick_val = $pick_val; |
|
1379
|
|
|
$last_options = $all_fields[ $pod ][ $field ]; |
|
1380
|
|
|
|
|
1381
|
|
|
// Temporary hack until there's some better handling here. |
|
1382
|
|
|
$last_limit *= count( $ids ); |
|
1383
|
|
|
|
|
1384
|
|
|
// Get related IDs. |
|
1385
|
|
|
if ( ! isset( $all_fields[ $pod ][ $field ]['pod_id'] ) ) { |
|
1386
|
|
|
$all_fields[ $pod ][ $field ]['pod_id'] = 0; |
|
1387
|
|
|
} |
|
1388
|
|
|
|
|
1389
|
|
|
if ( isset( $all_fields[ $pod ][ $field ]['id'] ) ) { |
|
1390
|
|
|
$ids = $this->api->lookup_related_items( $all_fields[ $pod ][ $field ]['id'], $all_fields[ $pod ][ $field ]['pod_id'], $ids, $all_fields[ $pod ][ $field ] ); |
|
1391
|
|
|
} |
|
1392
|
|
|
|
|
1393
|
|
|
// No items found. |
|
1394
|
|
|
if ( empty( $ids ) ) { |
|
1395
|
|
|
return false; |
|
1396
|
|
|
} elseif ( 0 < $last_limit ) { |
|
1397
|
|
|
// @todo This should return array() if not $params->single. |
|
1398
|
|
|
$ids = array_slice( $ids, 0, $last_limit ); |
|
1399
|
|
|
} |
|
1400
|
|
|
|
|
1401
|
|
|
// Get $pod if related to a Pod. |
|
1402
|
|
|
if ( ! empty( $pick_object ) && ( ! empty( $pick_val ) || in_array( $pick_object, array( |
|
1403
|
|
|
'user', |
|
1404
|
|
|
'media', |
|
1405
|
|
|
'comment', |
|
1406
|
|
|
), true ) ) ) { |
|
1407
|
|
|
if ( 'pod' === $pick_object ) { |
|
1408
|
|
|
$pod = $pick_val; |
|
1409
|
|
|
} else { |
|
1410
|
|
|
$check = $this->api->get_table_info( $pick_object, $pick_val ); |
|
1411
|
|
|
|
|
1412
|
|
|
if ( ! empty( $check ) && ! empty( $check['pod'] ) ) { |
|
1413
|
|
|
$pod = $check['pod']['name']; |
|
1414
|
|
|
} |
|
1415
|
|
|
} |
|
1416
|
|
|
} |
|
1417
|
|
|
} else { |
|
1418
|
|
|
// Assume last iteration. |
|
1419
|
|
|
if ( 0 === $key ) { |
|
1420
|
|
|
// Invalid field. |
|
1421
|
|
|
return false; |
|
1422
|
|
|
} |
|
1423
|
|
|
|
|
1424
|
|
|
$last_loop = true; |
|
1425
|
|
|
}//end if |
|
1426
|
|
|
|
|
1427
|
|
|
if ( $last_loop ) { |
|
1428
|
|
|
$object_type = $last_object; |
|
1429
|
|
|
$object = $last_pick_val; |
|
1430
|
|
|
|
|
1431
|
|
|
if ( in_array( $last_type, PodsForm::file_field_types(), true ) ) { |
|
1432
|
|
|
$object_type = 'media'; |
|
1433
|
|
|
$object = 'attachment'; |
|
1434
|
|
|
} |
|
1435
|
|
|
|
|
1436
|
|
|
$data = array(); |
|
1437
|
|
|
|
|
1438
|
|
|
$table = $this->api->get_table_info( $object_type, $object, null, null, $last_options ); |
|
1439
|
|
|
|
|
1440
|
|
|
$join = array(); |
|
1441
|
|
|
$where = array(); |
|
1442
|
|
|
|
|
1443
|
|
|
if ( ! empty( $table['join'] ) ) { |
|
1444
|
|
|
$join = (array) $table['join']; |
|
1445
|
|
|
} |
|
1446
|
|
|
|
|
1447
|
|
|
if ( ! empty( $ids ) || ! empty( $table['where'] ) ) { |
|
1448
|
|
|
foreach ( $ids as $id ) { |
|
1449
|
|
|
$where[ $id ] = '`t`.`' . $table['field_id'] . '` = ' . (int) $id; |
|
1450
|
|
|
} |
|
1451
|
|
|
|
|
1452
|
|
|
if ( ! empty( $where ) ) { |
|
1453
|
|
|
$where = array( implode( ' OR ', $where ) ); |
|
1454
|
|
|
} |
|
1455
|
|
|
|
|
1456
|
|
|
if ( ! empty( $table['where'] ) ) { |
|
1457
|
|
|
// @codingStandardsIgnoreLine. |
|
1458
|
|
|
$where = array_merge( $where, array_values( (array) $table['where'] ) ); |
|
1459
|
|
|
} |
|
1460
|
|
|
} |
|
1461
|
|
|
|
|
1462
|
|
|
/** |
|
1463
|
|
|
* Related object. |
|
1464
|
|
|
* |
|
1465
|
|
|
* @var $related_obj Pods|false |
|
1466
|
|
|
*/ |
|
1467
|
|
|
$related_obj = false; |
|
1468
|
|
|
|
|
1469
|
|
|
// Check if we can return the full object/array or if we need to traverse into it. |
|
1470
|
|
|
$is_field_output_full = false; |
|
1471
|
|
|
|
|
1472
|
|
|
if ( false !== $field_exists && ( in_array( $last_type, $tableless_field_types, true ) && ! $simple ) ) { |
|
1473
|
|
|
$is_field_output_full = true; |
|
1474
|
|
|
} |
|
1475
|
|
|
|
|
1476
|
|
|
if ( 'pod' === $object_type ) { |
|
1477
|
|
|
$related_obj = pods( $object, null, false ); |
|
1478
|
|
|
} elseif ( ! empty( $table['pod'] ) ) { |
|
1479
|
|
|
$related_obj = pods( $table['pod']['name'], null, false ); |
|
1480
|
|
|
} |
|
1481
|
|
|
|
|
1482
|
|
|
if ( $related_obj || ! empty( $table['table'] ) ) { |
|
1483
|
|
|
$sql = array( |
|
1484
|
|
|
'select' => '*, `t`.`' . $table['field_id'] . '` AS `pod_item_id`', |
|
1485
|
|
|
'table' => $table['table'], |
|
1486
|
|
|
'join' => $join, |
|
1487
|
|
|
'where' => $where, |
|
1488
|
|
|
'orderby' => $params->orderby, |
|
1489
|
|
|
'pagination' => false, |
|
1490
|
|
|
'search' => false, |
|
1491
|
|
|
'limit' => - 1, |
|
1492
|
|
|
'expires' => 180, |
|
1493
|
|
|
// @todo This could potentially cause issues if someone changes the data within this time and persistent storage is used. |
|
1494
|
|
|
); |
|
1495
|
|
|
|
|
1496
|
|
|
if ( ! empty( $table['where_default'] ) ) { |
|
1497
|
|
|
$sql['where_default'] = $table['where_default']; |
|
1498
|
|
|
} |
|
1499
|
|
|
|
|
1500
|
|
|
// Output types. |
|
1501
|
|
|
if ( in_array( $params->output, array( 'ids', 'objects', 'pods' ), true ) ) { |
|
1502
|
|
|
$sql['select'] = '`t`.`' . $table['field_id'] . '` AS `pod_item_id`'; |
|
1503
|
|
|
} elseif ( 'names' === $params->output && ! empty( $table['field_index'] ) ) { |
|
1504
|
|
|
$sql['select'] = '`t`.`' . $table['field_index'] . '` AS `pod_item_index`, `t`.`' . $table['field_id'] . '` AS `pod_item_id`'; |
|
1505
|
|
|
} |
|
1506
|
|
|
|
|
1507
|
|
|
if ( ! empty( $params->params ) && is_array( $params->params ) ) { |
|
1508
|
|
|
$where = $sql['where']; |
|
1509
|
|
|
|
|
1510
|
|
|
// @codingStandardsIgnoreLine. |
|
1511
|
|
|
$sql = array_merge( $sql, $params->params ); |
|
1512
|
|
|
|
|
1513
|
|
|
if ( isset( $params->params['where'] ) ) { |
|
1514
|
|
|
// @codingStandardsIgnoreLine. |
|
1515
|
|
|
$sql['where'] = array_merge( (array) $where, (array) $params->params['where'] ); |
|
1516
|
|
|
} |
|
1517
|
|
|
} |
|
1518
|
|
|
|
|
1519
|
|
|
$item_data = array(); |
|
1520
|
|
|
|
|
1521
|
|
|
if ( ! $related_obj ) { |
|
1522
|
|
|
if ( ! is_object( $this->alt_data ) ) { |
|
1523
|
|
|
$this->alt_data = pods_data( null, 0, true, true ); |
|
1524
|
|
|
} |
|
1525
|
|
|
|
|
1526
|
|
|
$item_data = $this->alt_data->select( $sql ); |
|
1527
|
|
|
} else { |
|
1528
|
|
|
// Support 'find' output ordering. |
|
1529
|
|
|
if ( $ids && 'find' === $params->output && $is_field_output_full && empty( $sql['orderby'] ) ) { |
|
|
|
|
|
|
1530
|
|
|
// Handle default orderby for ordering by the IDs. |
|
1531
|
|
|
$order_ids = implode( ', ', array_map( 'absint', $ids ) ); |
|
1532
|
|
|
|
|
1533
|
|
|
$sql['orderby'] = 'FIELD( `t`.`' . $table['field_id'] . '`, ' . $order_ids . ' )'; |
|
1534
|
|
|
} |
|
1535
|
|
|
|
|
1536
|
|
|
$related_obj->find( $sql ); |
|
1537
|
|
|
|
|
1538
|
|
|
// Support 'find' output. |
|
1539
|
|
|
if ( 'find' === $params->output && $is_field_output_full ) { |
|
1540
|
|
|
$data = $related_obj; |
|
1541
|
|
|
|
|
1542
|
|
|
$is_field_output_full = true; |
|
1543
|
|
|
} else { |
|
1544
|
|
|
$item_data = $related_obj->data(); |
|
1545
|
|
|
} |
|
1546
|
|
|
}//end if |
|
1547
|
|
|
|
|
1548
|
|
|
$items = array(); |
|
1549
|
|
|
|
|
1550
|
|
|
if ( ! empty( $item_data ) ) { |
|
1551
|
|
|
foreach ( $item_data as $item ) { |
|
1552
|
|
|
if ( is_array( $item ) ) { |
|
1553
|
|
|
$item = (object) $item; |
|
1554
|
|
|
} |
|
1555
|
|
|
|
|
1556
|
|
|
if ( empty( $item->pod_item_id ) ) { |
|
1557
|
|
|
continue; |
|
1558
|
|
|
} |
|
1559
|
|
|
|
|
1560
|
|
|
// Bypass pass field. |
|
1561
|
|
|
if ( isset( $item->user_pass ) ) { |
|
1562
|
|
|
unset( $item->user_pass ); |
|
1563
|
|
|
} |
|
1564
|
|
|
|
|
1565
|
|
|
// Get Item ID. |
|
1566
|
|
|
$item_id = $item->pod_item_id; |
|
1567
|
|
|
|
|
1568
|
|
|
// Output types. |
|
1569
|
|
|
if ( 'ids' === $params->output ) { |
|
1570
|
|
|
$item = (int) $item_id; |
|
1571
|
|
|
} elseif ( 'names' === $params->output && ! empty( $table['field_index'] ) ) { |
|
1572
|
|
|
$item = $item->pod_item_index; |
|
1573
|
|
|
} elseif ( 'objects' === $params->output ) { |
|
1574
|
|
|
if ( in_array( $object_type, array( 'post_type', 'media' ), true ) ) { |
|
1575
|
|
|
$item = get_post( $item_id ); |
|
1576
|
|
|
} elseif ( 'taxonomy' === $object_type ) { |
|
1577
|
|
|
$item = get_term( $item_id, $object ); |
|
1578
|
|
|
} elseif ( 'user' === $object_type ) { |
|
1579
|
|
|
$item = get_userdata( $item_id ); |
|
1580
|
|
|
|
|
1581
|
|
|
if ( ! empty( $item ) ) { |
|
1582
|
|
|
// Get other vars. |
|
1583
|
|
|
$roles = $item->roles; |
|
1584
|
|
|
$caps = $item->caps; |
|
1585
|
|
|
$allcaps = $item->allcaps; |
|
1586
|
|
|
|
|
1587
|
|
|
$item = $item->data; |
|
1588
|
|
|
|
|
1589
|
|
|
// Set other vars. |
|
1590
|
|
|
$item->roles = $roles; |
|
1591
|
|
|
$item->caps = $caps; |
|
1592
|
|
|
$item->allcaps = $allcaps; |
|
1593
|
|
|
|
|
1594
|
|
|
unset( $item->user_pass ); |
|
1595
|
|
|
} |
|
1596
|
|
|
} elseif ( 'comment' === $object_type ) { |
|
1597
|
|
|
$item = get_comment( $item_id ); |
|
1598
|
|
|
} else { |
|
1599
|
|
|
$item = (object) $item; |
|
1600
|
|
|
}//end if |
|
1601
|
|
|
} elseif ( 'pods' === $params->output ) { |
|
1602
|
|
|
if ( in_array( $object_type, array( 'user', 'media' ), true ) ) { |
|
1603
|
|
|
$item = pods( $object_type, (int) $item_id ); |
|
1604
|
|
|
} else { |
|
1605
|
|
|
$item = pods( $object, (int) $item_id ); |
|
1606
|
|
|
} |
|
1607
|
|
|
} else { |
|
1608
|
|
|
// arrays. |
|
1609
|
|
|
$item = get_object_vars( (object) $item ); |
|
1610
|
|
|
}//end if |
|
1611
|
|
|
|
|
1612
|
|
|
// Pass item data into $data. |
|
1613
|
|
|
$items[ $item_id ] = $item; |
|
1614
|
|
|
}//end foreach |
|
1615
|
|
|
|
|
1616
|
|
|
// Cleanup. |
|
1617
|
|
|
unset( $item_data ); |
|
1618
|
|
|
|
|
1619
|
|
|
// Return all of the data in the order expected. |
|
1620
|
|
|
if ( empty( $params->orderby ) ) { |
|
1621
|
|
|
foreach ( $ids as $id ) { |
|
1622
|
|
|
if ( isset( $items[ $id ] ) ) { |
|
1623
|
|
|
$data[ $id ] = $items[ $id ]; |
|
1624
|
|
|
} |
|
1625
|
|
|
} |
|
1626
|
|
|
} else { |
|
1627
|
|
|
// Use order set by orderby. |
|
1628
|
|
|
foreach ( $items as $id => $v ) { |
|
1629
|
|
|
// @codingStandardsIgnoreLine. |
|
1630
|
|
|
if ( in_array( $id, $ids ) ) { |
|
1631
|
|
|
$data[ $id ] = $v; |
|
1632
|
|
|
} |
|
1633
|
|
|
} |
|
1634
|
|
|
} |
|
1635
|
|
|
}//end if |
|
1636
|
|
|
}//end if |
|
1637
|
|
|
|
|
1638
|
|
|
if ( in_array( $last_type, $tableless_field_types, true ) || in_array( $last_type, array( |
|
1639
|
|
|
'boolean', |
|
1640
|
|
|
'number', |
|
1641
|
|
|
'currency', |
|
1642
|
|
|
), true ) ) { |
|
1643
|
|
|
$params->raw = true; |
|
1644
|
|
|
} |
|
1645
|
|
|
|
|
1646
|
|
|
if ( empty( $data ) ) { |
|
1647
|
|
|
$value = false; |
|
1648
|
|
|
} else { |
|
1649
|
|
|
$object_type = $table['type']; |
|
1650
|
|
|
|
|
1651
|
|
|
if ( in_array( $table['type'], array( 'post_type', 'attachment', 'media' ), true ) ) { |
|
1652
|
|
|
$object_type = 'post'; |
|
1653
|
|
|
} |
|
1654
|
|
|
|
|
1655
|
|
|
$no_conflict = true; |
|
1656
|
|
|
|
|
1657
|
|
|
if ( in_array( $object_type, array( |
|
1658
|
|
|
'post', |
|
1659
|
|
|
'taxonomy', |
|
1660
|
|
|
'user', |
|
1661
|
|
|
'comment', |
|
1662
|
|
|
'settings', |
|
1663
|
|
|
), true ) ) { |
|
1664
|
|
|
$no_conflict = pods_no_conflict_check( $object_type ); |
|
1665
|
|
|
|
|
1666
|
|
|
if ( ! $no_conflict ) { |
|
1667
|
|
|
pods_no_conflict_on( $object_type ); |
|
1668
|
|
|
} |
|
1669
|
|
|
} |
|
1670
|
|
|
|
|
1671
|
|
|
if ( $is_field_output_full ) { |
|
1672
|
|
|
// Return entire array. |
|
1673
|
|
|
$value = $data; |
|
1674
|
|
|
} else { |
|
1675
|
|
|
// Return an array of single column values. |
|
1676
|
|
|
$value = array(); |
|
1677
|
|
|
|
|
1678
|
|
|
foreach ( $data as $item_id => $item ) { |
|
1679
|
|
|
// $field is 123x123, needs to be _src.123x123 |
|
1680
|
|
|
$full_field = implode( '.', array_splice( $params->traverse, $key ) ); |
|
1681
|
|
|
|
|
1682
|
|
|
if ( is_array( $item ) && isset( $item[ $field ] ) ) { |
|
1683
|
|
|
if ( $table['field_id'] === $field ) { |
|
1684
|
|
|
$value[] = (int) $item[ $field ]; |
|
1685
|
|
|
} else { |
|
1686
|
|
|
$value[] = $item[ $field ]; |
|
1687
|
|
|
} |
|
1688
|
|
|
} elseif ( is_object( $item ) && isset( $item->{$field} ) ) { |
|
1689
|
|
|
if ( $table['field_id'] === $field ) { |
|
1690
|
|
|
$value[] = (int) $item->{$field}; |
|
1691
|
|
|
} else { |
|
1692
|
|
|
$value[] = $item->{$field}; |
|
1693
|
|
|
} |
|
1694
|
|
|
} elseif ( ! empty( $related_obj ) && 0 === strpos( $full_field, 'post_thumbnail' ) ) { |
|
1695
|
|
|
// We want to catch post_thumbnail and post_thumbnail_url here |
|
1696
|
|
|
$value[] = $related_obj->field( $full_field ); |
|
1697
|
|
|
} elseif ( ( ( false !== strpos( $full_field, '_src' ) || 'guid' === $field ) && ( in_array( $table['type'], array( |
|
1698
|
|
|
'attachment', |
|
1699
|
|
|
'media', |
|
1700
|
|
|
), true ) || in_array( $last_type, PodsForm::file_field_types(), true ) ) ) || ( in_array( $field, array( |
|
1701
|
|
|
'_link', |
|
1702
|
|
|
'detail_url', |
|
1703
|
|
|
), true ) || in_array( $field, array( |
|
1704
|
|
|
'permalink', |
|
1705
|
|
|
'the_permalink', |
|
1706
|
|
|
), true ) && in_array( $last_type, PodsForm::file_field_types(), true ) ) ) { |
|
1707
|
|
|
// @todo Refactor the above condition statement. |
|
1708
|
|
|
$size = 'full'; |
|
1709
|
|
|
|
|
1710
|
|
|
if ( false === strpos( 'image', get_post_mime_type( $item_id ) ) ) { |
|
1711
|
|
|
// No default sizes for non-images. |
|
1712
|
|
|
// When a size is defined this will be overwritten. |
|
1713
|
|
|
$size = null; |
|
1714
|
|
|
} |
|
1715
|
|
|
|
|
1716
|
|
|
if ( false !== strpos( $full_field, '_src.' ) && 5 < strlen( $full_field ) ) { |
|
1717
|
|
|
$size = substr( $full_field, 5 ); |
|
1718
|
|
|
} elseif ( false !== strpos( $full_field, '_src_relative.' ) && 14 < strlen( $full_field ) ) { |
|
1719
|
|
|
$size = substr( $full_field, 14 ); |
|
1720
|
|
|
} elseif ( false !== strpos( $full_field, '_src_schemeless.' ) && 16 < strlen( $full_field ) ) { |
|
1721
|
|
|
$size = substr( $full_field, 16 ); |
|
1722
|
|
|
} |
|
1723
|
|
|
|
|
1724
|
|
|
if ( $size ) { |
|
|
|
|
|
|
1725
|
|
|
$value_url = pods_image_url( $item_id, $size ); |
|
1726
|
|
|
} else { |
|
1727
|
|
|
$value_url = wp_get_attachment_url( $item_id ); |
|
1728
|
|
|
} |
|
1729
|
|
|
|
|
1730
|
|
|
if ( ! empty( $value_url ) ) { |
|
1731
|
|
|
if ( false !== strpos( $full_field, '_src_relative' ) ) { |
|
1732
|
|
|
$value_url_parsed = wp_parse_url( $value_url ); |
|
1733
|
|
|
$value_url = $value_url_parsed['path']; |
|
1734
|
|
|
} elseif ( false !== strpos( $full_field, '_src_schemeless' ) ) { |
|
1735
|
|
|
$value_url = str_replace( array( |
|
1736
|
|
|
'http://', |
|
1737
|
|
|
'https://', |
|
1738
|
|
|
), '//', $value_url ); |
|
1739
|
|
|
} |
|
1740
|
|
|
} |
|
1741
|
|
|
|
|
1742
|
|
|
if ( ! empty( $value_url ) ) { |
|
1743
|
|
|
$value[] = $value_url; |
|
1744
|
|
|
} |
|
1745
|
|
|
|
|
1746
|
|
|
$params->raw_display = true; |
|
1747
|
|
|
} elseif ( false !== strpos( $full_field, '_img' ) && ( in_array( $table['type'], array( |
|
1748
|
|
|
'attachment', |
|
1749
|
|
|
'media', |
|
1750
|
|
|
), true ) || in_array( $last_type, PodsForm::file_field_types(), true ) ) ) { |
|
1751
|
|
|
$size = 'full'; |
|
1752
|
|
|
|
|
1753
|
|
|
if ( false !== strpos( $full_field, '_img.' ) && 5 < strlen( $full_field ) ) { |
|
1754
|
|
|
$size = substr( $full_field, 5 ); |
|
1755
|
|
|
} |
|
1756
|
|
|
|
|
1757
|
|
|
$value[] = pods_image( $item_id, $size ); |
|
1758
|
|
|
|
|
1759
|
|
|
$params->raw_display = true; |
|
1760
|
|
|
} elseif ( in_array( $field, array( |
|
1761
|
|
|
'_link', |
|
1762
|
|
|
'detail_url', |
|
1763
|
|
|
), true ) || in_array( $field, array( 'permalink', 'the_permalink' ), true ) ) { |
|
1764
|
|
|
if ( 'pod' === $object_type ) { |
|
1765
|
|
|
if ( is_object( $related_obj ) ) { |
|
1766
|
|
|
$related_obj->fetch( $item_id ); |
|
1767
|
|
|
|
|
1768
|
|
|
$value[] = $related_obj->field( 'detail_url' ); |
|
1769
|
|
|
} else { |
|
1770
|
|
|
$value[] = ''; |
|
1771
|
|
|
} |
|
1772
|
|
|
} elseif ( 'post' === $object_type ) { |
|
1773
|
|
|
$value[] = get_permalink( $item_id ); |
|
1774
|
|
|
} elseif ( 'taxonomy' === $object_type ) { |
|
1775
|
|
|
$value[] = get_term_link( $item_id, $object ); |
|
1776
|
|
|
} elseif ( 'user' === $object_type ) { |
|
1777
|
|
|
$value[] = get_author_posts_url( $item_id ); |
|
1778
|
|
|
} elseif ( 'comment' === $object_type ) { |
|
1779
|
|
|
$value[] = get_comment_link( $item_id ); |
|
1780
|
|
|
} else { |
|
1781
|
|
|
$value[] = ''; |
|
1782
|
|
|
} |
|
1783
|
|
|
|
|
1784
|
|
|
$params->raw_display = true; |
|
1785
|
|
|
} elseif ( in_array( $object_type, array( |
|
1786
|
|
|
'post', |
|
1787
|
|
|
'taxonomy', |
|
1788
|
|
|
'user', |
|
1789
|
|
|
'comment', |
|
1790
|
|
|
), true ) ) { |
|
1791
|
|
|
$metadata_object_id = $item_id; |
|
1792
|
|
|
|
|
1793
|
|
|
$metadata_type = $object_type; |
|
1794
|
|
|
|
|
1795
|
|
|
if ( 'post' === $object_type ) { |
|
1796
|
|
|
// Support for WPML 'duplicated' translation handling. |
|
1797
|
|
|
if ( did_action( 'wpml_loaded' ) && apply_filters( 'wpml_is_translated_post_type', false, $object ) ) { |
|
1798
|
|
|
$master_post_id = (int) apply_filters( 'wpml_master_post_from_duplicate', $metadata_object_id ); |
|
1799
|
|
|
|
|
1800
|
|
|
if ( 0 < $master_post_id ) { |
|
1801
|
|
|
$metadata_object_id = $master_post_id; |
|
1802
|
|
|
} |
|
1803
|
|
|
} |
|
1804
|
|
|
} elseif ( 'taxonomy' === $object_type ) { |
|
1805
|
|
|
$metadata_type = 'term'; |
|
1806
|
|
|
} |
|
1807
|
|
|
|
|
1808
|
|
|
$value[] = get_metadata( $metadata_type, $metadata_object_id, $field, true ); |
|
1809
|
|
|
} elseif ( 'settings' === $object_type ) { |
|
1810
|
|
|
$value[] = get_option( $object . '_' . $field ); |
|
1811
|
|
|
}//end if |
|
1812
|
|
|
}//end foreach |
|
1813
|
|
|
}//end if |
|
1814
|
|
|
|
|
1815
|
|
|
if ( ! $no_conflict && in_array( $object_type, array( |
|
1816
|
|
|
'post', |
|
1817
|
|
|
'taxonomy', |
|
1818
|
|
|
'user', |
|
1819
|
|
|
'comment', |
|
1820
|
|
|
'settings', |
|
1821
|
|
|
), true ) ) { |
|
1822
|
|
|
pods_no_conflict_off( $object_type ); |
|
1823
|
|
|
} |
|
1824
|
|
|
|
|
1825
|
|
|
// Handle Simple Relationships. |
|
1826
|
|
|
if ( $simple ) { |
|
1827
|
|
|
if ( null === $params->single ) { |
|
1828
|
|
|
$params->single = false; |
|
1829
|
|
|
} |
|
1830
|
|
|
|
|
1831
|
|
|
$value = PodsForm::field_method( 'pick', 'simple_value', $field, $value, $last_options, $all_fields[ $pod ], 0, true ); |
|
1832
|
|
|
} elseif ( false === $params->in_form && ! empty( $value ) && is_array( $value ) ) { |
|
1833
|
|
|
$value = array_values( $value ); |
|
1834
|
|
|
} |
|
1835
|
|
|
|
|
1836
|
|
|
// Return a single column value. |
|
1837
|
|
|
if ( false === $params->in_form && 1 === $limit && ! empty( $value ) && is_array( $value ) && 1 === count( $value ) ) { |
|
1838
|
|
|
$value = current( $value ); |
|
1839
|
|
|
} |
|
1840
|
|
|
}//end if |
|
1841
|
|
|
|
|
1842
|
|
|
if ( $last_options ) { |
|
1843
|
|
|
$last_field_data = $last_options; |
|
1844
|
|
|
} |
|
1845
|
|
|
|
|
1846
|
|
|
break; |
|
1847
|
|
|
}//end if |
|
1848
|
|
|
}//end foreach |
|
1849
|
|
|
}//end if |
|
1850
|
|
|
}//end if |
|
1851
|
|
|
}//end if |
|
1852
|
|
|
|
|
1853
|
|
|
if ( ! empty( $params->traverse ) && 1 < count( $params->traverse ) ) { |
|
1854
|
|
|
$field_names = implode( '.', $params->traverse ); |
|
1855
|
|
|
|
|
1856
|
|
|
$this->row[ $field_names ] = $value; |
|
1857
|
|
|
} elseif ( 'arrays' !== $params->output && in_array( $field_data['type'], $tableless_field_types, true ) ) { |
|
1858
|
|
|
$this->row[ '_' . $params->output . '_' . $params->full_name ] = $value; |
|
1859
|
|
|
} elseif ( 'arrays' === $params->output || ! in_array( $field_data['type'], $tableless_field_types, true ) ) { |
|
1860
|
|
|
$this->row[ $params->full_name ] = $value; |
|
1861
|
|
|
} |
|
1862
|
|
|
|
|
1863
|
|
|
if ( true === $params->single && is_array( $value ) && 1 === count( $value ) ) { |
|
1864
|
|
|
$value = current( $value ); |
|
1865
|
|
|
} |
|
1866
|
|
|
|
|
1867
|
|
|
if ( ! empty( $last_field_data ) ) { |
|
1868
|
|
|
$field_data = $last_field_data; |
|
1869
|
|
|
} |
|
1870
|
|
|
|
|
1871
|
|
|
// @todo Expand this into traversed fields too. |
|
1872
|
|
|
if ( ! empty( $field_data ) && ( $params->display || ! $params->raw ) && ! $params->in_form && ! $params->raw_display ) { |
|
1873
|
|
|
if ( $params->display || ( ( $params->get_meta || $params->deprecated ) && ! in_array( $field_data['type'], $tableless_field_types, true ) ) ) { |
|
1874
|
|
|
$field_data['options'] = pods_v( 'options', $field_data, array(), true ); |
|
1875
|
|
|
|
|
1876
|
|
|
$post_temp = false; |
|
1877
|
|
|
$old_post = null; |
|
1878
|
|
|
$old_post_id = null; |
|
1879
|
|
|
|
|
1880
|
|
|
if ( empty( $GLOBALS['post'] ) && 'post_type' === pods_v( 'type', $this->pod_data ) && 0 < $this->id() ) { |
|
1881
|
|
|
global $post_ID, $post; |
|
|
|
|
|
|
1882
|
|
|
|
|
1883
|
|
|
$post_temp = true; |
|
1884
|
|
|
|
|
1885
|
|
|
$old_post = $post; |
|
1886
|
|
|
$old_post_id = $post_ID; |
|
1887
|
|
|
|
|
1888
|
|
|
// @codingStandardsIgnoreLine. |
|
1889
|
|
|
$post = get_post( $this->id() ); |
|
1890
|
|
|
// @codingStandardsIgnoreLine. |
|
1891
|
|
|
$post_ID = $this->id(); |
|
1892
|
|
|
} |
|
1893
|
|
|
|
|
1894
|
|
|
$filter = pods_v( 'display_filter', $field_data['options'] ); |
|
1895
|
|
|
|
|
1896
|
|
|
if ( 0 < strlen( $filter ) ) { |
|
1897
|
|
|
$args = array( |
|
1898
|
|
|
$filter, |
|
1899
|
|
|
$value, |
|
1900
|
|
|
); |
|
1901
|
|
|
|
|
1902
|
|
|
$filter_args = pods_v( 'display_filter_args', $field_data['options'] ); |
|
1903
|
|
|
|
|
1904
|
|
|
if ( ! empty( $filter_args ) ) { |
|
1905
|
|
|
$args = array_merge( $args, compact( $filter_args ) ); |
|
1906
|
|
|
} |
|
1907
|
|
|
|
|
1908
|
|
|
$value = call_user_func_array( 'apply_filters', $args ); |
|
1909
|
|
|
} elseif ( 1 === (int) pods_v( 'display_process', $field_data['options'], 1 ) ) { |
|
1910
|
|
|
$value = PodsForm::display( $field_data['type'], $value, $params->name, array_merge( $field_data, $field_data['options'] ), $this->pod_data, $this->id() ); |
|
1911
|
|
|
} |
|
1912
|
|
|
|
|
1913
|
|
|
if ( $post_temp ) { |
|
1914
|
|
|
// @codingStandardsIgnoreLine. |
|
1915
|
|
|
$post = $old_post; |
|
1916
|
|
|
// @codingStandardsIgnoreLine. |
|
1917
|
|
|
$post_ID = $old_post_id; |
|
1918
|
|
|
} |
|
1919
|
|
|
} else { |
|
1920
|
|
|
$value = PodsForm::value( $field_data['type'], $value, $params->name, array_merge( $field_data, $field_data['options'] ), $this->pod_data, $this->id() ); |
|
1921
|
|
|
}//end if |
|
1922
|
|
|
}//end if |
|
1923
|
|
|
|
|
1924
|
|
|
/** |
|
1925
|
|
|
* Modify value returned by field() directly before output. |
|
1926
|
|
|
* |
|
1927
|
|
|
* Will not run if value was null |
|
1928
|
|
|
* |
|
1929
|
|
|
* @since unknown |
|
1930
|
|
|
* |
|
1931
|
|
|
* @param array|string|null $value Value to be returned. |
|
1932
|
|
|
* @param array|object $row Current row being outputted. |
|
1933
|
|
|
* @param array $params Params array passed to field(). |
|
1934
|
|
|
* @param object|Pods $this Current Pods object. |
|
1935
|
|
|
*/ |
|
1936
|
|
|
$value = apply_filters( 'pods_pods_field', $value, $this->row, $params, $this ); |
|
1937
|
|
|
|
|
1938
|
|
|
return $value; |
|
1939
|
|
|
} |
|
1940
|
|
|
|
|
1941
|
|
|
/** |
|
1942
|
|
|
* Check if an item field has a specific value in it |
|
1943
|
|
|
* |
|
1944
|
|
|
* @param string $field Field name. |
|
1945
|
|
|
* @param mixed $value Value to check. |
|
1946
|
|
|
* @param int $id (optional) ID of the pod item to check. |
|
|
|
|
|
|
1947
|
|
|
* |
|
1948
|
|
|
* @return bool Whether the value was found |
|
|
|
|
|
|
1949
|
|
|
* |
|
1950
|
|
|
* @since 2.3.3 |
|
1951
|
|
|
*/ |
|
1952
|
|
|
public function has( $field, $value, $id = null ) { |
|
1953
|
|
|
|
|
1954
|
|
|
$pod =& $this; |
|
1955
|
|
|
|
|
1956
|
|
|
if ( null === $id ) { |
|
1957
|
|
|
$id = $this->id(); |
|
1958
|
|
|
// @codingStandardsIgnoreLine. |
|
1959
|
|
|
} elseif ( $id != $this->id() ) { |
|
1960
|
|
|
$pod = pods( $this->pod, $id ); |
|
1961
|
|
|
} |
|
1962
|
|
|
|
|
1963
|
|
|
$this->do_hook( 'has', $field, $value, $id ); |
|
1964
|
|
|
|
|
1965
|
|
|
if ( ! isset( $this->fields[ $field ] ) ) { |
|
1966
|
|
|
return false; |
|
1967
|
|
|
} |
|
1968
|
|
|
|
|
1969
|
|
|
// Tableless fields. |
|
1970
|
|
|
if ( in_array( $this->fields[ $field ]['type'], PodsForm::tableless_field_types(), true ) ) { |
|
1971
|
|
|
if ( ! is_array( $value ) ) { |
|
1972
|
|
|
$value = explode( ',', $value ); |
|
1973
|
|
|
} |
|
1974
|
|
|
|
|
1975
|
|
|
if ( 'pick' === $this->fields[ $field ]['type'] && in_array( $this->fields[ $field ]['pick_object'], PodsForm::simple_tableless_objects(), true ) ) { |
|
1976
|
|
|
$current_value = $pod->raw( $field ); |
|
1977
|
|
|
|
|
1978
|
|
|
if ( ! empty( $current_value ) ) { |
|
1979
|
|
|
$current_value = (array) $current_value; |
|
1980
|
|
|
} |
|
1981
|
|
|
|
|
1982
|
|
|
foreach ( $current_value as $v ) { |
|
1983
|
|
|
// @codingStandardsIgnoreLine. |
|
1984
|
|
|
if ( in_array( $v, $value ) ) { |
|
1985
|
|
|
return true; |
|
1986
|
|
|
} |
|
1987
|
|
|
} |
|
1988
|
|
|
} else { |
|
1989
|
|
|
$related_ids = $this->api->lookup_related_items( $this->fields[ $field ]['id'], $this->pod_data['id'], $id, $this->fields[ $field ], $this->pod_data ); |
|
1990
|
|
|
|
|
1991
|
|
|
foreach ( $value as $k => $v ) { |
|
1992
|
|
|
if ( ! preg_match( '/[^\D]/', $v ) ) { |
|
1993
|
|
|
$value[ $k ] = (int) $v; |
|
1994
|
|
|
} |
|
1995
|
|
|
|
|
1996
|
|
|
// @todo Convert slugs into IDs. |
|
1997
|
|
|
} |
|
1998
|
|
|
|
|
1999
|
|
|
foreach ( $related_ids as $v ) { |
|
2000
|
|
|
// @codingStandardsIgnoreLine. |
|
2001
|
|
|
if ( in_array( $v, $value ) ) { |
|
2002
|
|
|
return true; |
|
2003
|
|
|
} |
|
2004
|
|
|
} |
|
2005
|
|
|
}//end if |
|
2006
|
|
|
} elseif ( in_array( $this->fields[ $field ]['type'], PodsForm::text_field_types(), true ) ) { |
|
2007
|
|
|
// Text fields. |
|
2008
|
|
|
$current_value = $pod->raw( $field ); |
|
2009
|
|
|
|
|
2010
|
|
|
if ( 0 < strlen( $current_value ) ) { |
|
2011
|
|
|
return stripos( $current_value, $value ); |
|
2012
|
|
|
} |
|
2013
|
|
|
} else { |
|
2014
|
|
|
// All other fields. |
|
2015
|
|
|
return $this->is( $field, $value, $id ); |
|
2016
|
|
|
}//end if |
|
2017
|
|
|
|
|
2018
|
|
|
return false; |
|
2019
|
|
|
} |
|
2020
|
|
|
|
|
2021
|
|
|
/** |
|
2022
|
|
|
* Check if an item field is a specific value |
|
2023
|
|
|
* |
|
2024
|
|
|
* @param string $field Field name. |
|
2025
|
|
|
* @param mixed $value Value to check. |
|
2026
|
|
|
* @param int $id (optional) ID of the pod item to check. |
|
|
|
|
|
|
2027
|
|
|
* |
|
2028
|
|
|
* @return bool Whether the value was found |
|
2029
|
|
|
* |
|
2030
|
|
|
* @since 2.3.3 |
|
2031
|
|
|
*/ |
|
2032
|
|
|
public function is( $field, $value, $id = null ) { |
|
|
|
|
|
|
2033
|
|
|
|
|
2034
|
|
|
$pod =& $this; |
|
2035
|
|
|
|
|
2036
|
|
|
if ( null === $id ) { |
|
2037
|
|
|
$id = $this->id(); |
|
2038
|
|
|
// @codingStandardsIgnoreLine. |
|
2039
|
|
|
} elseif ( $id != $this->id() ) { |
|
2040
|
|
|
$pod = pods( $this->pod, $id ); |
|
2041
|
|
|
} |
|
2042
|
|
|
|
|
2043
|
|
|
$this->do_hook( 'is', $field, $value, $id ); |
|
2044
|
|
|
|
|
2045
|
|
|
if ( ! isset( $this->fields[ $field ] ) ) { |
|
2046
|
|
|
return false; |
|
2047
|
|
|
} |
|
2048
|
|
|
|
|
2049
|
|
|
// Tableless fields. |
|
2050
|
|
|
if ( in_array( $this->fields[ $field ]['type'], PodsForm::tableless_field_types(), true ) ) { |
|
2051
|
|
|
if ( ! is_array( $value ) ) { |
|
2052
|
|
|
$value = explode( ',', $value ); |
|
2053
|
|
|
} |
|
2054
|
|
|
|
|
2055
|
|
|
$current_value = array(); |
|
2056
|
|
|
|
|
2057
|
|
|
if ( 'pick' === $this->fields[ $field ]['type'] && in_array( $this->fields[ $field ]['pick_object'], PodsForm::simple_tableless_objects(), true ) ) { |
|
2058
|
|
|
$current_value = $pod->raw( $field ); |
|
2059
|
|
|
|
|
2060
|
|
|
if ( ! empty( $current_value ) ) { |
|
2061
|
|
|
$current_value = (array) $current_value; |
|
2062
|
|
|
} |
|
2063
|
|
|
|
|
2064
|
|
|
foreach ( $current_value as $v ) { |
|
2065
|
|
|
// @codingStandardsIgnoreLine. |
|
2066
|
|
|
if ( in_array( $v, $value ) ) { |
|
2067
|
|
|
return true; |
|
2068
|
|
|
} |
|
2069
|
|
|
} |
|
2070
|
|
|
} else { |
|
2071
|
|
|
$related_ids = $this->api->lookup_related_items( $this->fields[ $field ]['id'], $this->pod_data['id'], $id, $this->fields[ $field ], $this->pod_data ); |
|
2072
|
|
|
|
|
2073
|
|
|
foreach ( $value as $k => $v ) { |
|
2074
|
|
|
if ( ! preg_match( '/[^\D]/', $v ) ) { |
|
2075
|
|
|
$value[ $k ] = (int) $v; |
|
2076
|
|
|
} |
|
2077
|
|
|
|
|
2078
|
|
|
// @todo Convert slugs into IDs. |
|
2079
|
|
|
} |
|
2080
|
|
|
|
|
2081
|
|
|
foreach ( $related_ids as $v ) { |
|
2082
|
|
|
// @codingStandardsIgnoreLine. |
|
2083
|
|
|
if ( in_array( $v, $value ) ) { |
|
2084
|
|
|
return true; |
|
2085
|
|
|
} |
|
2086
|
|
|
} |
|
2087
|
|
|
}//end if |
|
2088
|
|
|
|
|
2089
|
|
|
if ( ! empty( $current_value ) ) { |
|
2090
|
|
|
$current_value = array_filter( array_unique( $current_value ) ); |
|
2091
|
|
|
} else { |
|
2092
|
|
|
$current_value = array(); |
|
2093
|
|
|
} |
|
2094
|
|
|
|
|
2095
|
|
|
if ( ! empty( $value ) ) { |
|
2096
|
|
|
$value = array_filter( array_unique( $value ) ); |
|
2097
|
|
|
} else { |
|
2098
|
|
|
$value = array(); |
|
2099
|
|
|
} |
|
2100
|
|
|
|
|
2101
|
|
|
sort( $current_value ); |
|
2102
|
|
|
sort( $value ); |
|
2103
|
|
|
|
|
2104
|
|
|
if ( $value === $current_value ) { |
|
2105
|
|
|
return true; |
|
2106
|
|
|
} |
|
2107
|
|
|
} elseif ( in_array( $this->fields[ $field ]['type'], PodsForm::number_field_types(), true ) ) { |
|
2108
|
|
|
// Number fields. |
|
2109
|
|
|
$current_value = $pod->raw( $field ); |
|
2110
|
|
|
|
|
2111
|
|
|
if ( (float) $current_value === (float) $value ) { |
|
2112
|
|
|
return true; |
|
2113
|
|
|
} |
|
2114
|
|
|
} elseif ( in_array( $this->fields[ $field ]['type'], PodsForm::date_field_types(), true ) ) { |
|
2115
|
|
|
// Date fields. |
|
2116
|
|
|
$current_value = $pod->raw( $field ); |
|
2117
|
|
|
|
|
2118
|
|
|
if ( 0 < strlen( $current_value ) ) { |
|
2119
|
|
|
if ( strtotime( $current_value ) === strtotime( $value ) ) { |
|
2120
|
|
|
return true; |
|
2121
|
|
|
} |
|
2122
|
|
|
} elseif ( empty( $value ) ) { |
|
2123
|
|
|
return true; |
|
2124
|
|
|
} |
|
2125
|
|
|
} elseif ( in_array( $this->fields[ $field ]['type'], PodsForm::text_field_types(), true ) ) { |
|
2126
|
|
|
// Text fields. |
|
2127
|
|
|
$current_value = $pod->raw( $field ); |
|
2128
|
|
|
|
|
2129
|
|
|
if ( (string) $current_value === (string) $value ) { |
|
2130
|
|
|
return true; |
|
2131
|
|
|
} |
|
2132
|
|
|
} else { |
|
2133
|
|
|
// All other fields. |
|
2134
|
|
|
$current_value = $pod->raw( $field ); |
|
2135
|
|
|
|
|
2136
|
|
|
if ( $current_value === $value ) { |
|
2137
|
|
|
return true; |
|
2138
|
|
|
} |
|
2139
|
|
|
}//end if |
|
2140
|
|
|
|
|
2141
|
|
|
return false; |
|
2142
|
|
|
} |
|
2143
|
|
|
|
|
2144
|
|
|
/** |
|
2145
|
|
|
* Return the item ID |
|
2146
|
|
|
* |
|
2147
|
|
|
* @return int |
|
2148
|
|
|
* @since 2.0 |
|
2149
|
|
|
*/ |
|
2150
|
|
|
public function id() { |
|
|
|
|
|
|
2151
|
|
|
|
|
2152
|
|
|
if ( isset( $this->data->row, $this->data->row['id'] ) ) { |
|
2153
|
|
|
// If we already have data loaded return that ID. |
|
2154
|
|
|
return $this->data->row['id']; |
|
2155
|
|
|
} |
|
2156
|
|
|
|
|
2157
|
|
|
return $this->field( $this->data->field_id ); |
|
2158
|
|
|
} |
|
2159
|
|
|
|
|
2160
|
|
|
/** |
|
2161
|
|
|
* Return the previous item ID, loops at the last id to return the first |
|
2162
|
|
|
* |
|
2163
|
|
|
* @param int|null $id ID to start from. |
|
2164
|
|
|
* @param array|object|null $params_override Override the find() parameters. |
|
2165
|
|
|
* |
|
2166
|
|
|
* @return int |
|
2167
|
|
|
* @since 2.0 |
|
2168
|
|
|
*/ |
|
2169
|
|
|
public function prev_id( $id = null, $params_override = null ) { |
|
2170
|
|
|
|
|
2171
|
|
|
if ( null === $id ) { |
|
2172
|
|
|
$id = $this->id(); |
|
2173
|
|
|
} |
|
2174
|
|
|
|
|
2175
|
|
|
$id = (int) $id; |
|
2176
|
|
|
|
|
2177
|
|
|
$params = array( |
|
2178
|
|
|
'select' => "`t`.`{$this->data->field_id}`", |
|
2179
|
|
|
'where' => "`t`.`{$this->data->field_id}` < {$id}", |
|
2180
|
|
|
'orderby' => "`t`.`{$this->data->field_id}` DESC", |
|
2181
|
|
|
'limit' => 1, |
|
2182
|
|
|
); |
|
2183
|
|
|
|
|
2184
|
|
|
if ( ! empty( $params_override ) || ! empty( $this->params ) ) { |
|
2185
|
|
|
if ( ! empty( $params_override ) ) { |
|
2186
|
|
|
$params = $params_override; |
|
2187
|
|
|
} elseif ( ! empty( $this->params ) ) { |
|
2188
|
|
|
$params = $this->params; |
|
2189
|
|
|
} |
|
2190
|
|
|
|
|
2191
|
|
|
if ( is_object( $params ) ) { |
|
2192
|
|
|
$params = get_object_vars( $params ); |
|
2193
|
|
|
} |
|
2194
|
|
|
|
|
2195
|
|
|
if ( 0 < $id ) { |
|
2196
|
|
|
if ( isset( $params['where'] ) && ! empty( $params['where'] ) ) { |
|
2197
|
|
|
$params['where'] = (array) $params['where']; |
|
2198
|
|
|
$params['where'][] = "`t`.`{$this->data->field_id}` < {$id}"; |
|
2199
|
|
|
} else { |
|
2200
|
|
|
$params['where'] = "`t`.`{$this->data->field_id}` < {$id}"; |
|
2201
|
|
|
} |
|
2202
|
|
|
} elseif ( isset( $params['offset'] ) && 0 < $params['offset'] ) { |
|
2203
|
|
|
$params['offset'] --; |
|
2204
|
|
|
} elseif ( 0 < $this->row_number && ! isset( $params['offset'] ) && ! empty( $this->params ) ) { |
|
2205
|
|
|
$params['offset'] = $this->row_number - 1; |
|
2206
|
|
|
} else { |
|
2207
|
|
|
return 0; |
|
2208
|
|
|
} |
|
2209
|
|
|
|
|
2210
|
|
|
if ( isset( $params['orderby'] ) && ! empty( $params['orderby'] ) ) { |
|
2211
|
|
|
if ( is_array( $params['orderby'] ) ) { |
|
2212
|
|
|
foreach ( $params['orderby'] as $orderby => $dir ) { |
|
2213
|
|
|
$dir = strtoupper( $dir ); |
|
2214
|
|
|
|
|
2215
|
|
|
if ( ! in_array( $dir, array( 'ASC', 'DESC' ), true ) ) { |
|
2216
|
|
|
continue; |
|
2217
|
|
|
} |
|
2218
|
|
|
|
|
2219
|
|
|
if ( 'ASC' === $dir ) { |
|
2220
|
|
|
$params['orderby'][ $orderby ] = 'DESC'; |
|
2221
|
|
|
} else { |
|
2222
|
|
|
$params['orderby'][ $orderby ] = 'ASC'; |
|
2223
|
|
|
} |
|
2224
|
|
|
} |
|
2225
|
|
|
|
|
2226
|
|
|
$params['orderby'][ $this->data->field_id ] = 'DESC'; |
|
2227
|
|
|
} elseif ( "`t`.`{$this->data->field_id}` DESC" !== $params['orderby'] ) { |
|
2228
|
|
|
$params['orderby'] .= ", `t`.`{$this->data->field_id}` DESC"; |
|
2229
|
|
|
} |
|
2230
|
|
|
}//end if |
|
2231
|
|
|
|
|
2232
|
|
|
$params['select'] = "`t`.`{$this->data->field_id}`"; |
|
2233
|
|
|
$params['limit'] = 1; |
|
2234
|
|
|
}//end if |
|
2235
|
|
|
|
|
2236
|
|
|
$pod = pods( $this->pod, $params ); |
|
2237
|
|
|
|
|
2238
|
|
|
$new_id = 0; |
|
2239
|
|
|
|
|
2240
|
|
|
if ( $pod->fetch() ) { |
|
2241
|
|
|
$new_id = $pod->id(); |
|
2242
|
|
|
} |
|
2243
|
|
|
|
|
2244
|
|
|
$new_id = $this->do_hook( 'prev_id', $new_id, $id, $pod, $params_override ); |
|
2245
|
|
|
|
|
2246
|
|
|
return $new_id; |
|
2247
|
|
|
} |
|
2248
|
|
|
|
|
2249
|
|
|
/** |
|
2250
|
|
|
* Return the next item ID, loops at the first id to return the last |
|
2251
|
|
|
* |
|
2252
|
|
|
* @param int|null $id ID to start from. |
|
2253
|
|
|
* @param array|object|null $params_override Override the find() parameters. |
|
2254
|
|
|
* |
|
2255
|
|
|
* @return int |
|
2256
|
|
|
* @since 2.0 |
|
2257
|
|
|
*/ |
|
2258
|
|
|
public function next_id( $id = null, $params_override = null ) { |
|
2259
|
|
|
|
|
2260
|
|
|
if ( null === $id ) { |
|
2261
|
|
|
$id = $this->id(); |
|
2262
|
|
|
} |
|
2263
|
|
|
|
|
2264
|
|
|
$id = (int) $id; |
|
2265
|
|
|
|
|
2266
|
|
|
$params = array( |
|
2267
|
|
|
'select' => "`t`.`{$this->data->field_id}`", |
|
2268
|
|
|
'where' => "{$id} < `t`.`{$this->data->field_id}`", |
|
2269
|
|
|
'orderby' => "`t`.`{$this->data->field_id}` ASC", |
|
2270
|
|
|
'limit' => 1, |
|
2271
|
|
|
); |
|
2272
|
|
|
|
|
2273
|
|
|
if ( ! empty( $params_override ) || ! empty( $this->params ) ) { |
|
2274
|
|
|
if ( ! empty( $params_override ) ) { |
|
2275
|
|
|
$params = $params_override; |
|
2276
|
|
|
} elseif ( ! empty( $this->params ) ) { |
|
2277
|
|
|
$params = $this->params; |
|
2278
|
|
|
} |
|
2279
|
|
|
|
|
2280
|
|
|
if ( is_object( $params ) ) { |
|
2281
|
|
|
$params = get_object_vars( $params ); |
|
2282
|
|
|
} |
|
2283
|
|
|
|
|
2284
|
|
|
if ( 0 < $id ) { |
|
2285
|
|
|
if ( isset( $params['where'] ) && ! empty( $params['where'] ) ) { |
|
2286
|
|
|
$params['where'] = (array) $params['where']; |
|
2287
|
|
|
$params['where'][] = "{$id} < `t`.`{$this->data->field_id}`"; |
|
2288
|
|
|
} else { |
|
2289
|
|
|
$params['where'] = "{$id} < `t`.`{$this->data->field_id}`"; |
|
2290
|
|
|
} |
|
2291
|
|
|
} elseif ( ! isset( $params['offset'] ) ) { |
|
2292
|
|
|
if ( ! empty( $this->params ) && - 1 < $this->row_number ) { |
|
2293
|
|
|
$params['offset'] = $this->row_number + 1; |
|
2294
|
|
|
} else { |
|
2295
|
|
|
$params['offset'] = 1; |
|
2296
|
|
|
} |
|
2297
|
|
|
} else { |
|
2298
|
|
|
$params['offset'] ++; |
|
2299
|
|
|
} |
|
2300
|
|
|
|
|
2301
|
|
|
$params['select'] = "`t`.`{$this->data->field_id}`"; |
|
2302
|
|
|
$params['limit'] = 1; |
|
2303
|
|
|
}//end if |
|
2304
|
|
|
|
|
2305
|
|
|
$pod = pods( $this->pod, $params ); |
|
2306
|
|
|
|
|
2307
|
|
|
$new_id = 0; |
|
2308
|
|
|
|
|
2309
|
|
|
if ( $pod->fetch() ) { |
|
2310
|
|
|
$new_id = $pod->id(); |
|
2311
|
|
|
} |
|
2312
|
|
|
|
|
2313
|
|
|
$new_id = $this->do_hook( 'next_id', $new_id, $id, $pod, $params_override ); |
|
2314
|
|
|
|
|
2315
|
|
|
return $new_id; |
|
2316
|
|
|
} |
|
2317
|
|
|
|
|
2318
|
|
|
/** |
|
2319
|
|
|
* Return the first item ID |
|
2320
|
|
|
* |
|
2321
|
|
|
* @param array|object|null $params_override Override the find() parameters. |
|
2322
|
|
|
* |
|
2323
|
|
|
* @return int |
|
2324
|
|
|
* @since 2.3 |
|
2325
|
|
|
*/ |
|
2326
|
|
|
public function first_id( $params_override = null ) { |
|
2327
|
|
|
|
|
2328
|
|
|
$params = array( |
|
2329
|
|
|
'select' => "`t`.`{$this->data->field_id}`", |
|
2330
|
|
|
'orderby' => "`t`.`{$this->data->field_id}` ASC", |
|
2331
|
|
|
'limit' => 1, |
|
2332
|
|
|
); |
|
2333
|
|
|
|
|
2334
|
|
|
if ( ! empty( $params_override ) || ! empty( $this->params ) ) { |
|
2335
|
|
|
if ( ! empty( $params_override ) ) { |
|
2336
|
|
|
$params = $params_override; |
|
2337
|
|
|
} elseif ( ! empty( $this->params ) ) { |
|
2338
|
|
|
$params = $this->params; |
|
2339
|
|
|
} |
|
2340
|
|
|
|
|
2341
|
|
|
if ( is_object( $params ) ) { |
|
2342
|
|
|
$params = get_object_vars( $params ); |
|
2343
|
|
|
} |
|
2344
|
|
|
|
|
2345
|
|
|
$params['select'] = "`t`.`{$this->data->field_id}`"; |
|
2346
|
|
|
$params['offset'] = 0; |
|
2347
|
|
|
$params['limit'] = 1; |
|
2348
|
|
|
} |
|
2349
|
|
|
|
|
2350
|
|
|
$pod = pods( $this->pod, $params ); |
|
2351
|
|
|
|
|
2352
|
|
|
$new_id = 0; |
|
2353
|
|
|
|
|
2354
|
|
|
if ( $pod->fetch() ) { |
|
2355
|
|
|
$new_id = $pod->id(); |
|
2356
|
|
|
} |
|
2357
|
|
|
|
|
2358
|
|
|
$new_id = $this->do_hook( 'first_id', $new_id, $pod, $params_override ); |
|
2359
|
|
|
|
|
2360
|
|
|
return $new_id; |
|
2361
|
|
|
} |
|
2362
|
|
|
|
|
2363
|
|
|
/** |
|
2364
|
|
|
* Return the last item ID |
|
2365
|
|
|
* |
|
2366
|
|
|
* @param array|object|null $params_override Override the find() parameters. |
|
2367
|
|
|
* |
|
2368
|
|
|
* @return int |
|
2369
|
|
|
* @since 2.3 |
|
2370
|
|
|
*/ |
|
2371
|
|
|
public function last_id( $params_override = null ) { |
|
2372
|
|
|
|
|
2373
|
|
|
$params = array( |
|
2374
|
|
|
'select' => "`t`.`{$this->data->field_id}`", |
|
2375
|
|
|
'orderby' => "`t`.`{$this->data->field_id}` DESC", |
|
2376
|
|
|
'limit' => 1, |
|
2377
|
|
|
); |
|
2378
|
|
|
|
|
2379
|
|
|
if ( ! empty( $params_override ) || ! empty( $this->params ) ) { |
|
2380
|
|
|
if ( ! empty( $params_override ) ) { |
|
2381
|
|
|
$params = $params_override; |
|
2382
|
|
|
} elseif ( ! empty( $this->params ) ) { |
|
2383
|
|
|
$params = $this->params; |
|
2384
|
|
|
} |
|
2385
|
|
|
|
|
2386
|
|
|
if ( is_object( $params ) ) { |
|
2387
|
|
|
$params = get_object_vars( $params ); |
|
2388
|
|
|
} |
|
2389
|
|
|
|
|
2390
|
|
|
if ( isset( $params['total_found'] ) ) { |
|
2391
|
|
|
$params['offset'] = $params['total_found'] - 1; |
|
2392
|
|
|
} else { |
|
2393
|
|
|
$params['offset'] = $this->total_found() - 1; |
|
2394
|
|
|
} |
|
2395
|
|
|
|
|
2396
|
|
|
if ( isset( $params['orderby'] ) && ! empty( $params['orderby'] ) ) { |
|
2397
|
|
|
if ( is_array( $params['orderby'] ) ) { |
|
2398
|
|
|
foreach ( $params['orderby'] as $orderby => $dir ) { |
|
2399
|
|
|
$dir = strtoupper( $dir ); |
|
2400
|
|
|
|
|
2401
|
|
|
if ( ! in_array( $dir, array( 'ASC', 'DESC' ), true ) ) { |
|
2402
|
|
|
continue; |
|
2403
|
|
|
} |
|
2404
|
|
|
|
|
2405
|
|
|
if ( 'ASC' === $dir ) { |
|
2406
|
|
|
$params['orderby'][ $orderby ] = 'DESC'; |
|
2407
|
|
|
} else { |
|
2408
|
|
|
$params['orderby'][ $orderby ] = 'ASC'; |
|
2409
|
|
|
} |
|
2410
|
|
|
} |
|
2411
|
|
|
|
|
2412
|
|
|
$params['orderby'][ $this->data->field_id ] = 'DESC'; |
|
2413
|
|
|
} elseif ( "`t`.`{$this->data->field_id}` DESC" !== $params['orderby'] ) { |
|
2414
|
|
|
$params['orderby'] .= ", `t`.`{$this->data->field_id}` DESC"; |
|
2415
|
|
|
} |
|
2416
|
|
|
}//end if |
|
2417
|
|
|
|
|
2418
|
|
|
$params['select'] = "`t`.`{$this->data->field_id}`"; |
|
2419
|
|
|
$params['limit'] = 1; |
|
2420
|
|
|
}//end if |
|
2421
|
|
|
|
|
2422
|
|
|
$pod = pods( $this->pod, $params ); |
|
2423
|
|
|
|
|
2424
|
|
|
$new_id = 0; |
|
2425
|
|
|
|
|
2426
|
|
|
if ( $pod->fetch() ) { |
|
2427
|
|
|
$new_id = $pod->id(); |
|
2428
|
|
|
} |
|
2429
|
|
|
|
|
2430
|
|
|
$new_id = $this->do_hook( 'last_id', $new_id, $pod, $params_override ); |
|
2431
|
|
|
|
|
2432
|
|
|
return $new_id; |
|
2433
|
|
|
} |
|
2434
|
|
|
|
|
2435
|
|
|
/** |
|
2436
|
|
|
* Return the item name |
|
2437
|
|
|
* |
|
2438
|
|
|
* @return string |
|
2439
|
|
|
* @since 2.0 |
|
2440
|
|
|
*/ |
|
2441
|
|
|
public function index() { |
|
2442
|
|
|
|
|
2443
|
|
|
return $this->field( $this->data->field_index ); |
|
2444
|
|
|
} |
|
2445
|
|
|
|
|
2446
|
|
|
/** |
|
2447
|
|
|
* Find items of a pod, much like WP_Query, but with advanced table handling. |
|
2448
|
|
|
* |
|
2449
|
|
|
* @param array|object $params An associative array of parameters. |
|
|
|
|
|
|
2450
|
|
|
* @param int $limit (deprecated) Limit the number of items to find, -1 to return all items with no limit. |
|
2451
|
|
|
* @param string $where (deprecated) SQL WHERE declaration to use. |
|
|
|
|
|
|
2452
|
|
|
* @param string $sql (deprecated) For advanced use, a custom SQL query to run. |
|
|
|
|
|
|
2453
|
|
|
* |
|
2454
|
|
|
* @return \Pods The pod object |
|
2455
|
|
|
* @since 2.0 |
|
2456
|
|
|
* @link https://pods.io/docs/find/ |
|
2457
|
|
|
*/ |
|
2458
|
|
|
public function find( $params = null, $limit = 15, $where = null, $sql = null ) { |
|
2459
|
|
|
|
|
2460
|
|
|
$tableless_field_types = PodsForm::tableless_field_types(); |
|
|
|
|
|
|
2461
|
|
|
$simple_tableless_objects = PodsForm::simple_tableless_objects(); |
|
|
|
|
|
|
2462
|
|
|
|
|
2463
|
|
|
$this->params = $params; |
|
2464
|
|
|
|
|
2465
|
|
|
$select = '`t`.*'; |
|
2466
|
|
|
|
|
2467
|
|
|
if ( 'table' === $this->pod_data['storage'] && ! in_array( $this->pod_data['type'], array( |
|
2468
|
|
|
'pod', |
|
2469
|
|
|
'table', |
|
2470
|
|
|
), true ) ) { |
|
2471
|
|
|
$select .= ', `d`.*'; |
|
2472
|
|
|
} |
|
2473
|
|
|
|
|
2474
|
|
|
if ( empty( $this->data->table ) ) { |
|
2475
|
|
|
return $this; |
|
2476
|
|
|
} |
|
2477
|
|
|
|
|
2478
|
|
|
$defaults = array( |
|
2479
|
|
|
// Optimization parameters. |
|
2480
|
|
|
'table' => $this->data->table, |
|
2481
|
|
|
'select' => $select, |
|
2482
|
|
|
'join' => null, |
|
2483
|
|
|
// Main query parameters. |
|
2484
|
|
|
'where' => $where, |
|
2485
|
|
|
'groupby' => null, |
|
2486
|
|
|
'having' => null, |
|
2487
|
|
|
'orderby' => null, |
|
2488
|
|
|
// Pagination parameters. |
|
2489
|
|
|
'limit' => (int) $limit, |
|
2490
|
|
|
'offset' => null, |
|
2491
|
|
|
'page' => (int) $this->page, |
|
2492
|
|
|
'page_var' => $this->page_var, |
|
2493
|
|
|
'pagination' => (boolean) $this->pagination, |
|
2494
|
|
|
// Search parameters. |
|
2495
|
|
|
'search' => (boolean) $this->search, |
|
2496
|
|
|
'search_var' => $this->search_var, |
|
2497
|
|
|
'search_query' => null, |
|
2498
|
|
|
'search_mode' => $this->search_mode, |
|
2499
|
|
|
'search_across' => false, |
|
2500
|
|
|
'search_across_picks' => false, |
|
2501
|
|
|
'search_across_files' => false, |
|
2502
|
|
|
// Advanced parameters. |
|
2503
|
|
|
'filters' => $this->filters, |
|
2504
|
|
|
'sql' => $sql, |
|
2505
|
|
|
// Caching parameters. |
|
2506
|
|
|
'expires' => null, |
|
2507
|
|
|
'cache_mode' => 'cache', |
|
2508
|
|
|
); |
|
2509
|
|
|
|
|
2510
|
|
|
if ( is_array( $params ) ) { |
|
2511
|
|
|
$params = (object) array_merge( $defaults, $params ); |
|
2512
|
|
|
} elseif ( is_object( $params ) ) { |
|
2513
|
|
|
$params = (object) array_merge( $defaults, get_object_vars( $params ) ); |
|
2514
|
|
|
} else { |
|
2515
|
|
|
$defaults['orderby'] = $params; |
|
2516
|
|
|
|
|
2517
|
|
|
$params = (object) $defaults; |
|
2518
|
|
|
} |
|
2519
|
|
|
|
|
2520
|
|
|
/** |
|
2521
|
|
|
* Filter the Pods::find() parameters. |
|
2522
|
|
|
* |
|
2523
|
|
|
* @param object $params Parameters to make lookup with. |
|
2524
|
|
|
*/ |
|
2525
|
|
|
$params = apply_filters( 'pods_pods_find', $params ); |
|
2526
|
|
|
|
|
2527
|
|
|
$params->limit = (int) $params->limit; |
|
2528
|
|
|
|
|
2529
|
|
|
if ( 0 === $params->limit ) { |
|
2530
|
|
|
$params->limit = - 1; |
|
2531
|
|
|
} |
|
2532
|
|
|
|
|
2533
|
|
|
$this->limit = (int) $params->limit; |
|
2534
|
|
|
$this->offset = (int) $params->offset; |
|
2535
|
|
|
$this->page = (int) $params->page; |
|
2536
|
|
|
$this->page_var = $params->page_var; |
|
2537
|
|
|
$this->pagination = (boolean) $params->pagination; |
|
2538
|
|
|
$this->search = (boolean) $params->search; |
|
2539
|
|
|
$this->search_var = $params->search_var; |
|
2540
|
|
|
$params->join = (array) $params->join; |
|
2541
|
|
|
|
|
2542
|
|
|
if ( empty( $params->search_query ) ) { |
|
2543
|
|
|
$params->search_query = pods_v_sanitized( $this->search_var, 'get', '' ); |
|
2544
|
|
|
} |
|
2545
|
|
|
|
|
2546
|
|
|
// Allow orderby array ( 'field' => 'asc|desc' ). |
|
|
|
|
|
|
2547
|
|
|
if ( ! empty( $params->orderby ) && is_array( $params->orderby ) ) { |
|
2548
|
|
|
foreach ( $params->orderby as $k => $orderby ) { |
|
2549
|
|
|
if ( ! is_numeric( $k ) ) { |
|
2550
|
|
|
$key = ''; |
|
2551
|
|
|
|
|
2552
|
|
|
$order = 'ASC'; |
|
2553
|
|
|
|
|
2554
|
|
|
if ( 'DESC' === strtoupper( $orderby ) ) { |
|
2555
|
|
|
$order = 'DESC'; |
|
2556
|
|
|
} |
|
2557
|
|
|
|
|
2558
|
|
|
if ( isset( $this->fields[ $k ] ) && in_array( $this->fields[ $k ]['type'], $tableless_field_types, true ) ) { |
|
2559
|
|
|
if ( in_array( $this->fields[ $k ]['pick_object'], $simple_tableless_objects, true ) ) { |
|
2560
|
|
|
if ( 'table' === $this->pod_data['storage'] ) { |
|
2561
|
|
|
if ( ! in_array( $this->pod_data['type'], array( 'pod', 'table' ), true ) ) { |
|
2562
|
|
|
$key = "`d`.`{$k}`"; |
|
2563
|
|
|
} else { |
|
2564
|
|
|
$key = "`t`.`{$k}`"; |
|
2565
|
|
|
} |
|
2566
|
|
|
} else { |
|
2567
|
|
|
$key = "`{$k}`.`meta_value`"; |
|
2568
|
|
|
} |
|
2569
|
|
|
} else { |
|
2570
|
|
|
$pick_val = $this->fields[ $k ]['pick_val']; |
|
2571
|
|
|
|
|
2572
|
|
|
if ( '__current__' === $pick_val ) { |
|
2573
|
|
|
$pick_val = $this->pod; |
|
2574
|
|
|
} |
|
2575
|
|
|
|
|
2576
|
|
|
$table = $this->api->get_table_info( $this->fields[ $k ]['pick_object'], $pick_val ); |
|
2577
|
|
|
|
|
2578
|
|
|
if ( ! empty( $table ) ) { |
|
2579
|
|
|
$key = "`{$k}`.`" . $table['field_index'] . '`'; |
|
2580
|
|
|
} |
|
2581
|
|
|
}//end if |
|
2582
|
|
|
}//end if |
|
2583
|
|
|
|
|
2584
|
|
|
if ( empty( $key ) ) { |
|
2585
|
|
|
if ( ! in_array( $this->pod_data['type'], array( 'pod', 'table' ), true ) ) { |
|
2586
|
|
|
if ( isset( $this->pod_data['object_fields'][ $k ] ) ) { |
|
2587
|
|
|
$key = "`t`.`{$k}`"; |
|
2588
|
|
|
} elseif ( isset( $this->fields[ $k ] ) ) { |
|
2589
|
|
|
if ( 'table' === $this->pod_data['storage'] ) { |
|
2590
|
|
|
$key = "`d`.`{$k}`"; |
|
2591
|
|
|
} else { |
|
2592
|
|
|
$key = "`{$k}`.`meta_value`"; |
|
2593
|
|
|
} |
|
2594
|
|
|
} else { |
|
2595
|
|
|
$object_fields = (array) $this->pod_data['object_fields']; |
|
2596
|
|
|
|
|
2597
|
|
|
foreach ( $object_fields as $object_field => $object_field_opt ) { |
|
2598
|
|
|
if ( $object_field === $k || in_array( $k, $object_field_opt['alias'], true ) ) { |
|
2599
|
|
|
$key = "`t`.`{$object_field}`"; |
|
2600
|
|
|
} |
|
2601
|
|
|
} |
|
2602
|
|
|
} |
|
2603
|
|
|
} elseif ( isset( $this->fields[ $k ] ) ) { |
|
2604
|
|
|
if ( 'table' === $this->pod_data['storage'] ) { |
|
2605
|
|
|
$key = "`t`.`{$k}`"; |
|
2606
|
|
|
} else { |
|
2607
|
|
|
$key = "`{$k}`.`meta_value`"; |
|
2608
|
|
|
} |
|
2609
|
|
|
}//end if |
|
2610
|
|
|
|
|
2611
|
|
|
if ( empty( $key ) ) { |
|
2612
|
|
|
$key = $k; |
|
2613
|
|
|
|
|
2614
|
|
|
if ( false === strpos( $key, ' ' ) && false === strpos( $key, '`' ) ) { |
|
2615
|
|
|
$key = '`' . str_replace( '.', '`.`', $key ) . '`'; |
|
2616
|
|
|
} |
|
2617
|
|
|
} |
|
2618
|
|
|
}//end if |
|
2619
|
|
|
|
|
2620
|
|
|
$orderby = $key; |
|
2621
|
|
|
|
|
2622
|
|
|
if ( false === strpos( $orderby, ' ' ) ) { |
|
2623
|
|
|
$orderby .= ' ' . $order; |
|
2624
|
|
|
} |
|
2625
|
|
|
|
|
2626
|
|
|
$params->orderby[ $k ] = $orderby; |
|
2627
|
|
|
}//end if |
|
2628
|
|
|
}//end foreach |
|
2629
|
|
|
}//end if |
|
2630
|
|
|
|
|
2631
|
|
|
// Add prefix to $params->orderby if needed. |
|
2632
|
|
|
if ( ! empty( $params->orderby ) ) { |
|
2633
|
|
|
if ( ! is_array( $params->orderby ) ) { |
|
2634
|
|
|
$params->orderby = array( $params->orderby ); |
|
2635
|
|
|
} |
|
2636
|
|
|
|
|
2637
|
|
|
foreach ( $params->orderby as $ok => $prefix_orderby ) { |
|
2638
|
|
|
if ( false === strpos( $prefix_orderby, ',' ) && false === strpos( $prefix_orderby, '(' ) && false === stripos( $prefix_orderby, ' AS ' ) && false === strpos( $prefix_orderby, '`' ) && false === strpos( $prefix_orderby, '.' ) ) { |
|
2639
|
|
|
if ( false !== stripos( $prefix_orderby, ' DESC' ) ) { |
|
2640
|
|
|
$k = trim( str_ireplace( array( '`', ' DESC' ), '', $prefix_orderby ) ); |
|
2641
|
|
|
$dir = 'DESC'; |
|
2642
|
|
|
} else { |
|
2643
|
|
|
$k = trim( str_ireplace( array( '`', ' ASC' ), '', $prefix_orderby ) ); |
|
2644
|
|
|
$dir = 'ASC'; |
|
2645
|
|
|
} |
|
2646
|
|
|
|
|
2647
|
|
|
$key = $k; |
|
2648
|
|
|
|
|
2649
|
|
|
if ( ! in_array( $this->pod_data['type'], array( 'pod', 'table' ), true ) ) { |
|
2650
|
|
|
if ( isset( $this->pod_data['object_fields'][ $k ] ) ) { |
|
2651
|
|
|
$key = "`t`.`{$k}`"; |
|
2652
|
|
|
} elseif ( isset( $this->fields[ $k ] ) ) { |
|
2653
|
|
|
if ( 'table' === $this->pod_data['storage'] ) { |
|
2654
|
|
|
$key = "`d`.`{$k}`"; |
|
2655
|
|
|
} else { |
|
2656
|
|
|
$key = "`{$k}`.`meta_value`"; |
|
2657
|
|
|
} |
|
2658
|
|
|
} else { |
|
2659
|
|
|
$object_fields = (array) $this->pod_data['object_fields']; |
|
2660
|
|
|
|
|
2661
|
|
|
foreach ( $object_fields as $object_field => $object_field_opt ) { |
|
2662
|
|
|
if ( $object_field === $k || in_array( $k, $object_field_opt['alias'], true ) ) { |
|
2663
|
|
|
$key = "`t`.`{$object_field}`"; |
|
2664
|
|
|
} |
|
2665
|
|
|
} |
|
2666
|
|
|
} |
|
2667
|
|
|
} elseif ( isset( $this->fields[ $k ] ) ) { |
|
2668
|
|
|
if ( 'table' === $this->pod_data['storage'] ) { |
|
2669
|
|
|
$key = "`t`.`{$k}`"; |
|
2670
|
|
|
} else { |
|
2671
|
|
|
$key = "`{$k}`.`meta_value`"; |
|
2672
|
|
|
} |
|
2673
|
|
|
}//end if |
|
2674
|
|
|
|
|
2675
|
|
|
$prefix_orderby = "{$key} {$dir}"; |
|
2676
|
|
|
|
|
2677
|
|
|
$params->orderby[ $ok ] = $prefix_orderby; |
|
2678
|
|
|
}//end if |
|
2679
|
|
|
}//end foreach |
|
2680
|
|
|
}//end if |
|
2681
|
|
|
|
|
2682
|
|
|
$this->data->select( $params ); |
|
2683
|
|
|
|
|
2684
|
|
|
return $this; |
|
2685
|
|
|
} |
|
2686
|
|
|
|
|
2687
|
|
|
/** |
|
2688
|
|
|
* Fetch an item from a Pod. If $id is null, it will return the next item in the list after running find(). |
|
2689
|
|
|
* You can rewind the list back to the start by using reset(). |
|
2690
|
|
|
* |
|
2691
|
|
|
* Providing an $id will fetch a specific item from a Pod, much like a call to pods(), and can handle either an id |
|
2692
|
|
|
* or slug. |
|
2693
|
|
|
* |
|
2694
|
|
|
* @see PodsData::fetch |
|
2695
|
|
|
* |
|
2696
|
|
|
* @param int $id ID or slug of the item to fetch. |
|
|
|
|
|
|
2697
|
|
|
* @param bool $explicit_set Whether to set explicitly (use false when in loop). |
|
2698
|
|
|
* |
|
2699
|
|
|
* @return array An array of fields from the row |
|
2700
|
|
|
* |
|
2701
|
|
|
* @since 2.0 |
|
2702
|
|
|
* @link https://pods.io/docs/fetch/ |
|
2703
|
|
|
*/ |
|
2704
|
|
|
public function fetch( $id = null, $explicit_set = true ) { |
|
2705
|
|
|
|
|
2706
|
|
|
/** |
|
2707
|
|
|
* Runs directly before an item is fetched by fetch(). |
|
2708
|
|
|
* |
|
2709
|
|
|
* @since unknown |
|
2710
|
|
|
* |
|
2711
|
|
|
* @param int|string|null $id Item ID being fetched or null. |
|
2712
|
|
|
* @param object|Pods $this Current Pods object. |
|
2713
|
|
|
*/ |
|
2714
|
|
|
do_action( 'pods_pods_fetch', $id, $this ); |
|
2715
|
|
|
|
|
2716
|
|
|
if ( ! empty( $id ) ) { |
|
2717
|
|
|
$this->params = array(); |
|
2718
|
|
|
} |
|
2719
|
|
|
|
|
2720
|
|
|
$this->data->fetch( $id, $explicit_set ); |
|
2721
|
|
|
|
|
2722
|
|
|
return $this->row; |
|
2723
|
|
|
} |
|
2724
|
|
|
|
|
2725
|
|
|
/** |
|
2726
|
|
|
* (Re)set the MySQL result pointer |
|
2727
|
|
|
* |
|
2728
|
|
|
* @see PodsData::reset |
|
2729
|
|
|
* |
|
2730
|
|
|
* @param int $row ID of the row to reset to. |
|
|
|
|
|
|
2731
|
|
|
* |
|
2732
|
|
|
* @return \Pods The pod object |
|
2733
|
|
|
* |
|
2734
|
|
|
* @since 2.0 |
|
2735
|
|
|
* @link https://pods.io/docs/reset/ |
|
2736
|
|
|
*/ |
|
2737
|
|
|
public function reset( $row = null ) { |
|
2738
|
|
|
|
|
2739
|
|
|
/** |
|
2740
|
|
|
* Runs directly before the Pods object is reset by reset() |
|
2741
|
|
|
* |
|
2742
|
|
|
* @since unknown |
|
2743
|
|
|
* |
|
2744
|
|
|
* @param int|string|null The ID of the row being reset to or null if being reset to the beginning. |
|
2745
|
|
|
* @param object|Pods $this Current Pods object. |
|
2746
|
|
|
*/ |
|
2747
|
|
|
do_action( 'pods_pods_reset', $row, $this ); |
|
2748
|
|
|
|
|
2749
|
|
|
$this->data->reset( $row ); |
|
2750
|
|
|
|
|
2751
|
|
|
return $this; |
|
2752
|
|
|
} |
|
2753
|
|
|
|
|
2754
|
|
|
/** |
|
2755
|
|
|
* Fetch the total row count returned by the last call to find(), based on the 'limit' parameter set. |
|
2756
|
|
|
* |
|
2757
|
|
|
* This is different than the total number of rows found in the database, which you can get with total_found(). |
|
2758
|
|
|
* |
|
2759
|
|
|
* @see PodsData::total |
|
2760
|
|
|
* |
|
2761
|
|
|
* @return int Number of rows returned by find(), based on the 'limit' parameter set |
|
2762
|
|
|
* @since 2.0 |
|
2763
|
|
|
* @link https://pods.io/docs/total/ |
|
2764
|
|
|
*/ |
|
2765
|
|
|
public function total() { |
|
2766
|
|
|
|
|
2767
|
|
|
do_action( 'pods_pods_total', $this ); |
|
2768
|
|
|
|
|
2769
|
|
|
$this->data->total(); |
|
|
|
|
|
|
2770
|
|
|
|
|
2771
|
|
|
$this->total =& $this->data->total; |
|
2772
|
|
|
|
|
2773
|
|
|
return $this->total; |
|
2774
|
|
|
} |
|
2775
|
|
|
|
|
2776
|
|
|
/** |
|
2777
|
|
|
* Fetch the total amount of rows found by the last call to find(), regardless of the 'limit' parameter set. |
|
2778
|
|
|
* |
|
2779
|
|
|
* This is different than the total number of rows limited by the current call, which you can get with total(). |
|
2780
|
|
|
* |
|
2781
|
|
|
* @see PodsData::total_found |
|
2782
|
|
|
* |
|
2783
|
|
|
* @return int Number of rows returned by find(), regardless of the 'limit' parameter |
|
|
|
|
|
|
2784
|
|
|
* @since 2.0 |
|
2785
|
|
|
* @link https://pods.io/docs/total-found/ |
|
2786
|
|
|
*/ |
|
2787
|
|
|
public function total_found() { |
|
2788
|
|
|
|
|
2789
|
|
|
/** |
|
2790
|
|
|
* Runs directly before the value of total_found() is determined and returned. |
|
2791
|
|
|
* |
|
2792
|
|
|
* @since unknown |
|
2793
|
|
|
* |
|
2794
|
|
|
* @param object|Pods $this Current Pods object. |
|
2795
|
|
|
*/ |
|
2796
|
|
|
do_action( 'pods_pods_total_found', $this ); |
|
2797
|
|
|
|
|
2798
|
|
|
$this->data->total_found(); |
|
2799
|
|
|
|
|
2800
|
|
|
$this->total_found =& $this->data->total_found; |
|
2801
|
|
|
|
|
2802
|
|
|
return $this->total_found; |
|
2803
|
|
|
} |
|
2804
|
|
|
|
|
2805
|
|
|
/** |
|
2806
|
|
|
* Fetch the total number of pages, based on total rows found and the last find() limit |
|
2807
|
|
|
* |
|
2808
|
|
|
* @param null|int $limit Rows per page. |
|
2809
|
|
|
* @param null|int $offset Offset of rows. |
|
2810
|
|
|
* @param null|int $total Total rows. |
|
2811
|
|
|
* |
|
2812
|
|
|
* @return int Number of pages |
|
|
|
|
|
|
2813
|
|
|
* @since 2.3.10 |
|
2814
|
|
|
*/ |
|
2815
|
|
|
public function total_pages( $limit = null, $offset = null, $total = null ) { |
|
2816
|
|
|
|
|
2817
|
|
|
$this->do_hook( 'total_pages' ); |
|
2818
|
|
|
|
|
2819
|
|
|
if ( null === $limit ) { |
|
2820
|
|
|
$limit = $this->limit; |
|
2821
|
|
|
} |
|
2822
|
|
|
|
|
2823
|
|
|
if ( null === $offset ) { |
|
2824
|
|
|
$offset = $this->offset; |
|
2825
|
|
|
} |
|
2826
|
|
|
|
|
2827
|
|
|
if ( null === $total ) { |
|
2828
|
|
|
$total = $this->total_found(); |
|
2829
|
|
|
} |
|
2830
|
|
|
|
|
2831
|
|
|
return ceil( ( $total - $offset ) / $limit ); |
|
2832
|
|
|
|
|
2833
|
|
|
} |
|
2834
|
|
|
|
|
2835
|
|
|
/** |
|
2836
|
|
|
* Fetch the zebra switch |
|
2837
|
|
|
* |
|
2838
|
|
|
* @see PodsData::zebra |
|
2839
|
|
|
* |
|
2840
|
|
|
* @return bool Zebra state |
|
2841
|
|
|
* @since 1.12 |
|
2842
|
|
|
*/ |
|
2843
|
|
|
public function zebra() { |
|
2844
|
|
|
|
|
2845
|
|
|
$this->do_hook( 'zebra' ); |
|
2846
|
|
|
|
|
2847
|
|
|
return $this->data->zebra(); |
|
2848
|
|
|
} |
|
2849
|
|
|
|
|
2850
|
|
|
/** |
|
2851
|
|
|
* Fetch the nth state |
|
2852
|
|
|
* |
|
2853
|
|
|
* @see PodsData::nth |
|
2854
|
|
|
* |
|
2855
|
|
|
* @param int|string $nth The $nth to match on the PodsData::row_number. |
|
|
|
|
|
|
2856
|
|
|
* |
|
2857
|
|
|
* @return bool Whether $nth matches |
|
2858
|
|
|
* @since 2.3 |
|
2859
|
|
|
*/ |
|
2860
|
|
|
public function nth( $nth = null ) { |
|
2861
|
|
|
|
|
2862
|
|
|
$this->do_hook( 'nth', $nth ); |
|
2863
|
|
|
|
|
2864
|
|
|
return $this->data->nth( $nth ); |
|
2865
|
|
|
} |
|
2866
|
|
|
|
|
2867
|
|
|
/** |
|
2868
|
|
|
* Fetch the current position in the loop (starting at 1) |
|
2869
|
|
|
* |
|
2870
|
|
|
* @see PodsData::position |
|
2871
|
|
|
* |
|
2872
|
|
|
* @return int Current row number (+1) |
|
2873
|
|
|
* @since 2.3 |
|
2874
|
|
|
*/ |
|
2875
|
|
|
public function position() { |
|
2876
|
|
|
|
|
2877
|
|
|
$this->do_hook( 'position' ); |
|
2878
|
|
|
|
|
2879
|
|
|
return $this->data->position(); |
|
2880
|
|
|
} |
|
2881
|
|
|
|
|
2882
|
|
|
/** |
|
2883
|
|
|
* Add an item to a Pod by giving an array of field data or set a specific field to |
|
2884
|
|
|
* a specific value if you're just wanting to add a new item but only set one field. |
|
2885
|
|
|
* |
|
2886
|
|
|
* You may be looking for save() in most cases where you're setting a specific field. |
|
2887
|
|
|
* |
|
2888
|
|
|
* @see PodsAPI::save_pod_item |
|
2889
|
|
|
* |
|
2890
|
|
|
* @param array|string $data Either an associative array of field information or a field name. |
|
|
|
|
|
|
2891
|
|
|
* @param mixed $value (optional) Value of the field, if $data is a field name. |
|
2892
|
|
|
* |
|
2893
|
|
|
* @return int The item ID |
|
|
|
|
|
|
2894
|
|
|
* |
|
2895
|
|
|
* @since 2.0 |
|
2896
|
|
|
* @link https://pods.io/docs/add/ |
|
2897
|
|
|
*/ |
|
2898
|
|
|
public function add( $data = null, $value = null ) { |
|
2899
|
|
|
|
|
2900
|
|
|
if ( null !== $value ) { |
|
2901
|
|
|
$data = array( $data => $value ); |
|
2902
|
|
|
} |
|
2903
|
|
|
|
|
2904
|
|
|
$data = (array) $this->do_hook( 'add', $data ); |
|
2905
|
|
|
|
|
2906
|
|
|
if ( empty( $data ) ) { |
|
2907
|
|
|
return 0; |
|
2908
|
|
|
} |
|
2909
|
|
|
|
|
2910
|
|
|
$params = array( |
|
2911
|
|
|
'pod' => $this->pod, |
|
2912
|
|
|
'data' => $data, |
|
2913
|
|
|
'allow_custom_fields' => true, |
|
2914
|
|
|
); |
|
2915
|
|
|
|
|
2916
|
|
|
return $this->api->save_pod_item( $params ); |
|
2917
|
|
|
} |
|
2918
|
|
|
|
|
2919
|
|
|
/** |
|
2920
|
|
|
* Add an item to the values of a relationship field, add a value to a number field (field+1), add time to a date |
|
2921
|
|
|
* field, or add text to a text field |
|
2922
|
|
|
* |
|
2923
|
|
|
* @see PodsAPI::save_pod_item |
|
2924
|
|
|
* |
|
2925
|
|
|
* @param string $field Field name. |
|
2926
|
|
|
* @param mixed $value IDs to add, int|float to add to number field, string for dates (+1 day), or string for text. |
|
2927
|
|
|
* @param int $id (optional) ID of the pod item to update. |
|
|
|
|
|
|
2928
|
|
|
* |
|
2929
|
|
|
* @return int The item ID |
|
|
|
|
|
|
2930
|
|
|
* |
|
2931
|
|
|
* @since 2.3 |
|
2932
|
|
|
*/ |
|
2933
|
|
|
public function add_to( $field, $value, $id = null ) { |
|
2934
|
|
|
|
|
2935
|
|
|
$pod =& $this; |
|
2936
|
|
|
|
|
2937
|
|
|
$fetch = false; |
|
2938
|
|
|
|
|
2939
|
|
|
if ( null === $id ) { |
|
2940
|
|
|
$fetch = true; |
|
2941
|
|
|
|
|
2942
|
|
|
$id = $pod->id(); |
|
2943
|
|
|
// @codingStandardsIgnoreLine |
|
2944
|
|
|
} elseif ( $id != $this->id() ) { |
|
2945
|
|
|
$pod = pods( $this->pod, $id ); |
|
2946
|
|
|
} |
|
2947
|
|
|
|
|
2948
|
|
|
$this->do_hook( 'add_to', $field, $value, $id ); |
|
2949
|
|
|
|
|
2950
|
|
|
if ( ! isset( $this->fields[ $field ] ) ) { |
|
2951
|
|
|
return $id; |
|
2952
|
|
|
} |
|
2953
|
|
|
|
|
2954
|
|
|
// Tableless fields. |
|
2955
|
|
|
if ( in_array( $this->fields[ $field ]['type'], PodsForm::tableless_field_types(), true ) ) { |
|
2956
|
|
|
if ( ! is_array( $value ) ) { |
|
2957
|
|
|
$value = explode( ',', $value ); |
|
2958
|
|
|
} |
|
2959
|
|
|
|
|
2960
|
|
|
if ( 'pick' === $this->fields[ $field ]['type'] && in_array( $this->fields[ $field ]['pick_object'], PodsForm::simple_tableless_objects(), true ) ) { |
|
2961
|
|
|
$current_value = $pod->raw( $field ); |
|
2962
|
|
|
|
|
2963
|
|
|
if ( ! empty( $current_value ) || ( ! is_array( $current_value ) && 0 < strlen( $current_value ) ) ) { |
|
2964
|
|
|
$current_value = (array) $current_value; |
|
2965
|
|
|
} else { |
|
2966
|
|
|
$current_value = array(); |
|
2967
|
|
|
} |
|
2968
|
|
|
|
|
2969
|
|
|
$value = array_merge( $current_value, $value ); |
|
2970
|
|
|
} else { |
|
2971
|
|
|
$related_ids = $this->api->lookup_related_items( $this->fields[ $field ]['id'], $this->pod_data['id'], $id, $this->fields[ $field ], $this->pod_data ); |
|
2972
|
|
|
|
|
2973
|
|
|
foreach ( $value as $k => $v ) { |
|
2974
|
|
|
if ( ! preg_match( '/[^\D]/', $v ) ) { |
|
2975
|
|
|
$value[ $k ] = (int) $v; |
|
2976
|
|
|
} |
|
2977
|
|
|
} |
|
2978
|
|
|
|
|
2979
|
|
|
$value = array_merge( $related_ids, $value ); |
|
2980
|
|
|
}//end if |
|
2981
|
|
|
|
|
2982
|
|
|
if ( ! empty( $value ) ) { |
|
2983
|
|
|
$value = array_filter( array_unique( $value ) ); |
|
2984
|
|
|
} else { |
|
2985
|
|
|
$value = array(); |
|
2986
|
|
|
} |
|
2987
|
|
|
|
|
2988
|
|
|
if ( empty( $value ) ) { |
|
2989
|
|
|
return $id; |
|
2990
|
|
|
} |
|
2991
|
|
|
} elseif ( in_array( $this->fields[ $field ]['type'], PodsForm::number_field_types(), true ) ) { |
|
2992
|
|
|
// Number fields. |
|
2993
|
|
|
$current_value = (float) $pod->raw( $field ); |
|
2994
|
|
|
|
|
2995
|
|
|
$value = ( $current_value + (float) $value ); |
|
2996
|
|
|
} elseif ( in_array( $this->fields[ $field ]['type'], PodsForm::date_field_types(), true ) ) { |
|
2997
|
|
|
// Date fields. |
|
2998
|
|
|
$current_value = $pod->raw( $field ); |
|
2999
|
|
|
|
|
3000
|
|
|
if ( 0 < strlen( $current_value ) ) { |
|
3001
|
|
|
$value = strtotime( $value, strtotime( $current_value ) ); |
|
3002
|
|
|
} else { |
|
3003
|
|
|
$value = strtotime( $value ); |
|
3004
|
|
|
} |
|
3005
|
|
|
} elseif ( in_array( $this->fields[ $field ]['type'], PodsForm::text_field_types(), true ) ) { |
|
3006
|
|
|
// Text fields. |
|
3007
|
|
|
$current_value = $pod->raw( $field ); |
|
3008
|
|
|
|
|
3009
|
|
|
if ( 0 < strlen( $current_value ) ) { |
|
3010
|
|
|
$value = $current_value . $value; |
|
3011
|
|
|
} |
|
3012
|
|
|
}//end if |
|
3013
|
|
|
|
|
3014
|
|
|
// @todo handle object fields and taxonomies. |
|
3015
|
|
|
$params = array( |
|
3016
|
|
|
'pod' => $this->pod, |
|
3017
|
|
|
'id' => $id, |
|
3018
|
|
|
'data' => array( |
|
3019
|
|
|
$field => $value, |
|
3020
|
|
|
), |
|
3021
|
|
|
); |
|
3022
|
|
|
|
|
3023
|
|
|
$id = $this->api->save_pod_item( $params ); |
|
3024
|
|
|
|
|
3025
|
|
|
if ( 0 < $id && $fetch ) { |
|
3026
|
|
|
// Clear local var cache of field values. |
|
3027
|
|
|
$pod->data->row = array(); |
|
3028
|
|
|
|
|
3029
|
|
|
$pod->fetch( $id, false ); |
|
3030
|
|
|
} |
|
3031
|
|
|
|
|
3032
|
|
|
return $id; |
|
3033
|
|
|
} |
|
3034
|
|
|
|
|
3035
|
|
|
/** |
|
3036
|
|
|
* Remove an item from the values of a relationship field, remove a value from a number field (field-1), remove |
|
3037
|
|
|
* time to a date field |
|
3038
|
|
|
* |
|
3039
|
|
|
* @see PodsAPI::save_pod_item |
|
3040
|
|
|
* |
|
3041
|
|
|
* @param string $field Field name. |
|
3042
|
|
|
* @param mixed $value IDs to add, int|float to add to number field, string for dates (-1 day), or string for text. |
|
3043
|
|
|
* @param int $id (optional) ID of the pod item to update. |
|
|
|
|
|
|
3044
|
|
|
* |
|
3045
|
|
|
* @return int The item ID |
|
|
|
|
|
|
3046
|
|
|
* |
|
3047
|
|
|
* @since 2.3.3 |
|
3048
|
|
|
*/ |
|
3049
|
|
|
public function remove_from( $field, $value = null, $id = null ) { |
|
3050
|
|
|
|
|
3051
|
|
|
$pod =& $this; |
|
3052
|
|
|
|
|
3053
|
|
|
$fetch = false; |
|
3054
|
|
|
|
|
3055
|
|
|
if ( null === $id ) { |
|
3056
|
|
|
$fetch = true; |
|
3057
|
|
|
|
|
3058
|
|
|
$id = $this->id(); |
|
3059
|
|
|
// @codingStandardsIgnoreLine |
|
3060
|
|
|
} elseif ( $id != $this->id() ) { |
|
3061
|
|
|
$pod = pods( $this->pod, $id ); |
|
3062
|
|
|
} |
|
3063
|
|
|
|
|
3064
|
|
|
$this->do_hook( 'remove_from', $field, $value, $id ); |
|
3065
|
|
|
|
|
3066
|
|
|
if ( ! isset( $this->fields[ $field ] ) ) { |
|
3067
|
|
|
return $id; |
|
3068
|
|
|
} |
|
3069
|
|
|
|
|
3070
|
|
|
// Tableless fields. |
|
3071
|
|
|
if ( in_array( $this->fields[ $field ]['type'], PodsForm::tableless_field_types(), true ) ) { |
|
3072
|
|
|
if ( empty( $value ) ) { |
|
3073
|
|
|
$value = array(); |
|
3074
|
|
|
} |
|
3075
|
|
|
|
|
3076
|
|
|
if ( ! empty( $value ) ) { |
|
3077
|
|
|
if ( ! is_array( $value ) ) { |
|
3078
|
|
|
$value = explode( ',', $value ); |
|
3079
|
|
|
} |
|
3080
|
|
|
|
|
3081
|
|
|
if ( 'pick' === $this->fields[ $field ]['type'] && in_array( $this->fields[ $field ]['pick_object'], PodsForm::simple_tableless_objects(), true ) ) { |
|
3082
|
|
|
$current_value = $pod->raw( $field ); |
|
3083
|
|
|
|
|
3084
|
|
|
if ( ! empty( $current_value ) ) { |
|
3085
|
|
|
$current_value = (array) $current_value; |
|
3086
|
|
|
} |
|
3087
|
|
|
|
|
3088
|
|
|
foreach ( $current_value as $k => $v ) { |
|
3089
|
|
|
// @codingStandardsIgnoreLine. |
|
3090
|
|
|
if ( in_array( $v, $value ) ) { |
|
3091
|
|
|
unset( $current_value[ $k ] ); |
|
3092
|
|
|
} |
|
3093
|
|
|
} |
|
3094
|
|
|
|
|
3095
|
|
|
$value = $current_value; |
|
3096
|
|
|
} else { |
|
3097
|
|
|
$related_ids = $this->api->lookup_related_items( $this->fields[ $field ]['id'], $this->pod_data['id'], $id, $this->fields[ $field ], $this->pod_data ); |
|
3098
|
|
|
|
|
3099
|
|
|
foreach ( $value as $k => $v ) { |
|
3100
|
|
|
if ( ! preg_match( '/[^\D]/', $v ) ) { |
|
3101
|
|
|
$value[ $k ] = (int) $v; |
|
3102
|
|
|
} |
|
3103
|
|
|
|
|
3104
|
|
|
// @todo Convert slugs into IDs. |
|
3105
|
|
|
} |
|
3106
|
|
|
|
|
3107
|
|
|
foreach ( $related_ids as $k => $v ) { |
|
3108
|
|
|
// @codingStandardsIgnoreLine. |
|
3109
|
|
|
if ( in_array( $v, $value ) ) { |
|
3110
|
|
|
unset( $related_ids[ $k ] ); |
|
3111
|
|
|
} |
|
3112
|
|
|
} |
|
3113
|
|
|
|
|
3114
|
|
|
$value = $related_ids; |
|
3115
|
|
|
}//end if |
|
3116
|
|
|
|
|
3117
|
|
|
if ( ! empty( $value ) ) { |
|
3118
|
|
|
$value = array_filter( array_unique( $value ) ); |
|
3119
|
|
|
} else { |
|
3120
|
|
|
$value = array(); |
|
3121
|
|
|
} |
|
3122
|
|
|
}//end if |
|
3123
|
|
|
} elseif ( in_array( $this->fields[ $field ]['type'], PodsForm::number_field_types(), true ) ) { |
|
3124
|
|
|
// Number fields. |
|
3125
|
|
|
// Date fields don't support empty for removing. |
|
3126
|
|
|
if ( empty( $value ) ) { |
|
3127
|
|
|
return $id; |
|
3128
|
|
|
} |
|
3129
|
|
|
|
|
3130
|
|
|
$current_value = (float) $pod->raw( $field ); |
|
3131
|
|
|
|
|
3132
|
|
|
$value = ( $current_value - (float) $value ); |
|
3133
|
|
|
} elseif ( in_array( $this->fields[ $field ]['type'], PodsForm::date_field_types(), true ) ) { |
|
3134
|
|
|
// Date fields. |
|
3135
|
|
|
// Date fields don't support empty for removing. |
|
3136
|
|
|
if ( empty( $value ) ) { |
|
3137
|
|
|
return $id; |
|
3138
|
|
|
} |
|
3139
|
|
|
|
|
3140
|
|
|
$current_value = $pod->raw( $field ); |
|
3141
|
|
|
|
|
3142
|
|
|
if ( 0 < strlen( $current_value ) ) { |
|
3143
|
|
|
$value = strtotime( $value, strtotime( $current_value ) ); |
|
3144
|
|
|
} else { |
|
3145
|
|
|
$value = strtotime( $value ); |
|
3146
|
|
|
} |
|
3147
|
|
|
|
|
3148
|
|
|
$value = date_i18n( 'Y-m-d h:i:s', $value ); |
|
3149
|
|
|
}//end if |
|
3150
|
|
|
|
|
3151
|
|
|
// @todo handle object fields and taxonomies. |
|
3152
|
|
|
$params = array( |
|
3153
|
|
|
'pod' => $this->pod, |
|
3154
|
|
|
'id' => $id, |
|
3155
|
|
|
'data' => array( |
|
3156
|
|
|
$field => $value, |
|
3157
|
|
|
), |
|
3158
|
|
|
); |
|
3159
|
|
|
|
|
3160
|
|
|
$id = $this->api->save_pod_item( $params ); |
|
3161
|
|
|
|
|
3162
|
|
|
if ( 0 < $id && $fetch ) { |
|
3163
|
|
|
// Clear local var cache of field values. |
|
3164
|
|
|
$pod->data->row = array(); |
|
3165
|
|
|
|
|
3166
|
|
|
$pod->fetch( $id, false ); |
|
3167
|
|
|
} |
|
3168
|
|
|
|
|
3169
|
|
|
return $id; |
|
3170
|
|
|
|
|
3171
|
|
|
} |
|
3172
|
|
|
|
|
3173
|
|
|
/** |
|
3174
|
|
|
* Save an item by giving an array of field data or set a specific field to a specific value. |
|
3175
|
|
|
* |
|
3176
|
|
|
* Though this function has the capacity to add new items, best practice should direct you |
|
3177
|
|
|
* to use add() for that instead. |
|
3178
|
|
|
* |
|
3179
|
|
|
* @see PodsAPI::save_pod_item |
|
3180
|
|
|
* |
|
3181
|
|
|
* @param array|string $data Either an associative array of field information or a field name. |
|
|
|
|
|
|
3182
|
|
|
* @param mixed $value (optional) Value of the field, if $data is a field name. |
|
3183
|
|
|
* @param int $id (optional) ID of the pod item to update. |
|
|
|
|
|
|
3184
|
|
|
* @param array $params (optional) Additional params to send to save_pod_item. |
|
|
|
|
|
|
3185
|
|
|
* |
|
3186
|
|
|
* @return int The item ID |
|
|
|
|
|
|
3187
|
|
|
* |
|
3188
|
|
|
* @since 2.0 |
|
3189
|
|
|
* @link https://pods.io/docs/save/ |
|
3190
|
|
|
*/ |
|
3191
|
|
|
public function save( $data = null, $value = null, $id = null, $params = null ) { |
|
3192
|
|
|
|
|
3193
|
|
|
if ( null !== $value ) { |
|
3194
|
|
|
$data = array( $data => $value ); |
|
3195
|
|
|
} |
|
3196
|
|
|
|
|
3197
|
|
|
$fetch = false; |
|
3198
|
|
|
|
|
3199
|
|
|
// @codingStandardsIgnoreLine |
|
3200
|
|
|
if ( null === $id || ( $this->row && $id == $this->id() ) ) { |
|
|
|
|
|
|
3201
|
|
|
$fetch = true; |
|
3202
|
|
|
|
|
3203
|
|
|
if ( null === $id ) { |
|
3204
|
|
|
$id = $this->id(); |
|
3205
|
|
|
} |
|
3206
|
|
|
} |
|
3207
|
|
|
|
|
3208
|
|
|
$data = (array) $this->do_hook( 'save', $data, $id ); |
|
3209
|
|
|
|
|
3210
|
|
|
if ( empty( $data ) && empty( $params['is_new_item'] ) ) { |
|
3211
|
|
|
return $id; |
|
3212
|
|
|
} |
|
3213
|
|
|
|
|
3214
|
|
|
$default = array(); |
|
3215
|
|
|
|
|
3216
|
|
|
if ( ! empty( $params ) && is_array( $params ) ) { |
|
3217
|
|
|
$default = $params; |
|
3218
|
|
|
} |
|
3219
|
|
|
|
|
3220
|
|
|
$params = array( |
|
3221
|
|
|
'pod' => $this->pod, |
|
3222
|
|
|
'id' => $id, |
|
3223
|
|
|
'data' => $data, |
|
3224
|
|
|
'allow_custom_fields' => true, |
|
3225
|
|
|
'clear_slug_cache' => false, |
|
3226
|
|
|
); |
|
3227
|
|
|
|
|
3228
|
|
|
if ( ! empty( $default ) ) { |
|
3229
|
|
|
$params = array_merge( $params, $default ); |
|
3230
|
|
|
} |
|
3231
|
|
|
|
|
3232
|
|
|
$id = $this->api->save_pod_item( $params ); |
|
3233
|
|
|
|
|
3234
|
|
|
if ( 0 < $id && $fetch ) { |
|
3235
|
|
|
// Clear local var cache of field values. |
|
3236
|
|
|
$this->data->row = array(); |
|
3237
|
|
|
|
|
3238
|
|
|
$this->fetch( $id, false ); |
|
3239
|
|
|
} |
|
3240
|
|
|
|
|
3241
|
|
|
if ( ! empty( $this->pod_data['field_slug'] ) ) { |
|
3242
|
|
|
if ( 0 < $id && $fetch ) { |
|
3243
|
|
|
$slug = $this->field( $this->pod_data['field_slug'] ); |
|
3244
|
|
|
} else { |
|
3245
|
|
|
$slug = pods( $this->pod, $id )->field( $this->pod_data['field_slug'] ); |
|
3246
|
|
|
} |
|
3247
|
|
|
|
|
3248
|
|
|
if ( 0 < strlen( $slug ) ) { |
|
3249
|
|
|
pods_cache_clear( $slug, 'pods_items_' . $this->pod ); |
|
3250
|
|
|
} |
|
3251
|
|
|
} |
|
3252
|
|
|
|
|
3253
|
|
|
return $id; |
|
3254
|
|
|
} |
|
3255
|
|
|
|
|
3256
|
|
|
/** |
|
3257
|
|
|
* Delete an item |
|
3258
|
|
|
* |
|
3259
|
|
|
* @see PodsAPI::delete_pod_item |
|
3260
|
|
|
* |
|
3261
|
|
|
* @param int $id ID of the Pod item to delete. |
|
|
|
|
|
|
3262
|
|
|
* |
|
3263
|
|
|
* @return bool Whether the item was successfully deleted |
|
3264
|
|
|
* |
|
3265
|
|
|
* @since 2.0 |
|
3266
|
|
|
* @link https://pods.io/docs/delete/ |
|
3267
|
|
|
*/ |
|
3268
|
|
|
public function delete( $id = null ) { |
|
3269
|
|
|
|
|
3270
|
|
|
if ( null === $id ) { |
|
3271
|
|
|
$id = $this->id(); |
|
3272
|
|
|
} |
|
3273
|
|
|
|
|
3274
|
|
|
$id = (int) $this->do_hook( 'delete', $id ); |
|
3275
|
|
|
|
|
3276
|
|
|
if ( empty( $id ) ) { |
|
3277
|
|
|
return false; |
|
3278
|
|
|
} |
|
3279
|
|
|
|
|
3280
|
|
|
$params = array( |
|
3281
|
|
|
'pod' => $this->pod, |
|
3282
|
|
|
'id' => $id, |
|
3283
|
|
|
); |
|
3284
|
|
|
|
|
3285
|
|
|
return $this->api->delete_pod_item( $params ); |
|
3286
|
|
|
} |
|
3287
|
|
|
|
|
3288
|
|
|
/** |
|
3289
|
|
|
* Reset Pod |
|
3290
|
|
|
* |
|
3291
|
|
|
* @see PodsAPI::reset_pod |
|
3292
|
|
|
* |
|
3293
|
|
|
* @return bool Whether the Pod was successfully reset |
|
3294
|
|
|
* |
|
3295
|
|
|
* @since 2.1.1 |
|
3296
|
|
|
*/ |
|
3297
|
|
|
public function reset_pod() { |
|
3298
|
|
|
|
|
3299
|
|
|
$params = array( 'id' => $this->pod_id ); |
|
3300
|
|
|
|
|
3301
|
|
|
$this->data->id = null; |
|
3302
|
|
|
$this->data->row = array(); |
|
3303
|
|
|
$this->data->data = array(); |
|
3304
|
|
|
|
|
3305
|
|
|
$this->data->total = 0; |
|
3306
|
|
|
$this->data->total_found = 0; |
|
3307
|
|
|
|
|
3308
|
|
|
return $this->api->reset_pod( $params ); |
|
3309
|
|
|
} |
|
3310
|
|
|
|
|
3311
|
|
|
/** |
|
3312
|
|
|
* Duplicate an item |
|
3313
|
|
|
* |
|
3314
|
|
|
* @see PodsAPI::duplicate_pod_item |
|
3315
|
|
|
* |
|
3316
|
|
|
* @param int $id ID of the pod item to duplicate. |
|
|
|
|
|
|
3317
|
|
|
* |
|
3318
|
|
|
* @return int|bool ID of the new pod item |
|
|
|
|
|
|
3319
|
|
|
* |
|
3320
|
|
|
* @since 2.0 |
|
3321
|
|
|
* @link https://pods.io/docs/duplicate/ |
|
3322
|
|
|
*/ |
|
3323
|
|
|
public function duplicate( $id = null ) { |
|
3324
|
|
|
|
|
3325
|
|
|
if ( null === $id ) { |
|
3326
|
|
|
$id = $this->id(); |
|
3327
|
|
|
} |
|
3328
|
|
|
|
|
3329
|
|
|
$id = (int) $this->do_hook( 'duplicate', $id ); |
|
3330
|
|
|
|
|
3331
|
|
|
if ( empty( $id ) ) { |
|
3332
|
|
|
return false; |
|
3333
|
|
|
} |
|
3334
|
|
|
|
|
3335
|
|
|
$params = array( |
|
3336
|
|
|
'pod' => $this->pod, |
|
3337
|
|
|
'id' => $id, |
|
3338
|
|
|
); |
|
3339
|
|
|
|
|
3340
|
|
|
return $this->api->duplicate_pod_item( $params ); |
|
3341
|
|
|
} |
|
3342
|
|
|
|
|
3343
|
|
|
/** |
|
3344
|
|
|
* Import data / Save multiple rows of data at once |
|
3345
|
|
|
* |
|
3346
|
|
|
* @see PodsAPI::import |
|
3347
|
|
|
* |
|
3348
|
|
|
* @param mixed $import_data PHP associative array or CSV input. |
|
3349
|
|
|
* @param bool $numeric_mode Use IDs instead of the name field when matching. |
|
3350
|
|
|
* @param string $format Format of import data, options are php or csv. |
|
|
|
|
|
|
3351
|
|
|
* |
|
3352
|
|
|
* @return array IDs of imported items |
|
3353
|
|
|
* |
|
3354
|
|
|
* @since 2.3 |
|
3355
|
|
|
*/ |
|
3356
|
|
|
public function import( $import_data, $numeric_mode = false, $format = null ) { |
|
3357
|
|
|
|
|
3358
|
|
|
return $this->api->import( $import_data, $numeric_mode, $format ); |
|
3359
|
|
|
} |
|
3360
|
|
|
|
|
3361
|
|
|
/** |
|
3362
|
|
|
* Export an item's data |
|
3363
|
|
|
* |
|
3364
|
|
|
* @see PodsAPI::export_pod_item |
|
3365
|
|
|
* |
|
3366
|
|
|
* @param array $fields (optional) Fields to export. |
|
|
|
|
|
|
3367
|
|
|
* @param int $id (optional) ID of the pod item to export. |
|
|
|
|
|
|
3368
|
|
|
* @param null|string $format (optional) The format of the export (php | json). |
|
3369
|
|
|
* |
|
3370
|
|
|
* @return array|bool Data array of the exported pod item |
|
3371
|
|
|
* |
|
3372
|
|
|
* @since 2.0 |
|
3373
|
|
|
* @link https://pods.io/docs/export/ |
|
3374
|
|
|
*/ |
|
3375
|
|
|
public function export( $fields = null, $id = null, $format = null ) { |
|
3376
|
|
|
|
|
3377
|
|
|
$params = array( |
|
3378
|
|
|
'pod' => $this->pod, |
|
3379
|
|
|
'id' => $id, |
|
3380
|
|
|
'fields' => null, |
|
3381
|
|
|
'depth' => 2, |
|
3382
|
|
|
'flatten' => false, |
|
3383
|
|
|
'context' => null, |
|
3384
|
|
|
'format' => $format, |
|
3385
|
|
|
); |
|
3386
|
|
|
|
|
3387
|
|
|
if ( is_array( $fields ) && ( isset( $fields['fields'] ) || isset( $fields['depth'] ) ) ) { |
|
3388
|
|
|
$params = array_merge( $params, $fields ); |
|
3389
|
|
|
} else { |
|
3390
|
|
|
$params['fields'] = $fields; |
|
3391
|
|
|
} |
|
3392
|
|
|
|
|
3393
|
|
|
if ( isset( $params['fields'] ) && is_array( $params['fields'] ) && ! in_array( $this->pod_data['field_id'], $params['fields'], true ) ) { |
|
3394
|
|
|
$params['fields'] = array_merge( array( $this->pod_data['field_id'] ), $params['fields'] ); |
|
3395
|
|
|
} |
|
3396
|
|
|
|
|
3397
|
|
|
if ( null === $params['id'] ) { |
|
3398
|
|
|
$params['id'] = $this->id(); |
|
3399
|
|
|
} |
|
3400
|
|
|
|
|
3401
|
|
|
$params = (array) $this->do_hook( 'export', $params ); |
|
3402
|
|
|
|
|
3403
|
|
|
if ( empty( $params['id'] ) ) { |
|
3404
|
|
|
return false; |
|
3405
|
|
|
} |
|
3406
|
|
|
|
|
3407
|
|
|
$data = $this->api->export_pod_item( $params ); |
|
3408
|
|
|
|
|
3409
|
|
|
if ( ! empty( $params['format'] ) && 'json' === $params['format'] ) { |
|
3410
|
|
|
$data = wp_json_encode( (array) $data ); |
|
3411
|
|
|
} |
|
3412
|
|
|
|
|
3413
|
|
|
return $data; |
|
3414
|
|
|
} |
|
3415
|
|
|
|
|
3416
|
|
|
/** |
|
3417
|
|
|
* Export data from all items |
|
3418
|
|
|
* |
|
3419
|
|
|
* @see PodsAPI::export |
|
3420
|
|
|
* |
|
3421
|
|
|
* @param array $params An associative array of parameters. |
|
|
|
|
|
|
3422
|
|
|
* |
|
3423
|
|
|
* @return array Data arrays of all exported pod items |
|
3424
|
|
|
* |
|
3425
|
|
|
* @since 2.3 |
|
3426
|
|
|
*/ |
|
3427
|
|
|
public function export_data( $params = null ) { |
|
3428
|
|
|
|
|
3429
|
|
|
$defaults = array( |
|
3430
|
|
|
'fields' => null, |
|
3431
|
|
|
'depth' => 2, |
|
3432
|
|
|
'params' => null, |
|
3433
|
|
|
); |
|
3434
|
|
|
|
|
3435
|
|
|
if ( empty( $params ) ) { |
|
3436
|
|
|
$params = $defaults; |
|
3437
|
|
|
} else { |
|
3438
|
|
|
$params = array_merge( $defaults, (array) $params ); |
|
3439
|
|
|
} |
|
3440
|
|
|
|
|
3441
|
|
|
return $this->api->export( $this, $params ); |
|
3442
|
|
|
} |
|
3443
|
|
|
|
|
3444
|
|
|
/** |
|
3445
|
|
|
* Display the pagination controls, types supported by default |
|
3446
|
|
|
* are simple, paginate and advanced. The base and format parameters |
|
3447
|
|
|
* are used only for the paginate view. |
|
3448
|
|
|
* |
|
3449
|
|
|
* @param array|object $params Associative array of parameters. |
|
|
|
|
|
|
3450
|
|
|
* |
|
3451
|
|
|
* @return string Pagination HTML |
|
3452
|
|
|
* @since 2.0 |
|
3453
|
|
|
* @link https://pods.io/docs/pagination/ |
|
3454
|
|
|
*/ |
|
3455
|
|
|
public function pagination( $params = null ) { |
|
3456
|
|
|
|
|
3457
|
|
|
if ( empty( $params ) ) { |
|
3458
|
|
|
$params = array(); |
|
3459
|
|
|
} elseif ( ! is_array( $params ) ) { |
|
3460
|
|
|
$params = array( 'label' => $params ); |
|
3461
|
|
|
} |
|
3462
|
|
|
|
|
3463
|
|
|
$this->page_var = pods_v( 'page_var', $params, $this->page_var ); |
|
3464
|
|
|
|
|
3465
|
|
|
$url = pods_query_arg( null, null, $this->page_var ); |
|
3466
|
|
|
|
|
3467
|
|
|
$append = '?'; |
|
3468
|
|
|
|
|
3469
|
|
|
if ( false !== strpos( $url, '?' ) ) { |
|
3470
|
|
|
$append = '&'; |
|
3471
|
|
|
} |
|
3472
|
|
|
|
|
3473
|
|
|
$defaults = array( |
|
3474
|
|
|
'type' => 'advanced', |
|
3475
|
|
|
'label' => __( 'Go to page:', 'pods' ), |
|
3476
|
|
|
'show_label' => true, |
|
3477
|
|
|
'first_text' => __( '« First', 'pods' ), |
|
3478
|
|
|
'prev_text' => __( '‹ Previous', 'pods' ), |
|
3479
|
|
|
'next_text' => __( 'Next ›', 'pods' ), |
|
3480
|
|
|
'last_text' => __( 'Last »', 'pods' ), |
|
3481
|
|
|
'prev_next' => true, |
|
3482
|
|
|
'first_last' => true, |
|
3483
|
|
|
'limit' => (int) $this->limit, |
|
3484
|
|
|
'offset' => (int) $this->offset, |
|
3485
|
|
|
'page' => max( 1, (int) $this->page ), |
|
3486
|
|
|
'mid_size' => 2, |
|
3487
|
|
|
'end_size' => 1, |
|
3488
|
|
|
'total_found' => $this->total_found(), |
|
3489
|
|
|
'page_var' => $this->page_var, |
|
3490
|
|
|
'base' => "{$url}{$append}%_%", |
|
3491
|
|
|
'format' => "{$this->page_var}=%#%", |
|
3492
|
|
|
'class' => '', |
|
3493
|
|
|
'link_class' => '', |
|
3494
|
|
|
); |
|
3495
|
|
|
|
|
3496
|
|
|
if ( is_object( $params ) ) { |
|
3497
|
|
|
$params = get_object_vars( $params ); |
|
3498
|
|
|
} |
|
3499
|
|
|
|
|
3500
|
|
|
$params = (object) array_merge( $defaults, (array) $params ); |
|
3501
|
|
|
|
|
3502
|
|
|
$params->total = $this->total_pages( $params->limit, $params->offset, $params->total_found ); |
|
3503
|
|
|
|
|
3504
|
|
|
if ( $params->limit < 1 || $params->total_found < 1 || 1 === $params->total || $params->total_found <= $params->offset ) { |
|
3505
|
|
|
return $this->do_hook( 'pagination', $this->do_hook( 'pagination_' . $params->type, '', $params ), $params ); |
|
3506
|
|
|
} |
|
3507
|
|
|
|
|
3508
|
|
|
$pagination = $params->type; |
|
3509
|
|
|
|
|
3510
|
|
|
if ( ! in_array( $params->type, array( 'simple', 'advanced', 'paginate', 'list' ), true ) ) { |
|
3511
|
|
|
$pagination = 'advanced'; |
|
3512
|
|
|
} |
|
3513
|
|
|
|
|
3514
|
|
|
ob_start(); |
|
3515
|
|
|
|
|
3516
|
|
|
pods_view( PODS_DIR . 'ui/front/pagination/' . $pagination . '.php', compact( array_keys( get_defined_vars() ) ) ); |
|
3517
|
|
|
|
|
3518
|
|
|
$output = ob_get_clean(); |
|
3519
|
|
|
|
|
3520
|
|
|
return $this->do_hook( 'pagination', $this->do_hook( 'pagination_' . $params->type, $output, $params ), $params ); |
|
3521
|
|
|
|
|
3522
|
|
|
} |
|
3523
|
|
|
|
|
3524
|
|
|
/** |
|
3525
|
|
|
* Return a filter form for searching a Pod |
|
3526
|
|
|
* |
|
3527
|
|
|
* @param array|string $params Comma-separated list of fields or array of parameters. |
|
|
|
|
|
|
3528
|
|
|
* |
|
3529
|
|
|
* @return string Filters HTML |
|
3530
|
|
|
* |
|
3531
|
|
|
* @since 2.0 |
|
3532
|
|
|
* @link https://pods.io/docs/filters/ |
|
3533
|
|
|
*/ |
|
3534
|
|
|
public function filters( $params = null ) { |
|
3535
|
|
|
|
|
3536
|
|
|
$defaults = array( |
|
3537
|
|
|
'fields' => $params, |
|
3538
|
|
|
'label' => '', |
|
3539
|
|
|
'action' => '', |
|
3540
|
|
|
'search' => '', |
|
3541
|
|
|
); |
|
3542
|
|
|
|
|
3543
|
|
|
if ( is_array( $params ) ) { |
|
3544
|
|
|
$params = array_merge( $defaults, $params ); |
|
3545
|
|
|
} else { |
|
3546
|
|
|
$params = $defaults; |
|
3547
|
|
|
} |
|
3548
|
|
|
|
|
3549
|
|
|
$pod =& $this; |
|
3550
|
|
|
|
|
3551
|
|
|
/** |
|
3552
|
|
|
* Filter the Pods::filters() parameters. |
|
3553
|
|
|
* |
|
3554
|
|
|
* @param array $params Parameters to filter with. |
|
3555
|
|
|
* @param Pods $pod Pods object. |
|
3556
|
|
|
*/ |
|
3557
|
|
|
$params = apply_filters( 'pods_filters_params', $params, $pod ); |
|
3558
|
|
|
|
|
3559
|
|
|
$fields = $params['fields']; |
|
3560
|
|
|
|
|
3561
|
|
|
if ( null !== $fields && ! is_array( $fields ) && 0 < strlen( $fields ) ) { |
|
3562
|
|
|
$fields = explode( ',', $fields ); |
|
3563
|
|
|
} |
|
3564
|
|
|
|
|
3565
|
|
|
$object_fields = (array) pods_v( 'object_fields', $this->pod_data, array(), true ); |
|
3566
|
|
|
|
|
3567
|
|
|
// Force array. |
|
3568
|
|
|
if ( empty( $fields ) ) { |
|
3569
|
|
|
$fields = array(); |
|
3570
|
|
|
} else { |
|
3571
|
|
|
// Temporary. |
|
3572
|
|
|
$filter_fields = $fields; |
|
3573
|
|
|
|
|
3574
|
|
|
$fields = array(); |
|
3575
|
|
|
|
|
3576
|
|
|
foreach ( $filter_fields as $k => $field ) { |
|
3577
|
|
|
$name = $k; |
|
3578
|
|
|
|
|
3579
|
|
|
$defaults = array( |
|
3580
|
|
|
'name' => $name, |
|
3581
|
|
|
); |
|
3582
|
|
|
|
|
3583
|
|
|
if ( ! is_array( $field ) ) { |
|
3584
|
|
|
$name = $field; |
|
3585
|
|
|
|
|
3586
|
|
|
$field = array( |
|
3587
|
|
|
'name' => $name, |
|
3588
|
|
|
); |
|
3589
|
|
|
} |
|
3590
|
|
|
|
|
3591
|
|
|
// @codingStandardsIgnoreLine. |
|
3592
|
|
|
$field = array_merge( $defaults, $field ); |
|
3593
|
|
|
|
|
3594
|
|
|
$field['name'] = trim( $field['name'] ); |
|
3595
|
|
|
|
|
3596
|
|
|
if ( pods_v( 'hidden', $field, false, true ) ) { |
|
3597
|
|
|
$field['type'] = 'hidden'; |
|
3598
|
|
|
} |
|
3599
|
|
|
|
|
3600
|
|
|
if ( isset( $object_fields[ $field['name'] ] ) ) { |
|
3601
|
|
|
// @codingStandardsIgnoreLine. |
|
3602
|
|
|
$fields[ $field['name'] ] = array_merge( $object_fields[ $field['name'] ], $field ); |
|
3603
|
|
|
} elseif ( isset( $this->fields[ $field['name'] ] ) ) { |
|
3604
|
|
|
// @codingStandardsIgnoreLine. |
|
3605
|
|
|
$fields[ $field['name'] ] = array_merge( $this->fields[ $field['name'] ], $field ); |
|
3606
|
|
|
} |
|
3607
|
|
|
}//end foreach |
|
3608
|
|
|
|
|
3609
|
|
|
// Cleanup. |
|
3610
|
|
|
unset( $filter_fields ); |
|
3611
|
|
|
}//end if |
|
3612
|
|
|
|
|
3613
|
|
|
$this->filters = array_keys( $fields ); |
|
3614
|
|
|
|
|
3615
|
|
|
$label = $params['label']; |
|
3616
|
|
|
|
|
3617
|
|
|
if ( '' === $label ) { |
|
3618
|
|
|
$label = __( 'Search', 'pods' ); |
|
3619
|
|
|
} |
|
3620
|
|
|
|
|
3621
|
|
|
$action = $params['action']; |
|
3622
|
|
|
|
|
3623
|
|
|
$search = trim( $params['search'] ); |
|
3624
|
|
|
|
|
3625
|
|
|
if ( '' === $search ) { |
|
3626
|
|
|
$search = pods_v_sanitized( $pod->search_var, 'get', '' ); |
|
3627
|
|
|
} |
|
3628
|
|
|
|
|
3629
|
|
|
ob_start(); |
|
3630
|
|
|
|
|
3631
|
|
|
pods_view( PODS_DIR . 'ui/front/filters.php', compact( array_keys( get_defined_vars() ) ) ); |
|
3632
|
|
|
|
|
3633
|
|
|
$output = ob_get_clean(); |
|
3634
|
|
|
|
|
3635
|
|
|
/** |
|
3636
|
|
|
* Filter the HTML output of filters() |
|
3637
|
|
|
* |
|
3638
|
|
|
* @since unknown |
|
3639
|
|
|
* |
|
3640
|
|
|
* @param string $output Filter output. |
|
3641
|
|
|
* @param array $params Params array passed to filters(). |
|
3642
|
|
|
* @param object|Pods $this Current Pods object. |
|
3643
|
|
|
*/ |
|
3644
|
|
|
return apply_filters( 'pods_pods_filters', $output, $params, $this ); |
|
3645
|
|
|
} |
|
3646
|
|
|
|
|
3647
|
|
|
/** |
|
3648
|
|
|
* Run a helper within a Pod Page or WP Template |
|
3649
|
|
|
* |
|
3650
|
|
|
* @see Pods_Helpers::helper |
|
3651
|
|
|
* |
|
3652
|
|
|
* @param string|array $helper Helper name. |
|
3653
|
|
|
* @param string $value Value to run the helper on. |
|
|
|
|
|
|
3654
|
|
|
* @param string $name Field name. |
|
|
|
|
|
|
3655
|
|
|
* |
|
3656
|
|
|
* @return mixed Anything returned by the helper |
|
3657
|
|
|
* @since 2.0 |
|
3658
|
|
|
*/ |
|
3659
|
|
|
public function helper( $helper, $value = null, $name = null ) { |
|
3660
|
|
|
|
|
3661
|
|
|
$params = array( |
|
3662
|
|
|
'helper' => $helper, |
|
3663
|
|
|
'value' => $value, |
|
3664
|
|
|
'name' => $name, |
|
3665
|
|
|
'deprecated' => false, |
|
3666
|
|
|
); |
|
3667
|
|
|
|
|
3668
|
|
|
if ( class_exists( 'Pods_Templates' ) ) { |
|
3669
|
|
|
$params['deprecated'] = Pods_Templates::$deprecated; |
|
3670
|
|
|
} |
|
3671
|
|
|
|
|
3672
|
|
|
if ( is_array( $helper ) ) { |
|
3673
|
|
|
$params = array_merge( $params, $helper ); |
|
3674
|
|
|
} |
|
3675
|
|
|
|
|
3676
|
|
|
if ( class_exists( 'Pods_Helpers' ) ) { |
|
3677
|
|
|
$value = Pods_Helpers::helper( $params, $this ); |
|
3678
|
|
|
} elseif ( function_exists( $params['helper'] ) ) { |
|
3679
|
|
|
$disallowed = array( |
|
3680
|
|
|
'system', |
|
3681
|
|
|
'exec', |
|
3682
|
|
|
'popen', |
|
3683
|
|
|
'eval', |
|
3684
|
|
|
'preg_replace', |
|
3685
|
|
|
'create_function', |
|
3686
|
|
|
'include', |
|
3687
|
|
|
'include_once', |
|
3688
|
|
|
'require', |
|
3689
|
|
|
'require_once', |
|
3690
|
|
|
); |
|
3691
|
|
|
|
|
3692
|
|
|
$allowed = array(); |
|
3693
|
|
|
|
|
3694
|
|
|
/** |
|
3695
|
|
|
* Allows adjusting the disallowed callbacks as needed. |
|
3696
|
|
|
* |
|
3697
|
|
|
* @param array $disallowed List of callbacks not allowed. |
|
3698
|
|
|
* @param array $params Parameters used by Pods::helper() method. |
|
3699
|
|
|
* |
|
3700
|
|
|
* @since 2.7 |
|
3701
|
|
|
*/ |
|
3702
|
|
|
$disallowed = apply_filters( 'pods_helper_disallowed_callbacks', $disallowed, $params ); |
|
3703
|
|
|
|
|
3704
|
|
|
/** |
|
3705
|
|
|
* Allows adjusting the allowed allowed callbacks as needed. |
|
3706
|
|
|
* |
|
3707
|
|
|
* @param array $allowed List of callbacks explicitly allowed. |
|
3708
|
|
|
* @param array $params Parameters used by Pods::helper() method. |
|
3709
|
|
|
* |
|
3710
|
|
|
* @since 2.7 |
|
3711
|
|
|
*/ |
|
3712
|
|
|
$allowed = apply_filters( 'pods_helper_allowed_callbacks', $allowed, $params ); |
|
3713
|
|
|
|
|
3714
|
|
|
// Clean up helper callback (if string). |
|
3715
|
|
|
if ( is_string( $params['helper'] ) ) { |
|
3716
|
|
|
$params['helper'] = strip_tags( str_replace( array( '`', chr( 96 ) ), "'", $params['helper'] ) ); |
|
3717
|
|
|
} |
|
3718
|
|
|
|
|
3719
|
|
|
$is_allowed = false; |
|
3720
|
|
|
|
|
3721
|
|
|
if ( ! empty( $allowed ) ) { |
|
3722
|
|
|
if ( in_array( $params['helper'], $allowed, true ) ) { |
|
3723
|
|
|
$is_allowed = true; |
|
3724
|
|
|
} |
|
3725
|
|
|
} elseif ( ! in_array( $params['helper'], $disallowed, true ) ) { |
|
3726
|
|
|
$is_allowed = true; |
|
3727
|
|
|
} |
|
3728
|
|
|
|
|
3729
|
|
|
if ( $is_allowed ) { |
|
3730
|
|
|
$value = call_user_func( $params['helper'], $value ); |
|
3731
|
|
|
} |
|
3732
|
|
|
} else { |
|
3733
|
|
|
$value = apply_filters( $params['helper'], $value ); |
|
3734
|
|
|
}//end if |
|
3735
|
|
|
|
|
3736
|
|
|
return $value; |
|
3737
|
|
|
} |
|
3738
|
|
|
|
|
3739
|
|
|
/** |
|
3740
|
|
|
* Display the page template |
|
3741
|
|
|
* |
|
3742
|
|
|
* @see Pods_Templates::template |
|
3743
|
|
|
* |
|
3744
|
|
|
* @param string $template_name The template name. |
|
3745
|
|
|
* @param string|null $code Custom template code to use instead. |
|
3746
|
|
|
* @param bool $deprecated Whether to use deprecated functionality based on old function usage. |
|
3747
|
|
|
* |
|
3748
|
|
|
* @return mixed Template output |
|
3749
|
|
|
* |
|
3750
|
|
|
* @since 2.0 |
|
3751
|
|
|
* @link https://pods.io/docs/template/ |
|
3752
|
|
|
*/ |
|
3753
|
|
|
public function template( $template_name, $code = null, $deprecated = false ) { |
|
3754
|
|
|
|
|
3755
|
|
|
$out = null; |
|
3756
|
|
|
|
|
3757
|
|
|
$obj =& $this; |
|
3758
|
|
|
|
|
3759
|
|
|
if ( ! empty( $code ) ) { |
|
3760
|
|
|
// backwards compatibility. |
|
3761
|
|
|
$code = str_replace( '$this->', '$obj->', $code ); |
|
3762
|
|
|
|
|
3763
|
|
|
/** |
|
3764
|
|
|
* Filter the template code before running it. |
|
3765
|
|
|
* |
|
3766
|
|
|
* @param string $code Template code. |
|
3767
|
|
|
* @param string $template_name Template name. |
|
3768
|
|
|
* @param Pods $pod Pods object. |
|
3769
|
|
|
*/ |
|
3770
|
|
|
$code = apply_filters( 'pods_templates_pre_template', $code, $template_name, $this ); |
|
3771
|
|
|
|
|
3772
|
|
|
/** |
|
3773
|
|
|
* Filter the template code before running it. |
|
3774
|
|
|
* |
|
3775
|
|
|
* @param string $code Template code. |
|
3776
|
|
|
* @param string $template_name Template name. |
|
3777
|
|
|
* @param Pods $pod Pods object. |
|
3778
|
|
|
*/ |
|
3779
|
|
|
$code = apply_filters( "pods_templates_pre_template_{$template_name}", $code, $template_name, $this ); |
|
3780
|
|
|
|
|
3781
|
|
|
ob_start(); |
|
3782
|
|
|
|
|
3783
|
|
|
if ( ! empty( $code ) ) { |
|
3784
|
|
|
// Only detail templates need $this->id. |
|
3785
|
|
|
if ( empty( $this->id ) ) { |
|
3786
|
|
|
while ( $this->fetch() ) { |
|
3787
|
|
|
// @codingStandardsIgnoreLine |
|
3788
|
|
|
echo $this->do_magic_tags( $code ); |
|
3789
|
|
|
} |
|
3790
|
|
|
} else { |
|
3791
|
|
|
// @codingStandardsIgnoreLine |
|
3792
|
|
|
echo $this->do_magic_tags( $code ); |
|
3793
|
|
|
} |
|
3794
|
|
|
} |
|
3795
|
|
|
|
|
3796
|
|
|
$out = ob_get_clean(); |
|
3797
|
|
|
|
|
3798
|
|
|
/** |
|
3799
|
|
|
* Filter the template output. |
|
3800
|
|
|
* |
|
3801
|
|
|
* @param string $out Template output. |
|
3802
|
|
|
* @param string $code Template code. |
|
3803
|
|
|
* @param string $template_name Template name. |
|
3804
|
|
|
* @param Pods $pod Pods object. |
|
3805
|
|
|
*/ |
|
3806
|
|
|
$out = apply_filters( 'pods_templates_post_template', $out, $code, $template_name, $this ); |
|
3807
|
|
|
|
|
3808
|
|
|
/** |
|
3809
|
|
|
* Filter the template output. |
|
3810
|
|
|
* |
|
3811
|
|
|
* @param string $out Template output. |
|
3812
|
|
|
* @param string $code Template code. |
|
3813
|
|
|
* @param string $template_name Template name. |
|
3814
|
|
|
* @param Pods $pod Pods object. |
|
3815
|
|
|
*/ |
|
3816
|
|
|
$out = apply_filters( "pods_templates_post_template_{$template_name}", $out, $code, $template_name, $this ); |
|
3817
|
|
|
} elseif ( class_exists( 'Pods_Templates' ) ) { |
|
3818
|
|
|
$out = Pods_Templates::template( $template_name, $code, $this, $deprecated ); |
|
3819
|
|
|
} elseif ( trim( preg_replace( '/[^a-zA-Z0-9_\-\/]/', '', $template_name ), ' /-' ) === $template_name ) { |
|
3820
|
|
|
ob_start(); |
|
3821
|
|
|
|
|
3822
|
|
|
$default_templates = array( |
|
3823
|
|
|
'pods/' . $template_name, |
|
3824
|
|
|
'pods-' . $template_name, |
|
3825
|
|
|
$template_name, |
|
3826
|
|
|
); |
|
3827
|
|
|
|
|
3828
|
|
|
/** |
|
3829
|
|
|
* Filter the default Pods Template files. |
|
3830
|
|
|
* |
|
3831
|
|
|
* @param array $default_templates Default Pods Template files. |
|
3832
|
|
|
*/ |
|
3833
|
|
|
$default_templates = apply_filters( 'pods_template_default_templates', $default_templates ); |
|
3834
|
|
|
|
|
3835
|
|
|
// Only detail templates need $this->id. |
|
3836
|
|
|
if ( empty( $this->id ) ) { |
|
3837
|
|
|
while ( $this->fetch() ) { |
|
3838
|
|
|
pods_template_part( $default_templates, compact( array_keys( get_defined_vars() ) ) ); |
|
3839
|
|
|
} |
|
3840
|
|
|
} else { |
|
3841
|
|
|
pods_template_part( $default_templates, compact( array_keys( get_defined_vars() ) ) ); |
|
3842
|
|
|
} |
|
3843
|
|
|
|
|
3844
|
|
|
$out = ob_get_clean(); |
|
3845
|
|
|
|
|
3846
|
|
|
/** |
|
3847
|
|
|
* Filter the template output. |
|
3848
|
|
|
* |
|
3849
|
|
|
* @param string $out Template output. |
|
3850
|
|
|
* @param string $code Template code. |
|
3851
|
|
|
* @param string $template_name Template name. |
|
3852
|
|
|
* @param Pods $pod Pods object. |
|
3853
|
|
|
*/ |
|
3854
|
|
|
$out = apply_filters( 'pods_templates_post_template', $out, $code, $template_name, $this ); |
|
3855
|
|
|
|
|
3856
|
|
|
/** |
|
3857
|
|
|
* Filter the template output. |
|
3858
|
|
|
* |
|
3859
|
|
|
* @param string $out Template output. |
|
3860
|
|
|
* @param string $code Template code. |
|
3861
|
|
|
* @param string $template_name Template name. |
|
3862
|
|
|
* @param Pods $pod Pods object. |
|
3863
|
|
|
*/ |
|
3864
|
|
|
$out = apply_filters( "pods_templates_post_template_{$template_name}", $out, $code, $template_name, $this ); |
|
3865
|
|
|
}//end if |
|
3866
|
|
|
|
|
3867
|
|
|
return $out; |
|
3868
|
|
|
} |
|
3869
|
|
|
|
|
3870
|
|
|
/** |
|
3871
|
|
|
* Embed a form to add / edit a pod item from within your theme. Provide an array of $fields to include |
|
3872
|
|
|
* and override options where needed. For WP object based Pods, you can pass through the WP object |
|
3873
|
|
|
* field names too, such as "post_title" or "post_content" for example. |
|
3874
|
|
|
* |
|
3875
|
|
|
* @param array $params (optional) Fields to show on the form, defaults to all fields. |
|
|
|
|
|
|
3876
|
|
|
* @param string $label (optional) Save button label, defaults to "Save Changes". |
|
|
|
|
|
|
3877
|
|
|
* @param string $thank_you (optional) Thank you URL to send to upon success. |
|
|
|
|
|
|
3878
|
|
|
* |
|
3879
|
|
|
* @return bool|mixed |
|
3880
|
|
|
* @since 2.0 |
|
3881
|
|
|
* @link https://pods.io/docs/form/ |
|
3882
|
|
|
*/ |
|
3883
|
|
|
public function form( $params = null, $label = null, $thank_you = null ) { |
|
3884
|
|
|
|
|
3885
|
|
|
$defaults = array( |
|
3886
|
|
|
'fields' => $params, |
|
3887
|
|
|
'label' => $label, |
|
3888
|
|
|
'thank_you' => $thank_you, |
|
3889
|
|
|
'fields_only' => false, |
|
3890
|
|
|
); |
|
3891
|
|
|
|
|
3892
|
|
|
if ( is_array( $params ) ) { |
|
3893
|
|
|
$params = array_merge( $defaults, $params ); |
|
3894
|
|
|
} else { |
|
3895
|
|
|
$params = $defaults; |
|
3896
|
|
|
} |
|
3897
|
|
|
|
|
3898
|
|
|
$pod =& $this; |
|
3899
|
|
|
|
|
3900
|
|
|
$params = $this->do_hook( 'form_params', $params ); |
|
3901
|
|
|
|
|
3902
|
|
|
$fields = $params['fields']; |
|
3903
|
|
|
|
|
3904
|
|
|
if ( null !== $fields && ! is_array( $fields ) && 0 < strlen( $fields ) ) { |
|
3905
|
|
|
$fields = explode( ',', $fields ); |
|
3906
|
|
|
} |
|
3907
|
|
|
|
|
3908
|
|
|
$object_fields = (array) pods_v( 'object_fields', $this->pod_data, array(), true ); |
|
3909
|
|
|
|
|
3910
|
|
|
if ( empty( $fields ) ) { |
|
3911
|
|
|
// Add core object fields if $fields is empty. |
|
3912
|
|
|
$fields = array_merge( $object_fields, $this->fields ); |
|
3913
|
|
|
} |
|
3914
|
|
|
|
|
3915
|
|
|
// Temporary. |
|
3916
|
|
|
$form_fields = $fields; |
|
3917
|
|
|
|
|
3918
|
|
|
$fields = array(); |
|
3919
|
|
|
|
|
3920
|
|
|
foreach ( $form_fields as $k => $field ) { |
|
3921
|
|
|
$name = $k; |
|
3922
|
|
|
|
|
3923
|
|
|
$defaults = array( |
|
3924
|
|
|
'name' => $name, |
|
3925
|
|
|
); |
|
3926
|
|
|
|
|
3927
|
|
|
if ( ! is_array( $field ) ) { |
|
3928
|
|
|
$name = $field; |
|
3929
|
|
|
|
|
3930
|
|
|
$field = array( |
|
3931
|
|
|
'name' => $name, |
|
3932
|
|
|
); |
|
3933
|
|
|
} |
|
3934
|
|
|
|
|
3935
|
|
|
// @codingStandardsIgnoreLine. |
|
3936
|
|
|
$field = array_merge( $defaults, $field ); |
|
3937
|
|
|
|
|
3938
|
|
|
$field['name'] = trim( $field['name'] ); |
|
3939
|
|
|
|
|
3940
|
|
|
$default_value = pods_v( 'default', $field ); |
|
3941
|
|
|
$value = pods_v( 'value', $field ); |
|
3942
|
|
|
|
|
3943
|
|
|
if ( empty( $field['name'] ) ) { |
|
3944
|
|
|
$field['name'] = trim( $name ); |
|
3945
|
|
|
} |
|
3946
|
|
|
|
|
3947
|
|
|
if ( isset( $object_fields[ $field['name'] ] ) ) { |
|
3948
|
|
|
// @codingStandardsIgnoreLine. |
|
3949
|
|
|
$field = array_merge( $object_fields[ $field['name'] ], $field ); |
|
3950
|
|
|
} elseif ( isset( $this->fields[ $field['name'] ] ) ) { |
|
3951
|
|
|
// @codingStandardsIgnoreLine. |
|
3952
|
|
|
$field = array_merge( $this->fields[ $field['name'] ], $field ); |
|
3953
|
|
|
} |
|
3954
|
|
|
|
|
3955
|
|
|
if ( pods_v( 'hidden', $field, false, true ) ) { |
|
3956
|
|
|
$field['type'] = 'hidden'; |
|
3957
|
|
|
} |
|
3958
|
|
|
|
|
3959
|
|
|
$fields[ $field['name'] ] = $field; |
|
3960
|
|
|
|
|
3961
|
|
|
if ( empty( $this->id ) && null !== $default_value ) { |
|
3962
|
|
|
$this->row_override[ $field['name'] ] = $default_value; |
|
3963
|
|
|
} elseif ( ! empty( $this->id ) && null !== $value ) { |
|
3964
|
|
|
$this->row[ $field['name'] ] = $value; |
|
3965
|
|
|
} |
|
3966
|
|
|
}//end foreach |
|
3967
|
|
|
|
|
3968
|
|
|
// Cleanup. |
|
3969
|
|
|
unset( $form_fields ); |
|
3970
|
|
|
|
|
3971
|
|
|
$fields = $this->do_hook( 'form_fields', $fields, $params ); |
|
3972
|
|
|
|
|
3973
|
|
|
$label = $params['label']; |
|
3974
|
|
|
|
|
3975
|
|
|
if ( empty( $label ) ) { |
|
3976
|
|
|
$label = __( 'Save Changes', 'pods' ); |
|
3977
|
|
|
} |
|
3978
|
|
|
|
|
3979
|
|
|
$thank_you = $params['thank_you']; |
|
3980
|
|
|
$fields_only = $params['fields_only']; |
|
3981
|
|
|
|
|
3982
|
|
|
PodsForm::$form_counter ++; |
|
3983
|
|
|
|
|
3984
|
|
|
ob_start(); |
|
3985
|
|
|
|
|
3986
|
|
|
if ( empty( $thank_you ) ) { |
|
3987
|
|
|
$success = 'success'; |
|
3988
|
|
|
|
|
3989
|
|
|
if ( 1 < PodsForm::$form_counter ) { |
|
3990
|
|
|
$success .= PodsForm::$form_counter; |
|
3991
|
|
|
} |
|
3992
|
|
|
|
|
3993
|
|
|
$thank_you = pods_query_arg( array( |
|
3994
|
|
|
'success*' => null, |
|
3995
|
|
|
$success => 1, |
|
3996
|
|
|
) ); |
|
3997
|
|
|
|
|
3998
|
|
|
if ( 1 === (int) pods_v( $success, 'get', 0 ) ) { |
|
3999
|
|
|
$message = __( 'Form submitted successfully', 'pods' ); |
|
4000
|
|
|
|
|
4001
|
|
|
/** |
|
4002
|
|
|
* Change the text of the message that appears on successful form submission. |
|
4003
|
|
|
* |
|
4004
|
|
|
* @param string $message Success message. |
|
4005
|
|
|
* |
|
4006
|
|
|
* @since 2.7 |
|
4007
|
|
|
*/ |
|
4008
|
|
|
$message = apply_filters( 'pods_pod_form_success_message', $message ); |
|
4009
|
|
|
|
|
4010
|
|
|
echo '<div id="message" class="pods-form-front-success">' . wp_kses_post( $message ) . '</div>'; |
|
4011
|
|
|
} |
|
4012
|
|
|
}//end if |
|
4013
|
|
|
|
|
4014
|
|
|
pods_view( PODS_DIR . 'ui/front/form.php', compact( array_keys( get_defined_vars() ) ) ); |
|
4015
|
|
|
|
|
4016
|
|
|
$output = ob_get_clean(); |
|
4017
|
|
|
|
|
4018
|
|
|
if ( empty( $this->id ) ) { |
|
4019
|
|
|
$this->row_override = array(); |
|
4020
|
|
|
} |
|
4021
|
|
|
|
|
4022
|
|
|
return $this->do_hook( 'form', $output, $fields, $label, $thank_you, $this, $this->id() ); |
|
4023
|
|
|
} |
|
4024
|
|
|
|
|
4025
|
|
|
/** |
|
4026
|
|
|
* Render a singular view for the Pod item content. |
|
4027
|
|
|
* |
|
4028
|
|
|
* @param array|string|null $fields (optional) Fields to show in the view, defaults to all fields. |
|
4029
|
|
|
* |
|
4030
|
|
|
* @return mixed |
|
4031
|
|
|
* @since 2.3.10 |
|
4032
|
|
|
*/ |
|
4033
|
|
|
public function view( $fields = null ) { |
|
4034
|
|
|
|
|
4035
|
|
|
$pod =& $this; |
|
4036
|
|
|
|
|
4037
|
|
|
// Convert comma separated list of fields to an array. |
|
4038
|
|
|
if ( null !== $fields && ! is_array( $fields ) && 0 < strlen( $fields ) ) { |
|
4039
|
|
|
$fields = explode( ',', $fields ); |
|
4040
|
|
|
} |
|
4041
|
|
|
|
|
4042
|
|
|
$object_fields = (array) pods_v( 'object_fields', $this->pod_data, array(), true ); |
|
4043
|
|
|
|
|
4044
|
|
|
if ( empty( $fields ) ) { |
|
4045
|
|
|
// Add core object fields if $fields is empty. |
|
4046
|
|
|
$fields = array_merge( $object_fields, $this->fields ); |
|
4047
|
|
|
} |
|
4048
|
|
|
|
|
4049
|
|
|
// Temporary. |
|
4050
|
|
|
$view_fields = $fields; |
|
4051
|
|
|
|
|
4052
|
|
|
$fields = array(); |
|
4053
|
|
|
|
|
4054
|
|
|
foreach ( $view_fields as $name => $field ) { |
|
|
|
|
|
|
4055
|
|
|
$defaults = array( |
|
4056
|
|
|
'name' => $name, |
|
4057
|
|
|
); |
|
4058
|
|
|
|
|
4059
|
|
|
if ( ! is_array( $field ) ) { |
|
4060
|
|
|
$name = $field; |
|
4061
|
|
|
|
|
4062
|
|
|
$field = array( |
|
4063
|
|
|
'name' => $name, |
|
4064
|
|
|
); |
|
4065
|
|
|
} |
|
4066
|
|
|
|
|
4067
|
|
|
// @codingStandardsIgnoreLine. |
|
4068
|
|
|
$field = array_merge( $defaults, $field ); |
|
4069
|
|
|
|
|
4070
|
|
|
$field['name'] = trim( $field['name'] ); |
|
4071
|
|
|
|
|
4072
|
|
|
if ( empty( $field['name'] ) ) { |
|
4073
|
|
|
$field['name'] = trim( $name ); |
|
4074
|
|
|
} |
|
4075
|
|
|
|
|
4076
|
|
|
if ( isset( $object_fields[ $field['name'] ] ) ) { |
|
4077
|
|
|
// @codingStandardsIgnoreLine. |
|
4078
|
|
|
$field = array_merge( $field, $object_fields[ $field['name'] ] ); |
|
4079
|
|
|
} elseif ( isset( $this->fields[ $field['name'] ] ) ) { |
|
4080
|
|
|
// @codingStandardsIgnoreLine. |
|
4081
|
|
|
$field = array_merge( $this->fields[ $field['name'] ], $field ); |
|
4082
|
|
|
} |
|
4083
|
|
|
|
|
4084
|
|
|
if ( pods_v( 'hidden', $field, false, true ) || 'hidden' === $field['type'] ) { |
|
4085
|
|
|
continue; |
|
4086
|
|
|
} elseif ( ! PodsForm::permission( $field['type'], $field['name'], $field['options'], $fields, $pod, $pod->id() ) ) { |
|
4087
|
|
|
continue; |
|
4088
|
|
|
} |
|
4089
|
|
|
|
|
4090
|
|
|
$fields[ $field['name'] ] = $field; |
|
4091
|
|
|
}//end foreach |
|
4092
|
|
|
|
|
4093
|
|
|
// Cleanup. |
|
4094
|
|
|
unset( $view_fields ); |
|
4095
|
|
|
|
|
4096
|
|
|
$output = pods_view( PODS_DIR . 'ui/front/view.php', compact( array_keys( get_defined_vars() ) ), false, 'cache', true ); |
|
4097
|
|
|
|
|
4098
|
|
|
return $this->do_hook( 'view', $output, $fields, $this->id() ); |
|
4099
|
|
|
|
|
4100
|
|
|
} |
|
4101
|
|
|
|
|
4102
|
|
|
/** |
|
4103
|
|
|
* Replace magic tags with their values |
|
4104
|
|
|
* |
|
4105
|
|
|
* @param string $code The content to evaluate. |
|
4106
|
|
|
* |
|
4107
|
|
|
* @return string Code with Magic Tags evaluated |
|
4108
|
|
|
* |
|
4109
|
|
|
* @since 2.0 |
|
4110
|
|
|
*/ |
|
4111
|
|
|
public function do_magic_tags( $code ) { |
|
4112
|
|
|
|
|
4113
|
|
|
/** |
|
4114
|
|
|
* Filters the Pods magic tags content before the default function. |
|
4115
|
|
|
* Allows complete replacement of the Pods magic tag engine. |
|
4116
|
|
|
* |
|
4117
|
|
|
* @param null $pre Default is null which processes magic tags normally. Return any other value to override. |
|
4118
|
|
|
* @param string $code The content to evaluate. |
|
4119
|
|
|
* @param Pods $pods The Pods Object. |
|
4120
|
|
|
* |
|
4121
|
|
|
* @since 2.7 |
|
4122
|
|
|
*/ |
|
4123
|
|
|
$pre = apply_filters( 'pods_pre_do_magic_tags', null, $code, $this ); |
|
4124
|
|
|
if ( null !== $pre ) { |
|
4125
|
|
|
return $pre; |
|
4126
|
|
|
} |
|
4127
|
|
|
|
|
4128
|
|
|
return preg_replace_callback( '/({@(.*?)})/m', array( $this, 'process_magic_tags' ), $code ); |
|
4129
|
|
|
} |
|
4130
|
|
|
|
|
4131
|
|
|
/** |
|
4132
|
|
|
* Replace magic tags with their values |
|
4133
|
|
|
* |
|
4134
|
|
|
* @param string|array $tag The magic tag to process. |
|
4135
|
|
|
* |
|
4136
|
|
|
* @return string Code with Magic Tags evaluated |
|
4137
|
|
|
* |
|
4138
|
|
|
* @since 2.0.2 |
|
4139
|
|
|
*/ |
|
4140
|
|
|
private function process_magic_tags( $tag ) { |
|
4141
|
|
|
|
|
4142
|
|
|
if ( is_array( $tag ) ) { |
|
4143
|
|
|
if ( ! isset( $tag[2] ) && '' === trim( $tag[2] ) ) { |
|
4144
|
|
|
return ''; |
|
4145
|
|
|
} |
|
4146
|
|
|
|
|
4147
|
|
|
$tag = $tag[2]; |
|
4148
|
|
|
} |
|
4149
|
|
|
|
|
4150
|
|
|
$tag = trim( $tag, ' {@}' ); |
|
4151
|
|
|
$tag = explode( ',', $tag ); |
|
4152
|
|
|
|
|
4153
|
|
|
if ( empty( $tag ) || ! isset( $tag[0] ) || '' === trim( $tag[0] ) ) { |
|
4154
|
|
|
return ''; |
|
4155
|
|
|
} |
|
4156
|
|
|
|
|
4157
|
|
|
foreach ( $tag as $k => $v ) { |
|
4158
|
|
|
$tag[ $k ] = trim( $v ); |
|
4159
|
|
|
} |
|
4160
|
|
|
|
|
4161
|
|
|
$field_name = $tag[0]; |
|
4162
|
|
|
|
|
4163
|
|
|
$helper_name = ''; |
|
4164
|
|
|
$before = ''; |
|
4165
|
|
|
$after = ''; |
|
4166
|
|
|
|
|
4167
|
|
|
if ( isset( $tag[1] ) && ! empty( $tag[1] ) ) { |
|
4168
|
|
|
$value = $this->field( $field_name ); |
|
4169
|
|
|
|
|
4170
|
|
|
$helper_name = $tag[1]; |
|
4171
|
|
|
|
|
4172
|
|
|
$value = $this->helper( $helper_name, $value, $field_name ); |
|
4173
|
|
|
} else { |
|
4174
|
|
|
$value = $this->display( $field_name ); |
|
4175
|
|
|
} |
|
4176
|
|
|
|
|
4177
|
|
|
if ( isset( $tag[2] ) && ! empty( $tag[2] ) ) { |
|
4178
|
|
|
$before = $tag[2]; |
|
4179
|
|
|
} |
|
4180
|
|
|
|
|
4181
|
|
|
if ( isset( $tag[3] ) && ! empty( $tag[3] ) ) { |
|
4182
|
|
|
$after = $tag[3]; |
|
4183
|
|
|
} |
|
4184
|
|
|
|
|
4185
|
|
|
/** |
|
4186
|
|
|
* Filter the magic tag output for a value. |
|
4187
|
|
|
* |
|
4188
|
|
|
* @param string $value Magic tag output for value. |
|
4189
|
|
|
* @param string $field_name Magic tag field name. |
|
4190
|
|
|
* @param string $before Before content. |
|
4191
|
|
|
* @param string $after After content. |
|
4192
|
|
|
*/ |
|
4193
|
|
|
$value = apply_filters( 'pods_do_magic_tags', $value, $field_name, $helper_name, $before, $after ); |
|
4194
|
|
|
|
|
4195
|
|
|
if ( is_array( $value ) ) { |
|
4196
|
|
|
$value = pods_serial_comma( $value, array( |
|
4197
|
|
|
'field' => $field_name, |
|
4198
|
|
|
'fields' => $this->fields, |
|
4199
|
|
|
) ); |
|
4200
|
|
|
} |
|
4201
|
|
|
|
|
4202
|
|
|
if ( null !== $value && false !== $value ) { |
|
4203
|
|
|
return $before . $value . $after; |
|
4204
|
|
|
} |
|
4205
|
|
|
|
|
4206
|
|
|
return ''; |
|
4207
|
|
|
} |
|
4208
|
|
|
|
|
4209
|
|
|
/** |
|
4210
|
|
|
* |
|
4211
|
|
|
* Generate UI for Data Management |
|
4212
|
|
|
* |
|
4213
|
|
|
* @param mixed $options Array or String containing Pod or Options to be used. |
|
4214
|
|
|
* @param bool $amend Whether to amend the default UI options or replace entirely. |
|
4215
|
|
|
* |
|
4216
|
|
|
* @return PodsUI|null UI object or null if custom UI used |
|
4217
|
|
|
* |
|
4218
|
|
|
* @since 2.3.10 |
|
4219
|
|
|
*/ |
|
4220
|
|
|
public function ui( $options = null, $amend = false ) { |
|
|
|
|
|
|
4221
|
|
|
|
|
4222
|
|
|
$num = ''; |
|
4223
|
|
|
|
|
4224
|
|
|
if ( empty( $options ) ) { |
|
4225
|
|
|
$options = array(); |
|
4226
|
|
|
} else { |
|
4227
|
|
|
$num = pods_v_sanitized( 'num', $options, '' ); |
|
4228
|
|
|
|
|
4229
|
|
|
if ( empty( $num ) ) { |
|
4230
|
|
|
$num = ''; |
|
4231
|
|
|
} |
|
4232
|
|
|
} |
|
4233
|
|
|
|
|
4234
|
|
|
$check_id = pods_v( 'id' . $num, 'get', null, true ); |
|
4235
|
|
|
|
|
4236
|
|
|
// @codingStandardsIgnoreLine |
|
4237
|
|
|
if ( $this->id() != $check_id ) { |
|
4238
|
|
|
$this->fetch( $check_id ); |
|
4239
|
|
|
} |
|
4240
|
|
|
|
|
4241
|
|
|
if ( ! empty( $options ) && ! $amend ) { |
|
4242
|
|
|
$this->ui = $options; |
|
4243
|
|
|
|
|
4244
|
|
|
return pods_ui( $this ); |
|
4245
|
|
|
} elseif ( ! empty( $options ) || 'custom' !== pods_v( 'ui_style', $this->pod_data['options'], 'post_type', true ) ) { |
|
4246
|
|
|
$actions_enabled = pods_v( 'ui_actions_enabled', $this->pod_data['options'] ); |
|
4247
|
|
|
|
|
4248
|
|
|
if ( ! empty( $actions_enabled ) ) { |
|
4249
|
|
|
$actions_enabled = (array) $actions_enabled; |
|
4250
|
|
|
} else { |
|
4251
|
|
|
$actions_enabled = array(); |
|
4252
|
|
|
} |
|
4253
|
|
|
|
|
4254
|
|
|
$available_actions = array( |
|
4255
|
|
|
'add', |
|
4256
|
|
|
'edit', |
|
4257
|
|
|
'duplicate', |
|
4258
|
|
|
'delete', |
|
4259
|
|
|
'reorder', |
|
4260
|
|
|
'export', |
|
4261
|
|
|
); |
|
4262
|
|
|
|
|
4263
|
|
|
if ( ! empty( $actions_enabled ) ) { |
|
4264
|
|
|
$actions_disabled = array( |
|
4265
|
|
|
'view' => 'view', |
|
4266
|
|
|
); |
|
4267
|
|
|
|
|
4268
|
|
|
foreach ( $available_actions as $action ) { |
|
4269
|
|
|
if ( ! in_array( $action, $actions_enabled, true ) ) { |
|
4270
|
|
|
$actions_disabled[ $action ] = $action; |
|
4271
|
|
|
} |
|
4272
|
|
|
} |
|
4273
|
|
|
} else { |
|
4274
|
|
|
$actions_disabled = array( |
|
4275
|
|
|
'duplicate' => 'duplicate', |
|
4276
|
|
|
'view' => 'view', |
|
4277
|
|
|
'export' => 'export', |
|
4278
|
|
|
); |
|
4279
|
|
|
|
|
4280
|
|
|
if ( 1 === pods_v( 'ui_export', $this->pod_data['options'], 0 ) ) { |
|
4281
|
|
|
unset( $actions_disabled['export'] ); |
|
4282
|
|
|
} |
|
4283
|
|
|
}//end if |
|
4284
|
|
|
|
|
4285
|
|
|
if ( empty( $options ) ) { |
|
4286
|
|
|
$author_restrict = false; |
|
4287
|
|
|
|
|
4288
|
|
|
if ( isset( $this->fields['author'] ) && 'pick' === $this->fields['author']['type'] && 'user' === $this->fields['author']['pick_object'] ) { |
|
4289
|
|
|
$author_restrict = 'author.ID'; |
|
4290
|
|
|
} |
|
4291
|
|
|
|
|
4292
|
|
|
if ( ! pods_is_admin( array( 'pods', 'pods_content' ) ) ) { |
|
4293
|
|
|
if ( ! current_user_can( 'pods_add_' . $this->pod ) ) { |
|
4294
|
|
|
$actions_disabled['add'] = 'add'; |
|
4295
|
|
|
|
|
4296
|
|
|
if ( 'add' === pods_v( 'action' . $num ) ) { |
|
4297
|
|
|
$_GET[ 'action' . $num ] = 'manage'; |
|
4298
|
|
|
} |
|
4299
|
|
|
} |
|
4300
|
|
|
|
|
4301
|
|
|
if ( ! $author_restrict && ! current_user_can( 'pods_edit_' . $this->pod ) && ! current_user_can( 'pods_edit_others_' . $this->pod ) ) { |
|
|
|
|
|
|
4302
|
|
|
$actions_disabled['edit'] = 'edit'; |
|
4303
|
|
|
} |
|
4304
|
|
|
|
|
4305
|
|
|
if ( ! $author_restrict && ! current_user_can( 'pods_delete_' . $this->pod ) && ! current_user_can( 'pods_delete_others_' . $this->pod ) ) { |
|
|
|
|
|
|
4306
|
|
|
$actions_disabled['delete'] = 'delete'; |
|
4307
|
|
|
} |
|
4308
|
|
|
|
|
4309
|
|
|
if ( ! current_user_can( 'pods_reorder_' . $this->pod ) ) { |
|
4310
|
|
|
$actions_disabled['reorder'] = 'reorder'; |
|
4311
|
|
|
} |
|
4312
|
|
|
|
|
4313
|
|
|
if ( ! current_user_can( 'pods_export_' . $this->pod ) ) { |
|
4314
|
|
|
$actions_disabled['export'] = 'export'; |
|
4315
|
|
|
} |
|
4316
|
|
|
}//end if |
|
4317
|
|
|
}//end if |
|
4318
|
|
|
|
|
4319
|
|
|
$_GET[ 'action' . $num ] = pods_v_sanitized( 'action' . $num, 'get', pods_v( 'action', $options, 'manage' ), true ); |
|
4320
|
|
|
|
|
4321
|
|
|
$index = $this->pod_data['field_id']; |
|
4322
|
|
|
$label = __( 'ID', 'pods' ); |
|
4323
|
|
|
|
|
4324
|
|
|
if ( isset( $this->pod_data['fields'][ $this->pod_data['field_index'] ] ) ) { |
|
4325
|
|
|
$index = $this->pod_data['field_index']; |
|
4326
|
|
|
$label = $this->pod_data['fields'][ $this->pod_data['field_index'] ]; |
|
4327
|
|
|
} |
|
4328
|
|
|
|
|
4329
|
|
|
$manage = array( |
|
4330
|
|
|
$index => $label, |
|
4331
|
|
|
); |
|
4332
|
|
|
|
|
4333
|
|
|
if ( isset( $this->pod_data['fields']['modified'] ) ) { |
|
4334
|
|
|
$manage['modified'] = $this->pod_data['fields']['modified']['label']; |
|
4335
|
|
|
} |
|
4336
|
|
|
|
|
4337
|
|
|
$manage_fields = (array) pods_v( 'ui_fields_manage', $this->pod_data['options'] ); |
|
4338
|
|
|
|
|
4339
|
|
|
if ( ! empty( $manage_fields ) ) { |
|
4340
|
|
|
$manage_new = array(); |
|
4341
|
|
|
|
|
4342
|
|
|
foreach ( $manage_fields as $manage_field ) { |
|
4343
|
|
|
if ( isset( $this->pod_data['fields'][ $manage_field ] ) ) { |
|
4344
|
|
|
$manage_new[ $manage_field ] = $this->pod_data['fields'][ $manage_field ]; |
|
4345
|
|
|
} elseif ( isset( $this->pod_data['object_fields'][ $manage_field ] ) ) { |
|
4346
|
|
|
$manage_new[ $manage_field ] = $this->pod_data['object_fields'][ $manage_field ]; |
|
4347
|
|
|
} elseif ( $manage_field === $this->pod_data['field_id'] ) { |
|
4348
|
|
|
$field = array( |
|
4349
|
|
|
'name' => $manage_field, |
|
4350
|
|
|
'label' => 'ID', |
|
4351
|
|
|
'type' => 'number', |
|
4352
|
|
|
'width' => '8%', |
|
4353
|
|
|
); |
|
4354
|
|
|
|
|
4355
|
|
|
$manage_new[ $manage_field ] = PodsForm::field_setup( $field, null, $field['type'] ); |
|
4356
|
|
|
} |
|
4357
|
|
|
} |
|
4358
|
|
|
|
|
4359
|
|
|
if ( ! empty( $manage_new ) ) { |
|
4360
|
|
|
$manage = $manage_new; |
|
4361
|
|
|
} |
|
4362
|
|
|
}//end if |
|
4363
|
|
|
|
|
4364
|
|
|
$manage = apply_filters( 'pods_admin_ui_fields_' . $this->pod, apply_filters( 'pods_admin_ui_fields', $manage, $this->pod, $this ), $this->pod, $this ); |
|
4365
|
|
|
|
|
4366
|
|
|
$icon = pods_v( 'ui_icon', $this->pod_data['options'] ); |
|
4367
|
|
|
|
|
4368
|
|
|
if ( ! empty( $icon ) ) { |
|
4369
|
|
|
$icon = pods_image_url( $icon, '32x32' ); |
|
4370
|
|
|
} |
|
4371
|
|
|
|
|
4372
|
|
|
$filters = pods_v( 'ui_filters', $this->pod_data['options'] ); |
|
4373
|
|
|
|
|
4374
|
|
|
if ( ! empty( $filters ) ) { |
|
4375
|
|
|
$filters_new = array(); |
|
4376
|
|
|
|
|
4377
|
|
|
$filters = (array) $filters; |
|
4378
|
|
|
|
|
4379
|
|
|
foreach ( $filters as $filter_field ) { |
|
4380
|
|
|
if ( isset( $this->pod_data['fields'][ $filter_field ] ) ) { |
|
4381
|
|
|
$filters_new[ $filter_field ] = $this->pod_data['fields'][ $filter_field ]; |
|
4382
|
|
|
} elseif ( isset( $this->pod_data['object_fields'][ $filter_field ] ) ) { |
|
4383
|
|
|
$filters_new[ $filter_field ] = $this->pod_data['object_fields'][ $filter_field ]; |
|
4384
|
|
|
} |
|
4385
|
|
|
} |
|
4386
|
|
|
|
|
4387
|
|
|
$filters = $filters_new; |
|
4388
|
|
|
} |
|
4389
|
|
|
|
|
4390
|
|
|
$ui = array( |
|
|
|
|
|
|
4391
|
|
|
'fields' => array( |
|
4392
|
|
|
'manage' => $manage, |
|
4393
|
|
|
'add' => $this->pod_data['fields'], |
|
4394
|
|
|
'edit' => $this->pod_data['fields'], |
|
4395
|
|
|
'duplicate' => $this->pod_data['fields'], |
|
4396
|
|
|
), |
|
4397
|
|
|
'icon' => $icon, |
|
4398
|
|
|
'actions_disabled' => $actions_disabled, |
|
4399
|
|
|
'actions_bulk' => array(), |
|
4400
|
|
|
); |
|
4401
|
|
|
|
|
4402
|
|
|
if ( ! empty( $filters ) ) { |
|
4403
|
|
|
$ui['fields']['search'] = $filters; |
|
4404
|
|
|
$ui['filters'] = array_keys( $filters ); |
|
4405
|
|
|
$ui['filters_enhanced'] = true; |
|
4406
|
|
|
} |
|
4407
|
|
|
|
|
4408
|
|
|
$reorder_field = pods_v( 'ui_reorder_field', $this->pod_data['options'] ); |
|
4409
|
|
|
|
|
4410
|
|
|
if ( ! empty( $reorder_field ) && in_array( 'reorder', $actions_enabled, true ) && ! in_array( 'reorder', $actions_disabled, true ) && ( ( ! empty( $this->pod_data['object_fields'] ) && isset( $this->pod_data['object_fields'][ $reorder_field ] ) ) || isset( $this->pod_data['fields'][ $reorder_field ] ) ) ) { |
|
4411
|
|
|
$ui['reorder'] = array( 'on' => $reorder_field ); |
|
4412
|
|
|
$ui['orderby'] = $reorder_field; |
|
4413
|
|
|
$ui['orderby_dir'] = 'ASC'; |
|
4414
|
|
|
} |
|
4415
|
|
|
|
|
4416
|
|
|
if ( ! empty( $author_restrict ) ) { |
|
4417
|
|
|
$ui['restrict'] = array( 'author_restrict' => $author_restrict ); |
|
4418
|
|
|
} |
|
4419
|
|
|
|
|
4420
|
|
|
if ( ! in_array( 'export', $ui['actions_disabled'], true ) ) { |
|
4421
|
|
|
$ui['actions_bulk']['export'] = array( |
|
4422
|
|
|
'label' => __( 'Export', 'pods' ), |
|
4423
|
|
|
// callback not needed, Pods has this built-in for export. |
|
4424
|
|
|
); |
|
4425
|
|
|
} |
|
4426
|
|
|
|
|
4427
|
|
|
if ( ! in_array( 'delete', $ui['actions_disabled'], true ) ) { |
|
4428
|
|
|
$ui['actions_bulk']['delete'] = array( |
|
4429
|
|
|
'label' => __( 'Delete', 'pods' ), |
|
4430
|
|
|
// callback not needed, Pods has this built-in for delete. |
|
4431
|
|
|
); |
|
4432
|
|
|
} |
|
4433
|
|
|
|
|
4434
|
|
|
$detail_url = pods_v( 'detail_url', $this->pod_data['options'] ); |
|
4435
|
|
|
|
|
4436
|
|
|
if ( 0 < strlen( $detail_url ) ) { |
|
4437
|
|
|
$ui['actions_custom'] = array( |
|
4438
|
|
|
'view_url' => array( |
|
4439
|
|
|
'label' => 'View', |
|
4440
|
|
|
'link' => get_site_url() . '/' . $detail_url, |
|
4441
|
|
|
), |
|
4442
|
|
|
); |
|
4443
|
|
|
} |
|
4444
|
|
|
|
|
4445
|
|
|
// @todo Customize the Add New / Manage links to point to their correct menu items. |
|
4446
|
|
|
$ui = apply_filters( 'pods_admin_ui_' . $this->pod, apply_filters( 'pods_admin_ui', $ui, $this->pod, $this ), $this->pod, $this ); |
|
4447
|
|
|
|
|
4448
|
|
|
// Override UI options. |
|
4449
|
|
|
foreach ( $options as $option => $value ) { |
|
4450
|
|
|
$ui[ $option ] = $value; |
|
4451
|
|
|
} |
|
4452
|
|
|
|
|
4453
|
|
|
$this->ui = $ui; |
|
4454
|
|
|
|
|
4455
|
|
|
return pods_ui( $this ); |
|
4456
|
|
|
}//end if |
|
4457
|
|
|
|
|
4458
|
|
|
do_action( 'pods_admin_ui_custom', $this ); |
|
4459
|
|
|
do_action( 'pods_admin_ui_custom_' . $this->pod, $this ); |
|
4460
|
|
|
|
|
4461
|
|
|
return null; |
|
4462
|
|
|
} |
|
4463
|
|
|
|
|
4464
|
|
|
/** |
|
4465
|
|
|
* Handle filters / actions for the class |
|
4466
|
|
|
* |
|
4467
|
|
|
* @see pods_do_hook |
|
4468
|
|
|
* |
|
4469
|
|
|
* @param string $name Hook name. |
|
4470
|
|
|
* |
|
4471
|
|
|
* @return mixed Value filtered |
|
4472
|
|
|
* |
|
4473
|
|
|
* @since 2.0 |
|
4474
|
|
|
*/ |
|
4475
|
|
|
private function do_hook( $name ) { |
|
4476
|
|
|
|
|
4477
|
|
|
$args = func_get_args(); |
|
4478
|
|
|
|
|
4479
|
|
|
if ( empty( $args ) ) { |
|
4480
|
|
|
return false; |
|
4481
|
|
|
} |
|
4482
|
|
|
|
|
4483
|
|
|
// Remove first argument. |
|
4484
|
|
|
array_shift( $args ); |
|
4485
|
|
|
|
|
4486
|
|
|
return pods_do_hook( 'pods', $name, $args, $this ); |
|
4487
|
|
|
} |
|
4488
|
|
|
|
|
4489
|
|
|
/** |
|
4490
|
|
|
* Handle variables that have been deprecated and PodsData vars |
|
4491
|
|
|
* |
|
4492
|
|
|
* @param string $name Property name. |
|
4493
|
|
|
* |
|
4494
|
|
|
* @return mixed |
|
4495
|
|
|
* |
|
4496
|
|
|
* @since 2.0 |
|
4497
|
|
|
*/ |
|
4498
|
|
|
public function __get( $name ) { |
|
4499
|
|
|
|
|
4500
|
|
|
$name = (string) $name; |
|
4501
|
|
|
|
|
4502
|
|
|
// PodsData vars. |
|
4503
|
|
|
if ( isset( $this->data->{$name} ) && 0 === strpos( $name, 'field_' ) ) { |
|
4504
|
|
|
return $this->data->{$name}; |
|
4505
|
|
|
} |
|
4506
|
|
|
|
|
4507
|
|
|
if ( ! $this->deprecated ) { |
|
4508
|
|
|
require_once PODS_DIR . 'deprecated/classes/Pods.php'; |
|
4509
|
|
|
|
|
4510
|
|
|
$this->deprecated = new Pods_Deprecated( $this ); |
|
4511
|
|
|
} |
|
4512
|
|
|
|
|
4513
|
|
|
$var = null; |
|
4514
|
|
|
|
|
4515
|
|
|
$pod_class_exists = class_exists( 'Pod' ); |
|
4516
|
|
|
|
|
4517
|
|
|
if ( isset( $this->deprecated->{$name} ) ) { |
|
4518
|
|
|
if ( ! $pod_class_exists || Pod::$deprecated_notice ) { |
|
4519
|
|
|
pods_deprecated( "Pods->{$name}", '2.0' ); |
|
4520
|
|
|
} |
|
4521
|
|
|
|
|
4522
|
|
|
$var = $this->deprecated->{$name}; |
|
4523
|
|
|
} elseif ( ! $pod_class_exists || Pod::$deprecated_notice ) { |
|
4524
|
|
|
pods_deprecated( "Pods->{$name}", '2.0' ); |
|
4525
|
|
|
} |
|
4526
|
|
|
|
|
4527
|
|
|
return $var; |
|
4528
|
|
|
} |
|
4529
|
|
|
|
|
4530
|
|
|
/** |
|
4531
|
|
|
* Handle methods that have been deprecated and any aliasing. |
|
4532
|
|
|
* |
|
4533
|
|
|
* @param string $name Function name. |
|
4534
|
|
|
* @param array $args Arguments passed to function. |
|
4535
|
|
|
* |
|
4536
|
|
|
* @return mixed|null |
|
4537
|
|
|
* |
|
4538
|
|
|
* @since 2.0 |
|
4539
|
|
|
*/ |
|
4540
|
|
|
public function __call( $name, $args ) { |
|
4541
|
|
|
|
|
4542
|
|
|
$name = (string) $name; |
|
4543
|
|
|
|
|
4544
|
|
|
// select > find alias. |
|
4545
|
|
|
if ( 'select' === $name ) { |
|
4546
|
|
|
return call_user_func_array( array( $this, 'find' ), $args ); |
|
4547
|
|
|
} |
|
4548
|
|
|
|
|
4549
|
|
|
if ( ! $this->deprecated ) { |
|
4550
|
|
|
require_once PODS_DIR . 'deprecated/classes/Pods.php'; |
|
4551
|
|
|
|
|
4552
|
|
|
$this->deprecated = new Pods_Deprecated( $this ); |
|
4553
|
|
|
} |
|
4554
|
|
|
|
|
4555
|
|
|
$pod_class_exists = class_exists( 'Pod' ); |
|
4556
|
|
|
|
|
4557
|
|
|
if ( method_exists( $this->deprecated, $name ) ) { |
|
4558
|
|
|
return call_user_func_array( array( $this->deprecated, $name ), $args ); |
|
4559
|
|
|
// @codingStandardsIgnoreLine |
|
4560
|
|
|
} elseif ( ! $pod_class_exists || Pod::$deprecated_notice ) { |
|
4561
|
|
|
pods_deprecated( "Pods::{$name}", '2.0' ); |
|
4562
|
|
|
} |
|
4563
|
|
|
|
|
4564
|
|
|
return null; |
|
4565
|
|
|
} |
|
4566
|
|
|
|
|
4567
|
|
|
/** |
|
4568
|
|
|
* Handle casting a Pods() object to string |
|
4569
|
|
|
* |
|
4570
|
|
|
* @return string Pod type and name in CURIE notation |
|
4571
|
|
|
*/ |
|
4572
|
|
|
public function __toString() { |
|
4573
|
|
|
|
|
4574
|
|
|
$string = ''; |
|
4575
|
|
|
|
|
4576
|
|
|
if ( ! empty( $this->pod_data ) ) { |
|
4577
|
|
|
$string = sprintf( '%s:%s', $this->pod_data['type'], $this->pod_data['name'] ); |
|
4578
|
|
|
} |
|
4579
|
|
|
|
|
4580
|
|
|
return $string; |
|
4581
|
|
|
|
|
4582
|
|
|
} |
|
4583
|
|
|
} |
|
4584
|
|
|
|
Short variable names may make your code harder to understand. Variable names should be self-descriptive. This check looks for variable names who are shorter than a configured minimum.