Completed
Pull Request — 2.x (#3990)
by
unknown
05:09
created

PodsAPI::pod_exists()   D

Complexity

Conditions 9
Paths 14

Size

Total Lines 26
Code Lines 17

Duplication

Lines 0
Ratio 0 %

Importance

Changes 0
Metric Value
cc 9
eloc 17
nc 14
nop 2
dl 0
loc 26
rs 4.909
c 0
b 0
f 0
1
<?php
2
/**
3
 * @package Pods
4
 */
5
class PodsAPI {
6
7
    /**
8
     * @var PodsAPI
9
     */
10
    static $instance = null;
0 ignored issues
show
Coding Style introduced by
The visibility should be declared for property $instance.

The PSR-2 coding standard requires that all properties in a class have their visibility explicitly declared. If you declare a property using

class A {
    var $property;
}

the property is implicitly global.

To learn more about the PSR-2, please see the PHP-FIG site on the PSR-2.

Loading history...
11
12
	/**
13
	 * @var array PodsAPI
14
	 */
15
	static $instances = array();
0 ignored issues
show
Coding Style introduced by
The visibility should be declared for property $instances.

The PSR-2 coding standard requires that all properties in a class have their visibility explicitly declared. If you declare a property using

class A {
    var $property;
}

the property is implicitly global.

To learn more about the PSR-2, please see the PHP-FIG site on the PSR-2.

Loading history...
16
17
18
    /**
19
     * @var bool
20
     */
21
    public $display_errors = false;
22
23
    /**
24
     * @var array|bool|mixed|null|void
25
     */
26
    public $pod_data;
27
28
    /**
29
     * @var
30
     */
31
    public $pod;
32
33
    /**
34
     * @var
35
     */
36
    public $pod_id;
37
38
    /**
39
     * @var
40
     */
41
    public $fields;
42
43
    /**
44
     * @var
45
     * @deprecated 2.0
46
     */
47
    public $format = null;
48
49
    /**
50
     * @var
51
     */
52
    private $deprecated;
53
54
	/**
55
	 * @var array
56
	 * @since 2.5
57
	 */
58
	private $fields_cache = array();
59
60
	/**
61
	 * @var array
62
	 * @since 2.5
63
	 *
64
	 */
65
	private static $table_info_cache = array();
66
67
	/**
68
	 * @var array
69
	 * @since 2.5
70
	 *
71
	 */
72
	private static $related_item_cache = array();
73
74
	/**
75
     * Singleton-ish handling for a basic pods_api() request
76
     *
77
     * @param string $pod (optional) The pod name
78
     * @param string $format (deprecated) Format for import/export, "php" or "csv"
79
     *
80
     * @return \PodsAPI
81
     *
82
     * @since 2.3.5
83
     */
84
	public static function init ( $pod = null, $format = null ) {
85
		if ( null !== $pod || null !== $format ) {
86
			if ( ! isset( self::$instances[ $pod ] ) ) {
87
				// Cache API singleton per Pod
88
				self::$instances[ $pod ] = new PodsAPI( $pod, $format );
89
			}
90
			return self::$instances[ $pod ];
91
		}
92
		elseif ( !is_object( self::$instance ) ) {
93
			self::$instance = new PodsAPI();
94
		}
95
96
		return self::$instance;
97
	}
98
99
100
    /**
101
     * Store and retrieve data programatically
102
     *
103
     * @param string $pod (optional) The pod name
104
     * @param string $format (deprecated) Format for import/export, "php" or "csv"
105
     *
106
     * @return \PodsAPI
0 ignored issues
show
Comprehensibility Best Practice introduced by
Adding a @return annotation to constructors is generally not recommended as a constructor does not have a meaningful return value.

Adding a @return annotation to a constructor is not recommended, since a constructor does not have a meaningful return value.

Please refer to the PHP core documentation on constructors.

Loading history...
107
     *
108
     * @license http://www.gnu.org/licenses/gpl-2.0.html
109
     * @since 1.7.1
110
     */
111
    public function __construct ( $pod = null, $format = null ) {
112
        if ( null !== $pod && 0 < strlen( (string) $pod ) ) {
113
            if ( null !== $format ) {
114
                $this->format = $format;
0 ignored issues
show
Deprecated Code introduced by
The property PodsAPI::$format has been deprecated with message: 2.0

This property has been deprecated. The supplier of the class has supplied an explanatory message.

The explanatory message should give you some clue as to whether and when the property will be removed from the class and what other property to use instead.

Loading history...
115
116
                pods_deprecated( 'pods_api( $pod, $format )', '2.0', 'pods_api( $pod )' );
117
            }
118
119
            $pod = pods_clean_name( $pod );
120
121
            $pod = $this->load_pod( array( 'name' => $pod, 'table_info' => true ), false );
122
123
            if ( !empty( $pod ) ) {
124
                $this->pod_data = $pod;
125
                $this->pod = $pod[ 'name' ];
126
                $this->pod_id = $pod[ 'id' ];
127
                $this->fields = $pod[ 'fields' ];
128
            }
129
        }
130
    }
131
132
    /**
133
     * Save a WP object and its meta
134
     *
135
     * @param string $object_type Object type: post|taxonomy|user|comment|setting
136
     * @param array $data All post data to be saved
137
     * @param array $meta (optional) Associative array of meta keys and values
138
     * @param bool $strict (optional) Decides whether the previous saved meta should be deleted or not
139
     * @param bool $sanitized (optional) Will unsanitize the data, should be passed if the data is sanitized before sending.
140
     * @param array $fields (optional) The array of fields and their options, for further processing with
141
     *
142
     * @return bool|mixed
143
     *
144
     * @since 2.0
145
     */
146
    public function save_wp_object ( $object_type, $data, $meta = array(), $strict = false, $sanitized = false, $fields = array() ) {
147
        if ( in_array( $object_type, array( 'post_type', 'media' ) ) )
148
            $object_type = 'post';
149
150
        if ( 'taxonomy' == $object_type )
151
            $object_type = 'term';
152
153
        if ( $sanitized ) {
154
            $data = pods_unsanitize( $data );
155
            $meta = pods_unsanitize( $meta );
156
        }
157
158
        if ( in_array( $object_type, array( 'post', 'term', 'user', 'comment' ) ) )
159
            return call_user_func( array( $this, 'save_' . $object_type ), $data, $meta, $strict, false, $fields );
160
        elseif ( 'settings' == $object_type ) {
161
            // Nothing to save
162
            if ( empty( $meta ) )
163
                return true;
164
165
            return $this->save_setting( pods_var( 'option_id', $data ), $meta, false );
166
        }
167
168
        return false;
169
    }
170
171
    /**
172
     * Delete a WP object
173
     *
174
     * @param string $object_type Object type: post|user|comment
175
     * @param int $id Object ID
176
     * @param bool $force_delete (optional) Force deletion instead of trashing (post types only)
177
     *
178
     * @return bool|mixed
179
     *
180
     * @since 2.0
181
     */
182
    public function delete_wp_object ( $object_type, $id, $force_delete = true ) {
183
        if ( in_array( $object_type, array( 'post_type', 'media' ) ) )
184
            $object_type = 'post';
185
186
        if ( 'taxonomy' == $object_type )
187
            $object_type = 'term';
188
189
        if ( empty( $id ) )
190
            return false;
191
192
        if ( in_array( $object_type, array( 'post' ) ) )
193
            return wp_delete_post( $id, $force_delete );
194
195
        if ( function_exists( 'wp_delete_' . $object_type ) )
196
            return call_user_func( 'wp_delete_' . $object_type, $id );
197
198
        return false;
199
    }
200
201
    /**
202
     * Save a post and it's meta
203
     *
204
     * @param array $post_data All post data to be saved (using wp_insert_post / wp_update_post)
205
     * @param array $post_meta (optional) All meta to be saved (set value to null to delete)
206
     * @param bool $strict (optional) Whether to delete previously saved meta not in $post_meta
207
     * @param bool $sanitized (optional) Will unsanitize the data, should be passed if the data is sanitized before sending.
208
     * @param array $fields (optional) The array of fields and their options, for further processing with
209
     *
210
     * @return mixed|void
211
     *
212
     * @since 2.0
213
     */
214
    public function save_post ( $post_data, $post_meta = null, $strict = false, $sanitized = false, $fields = array() ) {
215
        $conflicted = pods_no_conflict_check( 'post' );
216
217
        if ( !$conflicted )
218
            pods_no_conflict_on( 'post' );
219
220
        if ( !is_array( $post_data ) || empty( $post_data ) )
221
            $post_data = array( 'post_title' => '' );
222
223
        if ( !is_array( $post_meta ) )
224
            $post_meta = array();
225
226
        if ( $sanitized ) {
227
            $post_data = pods_unsanitize( $post_data );
228
            $post_meta = pods_unsanitize( $post_meta );
229
        }
230
231
        if ( !isset( $post_data[ 'ID' ] ) || empty( $post_data[ 'ID' ] ) )
232
            $post_data[ 'ID' ] = wp_insert_post( $post_data, true );
233
        elseif ( 2 < count( $post_data ) || !isset( $post_data[ 'post_type' ] ) )
234
            $post_data[ 'ID' ] = wp_update_post( $post_data, true );
235
236 View Code Duplication
        if ( is_wp_error( $post_data[ 'ID' ] ) ) {
237
            if ( !$conflicted )
238
                pods_no_conflict_off( 'post' );
239
240
            /**
241
             * @var $post_error WP_Error
242
             */
243
            $post_error = $post_data[ 'ID' ];
244
245
            return pods_error( $post_error->get_error_message(), $this );
246
        }
247
248
        $this->save_post_meta( $post_data[ 'ID' ], $post_meta, $strict, $fields );
249
250
        if ( !$conflicted )
251
            pods_no_conflict_off( 'post' );
252
253
        return $post_data[ 'ID' ];
254
    }
255
256
    /**
257
     * Save a post's meta
258
     *
259
     * @param int $id Post ID
260
     * @param array $post_meta All meta to be saved (set value to null to delete)
261
     * @param bool $strict Whether to delete previously saved meta not in $post_meta
262
     * @param array $fields (optional) The array of fields and their options, for further processing with
263
     *
264
     * @return int Id of the post with the meta
265
     *
266
     * @since 2.0
267
     */
268 View Code Duplication
    public function save_post_meta ( $id, $post_meta = null, $strict = false, $fields = array() ) {
0 ignored issues
show
Duplication introduced by
This method seems to be duplicated in your project.

Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation.

You can also find more detailed suggestions in the “Code” section of your repository.

Loading history...
269
        $simple_tableless_objects = PodsForm::simple_tableless_objects();
270
271
        $conflicted = pods_no_conflict_check( 'post' );
272
273
        if ( !$conflicted )
274
            pods_no_conflict_on( 'post' );
275
276
        if ( !is_array( $post_meta ) )
277
            $post_meta = array();
278
279
        $id = (int) $id;
280
281
        $meta = get_post_meta( $id );
282
283
        foreach ( $meta as $k => $value ) {
284
            if ( is_array( $value ) && 1 == count( $value ) )
285
                $meta[ $k ] = current( $value );
286
        }
287
288
        foreach ( $post_meta as $meta_key => $meta_value ) {
289
            if ( null === $meta_value || ( $strict && '' === $post_meta[ $meta_key ] ) ) {
290
                $old_meta_value = '';
291
292
                if ( isset( $meta[ $meta_key ] ) )
293
                    $old_meta_value = $meta[ $meta_key ];
294
295
                delete_post_meta( $id, $meta_key, $old_meta_value );
296
            }
297
            else {
298
				$simple = false;
299
300
				if ( isset( $fields[ $meta_key ] ) ) {
301
					$field_data = $fields[ $meta_key ];
302
303
					$simple = ( 'pick' == $field_data[ 'type' ] && in_array( pods_var( 'pick_object', $field_data ), $simple_tableless_objects ) );
304
				}
305
306
				if ( $simple ) {
307
					delete_post_meta( $id, $meta_key );
308
309
					update_post_meta( $id, '_pods_' . $meta_key, $meta_value );
310
311
					if ( ! is_array( $meta_value ) ) {
312
						$meta_value = array( $meta_value );
313
					}
314
315
					foreach ( $meta_value as $value ) {
316
						add_post_meta( $id, $meta_key, $value );
317
					}
318
				}
319
				else {
320
                	update_post_meta( $id, $meta_key, $meta_value );
321
				}
322
			}
323
        }
324
325
        if ( $strict ) {
326
            foreach ( $meta as $meta_key => $meta_value ) {
327
                if ( !isset( $post_meta[ $meta_key ] ) )
328
                    delete_post_meta( $id, $meta_key, $meta_value );
329
            }
330
        }
331
332
        if ( !$conflicted )
333
            pods_no_conflict_off( 'post' );
334
335
        return $id;
336
    }
337
338
    /**
339
     * Save a user and it's meta
340
     *
341
     * @param array $user_data All user data to be saved (using wp_insert_user / wp_update_user)
342
     * @param array $user_meta (optional) All meta to be saved (set value to null to delete)
343
     * @param bool $strict (optional) Whether to delete previously saved meta not in $user_meta
344
     * @param bool $sanitized (optional) Will unsanitize the data, should be passed if the data is sanitized before sending.
345
     * @param array $fields (optional) The array of fields and their options, for further processing with
346
     *
347
     * @return int Returns user id on success
348
     *
349
     * @since 2.0
350
     */
351
    public function save_user ( $user_data, $user_meta = null, $strict = false, $sanitized = false, $fields = array() ) {
352 View Code Duplication
        if ( !is_array( $user_data ) || empty( $user_data ) )
353
            return pods_error( __( 'User data is required but is either invalid or empty', 'pods' ), $this );
354
355
        $conflicted = pods_no_conflict_check( 'user' );
356
357
        if ( !$conflicted )
358
            pods_no_conflict_on( 'user' );
359
360
        if ( !is_array( $user_meta ) )
361
            $user_meta = array();
362
363
        if ( $sanitized ) {
364
            $user_data = pods_unsanitize( $user_data );
365
            $user_meta = pods_unsanitize( $user_meta );
366
        }
367
368
		// Set role
369
		if ( isset( $user_meta[ 'role' ] ) ) {
370
			$user_data[ 'role' ] = $user_meta[ 'role' ];
371
372
			unset( $user_meta[ 'role' ] );
373
		}
374
375
        if ( !isset( $user_data[ 'ID' ] ) || empty( $user_data[ 'ID' ] ) )
376
            $user_data[ 'ID' ] = wp_insert_user( $user_data );
377
        elseif ( 1 < count( $user_data ) )
378
            wp_update_user( $user_data );
379
380 View Code Duplication
        if ( is_wp_error( $user_data[ 'ID' ] ) ) {
381
            if ( !$conflicted )
382
                pods_no_conflict_off( 'user' );
383
384
            /**
385
             * @var $user_error WP_Error
386
             */
387
            $user_error = $user_data[ 'ID' ];
388
389
            return pods_error( $user_error->get_error_message(), $this );
390
        }
391
392
        $this->save_user_meta( $user_data[ 'ID' ], $user_meta, $strict, $fields );
393
394
        if ( !$conflicted )
395
            pods_no_conflict_off( 'user' );
396
397
        return $user_data[ 'ID' ];
398
    }
399
400
    /**
401
     * Save a user meta
402
     *
403
     * @param int $id User ID
404
     * @param array $user_meta (optional) All meta to be saved (set value to null to delete)
405
     * @param bool $strict (optional) Whether to delete previously saved meta not in $user_meta
406
     * @param array $fields (optional) The array of fields and their options, for further processing with
407
     *
408
     * @return int User ID
409
     *
410
     * @since 2.0
411
     *
412
     */
413 View Code Duplication
    public function save_user_meta ( $id, $user_meta = null, $strict = false, $fields = array() ) {
0 ignored issues
show
Duplication introduced by
This method seems to be duplicated in your project.

Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation.

You can also find more detailed suggestions in the “Code” section of your repository.

Loading history...
414
        $simple_tableless_objects = PodsForm::simple_tableless_objects();
415
416
        $conflicted = pods_no_conflict_check( 'user' );
417
418
        if ( !$conflicted )
419
            pods_no_conflict_on( 'user' );
420
421
        if ( !is_array( $user_meta ) )
422
            $user_meta = array();
423
424
        $id = (int) $id;
425
426
        $meta = get_user_meta( $id );
427
428
        foreach ( $user_meta as $meta_key => $meta_value ) {
429
            if ( null === $meta_value ) {
430
                $old_meta_value = '';
431
432
                if ( isset( $meta[ $meta_key ] ) )
433
                    $old_meta_value = $meta[ $meta_key ];
434
435
                delete_user_meta( $id, $meta_key, $old_meta_value );
436
            }
437
            else {
438
				$simple = false;
439
440
				if ( isset( $fields[ $meta_key ] ) ) {
441
					$field_data = $fields[ $meta_key ];
442
443
					$simple = ( 'pick' == $field_data[ 'type' ] && in_array( pods_var( 'pick_object', $field_data ), $simple_tableless_objects ) );
444
				}
445
446
				if ( $simple ) {
447
					delete_user_meta( $id, $meta_key );
448
449
					if ( ! is_array( $meta_value ) ) {
450
						$meta_value = array( $meta_value );
451
					}
452
453
					foreach ( $meta_value as $value ) {
454
						add_user_meta( $id, $meta_key, $value );
455
					}
456
				}
457
				else {
458
                	update_user_meta( $id, $meta_key, $meta_value );
459
				}
460
			}
461
        }
462
463
        if ( $strict ) {
464
            foreach ( $meta as $meta_key => $meta_value ) {
465
                if ( !isset( $user_meta[ $meta_key ] ) )
466
                    delete_user_meta( $id, $meta_key, $user_meta[ $meta_key ] );
467
            }
468
        }
469
470
        if ( !$conflicted )
471
            pods_no_conflict_off( 'user' );
472
473
        return $id;
474
    }
475
476
    /**
477
     * Save a comment and it's meta
478
     *
479
     * @param array $comment_data All comment data to be saved (using wp_insert_comment / wp_update_comment)
480
     * @param array $comment_meta (optional) All meta to be saved (set value to null to delete)
481
     * @param bool $strict (optional) Whether to delete previously saved meta not in $comment_meta
482
     * @param bool $sanitized (optional) Will unsanitize the data, should be passed if the data is sanitized before sending.
483
     * @param array $fields (optional) The array of fields and their options, for further processing with
484
     *
485
     * @return int Comment ID
486
     *
487
     * @since 2.0
488
     */
489
    public function save_comment ( $comment_data, $comment_meta = null, $strict = false, $sanitized = false, $fields = array() ) {
490 View Code Duplication
        if ( !is_array( $comment_data ) || empty( $comment_data ) )
491
            return pods_error( __( 'Comment data is required but is either invalid or empty', 'pods' ), $this );
492
493
        $conflicted = pods_no_conflict_check( 'comment' );
494
495
        if ( !$conflicted )
496
            pods_no_conflict_on( 'comment' );
497
498
        if ( !is_array( $comment_meta ) )
499
            $comment_meta = array();
500
501
        if ( $sanitized ) {
502
            $comment_data = pods_unsanitize( $comment_data );
503
            $comment_meta = pods_unsanitize( $comment_meta );
504
        }
505
506
        if ( !isset( $comment_data[ 'comment_ID' ] ) || empty( $comment_data[ 'comment_ID' ] ) )
507
	        $comment_data[ 'comment_ID' ] = wp_insert_comment( pods_slash( $comment_data ) ); // Expects slashed
508
        elseif ( 1 < count( $comment_data ) )
509
            wp_update_comment( $comment_data );
510
511 View Code Duplication
        if ( is_wp_error( $comment_data[ 'comment_ID' ] ) ) {
512
            if ( !$conflicted )
513
                pods_no_conflict_off( 'comment' );
514
515
            /**
516
             * @var $comment_error WP_Error
517
             */
518
            $comment_error = $comment_data[ 'comment_ID' ];
519
520
            return pods_error( $comment_error->get_error_message(), $this );
521
        }
522
523
        $this->save_comment_meta( $comment_data[ 'comment_ID' ], $comment_meta, $strict, $fields );
524
525
        if ( !$conflicted )
526
            pods_no_conflict_off( 'comment' );
527
528
        return $comment_data[ 'comment_ID' ];
529
    }
530
531
    /**
532
     * Save a comment meta
533
     *
534
     * @param int $id Comment ID
535
     * @param array $comment_meta (optional) All meta to be saved (set value to null to delete)
536
     * @param bool $strict (optional) Whether to delete previously saved meta not in $comment_meta
537
     * @param array $fields (optional) The array of fields and their options, for further processing with
538
     *
539
     * @return int Comment ID
540
     *
541
     * @since 2.0
542
     */
543 View Code Duplication
    public function save_comment_meta ( $id, $comment_meta = null, $strict = false, $fields = array() ) {
0 ignored issues
show
Duplication introduced by
This method seems to be duplicated in your project.

Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation.

You can also find more detailed suggestions in the “Code” section of your repository.

Loading history...
544
        $simple_tableless_objects = PodsForm::simple_tableless_objects();
545
546
        $conflicted = pods_no_conflict_check( 'comment' );
547
548
        if ( !$conflicted )
549
            pods_no_conflict_on( 'comment' );
550
551
        if ( !is_array( $comment_meta ) )
552
            $comment_meta = array();
553
554
        $id = (int) $id;
555
556
        $meta = get_comment_meta( $id );
557
558
        foreach ( $comment_meta as $meta_key => $meta_value ) {
559
            if ( null === $meta_value ) {
560
                $old_meta_value = '';
561
562
                if ( isset( $meta[ $meta_key ] ) )
563
                    $old_meta_value = $meta[ $meta_key ];
564
565
                delete_comment_meta( $id, $meta_key, $old_meta_value );
566
            }
567
            else {
568
				$simple = false;
569
570
				if ( isset( $fields[ $meta_key ] ) ) {
571
					$field_data = $fields[ $meta_key ];
572
573
					$simple = ( 'pick' == $field_data[ 'type' ] && in_array( pods_var( 'pick_object', $field_data ), $simple_tableless_objects ) );
574
				}
575
576
				if ( $simple ) {
577
					delete_comment_meta( $id, $meta_key );
578
579
					if ( ! is_array( $meta_value ) ) {
580
						$meta_value = array( $meta_value );
581
					}
582
583
					foreach ( $meta_value as $value ) {
584
						add_comment_meta( $id, $meta_key, $value );
585
					}
586
				}
587
				else {
588
                	update_comment_meta( $id, $meta_key, $meta_value );
589
				}
590
			}
591
        }
592
593
        if ( $strict ) {
594
            foreach ( $meta as $meta_key => $meta_value ) {
595
                if ( !isset( $comment_meta[ $meta_key ] ) )
596
                    delete_comment_meta( (int) $id, $meta_key, $comment_meta[ $meta_key ] );
597
            }
598
        }
599
600
        if ( !$conflicted )
601
            pods_no_conflict_off( 'comment' );
602
603
        return $id;
604
    }
605
606
    /**
607
     * Save a taxonomy's term
608
     *
609
     * @param array $term_data All term data to be saved (using wp_insert_term / wp_update_term)
610
     * @param array $term_meta All meta to be saved (set value to null to delete)
611
     * @param bool $strict (optional) Whether to delete previously saved meta not in $post_meta
612
     * @param bool $sanitized (optional) Will unsanitize the data, should be passed if the data is sanitized before sending.
613
     * @param array $fields (optional) The array of fields and their options, for further processing with
614
     *
615
     * @return int Term ID
616
     *
617
     * @since 2.0
618
     */
619
    public function save_term ( $term_data, $term_meta, $strict = false, $sanitized = false, $fields = array() ) {
620
		if ( empty( $term_data['taxonomy'] ) ) {
621
            return 0;
622
		}
623
624
        $conflicted = pods_no_conflict_check( 'taxonomy' );
625
626
        if ( !is_array( $term_data ) || empty( $term_data ) )
627
            $term_data = array( 'name' => '' );
628
629
        if ( !$conflicted )
630
            pods_no_conflict_on( 'taxonomy' );
631
632
        if ( !is_array( $term_meta ) )
633
            $term_meta = array();
634
635
        if ( $sanitized ) {
636
            $term_data = pods_unsanitize( $term_data );
637
            $term_meta = pods_unsanitize( $term_meta );
638
        }
639
640
        $taxonomy = $term_data['taxonomy'];
641
642
        unset( $term_data['taxonomy'] );
643
644
        if ( empty( $term_data['term_id'] ) ) {
645
        	$term_name = $term_data['name'];
646
647
        	unset( $term_data['name'] );
648
649
            $term_data['term_id'] = wp_insert_term( $term_name, $taxonomy, $term_data );
650
		} elseif ( 2 < count( $term_data ) ) {
651
            $term_data['term_id'] = wp_update_term( $term_data['term_id'], $taxonomy, $term_data );
652
        }
653
654
        if ( is_wp_error( $term_data['term_id'] ) ) {
655
            if ( !$conflicted )
656
                pods_no_conflict_off( 'taxonomy' );
657
658
            /**
659
             * @var $term_error WP_Error
660
             */
661
            $term_error = $term_data[ 'term_id' ];
662
663
            return pods_error( $term_error->get_error_message(), $this );
664
        }
665
        elseif ( is_array( $term_data['term_id'] ) )
666
            $term_data['term_id'] = $term_data['term_id'][ 'term_id' ];
667
668
        $this->save_term_meta( $term_data['term_id'], $term_meta, $strict, $fields );
669
670
        if ( !$conflicted )
671
            pods_no_conflict_off( 'taxonomy' );
672
673
        return $term_data['term_id'];
674
    }
675
676
    /**
677
     * Save a term's meta
678
     *
679
     * @param int $id Term ID
680
     * @param array $term_meta All meta to be saved (set value to null to delete)
681
     * @param bool $strict Whether to delete previously saved meta not in $term_meta
682
     * @param array $fields (optional) The array of fields and their options, for further processing with
683
     *
684
     * @return int Id of the term with the meta
685
     *
686
     * @since 2.0
687
     */
688 View Code Duplication
    public function save_term_meta ( $id, $term_meta = null, $strict = false, $fields = array() ) {
0 ignored issues
show
Duplication introduced by
This method seems to be duplicated in your project.

Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation.

You can also find more detailed suggestions in the “Code” section of your repository.

Loading history...
689
        if ( ! function_exists( 'get_term_meta' ) ) {
690
        	return $id;
691
        }
692
693
        $simple_tableless_objects = PodsForm::simple_tableless_objects();
694
695
        $conflicted = pods_no_conflict_check( 'taxonomy' );
696
697
        if ( !$conflicted )
698
            pods_no_conflict_on( 'taxonomy' );
699
700
        if ( !is_array( $term_meta ) )
701
            $term_meta = array();
702
703
        $id = (int) $id;
704
705
        $meta = get_term_meta( $id );
706
707
        foreach ( $meta as $k => $value ) {
708
            if ( is_array( $value ) && 1 == count( $value ) )
709
                $meta[ $k ] = current( $value );
710
        }
711
712
        foreach ( $term_meta as $meta_key => $meta_value ) {
713
            if ( null === $meta_value || ( $strict && '' === $term_meta[ $meta_key ] ) ) {
714
                $old_meta_value = '';
715
716
                if ( isset( $meta[ $meta_key ] ) )
717
                    $old_meta_value = $meta[ $meta_key ];
718
719
                delete_term_meta( $id, $meta_key, $old_meta_value );
720
            }
721
            else {
722
				$simple = false;
723
724
				if ( isset( $fields[ $meta_key ] ) ) {
725
					$field_data = $fields[ $meta_key ];
726
727
					$simple = ( 'pick' == $field_data[ 'type' ] && in_array( pods_var( 'pick_object', $field_data ), $simple_tableless_objects ) );
728
				}
729
730
				if ( $simple ) {
731
					delete_term_meta( $id, $meta_key );
732
733
					update_term_meta( $id, '_pods_' . $meta_key, $meta_value );
734
735
					if ( ! is_array( $meta_value ) ) {
736
						$meta_value = array( $meta_value );
737
					}
738
739
					foreach ( $meta_value as $value ) {
740
						add_term_meta( $id, $meta_key, $value );
741
					}
742
				}
743
				else {
744
                	update_term_meta( $id, $meta_key, $meta_value );
745
				}
746
			}
747
        }
748
749
        if ( $strict ) {
750
            foreach ( $meta as $meta_key => $meta_value ) {
751
                if ( !isset( $term_meta[ $meta_key ] ) )
752
                    delete_term_meta( $id, $meta_key, $meta_value );
753
            }
754
        }
755
756
        if ( !$conflicted )
757
            pods_no_conflict_off( 'taxonomy' );
758
759
        return $id;
760
    }
761
762
    /**
763
     * Save a set of options
764
     *
765
     * @param string $setting Setting group name
766
     * @param array $option_data All option data to be saved
767
     * @param bool $sanitized (optional) Will unsanitize the data, should be passed if the data is sanitized before sending.
768
     *
769
     * @return bool
770
     *
771
     * @since 2.3
772
     */
773
    public function save_setting ( $setting, $option_data, $sanitized = false ) {
774 View Code Duplication
        if ( !is_array( $option_data ) || empty( $option_data ) )
775
            return pods_error( __( 'Setting data is required but is either invalid or empty', 'pods' ), $this );
776
777
        $conflicted = pods_no_conflict_check( 'settings' );
778
779
        if ( !$conflicted )
780
            pods_no_conflict_on( 'settings' );
781
782
        if ( $sanitized )
783
            $option_data = pods_unsanitize( $option_data );
784
785
        foreach ( $option_data as $option => $value ) {
786
            if ( !empty( $setting ) )
787
                $option = $setting . '_' . $option;
788
789
            update_option( $option, $value );
790
        }
791
792
        if ( !$conflicted )
793
            pods_no_conflict_off( 'settings' );
794
795
        return true;
796
    }
797
798
    /**
799
     * Rename a WP object's type
800
     *
801
     * @param string $object_type Object type: post|taxonomy|comment|setting
802
     * @param string $old_name The old name
803
     * @param string $new_name The new name
804
     *
805
     * @return bool
806
     *
807
     * @since 2.0
808
     */
809
    public function rename_wp_object_type ( $object_type, $old_name, $new_name ) {
810
        /**
811
         * @var $wpdb wpdb
812
         */
813
        global $wpdb;
0 ignored issues
show
Compatibility Best Practice introduced by
Use of global functionality is not recommended; it makes your code harder to test, and less reusable.

Instead of relying on global state, we recommend one of these alternatives:

1. Pass all data via parameters

function myFunction($a, $b) {
    // Do something
}

2. Create a class that maintains your state

class MyClass {
    private $a;
    private $b;

    public function __construct($a, $b) {
        $this->a = $a;
        $this->b = $b;
    }

    public function myFunction() {
        // Do something
    }
}
Loading history...
814
815
        if ( 'post_type' == $object_type )
816
            $object_type = 'post';
817
818
        if ( 'post' == $object_type ) {
819
            pods_query( "UPDATE `{$wpdb->posts}` SET `post_type` = %s WHERE `post_type` = %s", array(
820
                $new_name,
821
                $old_name
822
            ) );
823
        }
824
        elseif ( 'taxonomy' == $object_type ) {
825
            pods_query( "UPDATE `{$wpdb->term_taxonomy}` SET `taxonomy` = %s WHERE `taxonomy` = %s", array(
826
                $new_name,
827
                $old_name
828
            ) );
829
        }
830
        elseif ( 'comment' == $object_type ) {
831
            pods_query( "UPDATE `{$wpdb->comments}` SET `comment_type` = %s WHERE `comment_type` = %s", array(
832
                $new_name,
833
                $old_name
834
            ) );
835
        }
836
        elseif ( 'settings' == $object_type ) {
837
            pods_query( "UPDATE `{$wpdb->options}` SET `option_name` = REPLACE( `option_name`, %s, %s ) WHERE `option_name` LIKE '" . pods_sanitize_like( $old_name ) . "_%'", array(
838
                $new_name . '_',
839
                $old_name . '_'
840
            ) );
841
        }
842
843
        return true;
844
    }
845
846
    /**
847
     * Get a list of core WP object fields for a specific object
848
     *
849
     * @param string $object The pod type to look for, possible values: post_type, user, comment, taxonomy
850
     * @param array $pod Array of Pod data
851
     * @param boolean $refresh Whether to force refresh the information
852
     *
853
     * @return array Array of fields
854
     *
855
     * @since 2.0
856
     */
857
    public function get_wp_object_fields ( $object = 'post_type', $pod = null, $refresh = false ) {
858
        $pod_name = pods_var_raw( 'name', $pod, $object, null, true );
859
860
		if ( 'media' == $pod_name ) {
861
			$object = 'post_type';
862
			$pod_name = 'attachment';
863
		}
864
865
        $fields = false;
866
867
        if ( pods_api_cache() )
868
            $fields = pods_transient_get( trim( 'pods_api_object_fields_' . $object . $pod_name . '_', '_' ) );
869
870
        if ( false !== $fields && !$refresh )
871
            return $this->do_hook( 'get_wp_object_fields', $fields, $object, $pod );
872
873
        $fields = array();
874
875
        if ( 'post_type' == $object ) {
876
            $fields = array(
877
	            'ID' => array(
878
		            'name' => 'ID',
879
		            'label' => 'ID',
880
		            'type' => 'number',
881
		            'alias' => array( 'id' ),
882
	                'options' => array(
883
                        'number_format' => '9999.99'
884
	                )
885
	            ),
886
                'post_title' => array(
887
                    'name' => 'post_title',
888
                    'label' => 'Title',
889
                    'type' => 'text',
890
                    'alias' => array( 'title', 'name' ),
891
                    'options' => array(
892
                        'display_filter' => 'the_title',
893
                        'display_filter_args' => array( 'post_ID' )
894
                    )
895
                ),
896
                'post_content' => array(
897
                    'name' => 'post_content',
898
                    'label' => 'Content',
899
                    'type' => 'wysiwyg',
900
                    'alias' => array( 'content' ),
901
                    'options' => array(
902
                        'wysiwyg_allowed_html_tags' => '',
903
                        'display_filter' => 'the_content',
904
                        'pre_save' => 0
905
                    )
906
                ),
907
                'post_excerpt' => array(
908
                    'name' => 'post_excerpt',
909
                    'label' => 'Excerpt',
910
                    'type' => 'paragraph',
911
                    'alias' => array( 'excerpt' ),
912
                    'options' => array(
913
                        'paragraph_allow_html' => 1,
914
                        'paragraph_allowed_html_tags' => '',
915
                        'display_filter' => 'the_excerpt',
916
                        'pre_save' => 0
917
                    )
918
                ),
919
                'post_author' => array(
920
                    'name' => 'post_author',
921
                    'label' => 'Author',
922
                    'type' => 'pick',
923
                    'alias' => array( 'author' ),
924
                    'pick_object' => 'user',
925
                    'options' => array(
926
                        'pick_format_type' => 'single',
927
                        'pick_format_single' => 'autocomplete',
928
                        'default_value' => '{@user.ID}'
929
                    )
930
                ),
931
                'post_date' => array(
932
                    'name' => 'post_date',
933
                    'label' => 'Publish Date',
934
                    'type' => 'datetime',
935
                    'alias' => array( 'created', 'date' )
936
                ),
937
                'post_date_gmt' => array(
938
                    'name' => 'post_date_gmt',
939
                    'label' => 'Publish Date (GMT)',
940
                    'type' => 'datetime',
941
                    'alias' => array(),
942
                    'hidden' => true
943
                ),
944
                'post_status' => array(
945
                    'name' => 'post_status',
946
                    'label' => 'Status',
947
                    'type' => 'pick',
948
                    'pick_object' => 'post-status',
949
                    'default' => $this->do_hook( 'default_status_' . $pod_name, pods_var( 'default_status', pods_var_raw( 'options', $pod ), 'draft', null, true ), $pod ),
950
                    'alias' => array( 'status' )
951
                ),
952
                'comment_status' => array(
953
                    'name' => 'comment_status',
954
                    'label' => 'Comment Status',
955
                    'type' => 'text',
956
                    'default' => get_option( 'default_comment_status', 'open' ),
957
                    'alias' => array(),
958
                    'data' => array(
959
                        'open' => __( 'Open', 'pods' ),
960
                        'closed' => __( 'Closed', 'pods' )
961
                    )
962
                ),
963
                'ping_status' => array(
964
                    'name' => 'ping_status',
965
                    'label' => 'Ping Status',
966
                    'default' => get_option( 'default_ping_status', 'open' ),
967
                    'type' => 'text',
968
                    'alias' => array(),
969
                    'data' => array(
970
                        'open' => __( 'Open', 'pods' ),
971
                        'closed' => __( 'Closed', 'pods' )
972
                    )
973
                ),
974
                'post_password' => array(
975
                    'name' => 'post_password',
976
                    'label' => 'Password',
977
                    'type' => 'text',
978
                    'alias' => array()
979
                ),
980
                'post_name' => array(
981
                    'name' => 'post_name',
982
                    'label' => 'Permalink',
983
                    'type' => 'slug',
984
                    'alias' => array( 'slug', 'permalink' )
985
                ),
986
                'to_ping' => array(
987
                    'name' => 'to_ping',
988
                    'label' => 'To Ping',
989
                    'type' => 'text',
990
                    'alias' => array(),
991
                    'hidden' => true
992
                ),
993
                'pinged' => array(
994
                    'name' => 'pinged',
995
                    'label' => 'Pinged',
996
                    'type' => 'text',
997
                    'alias' => array(),
998
                    'hidden' => true
999
                ),
1000
                'post_modified' => array(
1001
                    'name' => 'post_modified',
1002
                    'label' => 'Last Modified Date',
1003
                    'type' => 'datetime',
1004
                    'alias' => array( 'modified' ),
1005
                    'hidden' => true
1006
                ),
1007
                'post_modified_gmt' => array(
1008
                    'name' => 'post_modified_gmt',
1009
                    'label' => 'Last Modified Date (GMT)',
1010
                    'type' => 'datetime',
1011
                    'alias' => array(),
1012
                    'hidden' => true
1013
                ),
1014
                'post_content_filtered' => array(
1015
                    'name' => 'post_content_filtered',
1016
                    'label' => 'Content (filtered)',
1017
                    'type' => 'paragraph',
1018
                    'alias' => array(),
1019
                    'hidden' => true,
1020
                    'options' => array(
1021
                        'paragraph_allow_html' => 1,
1022
                        'paragraph_oembed' => 1,
1023
                        'paragraph_wptexturize' => 1,
1024
                        'paragraph_convert_chars' => 1,
1025
                        'paragraph_wpautop' => 1,
1026
                        'paragraph_allow_shortcode' => 1,
1027
                        'paragraph_allowed_html_tags' => ''
1028
                    )
1029
                ),
1030
                'post_parent' => array(
1031
                    'name' => 'post_parent',
1032
                    'label' => 'Parent',
1033
                    'type' => 'pick',
1034
                    'pick_object' => 'post_type',
1035
                    'pick_val' => '__current__',
1036
                    'alias' => array( 'parent' ),
1037
                    'data' => array(),
1038
                    'hidden' => true
1039
                ),
1040
                'guid' => array(
1041
                    'name' => 'guid',
1042
                    'label' => 'GUID',
1043
                    'type' => 'text',
1044
                    'alias' => array(),
1045
                    'hidden' => true
1046
                ),
1047
                'menu_order' => array(
1048
                    'name' => 'menu_order',
1049
                    'label' => 'Menu Order',
1050
                    'type' => 'number',
1051
                    'alias' => array(),
1052
	                'options' => array(
1053
                        'number_format' => '9999.99'
1054
	                )
1055
                ),
1056
                'post_type' => array(
1057
                    'name' => 'post_type',
1058
                    'label' => 'Type',
1059
                    'type' => 'text',
1060
                    'alias' => array( 'type' ),
1061
                    'hidden' => true
1062
                ),
1063
                'post_mime_type' => array(
1064
                    'name' => 'post_mime_type',
1065
                    'label' => 'Mime Type',
1066
                    'type' => 'text',
1067
                    'alias' => array(),
1068
                    'hidden' => true
1069
                ),
1070
                'comment_count' => array(
1071
                    'name' => 'comment_count',
1072
                    'label' => 'Comment Count',
1073
                    'type' => 'number',
1074
                    'alias' => array(),
1075
                    'hidden' => true
1076
                )
1077
            );
1078
1079
            if ( !empty( $pod ) ) {
1080
                $taxonomies = get_object_taxonomies( $pod_name, 'objects' );
1081
1082
                foreach ( $taxonomies as $taxonomy ) {
1083
                    $fields[ $taxonomy->name ] = array(
1084
                        'name' => $taxonomy->name,
1085
                        'label' => $taxonomy->labels->name,
1086
                        'type' => 'taxonomy',
1087
						'pick_object' => 'taxonomy',
1088
						'pick_val' => $taxonomy->name,
1089
                        'alias' => array(),
1090
                        'hidden' => true,
1091
						'options' => array(
1092
							'taxonomy_format_type' => 'multi'
1093
						)
1094
                    );
1095
                }
1096
            }
1097
        }
1098
        elseif ( 'user' == $object ) {
1099
            $fields = array(
1100
	            'ID' => array(
1101
		            'name' => 'ID',
1102
		            'label' => 'ID',
1103
		            'type' => 'number',
1104
		            'alias' => array( 'id' ),
1105
	                'options' => array(
1106
                        'number_format' => '9999.99'
1107
	                )
1108
	            ),
1109
                'user_login' => array(
1110
                    'name' => 'user_login',
1111
                    'label' => 'Title',
1112
                    'type' => 'text',
1113
                    'alias' => array( 'login' ),
1114
                    'options' => array(
1115
                        'required' => 1
1116
                    )
1117
                ),
1118
                'user_nicename' => array(
1119
                    'name' => 'user_nicename',
1120
                    'label' => 'Permalink',
1121
                    'type' => 'slug',
1122
                    'alias' => array( 'nicename', 'slug', 'permalink' )
1123
                ),
1124
                'display_name' => array(
1125
                    'name' => 'display_name',
1126
                    'label' => 'Display Name',
1127
                    'type' => 'text',
1128
                    'alias' => array( 'title', 'name' )
1129
                ),
1130
                'user_pass' => array(
1131
                    'name' => 'user_pass',
1132
                    'label' => 'Password',
1133
                    'type' => 'text',
1134
                    'alias' => array( 'password', 'pass' ),
1135
                    'options' => array(
1136
                        'required' => 1,
1137
                        'text_format_type' => 'password'
1138
                    )
1139
                ),
1140
                'user_email' => array(
1141
                    'name' => 'user_email',
1142
                    'label' => 'E-mail',
1143
                    'type' => 'text',
1144
                    'alias' => array( 'email' ),
1145
                    'options' => array(
1146
                        'required' => 1,
1147
                        'text_format_type' => 'email'
1148
                    )
1149
                ),
1150
                'user_url' => array(
1151
                    'name' => 'user_url',
1152
                    'label' => 'URL',
1153
                    'type' => 'text',
1154
                    'alias' => array( 'url', 'website' ),
1155
                    'options' => array(
1156
                        'required' => 0,
1157
                        'text_format_type' => 'website',
1158
                        'text_format_website' => 'normal'
1159
                    )
1160
                ),
1161
                'user_registered' => array(
1162
                    'name' => 'user_registered',
1163
                    'label' => 'Registration Date',
1164
                    'type' => 'date',
1165
                    'alias' => array( 'created', 'date', 'registered' ),
1166
                    'options' => array(
1167
                        'date_format_type' => 'datetime'
1168
                    )
1169
                )
1170
            );
1171
        }
1172
        elseif ( 'comment' == $object ) {
1173
            $fields = array(
1174
	            'comment_ID' => array(
1175
		            'name' => 'comment_ID',
1176
		            'label' => 'ID',
1177
		            'type' => 'number',
1178
		            'alias' => array( 'id', 'ID', 'comment_id' ),
1179
	                'options' => array(
1180
                        'number_format' => '9999.99'
1181
	                )
1182
	            ),
1183
                'comment_content' => array(
1184
                    'name' => 'comment_content',
1185
                    'label' => 'Content',
1186
                    'type' => 'wysiwyg',
1187
                    'alias' => array( 'content' )
1188
                ),
1189
                'comment_approved' => array(
1190
                    'name' => 'comment_approved',
1191
                    'label' => 'Approved',
1192
                    'type' => 'number',
1193
                    'alias' => array( 'approved' ),
1194
	                'options' => array(
1195
                        'number_format' => '9999.99'
1196
	                )
1197
                ),
1198
                'comment_post_ID' => array(
1199
                    'name' => 'comment_post_ID',
1200
                    'label' => 'Post',
1201
                    'type' => 'pick',
1202
                    'alias' => array( 'post', 'post_id' ),
1203
                    'data' => array()
1204
                ),
1205
                'user_id' => array(
1206
                    'name' => 'user_id',
1207
                    'label' => 'Author',
1208
                    'type' => 'pick',
1209
                    'alias' => array( 'author' ),
1210
                    'pick_object' => 'user',
1211
                    'data' => array()
1212
                ),
1213
                'comment_date' => array(
1214
                    'name' => 'comment_date',
1215
                    'label' => 'Date',
1216
                    'type' => 'date',
1217
                    'alias' => array( 'created', 'date' ),
1218
                    'options' => array(
1219
                        'date_format_type' => 'datetime'
1220
                    )
1221
                ),
1222
                'comment_author' => array(
1223
                    'name' => 'comment_author',
1224
                    'label' => 'Author',
1225
                    'type' => 'text',
1226
                    'alias' => array( 'author' )
1227
                ),
1228
                'comment_author_email' => array(
1229
                    'name' => 'comment_author_email',
1230
                    'label' => 'Author E-mail',
1231
                    'type' => 'email',
1232
                    'alias' => array( 'author_email' )
1233
                ),
1234
                'comment_author_url' => array(
1235
                    'name' => 'comment_author_url',
1236
                    'label' => 'Author URL',
1237
                    'type' => 'text',
1238
                    'alias' => array( 'author_url' )
1239
                ),
1240
                'comment_author_IP' => array(
1241
                    'name' => 'comment_author_IP',
1242
                    'label' => 'Author IP',
1243
                    'type' => 'text',
1244
                    'alias' => array( 'author_IP' )
1245
                ),
1246
                'comment_type' => array(
1247
                    'name' => 'comment_type',
1248
                    'label' => 'Type',
1249
                    'type' => 'text',
1250
                    'alias' => array( 'type' ),
1251
                    'hidden' => true
1252
                ),
1253
                'comment_parent' => array(
1254
                    'name' => 'comment_parent',
1255
                    'label' => 'Parent',
1256
                    'type' => 'pick',
1257
                    'pick_object' => 'comment',
1258
                    'pick_val' => '__current__',
1259
                    'alias' => array( 'parent' ),
1260
                    'data' => array(),
1261
                    'hidden' => true
1262
                )
1263
            );
1264
        }
1265
        elseif ( 'taxonomy' == $object ) {
1266
            $fields = array(
1267
	            'term_id' => array(
1268
		            'name' => 'term_id',
1269
		            'label' => 'ID',
1270
		            'type' => 'number',
1271
		            'alias' => array( 'id', 'ID' ),
1272
	                'options' => array(
1273
                        'number_format' => '9999.99'
1274
	                )
1275
	            ),
1276
                'name' => array(
1277
                    'name' => 'name',
1278
                    'label' => 'Title',
1279
                    'type' => 'text',
1280
                    'alias' => array( 'title' )
1281
                ),
1282
                'slug' => array(
1283
                    'name' => 'slug',
1284
                    'label' => 'Permalink',
1285
                    'type' => 'slug',
1286
                    'alias' => array( 'permalink' )
1287
                ),
1288
                'description' => array(
1289
                    'name' => 'description',
1290
                    'label' => 'Description',
1291
                    'type' => 'wysiwyg',
1292
                    'alias' => array( 'content' )
1293
                ),
1294
                'taxonomy' => array(
1295
                    'name' => 'taxonomy',
1296
                    'label' => 'Taxonomy',
1297
                    'type' => 'text',
1298
                    'alias' => array()
1299
                ),
1300
                'parent' => array(
1301
                    'name' => 'parent',
1302
                    'label' => 'Parent',
1303
                    'type' => 'pick',
1304
                    'pick_object' => 'taxonomy',
1305
                    'pick_val' => '__current__',
1306
                    'alias' => array( 'parent' ),
1307
                    'data' => array(),
1308
                    'hidden' => true
1309
                ),
1310
                'term_taxonomy_id' => array(
1311
                    'name' => 'term_taxonomy_id',
1312
                    'label' => 'Term Taxonomy ID',
1313
                    'type' => 'number',
1314
                    'alias' => array(),
1315
                    'hidden' => true,
1316
	                'options' => array(
1317
                        'number_format' => '9999.99'
1318
	                )
1319
                ),
1320
                'term_group' => array(
1321
                    'name' => 'term_group',
1322
                    'label' => 'Term Group',
1323
                    'type' => 'number',
1324
                    'alias' => array( 'group' ),
1325
                    'hidden' => true,
1326
	                'options' => array(
1327
                        'number_format' => '9999.99'
1328
	                )
1329
                ),
1330
                'count' => array(
1331
                    'name' => 'count',
1332
                    'label' => 'Count',
1333
                    'type' => 'number',
1334
                    'alias' => array(),
1335
                    'hidden' => true,
1336
	                'options' => array(
1337
                        'number_format' => '9999.99'
1338
	                )
1339
                )
1340
            );
1341
        }
1342
1343
        $fields = $this->do_hook( 'get_wp_object_fields', $fields, $object, $pod );
1344
1345
        foreach ( $fields as $field => $options ) {
1346
            if ( !isset( $options[ 'alias' ] ) )
1347
                $options[ 'alias' ] = array();
1348
            else
1349
                $options[ 'alias' ] = (array) $options[ 'alias' ];
1350
1351
            if ( !isset( $options[ 'name' ] ) )
1352
                $options[ 'name' ] = $field;
1353
1354
            $fields[ $field ] = $options;
1355
        }
1356
1357
        $fields = PodsForm::fields_setup( $fields );
1358
1359 View Code Duplication
        if ( did_action( 'init' ) && pods_api_cache() )
1360
            pods_transient_set( trim( 'pods_api_object_fields_' . $object . $pod_name . '_', '_' ), $fields );
1361
1362
        return $fields;
1363
    }
1364
1365
    /**
1366
     *
1367
     * @see PodsAPI::save_pod
1368
     *
1369
     * Add a Pod via the Wizard
1370
     *
1371
     * $params['create_extend'] string Create or Extend a Content Type
1372
     * $params['create_pod_type'] string Pod Type (for Creating)
1373
     * $params['create_name'] string Pod Name (for Creating)
1374
     * $params['create_label_plural'] string Plural Label (for Creating)
1375
     * $params['create_label_singular'] string Singular Label (for Creating)
1376
     * $params['create_storage'] string Storage Type (for Creating Post Types)
1377
     * $params['create_storage_taxonomy'] string Storage Type (for Creating Taxonomies)
1378
     * $params['extend_pod_type'] string Pod Type (for Extending)
1379
     * $params['extend_post_type'] string Post Type (for Extending Post Types)
1380
     * $params['extend_taxonomy'] string Taxonomy (for Extending Taxonomies)
1381
     * $params['extend_storage'] string Storage Type (for Extending Post Types / Users / Comments)
1382
     *
1383
     * @param array $params An associative array of parameters
1384
     *
1385
     * @return bool|int Pod ID
1386
     * @since 2.0
1387
     */
1388
    public function add_pod ( $params ) {
1389
        $defaults = array(
1390
            'create_extend' => 'create',
1391
            'create_pod_type' => 'post_type',
1392
1393
            'create_name' => '',
1394
            'create_label_singular' => '',
1395
            'create_label_plural' => '',
1396
            'create_storage' => 'meta',
1397
            'create_storage_taxonomy' => ( function_exists( 'get_term_meta' ) ? 'meta' : 'none' ),
1398
1399
            'create_setting_name' => '',
1400
            'create_label_title' => '',
1401
            'create_label_menu' => '',
1402
            'create_menu_location' => 'settings',
1403
1404
            'extend_pod_type' => 'post_type',
1405
            'extend_post_type' => 'post',
1406
            'extend_taxonomy' => 'category',
1407
            'extend_table' => '',
1408
            'extend_storage' => 'meta',
1409
            'extend_storage_taxonomy' => ( function_exists( 'get_term_meta' ) ? 'meta' : 'table' ),
1410
        );
1411
1412
        $params = (object) array_merge( $defaults, (array) $params );
1413
1414
        if ( empty( $params->create_extend ) || !in_array( $params->create_extend, array( 'create', 'extend' ) ) )
1415
            return pods_error( __( 'Please choose whether to Create or Extend a Content Type', 'pods' ), $this );
1416
1417
        $pod_params = array(
1418
            'name' => '',
1419
            'label' => '',
1420
            'type' => '',
1421
            'storage' => 'table',
1422
            'object' => '',
1423
            'options' => array()
1424
        );
1425
1426
        if ( 'create' == $params->create_extend ) {
1427
            $label = ucwords( str_replace( '_', ' ', $params->create_name ) );
1428
1429
            if ( !empty( $params->create_label_singular ) )
1430
                $label = $params->create_label_singular;
1431
1432
            $pod_params[ 'name' ] = $params->create_name;
1433
            $pod_params[ 'label' ] = ( !empty( $params->create_label_plural ) ? $params->create_label_plural : $label );
1434
            $pod_params[ 'type' ] = $params->create_pod_type;
1435
            $pod_params[ 'options' ] = array(
1436
                'label_singular' => ( !empty( $params->create_label_singular ) ? $params->create_label_singular : $pod_params[ 'label' ] ),
1437
                'public' => 1,
1438
                'show_ui' => 1
1439
            );
1440
1441
            // Auto-generate name if not provided
1442
            if ( empty( $pod_params[ 'name' ] ) && !empty( $pod_params[ 'options' ][ 'label_singular' ] ) )
1443
                $pod_params[ 'name' ] = pods_clean_name( $pod_params[ 'options' ][ 'label_singular' ] );
1444
1445
            if ( 'post_type' == $pod_params[ 'type' ] ) {
1446
                if ( empty(  $pod_params[ 'name' ] ) )
1447
                    return pods_error( 'Please enter a Name for this Pod', $this );
1448
1449
                $pod_params[ 'storage' ] = $params->create_storage;
1450
1451
                if ( pods_tableless() )
1452
                    $pod_params[ 'storage' ] = 'meta';
1453
            }
1454
            elseif ( 'taxonomy' == $pod_params[ 'type' ] ) {
1455
                if ( empty(  $pod_params[ 'name' ] ) )
1456
                    return pods_error( 'Please enter a Name for this Pod', $this );
1457
1458
                $pod_params[ 'storage' ] = $params->create_storage_taxonomy;
1459
1460
                if ( pods_tableless() )
1461
                    $pod_params[ 'storage' ] = ( function_exists( 'get_term_meta' ) ? 'meta' : 'none' );
1462
1463
				$pod_params['options']['hierarchical'] = 1;
1464
            }
1465
            elseif ( 'pod' == $pod_params[ 'type' ] ) {
1466
                if ( empty(  $pod_params[ 'name' ] ) )
1467
                    return pods_error( 'Please enter a Name for this Pod', $this );
1468
1469
                if ( pods_tableless() ) {
1470
                    $pod_params[ 'type' ] = 'post_type';
1471
                    $pod_params[ 'storage' ] = 'meta';
1472
                }
1473
            }
1474
            elseif ( 'settings' == $pod_params[ 'type' ] ) {
1475
                $pod_params[ 'name' ] = $params->create_setting_name;
1476
                $pod_params[ 'label' ] = ( !empty( $params->create_label_title ) ? $params->create_label_title : ucwords( str_replace( '_', ' ', $params->create_setting_name ) ) );
1477
                $pod_params[ 'options' ] = array(
1478
                    'menu_name' => ( !empty( $params->create_label_menu ) ? $params->create_label_menu : $pod_params[ 'label' ] ),
1479
                    'menu_location' => $params->create_menu_location
1480
                );
1481
                $pod_params[ 'storage' ] = 'none';
1482
1483
                // Auto-generate name if not provided
1484
                if ( empty( $pod_params[ 'name' ] ) && !empty( $pod_params[ 'label' ] ) )
1485
                    $pod_params[ 'name' ] = pods_clean_name( $pod_params[ 'label' ] );
1486
1487
                if ( empty( $pod_params[ 'name' ] ) )
1488
                    return pods_error( 'Please enter a Name for this Pod', $this );
1489
            }
1490
        }
1491
        elseif ( 'extend' == $params->create_extend ) {
1492
            $pod_params[ 'type' ] = $params->extend_pod_type;
1493
1494
            if ( 'post_type' == $pod_params[ 'type' ] ) {
1495
                $pod_params[ 'storage' ] = $params->extend_storage;
1496
1497
                if ( pods_tableless() )
1498
                    $pod_params[ 'storage' ] = 'meta';
1499
1500
                $pod_params[ 'name' ] = $params->extend_post_type;
1501
            }
1502
            elseif ( 'taxonomy' == $pod_params[ 'type' ] ) {
1503
                $pod_params[ 'storage' ] = $params->extend_storage_taxonomy;
1504
1505
                if ( pods_tableless() )
1506
                    $pod_params[ 'storage' ] = ( function_exists( 'get_term_meta' ) ? 'meta' : 'none' );
1507
1508
                $pod_params[ 'name' ] = $params->extend_taxonomy;
1509
            }
1510
            elseif ( 'table' == $pod_params[ 'type' ] ) {
1511
                $pod_params[ 'storage' ] = 'table';
1512
                $pod_params[ 'name' ] = $params->extend_table;
1513
            }
1514
            else {
1515
                $pod_params[ 'storage' ] = $params->extend_storage;
1516
1517
                if ( pods_tableless() )
1518
                    $pod_params[ 'storage' ] = 'meta';
1519
1520
                $pod_params[ 'name' ] = $params->extend_pod_type;
1521
            }
1522
1523
            $pod_params[ 'label' ] = ucwords( str_replace( '_', ' ', $pod_params[ 'name' ] ) );
1524
            $pod_params[ 'object' ] = $pod_params[ 'name' ];
1525
        }
1526
1527
        if ( empty( $pod_params[ 'object' ] ) ) {
1528
            if ( 'post_type' == $pod_params[ 'type' ] ) {
1529
                $check = get_post_type_object( $pod_params[ 'name' ] );
1530
1531 View Code Duplication
                if ( !empty( $check ) )
1532
                    return pods_error( sprintf( __( 'Post Type %s already exists, try extending it instead', 'pods' ), $pod_params[ 'name' ] ), $this );
1533
1534
                $pod_params[ 'options' ][ 'supports_title' ] = 1;
1535
                $pod_params[ 'options' ][ 'supports_editor' ] = 1;
1536
            }
1537
            elseif ( 'taxonomy' == $pod_params[ 'type' ] ) {
1538
                $check = get_taxonomy( $pod_params[ 'name' ] );
1539
1540 View Code Duplication
                if ( !empty( $check ) )
1541
                    return pods_error( sprintf( __( 'Taxonomy %s already exists, try extending it instead', 'pods' ), $pod_params[ 'name' ] ), $this );
1542
            }
1543
        }
1544
1545
        if ( !empty( $pod_params ) )
1546
            return $this->save_pod( $pod_params );
1547
1548
        return false;
1549
    }
1550
1551
    /**
1552
     * Add or edit a Pod
1553
     *
1554
     * $params['id'] int The Pod ID
1555
     * $params['name'] string The Pod name
1556
     * $params['label'] string The Pod label
1557
     * $params['type'] string The Pod type
1558
     * $params['object'] string The object being extended (if any)
1559
     * $params['storage'] string The Pod storage
1560
     * $params['options'] array Options
1561
     *
1562
     * @param array $params An associative array of parameters
1563
     * @param bool $sanitized (optional) Decides whether the params have been sanitized before being passed, will sanitize them if false.
1564
     * @param bool|int $db (optional) Whether to save into the DB or just return Pod array.
1565
     *
1566
     * @return int Pod ID
1567
     * @since 1.7.9
1568
     */
1569
    public function save_pod ( $params, $sanitized = false, $db = true ) {
1570
        $tableless_field_types = PodsForm::tableless_field_types();
1571
        $simple_tableless_objects = PodsForm::simple_tableless_objects();
1572
1573
        $load_params = (object) $params;
1574
1575
        if ( isset( $load_params->id ) && isset( $load_params->name ) )
1576
            unset( $load_params->name );
1577
1578
        if ( isset( $load_params->old_name ) )
1579
            $load_params->name = $load_params->old_name;
1580
1581
        $load_params->table_info = true;
1582
1583
        $pod = $this->load_pod( $load_params, false );
1584
1585
        $params = (object) $params;
1586
1587
        if ( false === $sanitized )
1588
            $params = pods_sanitize( $params );
1589
1590
        $old_id = $old_name = $old_storage = null;
1591
1592
        $old_fields = $old_options = array();
1593
1594
		if ( isset( $params->name ) && ! isset( $params->object ) ) {
1595
			$params->name = pods_clean_name( $params->name );
1596
		}
1597
1598
        if ( !empty( $pod ) ) {
1599
            if ( isset( $params->id ) && 0 < $params->id )
1600
                $old_id = $params->id;
1601
1602
            $params->id = $pod[ 'id' ];
1603
1604
            $old_name = $pod[ 'name' ];
1605
            $old_storage = $pod[ 'storage' ];
1606
            $old_fields = $pod[ 'fields' ];
1607
            $old_options = $pod[ 'options' ];
1608
1609
            if ( !isset( $params->name ) && empty( $params->name ) )
1610
                $params->name = $pod[ 'name' ];
1611
1612
            if ( $old_name != $params->name && false !== $this->pod_exists( array( 'name' => $params->name ) ) )
1613
                return pods_error( sprintf( __( 'Pod %s already exists, you cannot rename %s to that', 'pods' ), $params->name, $old_name ), $this );
1614
1615
            if ( $old_name != $params->name && in_array( $pod[ 'type' ], array( 'user', 'comment', 'media' ) ) && in_array( $pod[ 'object' ], array( 'user', 'comment', 'media' ) ) )
1616
                return pods_error( sprintf( __( 'Pod %s cannot be renamed, it extends an existing WP Object', 'pods' ), $old_name ), $this );
1617
1618
            if ( $old_name != $params->name && in_array( $pod[ 'type' ], array( 'post_type', 'taxonomy' ) ) && !empty( $pod[ 'object' ] ) && $pod[ 'object' ] == $old_name )
1619
                return pods_error( sprintf( __( 'Pod %s cannot be renamed, it extends an existing WP Object', 'pods' ), $old_name ), $this );
1620
1621
            if ( $old_id != $params->id ) {
1622
                if ( $params->type == $pod[ 'type' ] && isset( $params->object ) && $params->object == $pod[ 'object' ] )
1623
                    return pods_error( sprintf( __( 'Pod using %s already exists, you can not reuse an object across multiple pods', 'pods' ), $params->object ), $this );
1624
                else
1625
                    return pods_error( sprintf( __( 'Pod %s already exists', 'pods' ), $params->name ), $this );
1626
            }
1627
        }
1628
		elseif ( in_array( $params->name, array( 'order','orderby','post_type' ) ) && 'post_type' == pods_var( 'type', $params ) ) {
1629
			return pods_error( sprintf( 'There are certain names that a Custom Post Types cannot be named and unfortunately, %s is one of them.', $params->name ), $this );
1630
		}
1631
        else {
1632
            $pod = array(
1633
                'id' => 0,
1634
                'name' => $params->name,
1635
                'label' => $params->name,
1636
                'description' => '',
1637
                'type' => 'pod',
1638
                'storage' => 'table',
1639
                'object' => '',
1640
                'alias' => '',
1641
                'options' => array(),
1642
                'fields' => array()
1643
            );
1644
        }
1645
1646
        // Blank out fields and options for AJAX calls (everything should be sent to it for a full overwrite)
1647
        if ( defined( 'DOING_AJAX' ) && DOING_AJAX ) {
1648
            $pod[ 'fields' ] = array();
1649
            $pod[ 'options' ] = array();
1650
        }
1651
1652
        // Setup options
1653
        $options = get_object_vars( $params );
1654
1655
        if ( isset( $options[ 'method' ] ) )
1656
            unset( $options[ 'method' ] );
1657
1658
        $options_ignore = array(
1659
            'object_type',
1660
            'object_name',
1661
            'table',
1662
            'meta_table',
1663
            'pod_table',
1664
            'field_id',
1665
            'field_index',
1666
            'field_slug',
1667
            'field_type',
1668
            'field_parent',
1669
            'field_parent_select',
1670
            'meta_field_id',
1671
            'meta_field_index',
1672
            'meta_field_value',
1673
            'pod_field_id',
1674
            'pod_field_index',
1675
            'object_fields',
1676
            'join',
1677
            'where',
1678
            'where_default',
1679
            'orderby',
1680
            'pod',
1681
            'recurse',
1682
            'table_info',
1683
            'attributes',
1684
            'group',
1685
            'grouped',
1686
            'developer_mode',
1687
            'dependency',
1688
            'depends-on',
1689
            'excludes-on'
1690
        );
1691
1692
        foreach ( $options_ignore as $ignore ) {
1693
            if ( isset( $options[ $ignore ] ) )
1694
                unset( $options[ $ignore ] );
1695
        }
1696
1697
        $exclude = array(
1698
            'id',
1699
            'name',
1700
            'label',
1701
            'description',
1702
            'type',
1703
            'storage',
1704
            'object',
1705
            'alias',
1706
            'options',
1707
            'fields'
1708
        );
1709
1710 View Code Duplication
        foreach ( $exclude as $k => $exclude_field ) {
1711
            $aliases = array( $exclude_field );
1712
1713
            if ( is_array( $exclude_field ) ) {
1714
                $aliases = array_merge( array( $k ), $exclude_field );
1715
                $exclude_field = $k;
1716
            }
1717
1718
            foreach ( $aliases as $alias ) {
1719
                if ( isset( $options[ $alias ] ) ) {
1720
                    $pod[ $exclude_field ] = pods_trim( $options[ $alias ] );
1721
1722
                    unset( $options[ $alias ] );
1723
                }
1724
            }
1725
        }
1726
1727
        if ( pods_tableless() && !in_array( $pod[ 'type' ], array( 'settings', 'table' ) ) ) {
1728
            if ( 'pod' == $pod[ 'type' ] )
1729
                $pod[ 'type' ] = 'post_type';
1730
1731 View Code Duplication
            if ( 'table' == $pod[ 'storage' ] ) {
1732
                if ( 'taxonomy' == $pod[ 'type' ] && ! function_exists( 'get_term_meta' ) )
1733
                    $pod[ 'storage' ] = 'none';
1734
                else
1735
                    $pod[ 'storage' ] = 'meta';
1736
            }
1737
        }
1738
1739
        $pod[ 'options' ][ 'type' ] = $pod[ 'type' ];
1740
        $pod[ 'options' ][ 'storage' ] = $pod[ 'storage' ];
1741
        $pod[ 'options' ][ 'object' ] = $pod[ 'object' ];
1742
        $pod[ 'options' ][ 'alias' ] = $pod[ 'alias' ];
1743
1744
        $pod[ 'options' ] = array_merge( $pod[ 'options' ], $options );
1745
1746
		/**
1747
		 * @var WP_Query
1748
		 */
1749
		global $wp_query;
0 ignored issues
show
Compatibility Best Practice introduced by
Use of global functionality is not recommended; it makes your code harder to test, and less reusable.

Instead of relying on global state, we recommend one of these alternatives:

1. Pass all data via parameters

function myFunction($a, $b) {
    // Do something
}

2. Create a class that maintains your state

class MyClass {
    private $a;
    private $b;

    public function __construct($a, $b) {
        $this->a = $a;
        $this->b = $b;
    }

    public function myFunction() {
        // Do something
    }
}
Loading history...
1750
1751
		$reserved_query_vars = array(
1752
			'post_type',
1753
			'taxonomy',
1754
			'output'
1755
		);
1756
1757
		if ( is_object( $wp_query ) ) {
1758
			$reserved_query_vars = array_merge( $reserved_query_vars, array_keys( $wp_query->fill_query_vars( array() ) ) );
1759
		}
1760
1761 View Code Duplication
		if ( isset( $pod[ 'options' ][ 'query_var_string' ] ) ) {
1762
			if ( in_array( $pod[ 'options' ][ 'query_var_string' ], $reserved_query_vars ) ) {
1763
				$pod[ 'options' ][ 'query_var_string' ] = $pod[ 'options' ][ 'type' ] . '_' . $pod[ 'options' ][ 'query_var_string' ];
1764
			}
1765
		}
1766
1767 View Code Duplication
		if ( isset( $pod[ 'options' ][ 'query_var' ] ) ) {
1768
			if ( in_array( $pod[ 'options' ][ 'query_var' ], $reserved_query_vars ) ) {
1769
				$pod[ 'options' ][ 'query_var' ] = $pod[ 'options' ][ 'type' ] . '_' . $pod[ 'options' ][ 'query_var' ];
1770
			}
1771
		}
1772
1773
        if ( strlen( $pod[ 'label' ] ) < 1 )
1774
            $pod[ 'label' ] = $pod[ 'name' ];
1775
1776
        if ( 'post_type' == $pod[ 'type' ] ) {
1777
            // Max length for post types are 20 characters
1778
            $pod[ 'name' ] = substr( $pod[ 'name' ], 0, 20 );
1779
        }
1780
        elseif ( 'taxonomy' == $pod[ 'type' ] ) {
1781
            // Max length for taxonomies are 32 characters
1782
            $pod[ 'name' ] = substr( $pod[ 'name' ], 0, 32 );
1783
        }
1784
1785
        $params->id = $pod[ 'id' ];
1786
        $params->name = $pod[ 'name' ];
1787
1788
        if ( null !== $old_name && $old_name != $params->name && empty( $pod[ 'object' ] ) ) {
1789
            if ( 'post_type' == $pod[ 'type' ] ) {
1790
                $check = get_post_type_object( $params->name );
1791
1792 View Code Duplication
                if ( !empty( $check ) )
1793
                    return pods_error( sprintf( __( 'Post Type %s already exists, you cannot rename %s to that', 'pods' ), $params->name, $old_name ), $this );
1794
            }
1795
            elseif ( 'taxonomy' == $pod[ 'type' ] ) {
1796
                $check = get_taxonomy( $params->name );
1797
1798 View Code Duplication
                if ( !empty( $check ) )
1799
                    return pods_error( sprintf( __( 'Taxonomy %s already exists, you cannot rename %s to that', 'pods' ), $params->name, $old_name ), $this );
1800
            }
1801
        }
1802
1803
        $field_table_operation = true;
1804
1805
        // Add new pod
1806
        if ( empty( $params->id ) ) {
1807
            if ( strlen( $params->name ) < 1 )
1808
                return pods_error( __( 'Pod name cannot be empty', 'pods' ), $this );
1809
1810
            $post_data = array(
1811
                'post_name' => $pod[ 'name' ],
1812
                'post_title' => $pod[ 'label' ],
1813
                'post_content' => $pod[ 'description' ],
1814
                'post_type' => '_pods_pod',
1815
                'post_status' => 'publish'
1816
            );
1817
1818
            if ( 'pod' == $pod[ 'type' ] && ( !is_array( $pod[ 'fields' ] ) || empty( $pod[ 'fields' ] ) ) ) {
1819
                $pod[ 'fields' ] = array();
1820
1821
                $pod[ 'fields' ][ 'name' ] = array(
1822
                    'name' => 'name',
1823
                    'label' => 'Name',
1824
                    'type' => 'text',
1825
                    'options' => array(
1826
                        'required' => '1'
1827
                    )
1828
                );
1829
1830
                $pod[ 'fields' ][ 'created' ] = array(
1831
                    'name' => 'created',
1832
                    'label' => 'Date Created',
1833
                    'type' => 'datetime',
1834
                    'options' => array(
1835
                        'datetime_format' => 'ymd_slash',
1836
                        'datetime_time_type' => '12',
1837
                        'datetime_time_format' => 'h_mm_ss_A'
1838
                    )
1839
                );
1840
1841
                $pod[ 'fields' ][ 'modified' ] = array(
1842
                    'name' => 'modified',
1843
                    'label' => 'Date Modified',
1844
                    'type' => 'datetime',
1845
                    'options' => array(
1846
                        'datetime_format' => 'ymd_slash',
1847
                        'datetime_time_type' => '12',
1848
                        'datetime_time_format' => 'h_mm_ss_A'
1849
                    )
1850
                );
1851
1852
                $pod[ 'fields' ][ 'author' ] = array(
1853
                    'name' => 'author',
1854
                    'label' => 'Author',
1855
                    'type' => 'pick',
1856
                    'pick_object' => 'user',
1857
                    'options' => array(
1858
                        'pick_format_type' => 'single',
1859
                        'pick_format_single' => 'autocomplete',
1860
                        'default_value' => '{@user.ID}'
1861
                    )
1862
                );
1863
1864
                $pod[ 'fields' ][ 'permalink' ] = array(
1865
                    'name' => 'permalink',
1866
                    'label' => 'Permalink',
1867
                    'type' => 'slug',
1868
                    'description' => 'Leave blank to auto-generate from Name'
1869
                );
1870
1871
                if ( !isset( $pod[ 'options' ][ 'pod_index' ] ) )
1872
                    $pod[ 'options' ][ 'pod_index' ] = 'name';
1873
            }
1874
1875
            $pod = $this->do_hook( 'save_pod_default_pod', $pod, $params, $sanitized, $db );
1876
1877
            $field_table_operation = false;
1878
        }
1879
        else {
1880
            $post_data = array(
1881
                'ID' => $pod[ 'id' ],
1882
                'post_name' => $pod[ 'name' ],
1883
                'post_title' => $pod[ 'label' ],
1884
                'post_content' => $pod[ 'description' ],
1885
                'post_status' => 'publish'
1886
            );
1887
        }
1888
1889
        if ( true === $db ) {
1890
            if ( !has_filter( 'wp_unique_post_slug', array( $this, 'save_slug_fix' ) ) )
1891
                add_filter( 'wp_unique_post_slug', array( $this, 'save_slug_fix' ), 100, 6 );
1892
1893
            $conflicted = false;
1894
1895
            // Headway compatibility fix
1896
            if ( has_filter( 'wp_insert_post_data', 'headway_clean_slug', 0 ) ) {
1897
                remove_filter( 'wp_insert_post_data', 'headway_clean_slug', 0 );
1898
1899
                $conflicted = true;
1900
            }
1901
1902
            $params->id = $this->save_wp_object( 'post', $post_data, $pod[ 'options' ], true, true );
1903
1904
            if ( $conflicted )
1905
                add_filter( 'wp_insert_post_data', 'headway_clean_slug', 0 );
1906
1907
            if ( false === $params->id )
1908
                return pods_error( __( 'Cannot save Pod', 'pods' ), $this );
1909
        }
1910
        elseif ( empty( $params->id ) )
1911
            $params->id = (int) $db;
1912
1913
        $pod[ 'id' ] = $params->id;
1914
1915
        // Setup / update tables
1916
        if ( 'table' != $pod[ 'type' ] && 'table' == $pod[ 'storage' ] && $old_storage != $pod[ 'storage' ] && $db ) {
1917
            $definitions = array( "`id` BIGINT(20) UNSIGNED AUTO_INCREMENT PRIMARY KEY" );
1918
1919
            $defined_fields = array();
1920
1921
            foreach ( $pod[ 'fields' ] as $field ) {
1922
                if ( !is_array( $field ) || !isset( $field[ 'name' ] ) || in_array( $field[ 'name' ], $defined_fields ) )
1923
                    continue;
1924
1925
                $defined_fields[] = $field[ 'name' ];
1926
1927
                if ( !in_array( $field[ 'type' ], $tableless_field_types ) || ( 'pick' == $field[ 'type' ] && in_array( pods_var( 'pick_object', $field ), $simple_tableless_objects ) ) ) {
1928
                    $definition = $this->get_field_definition( $field[ 'type' ], array_merge( $field, pods_var_raw( 'options', $field, array() ) ) );
1929
1930
                    if ( 0 < strlen( $definition ) )
1931
                        $definitions[] = "`{$field['name']}` " . $definition;
1932
                }
1933
            }
1934
1935
            pods_query( "DROP TABLE IF EXISTS `@wp_pods_{$params->name}`" );
1936
1937
            $result = pods_query( "CREATE TABLE `@wp_pods_{$params->name}` (" . implode( ', ', $definitions ) . ") DEFAULT CHARSET utf8", $this );
1938
1939
            if ( empty( $result ) )
1940
                return pods_error( __( 'Cannot add Database Table for Pod', 'pods' ), $this );
1941
1942
        }
1943
        elseif ( 'table' != $pod[ 'type' ] && 'table' == $pod[ 'storage' ] && $pod[ 'storage' ] == $old_storage && null !== $old_name && $old_name != $params->name && $db ) {
1944
            $result = pods_query( "ALTER TABLE `@wp_pods_{$old_name}` RENAME `@wp_pods_{$params->name}`", $this );
1945
1946
            if ( empty( $result ) )
1947
                return pods_error( __( 'Cannot update Database Table for Pod', 'pods' ), $this );
1948
        }
1949
1950
        /**
1951
         * @var $wpdb wpdb
1952
         */
1953
        global $wpdb;
0 ignored issues
show
Compatibility Best Practice introduced by
Use of global functionality is not recommended; it makes your code harder to test, and less reusable.

Instead of relying on global state, we recommend one of these alternatives:

1. Pass all data via parameters

function myFunction($a, $b) {
    // Do something
}

2. Create a class that maintains your state

class MyClass {
    private $a;
    private $b;

    public function __construct($a, $b) {
        $this->a = $a;
        $this->b = $b;
    }

    public function myFunction() {
        // Do something
    }
}
Loading history...
1954
1955
		if ( null !== $old_name && $old_name != $params->name && $db ) {
1956
        	// Rename items in the DB pointed at the old WP Object names
1957
			if ( 'post_type' == $pod[ 'type' ] && empty( $pod[ 'object' ] ) ) {
1958
				$this->rename_wp_object_type( 'post', $old_name, $params->name );
1959
			}
1960 View Code Duplication
			elseif ( 'taxonomy' == $pod[ 'type' ] && empty( $pod[ 'object' ] ) ) {
1961
				$this->rename_wp_object_type( 'taxonomy', $old_name, $params->name );
1962
			}
1963 View Code Duplication
			elseif ( 'comment' == $pod[ 'type' ] && empty( $pod[ 'object' ] ) ) {
1964
				$this->rename_wp_object_type( 'comment', $old_name, $params->name );
1965
			}
1966
			elseif ( 'settings' == $pod[ 'type' ] ) {
1967
				$this->rename_wp_object_type( 'settings', $old_name, $params->name );
1968
			}
1969
1970
        	// Sync any related fields if the name has changed
1971
            $fields = pods_query( "
1972
                SELECT `p`.`ID`
1973
                FROM `{$wpdb->posts}` AS `p`
1974
                LEFT JOIN `{$wpdb->postmeta}` AS `pm` ON `pm`.`post_id` = `p`.`ID`
1975
                LEFT JOIN `{$wpdb->postmeta}` AS `pm2` ON `pm2`.`post_id` = `p`.`ID`
1976
                WHERE
1977
                    `p`.`post_type` = '_pods_field'
1978
                    AND `pm`.`meta_key` = 'pick_object'
1979
                    AND (
1980
                    	`pm`.`meta_value` = 'pod'
1981
                    	OR `pm`.`meta_value` = '" . $pod[ 'type' ] . "'
1982
					)
1983
                    AND `pm2`.`meta_key` = 'pick_val'
1984
                    AND `pm2`.`meta_value` = '{$old_name}'
1985
            " );
1986
1987 View Code Duplication
            if ( !empty( $fields ) ) {
1988
                foreach ( $fields as $field ) {
1989
                    update_post_meta( $field->ID, 'pick_object', $pod[ 'type' ] );
1990
                    update_post_meta( $field->ID, 'pick_val', $params->name );
1991
                }
1992
            }
1993
1994
            $fields = pods_query( "
1995
                SELECT `p`.`ID`
1996
                FROM `{$wpdb->posts}` AS `p`
1997
                LEFT JOIN `{$wpdb->postmeta}` AS `pm` ON `pm`.`post_id` = `p`.`ID`
1998
                WHERE
1999
                    `p`.`post_type` = '_pods_field'
2000
                    AND `pm`.`meta_key` = 'pick_object'
2001
                    AND (
2002
                    	`pm`.`meta_value` = 'pod-{$old_name}'
2003
                    	OR `pm`.`meta_value` = '" . $pod[ 'type' ] . "-{$old_name}'
2004
					)
2005
            " );
2006
2007 View Code Duplication
            if ( !empty( $fields ) ) {
2008
                foreach ( $fields as $field ) {
2009
                    update_post_meta( $field->ID, 'pick_object', $pod[ 'type' ] );
2010
                    update_post_meta( $field->ID, 'pick_val', $params->name );
2011
                }
2012
            }
2013
        }
2014
2015
        // Sync built-in options for post types and taxonomies
2016
        if ( in_array( $pod[ 'type' ], array( 'post_type', 'taxonomy' ) ) && empty( $pod[ 'object' ] ) && $db ) {
2017
            // Build list of 'built_in' for later
2018
            $built_in = array();
2019
2020
            foreach ( $pod[ 'options' ] as $key => $val ) {
2021
                if ( false === strpos( $key, 'built_in_' ) )
2022
                    continue;
2023
                elseif ( false !== strpos( $key, 'built_in_post_types_' ) )
2024
                    $built_in_type = 'post_type';
2025
                elseif ( false !== strpos( $key, 'built_in_taxonomies_' ) )
2026
                    $built_in_type = 'taxonomy';
2027
                else
2028
                    continue;
2029
2030
                if ( $built_in_type == $pod[ 'type' ] )
2031
                    continue;
2032
2033
                if ( !isset( $built_in[ $built_in_type ] ) )
2034
                    $built_in[ $built_in_type ] = array();
2035
2036
                $built_in_object = str_replace( array( 'built_in_post_types_', 'built_in_taxonomies_' ), '', $key );
2037
2038
                $built_in[ $built_in_type ][ $built_in_object ] = (int) $val;
2039
            }
2040
2041
            $lookup_option = $lookup_built_in = false;
2042
2043
            $lookup_name = $pod[ 'name' ];
2044
2045
            if ( 'post_type' == $pod[ 'type' ] ) {
2046
                $lookup_option = 'built_in_post_types_' . $lookup_name;
2047
                $lookup_built_in = 'taxonomy';
2048
            }
2049
            elseif ( 'taxonomy' == $pod[ 'type' ] ) {
2050
                $lookup_option = 'built_in_taxonomies_' . $lookup_name;
2051
                $lookup_built_in = 'post_type';
2052
            }
2053
2054
            if ( !empty( $lookup_option ) && !empty( $lookup_built_in ) && isset( $built_in[ $lookup_built_in ] ) ) {
2055
                foreach ( $built_in[ $lookup_built_in ] as $built_in_object => $val ) {
2056
                    $search_val = 1;
2057
2058
                    if ( 1 == $val )
2059
                        $search_val = 0;
2060
2061
                    $query = "SELECT p.ID FROM {$wpdb->posts} AS p
2062
                                LEFT JOIN {$wpdb->postmeta} AS pm ON pm.post_id = p.ID AND pm.meta_key = '{$lookup_option}'
2063
                                LEFT JOIN {$wpdb->postmeta} AS pm2 ON pm2.post_id = p.ID AND pm2.meta_key = 'type' AND pm2.meta_value = '{$lookup_built_in}'
2064
                                LEFT JOIN {$wpdb->postmeta} AS pm3 ON pm3.post_id = p.ID AND pm3.meta_key = 'object' AND pm3.meta_value = ''
2065
                                WHERE p.post_type = '_pods_pod' AND p.post_name = '{$built_in_object}'
2066
                                    AND pm2.meta_id IS NOT NULL
2067
                                    AND ( pm.meta_id IS NULL OR pm.meta_value = {$search_val} )";
2068
2069
                    $results = pods_query( $query );
2070
2071
                    if ( !empty( $results ) ) {
2072
                        foreach ( $results as $the_pod ) {
2073
                            delete_post_meta( $the_pod->ID, $lookup_option );
2074
2075
                            add_post_meta( $the_pod->ID, $lookup_option, $val );
2076
                        }
2077
                    }
2078
                }
2079
            }
2080
        }
2081
2082
        $saved = array();
2083
        $errors = array();
2084
2085
        $field_index_change = false;
2086
        $field_index_id = 0;
2087
2088
        $id_required = false;
2089
2090
        $field_index = pods_var( 'pod_index', $pod[ 'options' ], 'id', null, true );
2091
2092
        if ( 'pod' == $pod[ 'type' ] && !empty( $pod[ 'fields' ] ) && isset( $pod[ 'fields' ][ $field_index ] ) )
2093
            $field_index_id = $pod[ 'fields' ][ $field_index ];
2094
2095
        if ( isset( $params->fields ) || ( defined( 'DOING_AJAX' ) && DOING_AJAX ) ) {
2096
            $fields = array();
2097
2098
            if ( isset( $params->fields ) ) {
2099
                $params->fields = (array) $params->fields;
2100
2101
                $weight = 0;
2102
2103
                foreach ( $params->fields as $field ) {
2104
                    if ( !is_array( $field ) || !isset( $field[ 'name' ] ) )
2105
                        continue;
2106
2107
                    if ( !isset( $field[ 'weight' ] ) ) {
2108
                        $field[ 'weight' ] = $weight;
2109
2110
                        $weight++;
2111
                    }
2112
2113
                    $fields[ $field[ 'name' ] ] = $field;
2114
                }
2115
            }
2116
2117
            $weight = 0;
2118
2119
            $saved_field_ids = array();
2120
2121
            foreach ( $pod[ 'fields' ] as $k => $field ) {
2122
                if ( !empty( $old_id ) && ( !is_array( $field ) || !isset( $field[ 'name' ] ) || !isset( $fields[ $field[ 'name' ] ] ) ) ) {
2123
                    // Iterative change handling for setup-edit.php
2124
                    if ( !is_array( $field ) && isset( $old_fields[ $k ] ) )
2125
                        $saved[ $old_fields[ $k ][ 'name' ] ] = true;
2126
2127
                    continue;
2128
                }
2129
2130
                if ( !empty( $old_id ) )
2131
                    $field = array_merge( $field, $fields[ $field[ 'name' ] ] );
2132
2133
                $field[ 'pod' ] = $pod;
2134
2135
                if ( !isset( $field[ 'weight' ] ) ) {
2136
                    $field[ 'weight' ] = $weight;
2137
2138
                    $weight++;
2139
                }
2140
2141
                if ( 0 < $field_index_id && pods_var( 'id', $field ) == $field_index_id )
2142
                    $field_index_change = $field[ 'name' ];
2143
2144
                if ( 0 < pods_var( 'id', $field ) )
2145
                    $id_required = true;
2146
2147
                if ( $id_required )
2148
                    $field[ 'id_required' ] = true;
2149
2150
                $field_data = $field;
2151
2152
                $field = $this->save_field( $field_data, $field_table_operation, true, $db );
2153
2154
                if ( true !== $db ) {
2155
                    $pod[ 'fields' ][ $k ] = $field;
2156
                    $saved_field_ids[] = $field[ 'id' ];
2157
                }
2158
                else {
2159
                    if ( !empty( $field ) && 0 < $field ) {
2160
                        $saved[ $field_data[ 'name' ] ] = true;
2161
                        $saved_field_ids[] = $field;
2162
                    }
2163
                    else
2164
                        $errors[] = sprintf( __( 'Cannot save the %s field', 'pods' ), $field_data[ 'name' ] );
2165
                }
2166
            }
2167
2168
            if ( true === $db ) {
2169
                foreach ( $old_fields as $field ) {
2170
                    if ( isset( $pod[ 'fields' ][ $field[ 'name' ] ] ) || isset( $saved[ $field[ 'name' ] ] ) || in_array( $field[ 'id' ], $saved_field_ids ) )
2171
                        continue;
2172
2173
                    if ( $field[ 'id' ] == $field_index_id )
2174
                        $field_index_change = 'id';
2175
                    elseif ( $field[ 'name' ] == $field_index )
2176
                        $field_index_change = 'id';
2177
2178
                    $this->delete_field( array(
2179
                        'id' => (int) $field[ 'id' ],
2180
                        'name' => $field[ 'name' ],
2181
                        'pod' => $pod
2182
                    ), $field_table_operation );
2183
                }
2184
            }
2185
2186
            // Update field index if the name has changed or the field has been removed
2187
            if ( false !== $field_index_change && true === $db )
2188
                update_post_meta( $pod[ 'id' ], 'pod_index', $field_index_change );
2189
        }
2190
2191
        if ( !empty( $errors ) )
2192
            return pods_error( $errors, $this );
2193
2194
        $this->cache_flush_pods( $pod );
2195
2196
		$refresh_pod = $this->load_pod( array( 'name' => $pod['name'] ), false );
2197
2198
		if ( $refresh_pod ) {
2199
			$pod = $refresh_pod;
2200
		}
2201
2202
		if ( 'post_type' == $pod['type'] ) {
2203
			PodsMeta::$post_types[ $pod['id'] ] = $pod;
2204
		} elseif ( 'taxonomy' == $pod['type'] ) {
2205
			PodsMeta::$taxonomies[ $pod['id'] ] = $pod;
2206
		} elseif ( 'media' == $pod['type'] ) {
2207
			PodsMeta::$media[ $pod['id'] ] = $pod;
2208
		} elseif ( 'user' == $pod['type'] ) {
2209
			PodsMeta::$user[ $pod['id'] ] = $pod;
2210
		} elseif ( 'comment' == $pod['type'] ) {
2211
			PodsMeta::$comment[ $pod['id'] ] = $pod;
2212
		}
2213
2214
        // Register Post Types / Taxonomies post-registration from PodsInit
2215
        if ( !empty( PodsInit::$content_types_registered ) && in_array( $pod[ 'type' ], array( 'post_type', 'taxonomy' ) ) && empty( $pod[ 'object' ] ) ) {
0 ignored issues
show
Bug introduced by
The property content_types_registered cannot be accessed from this context as it is declared private in class PodsInit.

This check looks for access to properties that are not accessible from the current context.

If you need to make a property accessible to another context you can either raise its visibility level or provide an accessible getter in the defining class.

Loading history...
2216
            global $pods_init;
0 ignored issues
show
Compatibility Best Practice introduced by
Use of global functionality is not recommended; it makes your code harder to test, and less reusable.

Instead of relying on global state, we recommend one of these alternatives:

1. Pass all data via parameters

function myFunction($a, $b) {
    // Do something
}

2. Create a class that maintains your state

class MyClass {
    private $a;
    private $b;

    public function __construct($a, $b) {
        $this->a = $a;
        $this->b = $b;
    }

    public function myFunction() {
        // Do something
    }
}
Loading history...
2217
2218
            $pods_init->setup_content_types( true );
2219
        }
2220
2221
        if ( true === $db )
2222
            return $pod[ 'id' ];
2223
        else
2224
            return $pod;
2225
    }
2226
2227
    /**
2228
     * Add or edit a field within a Pod
2229
     *
2230
     * $params['id'] int Field ID (id OR pod_id+pod+name required)
2231
     * $params['pod_id'] int Pod ID (id OR pod_id+pod+name required)
2232
     * $params['pod'] string Pod name (id OR pod_id+pod+name required)
2233
     * $params['name'] string Field name (id OR pod_id+pod+name required)
2234
     * $params['label'] string (optional) Field label
2235
     * $params['type'] string (optional) Field type (avatar, boolean, code, color, currency, date, datetime, email, file, number, paragraph, password, phone, pick, slug, text, time, website, wysiwyg)
2236
     * $params['pick_object'] string (optional) Related Object (for relationships)
2237
     * $params['pick_val'] string (optional) Related Object name (for relationships)
2238
     * $params['sister_id'] int (optional) Related Field ID (for bidirectional relationships)
2239
     * $params['weight'] int (optional) Order in which the field appears
2240
     * $params['options'] array (optional) Options
2241
     *
2242
     * @param array $params An associative array of parameters
2243
     * @param bool $table_operation (optional) Whether or not to handle table operations
2244
     * @param bool $sanitized (optional) Decides wether the params have been sanitized before being passed, will sanitize them if false.
2245
     * @param bool|int $db (optional) Whether to save into the DB or just return field array.
2246
     *
2247
     * @return int|array The field ID or field array (if !$db)
2248
     * @since 1.7.9
2249
     */
2250
    public function save_field ( $params, $table_operation = true, $sanitized = false, $db = true ) {
2251
        /**
2252
         * @var $wpdb wpdb
2253
         */
2254
        global $wpdb;
0 ignored issues
show
Compatibility Best Practice introduced by
Use of global functionality is not recommended; it makes your code harder to test, and less reusable.

Instead of relying on global state, we recommend one of these alternatives:

1. Pass all data via parameters

function myFunction($a, $b) {
    // Do something
}

2. Create a class that maintains your state

class MyClass {
    private $a;
    private $b;

    public function __construct($a, $b) {
        $this->a = $a;
        $this->b = $b;
    }

    public function myFunction() {
        // Do something
    }
}
Loading history...
2255
2256
        if ( true !== $db )
2257
            $table_operation = false;
2258
2259
        $tableless_field_types = PodsForm::tableless_field_types();
2260
        $simple_tableless_objects = PodsForm::simple_tableless_objects();
2261
2262
        $params = (object) $params;
2263
2264
        if ( false === $sanitized )
2265
            $params = pods_sanitize( $params );
2266
2267
        if ( isset( $params->pod_id ) )
2268
            $params->pod_id = pods_absint( $params->pod_id );
2269
2270
        if ( true !== $db )
2271
            $params->pod_id = (int) $db;
2272
2273
        $pod = null;
2274
        $save_pod = false;
2275
        $id_required = false;
2276
2277
        if ( isset( $params->id_required ) ) {
2278
            unset( $params->id_required );
2279
2280
            $id_required = true;
2281
        }
2282
2283 View Code Duplication
        if ( ( !isset( $params->pod ) || empty( $params->pod ) ) && ( !isset( $params->pod_id ) || empty( $params->pod_id ) ) )
2284
            return pods_error( __( 'Pod ID or name is required', 'pods' ), $this );
2285
2286
        if ( isset( $params->pod ) && is_array( $params->pod ) ) {
2287
            $pod = $params->pod;
2288
2289
            $save_pod = true;
2290
        }
2291 View Code Duplication
        elseif ( ( !isset( $params->pod_id ) || empty( $params->pod_id ) ) && ( true === $db || 0 < $db ) )
2292
            $pod = $this->load_pod( array( 'name' => $params->pod, 'table_info' => true ) );
2293 View Code Duplication
        elseif ( !isset( $params->pod ) && ( true === $db || 0 < $db ) )
2294
            $pod = $this->load_pod( array( 'id' => $params->pod_id, 'table_info' => true ) );
2295 View Code Duplication
        elseif ( true === $db || 0 < $db )
2296
            $pod = $this->load_pod( array( 'id' => $params->pod_id, 'name' => $params->pod, 'table_info' => true ) );
2297
2298
        if ( empty( $pod ) && true === $db )
2299
            return pods_error( __( 'Pod not found', 'pods' ), $this );
2300
2301
        $params->pod_id = $pod[ 'id' ];
2302
        $params->pod = $pod[ 'name' ];
2303
        $params->pod_data = $pod;
2304
2305
        $params->name = pods_clean_name( $params->name, true, ( 'meta' == $pod[ 'storage' ] ? false : true ) );
2306
2307
        if ( !isset( $params->id ) )
2308
            $params->id = 0;
2309
2310
        if ( empty( $params->name ) )
2311
            return pods_error( 'Pod field name is required', $this );
2312
2313
        $field = $this->load_field( $params );
2314
2315
        unset( $params->pod_data );
2316
2317
        $old_id = $old_name = $old_type = $old_definition = $old_simple = $old_options = $old_sister_id = null;
2318
2319
        if ( !empty( $field ) ) {
2320
            $old_id = pods_var( 'id', $field );
2321
            $old_name = pods_clean_name( $field[ 'name' ], true, ( 'meta' == $pod[ 'storage' ] ? false : true ) );
2322
            $old_type = $field[ 'type' ];
2323
            $old_options = $field[ 'options' ];
2324
            $old_sister_id = (int) pods_var( 'sister_id', $old_options, 0 );
2325
2326
            $old_simple = ( 'pick' == $old_type && in_array( pods_var( 'pick_object', $field ), $simple_tableless_objects ) );
2327
2328
            if ( isset( $params->name ) && !empty( $params->name ) )
2329
                $field[ 'name' ] = $params->name;
2330
2331
            if ( $old_name != $field[ 'name' ] && false !== $this->field_exists( $params ) )
2332
                return pods_error( sprintf( __( 'Field %s already exists, you cannot rename %s to that', 'pods' ), $field[ 'name' ], $old_name ), $this );
2333
2334
            if ( ( $id_required || !empty( $params->id ) ) && ( empty( $old_id ) || $old_id != $params->id ) )
2335
                return pods_error( sprintf( __( 'Field %s already exists', 'pods' ), $field[ 'name' ] ), $this );
2336
2337
            if ( empty( $params->id ) )
2338
                $params->id = $old_id;
2339
2340
            if ( !in_array( $old_type, $tableless_field_types ) || $old_simple ) {
2341
                $definition = $this->get_field_definition( $old_type, array_merge( $field, $old_options ) );
2342
2343
                if ( 0 < strlen( $definition ) )
2344
                    $old_definition = "`{$old_name}` " . $definition;
2345
            }
2346
        }
2347
        else {
2348
            $field = array(
2349
                'id' => 0,
2350
                'pod_id' => $params->pod_id,
2351
                'name' => $params->name,
2352
                'label' => $params->name,
2353
                'description' => '',
2354
                'type' => 'text',
2355
                'pick_object' => '',
2356
                'pick_val' => '',
2357
                'sister_id' => '',
2358
                'weight' => null,
2359
                'options' => array()
2360
            );
2361
        }
2362
2363
        // Setup options
2364
        $options = get_object_vars( $params );
2365
2366
        $options_ignore = array(
2367
            'method',
2368
            'table_info',
2369
            'attributes',
2370
            'group',
2371
            'grouped',
2372
            'developer_mode',
2373
            'dependency',
2374
            'depends-on',
2375
            'excludes-on'
2376
        );
2377
2378
        foreach ( $options_ignore as $ignore ) {
2379
            if ( isset( $options[ $ignore ] ) )
2380
                unset( $options[ $ignore ] );
2381
        }
2382
2383
        if ( isset( $options[ 'method' ] ) )
2384
            unset( $options[ 'method' ] );
2385
        elseif ( isset( $options[ 'table_info' ] ) )
2386
            unset( $options[ 'table_info' ] );
2387
2388
        $exclude = array(
2389
            'id',
2390
            'pod_id',
2391
            'pod',
2392
            'name',
2393
            'label',
2394
            'description',
2395
            'type',
2396
            'pick_object',
2397
            'pick_val',
2398
            'sister_id',
2399
            'weight',
2400
            'options'
2401
        );
2402
2403 View Code Duplication
        foreach ( $exclude as $k => $exclude_field ) {
2404
            $aliases = array( $exclude_field );
2405
2406
            if ( is_array( $exclude_field ) ) {
2407
                $aliases = array_merge( array( $k ), $exclude_field );
2408
                $exclude_field = $k;
2409
            }
2410
2411
            foreach ( $aliases as $alias ) {
2412
                if ( isset( $options[ $alias ] ) ) {
2413
                    $field[ $exclude_field ] = pods_trim( $options[ $alias ] );
2414
2415
                    unset( $options[ $alias ] );
2416
                }
2417
            }
2418
        }
2419
2420
        if ( strlen( $field[ 'label' ] ) < 1 )
2421
            $field[ 'label' ] = $field[ 'name' ];
2422
2423
        $field[ 'options' ][ 'type' ] = $field[ 'type' ];
2424
2425
        if ( in_array( $field[ 'options' ][ 'type' ], $tableless_field_types ) ) {
2426
            // Clean up special drop-down in field editor and save out pick_val
2427
            $field[ 'pick_object' ] = pods_var( 'pick_object', $field, '', null, true );
2428
2429
            if ( 0 === strpos( $field[ 'pick_object' ], 'pod-' ) ) {
2430
                $field[ 'pick_val' ] = pods_str_replace( 'pod-', '', $field[ 'pick_object' ], 1 );
2431
                $field[ 'pick_object' ] = 'pod';
2432
            }
2433 View Code Duplication
            elseif ( 0 === strpos( $field[ 'pick_object' ], 'post_type-' ) ) {
2434
                $field[ 'pick_val' ] = pods_str_replace( 'post_type-', '', $field[ 'pick_object' ], 1 );
2435
                $field[ 'pick_object' ] = 'post_type';
2436
            }
2437 View Code Duplication
            elseif ( 0 === strpos( $field[ 'pick_object' ], 'taxonomy-' ) ) {
2438
                $field[ 'pick_val' ] = pods_str_replace( 'taxonomy-', '', $field[ 'pick_object' ], 1 );
2439
                $field[ 'pick_object' ] = 'taxonomy';
2440
            }
2441
            elseif ( 'table' == $field[ 'pick_object' ] && 0 < strlen( pods_var_raw( 'pick_table', $field[ 'options' ] ) ) ) {
2442
                $field[ 'pick_val' ] = $field[ 'options' ][ 'pick_table' ];
2443
                $field[ 'pick_object' ] = 'table';
2444
            }
2445
            elseif ( false === strpos( $field[ 'pick_object' ], '-' ) && !in_array( $field[ 'pick_object' ], array( 'pod', 'post_type', 'taxonomy' ) ) ) {
2446
                $field[ 'pick_val' ] = '';
2447
			}
2448
			elseif ( 'custom-simple' == $field[ 'pick_object' ] ) {
2449
                $field[ 'pick_val' ] = '';
2450
			}
2451
2452
            $field[ 'options' ][ 'pick_object' ] = $field[ 'pick_object' ];
2453
            $field[ 'options' ][ 'pick_val' ] = $field[ 'pick_val' ];
2454
            $field[ 'options' ][ 'sister_id' ] = pods_var( 'sister_id', $field );
2455
2456
            unset( $field[ 'pick_object' ] );
2457
            unset( $field[ 'pick_val' ] );
2458
2459
            if ( isset( $field[ 'sister_id' ] ) )
2460
                unset( $field[ 'sister_id' ] );
2461
        }
2462
2463
        $field[ 'options' ] = array_merge( $field[ 'options' ], $options );
2464
2465
        $object_fields = (array) pods_var_raw( 'object_fields', $pod, array(), null, true );
2466
2467
        if ( 0 < $old_id && defined( 'PODS_FIELD_STRICT' ) && !PODS_FIELD_STRICT )
2468
            $params->id = $field[ 'id' ] = $old_id;
2469
2470
        // Add new field
2471
        if ( !isset( $params->id ) || empty( $params->id ) || empty( $field ) ) {
2472
            if ( $table_operation && in_array( $field[ 'name' ], array( 'created', 'modified' ) ) && !in_array( $field[ 'type' ], array( 'date', 'datetime' ) ) && ( !defined( 'PODS_FIELD_STRICT' ) || PODS_FIELD_STRICT ) )
2473
                return pods_error( sprintf( __( '%s is reserved for internal Pods usage, please try a different name', 'pods' ), $field[ 'name' ] ), $this );
2474
2475
            if ( $table_operation && 'author' == $field[ 'name' ] && 'pick' != $field[ 'type' ] && ( !defined( 'PODS_FIELD_STRICT' ) || PODS_FIELD_STRICT ) )
2476
                return pods_error( sprintf( __( '%s is reserved for internal Pods usage, please try a different name', 'pods' ), $field[ 'name' ] ), $this );
2477
2478 View Code Duplication
            if ( in_array( $field[ 'name' ], array( 'id', 'ID' ) ) )
2479
                return pods_error( sprintf( __( '%s is reserved for internal Pods usage, please try a different name', 'pods' ), $field[ 'name' ] ), $this );
2480
2481
            foreach ( $object_fields as $object_field => $object_field_opt ) {
2482
                if ( $object_field == $field[ 'name' ] || in_array( $field[ 'name' ], $object_field_opt[ 'alias' ] ) )
2483
                    return pods_error( sprintf( __( '%s is reserved for internal WordPress or Pods usage, please try a different name. Also consider what WordPress and Pods provide you built-in.', 'pods' ), $field[ 'name' ] ), $this );
2484
            }
2485
2486
            if ( in_array( $field[ 'name' ], array( 'rss' ) ) ) // Reserved post_name values that can't be used as field names
2487
                $field[ 'name' ] .= '2';
2488
2489
            if ( 'slug' == $field[ 'type' ] && true === $db ) {
2490 View Code Duplication
                if ( in_array( $pod[ 'type' ], array( 'post_type', 'taxonomy', 'user' ) ) )
2491
                    return pods_error( __( 'This pod already has an internal WordPress permalink field', 'pods' ), $this );
2492
2493
                $slug_field = get_posts( array(
2494
                    'post_type' => '_pods_field',
2495
                    'orderby' => 'menu_order',
2496
                    'order' => 'ASC',
2497
                    'posts_per_page' => 1,
2498
                    'post_parent' => $field[ 'pod_id' ],
2499
                    'meta_query' => array(
2500
                        array(
2501
                            'key' => 'type',
2502
                            'value' => 'slug'
2503
                        )
2504
                    )
2505
                ) );
2506
2507
                if ( !empty( $slug_field ) )
2508
                    return pods_error( __( 'This pod already has a permalink field', 'pods' ), $this );
2509
            }
2510
2511
            // Sink the new field to the bottom of the list
2512
            if ( null === $field[ 'weight' ] ) {
2513
                $field[ 'weight' ] = 0;
2514
2515
                $bottom_most_field = get_posts( array(
2516
                    'post_type' => '_pods_field',
2517
                    'orderby' => 'menu_order',
2518
                    'order' => 'DESC',
2519
                    'posts_per_page' => 1,
2520
                    'post_parent' => $field[ 'pod_id' ]
2521
                ) );
2522
2523
                if ( !empty( $bottom_most_field ) )
2524
                    $field[ 'weight' ] = pods_absint( $bottom_most_field[ 0 ]->menu_order ) + 1;
2525
            }
2526
2527
            $field[ 'weight' ] = pods_absint( $field[ 'weight' ] );
2528
2529
            $post_data = array(
2530
                'post_name' => $field[ 'name' ],
2531
                'post_title' => $field[ 'label' ],
2532
                'post_content' => $field[ 'description' ],
2533
                'post_type' => '_pods_field',
2534
                'post_parent' => $field[ 'pod_id' ],
2535
                'post_status' => 'publish',
2536
                'menu_order' => $field[ 'weight' ]
2537
            );
2538
        }
2539
        else {
2540
            if ( in_array( $field[ 'name' ], array( 'id', 'ID' ) ) ) {
2541 View Code Duplication
                if ( null !== $old_name )
2542
                    return pods_error( sprintf( __( '%s is reserved for internal Pods usage, please try a different name', 'pods' ), $field[ 'name' ] ), $this );
2543
                else
2544
                    return pods_error( sprintf( __( '%s is not editable', 'pods' ), $field[ 'name' ] ), $this );
2545
            }
2546
2547
            if ( null !== $old_name && $field[ 'name' ] != $old_name && in_array( $field[ 'name' ], array( 'created', 'modified' ) ) && !in_array( $field[ 'type' ], array( 'date', 'datetime' ) ) && ( !defined( 'PODS_FIELD_STRICT' ) || PODS_FIELD_STRICT ) )
2548
                return pods_error( sprintf( __( '%s is reserved for internal Pods usage, please try a different name', 'pods' ), $field[ 'name' ] ), $this );
2549
2550
            if ( null !== $old_name && $field[ 'name' ] != $old_name && 'author' == $field[ 'name' ] && 'pick' != $field[ 'type' ] && ( !defined( 'PODS_FIELD_STRICT' ) || PODS_FIELD_STRICT ) )
2551
                return pods_error( sprintf( __( '%s is reserved for internal Pods usage, please try a different name', 'pods' ), $field[ 'name' ] ), $this );
2552
2553
            foreach ( $object_fields as $object_field => $object_field_opt ) {
2554
                if ( $object_field != $field[ 'name' ] && !in_array( $field[ 'name' ], $object_field_opt[ 'alias' ] ) )
2555
                    continue;
2556
2557 View Code Duplication
                if ( null !== $old_name )
2558
                    return pods_error( sprintf( __( '%s is reserved for internal WordPress or Pods usage, please try a different name', 'pods' ), $field[ 'name' ] ), $this );
2559
                else
2560
                    return pods_error( sprintf( __( '%s is not editable', 'pods' ), $field[ 'name' ] ), $this );
2561
            }
2562
2563
            $post_data = array(
2564
                'ID' => $field[ 'id' ],
2565
                'post_name' => $field[ 'name' ],
2566
                'post_title' => $field[ 'label' ],
2567
                'post_content' => $field[ 'description' ]
2568
            );
2569
2570
            if ( null !== $field[ 'weight' ] ) {
2571
                $field[ 'weight' ] = pods_absint( $field[ 'weight' ] );
2572
2573
                $post_data[ 'menu_order' ] = $field[ 'weight' ];
2574
            }
2575
        }
2576
2577
        if ( true === $db ) {
2578
            if ( !has_filter( 'wp_unique_post_slug', array( $this, 'save_slug_fix' ) ) )
2579
                add_filter( 'wp_unique_post_slug', array( $this, 'save_slug_fix' ), 100, 6 );
2580
2581
            $conflicted = false;
2582
2583
            // Headway compatibility fix
2584
            if ( has_filter( 'wp_insert_post_data', 'headway_clean_slug', 0 ) ) {
2585
                remove_filter( 'wp_insert_post_data', 'headway_clean_slug', 0 );
2586
2587
                $conflicted = true;
2588
            }
2589
2590
            // Store the old field name
2591
            if ( $old_name && $old_name != $post_data['post_name'] ) {
0 ignored issues
show
Bug Best Practice introduced by
The expression $old_name of type string|null is loosely compared to true; this is ambiguous if the string can be empty. You might want to explicitly use !== null instead.

In PHP, under loose comparison (like ==, or !=, or switch conditions), values of different types might be equal.

For string values, the empty string '' is a special case, in particular the following results might be unexpected:

''   == false // true
''   == null  // true
'ab' == false // false
'ab' == null  // false

// It is often better to use strict comparison
'' === false // false
'' === null  // false
Loading history...
2592
	            $field['options']['old_name'] = $old_name;
2593
            }
2594
2595
            $params->id = $this->save_wp_object( 'post', $post_data, $field[ 'options' ], true, true );
2596
2597
            if ( $conflicted )
2598
                add_filter( 'wp_insert_post_data', 'headway_clean_slug', 0 );
2599
2600
            if ( false === $params->id )
2601
                return pods_error( __( 'Cannot save Field', 'pods' ), $this );
2602
        }
2603
        else
2604
            $params->id = $field[ 'name' ];
2605
2606
        $field[ 'id' ] = $params->id;
2607
2608
        $simple = ( 'pick' == $field[ 'type' ] && in_array( pods_var( 'pick_object', $field[ 'options' ] ), $simple_tableless_objects ) );
2609
2610
        $definition = false;
2611
2612
        if ( !in_array( $field[ 'type' ], $tableless_field_types ) || $simple ) {
2613
            $field_definition = $this->get_field_definition( $field[ 'type' ], array_merge( $field, $field[ 'options' ] ) );
2614
2615
            if ( 0 < strlen( $field_definition ) )
2616
                $definition = '`' . $field[ 'name' ] . '` ' . $field_definition;
2617
        }
2618
2619
        $sister_id = (int) pods_var( 'sister_id', $field[ 'options' ], 0 );
2620
2621
        if ( $table_operation && 'table' == $pod[ 'storage' ] && !pods_tableless() ) {
2622
            if ( !empty( $old_id ) ) {
2623
                if ( ( $field[ 'type' ] != $old_type || $old_simple != $simple ) && empty( $definition ) )
2624
                    pods_query( "ALTER TABLE `@wp_pods_{$params->pod}` DROP COLUMN `{$old_name}`", false );
2625
                elseif ( 0 < strlen( $definition ) ) {
2626
                    if ( $old_name != $field[ 'name' ] || $old_simple != $simple ) {
2627
                        $test = false;
2628
2629 View Code Duplication
                        if ( 0 < strlen( $old_definition ) )
2630
                            $test = pods_query( "ALTER TABLE `@wp_pods_{$params->pod}` CHANGE `{$old_name}` {$definition}", false );
2631
2632
                        // If the old field doesn't exist, continue to add a new field
2633
                        if ( false === $test )
2634
                            pods_query( "ALTER TABLE `@wp_pods_{$params->pod}` ADD COLUMN {$definition}", __( 'Cannot create new field', 'pods' ) );
2635
                    }
2636
                    elseif ( null !== $old_definition && $definition != $old_definition ) {
2637
                        $test = pods_query( "ALTER TABLE `@wp_pods_{$params->pod}` CHANGE `{$old_name}` {$definition}", false );
2638
2639
                        // If the old field doesn't exist, continue to add a new field
2640
                        if ( false === $test )
2641
                            pods_query( "ALTER TABLE `@wp_pods_{$params->pod}` ADD COLUMN {$definition}", __( 'Cannot create new field', 'pods' ) );
2642
                    }
2643
                }
2644
            }
2645
            elseif ( 0 < strlen( $definition ) ) {
2646
                $test = false;
2647
2648 View Code Duplication
                if ( 0 < strlen( $old_definition ) )
2649
                    $test = pods_query( "ALTER TABLE `@wp_pods_{$params->pod}` CHANGE `" . $field[ 'name' ] . "` {$definition}", false );
2650
2651
                // If the old field doesn't exist, continue to add a new field
2652
                if ( false === $test )
2653
                    pods_query( "ALTER TABLE `@wp_pods_{$params->pod}` ADD COLUMN {$definition}", __( 'Cannot create new field', 'pods' ) );
2654
            }
2655
        }
2656
2657
        if ( !empty( $old_id ) && 'meta' == $pod[ 'storage' ] && $old_name != $field[ 'name' ] && $pod[ 'meta_table' ] != $pod[ 'table' ] ) {
2658
            $prepare = array(
2659
                $field[ 'name' ],
2660
                $old_name
2661
            );
2662
2663
            // Users don't have a type
2664
            if ( !empty( $pod[ 'field_type' ] ) )
2665
                $prepare[] = $pod[ 'name' ];
2666
2667
            pods_query( "
2668
                UPDATE `{$pod[ 'meta_table' ]}` AS `m`
2669
                LEFT JOIN `{$pod[ 'table' ]}` AS `t`
2670
                    ON `t`.`{$pod[ 'field_id' ]}` = `m`.`{$pod[ 'meta_field_id' ]}`
2671
                SET
2672
                    `m`.`{$pod[ 'meta_field_index' ]}` = %s
2673
                WHERE
2674
                    `m`.`{$pod[ 'meta_field_index' ]}` = %s
2675
            " . ( !empty( $pod[ 'field_type' ] ) ? " AND `t`.`{$pod[ 'field_type' ]}` = %s" : "" ),
2676
                $prepare
2677
            );
2678
        }
2679
2680
        if ( $field[ 'type' ] != $old_type && in_array( $old_type, $tableless_field_types ) ) {
2681
            delete_post_meta( $old_sister_id, 'sister_id' );
2682
2683
            if ( true === $db ) {
2684
                pods_query( "
2685
                        DELETE pm
2686
                        FROM {$wpdb->postmeta} AS pm
2687
                        LEFT JOIN {$wpdb->posts} AS p
2688
                            ON p.post_type = '_pods_field'
2689
                            AND p.ID = pm.post_id
2690
                        WHERE
2691
                            p.ID IS NOT NULL
2692
                            AND pm.meta_key = 'sister_id'
2693
                            AND pm.meta_value = %d
2694
                    ", array(
2695
                        $params->id
2696
                    )
2697
                );
2698
2699
                if ( !pods_tableless() ) {
2700
                    pods_query( "DELETE FROM @wp_podsrel WHERE `field_id` = {$params->id}", false );
2701
2702
                    pods_query( "
2703
                            UPDATE `@wp_podsrel`
2704
                            SET `related_field_id` = 0
2705
                            WHERE `field_id` = %d
2706
                        ", array(
2707
                            $old_sister_id
2708
                        )
2709
                    );
2710
                }
2711
            }
2712
        }
2713 View Code Duplication
        elseif ( 0 < $sister_id ) {
2714
            update_post_meta( $sister_id, 'sister_id', $params->id );
2715
2716
            if ( true === $db && ( !pods_tableless() ) ) {
2717
                pods_query( "
2718
                        UPDATE `@wp_podsrel`
2719
                        SET `related_field_id` = %d
2720
                        WHERE `field_id` = %d
2721
                    ",
2722
                    array(
2723
                        $params->id,
2724
                        $sister_id
2725
                    )
2726
                );
2727
            }
2728
        }
2729 View Code Duplication
        elseif ( 0 < $old_sister_id ) {
2730
            delete_post_meta( $old_sister_id, 'sister_id' );
2731
2732
            if ( true === $db && ( !pods_tableless() ) ) {
2733
                pods_query( "
2734
                        UPDATE `@wp_podsrel`
2735
                        SET `related_field_id` = 0
2736
                        WHERE `field_id` = %d
2737
                    ", array(
2738
                        $old_sister_id
2739
                    )
2740
                );
2741
            }
2742
        }
2743
2744
        if ( !empty( $old_id ) && $old_name != $field[ 'name' ] && true === $db ) {
2745
            pods_query( "
2746
                    UPDATE `@wp_postmeta`
2747
                    SET `meta_value` = %s
2748
                    WHERE
2749
                        `post_id` = %d
2750
                        AND `meta_key` = 'pod_index'
2751
                        AND `meta_value` = %s
2752
                ", array(
2753
                    $field[ 'name' ],
2754
                    $pod[ 'id' ],
2755
                    $old_name
2756
                )
2757
            );
2758
        }
2759
2760
        if ( !$save_pod )
2761
            $this->cache_flush_pods( $pod );
2762
        else {
2763
            pods_transient_clear( 'pods_field_' . $pod[ 'name' ] . '_' . $field[ 'name' ] );
2764
2765
            if ( !empty( $old_id ) && $old_name != $field[ 'name' ] )
2766
                pods_transient_clear( 'pods_field_' . $pod[ 'name' ] . '_' . $old_name );
2767
        }
2768
2769
        if ( true === $db )
2770
            return $params->id;
2771
        else
2772
            return $field;
2773
    }
2774
2775
    /**
2776
     * Fix Pod / Field post_name to ensure they are exactly as saved (allow multiple posts w/ same post_name)
2777
     *
2778
     * @param string $slug Unique slug value
2779
     * @param int $post_ID Post ID
2780
     * @param string $post_status Post Status
2781
     * @param string $post_type Post Type
2782
     * @param int $post_parent Post Parent ID
2783
     * @param string $original_slug Original slug value
2784
     *
2785
     * @return string Final slug value
2786
     *
2787
     * @since 2.3.3
2788
     */
2789
    public function save_slug_fix ( $slug, $post_ID, $post_status, $post_type, $post_parent = 0, $original_slug = null ) {
2790
        if ( in_array( $post_type, array( '_pods_field', '_pods_pod' ) ) && false !== strpos( $slug, '-' ) )
2791
            $slug = $original_slug;
2792
2793
        return $slug;
2794
    }
2795
2796
    /**
2797
     * Add or Edit a Pods Object
2798
     *
2799
     * $params['id'] int The Object ID
2800
     * $params['name'] string The Object name
2801
     * $params['type'] string The Object type
2802
     * $params['options'] Associative array of Object options
2803
     *
2804
     * @param array|object $params An associative array of parameters
2805
     * @param bool $sanitized (optional) Decides whether the params have been sanitized before being passed, will sanitize them if false.
2806
     *
2807
     * @return int The Object ID
2808
     * @since 2.0
2809
     */
2810
    public function save_object ( $params, $sanitized = false ) {
2811
        $params = (object) $params;
2812
2813
        if ( false === $sanitized )
2814
            $params = pods_sanitize( $params );
2815
2816 View Code Duplication
        if ( !isset( $params->name ) || empty( $params->name ) )
2817
            return pods_error( __( 'Name must be given to save an Object', 'pods' ), $this );
2818
2819 View Code Duplication
        if ( !isset( $params->type ) || empty( $params->type ) )
2820
            return pods_error( __( 'Type must be given to save an Object', 'pods' ), $this );
2821
2822
        $object = array(
2823
            'id' => 0,
2824
            'name' => $params->name,
2825
            'type' => $params->type,
2826
            'code' => '',
2827
            'options' => array()
2828
        );
2829
2830
        // Setup options
2831
        $options = get_object_vars( $params );
2832
2833
        if ( isset( $options[ 'method' ] ) )
2834
            unset( $options[ 'method' ] );
2835
2836
        $exclude = array(
2837
            'id',
2838
            'name',
2839
            'helper_type',
2840
            'code',
2841
            'options',
2842
            'status'
2843
        );
2844
2845 View Code Duplication
        foreach ( $exclude as $k => $exclude_field ) {
2846
            $aliases = array( $exclude_field );
2847
2848
            if ( is_array( $exclude_field ) ) {
2849
                $aliases = array_merge( array( $k ), $exclude_field );
2850
                $exclude_field = $k;
2851
            }
2852
2853
            foreach ( $aliases as $alias ) {
2854
                if ( isset( $options[ $alias ] ) ) {
2855
                    $object[ $exclude_field ] = pods_trim( $options[ $alias ] );
2856
2857
                    unset( $options[ $alias ] );
2858
                }
2859
            }
2860
        }
2861
2862
        if ( 'helper' == $object[ 'type' ] )
2863
            $object[ 'options' ][ 'helper_type' ] = $object[ 'helper_type' ];
2864
2865
        if ( isset( $object[ 'options' ][ 'code' ] ) )
2866
            unset( $object[ 'options' ][ 'code' ] );
2867
2868
        $object[ 'options' ] = array_merge( $object[ 'options' ], $options );
2869
2870
        $post_data = array(
2871
            'post_name' => pods_clean_name( $object[ 'name' ], true),
2872
            'post_title' => $object[ 'name' ],
2873
            'post_content' => $object[ 'code' ],
2874
            'post_type' => '_pods_' . $object[ 'type' ],
2875
            'post_status' => 'publish'
2876
        );
2877
2878
        if ( !empty( $object[ 'id' ] ) )
2879
            $post_data[ 'ID' ] = $object[ 'id' ];
2880
2881
        if ( null !== pods_var( 'status', $object, null, null, true ) )
2882
            $post_data[ 'post_status' ] = pods_var( 'status', $object, null, null, true );
2883
2884
        remove_filter( 'content_save_pre', 'balanceTags', 50 );
2885
2886
        $post_data = pods_sanitize( $post_data );
2887
2888
        $params->id = $this->save_post( $post_data, $object[ 'options' ], true, true );
2889
2890
        pods_transient_clear( 'pods_objects_' . $params->type );
2891
        pods_transient_clear( 'pods_objects_' . $params->type . '_get' );
2892
2893
        return $params->id;
2894
    }
2895
2896
    /**
2897
     * @see PodsAPI::save_object
2898
     *
2899
     * Add or edit a Pod Template
2900
     *
2901
     * $params['id'] int The template ID
2902
     * $params['name'] string The template name
2903
     * $params['code'] string The template code
2904
     *
2905
     * @param array|object $params An associative array of parameters
2906
     * @param bool $sanitized  (optional) Decides wether the params have been sanitized before being passed, will sanitize them if false.
2907
     *
2908
     * @return int The Template ID
2909
     *
2910
     * @since 1.7.9
2911
     */
2912
    public function save_template ( $params, $sanitized = false ) {
2913
        $params = (object) $params;
2914
2915
        $params->type = 'template';
2916
2917
        return $this->save_object( $params, $sanitized );
2918
    }
2919
2920
    /**
2921
     * @see PodsAPI::save_object
2922
     *
2923
     * Add or edit a Pod Page
2924
     *
2925
     * $params['id'] int The page ID
2926
     * $params['name'] string The page URI
2927
     * $params['code'] string The page code
2928
     *
2929
     * @param array|object $params An associative array of parameters
2930
     * @param bool $sanitized  (optional) Decides wether the params have been sanitized before being passed, will sanitize them if false.
2931
     *
2932
     * @return int The page ID
2933
     * @since 1.7.9
2934
     */
2935
    public function save_page ( $params, $sanitized = false ) {
2936
        $params = (object) $params;
2937
2938
        if ( !isset( $params->name ) ) {
2939
            $params->name = $params->uri;
2940
            unset( $params->uri );
2941
        }
2942
2943
        if ( isset( $params->phpcode ) ) {
2944
            $params->code = $params->phpcode;
2945
            unset( $params->phpcode );
2946
        }
2947
2948
        $params->name = trim( $params->name, '/' );
2949
        $params->type = 'page';
2950
2951
        return $this->save_object( $params, $sanitized );
2952
    }
2953
2954
    /**
2955
     * @see PodsAPI::save_object
2956
     *
2957
     * Add or edit a Pod Helper
2958
     *
2959
     * $params['id'] int The helper ID
2960
     * $params['name'] string The helper name
2961
     * $params['helper_type'] string The helper type ("pre_save", "display", etc)
2962
     * $params['code'] string The helper code
2963
     *
2964
     * @param array $params An associative array of parameters
2965
     * @param bool $sanitized  (optional) Decides wether the params have been sanitized before being passed, will sanitize them if false.
2966
     *
2967
     * @return int The helper ID
2968
     * @since 1.7.9
2969
     */
2970
    public function save_helper ( $params, $sanitized = false ) {
2971
        $params = (object) $params;
2972
2973
        if ( isset( $params->phpcode ) ) {
2974
            $params->code = $params->phpcode;
2975
            unset( $params->phpcode );
2976
        }
2977
2978
        if ( isset( $params->type ) ) {
2979
            $params->helper_type = $params->type;
2980
            unset( $params->type );
2981
        }
2982
2983
        $params->type = 'helper';
2984
2985
        return $this->save_object( $params, $sanitized );
2986
    }
2987
2988
    /**
2989
     * Add or edit a single pod item
2990
     *
2991
     * $params['pod'] string The Pod name (pod or pod_id is required)
2992
     * $params['pod_id'] string The Pod ID (pod or pod_id is required)
2993
     * $params['id'] int|array The item ID, or an array of item IDs to save data for
2994
     * $params['data'] array (optional) Associative array of field names + values
2995
     * $params['bypass_helpers'] bool Set to true to bypass running pre-save and post-save helpers
2996
	 * $params['track_changed_fields'] bool Set to true to enable tracking of saved fields via PodsAPI::get_changed_fields()
2997
	 * $params['error_mode'] string Throw an 'exception', 'exit' with the message, return 'false', or return 'wp_error'
2998
     *
2999
     * @param array|object $params An associative array of parameters
3000
     *
3001
     * @return int|array The item ID, or an array of item IDs (if `id` is an array if IDs)
3002
     *
3003
     * @since 1.7.9
3004
     */
3005
    public function save_pod_item ( $params ) {
3006
3007
		global $wpdb;
0 ignored issues
show
Compatibility Best Practice introduced by
Use of global functionality is not recommended; it makes your code harder to test, and less reusable.

Instead of relying on global state, we recommend one of these alternatives:

1. Pass all data via parameters

function myFunction($a, $b) {
    // Do something
}

2. Create a class that maintains your state

class MyClass {
    private $a;
    private $b;

    public function __construct($a, $b) {
        $this->a = $a;
        $this->b = $b;
    }

    public function myFunction() {
        // Do something
    }
}
Loading history...
3008
3009
        $params = (object) pods_str_replace( '@wp_', '{prefix}', $params );
3010
3011
        $tableless_field_types = PodsForm::tableless_field_types();
3012
        $repeatable_field_types = PodsForm::repeatable_field_types();
3013
        $simple_tableless_objects = PodsForm::simple_tableless_objects();
3014
3015
	    $error_mode = $this->display_errors;
3016
3017
	    if ( ! empty( $params->error_mode ) ) {
3018
		    $error_mode = $params->error_mode;
3019
	    }
3020
3021
        // @deprecated 2.0
3022
        if ( isset( $params->datatype ) ) {
3023
            pods_deprecated( '$params->pod instead of $params->datatype', '2.0' );
3024
3025
            $params->pod = $params->datatype;
3026
3027
            unset( $params->datatype );
3028
3029
            if ( isset( $params->pod_id ) ) {
3030
                pods_deprecated( '$params->id instead of $params->pod_id', '2.0' );
3031
3032
                $params->id = $params->pod_id;
3033
3034
                unset( $params->pod_id );
3035
            }
3036
3037
            if ( isset( $params->data ) && !empty( $params->data ) && is_array( $params->data ) ) {
3038
                $check = current( $params->data );
3039
3040
                if ( is_array( $check ) ) {
3041
                    pods_deprecated( 'PodsAPI::save_pod_items', '2.0' );
3042
3043
                    return $this->save_pod_items( $params, $params->data );
3044
                }
3045
            }
3046
        }
3047
3048
        // @deprecated 2.0
3049
        if ( isset( $params->tbl_row_id ) ) {
3050
            pods_deprecated( '$params->id instead of $params->tbl_row_id', '2.0' );
3051
3052
            $params->id = $params->tbl_row_id;
3053
3054
            unset( $params->tbl_row_id );
3055
        }
3056
3057
        // @deprecated 2.0
3058
        if ( isset( $params->columns ) ) {
3059
            pods_deprecated( '$params->data instead of $params->columns', '2.0' );
3060
3061
            $params->data = $params->columns;
3062
3063
            unset( $params->columns );
3064
        }
3065
3066
        if ( !isset( $params->pod ) )
3067
            $params->pod = false;
3068 View Code Duplication
        if ( isset( $params->pod_id ) )
3069
            $params->pod_id = pods_absint( $params->pod_id );
3070
        else
3071
            $params->pod_id = 0;
3072
3073 View Code Duplication
        if ( isset( $params->id ) )
3074
            $params->id = pods_absint( $params->id );
3075
        else
3076
            $params->id = 0;
3077
3078
        if ( !isset( $params->from ) )
3079
            $params->from = 'save';
3080
3081
        if ( !isset( $params->location ) )
3082
            $params->location = null;
3083
3084
        if ( !isset( $params->track_changed_fields ) )
3085
            $params->track_changed_fields = false;
3086
3087
		/**
3088
		 * Override $params['track_changed_fields']
3089
		 *
3090
		 * Use for globally setting field change tracking.
3091
		 *
3092
		 * @param bool
3093
		 *
3094
		 * @since 2.3.19
3095
		 */
3096
		$track_changed_fields = apply_filters( 'pods_api_save_pod_item_track_changed_fields_' . $params->pod, (boolean) $params->track_changed_fields, $params );
3097
3098
		$changed_fields = array();
3099
3100
		if ( !isset( $params->clear_slug_cache ) ) {
3101
			$params->clear_slug_cache = true;
3102
		}
3103
3104
        // Support for bulk edit
3105
        if ( isset( $params->id ) && !empty( $params->id ) && is_array( $params->id ) ) {
3106
            $ids = array();
3107
            $new_params = $params;
3108
3109
            foreach ( $params->id as $id ) {
3110
                $new_params->id = $id;
3111
3112
                $ids[] = $this->save_pod_item( $new_params );
3113
            }
3114
3115
            return $ids;
3116
        }
3117
3118
        // Allow Helpers to know what's going on, are we adding or saving?
3119
        $is_new_item = false;
3120
3121
        if ( empty( $params->id ) )
3122
            $is_new_item = true;
3123
3124
        if ( isset( $params->is_new_item ) )
3125
            $is_new_item = (boolean) $params->is_new_item;
3126
3127
        // Allow Helpers to bypass subsequent helpers in recursive save_pod_item calls
3128
        $bypass_helpers = false;
3129
3130
        if ( isset( $params->bypass_helpers ) && false !== $params->bypass_helpers )
3131
            $bypass_helpers = true;
3132
3133
        // Allow Custom Fields not defined by Pods to be saved
3134
        $allow_custom_fields = false;
3135
3136
        if ( isset( $params->allow_custom_fields ) && false !== $params->allow_custom_fields )
3137
            $allow_custom_fields = true;
3138
3139
        // Get array of Pods
3140
        $pod = $this->load_pod( array( 'id' => $params->pod_id, 'name' => $params->pod, 'table_info' => true ) );
3141
3142
        if ( false === $pod )
3143
            return pods_error( __( 'Pod not found', 'pods' ), $error_mode );
3144
3145
        $params->pod = $pod[ 'name' ];
3146
        $params->pod_id = $pod[ 'id' ];
3147
3148
        if ( 'settings' == $pod[ 'type' ] )
3149
            $params->id = $pod[ 'id' ];
3150
3151
        $fields = $pod[ 'fields' ];
3152
3153
        $object_fields = (array) pods_var_raw( 'object_fields', $pod, array(), null, true );
3154
3155
        $fields_active = array();
3156
        $custom_data = array();
3157
3158
        // Find the active fields (loop through $params->data to retain order)
3159
        if ( !empty( $params->data ) && is_array( $params->data ) ) {
3160
            $custom_fields = array();
3161
3162
            foreach ( $params->data as $field => $value ) {
3163
                if ( isset( $object_fields[ $field ] ) ) {
3164
                    $object_fields[ $field ][ 'value' ] = $value;
3165
                    $fields_active[] = $field;
3166
                }
3167
                elseif ( isset( $fields[ $field ] ) ) {
3168
                    if ( 'save' == $params->from || true === PodsForm::permission( $fields[ $field ][ 'type' ], $field, $fields[ $field ], $fields, $pod, $params->id, $params ) ) {
3169
                        $fields[ $field ][ 'value' ] = $value;
3170
                        $fields_active[] = $field;
3171
                    }
3172
                    elseif ( !pods_has_permissions( $fields[ $field ][ 'options' ] ) && pods_var( 'hidden', $fields[ $field ][ 'options' ], false ) ) {
3173
                        $fields[ $field ][ 'value' ] = $value;
3174
                        $fields_active[] = $field;
3175
                    }
3176
                }
3177
                else {
3178
                    $found = false;
3179
3180
                    foreach ( $object_fields as $object_field => $object_field_opt ) {
3181
                        if ( in_array( $field, $object_field_opt[ 'alias' ] ) ) {
3182
                            $object_fields[ $object_field ][ 'value' ] = $value;
3183
                            $fields_active[] = $object_field;
3184
3185
                            $found = true;
3186
3187
                            break;
3188
                        }
3189
                    }
3190
3191
                    if ( $allow_custom_fields && !$found )
3192
                        $custom_fields[] = $field;
3193
                }
3194
            }
3195
3196
            if ( $allow_custom_fields && !empty( $custom_fields ) ) {
3197
                foreach ( $custom_fields as $field ) {
3198
                    $custom_data[ $field ] = $params->data[ $field ];
3199
                }
3200
            }
3201
3202
           unset( $params->data );
3203
        }
3204
3205 View Code Duplication
		if ( empty( $params->id ) && !in_array( 'created', $fields_active ) && isset( $fields[ 'created' ] ) && in_array( $fields[ 'created' ][ 'type' ], array( 'date', 'datetime' ) ) ) {
3206
			$fields[ 'created' ][ 'value' ] = current_time( 'mysql' );
3207
			$fields_active[] = 'created';
3208
		}
3209
3210 View Code Duplication
		if ( !in_array( 'modified', $fields_active ) && isset( $fields[ 'modified' ] ) && in_array( $fields[ 'modified' ][ 'type' ], array( 'date', 'datetime' ) ) ) {
3211
			$fields[ 'modified' ][ 'value' ] = current_time( 'mysql' );
3212
			$fields_active[] = 'modified';
3213
		}
3214
3215
        if ( in_array( $pod[ 'type' ], array( 'pod', 'table' ) ) && empty( $params->id ) && !empty( $pod[ 'pod_field_index' ] ) && in_array( $pod[ 'pod_field_index' ], $fields_active ) && !in_array( $pod[ 'pod_field_slug' ], $fields_active ) && isset( $fields[ $pod[ 'pod_field_slug' ] ] ) ) {
3216
			$fields[ $pod[ 'pod_field_slug' ] ][ 'value' ] = ''; // this will get picked up by slug pre_save method
3217
			$fields_active[] = $pod[ 'pod_field_slug' ];
3218
        }
3219
3220
        // Handle hidden fields
3221
        if ( empty( $params->id ) ) {
3222
            foreach ( $fields as $field => $field_data ) {
3223
                if ( in_array( $field, $fields_active ) )
3224
                    continue;
3225
3226
                if ( in_array( $params->from, array( 'save', 'process_form' ) ) || true === PodsForm::permission( $fields[ $field ][ 'type' ], $field, $fields[ $field ], $fields, $pod, $params->id, $params ) ) {
3227
                    $value = PodsForm::default_value( pods_var_raw( $field, 'post' ), $field_data[ 'type' ], $field, pods_var_raw( 'options', $field_data, $field_data, null, true ), $pod, $params->id );
3228
3229
                    if ( null !== $value && '' !== $value && false !== $value ) {
3230
                        $fields[ $field ][ 'value' ] = $value;
3231
                        $fields_active[] = $field;
3232
                    }
3233
                }
3234
            }
3235
3236
			// Set default field values for object fields
3237
			if ( !empty( $object_fields ) ) {
3238 View Code Duplication
				foreach ( $object_fields as $field => $field_data ) {
3239
					if ( in_array( $field, $fields_active ) ) {
3240
						continue;
3241
					}
3242
					elseif ( !isset( $field_data[ 'default' ] ) || strlen( $field_data[ 'default' ] ) < 1 ) {
3243
						continue;
3244
					}
3245
3246
                    $value = PodsForm::default_value( pods_var_raw( $field, 'post' ), $field_data[ 'type' ], $field, pods_var_raw( 'options', $field_data, $field_data, null, true ), $pod, $params->id );
3247
3248
                    if ( null !== $value && '' !== $value && false !== $value ) {
3249
                        $object_fields[ $field ][ 'value' ] = $value;
3250
                        $fields_active[] = $field;
3251
                    }
3252
				}
3253
			}
3254
3255
			// Set default field values for Pod fields
3256 View Code Duplication
			foreach ( $fields as $field => $field_data ) {
3257
				if ( in_array( $field, $fields_active ) ) {
3258
					continue;
3259
				}
3260
				elseif ( !isset( $field_data[ 'default' ] ) || strlen( $field_data[ 'default' ] ) < 1 ) {
3261
					continue;
3262
				}
3263
3264
				$value = PodsForm::default_value( pods_var_raw( $field, 'post' ), $field_data[ 'type' ], $field, pods_var_raw( 'options', $field_data, $field_data, null, true ), $pod, $params->id );
3265
3266
				if ( null !== $value && '' !== $value && false !== $value ) {
3267
					$fields[ $field ][ 'value' ] = $value;
3268
					$fields_active[] = $field;
3269
				}
3270
			}
3271
        }
3272
3273
        $columns =& $fields; // @deprecated 2.0
3274
        $active_columns =& $fields_active; // @deprecated 2.0
3275
        $params->tbl_row_id =& $params->id; // @deprecated 2.0
3276
3277
        $pre_save_helpers = $post_save_helpers = array();
3278
3279
		$pieces = array(
3280
			'fields',
3281
			'params',
3282
			'pod',
3283
			'fields_active',
3284
			'object_fields',
3285
			'custom_fields',
3286
			'custom_data',
3287
			'track_changed_fields',
3288
			'changed_fields'
3289
		);
3290
3291
        if ( false === $bypass_helpers ) {
3292
            // Plugin hooks
3293
            $hooked = $this->do_hook( 'pre_save_pod_item', compact( $pieces ), $is_new_item, $params->id );
3294
3295
            if ( is_array( $hooked ) && !empty( $hooked ) )
3296
                extract( $hooked );
3297
3298
            $hooked = $this->do_hook( "pre_save_pod_item_{$params->pod}", compact( $pieces ), $is_new_item, $params->id );
3299
3300
            if ( is_array( $hooked ) && !empty( $hooked ) )
3301
                extract( $hooked );
3302
3303
            if ( $is_new_item ) {
3304
                $hooked = $this->do_hook( 'pre_create_pod_item', compact( $pieces ) );
3305
3306
                if ( is_array( $hooked ) && !empty( $hooked ) )
3307
                    extract( $hooked );
3308
3309
                $hooked = $this->do_hook( "pre_create_pod_item_{$params->pod}", compact( $pieces ) );
3310
3311
                if ( is_array( $hooked ) && !empty( $hooked ) )
3312
                    extract( $hooked );
3313
            }
3314
            else {
3315
                $hooked = $this->do_hook( 'pre_edit_pod_item', compact( $pieces ), $params->id );
3316
3317
                if ( is_array( $hooked ) && !empty( $hooked ) )
3318
                    extract( $hooked );
3319
3320
                $hooked = $this->do_hook( "pre_edit_pod_item_{$params->pod}", compact( $pieces ), $params->id );
3321
3322
                if ( is_array( $hooked ) && !empty( $hooked ) )
3323
                    extract( $hooked );
3324
            }
3325
3326
            // Call any pre-save helpers (if not bypassed)
3327 View Code Duplication
            if ( !defined( 'PODS_DISABLE_EVAL' ) || !PODS_DISABLE_EVAL ) {
3328
                if ( !empty( $pod[ 'options' ] ) && is_array( $pod[ 'options' ] ) ) {
3329
                    $helpers = array( 'pre_save_helpers', 'post_save_helpers' );
3330
3331
                    foreach ( $helpers as $helper ) {
3332
                        if ( isset( $pod[ 'options' ][ $helper ] ) && !empty( $pod[ 'options' ][ $helper ] ) )
0 ignored issues
show
Unused Code introduced by
This if statement is empty and can be removed.

This check looks for the bodies of if statements that have no statements or where all statements have been commented out. This may be the result of changes for debugging or the code may simply be obsolete.

These if bodies can be removed. If you have an empty if but statements in the else branch, consider inverting the condition.

if (rand(1, 6) > 3) {
//print "Check failed";
} else {
    print "Check succeeded";
}

could be turned into

if (rand(1, 6) <= 3) {
    print "Check succeeded";
}

This is much more concise to read.

Loading history...
3333
                            ${$helper} = explode( ',', $pod[ 'options' ][ $helper ] );
3334
                    }
3335
                }
3336
3337
                if ( !empty( $pre_save_helpers ) ) {
3338
                    pods_deprecated( sprintf( __( 'Pre-save helpers are deprecated, use the action pods_pre_save_pod_item_%s instead', 'pods' ), $params->pod ), '2.0' );
3339
3340
                    foreach ( $pre_save_helpers as $helper ) {
3341
                        $helper = $this->load_helper( array( 'name' => $helper ) );
3342
3343
                        if ( false !== $helper )
3344
                            eval( '?>' . $helper[ 'code' ] );
0 ignored issues
show
Coding Style introduced by
It is generally not recommended to use eval unless absolutely required.

On one hand, eval might be exploited by malicious users if they somehow manage to inject dynamic content. On the other hand, with the emergence of faster PHP runtimes like the HHVM, eval prevents some optimization that they perform.

Loading history...
3345
                    }
3346
                }
3347
            }
3348
        }
3349
3350
		if ( $track_changed_fields ) {
3351
			$changed_fields = $this->get_changed_fields( compact( $pieces ) );
3352
		}
3353
3354
        $table_data = $table_formats = $update_values = $rel_fields = $rel_field_ids = array();
3355
3356
        $object_type = $pod[ 'type' ];
3357
3358
        $object_ID = 'ID';
3359
3360
        if ( 'comment' == $object_type )
3361
            $object_ID = 'comment_ID';
3362
        elseif ( 'taxonomy' == $object_type )
3363
            $object_ID = 'term_id';
3364
3365
        $object_data = $object_meta = $post_term_data = array();
3366
3367
        if ( 'settings' == $object_type )
3368
            $object_data[ 'option_id' ] = $pod[ 'name' ];
3369
        elseif ( !empty( $params->id ) )
3370
            $object_data[ $object_ID ] = $params->id;
3371
3372
        $fields_active = array_unique( $fields_active );
3373
3374
        // Loop through each active field, validating and preparing the table data
3375
        foreach ( $fields_active as $field ) {
3376 View Code Duplication
            if ( isset( $object_fields[ $field ] ) )
3377
                $field_data = $object_fields[ $field ];
3378
            elseif ( isset( $fields[ $field ] ) )
3379
                $field_data = $fields[ $field ];
3380
            else
3381
                continue;
3382
3383
            $value = $field_data[ 'value' ];
3384
            $type = $field_data[ 'type' ];
3385
            $options = pods_var( 'options', $field_data, array() );
3386
3387
            // WPML AJAX compatibility
3388
            if ( is_admin() && isset( $_GET[ 'page' ] ) && false !== strpos( $_GET[ 'page' ], '/menu/languages.php' ) && isset( $_POST[ 'icl_ajx_action' ] ) && isset( $_POST[ '_icl_nonce' ] ) && wp_verify_nonce( $_POST[ '_icl_nonce' ], $_POST[ 'icl_ajx_action' ] . '_nonce' ) )
3389
                $options[ 'unique' ] = $fields[ $field ][ 'options' ][ 'unique' ] = $options[ 'required' ] = $fields[ $field ][ 'options' ][ 'required' ] = 0;
3390
            else {
3391
                // Validate value
3392
                $validate = $this->handle_field_validation( $value, $field, $object_fields, $fields, $pod, $params );
3393
3394
                if ( false === $validate )
3395
                    $validate = sprintf( __( 'There was an issue validating the field %s', 'pods' ), $field_data[ 'label' ] );
3396
                elseif ( true !== $validate )
3397
                    $validate = (array) $validate;
3398
3399
                if ( !is_bool( $validate ) && !empty( $validate ) )
3400
                    return pods_error( $validate, $error_mode );
3401
            }
3402
3403
            $value = PodsForm::pre_save( $field_data[ 'type' ], $value, $params->id, $field, array_merge( $field_data, $options ), array_merge( $fields, $object_fields ), $pod, $params );
3404
3405
            $field_data[ 'value' ] = $value;
3406
3407
            if ( isset( $object_fields[ $field ] ) ) {
3408
				if ( 'taxonomy' == $object_fields[ $field ][ 'type' ] ) {
3409
					$post_term_data[ $field ] = $value;
3410
				}
3411
				else {
3412
                	$object_data[ $field ] = $value;
3413
				}
3414
			}
3415
            else {
3416
                $simple = ( 'pick' == $type && in_array( pods_var( 'pick_object', $field_data ), $simple_tableless_objects ) );
3417
                $simple = (boolean) $this->do_hook( 'tableless_custom', $simple, $field_data, $field, $fields, $pod, $params );
3418
3419
                // Handle Simple Relationships
3420
                if ( $simple ) {
3421
                    if ( !is_array( $value ) )
3422
                        $value = explode( ',', $value );
3423
3424
                    $pick_limit = (int) pods_var_raw( 'pick_limit', $options, 0 );
3425
3426
                    if ( 'single' == pods_var_raw( 'pick_format_type', $options ) )
3427
                        $pick_limit = 1;
3428
3429
                    if ( 'custom-simple' == pods_var( 'pick_object', $field_data ) ) {
3430
                        $custom = pods_var_raw( 'pick_custom', $options, '' );
3431
3432
                        $custom = apply_filters( 'pods_form_ui_field_pick_custom_values', $custom, $field_data[ 'name' ], $value, array_merge( $field_data, $options ), $pod, $params->id );
3433
3434
                        if ( empty( $value ) || empty( $custom ) )
3435
                            $value = '';
3436
                        elseif ( !empty( $custom ) ) {
3437
                            if ( !is_array( $custom ) ) {
3438
                                $custom = explode( "\n", $custom );
3439
3440
                                $custom_values = array();
3441
3442
                                foreach ( $custom as $c => $cv ) {
3443
                                    if ( 0 < strlen( $cv ) ) {
3444
                                        $custom_label = explode( '|', $cv );
3445
3446
                                        if ( !isset( $custom_label[ 1 ] ) )
3447
                                            $custom_label[ 1 ] = $custom_label[ 0 ];
3448
3449
                                        $custom_label[ 0 ] = trim( (string) $custom_label[ 0 ] );
3450
                                        $custom_label[ 1 ] = trim( (string) $custom_label[ 1 ] );
3451
                                        $custom_values[ $custom_label[ 0 ] ] = $custom_label[ 1 ];
3452
                                    }
3453
                                }
3454
                            }
3455
                            else
3456
                                $custom_values = $custom;
3457
3458
                            $values = array();
3459
3460
                            foreach ( $value as $k => $v ) {
3461
                                $v = pods_unsanitize( $v );
3462
3463
                                if ( isset( $custom_values[ $v ] ) )
3464
                                    $values[ $k ] = $v;
3465
                            }
3466
3467
                            $value = $values;
3468
                        }
3469
                    }
3470
3471
                    if ( 0 < $pick_limit && !empty( $value ) )
3472
                        $value = array_slice( $value, 0, $pick_limit );
3473
3474
                    // Don't save an empty array, just make it an empty string
3475 View Code Duplication
                    if ( empty( $value ) )
3476
                        $value = '';
3477
                    elseif ( is_array( $value ) ) {
3478
                        // If there's just one item, don't save as an array, save the string
3479
                        if ( 1 == $pick_limit || 1 == count( $value ) )
3480
                            $value = implode( '', $value );
3481
                        // If storage is set to table, json encode, otherwise WP will serialize automatically
3482
                        elseif ( 'table' == pods_var( 'storage', $pod ) )
3483
                            $value = version_compare( PHP_VERSION, '5.4.0', '>=' ) ? json_encode( $value, JSON_UNESCAPED_UNICODE ) : json_encode( $value );
0 ignored issues
show
Unused Code introduced by
The call to json_encode() has too many arguments starting with JSON_UNESCAPED_UNICODE.

This check compares calls to functions or methods with their respective definitions. If the call has more arguments than are defined, it raises an issue.

If a function is defined several times with a different number of parameters, the check may pick up the wrong definition and report false positives. One codebase where this has been known to happen is Wordpress.

In this case you can add the @ignore PhpDoc annotation to the duplicate definition and it will be ignored.

Loading history...
3484
                    }
3485
                }
3486
3487
                // Prepare all table / meta data
3488
                if ( !in_array( $type, $tableless_field_types ) || $simple ) {
3489
                    if ( in_array( $type, $repeatable_field_types ) && 1 == pods_var( $type . '_repeatable', $field_data, 0 ) ) {
3490
                        // Don't save an empty array, just make it an empty string
3491 View Code Duplication
                        if ( empty( $value ) )
3492
                            $value = '';
3493
                        elseif ( is_array( $value ) ) {
3494
                            // If there's just one item, don't save as an array, save the string
3495
                            if ( 1 == count( $value ) )
3496
                                $value = implode( '', $value );
3497
                            // If storage is set to table, json encode, otherwise WP will serialize automatically
3498
                            elseif ( 'table' == pods_var( 'storage', $pod ) )
3499
                                $value = version_compare( PHP_VERSION, '5.4.0', '>=' ) ? json_encode( $value, JSON_UNESCAPED_UNICODE ) : json_encode( $value );
0 ignored issues
show
Unused Code introduced by
The call to json_encode() has too many arguments starting with JSON_UNESCAPED_UNICODE.

This check compares calls to functions or methods with their respective definitions. If the call has more arguments than are defined, it raises an issue.

If a function is defined several times with a different number of parameters, the check may pick up the wrong definition and report false positives. One codebase where this has been known to happen is Wordpress.

In this case you can add the @ignore PhpDoc annotation to the duplicate definition and it will be ignored.

Loading history...
3500
                        }
3501
                    }
3502
3503
                    $table_data[ $field ] = str_replace( array( '{prefix}', '@wp_' ), array( '{/prefix/}', '{prefix}' ), $value ); // Fix for pods_query
3504
                    $table_formats[] = PodsForm::prepare( $type, $options );
3505
3506
                    $object_meta[ $field ] = $value;
3507
                }
3508
                // Store relational field data to be looped through later
3509
                else {
3510
                    // Convert values from a comma-separated string into an array
3511
                    if ( !is_array( $value ) )
3512
                        $value = explode( ',', $value );
3513
3514
                    $rel_fields[ $type ][ $field ] = $value;
3515
                    $rel_field_ids[] = $field_data[ 'id' ];
3516
                }
3517
            }
3518
        }
3519
3520
        if ( in_array( $pod[ 'type' ], array( 'post_type', 'taxonomy' ) ) ) {
3521
            $object_name = $pod[ 'name' ];
3522
3523
            if ( !empty( $pod[ 'object' ] ) )
3524
                $object_name = $pod[ 'object' ];
3525
3526
            $object_name_field = 'post_type';
3527
3528
            if ( 'taxonomy' == $pod['type'] ) {
3529
                $object_name_field = 'taxonomy';
3530
            }
3531
3532
            $object_data[ $object_name_field ] = $object_name;
3533
        }
3534
3535
        if ( ( 'meta' == $pod[ 'storage' ] || 'settings' == $pod[ 'type' ] || ( 'taxonomy' == $pod[ 'type' ] && 'none' == $pod[ 'storage' ] ) ) && !in_array( $pod[ 'type' ], array( 'pod', 'table', '' ) ) ) {
3536
            if ( $allow_custom_fields && !empty( $custom_data ) )
3537
                $object_meta = array_merge( $custom_data, $object_meta );
3538
3539
			$fields_to_send = array_flip( array_keys( $object_meta ) );
3540
3541
			foreach ( $fields_to_send as $field => $field_data ) {
3542 View Code Duplication
				if ( isset( $object_fields[ $field ] ) ) {
3543
					$field_data = $object_fields[ $field ];
3544
				}
3545
				elseif ( isset( $fields[ $field ] ) ) {
3546
					$field_data = $fields[ $field ];
3547
				}
3548
				else {
3549
					unset( $fields_to_send[ $field ] );
3550
				}
3551
3552
				$fields_to_send[ $field ] = $field_data;
3553
			}
3554
3555
            $params->id = $this->save_wp_object( $object_type, $object_data, $object_meta, false, true, $fields_to_send );
3556
3557
            if ( !empty( $params->id ) && 'settings' == $object_type )
3558
                $params->id = $pod[ 'id' ];
3559
        }
3560
        else {
3561
            if ( ! in_array( $pod[ 'type' ], array( 'pod', 'table', '' ) ) ) {
3562
                $params->id = $this->save_wp_object( $object_type, $object_data, array(), false, true );
3563
            }
3564
3565
            if ( 'table' == $pod[ 'storage' ] ) {
3566
                // Every row should have an id set here, otherwise Pods with nothing
3567
                // but relationship fields won't get properly ID'd
3568
                if ( empty( $params->id ) )
3569
                    $params->id = 0;
3570
3571
                $table_data = array( 'id' => $params->id ) + $table_data;
3572
                array_unshift( $table_formats, '%d' );
3573
3574
                if ( !empty( $table_data ) ) {
3575
                    $sql = pods_data()->insert_on_duplicate( "@wp_pods_{$params->pod}", $table_data, $table_formats );
3576
3577
                    $id = pods_query( $sql, 'Cannot add/save table row' );
3578
3579
                    if ( empty( $params->id ) )
3580
                        $params->id = $id;
3581
                }
3582
            }
3583
        }
3584
3585
        $params->id = (int) $params->id;
3586
3587
		// Save terms for taxonomies associated to a post type
3588
        if ( 0 < $params->id && 'post_type' == $pod[ 'type' ] && !empty( $post_term_data ) ) {
3589
			foreach ( $post_term_data as $post_taxonomy => $post_terms ) {
3590
                $post_terms = (array) $post_terms;
3591
3592
                foreach ( $post_terms as $k => $v ) {
3593
                    if ( ! preg_match( '/[^0-9]/', $v ) ) {
3594
                        $v = (int) $v;
3595
                    }
3596
3597
                    $post_terms[ $k ] = $v;
3598
                }
3599
3600
				wp_set_object_terms( $params->id, $post_terms, $post_taxonomy );
3601
			}
3602
		}
3603
3604
        $no_conflict = pods_no_conflict_check( $pod[ 'type' ] );
3605
3606
        if ( !$no_conflict )
3607
            pods_no_conflict_on( $pod[ 'type' ] );
3608
3609
        // Save relationship / file data
3610
        if ( !empty( $rel_fields ) ) {
3611
            foreach ( $rel_fields as $type => $data ) {
3612
                // Only handle tableless fields
3613
                if ( !in_array( $type, $tableless_field_types ) ) {
3614
                    continue;
3615
				}
3616
3617
                foreach ( $data as $field => $values ) {
3618
                    $pick_val = pods_var( 'pick_val', $fields[ $field ] );
3619
3620
                    if ( 'table' == pods_var( 'pick_object', $fields[ $field ] ) ) {
3621
                        $pick_val = pods_var( 'pick_table', $fields[ $field ][ 'options' ], $pick_val, null, true );
3622
					}
3623
3624 View Code Duplication
                    if ( '__current__' == $pick_val ) {
3625
                        if ( is_object( $pod ) ) {
3626
                            $pick_val = $pod->pod;
3627
						}
3628
                        elseif ( is_array( $pod ) ) {
3629
                            $pick_val = $pod[ 'name' ];
3630
						}
3631
                        elseif ( 0 < strlen( $pod ) ) {
3632
                            $pick_val = $pod;
3633
						}
3634
                    }
3635
3636
                    $fields[ $field ][ 'options' ][ 'table_info' ] = pods_api()->get_table_info( pods_var( 'pick_object', $fields[ $field ] ), $pick_val, null, null, $fields[ $field ][ 'options' ] );
3637
3638
                    if ( isset( $fields[ $field ][ 'options' ][ 'table_info' ][ 'pod' ] ) && !empty( $fields[ $field ][ 'options' ][ 'table_info' ][ 'pod' ] ) && isset( $fields[ $field ][ 'options' ][ 'table_info' ][ 'pod' ][ 'name' ] ) ) {
3639
						$search_data = pods( $fields[ $field ][ 'options' ][ 'table_info' ][ 'pod' ][ 'name' ] );
3640
3641
						$data_mode = 'pods';
3642
                    }
3643
					else {
3644
						$search_data = pods_data();
3645
						$search_data->table( $fields[ $field ][ 'options' ][ 'table_info' ] );
3646
3647
						$data_mode = 'data';
3648
					}
3649
3650
					$find_rel_params = array(
3651
						'select' => "`t`.`{$search_data->field_id}`",
3652
						'where' => "`t`.`{$search_data->field_slug}` = %s OR `t`.`{$search_data->field_index}` = %s",
3653
						'limit' => 1,
3654
						'pagination' => false,
3655
						'search' => false
3656
					);
3657
3658
					if ( empty( $search_data->field_slug ) && !empty( $search_data->field_index ) ) {
3659
						$find_rel_params[ 'where' ] = "`t`.`{$search_data->field_index}` = %s";
3660
					}
3661
					elseif ( empty( $search_data->field_slug ) && empty( $search_data->field_index ) ) {
3662
						$find_rel_params = false;
3663
					}
3664
3665
                    $related_limit = (int) pods_var_raw( $type . '_limit', $fields[ $field ][ 'options' ], 0 );
3666
3667 View Code Duplication
                    if ( 'single' == pods_var_raw( $type . '_format_type', $fields[ $field ][ 'options' ] ) ) {
3668
                        $related_limit = 1;
3669
					}
3670
3671
                    // Enforce integers / unique values for IDs
3672
                    $value_ids = array();
3673
3674
					$is_file_field = in_array( $type, PodsForm::file_field_types() );
3675
					$is_taggable = ( in_array( $type, PodsForm::tableless_field_types() ) && 1 == pods_v( $type . '_taggable', $fields[ $field ][ 'options' ] ) );
3676
3677
					// @todo Handle simple relationships eventually
3678
                    foreach ( $values as $v ) {
3679
                        if ( !empty( $v ) ) {
3680
							if ( !is_array( $v ) ) {
3681
								if ( !preg_match( '/[^0-9]/', $v ) ) {
3682
									$v = (int) $v;
3683
								}
3684
								// File handling
3685
								elseif ( $is_file_field ) {
3686
									// Get ID from GUID
3687
									$v = pods_image_id_from_field( $v );
3688
3689
									// If file not found, add it
3690
									if ( empty( $v ) ) {
3691
										$v = pods_attachment_import( $v );
3692
									}
3693
								}
3694
								// Reference by slug
3695
								else {
3696
									$v_data = false;
3697
3698
									if ( false !== $find_rel_params ) {
3699
										$rel_params = $find_rel_params;
3700
										$rel_params[ 'where' ] = $wpdb->prepare( $rel_params[ 'where' ], array( $v, $v ) );
3701
3702
										$search_data->select( $rel_params );
0 ignored issues
show
Bug introduced by
The method select does only exist in PodsData, but not in Pods.

It seems like the method you are trying to call exists only in some of the possible types.

Let’s take a look at an example:

class A
{
    public function foo() { }
}

class B extends A
{
    public function bar() { }
}

/**
 * @param A|B $x
 */
function someFunction($x)
{
    $x->foo(); // This call is fine as the method exists in A and B.
    $x->bar(); // This method only exists in B and might cause an error.
}

Available Fixes

  1. Add an additional type-check:

    /**
     * @param A|B $x
     */
    function someFunction($x)
    {
        $x->foo();
    
        if ($x instanceof B) {
            $x->bar();
        }
    }
    
  2. Only allow a single type to be passed if the variable comes from a parameter:

    function someFunction(B $x) { /** ... */ }
    
Loading history...
3703
3704
										$v_data = $search_data->fetch( $v );
3705
									}
3706
3707
									if ( !empty( $v_data ) && isset( $v_data[ $search_data->field_id ] ) ) {
3708
										$v = (int) $v_data[ $search_data->field_id ];
3709
									}
3710
									// Allow tagging for Pods objects
3711
									elseif ( $is_taggable && 'pods' == $data_mode ) {
3712
										$tag_data = array(
3713
											$search_data->field_index => $v
3714
										);
3715
3716
										if ( 'post_type' == $search_data->pod_data[ 'type' ] ) {
3717
											$tag_data[ 'post_status' ] = 'publish';
3718
										}
3719
3720
										/**
3721
										 * Filter for changing tag before adding new item.
3722
										 *
3723
										 * @param array $tag_data Fields for creating new item.
3724
										 * @param int $v Field ID of tag.
3725
										 * @param obj $search_data Search object for tag.
3726
										 * @param string $field Table info for field.
3727
										 * @param array	$pieces Field array.
3728
										 *
3729
										 * @since 2.3.19
3730
										 */
3731
										$tag_data = apply_filters( 'pods_api_save_pod_item_taggable_data', $tag_data, $v, $search_data, $field, compact( $pieces ) );
3732
3733
										// Save $v to a new item on related object
3734
										$v = $search_data->add( $tag_data );
0 ignored issues
show
Bug introduced by
The method add does only exist in Pods, but not in PodsData.

It seems like the method you are trying to call exists only in some of the possible types.

Let’s take a look at an example:

class A
{
    public function foo() { }
}

class B extends A
{
    public function bar() { }
}

/**
 * @param A|B $x
 */
function someFunction($x)
{
    $x->foo(); // This call is fine as the method exists in A and B.
    $x->bar(); // This method only exists in B and might cause an error.
}

Available Fixes

  1. Add an additional type-check:

    /**
     * @param A|B $x
     */
    function someFunction($x)
    {
        $x->foo();
    
        if ($x instanceof B) {
            $x->bar();
        }
    }
    
  2. Only allow a single type to be passed if the variable comes from a parameter:

    function someFunction(B $x) { /** ... */ }
    
Loading history...
3735
3736
										// @todo Support non-Pods for tagging
3737
									}
3738
								}
3739
							}
3740
							elseif ( $is_file_field && isset( $v[ 'id' ] ) ) {
3741
								$v = (int) $v[ 'id' ];
3742
							}
3743
							else {
3744
								continue;
3745
							}
3746
3747
							if ( !empty( $v ) && !in_array( $v, $value_ids ) ) {
3748
								$value_ids[] = $v;
3749
							}
3750
                        }
3751
                    }
3752
3753
                    $value_ids = array_unique( array_filter( $value_ids ) );
3754
3755
                    // Limit values
3756
                    if ( 0 < $related_limit && !empty( $value_ids ) )
3757
                        $value_ids = array_slice( $value_ids, 0, $related_limit );
3758
3759
                    // Get current values
3760
                    if ( 'pick' == $type && isset( PodsField_Pick::$related_data[ $fields[ $field ][ 'id' ] ] ) && isset( PodsField_Pick::$related_data[ $fields[ $field ][ 'id' ] ][ 'current_ids' ] ) )
3761
                        $related_ids = PodsField_Pick::$related_data[ $fields[ $field ][ 'id' ] ][ 'current_ids' ];
3762
                    else
3763
                        $related_ids = $this->lookup_related_items( $fields[ $field ][ 'id' ], $pod[ 'id' ], $params->id, $fields[ $field ], $pod );
3764
3765
                    // Get ids to remove
3766
                    $remove_ids = array_diff( $related_ids, $value_ids );
3767
3768
                    // Delete relationships
3769
                    if ( !empty( $remove_ids ) )
3770
                        $this->delete_relationships( $params->id, $remove_ids, $pod, $fields[ $field ] );
3771
3772
                    // Save relationships
3773
                    if ( !empty( $value_ids ) )
3774
                        $this->save_relationships( $params->id, $value_ids, $pod, $fields[ $field ] );
3775
3776
                    // Run save function for field type (where needed)
3777
                    PodsForm::save( $type, $value_ids, $params->id, $field, array_merge( $fields[ $field ], $fields[ $field ][ 'options' ] ), array_merge( $fields, $object_fields ), $pod, $params );
3778
                }
3779
3780
                // Unset data no longer needed
3781
                if ( 'pick' == $type ) {
3782
                    foreach ( $data as $field => $values ) {
3783
                        if ( isset( PodsField_Pick::$related_data[ $fields[ $field ][ 'id' ] ] ) ) {
3784
                            unset( PodsField_Pick::$related_data[ PodsField_Pick::$related_data[ $fields[ $field ][ 'id' ] ][ 'related_field' ][ 'id' ] ] );
3785
                            unset( PodsField_Pick::$related_data[ $fields[ $field ][ 'id' ] ] );
3786
                        }
3787
                    }
3788
                }
3789
            }
3790
        }
3791
3792
        if ( !$no_conflict )
3793
            pods_no_conflict_off( $pod[ 'type' ] );
3794
3795
        // Clear cache
3796
        pods_cache_clear( $params->id, 'pods_items_' . $pod[ 'name' ] );
3797
3798
		if ( $params->clear_slug_cache && !empty( $pod[ 'field_slug' ] ) ) {
3799
			$slug = pods( $pod[ 'name' ], $params->id )->field( $pod[ 'field_slug' ] );
3800
3801
			if ( 0 < strlen( $slug ) ) {
3802
        		pods_cache_clear( $slug, 'pods_items_' . $pod[ 'name' ] );
3803
			}
3804
		}
3805
3806
        // Clear WP meta cache
3807
        if ( in_array( $pod[ 'type' ], array( 'post_type', 'media', 'taxonomy', 'user', 'comment' ) ) ) {
3808
            $meta_type = $pod[ 'type' ];
3809
3810
            if ( 'post_type' == $meta_type )
3811
                $meta_type = 'post';
3812
3813
            wp_cache_delete( $params->id, $meta_type . '_meta' );
3814
            wp_cache_delete( $params->id, 'pods_' . $meta_type . '_meta' );
3815
        }
3816
3817
        if ( false === $bypass_helpers ) {
3818
            $pieces = compact( $pieces );
3819
3820
            // Plugin hooks
3821
            $this->do_hook( 'post_save_pod_item', $pieces, $is_new_item, $params->id );
3822
            $this->do_hook( "post_save_pod_item_{$params->pod}", $pieces, $is_new_item, $params->id );
3823
3824
            if ( $is_new_item ) {
3825
                $this->do_hook( 'post_create_pod_item', $pieces, $params->id );
3826
                $this->do_hook( "post_create_pod_item_{$params->pod}", $pieces, $params->id );
3827
            }
3828
            else {
3829
                $this->do_hook( 'post_edit_pod_item', $pieces, $params->id );
3830
                $this->do_hook( "post_edit_pod_item_{$params->pod}", $pieces, $params->id );
3831
            }
3832
3833
            // Call any post-save helpers (if not bypassed)
3834
            if ( !defined( 'PODS_DISABLE_EVAL' ) || !PODS_DISABLE_EVAL ) {
3835 View Code Duplication
                if ( !empty( $post_save_helpers ) ) {
3836
                    pods_deprecated( sprintf( __( 'Post-save helpers are deprecated, use the action pods_post_save_pod_item_%s instead', 'pods' ), $params->pod ), '2.0' );
3837
3838
                    foreach ( $post_save_helpers as $helper ) {
3839
                        $helper = $this->load_helper( array( 'name' => $helper ) );
3840
3841
                        if ( false !== $helper && ( !defined( 'PODS_DISABLE_EVAL' ) || !PODS_DISABLE_EVAL ) )
3842
                            eval( '?>' . $helper[ 'code' ] );
0 ignored issues
show
Coding Style introduced by
It is generally not recommended to use eval unless absolutely required.

On one hand, eval might be exploited by malicious users if they somehow manage to inject dynamic content. On the other hand, with the emergence of faster PHP runtimes like the HHVM, eval prevents some optimization that they perform.

Loading history...
3843
                    }
3844
                }
3845
            }
3846
        }
3847
3848
        // Success! Return the id
3849
        return $params->id;
3850
3851
    }
3852
3853
    /**
3854
     * @see PodsAPI::save_pod_item
3855
     * Add multiple pod items
3856
     *
3857
     * $params['pod'] string The Pod name (pod or pod_id is required)
3858
     * $params['pod_id'] string The Pod ID (pod or pod_id is required)
3859
     * $params['bypass_helpers'] bool Set to true to bypass running pre-save and post-save helpers
3860
     *
3861
     * $data['id'] int The item ID (optional)
3862
     * $data['data'] array An associative array of field names + values
3863
     *
3864
     * @param array|object $params An associative array of parameters, data excluded
3865
     * @param array $data An associative array of pod ids and field names + values (arrays of field data)
3866
     *
3867
     * @return int The item ID
3868
     * @since 2.0
3869
     */
3870
    public function save_pod_items ( $params, $data ) {
3871
        $params = (object) $params;
3872
3873
        $ids = array();
3874
3875
        foreach ( $data as $fields ) {
3876
            $params->data = $fields;
3877
3878
            if ( isset( $fields[ 'id' ] ) && isset( $fields[ 'data' ] ) ) {
3879
                $params->id = $fields[ 'id' ];
3880
                $params->data = $fields[ 'data' ];
3881
            }
3882
3883
            $ids[] = $this->save_pod_item( $params );
3884
        }
3885
3886
        return $ids;
3887
    }
3888
3889
	/**
3890
	 * Get the fields that have changed during a save
3891
	 *
3892
	 * @param array $pieces Pieces array from save_pod_item
3893
	 *
3894
	 * @return array Array of fields and values that have changed
3895
	 */
3896
	public function get_changed_fields( $pieces ) {
3897
3898
		$fields = $pieces[ 'fields' ];
3899
		$fields_active = $pieces[ 'fields_active' ];
3900
3901
		$fields_changed = array();
3902
3903
		if ( 0 < $pieces[ 'params' ]->id ) {
3904
			$pod = pods( $pieces[ 'params' ]->pod, $pieces[ 'params' ]->id );
3905
3906
			foreach ( $fields_active as $field ) {
3907
				if ( isset( $fields[ $field ] ) && $pod->raw( $field ) != $fields[ $field ][ 'value' ] ) {
3908
					$fields_changed[ $field ] = $fields[ $field ][ 'value' ];
3909
				}
3910
			}
3911
		}
3912
3913
		return $fields_changed;
3914
3915
	}
3916
3917
    /**
3918
     * Save relationships
3919
     *
3920
     * @param int $id ID of item
3921
     * @param int|array $related_id ID or IDs to save
0 ignored issues
show
Documentation introduced by
There is no parameter named $related_id. Did you maybe mean $related_ids?

This check looks for PHPDoc comments describing methods or function parameters that do not exist on the corresponding method or function. It has, however, found a similar but not annotated parameter which might be a good fit.

Consider the following example. The parameter $ireland is not defined by the method finale(...).

/**
 * @param array $germany
 * @param array $ireland
 */
function finale($germany, $island) {
    return "2:1";
}

The most likely cause is that the parameter was changed, but the annotation was not.

Loading history...
3922
     * @param array $pod Pod data
3923
     * @param array $field Field data
3924
     */
3925
    public function save_relationships ( $id, $related_ids, $pod, $field ) {
3926
        // Get current values
3927
        if ( 'pick' == $field[ 'type' ] && isset( PodsField_Pick::$related_data[ $field[ 'id' ] ] ) && isset( PodsField_Pick::$related_data[ $field[ 'id' ] ][ 'current_ids' ] ) )
3928
            $current_ids = PodsField_Pick::$related_data[ $field[ 'id' ] ][ 'current_ids' ];
3929
        else
3930
            $current_ids = $this->lookup_related_items( $field[ 'id' ], $pod[ 'id' ], $id, $field, $pod );
3931
3932
	    if ( isset( self::$related_item_cache[ $pod['id'] ][ $field['id'] ] ) ) {
3933
		    // Delete relationship from cache
3934
		    unset( self::$related_item_cache[ $pod['id'] ][ $field['id'] ] );
3935
	    }
3936
3937
        if ( !is_array( $related_ids ) )
3938
            $related_ids = implode( ',', $related_ids );
3939
3940
        foreach ( $related_ids as $k => $related_id ) {
0 ignored issues
show
Bug introduced by
The expression $related_ids of type string|array is not guaranteed to be traversable. How about adding an additional type check?

There are different options of fixing this problem.

  1. If you want to be on the safe side, you can add an additional type-check:

    $collection = json_decode($data, true);
    if ( ! is_array($collection)) {
        throw new \RuntimeException('$collection must be an array.');
    }
    
    foreach ($collection as $item) { /** ... */ }
    
  2. If you are sure that the expression is traversable, you might want to add a doc comment cast to improve IDE auto-completion and static analysis:

    /** @var array $collection */
    $collection = json_decode($data, true);
    
    foreach ($collection as $item) { /** .. */ }
    
  3. Mark the issue as a false-positive: Just hover the remove button, in the top-right corner of this issue for more options.

Loading history...
3941
            $related_ids[ $k ] = (int) $related_id;
3942
        }
3943
3944
        $related_ids = array_unique( array_filter( $related_ids ) );
3945
3946
        $related_limit = (int) pods_var_raw( $field[ 'type' ] . '_limit', $field[ 'options' ], 0 );
3947
3948 View Code Duplication
        if ( 'single' == pods_var_raw( $field[ 'type' ] . '_format_type', $field[ 'options' ] ) )
3949
            $related_limit = 1;
3950
3951
        // Limit values
3952
        if ( 0 < $related_limit && !empty( $related_ids ) )
3953
            $related_ids = array_slice( $related_ids, 0, $related_limit );
3954
3955
        // Post Types, Media, Users, and Comments (meta-based)
3956 View Code Duplication
        if ( in_array( $pod[ 'type' ], array( 'post_type', 'media', 'taxonomy', 'user', 'comment' ) ) ) {
3957
            $object_type = $pod[ 'type' ];
3958
3959
            if ( in_array( $object_type, array( 'post_type', 'media' ) ) )
3960
                $object_type = 'post';
3961
            elseif ( 'taxonomy' == $object_type )
3962
                $object_type = 'term';
3963
3964
            delete_metadata( $object_type, $id, $field[ 'name' ] );
3965
3966
            if ( !empty( $related_ids ) ) {
3967
                update_metadata( $object_type, $id, '_pods_' . $field[ 'name' ], $related_ids );
3968
3969
                foreach ( $related_ids as $related_id ) {
3970
                    add_metadata( $object_type, $id, $field[ 'name' ], $related_id );
3971
                }
3972
            }
3973
            else
3974
                delete_metadata( $object_type, $id, '_pods_' . $field[ 'name' ] );
3975
        }
3976
        // Custom Settings Pages (options-based)
3977
        elseif ( 'settings' == $pod[ 'type' ] ) {
3978
            if ( !empty( $related_ids ) )
3979
                update_option( $pod[ 'name' ] . '_' . $field[ 'name' ], $related_ids );
3980
            else
3981
                delete_option( $pod[ 'name' ] . '_' . $field[ 'name' ] );
3982
        }
3983
3984
        $related_pod_id = $related_field_id = 0;
3985
3986
        if ( 'pick' == $field[ 'type' ] && isset( PodsField_Pick::$related_data[ $field[ 'id' ] ] ) && !empty( PodsField_Pick::$related_data[ $field[ 'id' ] ][ 'related_field' ] ) ) {
3987
            $related_pod_id = PodsField_Pick::$related_data[ $field[ 'id' ] ][ 'related_pod' ][ 'id' ];
3988
            $related_field_id = PodsField_Pick::$related_data[ $field[ 'id' ] ][ 'related_field' ][ 'id' ];
3989
        }
3990
3991
        // Relationships table
3992
        if ( !pods_tableless() ) {
3993
            $related_weight = 0;
3994
3995
            foreach ( $related_ids as $related_id ) {
3996
                if ( in_array( $related_id, $current_ids ) ) {
3997
                    pods_query( "
3998
                        UPDATE `@wp_podsrel`
3999
                        SET
4000
                            `pod_id` = %d,
4001
                            `field_id` = %d,
4002
                            `item_id` = %d,
4003
                            `related_pod_id` = %d,
4004
                            `related_field_id` = %d,
4005
                            `related_item_id` = %d,
4006
                            `weight` = %d
4007
                        WHERE
4008
                            `pod_id` = %d
4009
                            AND `field_id` = %d
4010
                            AND `item_id` = %d
4011
                            AND `related_item_id` = %d
4012
                    ", array(
4013
                        $pod[ 'id' ],
4014
                        $field[ 'id' ],
4015
                        $id,
4016
                        $related_pod_id,
4017
                        $related_field_id,
4018
                        $related_id,
4019
                        $related_weight,
4020
4021
                        $pod[ 'id' ],
4022
                        $field[ 'id' ],
4023
                        $id,
4024
                        $related_id,
4025
                    ) );
4026
                }
4027
                else {
4028
                    pods_query( "
4029
                        INSERT INTO `@wp_podsrel`
4030
                            (
4031
                                `pod_id`,
4032
                                `field_id`,
4033
                                `item_id`,
4034
                                `related_pod_id`,
4035
                                `related_field_id`,
4036
                                `related_item_id`,
4037
                                `weight`
4038
                            )
4039
                        VALUES ( %d, %d, %d, %d, %d, %d, %d )
4040
                    ", array(
4041
                        $pod[ 'id' ],
4042
                        $field[ 'id' ],
4043
                        $id,
4044
                        $related_pod_id,
4045
                        $related_field_id,
4046
                        $related_id,
4047
                        $related_weight
4048
                    ) );
4049
                }
4050
4051
                $related_weight++;
4052
            }
4053
        }
4054
    }
4055
4056
    /**
4057
     * Duplicate a Pod
4058
     *
4059
     * $params['id'] int The Pod ID
4060
     * $params['name'] string The Pod name
4061
     * $params['new_name'] string The new Pod name
4062
     *
4063
     * @param array $params An associative array of parameters
4064
     * @param bool $strict (optional) Makes sure a pod exists, if it doesn't throws an error
4065
     *
4066
     * @return int New Pod ID
4067
     * @since 2.3
4068
     */
4069
    public function duplicate_pod ( $params, $strict = false ) {
4070 View Code Duplication
        if ( !is_object( $params ) && !is_array( $params ) ) {
4071
            if ( is_numeric( $params ) )
4072
                $params = array( 'id' => $params );
4073
            else
4074
                $params = array( 'name' => $params );
4075
4076
            $params = (object) pods_sanitize( $params );
4077
        }
4078
        else
4079
            $params = (object) pods_sanitize( $params );
4080
4081
        $params->table_info = false;
4082
4083
        $pod = $this->load_pod( $params, $strict );
4084
4085
        if ( empty( $pod ) ) {
4086
            if ( false !== $strict )
4087
                return pods_error( __( 'Pod not found', 'pods' ), $this );
4088
4089
            return false;
4090
        }
4091
        elseif ( in_array( $pod[ 'type' ], array( 'media', 'user', 'comment' ) ) ) {
4092
            if ( false !== $strict )
4093
                return pods_error( __( 'Pod not allowed to be duplicated', 'pods' ), $this );
4094
4095
            return false;
4096
        }
4097
        elseif ( in_array( $pod[ 'type' ], array( 'post_type', 'taxonomy' ) ) && 0 < strlen( $pod[ 'object' ] ) ) {
4098
			$pod[ 'object' ] = '';
4099
        }
4100
4101
        unset( $pod[ 'id' ] );
4102
4103
        if ( isset( $params->new_name ) )
4104
            $pod[ 'name' ] = $params->new_name;
4105
4106
        $try = 1;
4107
4108
        $check_name = $pod[ 'name' ];
4109
        $new_label = $pod[ 'label' ];
4110
4111 View Code Duplication
        while ( $this->load_pod( array( 'name' => $check_name, 'table_info' => false ), false ) ) {
4112
            $try++;
4113
4114
            $check_name = $pod[ 'name' ] . $try;
4115
            $new_label = $pod[ 'label' ] . $try;
4116
        }
4117
4118
        $pod[ 'name' ] = $check_name;
4119
        $pod[ 'label' ] = $new_label;
4120
4121
        foreach ( $pod[ 'fields' ] as $field => $field_data ) {
4122
            unset( $pod[ 'fields' ][ $field ][ 'id' ] );
4123
        }
4124
4125
        return $this->save_pod( $pod );
4126
    }
4127
4128
    /**
4129
     * Duplicate a Field
4130
     *
4131
     * $params['pod_id'] int The Pod ID
4132
     * $params['pod'] string The Pod name
4133
     * $params['id'] int The Field ID
4134
     * $params['name'] string The Field name
4135
     * $params['new_name'] string The new Field name
4136
     *
4137
     * @param array $params An associative array of parameters
4138
     * @param bool $strict (optional) Makes sure a field exists, if it doesn't throws an error
4139
     *
4140
     * @return int New Field ID
4141
     * @since 2.3.10
4142
     */
4143
	public function duplicate_field( $params, $strict = false ) {
4144
4145
		if ( !is_object( $params ) && !is_array( $params ) ) {
4146
			if ( is_numeric( $params ) ) {
4147
				$params = array( 'id' => $params );
4148
			}
4149
			else {
4150
				$params = array( 'name' => $params );
4151
			}
4152
		}
4153
4154
		$params = (object) pods_sanitize( $params );
4155
4156
		$params->table_info = false;
4157
4158
		$field = $this->load_field( $params, $strict );
4159
4160
		if ( empty( $field ) ) {
4161
			if ( false !== $strict ) {
4162
				return pods_error( __( 'Field not found', 'pods' ), $this );
4163
			}
4164
4165
			return false;
4166
		}
4167
4168
		unset( $field[ 'id' ] );
4169
4170
		if ( isset( $params->new_name ) ) {
4171
			$field[ 'name' ] = $params->new_name;
4172
		}
4173
4174
		$try = 1;
4175
4176
		$check_name = $field[ 'name' ];
4177
		$new_label = $field[ 'label' ];
4178
4179 View Code Duplication
		while ( $this->load_field( array( 'pod_id' => $field[ 'pod_id' ], 'name' => $check_name, 'table_info' => false ), false ) ) {
4180
			$try++;
4181
4182
			$check_name = $field[ 'name' ] . $try;
4183
			$new_label = $field[ 'label' ] . $try;
4184
		}
4185
4186
		$field[ 'name' ] = $check_name;
4187
		$field[ 'label' ] = $new_label;
4188
4189
		return $this->save_field( $field );
4190
4191
	}
4192
4193
	/**
4194
	* @see PodsAPI::save_pod_item
4195
	*
4196
	* Duplicate a pod item
4197
	*
4198
	* $params['pod'] string The Pod name
4199
	* $params['id'] int The item's ID from the wp_pods_* table
4200
	*
4201
	* @param array $params An associative array of parameters
4202
	*
4203
	* @return int The table row ID
4204
	*
4205
	* @since 1.12
4206
	*/
4207
	public function duplicate_pod_item ( $params ) {
4208
4209
		$params = (object) pods_sanitize( $params );
4210
4211
		$load_pod_params = array(
4212
			'name' => $params->pod,
4213
			'table_info' => false,
4214
		);
4215
4216
		$pod = $this->load_pod( $load_pod_params );
4217
4218
		if ( false === $pod ) {
4219
			return pods_error( __( 'Pod not found', 'pods' ), $this );
4220
		}
4221
4222
		$pod = pods( $params->pod, $params->id );
4223
4224
		$params->pod = $pod->pod;
4225
		$params->pod_id = $pod->pod_id;
4226
4227
		$fields = (array) pods_var_raw( 'fields', $pod->pod_data, array(), null, true );
4228
		$object_fields = (array) pods_var_raw( 'object_fields', $pod->pod_data, array(), null, true );
4229
4230
		if ( ! empty( $object_fields ) ) {
4231
			$fields = array_merge( $object_fields, $fields );
4232
		}
4233
4234
		$save_params = array(
4235
			'pod' => $params->pod,
4236
			'data' => array()
4237
		);
4238
4239
		$ignore_fields = array(
4240
			$pod->pod_data['field_id'],
4241
			$pod->pod_data['field_slug'],
4242
		);
4243
4244
		if ( in_array( $pod->pod_data['type'], array( 'post_type', 'media' ) ) ) {
4245
			$ignore_fields = array(
4246
				'post_name',
4247
				'post_date',
4248
				'post_date_gmt',
4249
				'post_modified',
4250
				'post_modified_gmt',
4251
				'guid',
4252
		        );
4253
		} elseif ( 'term' == $pod->pod_data['type'] ) {
4254
			$ignore_fields = array(
4255
				'term_taxonomy_id',
4256
				'slug',
4257
		        );
4258
		} elseif ( 'user' == $pod->pod_data['type'] ) {
4259
			$ignore_fields = array(
4260
				'user_nicename',
4261
		        );
4262
		} elseif ( 'comment' == $pod->pod_data['type'] ) {
4263
			$ignore_fields = array(
4264
		        );
4265
		}
4266
4267
		/**
4268
		 * Filter the fields to ignore during duplication
4269
		 *
4270
		 * @since 2.6.6
4271
		 *
4272
		 * @param array  $ignore_fields Fields to ignore and not save during duplication
4273
		 * @param Pods   $pod           Pod object
4274
		 * @param array  $fields        Fields on the pod to duplicate
4275
		 * @param object $params        Params passed into duplicate_pod_item()
4276
		 */
4277
		$ignore_fields = apply_filters( 'pods_api_duplicate_pod_item_ignore_fields', $ignore_fields, $pod, $fields, $params );
4278
4279
		foreach ( $fields as $field ) {
4280
			if ( in_array( $field['name'], $ignore_fields ) ) {
4281
				continue;
4282
			}
4283
4284
			$field = array(
4285
				'name' => $field['name'],
4286
				'output' => 'ids'
4287
			);
4288
4289
			$value = $pod->field( $field );
4290
4291
			// @todo Add post type compatibility to set unique post_title
4292
			// @todo Add term compatibility to set unique name
4293
			// @todo Add user compatibility to set unique user_login/user_email
4294
4295
			if ( ! empty( $value ) || ( ! is_array( $value ) && 0 < strlen( $value ) ) ) {
4296
				$save_params['data'][ $field['name'] ] = $value;
4297
			}
4298
		}
4299
4300
		$save_params = $this->do_hook( 'duplicate_pod_item', $save_params, $pod->pod, $pod->id(), $params );
4301
4302
		$id = $this->save_pod_item( $save_params );
4303
4304
		return $id;
4305
4306
	}
4307
4308
    /**
4309
     * @see pods()
4310
     *
4311
     * Export a pod item
4312
     *
4313
     * $params['pod'] string The Pod name
4314
     * $params['id'] int The item's ID from the wp_pods_* table
4315
     * $params['fields'] array The fields to export
4316
     * $params['depth'] int How many levels deep to export data
4317
     *
4318
     * @param array $params An associative array of parameters
4319
     * @param object $pod (optional) Pods object
4320
     *
4321
     * @return int The table row ID
4322
     * @since 1.12
4323
     */
4324
    public function export_pod_item ( $params, $pod = null ) {
4325
        if ( !is_object( $pod ) || 'Pods' != get_class( $pod ) ) {
4326
            if ( empty( $params ) )
4327
                return false;
4328
4329
            $params = (object) pods_sanitize( $params );
4330
4331
            $pod = pods( $params->pod, $params->id, false );
4332
4333
            if ( empty( $pod ) )
4334
                return false;
4335
        }
4336
4337
        $fields = (array) pods_var_raw( 'fields', $params, array(), null, true );
4338
        $depth = (int) pods_var_raw( 'depth', $params, 2, null, true );
4339
        $object_fields = (array) pods_var_raw( 'object_fields', $pod->pod_data, array(), null, true );
4340
        $flatten = (boolean) pods_var( 'flatten', $params, false, null, true );
4341
4342
        if ( empty( $fields ) ) {
4343
            $fields = $pod->fields;
4344
            $fields = array_merge( $fields, $object_fields );
4345
        }
4346
4347
        $data = $this->export_pod_item_level( $pod, $fields, $depth, $flatten );
4348
4349
        $data = $this->do_hook( 'export_pod_item', $data, $pod->pod, $pod->id(), $pod, $fields, $depth, $flatten );
4350
4351
        return $data;
4352
    }
4353
4354
    /**
4355
     * Export a pod item by depth level
4356
     *
4357
     * @param Pods $pod Pods object
4358
     * @param array $fields Fields to export
4359
     * @param int $depth Depth limit
4360
     * @param boolean $flatten Whether to flatten arrays for display
4361
     * @param int $current_depth Current depth level
4362
     *
4363
     * @return array Data array
4364
     *
4365
     * @since 2.3
4366
     */
4367
    private function export_pod_item_level ( $pod, $fields, $depth, $flatten = false, $current_depth = 1 ) {
4368
        $tableless_field_types = PodsForm::tableless_field_types();
4369
        $simple_tableless_objects = PodsForm::simple_tableless_objects();
4370
4371
        $object_fields = (array) pods_var_raw( 'object_fields', $pod->pod_data, array(), null, true );
4372
4373
        $export_fields = array();
4374
4375
        foreach ( $fields as $k => $field ) {
4376
            if ( !is_array( $field ) ) {
4377
                $field = array(
4378
                    'id' => 0,
4379
                    'name' => $field
4380
                );
4381
            }
4382
4383
            if ( isset( $pod->fields[ $field[ 'name' ] ] ) ) {
4384
                $field = $pod->fields[ $field[ 'name' ] ];
4385
                $field[ 'lookup_name' ] = $field[ 'name' ];
4386
4387
                if ( in_array( $field[ 'type' ], $tableless_field_types ) && !in_array( pods_var( 'pick_object', $field ), $simple_tableless_objects ) ) {
4388
                    if ( 'pick' == $field[ 'type' ] ) {
4389
                        if ( empty( $field[ 'table_info' ] ) )
4390
                            $field[ 'table_info' ] = $this->get_table_info( pods_var_raw( 'pick_object', $field ), pods_var_raw( 'pick_val', $field ), null, null, $field );
4391
4392
                        if ( !empty( $field[ 'table_info' ] ) )
4393
                            $field[ 'lookup_name' ] .= '.' . $field[ 'table_info' ][ 'field_id' ];
4394
                    }
4395
                    elseif ( in_array( $field[ 'type' ], PodsForm::file_field_types() ) )
4396
                        $field[ 'lookup_name' ] .= '.guid';
4397
                }
4398
4399
                $export_fields[ $field[ 'name' ] ] = $field;
4400
            }
4401
            elseif ( isset( $object_fields[ $field[ 'name' ] ] ) ) {
4402
                $field = $object_fields[ $field[ 'name' ] ];
4403
                $field[ 'lookup_name' ] = $field[ 'name' ];
4404
4405
                $export_fields[ $field[ 'name' ] ] = $field;
4406
            }
4407
            elseif ( $field[ 'name' ] == $pod->pod_data[ 'field_id' ] ) {
4408
                $field[ 'type' ] = 'number';
4409
                $field[ 'lookup_name' ] = $field[ 'name' ];
4410
4411
                $export_fields[ $field[ 'name' ] ] = $field;
4412
            }
4413
        }
4414
4415
        $data = array();
4416
4417
        foreach ( $export_fields as $field ) {
4418
            // Return IDs (or guid for files) if only one level deep
4419
            if ( 1 == $depth )
4420
                $data[ $field[ 'name' ] ] = $pod->field( array( 'name' => $field[ 'lookup_name' ], 'output' => 'arrays' ) );
4421
            // Recurse depth levels for pick fields if $depth allows
4422
            elseif ( ( -1 == $depth || $current_depth < $depth ) && 'pick' == $field[ 'type' ] && !in_array( pods_var( 'pick_object', $field ), $simple_tableless_objects ) ) {
4423
                $related_data = array();
4424
4425
                $related_ids = $pod->field( array( 'name' => $field[ 'name' ], 'output' => 'ids' ) );
4426
4427
                if ( !empty( $related_ids ) ) {
4428
                    $related_ids = (array) $related_ids;
4429
4430
                    $pick_object = pods_var_raw( 'pick_object', $field );
4431
4432
                    $related_pod = pods( pods_var_raw( 'pick_val', $field ), null, false );
4433
4434
                    // If this isn't a Pod, return data exactly as Pods does normally
4435
                    if ( empty( $related_pod ) || ( 'pod' != $pick_object && $pick_object != $related_pod->pod_data[ 'type' ] ) || $related_pod->pod == $pod->pod )
4436
                        $related_data = $pod->field( array( 'name' => $field[ 'name' ], 'output' => 'arrays' ) );
4437
                    else {
4438
                        $related_object_fields = (array) pods_var_raw( 'object_fields', $related_pod->pod_data, array(), null, true );
4439
4440
                        $related_fields = array_merge( $related_pod->fields, $related_object_fields );
4441
4442
                        foreach ( $related_ids as $related_id ) {
4443
                            if ( $related_pod->fetch( $related_id ) ) {
4444
                                $related_item = $this->export_pod_item_level( $related_pod, $related_fields, $depth, $flatten, ( $current_depth + 1 ) );
4445
4446
                                $related_data[ $related_id ] = $this->do_hook( 'export_pod_item_level', $related_item, $related_pod->pod, $related_pod->id(), $related_pod, $related_fields, $depth, $flatten, ( $current_depth + 1 ) );
4447
                            }
4448
                        }
4449
4450
                        if ( $flatten && !empty( $related_data ) )
4451
                            $related_data = pods_serial_comma( array_values( $related_data ), array( 'and' => '', 'field_index' => $related_pod->pod_data[ 'field_index' ] ) );
4452
                    }
4453
                }
4454
4455
                $data[ $field[ 'name' ] ] = $related_data;
4456
            }
4457
            // Return data exactly as Pods does normally
4458
            else
4459
                $data[ $field[ 'name' ] ] = $pod->field( array( 'name' => $field[ 'name' ], 'output' => 'arrays' ) );
4460
4461
            if ( $flatten && is_array( $data[ $field[ 'name' ] ] ) )
4462
                $data[ $field[ 'name' ] ] = pods_serial_comma( $data[ $field[ 'name' ] ], array( 'field' => $field[ 'name' ], 'fields' => $export_fields, 'and' => '' ) );
4463
        }
4464
4465
	$data[ 'id' ] = (int) $pod->id();
4466
        return $data;
4467
    }
4468
4469
    /**
4470
     * Reorder a Pod
4471
     *
4472
     * $params['pod'] string The Pod name
4473
     * $params['field'] string The field name of the field to reorder
4474
     * $params['order'] array The key => value array of items to reorder (key should be an integer)
4475
     *
4476
     * @param array $params An associative array of parameters
4477
     *
4478
     * @return bool
4479
     *
4480
     * @since 1.9.0
4481
     */
4482
    public function reorder_pod_item ( $params ) {
4483
        $params = (object) pods_sanitize( $params );
4484
4485
        // @deprecated 2.0
4486
        if ( isset( $params->datatype ) ) {
4487
            pods_deprecated( __( '$params->pod instead of $params->datatype', 'pods' ), '2.0' );
4488
4489
            $params->pod = $params->datatype;
4490
4491
            unset( $params->datatype );
4492
        }
4493
4494
        if ( null === pods_var_raw( 'pod', $params, null, null, true ) )
4495
            return pods_error( __( '$params->pod is required', 'pods' ), $this );
4496
4497
        if ( !is_array( $params->order ) )
4498
            $params->order = explode( ',', $params->order );
4499
4500
        $pod = $this->load_pod( array( 'name' => $params->pod, 'table_info' => true ) );
4501
4502
        $params->name = $pod[ 'name' ];
4503
4504
        if ( false === $pod )
4505
            return pods_error( __( 'Pod is required', 'pods' ), $this );
4506
4507
        foreach ( $params->order as $order => $id ) {
4508
            if ( isset( $pod[ 'fields' ][ $params->field ] ) || isset( $pod[ 'object_fields' ][ $params->field ] ) ) {
4509
                if ( 'table' == $pod[ 'storage' ] && ( !pods_tableless() ) ) {
4510
                    if ( isset( $pod[ 'fields' ][ $params->field ] ) )
4511
                        pods_query( "UPDATE `@wp_pods_{$params->name}` SET `{$params->field}` = " . pods_absint( $order ) . " WHERE `id` = " . pods_absint( $id ) . " LIMIT 1" );
4512
                    else
4513
                        pods_query( "UPDATE `{$pod['table']}` SET `{$params->field}` = " . pods_absint( $order ) . " WHERE `{$pod['field_id']}` = " . pods_absint( $id ) . " LIMIT 1" );
4514
                }
4515
                else
4516
                    $this->save_pod_item( array( 'pod' => $params->pod, 'pod_id' => $params->pod_id, 'id' => $id, 'data' => array( $params->field => pods_absint( $order ) ) ) );
4517
            }
4518
        }
4519
4520
        return true;
4521
    }
4522
4523
    /**
4524
     *
4525
     * Delete all content for a Pod
4526
     *
4527
     * $params['id'] int The Pod ID
4528
     * $params['name'] string The Pod name
4529
     *
4530
     * @param array $params An associative array of parameters
4531
     * @param array $pod Pod data
4532
     *
4533
     * @return bool
4534
     *
4535
     * @uses pods_query
4536
     * @uses pods_cache_clear
4537
     *
4538
     * @since 1.9.0
4539
     */
4540
    public function reset_pod ( $params, $pod = false ) {
4541
        $params = (object) pods_sanitize( $params );
4542
4543
        $params->table_info = true;
4544
4545
        if ( empty( $pod ) )
4546
            $pod = $this->load_pod( $params );
4547
4548
        if ( false === $pod )
4549
            return pods_error( __( 'Pod not found', 'pods' ), $this );
4550
4551
        $params->id = $pod[ 'id' ];
4552
        $params->name = $pod[ 'name' ];
4553
4554 View Code Duplication
        if ( !pods_tableless() ) {
4555
            if ( 'table' == $pod[ 'storage' ] ) {
4556
                try {
4557
                    pods_query( "TRUNCATE `@wp_pods_{$params->name}`", false );
4558
                }
4559
                catch ( Exception $e ) {
4560
                    // Allow pod to be reset if the table doesn't exist
4561
                    if ( false === strpos( $e->getMessage(), 'Unknown table' ) )
4562
                        return pods_error( $e->getMessage(), $this );
4563
                }
4564
            }
4565
4566
            pods_query( "DELETE FROM `@wp_podsrel` WHERE `pod_id` = {$params->id} OR `related_pod_id` = {$params->id}", false );
4567
        }
4568
4569
        // @todo Delete relationships from tableless relationships
4570
4571
        // Delete all posts/revisions from this post type
4572
        if ( in_array( $pod[ 'type' ], array( 'post_type', 'media' ) ) ) {
4573
            $type = pods_var( 'object', $pod, $pod[ 'name' ], null, true );
4574
4575
            $sql = "
4576
                DELETE `t`, `r`, `m`
4577
                FROM `{$pod['table']}` AS `t`
4578
                LEFT JOIN `{$pod['meta_table']}` AS `m`
4579
                    ON `m`.`{$pod['meta_field_id']}` = `t`.`{$pod['field_id']}`
4580
                LEFT JOIN `{$pod['table']}` AS `r`
4581
                    ON `r`.`post_parent` = `t`.`{$pod['field_id']}` AND `r`.`post_status` = 'inherit'
4582
                WHERE `t`.`{$pod['field_type']}` = '{$type}'
4583
            ";
4584
4585
            pods_query( $sql, false );
4586
        }
4587
        // Delete all terms from this taxonomy
4588
        elseif ( 'taxonomy' == $pod[ 'type' ] ) {
4589
            if ( function_exists( 'get_term_meta' ) ) {
4590
                $sql = "
4591
                    DELETE `t`, `m`, `tt`, `tr`
4592
                    FROM `{$pod['table']}` AS `t`
4593
                    LEFT JOIN `{$pod['meta_table']}` AS `m`
4594
                        ON `m`.`{$pod['meta_field_id']}` = `t`.`{$pod['field_id']}`
4595
                    " . $pod['join']['tt'] . "
4596
                    " . $pod['join']['tr'] . "
4597
                    WHERE " . implode( ' AND ', $pod['where'] ) . "
4598
                ";
4599
            } else {
4600
                $sql = "
4601
                    DELETE `t`, `tt`, `tr`
4602
                    FROM `{$pod['table']}` AS `t`
4603
                    " . $pod['join']['tt'] . "
4604
                    " . $pod['join']['tr'] . "
4605
                    WHERE " . implode( ' AND ', $pod['where'] ) . "
4606
                ";
4607
            }
4608
4609
            pods_query( $sql, false );
4610
        }
4611
        // Delete all users except the current one
4612
        elseif ( 'user' == $pod[ 'type' ] ) {
4613
            $sql = "
4614
                DELETE `t`, `m`
4615
                FROM `{$pod['table']}` AS `t`
4616
                LEFT JOIN `{$pod['meta_table']}` AS `m`
4617
                    ON `m`.`{$pod['meta_field_id']}` = `t`.`{$pod['field_id']}`
4618
                WHERE `t`.`{$pod['field_id']}` != " . (int) get_current_user_id() . "
4619
            ";
4620
4621
            pods_query( $sql, false );
4622
        }
4623
        // Delete all comments
4624
        elseif ( 'comment' == $pod[ 'type' ] ) {
4625
            $type = pods_var( 'object', $pod, $pod[ 'name' ], null, true );
4626
4627
            $sql = "
4628
                DELETE `t`, `m`
4629
                FROM `{$pod['table']}` AS `t`
4630
                LEFT JOIN `{$pod['meta_table']}` AS `m`
4631
                    ON `m`.`{$pod['meta_field_id']}` = `t`.`{$pod['field_id']}`
4632
                WHERE `t`.`{$pod['field_type']}` = '{$type}'
4633
            ";
4634
4635
            pods_query( $sql, false );
4636
        }
4637
4638
        pods_cache_clear( true ); // only way to reliably clear out cached data across an entire group
4639
4640
        return true;
4641
    }
4642
4643
    /**
4644
     * Delete a Pod and all its content
4645
     *
4646
     * $params['id'] int The Pod ID
4647
     * $params['name'] string The Pod name
4648
     *
4649
     * @param array $params An associative array of parameters
4650
     * @param bool $strict (optional) Makes sure a pod exists, if it doesn't throws an error
4651
     * @param bool $delete_all (optional) Whether to delete all content from a WP object
4652
     *
4653
     * @uses PodsAPI::load_pod
4654
     * @uses wp_delete_post
4655
     * @uses pods_query
4656
     *
4657
     * @return bool
4658
     * @since 1.7.9
4659
     */
4660
    public function delete_pod ( $params, $strict = false, $delete_all = false ) {
4661
        /**
4662
         * @var $wpdb wpdb
4663
         */
4664
        global $wpdb;
0 ignored issues
show
Compatibility Best Practice introduced by
Use of global functionality is not recommended; it makes your code harder to test, and less reusable.

Instead of relying on global state, we recommend one of these alternatives:

1. Pass all data via parameters

function myFunction($a, $b) {
    // Do something
}

2. Create a class that maintains your state

class MyClass {
    private $a;
    private $b;

    public function __construct($a, $b) {
        $this->a = $a;
        $this->b = $b;
    }

    public function myFunction() {
        // Do something
    }
}
Loading history...
4665
4666 View Code Duplication
        if ( !is_object( $params ) && !is_array( $params ) ) {
4667
            if ( is_numeric( $params ) )
4668
                $params = array( 'id' => $params );
4669
            else
4670
                $params = array( 'name' => $params );
4671
4672
            $params = (object) pods_sanitize( $params );
4673
        }
4674
        else
4675
            $params = (object) pods_sanitize( $params );
4676
4677
        $params->table_info = false;
4678
4679
        $pod = $this->load_pod( $params, $strict );
4680
4681
        if ( empty( $pod ) ) {
4682
            if ( false !== $strict )
4683
                return pods_error( __( 'Pod not found', 'pods' ), $this );
4684
4685
            return false;
4686
        }
4687
4688
        $params->id = (int) $pod[ 'id' ];
4689
        $params->name = $pod[ 'name' ];
4690
4691
        foreach ( $pod[ 'fields' ] as $field ) {
4692
            $field[ 'pod' ] = $pod;
4693
4694
            $this->delete_field( $field, false );
4695
        }
4696
4697
        // Only delete the post once the fields are taken care of, it's not required anymore
4698
        $success = wp_delete_post( $params->id );
4699
4700
        if ( !$success )
4701
            return pods_error( __( 'Pod unable to be deleted', 'pods' ), $this );
4702
4703
        // Reset content
4704
        if ( $delete_all )
4705
            $this->reset_pod( $params, $pod );
4706
4707 View Code Duplication
        if ( !pods_tableless() ) {
4708
            if ( 'table' == $pod[ 'storage' ] ) {
4709
                try {
4710
                    pods_query( "DROP TABLE IF EXISTS `@wp_pods_{$params->name}`", false );
4711
                }
4712
                catch ( Exception $e ) {
4713
                    // Allow pod to be deleted if the table doesn't exist
4714
                    if ( false === strpos( $e->getMessage(), 'Unknown table' ) )
4715
                        return pods_error( $e->getMessage(), $this );
4716
                }
4717
            }
4718
4719
            pods_query( "DELETE FROM `@wp_podsrel` WHERE `pod_id` = {$params->id} OR `related_pod_id` = {$params->id}", false );
4720
        }
4721
4722
        // @todo Delete relationships from tableless relationships
4723
4724
        // Delete any relationship references
4725
        $sql = "
4726
            DELETE `pm`
4727
            FROM `{$wpdb->postmeta}` AS `pm`
4728
            LEFT JOIN `{$wpdb->posts}` AS `p`
4729
                ON `p`.`post_type` = '_pods_field'
4730
                    AND `p`.`ID` = `pm`.`post_id`
4731
            LEFT JOIN `{$wpdb->postmeta}` AS `pm2`
4732
                ON `pm2`.`meta_key` = 'pick_object'
4733
                    AND `pm2`.`meta_value` = 'pod'
4734
                    AND `pm2`.`post_id` = `pm`.`post_id`
4735
            WHERE
4736
                `p`.`ID` IS NOT NULL
4737
                AND `pm2`.`meta_id` IS NOT NULL
4738
                AND `pm`.`meta_key` = 'pick_val'
4739
                AND `pm`.`meta_value` = '{$params->name}'
4740
        ";
4741
4742
        pods_query( $sql );
4743
4744
        $this->cache_flush_pods( $pod );
4745
4746
        return true;
4747
    }
4748
4749
    /**
4750
     * Drop a field within a Pod
4751
     *
4752
     * $params['id'] int The field ID
4753
     * $params['name'] int The field name
4754
     * $params['pod'] string The Pod name
4755
     * $params['pod_id'] string The Pod name
4756
     *
4757
     * @param array $params An associative array of parameters
4758
     * @param bool $table_operation Whether or not to handle table operations
4759
     *
4760
     * @uses PodsAPI::load_field
4761
     * @uses wp_delete_post
4762
     * @uses pods_query
4763
     *
4764
     * @return bool
4765
     * @since 1.7.9
4766
     */
4767
    public function delete_field ( $params, $table_operation = true ) {
4768
        /**
4769
         * @var $wpdb wpdb
4770
         */
4771
        global $wpdb;
0 ignored issues
show
Compatibility Best Practice introduced by
Use of global functionality is not recommended; it makes your code harder to test, and less reusable.

Instead of relying on global state, we recommend one of these alternatives:

1. Pass all data via parameters

function myFunction($a, $b) {
    // Do something
}

2. Create a class that maintains your state

class MyClass {
    private $a;
    private $b;

    public function __construct($a, $b) {
        $this->a = $a;
        $this->b = $b;
    }

    public function myFunction() {
        // Do something
    }
}
Loading history...
4772
4773
        $tableless_field_types = PodsForm::tableless_field_types();
4774
        $simple_tableless_objects = PodsForm::simple_tableless_objects();
4775
4776
        $params = (object) pods_sanitize( $params );
4777
4778
        if ( !isset( $params->pod ) )
4779
            $params->pod = '';
4780
4781
        if ( !isset( $params->pod_id ) )
4782
            $params->pod_id = 0;
4783
4784
        $pod = $params->pod;
4785
4786
        $save_pod = false;
4787
4788
        if ( !is_array( $pod ) )
4789
            $pod = $this->load_pod( array( 'name' => $pod, 'id' => $params->pod_id, 'table_info' => false ) );
4790
        else
4791
            $save_pod = true;
4792
4793
        if ( empty( $pod ) )
4794
            return pods_error( __( 'Pod not found', 'pods' ), $this );
4795
4796
        $params->pod_id = $pod[ 'id' ];
4797
        $params->pod = $pod[ 'name' ];
4798
4799
        if ( !isset( $params->name ) )
4800
            $params->name = '';
4801
4802
        if ( !isset( $params->id ) )
4803
            $params->id = 0;
4804
4805
        $field = $this->load_field( array( 'name' => $params->name, 'id' => $params->id, 'pod' => $params->pod, 'pod_id' => $params->pod_id ) );
4806
4807
        if ( false === $field )
4808
            return pods_error( __( 'Field not found', 'pods' ), $this );
4809
4810
        $params->id = $field[ 'id' ];
4811
        $params->name = $field[ 'name' ];
4812
4813
        $simple = ( 'pick' == $field[ 'type' ] && in_array( pods_var( 'pick_object', $field ), $simple_tableless_objects ) );
4814
        $simple = (boolean) $this->do_hook( 'tableless_custom', $simple, $field, $pod, $params );
4815
4816
        if ( $table_operation && 'table' == $pod[ 'storage' ] && ( !in_array( $field[ 'type' ], $tableless_field_types ) || $simple ) )
4817
            pods_query( "ALTER TABLE `@wp_pods_{$params->pod}` DROP COLUMN `{$params->name}`", false );
4818
4819
        $success = wp_delete_post( $params->id );
4820
4821
        if ( !$success )
4822
            return pods_error( __( 'Field unable to be deleted', 'pods' ), $this );
4823
4824
        $wpdb->query( $wpdb->prepare( "DELETE pm FROM {$wpdb->postmeta} AS pm
4825
            LEFT JOIN {$wpdb->posts} AS p
4826
                ON p.post_type = '_pods_field' AND p.ID = pm.post_id
4827
            WHERE p.ID IS NOT NULL AND pm.meta_key = 'sister_id' AND pm.meta_value = %d", $params->id ) );
4828
4829
        if ( ( !pods_tableless() ) && $table_operation ) {
4830
            pods_query( "DELETE FROM `@wp_podsrel` WHERE (`pod_id` = {$params->pod_id} AND `field_id` = {$params->id}) OR (`related_pod_id` = {$params->pod_id} AND `related_field_id` = {$params->id})", false );
4831
        }
4832
4833
        // @todo Delete tableless relationship meta
4834
4835
        if ( true === $save_pod )
4836
            $this->cache_flush_pods( $pod );
4837
4838
        return true;
4839
    }
4840
4841
    /**
4842
     * Drop a Pod Object
4843
     *
4844
     * $params['id'] int The object ID
4845
     * $params['name'] string The object name
4846
     * $params['type'] string The object type
4847
     *
4848
     * @param array|object $params An associative array of parameters
4849
     *
4850
     * @uses wp_delete_post
4851
     *
4852
     * @return bool
4853
     * @since 2.0
4854
     */
4855
    public function delete_object ( $params ) {
4856
        $params = (object) $params;
4857
        $object = $this->load_object( $params );
4858
4859 View Code Duplication
        if ( empty( $object ) )
4860
            return pods_error( sprintf( __( "%s Object not found", 'pods' ), ucwords( $params->type ) ), $this );
4861
4862
        $success = wp_delete_post( $params->id );
4863
4864 View Code Duplication
        if ( !$success )
4865
            return pods_error( sprintf( __( "%s Object not deleted", 'pods' ), ucwords( $params->type ) ), $this );
4866
4867
        pods_transient_clear( 'pods_objects_' . $params->type );
4868
4869
        return true;
4870
    }
4871
4872
    /**
4873
     * @see PodsAPI::delete_object
4874
     *
4875
     * Drop a Pod Template
4876
     *
4877
     * $params['id'] int The template ID
4878
     * $params['name'] string The template name
4879
     *
4880
     * @param array $params An associative array of parameters
4881
     *
4882
     * @return bool
4883
     * @since 1.7.9
4884
     */
4885
    public function delete_template ( $params ) {
4886
        $params = (object) $params;
4887
        $params->type = 'template';
4888
        return $this->delete_object( $params );
4889
    }
4890
4891
    /**
4892
     * @see PodsAPI::delete_object
4893
     *
4894
     * Drop a Pod Page
4895
     *
4896
     * $params['id'] int The page ID
4897
     * $params['uri'] string The page URI
4898
     *
4899
     * @param array $params An associative array of parameters
4900
     *
4901
     * @return bool
4902
     * @since 1.7.9
4903
     */
4904
    public function delete_page ( $params ) {
4905
        $params = (object) $params;
4906
        if ( isset( $params->uri ) ) {
4907
            $params->name = $params->uri;
4908
            unset( $params->uri );
4909
        }
4910
        if ( isset( $params->name ) )
4911
            $params->name = trim( $params->name, '/' );
4912
        $params->type = 'page';
4913
        return $this->delete_object( $params );
4914
    }
4915
4916
    /**
4917
     * @see PodsAPI::delete_object
4918
     *
4919
     * Drop a Pod Helper
4920
     *
4921
     * $params['id'] int The helper ID
4922
     * $params['name'] string The helper name
4923
     *
4924
     * @param array $params An associative array of parameters
4925
     *
4926
     * @return bool
4927
     * @since 1.7.9
4928
     */
4929
    public function delete_helper ( $params ) {
4930
        $params = (object) $params;
4931
        $params->type = 'helper';
4932
        return $this->delete_object( $params );
4933
    }
4934
4935
    /**
4936
     * Drop a single pod item
4937
     *
4938
     * $params['id'] int (optional) The item's ID from the wp_pod_* table (used with datatype parameter)
4939
     * $params['pod'] string (optional) The Pod name (used with id parameter)
4940
     * $params['pod_id'] int (optional) The Pod ID (used with id parameter)
4941
     * $params['bypass_helpers'] bool Set to true to bypass running pre-save and post-save helpers
4942
     *
4943
     * @param array $params An associative array of parameters
4944
     * @param bool $wp Whether to run WP object delete action
4945
     *
4946
     * @return bool
4947
     * @since 1.7.9
4948
     */
4949
    public function delete_pod_item ( $params, $wp = true ) {
4950
        $params = (object) pods_sanitize( $params );
4951
4952
        // @deprecated 2.0
4953
        if ( isset( $params->datatype_id ) || isset( $params->datatype ) || isset( $params->tbl_row_id ) ) {
4954
            if ( isset( $params->tbl_row_id ) ) {
4955
                pods_deprecated( __( '$params->id instead of $params->tbl_row_id', 'pods' ), '2.0' );
4956
                $params->id = $params->tbl_row_id;
4957
                unset( $params->tbl_row_id );
4958
            }
4959
4960 View Code Duplication
            if ( isset( $params->pod_id ) ) {
4961
                pods_deprecated( __( '$params->id instead of $params->pod_id', 'pods' ), '2.0' );
4962
                $params->id = $params->pod_id;
4963
                unset( $params->pod_id );
4964
            }
4965
4966 View Code Duplication
            if ( isset( $params->dataype_id ) ) {
4967
                pods_deprecated( __( '$params->pod_id instead of $params->datatype_id', 'pods' ), '2.0' );
4968
                $params->pod_id = $params->dataype_id;
4969
                unset( $params->dataype_id );
4970
            }
4971
4972
            if ( isset( $params->datatype ) ) {
4973
                pods_deprecated( __( '$params->pod instead of $params->datatype', 'pods' ), '2.0' );
4974
                $params->pod = $params->datatype;
4975
                unset( $params->datatype );
4976
            }
4977
        }
4978
4979
        if ( !isset( $params->id ) )
4980
            return pods_error( __( 'Pod Item not found', 'pods' ), $this );
4981
4982
        $params->id = pods_absint( $params->id );
4983
4984
        if ( !isset( $params->pod ) )
4985
            $params->pod = '';
4986
4987
        if ( !isset( $params->pod_id ) )
4988
            $params->pod_id = 0;
4989
4990
        $pod = $this->load_pod( array( 'name' => $params->pod, 'id' => $params->pod_id, 'table_info' => false ) );
4991
4992
        if ( false === $pod )
4993
            return pods_error( __( 'Pod not found', 'pods' ), $this );
4994
4995
        $params->pod_id = $pod[ 'id' ];
4996
        $params->pod = $pod[ 'name' ];
4997
4998
        // Allow Helpers to bypass subsequent helpers in recursive delete_pod_item calls
4999
        $bypass_helpers = false;
5000
5001
        if ( isset( $params->bypass_helpers ) && false !== $params->bypass_helpers )
5002
            $bypass_helpers = true;
5003
5004
        $pre_delete_helpers = $post_delete_helpers = array();
5005
5006
        if ( false === $bypass_helpers ) {
5007
            // Plugin hook
5008
            $this->do_hook( 'pre_delete_pod_item', $params, $pod );
5009
            $this->do_hook( "pre_delete_pod_item_{$params->pod}", $params, $pod );
5010
5011
            // Call any pre-save helpers (if not bypassed)
5012 View Code Duplication
            if ( !defined( 'PODS_DISABLE_EVAL' ) || !PODS_DISABLE_EVAL ) {
5013
                if ( !empty( $pod[ 'options' ] ) && is_array( $pod[ 'options' ] ) ) {
5014
                    $helpers = array( 'pre_delete_helpers', 'post_delete_helpers' );
5015
5016
                    foreach ( $helpers as $helper ) {
5017
                        if ( isset( $pod[ 'options' ][ $helper ] ) && !empty( $pod[ 'options' ][ $helper ] ) )
0 ignored issues
show
Unused Code introduced by
This if statement is empty and can be removed.

This check looks for the bodies of if statements that have no statements or where all statements have been commented out. This may be the result of changes for debugging or the code may simply be obsolete.

These if bodies can be removed. If you have an empty if but statements in the else branch, consider inverting the condition.

if (rand(1, 6) > 3) {
//print "Check failed";
} else {
    print "Check succeeded";
}

could be turned into

if (rand(1, 6) <= 3) {
    print "Check succeeded";
}

This is much more concise to read.

Loading history...
5018
                            ${$helper} = explode( ',', $pod[ 'options' ][ $helper ] );
5019
                    }
5020
                }
5021
5022
                if ( !empty( $pre_delete_helpers ) ) {
5023
                    pods_deprecated( sprintf( __( 'Pre-delete helpers are deprecated, use the action pods_pre_delete_pod_item_%s instead', 'pods' ), $params->pod ), '2.0' );
5024
5025
                    foreach ( $pre_delete_helpers as $helper ) {
5026
                        $helper = $this->load_helper( array( 'name' => $helper ) );
5027
5028
                        if ( false !== $helper )
5029
                            eval( '?>' . $helper[ 'code' ] );
0 ignored issues
show
Coding Style introduced by
It is generally not recommended to use eval unless absolutely required.

On one hand, eval might be exploited by malicious users if they somehow manage to inject dynamic content. On the other hand, with the emergence of faster PHP runtimes like the HHVM, eval prevents some optimization that they perform.

Loading history...
5030
                    }
5031
                }
5032
            }
5033
        }
5034
5035
        // Delete object from relationship fields
5036
        $this->delete_object_from_relationships( $params->id, $pod );
5037
5038
        if ( 'table' == $pod[ 'storage' ] )
5039
            pods_query( "DELETE FROM `@wp_pods_{$params->pod}` WHERE `id` = {$params->id} LIMIT 1" );
5040
5041
        if ( $wp ) {
5042
            if ( 'taxonomy' == $pod['type'] ) {
5043
                $taxonomy = $pod['name'];
5044
5045
                if ( ! empty( $pod['object'] ) ) {
5046
                    $taxonomy = $pod['object'];
5047
                }
5048
5049
                wp_delete_term( $params->id, $taxonomy );
5050
            } elseif ( ! in_array( $pod['type'], array( 'pod', 'table', '', 'taxonomy' ) ) ) {
5051
                $this->delete_wp_object( $pod['type'], $params->id );
5052
            }
5053
        }
5054
5055
        if ( false === $bypass_helpers ) {
5056
            // Plugin hook
5057
            $this->do_hook( 'post_delete_pod_item', $params, $pod );
5058
            $this->do_hook( "post_delete_pod_item_{$params->pod}", $params, $pod );
5059
5060
            // Call any post-save helpers (if not bypassed)
5061 View Code Duplication
            if ( !defined( 'PODS_DISABLE_EVAL' ) || !PODS_DISABLE_EVAL ) {
5062
                if ( !empty( $post_delete_helpers ) ) {
5063
                    pods_deprecated( sprintf( __( 'Post-delete helpers are deprecated, use the action pods_post_delete_pod_item_%s instead', 'pods' ), $params->pod ), '2.0' );
5064
5065
                    foreach ( $post_delete_helpers as $helper ) {
5066
                        $helper = $this->load_helper( array( 'name' => $helper ) );
5067
5068
                        if ( false !== $helper )
5069
                            eval( '?>' . $helper[ 'code' ] );
0 ignored issues
show
Coding Style introduced by
It is generally not recommended to use eval unless absolutely required.

On one hand, eval might be exploited by malicious users if they somehow manage to inject dynamic content. On the other hand, with the emergence of faster PHP runtimes like the HHVM, eval prevents some optimization that they perform.

Loading history...
5070
                    }
5071
                }
5072
            }
5073
        }
5074
5075
        pods_cache_clear( $params->id, 'pods_items_' . $params->pod );
5076
5077
        return true;
5078
    }
5079
5080
    /**
5081
     * Delete an object from tableless fields
5082
     *
5083
     * @param int $id
5084
     * @param string $type
0 ignored issues
show
Bug introduced by
There is no parameter named $type. Was it maybe removed?

This check looks for PHPDoc comments describing methods or function parameters that do not exist on the corresponding method or function.

Consider the following example. The parameter $italy is not defined by the method finale(...).

/**
 * @param array $germany
 * @param array $island
 * @param array $italy
 */
function finale($germany, $island) {
    return "2:1";
}

The most likely cause is that the parameter was removed, but the annotation was not.

Loading history...
5085
     * @param string $name
5086
     *
5087
     * @return bool
5088
     *
5089
     * @since 2.3
5090
     */
5091
    public function delete_object_from_relationships ( $id, $object, $name = null ) {
5092
        /**
5093
         * @var $pods_init \PodsInit
5094
         */
5095
        global $pods_init;
0 ignored issues
show
Compatibility Best Practice introduced by
Use of global functionality is not recommended; it makes your code harder to test, and less reusable.

Instead of relying on global state, we recommend one of these alternatives:

1. Pass all data via parameters

function myFunction($a, $b) {
    // Do something
}

2. Create a class that maintains your state

class MyClass {
    private $a;
    private $b;

    public function __construct($a, $b) {
        $this->a = $a;
        $this->b = $b;
    }

    public function myFunction() {
        // Do something
    }
}
Loading history...
5096
5097
        $pod = false;
5098
5099
        // Run any bidirectional delete operations
5100
        if ( is_array( $object ) )
5101
            $pod = $object;
5102
        elseif ( is_object( $pods_init ) )
5103
            $pod = PodsInit::$meta->get_object( $object, $name );
0 ignored issues
show
Bug introduced by
The property meta cannot be accessed from this context as it is declared private in class PodsInit.

This check looks for access to properties that are not accessible from the current context.

If you need to make a property accessible to another context you can either raise its visibility level or provide an accessible getter in the defining class.

Loading history...
5104
5105
        if ( !empty( $pod ) ) {
5106
            $object = $pod[ 'type' ];
5107
            $name = $pod[ 'name' ];
5108
5109
            foreach ( $pod[ 'fields' ] as $field ) {
5110
                PodsForm::delete( $field[ 'type' ], $id, $field[ 'name' ], array_merge( $field, $field[ 'options' ] ), $pod );
5111
            }
5112
        }
5113
5114
        // Lookup related fields (non-bidirectional)
5115
        $params = array(
5116
            'where' => array(
5117
                array(
5118
                    'key' => 'type',
5119
                    'value' => 'pick'
5120
                ),
5121
                array(
5122
                    'key' => 'pick_object',
5123
                    'value' => $object
5124
                )
5125
            )
5126
        );
5127
5128
        if ( !empty( $name ) && $name != $object ) {
5129
            $params[ 'where' ][] = array(
5130
                'key' => 'pick_val',
5131
                'value' => $name
5132
            );
5133
        }
5134
5135
        $fields = $this->load_fields( $params, false );
5136
5137
        if ( !empty( $pod ) && 'media' == $pod[ 'type' ] ) {
5138
            $params[ 'where' ] = array(
5139
                array(
5140
                    'key' => 'type',
5141
                    'value' => 'file'
5142
                )
5143
            );
5144
5145
            $fields = array_merge( $fields, $this->load_fields( $params, false ) );
5146
        }
5147
5148
        if ( is_array( $fields ) && !empty( $fields ) ) {
5149
            foreach ( $fields as $related_field ) {
5150
                $related_pod = $this->load_pod( array( 'id' => $related_field[ 'pod_id' ], 'fields' => false ), false );
5151
5152
                if ( empty( $related_pod ) )
5153
                    continue;
5154
5155
                $related_from = $this->lookup_related_items_from( $related_field[ 'id' ], $related_pod[ 'id' ], $id, $related_field, $related_pod );
5156
5157
                $this->delete_relationships( $related_from, $id, $related_pod, $related_field );
5158
            }
5159
        }
5160
5161
        if ( !empty( $pod ) && !pods_tableless() ) {
5162
            pods_query( "
5163
                DELETE FROM `@wp_podsrel`
5164
                WHERE
5165
                (
5166
                    `pod_id` = %d
5167
                    AND `item_id` = %d
5168
                )
5169
                OR (
5170
                    `related_pod_id` = %d
5171
                    AND `related_item_id` = %d
5172
                )
5173
            ", array(
5174
                $pod[ 'id' ],
5175
                $id,
5176
5177
                $pod[ 'id' ],
5178
                $id
5179
            ) );
5180
        }
5181
5182
        return true;
5183
    }
5184
5185
    /**
5186
     * Delete relationships
5187
     *
5188
     * @param int|array $related_id IDs for items to save
5189
     * @param int|array $id ID or IDs to remove
5190
     * @param array $related_pod Pod data
5191
     * @param array $related_field Field data
5192
     *
5193
     * @return void
5194
     *
5195
     * @since 2.3
5196
     */
5197
    public function delete_relationships ( $related_id, $id, $related_pod, $related_field ) {
5198
        if ( is_array( $related_id ) ) {
5199
            foreach ( $related_id as $rid ) {
5200
                $this->delete_relationships( $rid, $id, $related_pod, $related_field );
5201
            }
5202
5203
            return;
5204
        }
5205
5206
        if ( is_array( $id ) ) {
5207
            foreach ( $id as $rid ) {
5208
                $this->delete_relationships( $related_id, $rid, $related_pod, $related_field );
5209
            }
5210
5211
            return;
5212
        }
5213
5214
        $id = (int) $id;
5215
5216
        if ( empty( $id ) )
5217
            return;
5218
5219
        $related_ids = $this->lookup_related_items( $related_field[ 'id' ], $related_pod[ 'id' ], $related_id, $related_field, $related_pod );
5220
5221
        if ( empty( $related_ids ) )
5222
            return;
5223
        elseif ( !in_array( $id, $related_ids ) )
5224
            return;
5225
5226
	    if ( isset( self::$related_item_cache[ $related_pod[ 'id' ] ][ $related_field[ 'id' ] ] ) ) {
5227
		    // Delete relationship from cache
5228
		    unset( self::$related_item_cache[ $related_pod[ 'id' ] ][ $related_field[ 'id' ] ] );
5229
	    }
5230
        unset( $related_ids[ array_search( $id, $related_ids ) ] );
5231
5232
        $no_conflict = pods_no_conflict_check( $related_pod[ 'type' ] );
5233
5234
        if ( !$no_conflict )
5235
            pods_no_conflict_on( $related_pod[ 'type' ] );
5236
5237
        // Post Types, Media, Users, and Comments (meta-based)
5238 View Code Duplication
        if ( in_array( $related_pod[ 'type' ], array( 'post_type', 'media', 'taxonomy', 'user', 'comment' ) ) ) {
5239
            $object_type = $related_pod[ 'type' ];
5240
5241
            if ( in_array( $object_type, array( 'post_type', 'media' ) ) )
5242
                $object_type = 'post';
5243
            elseif ( 'taxonomy' == $object_type )
5244
                $object_type = 'term';
5245
5246
            delete_metadata( $object_type, $related_id, $related_field[ 'name' ] );
5247
5248
            if ( !empty( $related_ids ) ) {
5249
                update_metadata( $object_type, $related_id, '_pods_' . $related_field[ 'name' ], $related_ids );
5250
5251
                foreach ( $related_ids as $rel_id ) {
5252
                    add_metadata( $object_type, $related_id, $related_field[ 'name' ], $rel_id );
5253
                }
5254
            }
5255
            else
5256
                delete_metadata( $object_type, $related_id, '_pods_' . $related_field[ 'name' ] );
5257
        }
5258
        // Custom Settings Pages (options-based)
5259
        elseif ( 'settings' == $related_pod[ 'type' ] ) {
5260
            if ( !empty( $related_ids ) )
5261
                update_option( $related_pod[ 'name' ] . '_' . $related_field[ 'name' ], $related_ids );
5262
            else
5263
                delete_option( $related_pod[ 'name' ] . '_' . $related_field[ 'name' ] );
5264
        }
5265
5266
        // Relationships table
5267
        if ( !pods_tableless() ) {
5268
            pods_query( "
5269
                DELETE FROM `@wp_podsrel`
5270
                WHERE
5271
                (
5272
                    `pod_id` = %d
5273
                    AND `field_id` = %d
5274
                    AND `item_id` = %d
5275
                    AND `related_item_id` = %d
5276
                )
5277
                OR (
5278
                    `related_pod_id` = %d
5279
                    AND `related_field_id` = %d
5280
                    AND `related_item_id` = %d
5281
                    AND `item_id` = %d
5282
                )
5283
            ", array(
5284
                $related_pod[ 'id' ],
5285
                $related_field[ 'id' ],
5286
                $related_id,
5287
                $id,
5288
5289
                $related_pod[ 'id' ],
5290
                $related_field[ 'id' ],
5291
                $related_id,
5292
                $id
5293
            ) );
5294
        }
5295
5296
        if ( !$no_conflict )
5297
            pods_no_conflict_off( $related_pod[ 'type' ] );
5298
    }
5299
5300
    /**
5301
     * Check if a Pod exists
5302
     *
5303
     * $params['id'] int Pod ID
5304
     * $params['name'] string Pod name
5305
     *
5306
     * @param array $params An associative array of parameters
5307
     *
5308
     * @return bool True if exists
5309
     *
5310
     * @since 1.12
5311
     */
5312
    public function pod_exists ( $params, $type = null ) {
5313
        if ( is_string( $params ) )
5314
            $params = array( 'name' => $params );
5315
5316
        $params = (object) pods_sanitize( $params );
5317
5318
        if ( !empty( $params->id ) || !empty( $params->name ) ) {
5319
            if ( !isset( $params->name ) )
5320
                $pod = get_post( $dummy = (int) $params->id );
5321
            else {
5322
                $pod = get_posts( array(
5323
                    'name' => $params->name,
5324
                    'post_type' => '_pods_pod',
5325
                    'posts_per_page' => 1
5326
                ) );
5327
                if ( is_array( $pod ) ) {
5328
                    $pod = $pod[0];
5329
                }
5330
            }
5331
5332
            if ( !empty( $pod ) && ( empty( $type ) || $type == get_post_meta( $pod->ID, 'type', true ) ) )
5333
                return true;
5334
        }
5335
5336
        return false;
5337
    }
5338
5339
	/**
5340
	 * Get number of pods for a specific pod type
5341
	 *
5342
	 * @param string $type Type to get count
5343
	 *
5344
	 * @return int Total number of pods for a type
5345
	 *
5346
	 * @since 2.6.6
5347
	 */
5348
	public function get_pod_type_count( $type ) {
5349
5350
		$args = array(
5351
			'post_type'      => '_pods_pod',
5352
			'posts_per_page' => - 1,
5353
			'nopaging'       => true,
5354
			'fields'         => 'ids',
5355
			'meta_query'     => array(
5356
				array(
5357
					'key'   => 'type',
5358
					'value' => $type,
5359
				),
5360
			),
5361
		);
5362
5363
		$posts = get_posts( $args );
5364
5365
		$total = count( $posts );
5366
5367
		return $total;
5368
5369
	}
5370
5371
    /**
5372
     * Load a Pod and all of its fields
5373
     *
5374
     * $params['id'] int The Pod ID
5375
     * $params['name'] string The Pod name
5376
     * $params['fields'] bool Whether to load fields (default is true)
5377
     * $params['bypass_cache'] boolean Bypass the cache when getting data
5378
     *
5379
     * @param array|object $params An associative array of parameters or pod name as a string
5380
     * @param bool $strict Makes sure the pod exists, throws an error if it doesn't work
5381
     *
5382
     * @return array|bool|mixed|void
5383
     * @since 1.7.9
5384
     */
5385
    public function load_pod ( $params, $strict = true ) {
5386
5387
        /**
5388
         * @var $sitepress SitePress
5389
		 * @var $wpdb wpdb
5390
         */
5391
        global $wpdb;
0 ignored issues
show
Compatibility Best Practice introduced by
Use of global functionality is not recommended; it makes your code harder to test, and less reusable.

Instead of relying on global state, we recommend one of these alternatives:

1. Pass all data via parameters

function myFunction($a, $b) {
    // Do something
}

2. Create a class that maintains your state

class MyClass {
    private $a;
    private $b;

    public function __construct($a, $b) {
        $this->a = $a;
        $this->b = $b;
    }

    public function myFunction() {
        // Do something
    }
}
Loading history...
5392
5393
        $current_language = false;
5394
        $load_fields = true;
5395
	    $bypass_cache = false;
5396
5397
	    // Get current language data
5398
		$lang_data = self::get_current_language();
5399
5400
	    if ( $lang_data ) {
0 ignored issues
show
Bug Best Practice introduced by
The expression $lang_data of type array is implicitly converted to a boolean; are you sure this is intended? If so, consider using ! empty($expr) instead to make it clear that you intend to check for an array without elements.

This check marks implicit conversions of arrays to boolean values in a comparison. While in PHP an empty array is considered to be equal (but not identical) to false, this is not always apparent.

Consider making the comparison explicit by using empty(..) or ! empty(...) instead.

Loading history...
5401
		    if ( ! empty( $lang_data['language'] ) ) {
5402
			    $current_language = $lang_data['language'];
5403
		    }
5404
	    }
5405
5406
        if ( !is_array( $params ) && !is_object( $params ) )
5407
            $params = array( 'name' => $params, 'table_info' => false, 'fields' => true );
5408
5409
        if ( is_object( $params ) && ! is_a( $params, 'WP_Post' ) && isset( $params->fields ) && !$params->fields )
5410
            $load_fields = false;
5411
        elseif ( is_array( $params ) && isset( $params[ 'fields' ] ) && !$params[ 'fields' ] )
5412
            $load_fields = false;
5413
5414
	    $table_info = false;
5415
5416
        if ( is_object( $params ) && ! is_a( $params, 'WP_Post' ) && ! empty( $params->table_info ) )
5417
            $table_info = true;
5418
        elseif ( is_array( $params ) && ! empty( $params[ 'table_info' ] ) )
5419
            $table_info = true;
5420
5421
        $transient = 'pods_' . $wpdb->prefix . '_pod';
5422
5423
        if ( !empty( $current_language ) )
5424
            $transient .= '_' . $current_language;
5425
5426
        if ( !$load_fields )
5427
            $transient .= '_nofields';
5428
5429
        if ( $table_info )
5430
            $transient .= '_tableinfo';
5431
5432
	    $check_pod = $params;
5433
5434
	    if ( is_object( $params ) && ! is_a( $params, 'WP_Post' ) && ! empty( $params->pod ) ) {
5435
		    $check_pod = $params->pod;
5436
	    } elseif ( is_array( $params ) && ! empty( $params['pod'] ) ) {
5437
		    $check_pod = $params['pod'];
5438
	    }
5439
5440
        if ( is_object( $check_pod ) && ( is_a( $check_pod, 'WP_Post' ) || isset( $check_pod->post_name ) ) ) {
5441
            $pod = false;
5442
5443
            if ( pods_api_cache() )
5444
                $pod = pods_transient_get( $transient . '_' . $check_pod->post_name );
5445
5446 View Code Duplication
            if ( false !== $pod && ( ! $table_info || isset( $pod[ 'table' ] ) ) ) {
5447
	            // @todo Is this needed anymore for WPML?
5448
                if ( in_array( $pod[ 'type' ], array( 'post_type', 'taxonomy' ) )
5449
                     && did_action( 'wpml_loaded' )
5450
                     && apply_filters( 'wpml_setting', true, 'auto_adjust_ids' ) ) {
5451
                    $pod = array_merge( $pod, $this->get_table_info( $pod['type'], $pod['object'], $pod['name'], $pod ) );
5452
                }
5453
5454
                return $pod;
5455
            }
5456
5457
            $_pod = get_object_vars( $check_pod );
5458
        }
5459
        else {
5460
            $params = (object) pods_sanitize( $params );
5461
5462 View Code Duplication
            if ( ( !isset( $params->id ) || empty( $params->id ) ) && ( !isset( $params->name ) || empty( $params->name ) ) ) {
5463
                if ( $strict ) {
5464
	                  return pods_error( 'Either Pod ID or Name are required', $this );
5465
                }
5466
5467
                return false;
5468
            }
5469
5470
		    if ( ! empty( $params->bypass_cache ) ) {
5471
		        $bypass_cache = true;
5472
		    }
5473
5474
            if ( isset( $params->name ) ) {
5475
                $pod = false;
5476
5477
				if ( '_pods_pod' == $params->name ) {
5478
					$pod = array(
5479
						'id' => 0,
5480
						'name' => $params->name,
5481
						'label' => __( 'Pods', 'pods' ),
5482
						'type' => 'post_type',
5483
						'storage' => 'meta',
5484
						'options' => array(
5485
							'label_singular' => __( 'Pod', 'pods' )
5486
						),
5487
						'fields' => array()
5488
					);
5489
				}
5490
				elseif ( '_pods_field' == $params->name ) {
5491
					$pod = array(
5492
						'id' => 0,
5493
						'name' => $params->name,
5494
						'label' => __( 'Pod Fields', 'pods' ),
5495
						'type' => 'post_type',
5496
						'storage' => 'meta',
5497
						'options' => array(
5498
							'label_singular' => __( 'Pod Field', 'pods' )
5499
						),
5500
						'fields' => array()
5501
					);
5502
				}
5503 View Code Duplication
                elseif ( ! $bypass_cache & pods_api_cache() )
5504
                    $pod = pods_transient_get( $transient . '_' . $params->name );
5505
5506 View Code Duplication
                if ( false !== $pod && ( ! $table_info || isset( $pod[ 'table' ] ) ) ) {
5507
                    if ( in_array( $pod[ 'type' ], array( 'post_type', 'taxonomy' ) ) && did_action( 'wpml_loaded' )
5508
                        && apply_filters( 'wpml_setting', true, 'auto_adjust_ids' ) )
5509
                        $pod = array_merge( $pod, $this->get_table_info( $pod[ 'type' ], $pod[ 'object' ], $pod[ 'name' ], $pod ) );
5510
5511
                    return $pod;
5512
                }
5513
            }
5514
5515 View Code Duplication
            if ( !isset( $params->name ) )
5516
                $pod = get_post( $dummy = (int) $params->id );
5517
            else {
5518
                $pod = get_posts( array(
5519
                    'name' => $params->name,
5520
                    'post_type' => '_pods_pod',
5521
                    'posts_per_page' => 1
5522
                ) );
5523
            }
5524
5525
            if ( empty( $pod ) ) {
5526
                if ( $strict )
5527
                    return pods_error( __( 'Pod not found', 'pods' ), $this );
5528
5529
                return false;
5530
            }
5531
5532
            if ( is_array( $pod ) )
5533
                $pod = $pod[ 0 ];
5534
5535
            $_pod = get_object_vars( $pod );
5536
        }
5537
5538
        $pod = false;
5539
5540 View Code Duplication
        if ( ! $bypass_cache || pods_api_cache() )
5541
            $pod = pods_transient_get( $transient . '_' . $_pod[ 'post_name' ] );
5542
5543 View Code Duplication
        if ( false !== $pod && ( ! $table_info || isset( $pod[ 'table' ] ) ) ) {
5544
            if ( in_array( $pod[ 'type' ], array( 'post_type', 'taxonomy' ) )
5545
                 && did_action( 'wpml_loaded' )
5546
                && apply_filters( 'wpml_setting', true, 'auto_adjust_ids' ) ) {
5547
	            $pod = array_merge( $pod, $this->get_table_info( $pod['type'], $pod['object'], $pod['name'], $pod ) );
5548
            }
5549
5550
            return $pod;
5551
        }
5552
5553
        $pod = array(
5554
            'id' => $_pod[ 'ID' ],
5555
            'name' => $_pod[ 'post_name' ],
5556
            'label' => $_pod[ 'post_title' ],
5557
            'description' => $_pod[ 'post_content' ]
5558
        );
5559
5560
        if ( strlen( $pod[ 'label' ] ) < 1 )
5561
            $pod[ 'label' ] = $pod[ 'name' ];
5562
5563
        // @todo update with a method to put all options in
5564
        $defaults = array(
5565
            'show_in_menu' => 1,
5566
            'type' => 'post_type',
5567
            'storage' => 'meta',
5568
            'object' => '',
5569
            'alias' => ''
5570
        );
5571
5572
        if ( $bypass_cache ) {
5573
            wp_cache_delete( $pod['id'], 'post_meta' );
5574
5575
            update_postmeta_cache( array( $pod['id'] ) );
5576
        }
5577
5578
        $pod[ 'options' ] = get_post_meta( $pod[ 'id' ] );
5579
5580 View Code Duplication
        foreach ( $pod[ 'options' ] as $option => $value ) {
5581
            if ( is_array( $value ) ) {
5582
                foreach ( $value as $k => $v ) {
5583
                    if ( !is_array( $v ) )
5584
                        $value[ $k ] = maybe_unserialize( $v );
5585
                }
5586
5587
                if ( 1 == count( $value ) )
5588
                    $value = current( $value );
5589
            }
5590
            else
5591
                $value = maybe_unserialize( $value );
5592
5593
            $pod[ 'options' ][ $option ] = $value;
5594
        }
5595
5596
        $pod[ 'options' ] = array_merge( $defaults, $pod[ 'options' ] );
5597
5598
        $pod[ 'type' ] = $pod[ 'options' ][ 'type' ];
5599
        $pod[ 'storage' ] = $pod[ 'options' ][ 'storage' ];
5600
        $pod[ 'object' ] = $pod[ 'options' ][ 'object' ];
5601
        $pod[ 'alias' ] = $pod[ 'options' ][ 'alias' ];
5602
5603
        unset( $pod[ 'options' ][ 'type' ] );
5604
        unset( $pod[ 'options' ][ 'storage' ] );
5605
        unset( $pod[ 'options' ][ 'object' ] );
5606
        unset( $pod[ 'options' ][ 'alias' ] );
5607
5608
        if ( $table_info )
5609
            $pod = array_merge( $this->get_table_info( $pod[ 'type' ], $pod[ 'object' ], $pod[ 'name' ], $pod ), $pod );
5610
5611
        // Override old 'none' storage type
5612 View Code Duplication
        if ( 'taxonomy' == $pod['type'] && 'none' == $pod['storage'] && function_exists( 'get_term_meta' ) ) {
5613
            $pod[ 'storage' ] = 'meta';
5614
        }
5615
5616
        if ( isset( $pod[ 'pod' ] ) )
5617
            unset( $pod[ 'pod' ] );
5618
5619
        $pod[ 'fields' ] = array();
5620
5621
        $pod[ 'object_fields' ] = array();
5622
5623
        if ( 'pod' != $pod[ 'type' ] )
5624
            $pod[ 'object_fields' ] = $this->get_wp_object_fields( $pod[ 'type' ], $pod );
5625
5626
        $fields = get_posts( array(
5627
            'post_type' => '_pods_field',
5628
            'posts_per_page' => -1,
5629
            'nopaging' => true,
5630
            'post_parent' => $pod[ 'id' ],
5631
            'orderby' => 'menu_order',
5632
            'order' => 'ASC'
5633
        ) );
5634
5635
        if ( !empty( $fields ) ) {
5636
            foreach ( $fields as $field ) {
5637
                $field->pod = $pod[ 'name' ];
5638
                $field->table_info = $table_info;
5639
                $field->bypass_cache = $bypass_cache;
5640
5641
                if ( $load_fields ) {
5642
                    $field = $this->load_field( $field );
5643
5644
                    $field = PodsForm::field_setup( $field, null, $field[ 'type' ] );
5645
                }
5646
                else {
5647
			        if ( $bypass_cache ) {
5648
                        wp_cache_delete( $field->ID, 'post_meta' );
5649
5650
			            update_postmeta_cache( array( $field->ID ) );
5651
			        }
5652
5653
                    $field = array(
5654
                        'id' => $field->ID,
5655
                        'name' => $field->post_name,
5656
                        'label' => $field->post_title,
5657
                        'type' => get_post_meta( $field->ID, 'type', true )
5658
                    );
5659
                }
5660
5661
                $pod[ 'fields' ][ $field[ 'name' ] ] = $field;
5662
            }
5663
        }
5664
5665 View Code Duplication
        if ( did_action( 'init' ) && pods_api_cache() )
5666
            pods_transient_set( $transient . '_' . $pod[ 'name' ], $pod );
5667
5668
        return $pod;
5669
    }
5670
5671
    /**
5672
     * Load a list of Pods based on filters specified.
5673
     *
5674
     * $params['type'] string/array Pod Type(s) to filter by
5675
     * $params['object'] string/array Pod Object(s) to filter by
5676
     * $params['options'] array Pod Option(s) key=>value array to filter by
5677
     * $params['orderby'] string ORDER BY clause of query
5678
     * $params['limit'] string Number of Pods to return
5679
     * $params['where'] string WHERE clause of query
5680
     * $params['ids'] string|array IDs of Objects
5681
     * $params['count'] boolean Return only a count of Pods
5682
     * $params['names'] boolean Return only an array of name => label
5683
     * $params['ids'] boolean Return only an array of ID => label
5684
     * $params['fields'] boolean Return pod fields with Pods (default is true)
5685
     * $params['key_names'] boolean Return pods keyed by name
5686
     * $params['bypass_cache'] boolean Bypass the cache when getting data
5687
     *
5688
     * @param array $params An associative array of parameters
5689
     *
5690
     * @return array|mixed
5691
     *
5692
     * @uses PodsAPI::load_pod
5693
     *
5694
     * @since 2.0
5695
     */
5696
    public function load_pods ( $params = null ) {
5697
5698
        $current_language = false;
5699
5700
	    // Get current language data
5701
		$lang_data = self::get_current_language();
5702
5703
	    if ( $lang_data ) {
0 ignored issues
show
Bug Best Practice introduced by
The expression $lang_data of type array is implicitly converted to a boolean; are you sure this is intended? If so, consider using ! empty($expr) instead to make it clear that you intend to check for an array without elements.

This check marks implicit conversions of arrays to boolean values in a comparison. While in PHP an empty array is considered to be equal (but not identical) to false, this is not always apparent.

Consider making the comparison explicit by using empty(..) or ! empty(...) instead.

Loading history...
5704
		    if ( ! empty( $lang_data['language'] ) ) {
5705
			    $current_language = $lang_data['language'];
5706
		    }
5707
	    }
5708
5709
        $params = (object) pods_sanitize( $params );
5710
5711
        $order = 'ASC';
5712
        $orderby = 'menu_order title';
5713
        $limit = -1;
5714
        $ids = false;
5715
5716
        $meta_query = array();
5717
        $cache_key = '';
5718
5719
        $bypass_cache = false;
5720
5721
	    if ( ! empty( $params->bypass_cache ) ) {
5722
	    	$bypass_cache = true;
5723
	    }
5724
5725
        if ( isset( $params->type ) && !empty( $params->type ) ) {
5726
            if ( !is_array( $params->type ) )
5727
                $params->type = array( trim( $params->type ) );
5728
5729
            sort( $params->type );
5730
5731
            $meta_query[] = array(
5732
                'key' => 'type',
5733
                'value' => $params->type,
5734
                'compare' => 'IN'
5735
            );
5736
5737
            if ( 0 < count( $params->type ) )
5738
                $cache_key .= '_type_' . trim( implode( '_', $params->type ) );
5739
        }
5740
5741
        if ( isset( $params->object ) && !empty( $params->object ) ) {
5742
            if ( !is_array( $params->object ) )
5743
                $params->object = array( $params->object );
5744
5745
            $params->object = pods_trim( $params->object );
5746
5747
            sort( $params->object );
5748
5749
            $meta_query[] = array(
5750
                'key' => 'object',
5751
                'value' => $params->object,
5752
                'compare' => 'IN'
5753
            );
5754
5755
            if ( 1 == count( $params->object ) )
5756
                $cache_key .= '_object_' . trim( implode( '', $params->object ) );
5757
        }
5758
5759 View Code Duplication
        if ( isset( $params->options ) && !empty( $params->options ) && is_array( $params->options ) ) {
5760
            foreach ( $params->options as $option => $value ) {
5761
                if ( !is_array( $value ) )
5762
                    $value = array( $value );
5763
5764
                $value = pods_trim( $value );
5765
5766
                sort( $value );
5767
5768
                $meta_query[] = array(
5769
                    'key' => $option,
5770
                    'value' => pods_sanitize( $value ),
5771
                    'compare' => 'IN'
5772
                );
5773
            }
5774
5775
            $cache_key = '';
5776
        }
5777
5778
        if ( isset( $params->where ) && is_array( $params->where ) )
5779
            $meta_query = array_merge( $meta_query, (array) $params->where );
5780
5781 View Code Duplication
        if ( isset( $params->order ) && !empty( $params->order ) && in_array( strtoupper( $params->order ), array( 'ASC', 'DESC' ) ) )
5782
            $order = strtoupper( $params->order );
5783
5784
        if ( isset( $params->orderby ) && !empty( $params->orderby ) )
5785
            $orderby = strtoupper( $params->orderby );
5786
5787
        if ( isset( $params->limit ) && !empty( $params->limit ) )
5788
            $limit = pods_absint( $params->limit );
5789
5790
        if ( isset( $params->ids ) && !empty( $params->ids ) ) {
5791
            $ids = $params->ids;
5792
5793
            if ( !is_array( $ids ) )
5794
                $ids = explode( ',', $ids );
5795
        }
5796
5797
        if ( empty( $ids ) )
5798
            $ids = false;
5799
5800
        $pre_key = '';
5801
5802
        if ( !empty( $current_language ) )
5803
            $pre_key .= '_' . $current_language;
5804
5805
        if ( isset( $params->count ) && $params->count )
5806
            $pre_key .= '_count';
5807
5808
        if ( isset( $params->ids ) && $params->ids && !empty( $ids ) )
5809
            $pre_key .= '_ids_' . implode( '_', $ids );
5810
5811
        if ( isset( $params->names ) && $params->names )
5812
            $pre_key .= '_names';
5813
        elseif ( isset( $params->names_ids ) && $params->names_ids )
5814
            $pre_key .= '_names_ids';
5815
5816
        if ( isset( $params->key_names ) && $params->key_names )
5817
            $pre_key .= '_namekeys';
5818
5819
        if ( isset( $params->fields ) && !$params->fields )
5820
            $pre_key .= '_nofields';
5821
5822
        if ( isset( $params->table_info ) && $params->table_info )
5823
            $pre_key .= '_tableinfo';
5824
5825
5826
        $pre_key .= '_get';
5827
5828
        if ( empty( $cache_key ) )
5829
            $cache_key = 'pods' . $pre_key . '_all';
5830
        else
5831
            $cache_key = 'pods' . $pre_key . $cache_key;
5832
5833
        if ( ! $bypass_cache && pods_api_cache() && !empty( $cache_key ) && ( 'pods' . ( !empty( $current_language ) ? '_' . $current_language : '' ) . '_get_all' != $cache_key || empty( $meta_query ) ) && $limit < 1 && ( empty( $orderby ) || 'menu_order title' == $orderby ) && empty( $ids ) ) {
5834
            $the_pods = pods_transient_get( $cache_key );
5835
5836
            if ( false === $the_pods )
5837
                $the_pods = pods_cache_get( $cache_key, 'pods' );
5838
5839
            if ( !is_array( $the_pods ) && 'none' == $the_pods )
5840
                return array();
5841
            elseif ( false !== $the_pods )
5842
                return $the_pods;
5843
        }
5844
5845
        $the_pods = array();
5846
5847
		$args = array(
5848
			'post_type' => '_pods_pod',
5849
			'nopaging' => true,
5850
			'posts_per_page' => $limit,
5851
			'order' => $order,
5852
			'orderby' => $orderby,
5853
			'meta_query' => $meta_query,
5854
		);
5855
5856
		// Only set post__in if there are ids to filter (see https://core.trac.wordpress.org/ticket/28099)
5857
		if ( false != $ids ) {
5858
			$args[ 'post__in' ] = $ids;
5859
		}
5860
5861
		$_pods = get_posts( $args );
5862
5863
        $export_ignore = array(
5864
            'object_type',
5865
            'object_name',
5866
            'table',
5867
            'meta_table',
5868
            'pod_table',
5869
            'field_id',
5870
            'field_index',
5871
            'field_slug',
5872
            'field_type',
5873
            'field_parent',
5874
            'field_parent_select',
5875
            'meta_field_id',
5876
            'meta_field_index',
5877
            'meta_field_value',
5878
            'pod_field_id',
5879
            'pod_field_index',
5880
            'object_fields',
5881
            'join',
5882
            'where',
5883
            'where_default',
5884
            'orderby',
5885
            'pod',
5886
            'recurse',
5887
            'table_info',
5888
            'attributes',
5889
            'group',
5890
            'grouped',
5891
            'developer_mode',
5892
            'dependency',
5893
            'depends-on',
5894
            'excludes-on'
5895
        );
5896
5897
        $total_fields = 0;
5898
5899
        if ( isset( $params->count ) && $params->count )
5900
            $the_pods = count( $_pods );
5901
        else {
5902
            foreach ( $_pods as $pod ) {
5903
                if ( isset( $params->names ) && $params->names )
5904
                    $the_pods[ $pod->post_name ] = $pod->post_title;
5905
                elseif ( isset( $params->names_ids ) && $params->names_ids )
5906
                    $the_pods[ $pod->ID ] = $pod->post_name;
5907
                else {
5908
                    if ( isset( $params->fields ) && !$params->fields )
5909
                        $pod->fields = false;
5910
5911
                    $pod = $this->load_pod( array( 'pod' => $pod, 'table_info' => ! empty( $params->table_info ), 'bypass_cache' => $bypass_cache ) );
5912
5913
                    // Remove extra data not needed
5914
                    if ( pods_var( 'export', $params, false ) && ( !isset( $params->fields ) || $params->fields ) ) {
5915
                        foreach ( $export_ignore as $ignore ) {
5916
                            if ( isset( $pod[ $ignore ] ) )
5917
                                unset( $pod[ $ignore ] );
5918
                        }
5919
5920
                        foreach ( $pod[ 'fields' ] as $field => $field_data ) {
5921
                            if ( isset( $pod[ 'fields' ][ $field ][ 'table_info' ] ) )
5922
                                unset( $pod[ 'fields' ][ $field ][ 'table_info' ] );
5923
                        }
5924
                    }
5925
5926
                    $total_fields += count( $pod[ 'fields' ] );
5927
5928
                    if ( isset( $params->key_names ) && $params->key_names )
5929
                        $the_pods[ $pod[ 'name' ] ] = $pod;
5930
                    else
5931
                        $the_pods[ $pod[ 'id' ] ] = $pod;
5932
                }
5933
            }
5934
        }
5935
5936
        if ( ( !function_exists( 'pll_current_language' ) || ( isset( $params->refresh ) && $params->refresh ) ) && !empty( $cache_key ) && ( 'pods' != $cache_key || empty( $meta_query ) ) && $limit < 1 && ( empty( $orderby ) || 'menu_order title' == $orderby ) && empty( $ids ) ) {
5937
            // Too many Pods can cause issues with the DB when caching is not enabled
5938
            if ( 15 < count( $the_pods ) || 75 < count( $total_fields ) ) {
5939
                pods_transient_clear( $cache_key );
5940
5941 View Code Duplication
                if ( pods_api_cache() ) {
5942
                    if ( empty( $the_pods ) && ( !isset( $params->count ) || !$params->count ) )
5943
                        pods_cache_set( $cache_key, 'none', 'pods' );
5944
                    else
5945
                        pods_cache_set( $cache_key, $the_pods, 'pods' );
5946
                }
5947
            }
5948
            else {
5949
                pods_cache_clear( $cache_key, 'pods' );
5950
5951 View Code Duplication
                if ( pods_api_cache() ) {
5952
                    if ( empty( $the_pods ) && ( !isset( $params->count ) || !$params->count ) )
5953
                        pods_transient_set( $cache_key, 'none' );
5954
                    else
5955
                        pods_transient_set( $cache_key, $the_pods );
5956
                }
5957
            }
5958
        }
5959
5960
        return $the_pods;
5961
    }
5962
5963
    /**
5964
     * Check if a Pod's field exists
5965
     *
5966
     * $params['pod_id'] int The Pod ID
5967
     * $params['id'] int The field ID
5968
     * $params['name'] string The field name
5969
     *
5970
     * @param array $params An associative array of parameters
5971
     *
5972
     * @return bool
5973
     *
5974
     * @since 1.12
5975
     */
5976
    public function field_exists ( $params ) {
5977
        $params = (object) pods_sanitize( $params );
5978
5979
        if ( ( !empty( $params->id ) || !empty( $params->name ) ) && isset( $params->pod_id ) && !empty( $params->pod_id ) ) {
5980 View Code Duplication
            if ( !isset( $params->name ) )
5981
                $field = get_post( $dummy = (int) $params->id );
5982
            else {
5983
                $field = get_posts( array(
5984
                    'name' => $params->name,
5985
                    'post_type' => '_pods_field',
5986
                    'posts_per_page' => 1,
5987
                    'post_parent' => $params->pod_id
5988
                ) );
5989
            }
5990
5991
            if ( !empty( $field ) )
5992
                return true;
5993
        }
5994
5995
        return false;
5996
    }
5997
5998
    /**
5999
     * Load a field
6000
     *
6001
     * $params['pod_id'] int The Pod ID
6002
     * $params['pod'] string The Pod name
6003
     * $params['id'] int The field ID
6004
     * $params['name'] string The field name
6005
     * $params['table_info'] boolean Whether to lookup a pick field's table info
6006
     * $params['bypass_cache'] boolean Bypass the cache when getting data
6007
     *
6008
     * @param array $params An associative array of parameters
6009
     * @param boolean $strict Whether to require a field exist or not when loading the info
6010
     *
6011
     * @return array|bool Array with field data, false if field not found
6012
     * @since 1.7.9
6013
     */
6014
    public function load_field ( $params, $strict = false ) {
6015
        $params = (object) $params;
6016
6017
        if ( !isset( $params->table_info ) )
6018
            $params->table_info = false;
6019
6020
        $bypass_cache = false;
6021
6022
        if ( ! empty( $params->bypass_cache ) )
6023
            $bypass_cache = true;
6024
6025
        $pod = array();
6026
        $field = array();
6027
6028
        if ( isset( $params->post_title ) )
6029
            $_field = $params;
6030
        elseif ( isset( $params->id ) && !empty( $params->id ) )
6031
            $_field = get_post( $dumb = (int) $params->id );
6032
        else {
6033
            if ( !isset( $params->pod ) )
6034
                $params->pod = '';
6035
6036
            if ( !isset( $params->pod_id ) )
6037
                $params->pod_id = 0;
6038
6039
            if ( isset( $params->pod_data ) )
6040
                $pod = $params->pod_data;
6041
            else {
6042
                $pod = $this->load_pod( array( 'name' => $params->pod, 'id' => $params->pod_id, 'table_info' => false, 'bypass_cache' => $bypass_cache ), false );
6043
6044
                if ( false === $pod ) {
6045
                    if ( $strict )
6046
                        return pods_error( __( 'Pod not found', 'pods' ), $this );
6047
6048
                    return false;
6049
                }
6050
            }
6051
6052
            $params->pod_id = $pod[ 'id' ];
6053
            $params->pod = $pod[ 'name' ];
6054
6055 View Code Duplication
            if ( empty( $params->name ) && empty( $params->pod ) && empty( $params->pod_id ) )
6056
                return pods_error( __( 'Either Field Name or Field ID / Pod ID are required', 'pods' ), $this );
6057
6058
            $params->name = pods_clean_name( $params->name, true, ( 'meta' == $pod[ 'storage' ] ? false : true ) );
6059
6060
            if ( isset( $pod[ 'fields' ][ $params->name ] ) && isset( $pod[ 'fields' ][ $params->name ][ 'id' ] ) )
6061
                return $pod[ 'fields' ][ $params->name ];
6062
6063
            $field = false;
6064
6065
            if ( ! $bypass_cache && pods_api_cache() )
6066
                $field = pods_transient_get( 'pods_field_' . $params->pod . '_' . $params->name );
6067
6068
            if ( empty( $field ) ) {
6069
                $field = get_posts( array(
6070
                    'name' => $params->name,
6071
                    'post_type' => '_pods_field',
6072
                    'posts_per_page' => 1,
6073
                    'post_parent' => $params->pod_id
6074
                ) );
6075
6076
                if ( empty( $field ) ) {
6077
                    if ( $strict )
6078
                        return pods_error( __( 'Field not found', 'pods' ), $this );
6079
6080
                    return false;
6081
                }
6082
6083
                $_field = $field[ 0 ];
6084
6085
                $field = array();
6086
            }
6087
        }
6088
6089
        if ( empty( $_field ) ) {
6090
            if ( $strict )
6091
                return pods_error( __( 'Field not found', 'pods' ), $this );
6092
6093
            return false;
6094
        }
6095
6096
        $_field = get_object_vars( $_field );
6097
6098
        if ( !isset( $pod[ 'name' ] ) && !isset( $_field[ 'pod' ] ) ) {
6099
            if ( 0 < $_field[ 'post_parent' ] )
6100
                $pod = $this->load_pod( array( 'id' => $_field[ 'post_parent' ], 'table_info' => false ), false );
6101
6102
            if ( empty( $pod ) ) {
6103
                if ( $strict )
6104
                    return pods_error( __( 'Pod for field not found', 'pods' ), $this );
6105
6106
                return false;
6107
            }
6108
        }
6109
6110
        if ( empty( $field ) ) {
6111 View Code Duplication
            if ( ! $bypass_cache && pods_api_cache() && ( isset( $pod[ 'name' ] ) || isset( $_field[ 'pod' ] ) ) )
6112
                $field = pods_transient_get( 'pods_field_' . pods_var( 'name', $pod, pods_var( 'pod', $_field ), null, true ) . '_' . $_field[ 'post_name' ] );
6113
6114
            if ( empty( $field ) ) {
6115
                $defaults = array(
6116
                    'type' => 'text'
6117
                );
6118
6119
                $field = array(
6120
                    'id' => $_field[ 'ID' ],
6121
                    'name' => $_field[ 'post_name' ],
6122
                    'label' => $_field[ 'post_title' ],
6123
                    'description' => $_field[ 'post_content' ],
6124
                    'weight' => $_field[ 'menu_order' ],
6125
                    'pod_id' => $_field[ 'post_parent' ],
6126
                    'pick_object' => '',
6127
                    'pick_val' => '',
6128
                    'sister_id' => '',
6129
                    'table_info' => array()
6130
                );
6131
6132
                if ( isset( $pod[ 'name' ] ) )
6133
                    $field[ 'pod' ] = $pod[ 'name' ];
6134
                elseif ( isset( $_field[ 'pod' ] ) )
6135
                    $field[ 'pod' ] = $_field[ 'pod' ];
6136
6137
	            if ( $bypass_cache ) {
6138
	                wp_cache_delete( $field['id'], 'post_meta' );
6139
6140
	                update_postmeta_cache( array( $field['id'] ) );
6141
	            }
6142
6143
                $field[ 'options' ] = get_post_meta( $field[ 'id' ] );
6144
6145
                $options_ignore = array(
6146
                    'method',
6147
                    'table_info',
6148
                    'attributes',
6149
                    'group',
6150
                    'grouped',
6151
                    'developer_mode',
6152
                    'dependency',
6153
                    'depends-on',
6154
                    'excludes-on'
6155
                );
6156
6157
                foreach ( $options_ignore as $ignore ) {
6158
                    if ( isset( $field[ 'options' ][ $ignore ] ) )
6159
                        unset( $field[ 'options' ][ $ignore ] );
6160
                }
6161
6162 View Code Duplication
                foreach ( $field[ 'options' ] as $option => $value ) {
6163
                    if ( is_array( $value ) ) {
6164
                        foreach ( $value as $k => $v ) {
6165
                            if ( !is_array( $v ) )
6166
                                $value[ $k ] = maybe_unserialize( $v );
6167
                        }
6168
6169
                        if ( 1 == count( $value ) )
6170
                            $value = current( $value );
6171
                    }
6172
                    else
6173
                        $value = maybe_unserialize( $value );
6174
6175
                    $field[ 'options' ][ $option ] = $value;
6176
                }
6177
6178
                $field[ 'options' ] = array_merge( $defaults, $field[ 'options' ] );
6179
6180
                $field[ 'type' ] = $field[ 'options' ][ 'type' ];
6181
6182
                unset( $field[ 'options' ][ 'type' ] );
6183
6184 View Code Duplication
                if ( isset( $field[ 'options' ][ 'pick_object' ] ) ) {
6185
                    $field[ 'pick_object' ] = $field[ 'options' ][ 'pick_object' ];
6186
6187
                    unset( $field[ 'options' ][ 'pick_object' ] );
6188
                }
6189
6190 View Code Duplication
                if ( isset( $field[ 'options' ][ 'pick_val' ] ) ) {
6191
                    $field[ 'pick_val' ] = $field[ 'options' ][ 'pick_val' ];
6192
6193
                    unset( $field[ 'options' ][ 'pick_val' ] );
6194
                }
6195
6196 View Code Duplication
                if ( isset( $field[ 'options' ][ 'sister_id' ] ) ) {
6197
                    $field[ 'sister_id' ] = $field[ 'options' ][ 'sister_id' ];
6198
6199
                    unset( $field[ 'options' ][ 'sister_id' ] );
6200
                }
6201
6202
                if ( isset( $field[ 'options' ][ 'sister_field_id' ] ) )
6203
                    unset( $field[ 'options' ][ 'sister_field_id' ] );
6204
6205 View Code Duplication
                if ( pods_api_cache() && ( isset( $pod[ 'name' ] ) || isset( $_field[ 'pod' ] ) ) )
6206
                    pods_transient_set( 'pods_field_' . pods_var( 'name', $pod, pods_var( 'pod', $_field ), null, true ) . '_' . $field[ 'name' ], $field );
6207
            }
6208
        }
6209
6210
        $field[ 'table_info' ] = array();
6211
6212
        if ( 'pick' == $field[ 'type' ] && $params->table_info )
6213
            $field[ 'table_info' ] = $this->get_table_info( $field[ 'pick_object' ], $field[ 'pick_val' ], null, null, $field );
6214
6215
        return $field;
6216
    }
6217
6218
    /**
6219
     * Load fields by Pod, ID, Name, and/or Type
6220
     *
6221
     * $params['pod_id'] int The Pod ID
6222
     * $params['pod'] string The Pod name
6223
     * $params['id'] array The field IDs
6224
     * $params['name'] array The field names
6225
     * $params['type'] array The field types
6226
     * $params['options'] array Field Option(s) key=>value array to filter by
6227
     * $params['where'] string WHERE clause of query
6228
     *
6229
     * @param array $params An associative array of parameters
6230
     * @param bool $strict  Whether to require a field exist or not when loading the info
6231
     *
6232
     * @return array Array of field data.
6233
     *
6234
     * @since 1.7.9
6235
     */
6236
    public function load_fields ( $params, $strict = false ) {
6237
		// @todo Get away from using md5/serialize, I'm sure we can cache specific parts
6238
	    $cache_key = md5( serialize( $params  ) );
6239
	    if ( isset( $this->fields_cache[ $cache_key ] ) ) {
6240
		    return $this->fields_cache[ $cache_key ];
6241
	    }
6242
6243
        $params = (object) pods_sanitize( $params );
6244
6245
        if ( !isset( $params->pod ) || empty( $params->pod ) )
6246
            $params->pod = '';
6247
6248
        if ( !isset( $params->pod_id ) || empty( $params->pod_id ) )
6249
            $params->pod_id = 0;
6250
6251 View Code Duplication
        if ( !isset( $params->name ) || empty( $params->name ) )
6252
            $params->name = array();
6253
        else
6254
            $params->name = (array) $params->name;
6255
6256
        if ( !isset( $params->id ) || empty( $params->id ) )
6257
            $params->id = array();
6258
        else {
6259
            $params->id = (array) $params->id;
6260
6261
            foreach ( $params->id as &$id ) {
6262
                $id = pods_absint( $id );
6263
            }
6264
        }
6265
6266 View Code Duplication
        if ( !isset( $params->type ) || empty( $params->type ) )
6267
            $params->type = array();
6268
        else
6269
            $params->type = (array) $params->type;
6270
6271
        $fields = array();
6272
6273
        if ( !empty( $params->pod ) || !empty( $params->pod_id ) ) {
6274
            $pod = $this->load_pod( array( 'name' => $params->pod, 'id' => $params->pod_id, 'table_info' => true ), false );
6275
6276
            if ( false === $pod ) {
6277
                if ( $strict )
6278
                    return pods_error( __( 'Pod not found', 'pods' ), $this );
6279
6280
                return $fields;
6281
            }
6282
6283
			$pod[ 'fields' ] = array_merge( pods_var_raw( 'object_fields', $pod, array() ), $pod[ 'fields' ] );
6284
6285
            foreach ( $pod[ 'fields' ] as $field ) {
6286
                if ( empty( $params->name ) && empty( $params->id ) && empty( $params->type ) )
6287
                    $fields[ $field[ 'name' ] ] = $field;
6288
				elseif ( in_array( $fields[ 'name' ], $params->name ) || in_array( $fields[ 'id' ], $params->id ) || in_array( $fields[ 'type' ], $params->type ) )
6289
                    $fields[ $field[ 'name' ] ] = $field;
6290
            }
6291
        }
6292
        elseif ( ( isset( $params->options ) && !empty( $params->options ) && is_array( $params->options ) ) || ( isset( $params->where ) && !empty( $params->where ) && is_array( $params->where ) ) ) {
6293
            $order = 'ASC';
6294
            $orderby = 'menu_order title';
6295
            $limit = -1;
6296
            $ids = false;
6297
6298
            $meta_query = array();
6299
6300 View Code Duplication
            if ( isset( $params->options ) && !empty( $params->options ) && is_array( $params->options ) ) {
6301
                foreach ( $params->options as $option => $value ) {
6302
                    if ( !is_array( $value ) )
6303
                        $value = array( $value );
6304
6305
                    $value = pods_trim( $value );
6306
6307
                    sort( $value );
6308
6309
                    $meta_query[] = array(
6310
                        'key' => $option,
6311
                        'value' => pods_sanitize( $value ),
6312
                        'compare' => 'IN'
6313
                    );
6314
                }
6315
            }
6316
6317
            if ( isset( $params->where ) && !empty( $params->where ) && is_array( $params->where ) )
6318
                $meta_query = array_merge( $meta_query, (array) $params->where );
6319
6320
			$args = array(
6321
				'post_type' => '_pods_field',
6322
				'nopaging' => true,
6323
				'posts_per_page' => $limit,
6324
				'order' => $order,
6325
				'orderby' => $orderby,
6326
				'meta_query' => $meta_query,
6327
			);
6328
6329
			// Only set post__in if there are ids to filter (see https://core.trac.wordpress.org/ticket/28099)
6330
			if ( false != $ids ) {
0 ignored issues
show
Coding Style Best Practice introduced by
It seems like you are loosely comparing two booleans. Considering using the strict comparison !== instead.

When comparing two booleans, it is generally considered safer to use the strict comparison operator.

Loading history...
6331
				$args[ 'post__in' ] = $ids;
6332
			}
6333
6334
            $fields = array();
6335
6336
            $_fields = get_posts( $args );
6337
6338
            foreach ( $_fields as $field ) {
6339
                $field = $this->load_field( $field, false );
6340
6341
                if ( !empty( $field ) )
6342
                    $fields[ $field[ 'id' ] ] = $field;
6343
            }
6344
        }
6345
        else {
6346 View Code Duplication
            if ( empty( $params->name ) && empty( $params->id ) && empty( $params->type ) )
6347
                return pods_error( __( 'Either Field Name / Field ID / Field Type, or Pod Name / Pod ID are required', 'pods' ), $this );
6348
6349
            $lookup = array();
6350
6351 View Code Duplication
            if ( !empty( $params->name ) ) {
6352
                $fields = implode( "', '", $params->name );
6353
6354
                $lookup[] = "`post_name` IN ( '{$fields}' )";
6355
            }
6356
6357 View Code Duplication
            if ( !empty( $params->id ) ) {
6358
                $fields = implode( ", ", $params->id );
6359
6360
                $lookup[] = "`ID` IN ( {$fields} )";
6361
            }
6362
6363
            $lookup = implode( ' AND ', $lookup );
6364
6365
            $result = pods_query( "SELECT `ID`, `post_name`, `post_parent` FROM `@wp_posts` WHERE `post_type` = '_pods_field' AND ( {$lookup} )" );
6366
6367
            $fields = array();
6368
6369
            if ( !empty( $result ) ) {
6370
                foreach ( $result as $field ) {
6371
					$field = $this->load_field( array(
6372
                        'id' => $field->ID,
6373
                        'name' => $field->post_name,
6374
                        'pod_id' => $field->post_parent
6375
                    ), false );
6376
6377
                    if ( !empty( $field ) && ( empty( $params->type ) || in_array( $field[ 'type' ], $params->type ) ) )
6378
                        $fields[ $field[ 'id' ] ] = $field;
6379
                }
6380
            }
6381
        }
6382
	    if ( isset( $cache_key ) ) {
6383
		    $this->fields_cache[ $cache_key ] = $fields;
6384
	    }
6385
        return $fields;
6386
    }
6387
6388
    /**
6389
     * Load a Pods Object
6390
     *
6391
     * $params['id'] int The Object ID
6392
     * $params['name'] string The Object name
6393
     * $params['type'] string The Object type
6394
     *
6395
     * @param array|object $params An associative array of parameters
6396
     * @param bool $strict
6397
     *
6398
     * @return array|bool
6399
     * @since 2.0
6400
     */
6401
    public function load_object ( $params, $strict = false ) {
6402
        if ( is_object( $params ) && isset( $params->post_title ) )
6403
            $_object = get_object_vars( $params );
6404
        else {
6405
            $params = (object) pods_sanitize( $params );
6406
6407 View Code Duplication
            if ( !isset( $params->type ) || empty( $params->type ) )
6408
                return pods_error( __( 'Object type is required', 'pods' ), $this );
6409
6410 View Code Duplication
            if ( ( !isset( $params->id ) || empty( $params->id ) ) && ( !isset( $params->name ) || empty( $params->name ) ) )
6411
                return pods_error( __( 'Either Object ID or Name are required', 'pods' ), $this );
6412
6413
            /**
6414
             * @var $wpdb wpdb
6415
             */
6416
            global $wpdb;
0 ignored issues
show
Compatibility Best Practice introduced by
Use of global functionality is not recommended; it makes your code harder to test, and less reusable.

Instead of relying on global state, we recommend one of these alternatives:

1. Pass all data via parameters

function myFunction($a, $b) {
    // Do something
}

2. Create a class that maintains your state

class MyClass {
    private $a;
    private $b;

    public function __construct($a, $b) {
        $this->a = $a;
        $this->b = $b;
    }

    public function myFunction() {
        // Do something
    }
}
Loading history...
6417
6418
            if ( isset( $params->name ) )
6419
                $_object = pods_by_title( $params->name, ARRAY_A, '_pods_' . $params->type, 'publish' );
6420
            else {
6421
                $object = $params->id;
6422
6423
                $_object = get_post( $object, ARRAY_A );
6424
            }
6425
6426
            if ( empty( $_object ) ) {
6427
                if ( $strict )
6428
                    return pods_error( __( 'Object not found', 'pods' ), $this );
6429
6430
                return false;
6431
            }
6432
        }
6433
6434
        $object = array(
6435
            'id' => $_object[ 'ID' ],
6436
            'name' => $_object[ 'post_title' ],
6437
            'code' => $_object[ 'post_content' ],
6438
            'type' => str_replace( '_pods_', '', $_object[ 'post_type' ] ),
6439
            'slug' => $_object[ 'post_name' ]
6440
        );
6441
6442
        $object[ 'options' ] = get_post_meta( $object[ 'id' ] );
6443
6444
        foreach ( $object[ 'options' ] as $option => &$value ) {
6445
            if ( is_array( $value ) && 1 == count( $value ) )
6446
                $value = current( $value );
6447
        }
6448
6449
        return $object;
6450
    }
6451
6452
    /**
6453
     * Load Multiple Pods Objects
6454
     *
6455
     * $params['type'] string The Object type
6456
     * $params['options'] array Pod Option(s) key=>value array to filter by
6457
     * $params['orderby'] string ORDER BY clause of query
6458
     * $params['limit'] string Number of objects to return
6459
     * $params['where'] string WHERE clause of query
6460
     * $params['ids'] string|array IDs of Objects
6461
     *
6462
     * @param array|object $params An associative array of parameters
6463
     *
6464
     * @return array
6465
     * @since 2.0
6466
     */
6467
    public function load_objects ( $params ) {
6468
        $params = (object) pods_sanitize( $params );
6469
6470 View Code Duplication
        if ( !isset( $params->type ) || empty( $params->type ) )
6471
            return pods_error( __( 'Pods Object type is required', 'pods' ), $this );
6472
6473
        $order = 'ASC';
6474
        $orderby = 'menu_order';
6475
        $limit = -1;
6476
        $ids = false;
6477
6478
        $meta_query = array();
6479
        $cache_key = '';
6480
6481 View Code Duplication
        if ( isset( $params->options ) && !empty( $params->options ) && is_array( $params->options ) ) {
6482
            foreach ( $params->options as $option => $value ) {
6483
                if ( !is_array( $value ) )
6484
                    $value = array( $value );
6485
6486
                $value = pods_trim( $value );
6487
6488
                sort( $value );
6489
6490
                $meta_query[] = array(
6491
                    'key' => $option,
6492
                    'value' => pods_sanitize( $value ),
6493
                    'compare' => 'IN'
6494
                );
6495
            }
6496
        }
6497
6498
        if ( isset( $params->where ) && is_array( $params->where ) )
6499
            $meta_query = array_merge( $meta_query, (array) $params->where );
6500
6501 View Code Duplication
        if ( isset( $params->order ) && !empty( $params->order ) && in_array( strtoupper( $params->order ), array( 'ASC', 'DESC' ) ) )
6502
            $order = strtoupper( $params->order );
6503
6504
        if ( isset( $params->orderby ) && !empty( $params->orderby ) )
6505
            $orderby = strtoupper( $params->orderby );
6506
6507
        if ( isset( $params->limit ) && !empty( $params->limit ) )
6508
            $limit = pods_absint( $params->limit );
6509
6510
        if ( isset( $params->ids ) && !empty( $params->ids ) ) {
6511
            $ids = $params->ids;
6512
6513
            if ( !is_array( $ids ) )
6514
                $ids = explode( ',', $ids );
6515
        }
6516
6517
        if ( empty( $ids ) )
6518
            $ids = false;
6519
6520
        if ( pods_api_cache() && empty( $meta_query ) && empty( $limit ) && ( empty( $orderby ) || 'menu_order' == $orderby ) && empty( $ids ) ) {
6521
            $cache_key = 'pods_objects_' . $params->type;
6522
6523
            $the_objects = pods_transient_get( $cache_key );
6524
6525
            if ( false !== $the_objects )
6526
                return $the_objects;
6527
        }
6528
6529
        $the_objects = array();
6530
6531
		$args = array(
6532
			'post_type' => '_pods_' . $params->type,
6533
			'nopaging' => true,
6534
			'posts_per_page' => $limit,
6535
			'order' => $order,
6536
			'orderby' => $orderby,
6537
			'meta_query' => $meta_query,
6538
		);
6539
6540
		// Only set post__in if there are ids to filter (see https://core.trac.wordpress.org/ticket/28099)
6541
		if ( false != $ids ) {
6542
			$args[ 'post__in' ] = $ids;
6543
		}
6544
6545
		$objects = get_posts( $args );
6546
6547
        foreach ( $objects as $object ) {
6548
            $object = $this->load_object( $object );
6549
6550
            $the_objects[ $object[ 'name' ] ] = $object;
6551
        }
6552
6553
        if ( pods_api_cache() && !empty( $cache_key ) )
6554
            pods_transient_set( $cache_key, $the_objects );
6555
6556
        return $the_objects;
6557
    }
6558
6559
    /**
6560
     * @see PodsAPI::load_object
6561
     *
6562
     * Load a Pod Template
6563
     *
6564
     * $params['id'] int The template ID
6565
     * $params['name'] string The template name
6566
     *
6567
     * @param array $params An associative array of parameters
6568
     *
6569
     * @return array|bool
6570
     * @since 1.7.9
6571
     */
6572
    public function load_template ( $params ) {
6573
        if ( !class_exists( 'Pods_Templates' ) )
6574
            return false;
6575
6576
        $params = (object) $params;
6577
        $params->type = 'template';
6578
        return $this->load_object( $params );
6579
    }
6580
6581
    /**
6582
     * @see PodsAPI::load_objects
6583
     *
6584
     * Load Multiple Pod Templates
6585
     *
6586
     * $params['where'] string The WHERE clause of query
6587
     * $params['options'] array Pod Option(s) key=>value array to filter by
6588
     * $params['orderby'] string ORDER BY clause of query
6589
     * $params['limit'] string Number of templates to return
6590
     *
6591
     * @param array $params (optional) An associative array of parameters
6592
     *
6593
     * @return array
6594
     *
6595
     * @since 2.0
6596
     */
6597
    public function load_templates ( $params = null ) {
6598
        if ( !class_exists( 'Pods_Templates' ) )
6599
            return array();
6600
6601
        $params = (object) $params;
6602
        $params->type = 'template';
6603
        return $this->load_objects( $params );
6604
    }
6605
6606
    /**
6607
     * @see PodsAPI::load_object
6608
     *
6609
     * Load a Pod Page
6610
     *
6611
     * $params['id'] int The page ID
6612
     * $params['name'] string The page URI
6613
     *
6614
     * @param array $params An associative array of parameters
6615
     *
6616
     * @return array|bool
6617
     *
6618
     * @since 1.7.9
6619
     */
6620
    public function load_page ( $params ) {
6621
        if ( !class_exists( 'Pods_Pages' ) )
6622
            return false;
6623
6624
        $params = (object) $params;
6625 View Code Duplication
        if ( !isset( $params->name ) && isset( $params->uri ) ) {
6626
            $params->name = $params->uri;
6627
            unset( $params->uri );
6628
        }
6629
        $params->type = 'page';
6630
        return $this->load_object( $params );
6631
    }
6632
6633
    /**
6634
     * @see PodsAPI::load_objects
6635
     *
6636
     * Load Multiple Pod Pages
6637
     *
6638
     * $params['where'] string The WHERE clause of query
6639
     * $params['options'] array Pod Option(s) key=>value array to filter by
6640
     * $params['orderby'] string ORDER BY clause of query
6641
     * $params['limit'] string Number of pages to return
6642
     *
6643
     * @param array $params (optional) An associative array of parameters
6644
     *
6645
     * @return array
6646
     *
6647
     * @since 2.0
6648
     */
6649
    public function load_pages ( $params = null ) {
6650
        if ( !class_exists( 'Pods_Pages' ) )
6651
            return array();
6652
6653
        $params = (object) $params;
6654
        $params->type = 'page';
6655
        return $this->load_objects( $params );
6656
    }
6657
6658
    /**
6659
     * @see PodsAPI::load_object
6660
     *
6661
     * Load a Pod Helper
6662
     *
6663
     * $params['id'] int The helper ID
6664
     * $params['name'] string The helper name
6665
     *
6666
     * @param array $params An associative array of parameters
6667
     *
6668
     * @return array|bool
6669
     *
6670
     * @since 1.7.9
6671
     */
6672 View Code Duplication
    public function load_helper ( $params ) {
0 ignored issues
show
Duplication introduced by
This method seems to be duplicated in your project.

Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation.

You can also find more detailed suggestions in the “Code” section of your repository.

Loading history...
6673
        if ( !class_exists( 'Pods_Helpers' ) )
6674
            return false;
6675
6676
        $params = (object) $params;
6677
        $params->type = 'helper';
6678
        return $this->load_object( $params );
6679
    }
6680
6681
    /**
6682
     * @see PodsAPI::load_objects
6683
     *
6684
     * Load Multiple Pod Helpers
6685
     *
6686
     * $params['where'] string The WHERE clause of query
6687
     * $params['options'] array Pod Option(s) key=>value array to filter by
6688
     * $params['orderby'] string ORDER BY clause of query
6689
     * $params['limit'] string Number of pages to return
6690
     *
6691
     * @param array $params (optional) An associative array of parameters
6692
     *
6693
     * @return array
6694
     *
6695
     * @since 2.0
6696
     */
6697 View Code Duplication
    public function load_helpers ( $params = null ) {
0 ignored issues
show
Duplication introduced by
This method seems to be duplicated in your project.

Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation.

You can also find more detailed suggestions in the “Code” section of your repository.

Loading history...
6698
        if ( !class_exists( 'Pods_Helpers' ) )
6699
            return array();
6700
6701
        $params = (object) $params;
6702
        $params->type = 'helper';
6703
        return $this->load_objects( $params );
6704
    }
6705
6706
    /**
6707
     * Load the pod item object
6708
     *
6709
     * $params['pod'] string The datatype name
6710
     * $params['id'] int (optional) The item's ID
6711
     *
6712
     * @param array $params An associative array of parameters
6713
     *
6714
     * @return bool|\Pods
6715
     *
6716
     * @uses pods()
6717
     *
6718
     * @since 2.0
6719
     */
6720
    public function load_pod_item ( $params ) {
6721
        $params = (object) pods_sanitize( $params );
6722
6723 View Code Duplication
        if ( !isset( $params->pod ) || empty( $params->pod ) )
6724
            return pods_error( __( 'Pod name required', 'pods' ), $this );
6725 View Code Duplication
        if ( !isset( $params->id ) || empty( $params->id ) )
6726
            return pods_error( __( 'Item ID required', 'pods' ), $this );
6727
6728
        $pod = false;
6729
6730
        if ( pods_api_cache() )
6731
            $pod = pods_cache_get( $params->id, 'pods_item_object_' . $params->pod );
6732
6733
        if ( false !== $pod )
6734
            return $pod;
6735
6736
        $pod = pods( $params->pod, $params->id );
6737
6738
        if ( pods_api_cache() )
6739
            pods_cache_set( $params->id, $pod, 'pods_item_object_' . $params->pod );
6740
6741
        return $pod;
6742
    }
6743
6744
    /**
6745
     * Load potential sister fields for a specific field
6746
     *
6747
     * $params['pod'] int The Pod name
6748
     * $params['related_pod'] string The related Pod name
6749
     *
6750
     * @param array $params An associative array of parameters
6751
     * @param array $pod (optional) Array of Pod data to use (to avoid lookup)
6752
     *
6753
     * @return array|bool
6754
     *
6755
     * @since 1.7.9
6756
     *
6757
     * @uses PodsAPI::load_pod
6758
     */
6759
    public function load_sister_fields ( $params, $pod = null ) {
6760
        $params = (object) pods_sanitize( $params );
6761
6762
        if ( empty( $pod ) ) {
6763
            $pod = $this->load_pod( array( 'name' => $params->pod, 'table_info' => false ), false );
6764
6765
            if ( false === $pod )
6766
                return pods_error( __( 'Pod not found', 'pods' ), $this );
6767
        }
6768
6769
        $params->pod_id = $pod[ 'id' ];
6770
        $params->pod = $pod[ 'name' ];
6771
6772
        $type = false;
6773
6774
        if ( 0 === strpos( $params->related_pod, 'pod-' ) ) {
6775
            $params->related_pod = pods_str_replace( 'pod-', '', $params->related_pod, 1 );
6776
            $type = 'pod';
6777
        }
6778 View Code Duplication
        elseif ( 0 === strpos( $params->related_pod, 'post_type-' ) ) {
6779
            $params->related_pod = pods_str_replace( 'post_type-', '', $params->related_pod, 1 );
6780
            $type = 'post_type';
6781
        }
6782 View Code Duplication
        elseif ( 0 === strpos( $params->related_pod, 'taxonomy-' ) ) {
6783
            $params->related_pod = pods_str_replace( 'taxonomy-', '', $params->related_pod, 1 );
6784
            $type = 'taxonomy';
6785
        }
6786
6787
        $related_pod = $this->load_pod( array( 'name' => $params->related_pod, 'table_info' => false ), false );
6788
6789
        if ( false === $related_pod || ( false !== $type && 'pod' != $type && $type != $related_pod[ 'type' ] ) )
6790
            return pods_error( __( 'Related Pod not found', 'pods' ), $this );
6791
6792
        $params->related_pod_id = $related_pod[ 'id' ];
6793
        $params->related_pod = $related_pod[ 'name' ];
6794
6795
        $sister_fields = array();
6796
6797
        foreach ( $related_pod[ 'fields' ] as $field ) {
6798
            if ( 'pick' == $field[ 'type' ] && in_array( $field[ 'pick_object' ], array( $pod[ 'type' ], 'pod' ) ) && ( $params->pod == $field[ 'pick_object' ] || $params->pod == $field[ 'pick_val' ] ) )
6799
                $sister_fields[ $field[ 'id' ] ] = esc_html( $field[ 'label' ] . ' (' . $field[ 'name' ] . ')' );
6800
        }
6801
6802
        return $sister_fields;
6803
    }
6804
6805
    /**
6806
     * Takes a sql field such as tinyint and returns the pods field type, such as num.
6807
     *
6808
     * @param string $sql_field The SQL field to look for
6809
     *
6810
     * @return string The field type
6811
     *
6812
     * @since 2.0
6813
     */
6814
    public static function detect_pod_field_from_sql_data_type ( $sql_field ) {
6815
        $sql_field = strtolower( $sql_field );
6816
6817
        $field_to_field_map = array(
6818
            'tinyint' => 'number',
6819
            'smallint' => 'number',
6820
            'mediumint' => 'number',
6821
            'int' => 'number',
6822
            'bigint' => 'number',
6823
            'float' => 'number',
6824
            'double' => 'number',
6825
            'decimal' => 'number',
6826
            'date' => 'date',
6827
            'datetime' => 'datetime',
6828
            'timestamp' => 'datetime',
6829
            'time' => 'time',
6830
            'year' => 'date',
6831
            'varchar' => 'text',
6832
            'text' => 'paragraph',
6833
            'mediumtext' => 'paragraph',
6834
            'longtext' => 'paragraph'
6835
        );
6836
6837
        return ( array_key_exists( $sql_field, $field_to_field_map ) ) ? $field_to_field_map[ $sql_field ] : 'paragraph';
6838
    }
6839
6840
    /**
6841
     * Gets all field types
6842
     *
6843
     * @return array Array of field types
6844
     *
6845
     * @uses PodsForm::field_loader
6846
     *
6847
     * @since 2.0
6848
     * @deprecated
6849
     */
6850
    public function get_field_types () {
6851
        return PodsForm::field_types();
6852
    }
6853
6854
    /**
6855
     * Gets the schema definition of a field.
6856
     *
6857
     * @param string $type Field type to look for
6858
     * @param array $options (optional) Options of the field to pass to the schema function.
6859
     *
6860
     * @return array|bool|mixed|null
6861
     *
6862
     * @since 2.0
6863
     */
6864
    private function get_field_definition ( $type, $options = null ) {
6865
        $definition = PodsForm::field_method( $type, 'schema', $options );
6866
6867
        return $this->do_hook( 'field_definition', $definition, $type, $options );
6868
    }
6869
6870
    /**
6871
     * @see PodsForm:validate
6872
     *
6873
     * Validates the value of a field.
6874
     *
6875
     * @param mixed $value The value to validate
6876
     * @param string $field Field to use for validation
6877
     * @param array $object_fields Fields of the object we're validating
6878
     * @param array $fields Array of all fields data
6879
     * @param array|Pods $pod Array of pod data (or Pods object)
6880
     * @param array|object $params Extra parameters to pass to the validation function of the field.
6881
     *
6882
     * @return array|bool
6883
     *
6884
     * @uses PodsForm::validate
6885
     *
6886
     * @since 2.0
6887
     */
6888
    public function handle_field_validation ( &$value, $field, $object_fields, $fields, $pod, $params ) {
6889
        $tableless_field_types = PodsForm::tableless_field_types();
6890
6891
        $fields = array_merge( $fields, $object_fields );
6892
6893
        $options = $fields[ $field ];
6894
6895
        $id = ( is_object( $params ) ? $params->id : ( is_object( $pod ) ? $pod->id() : 0 ) );
6896
6897
        if ( is_object( $pod ) )
6898
            $pod = $pod->pod_data;
6899
6900
        $type = $options[ 'type' ];
6901
        $label = $options[ 'label' ];
6902
        $label = empty( $label ) ? $field : $label;
6903
6904
        // Verify required fields
6905
        if ( 1 == pods_var( 'required', $options[ 'options' ], 0 ) && 'slug' != $type ) {
6906
            if ( '' == $value || null === $value || array() === $value )
6907
                return pods_error( sprintf( __( '%s is empty', 'pods' ), $label ), $this );
6908
6909
            if ( 'multi' == pods_var( 'pick_format_type', $options[ 'options' ] ) && 'autocomplete' != pods_var( 'pick_format_multi', $options[ 'options' ] ) ) {
6910
                $has_value = false;
6911
6912
                $check_value = (array) $value;
6913
6914
                foreach ( $check_value as $val ) {
6915
                    if ( '' != $val && null !== $val && 0 !== $val && '0' !== $val ) {
6916
                        $has_value = true;
6917
6918
                        continue;
6919
                    }
6920
                }
6921
6922
                if ( !$has_value )
6923
                    return pods_error( sprintf( __( '%s is required', 'pods' ), $label ), $this );
6924
            }
6925
6926
        }
6927
6928
        // @todo move this to after pre-save preparations
6929
        // Verify unique fields
6930
        if ( 1 == pods_var( 'unique', $options[ 'options' ], 0 ) && '' !== $value && null !== $value && array() !== $value ) {
6931
            if ( empty( $pod ) )
6932
                return false;
6933
6934
            if ( !in_array( $type, $tableless_field_types ) ) {
6935
                $exclude = '';
6936
6937
                if ( !empty( $id ) )
6938
                    $exclude = "AND `id` != {$id}";
6939
6940
                $check = false;
6941
6942
                $check_value = pods_sanitize( $value );
6943
6944
                // @todo handle meta-based fields
6945
                // Trigger an error if not unique
6946
                if ( 'table' == $pod[ 'storage' ] )
6947
                    $check = pods_query( "SELECT `id` FROM `@wp_pods_" . $pod[ 'name' ] . "` WHERE `{$field}` = '{$check_value}' {$exclude} LIMIT 1", $this );
6948
6949
                if ( !empty( $check ) )
6950
                    return pods_error( sprintf( __( '%s needs to be unique', 'pods' ), $label ), $this );
6951
            }
6952
            else {
0 ignored issues
show
Unused Code introduced by
This else statement is empty and can be removed.

This check looks for the else branches of if statements that have no statements or where all statements have been commented out. This may be the result of changes for debugging or the code may simply be obsolete.

These else branches can be removed.

if (rand(1, 6) > 3) {
print "Check failed";
} else {
    //print "Check succeeded";
}

could be turned into

if (rand(1, 6) > 3) {
    print "Check failed";
}

This is much more concise to read.

Loading history...
6953
                // @todo handle tableless check
6954
            }
6955
        }
6956
6957
        $validate = PodsForm::validate( $options[ 'type' ], $value, $field, array_merge( $options, pods_var( 'options', $options, array() ) ), $fields, $pod, $id, $params );
6958
6959
        $validate = $this->do_hook( 'field_validation', $validate, $value, $field, $object_fields, $fields, $pod, $params );
6960
6961
        return $validate;
6962
    }
6963
6964
    /**
6965
     * Find items related to a parent field
6966
     *
6967
     * @param int $field_id The Field ID
6968
     * @param int $pod_id The Pod ID
6969
     * @param mixed $ids A comma-separated string (or array) of item IDs
6970
     * @param array $field Field data array
6971
     * @param array $pod Pod data array
6972
     *
6973
     * @return array
6974
     *
6975
     * @since 2.0
6976
     *
6977
     * @uses pods_query()
6978
     */
6979
    public function lookup_related_items ( $field_id, $pod_id, $ids, $field = null, $pod = null ) {
6980
        $related_ids = array();
6981
6982
        if ( !is_array( $ids ) )
6983
            $ids = explode( ',', $ids );
6984
6985
        foreach ( $ids as $k => $id ) {
6986
            $ids[ $k ] = (int) $id;
6987
        }
6988
6989
        $ids = array_unique( array_filter( $ids ) );
6990
6991
	    $idstring = implode( ',', $ids );
6992
	    if ( 0 != $pod_id && 0 != $field_id && isset( self::$related_item_cache[ $pod_id ][ $field_id ][ $idstring ] ) ) {
6993
		    // Check cache first, no point in running the same query multiple times
6994
		    return self::$related_item_cache[ $pod_id ][ $field_id ][ $idstring ];
6995
	    }
6996
6997
        $tableless_field_types = PodsForm::tableless_field_types();
6998
6999
		$field_type = pods_v( 'type', $field );
7000
7001
        if ( empty( $ids ) || !in_array( $field_type, $tableless_field_types ) )
7002
            return array();
7003
7004
        $related_pick_limit = 0;
7005
7006
		if ( empty( $field ) ) {
7007
			$field = $this->load_field( array( 'id' => $field_id ) );
7008
		}
7009
7010
        if ( !empty( $field ) ) {
7011
            $options = (array) pods_var_raw( 'options', $field, $field, null, true );
7012
7013
            $related_pick_limit = (int) pods_v( $field_type . '_limit', $options, 0 );
7014
7015
            if ( 'single' == pods_var_raw( $field_type . '_format_type', $options ) )
7016
                $related_pick_limit = 1;
7017
7018
            // Temporary hack until there's some better handling here
7019
            $related_pick_limit = $related_pick_limit * count( $ids );
7020
        }
7021
7022
		if ( 'taxonomy' == $field_type ) {
7023
			$related = wp_get_object_terms( $ids, pods_v( 'name', $field ), array( 'fields' => 'ids' ) );
7024
7025
			if ( !is_wp_error( $related ) ) {
7026
				$related_ids = $related;
7027
			}
7028
		}
7029
		elseif ( !pods_tableless() ) {
7030
            $ids = implode( ', ', $ids );
7031
7032
            $field_id = (int) $field_id;
7033
            $sister_id = (int) pods_var_raw( 'sister_id', $field, 0 );
7034
7035
            $related_where = "
7036
                `field_id` = {$field_id}
7037
                AND `item_id` IN ( {$ids} )
7038
            ";
7039
7040
            $sql = "
7041
                SELECT item_id, related_item_id, related_field_id
7042
                FROM `@wp_podsrel`
7043
                WHERE
7044
                    {$related_where}
7045
                ORDER BY `weight`
7046
            ";
7047
7048
            $relationships = pods_query( $sql );
7049
7050
            if ( !empty( $relationships ) ) {
7051
                foreach ( $relationships as $relation ) {
7052
                    if ( !in_array( $relation->related_item_id, $related_ids ) )
7053
                        $related_ids[] = (int) $relation->related_item_id;
7054
                    elseif ( 0 < $sister_id && $field_id == $relation->related_field_id && !in_array( $relation->item_id, $related_ids ) )
7055
                        $related_ids[] = (int) $relation->item_id;
7056
                }
7057
            }
7058
        }
7059 View Code Duplication
        else {
7060
            if ( !is_array( $pod ) )
7061
                $pod = $this->load_pod( array( 'id' => $pod_id, 'table_info' => false ), false );
7062
7063
            if ( !empty( $pod ) && in_array( $pod[ 'type' ], array( 'post_type', 'media', 'taxonomy', 'user', 'comment', 'settings' ) ) ) {
7064
                $meta_type = $pod[ 'type' ];
7065
7066
                if ( in_array( $meta_type, array( 'post_type', 'media' ) ) )
7067
                    $meta_type = 'post';
7068
                elseif ( 'taxonomy' == $meta_type )
7069
                    $meta_type = 'term';
7070
7071
                $no_conflict = pods_no_conflict_check( ( 'term' == $meta_type ? 'taxonomy' : $meta_type ) );
7072
7073
                if ( !$no_conflict )
7074
                    pods_no_conflict_on( ( 'term' == $meta_type ? 'taxonomy' : $meta_type ) );
7075
7076
                foreach ( $ids as $id ) {
7077
                    if ( 'settings' == $meta_type ) {
7078
                        $related_id = get_option( '_pods_' . $pod[ 'name' ] . '_' . $field[ 'name' ] );
7079
7080
                        if ( empty( $related_id ) )
7081
                            $related_id = get_option( $pod[ 'name' ] . '_' . $field[ 'name' ] );
7082
7083
                        if ( is_array( $related_id ) && !empty( $related_id ) ) {
7084
                            foreach ( $related_id as $related ) {
7085
                                if ( is_array( $related ) && !empty( $related ) ) {
7086
                                    if ( isset( $related[ 'id' ] ) )
7087
                                        $related_ids[] = (int) $related[ 'id' ];
7088
                                    else {
7089
                                        foreach ( $related as $r ) {
7090
                                            $related_ids[] = (int) $r;
7091
                                        }
7092
                                    }
7093
                                }
7094
                                else
7095
                                    $related_ids[] = (int) $related;
7096
                            }
7097
                        }
7098
                    }
7099
                    else {
7100
                        $related_id = get_metadata( $meta_type, $id, '_pods_' . $field[ 'name' ], true );
7101
7102
                        if ( empty( $related_id ) )
7103
                            $related_id = get_metadata( $meta_type, $id, $field[ 'name' ] );
7104
7105
                        if ( is_array( $related_id ) && !empty( $related_id ) ) {
7106
                            foreach ( $related_id as $related ) {
7107
                                if ( is_array( $related ) && !empty( $related ) ) {
7108
                                    if ( isset( $related[ 'id' ] ) )
7109
                                        $related_ids[] = (int) $related[ 'id' ];
7110
                                    else {
7111
                                        foreach ( $related as $r ) {
7112
                                            if ( isset( $related[ 'id' ] ) )
7113
                                                $related_ids[] = (int) $r[ 'id' ];
7114
                                            else
7115
                                                $related_ids[] = (int) $r;
7116
                                        }
7117
                                    }
7118
                                }
7119
                                else
7120
                                    $related_ids[] = (int) $related;
7121
                            }
7122
                        }
7123
                    }
7124
                }
7125
7126
                if ( !$no_conflict )
7127
                    pods_no_conflict_off( ( 'term' == $meta_type ? 'taxonomy' : $meta_type ) );
7128
            }
7129
        }
7130
7131
        if ( is_array( $related_ids ) ) {
7132
            $related_ids = array_unique( array_filter( $related_ids ) );
7133
7134
            if ( 0 < $related_pick_limit && !empty( $related_ids ) )
7135
                $related_ids = array_slice( $related_ids, 0, $related_pick_limit );
7136
        }
7137
	    if ( 0 != $pod_id && 0 != $field_id && ! empty( $related_ids ) ) {
7138
                    // Only cache if $pod_id and $field_id were passed
7139
		    self::$related_item_cache[ $pod_id ][ $field_id ][ $idstring ] = $related_ids;
7140
	    }
7141
7142
        return $related_ids;
7143
    }
7144
7145
    /**
7146
     * Find related items related to an item
7147
     *
7148
     * @param int $field_id The Field ID
7149
     * @param int $pod_id The Pod ID
7150
     * @param int $id Item ID to get related IDs from
7151
     * @param array $field Field data array
7152
     * @param array $pod Pod data array
7153
     *
7154
     * @return array|bool
7155
     *
7156
     * @since 2.3
7157
     *
7158
     * @uses pods_query()
7159
     */
7160
    public function lookup_related_items_from ( $field_id, $pod_id, $id, $field = null, $pod = null ) {
0 ignored issues
show
Unused Code introduced by
The parameter $pod_id is not used and could be removed.

This check looks from parameters that have been defined for a function or method, but which are not used in the method body.

Loading history...
Unused Code introduced by
The parameter $pod is not used and could be removed.

This check looks from parameters that have been defined for a function or method, but which are not used in the method body.

Loading history...
7161
        $related_ids = false;
7162
7163
        $id = (int) $id;
7164
7165
        $tableless_field_types = PodsForm::tableless_field_types();
7166
7167
        if ( empty( $id ) || !in_array( pods_v( 'type', $field ), $tableless_field_types ) )
7168
            return false;
7169
7170
        $related_pick_limit = 0;
7171
7172
        if ( !empty( $field ) ) {
7173
            $options = (array) pods_var_raw( 'options', $field, $field, null, true );
7174
7175
            $related_pick_limit = (int) pods_v( 'pick_limit', $options, 0 );
7176
7177
            if ( 'single' == pods_var_raw( 'pick_format_type', $options ) )
7178
                $related_pick_limit = 1;
7179
        }
7180
7181
        if ( !pods_tableless() ) {
7182
            $field_id = (int) $field_id;
7183
            $sister_id = (int) pods_var_raw( 'sister_id', $field, 0 );
7184
7185
            $related_where = "
7186
                `field_id` = {$field_id}
7187
                AND `related_item_id` = {$id}
7188
            ";
7189
7190
            $sql = "
7191
                SELECT *
7192
                FROM `@wp_podsrel`
7193
                WHERE
7194
                    {$related_where}
7195
                ORDER BY `weight`
7196
            ";
7197
7198
            $relationships = pods_query( $sql );
7199
7200
            if ( !empty( $relationships ) ) {
7201
                $related_ids = array();
7202
7203
                foreach ( $relationships as $relation ) {
7204
                    if ( $field_id == $relation->field_id && !in_array( $relation->item_id, $related_ids ) )
7205
                        $related_ids[] = (int) $relation->item_id;
7206
                    elseif ( 0 < $sister_id && $field_id == $relation->related_field_id && !in_array( $relation->related_item_id, $related_ids ) )
7207
                        $related_ids[] = (int) $relation->related_item_id;
7208
                }
7209
            }
7210
        }
7211 View Code Duplication
        else {
7212
            // @todo handle meta-based lookups
7213
            return false;
7214
7215
            if ( !is_array( $pod ) )
0 ignored issues
show
Unused Code introduced by
if (!is_array($pod)) { ...o' => false), false); } does not seem to be reachable.

This check looks for unreachable code. It uses sophisticated control flow analysis techniques to find statements which will never be executed.

Unreachable code is most often the result of return, die or exit statements that have been added for debug purposes.

function fx() {
    try {
        doSomething();
        return true;
    }
    catch (\Exception $e) {
        return false;
    }

    return false;
}

In the above example, the last return false will never be executed, because a return statement has already been met in every possible execution path.

Loading history...
7216
                $pod = $this->load_pod( array( 'id' => $pod_id, 'table_info' => false ), false );
7217
7218
            if ( !empty( $pod ) && in_array( $pod[ 'type' ], array( 'post_type', 'media', 'taxonomy', 'user', 'comment', 'settings' ) ) ) {
7219
                $related_ids = array();
7220
7221
                $meta_type = $pod[ 'type' ];
7222
7223
                if ( in_array( $meta_type, array( 'post_type', 'media' ) ) )
7224
                    $meta_type = 'post';
7225
                elseif ( 'taxonomy' == $meta_type )
7226
                    $meta_type = 'term';
7227
7228
                $no_conflict = pods_no_conflict_check( ( 'term' == $meta_type ? 'taxonomy' : $meta_type ) );
7229
7230
                if ( !$no_conflict )
7231
                    pods_no_conflict_on( ( 'term' == $meta_type ? 'taxonomy' : $meta_type ) );
7232
7233
                if ( 'settings' == $meta_type ) {
7234
                    $related_id = get_option( '_pods_' . $pod[ 'name' ] . '_' . $field[ 'name' ] );
7235
7236
                    if ( empty( $related_id ) )
7237
                        $related_id = get_option( $pod[ 'name' ] . '_' . $field[ 'name' ] );
7238
7239
                    if ( is_array( $related_id ) && !empty( $related_id ) ) {
7240
                        foreach ( $related_id as $related ) {
7241
                            if ( is_array( $related ) && !empty( $related ) ) {
7242
                                if ( isset( $related[ 'id' ] ) )
7243
                                    $related_ids[] = (int) $related[ 'id' ];
7244
                                else {
7245
                                    foreach ( $related as $r ) {
7246
                                        $related_ids[] = (int) $r;
7247
                                    }
7248
                                }
7249
                            }
7250
                            else
7251
                                $related_ids[] = (int) $related;
7252
                        }
7253
                    }
7254
                }
7255
                else {
7256
                    $related_id = get_metadata( $meta_type, $id, '_pods_' . $field[ 'name' ], true );
7257
7258
                    if ( empty( $related_id ) )
7259
                        $related_id = get_metadata( $meta_type, $id, $field[ 'name' ] );
7260
7261
                    if ( is_array( $related_id ) && !empty( $related_id ) ) {
7262
                        foreach ( $related_id as $related ) {
7263
                            if ( is_array( $related ) && !empty( $related ) ) {
7264
                                if ( isset( $related[ 'id' ] ) )
7265
                                    $related_ids[] = (int) $related[ 'id' ];
7266
                                else {
7267
                                    foreach ( $related as $r ) {
7268
                                        if ( isset( $related[ 'id' ] ) )
7269
                                            $related_ids[] = (int) $r[ 'id' ];
7270
                                        else
7271
                                            $related_ids[] = (int) $r;
7272
                                    }
7273
                                }
7274
                            }
7275
                            else
7276
                                $related_ids[] = (int) $related;
7277
                        }
7278
                    }
7279
                }
7280
7281
                if ( !$no_conflict )
7282
                    pods_no_conflict_off( ( 'term' == $meta_type ? 'taxonomy' : $meta_type ) );
7283
            }
7284
        }
7285
7286
        if ( is_array( $related_ids ) )
7287
            $related_ids = array_unique( array_filter( $related_ids ) );
7288
7289
        return $related_ids;
7290
    }
7291
7292
	/**
7293
	 *
7294
	 * Load the information about an objects MySQL table
7295
	 *
7296
	 * @param $object_type
7297
	 * @param string $object The object to look for
7298
	 * @param null $name (optional) Name of the pod to load
7299
	 * @param array $pod (optional) Array with pod information
7300
	 *
7301
	 * @return array
7302
	 *
7303
	 * @since 2.5
7304
	 */
7305
	public function get_table_info_load ( $object_type, $object, $name = null, $pod = null ) {
7306
7307
		$info = array();
7308
7309
		if ( 'pod' == $object_type && null === $pod ) {
7310 View Code Duplication
			if ( empty( $name ) ) {
7311
				$prefix = 'pod-';
7312
7313
				// Make sure we actually have the prefix before trying anything with the name
7314
				if ( 0 === strpos( $object_type, $prefix ) )
7315
					$name = substr( $object_type, strlen( $prefix ), strlen( $object_type ) );
7316
			}
7317
7318
			if ( empty( $name ) && !empty( $object ) )
7319
				$name = $object;
7320
7321
			$pod = $this->load_pod( array( 'name' => $name, 'table_info' => false ), false );
7322
7323
			if ( !empty( $pod ) ) {
7324
				$object_type = $pod[ 'type' ];
7325
				$name = $pod[ 'name' ];
7326
				$object = $pod[ 'object' ];
7327
7328
				$info[ 'pod' ] = $pod;
7329
			}
7330
		}
7331
		elseif ( null === $pod ) {
7332
			if ( empty( $name ) ) {
7333
				$prefix = $object_type . '-';
7334
7335
				// Make sure we actually have the prefix before trying anything with the name
7336
				if ( 0 === strpos( $object_type, $prefix ) )
7337
					$name = substr( $object_type, strlen( $prefix ), strlen( $object_type ) );
7338
			}
7339
7340
			if ( empty( $name ) && !empty( $object ) )
7341
				$name = $object;
7342
7343
			if ( !empty( $name ) ) {
7344
				$pod = $this->load_pod( array( 'name' => $name, 'table_info' => false ), false );
7345
7346
				if ( !empty( $pod ) && ( null === $object_type || $object_type == $pod[ 'type' ] ) ) {
7347
					$object_type = $pod[ 'type' ];
7348
					$name = $pod[ 'name' ];
7349
					$object = $pod[ 'object' ];
7350
7351
					$info[ 'pod' ] = $pod;
7352
				}
7353
			}
7354
		}
7355
		elseif ( !empty( $pod ) )
7356
			$info[ 'pod' ] = $pod;
7357
7358
		if ( 0 === strpos( $object_type, 'pod' ) ) {
7359 View Code Duplication
			if ( empty( $name ) ) {
7360
				$prefix = 'pod-';
7361
7362
				// Make sure we actually have the prefix before trying anything with the name
7363
				if ( 0 === strpos( $object_type, $prefix ) )
7364
					$name = substr( $object_type, strlen( $prefix ), strlen( $object_type ) );
7365
			}
7366
7367
			$info[ 'type' ] = 'pod';
7368
			global $wpdb;
0 ignored issues
show
Compatibility Best Practice introduced by
Use of global functionality is not recommended; it makes your code harder to test, and less reusable.

Instead of relying on global state, we recommend one of these alternatives:

1. Pass all data via parameters

function myFunction($a, $b) {
    // Do something
}

2. Create a class that maintains your state

class MyClass {
    private $a;
    private $b;

    public function __construct($a, $b) {
        $this->a = $a;
        $this->b = $b;
    }

    public function myFunction() {
        // Do something
    }
}
Loading history...
7369
7370
			$info[ 'table' ] = $info[ 'meta_table' ] = $wpdb->prefix . 'pods_' . ( empty( $object ) ? $name : $object );
7371
7372
			if ( is_array( $info[ 'pod' ] ) && 'pod' == pods_v( 'type', $info[ 'pod' ] ) ) {
7373
				$info[ 'pod_field_index' ] = $info[ 'field_index' ] = $info[ 'meta_field_index' ] = $info[ 'meta_field_value' ] = pods_v( 'pod_index', $info[ 'pod' ][ 'options' ], 'id', true );
7374
7375
				$slug_field = get_posts( array(
7376
					'post_type' => '_pods_field',
7377
					'posts_per_page' => 1,
7378
					'nopaging' => true,
7379
					'post_parent' => $info[ 'pod' ][ 'id' ],
7380
					'orderby' => 'menu_order',
7381
					'order' => 'ASC',
7382
					'meta_query' => array(
7383
						array(
7384
							'key' => 'type',
7385
							'value' => 'slug',
7386
						)
7387
					)
7388
				) );
7389
7390
				if ( !empty( $slug_field ) ) {
7391
					$slug_field = $slug_field[ 0 ];
7392
7393
					$info[ 'field_slug' ] = $info[ 'pod_field_slug' ] = $slug_field->post_name;
7394
				}
7395
7396
				if ( 1 == pods_v( 'hierarchical', $info[ 'pod' ][ 'options' ], 0 ) ) {
7397
					$parent_field = pods_v( 'pod_parent', $info[ 'pod' ][ 'options' ], 'id', true );
7398
7399
					if ( !empty( $parent_field ) && isset( $info[ 'pod' ][ 'fields' ][ $parent_field ] ) ) {
7400
						$info[ 'object_hierarchical' ] = true;
7401
7402
						$info[ 'pod_field_parent' ] = $info[ 'field_parent' ] = $parent_field . '_select';
7403
						$info[ 'field_parent_select' ] = '`' . $parent_field . '`.`id` AS `' . $info[ 'field_parent' ] . '`';
7404
					}
7405
				}
7406
			}
7407
		}
7408
		return $info;
7409
	}
7410
7411
    /**
7412
     * Get information about an objects MySQL table
7413
     *
7414
     * @param string $object_type
7415
     * @param string $object The object to look for
7416
     * @param null $name (optional) Name of the pod to load
7417
     * @param array $pod (optional) Array with pod information
7418
     * @param array $field (optional) Array with field information
7419
     *
7420
     * @return array|bool
7421
     *
7422
     * @since 2.0
7423
     */
7424
    public function get_table_info ( $object_type, $object, $name = null, $pod = null, $field = null ) {
7425
7426
	    /**
7427
	     * @var $wpdb                         wpdb
7428
	     * @var $sitepress                    SitePress
7429
	     * @var $polylang                     object
7430
	     */
7431
	    /*
7432
	     * @todo wpml-comp Remove global object usage
7433
	     */
7434
        global $wpdb, $sitepress, $polylang;
0 ignored issues
show
Compatibility Best Practice introduced by
Use of global functionality is not recommended; it makes your code harder to test, and less reusable.

Instead of relying on global state, we recommend one of these alternatives:

1. Pass all data via parameters

function myFunction($a, $b) {
    // Do something
}

2. Create a class that maintains your state

class MyClass {
    private $a;
    private $b;

    public function __construct($a, $b) {
        $this->a = $a;
        $this->b = $b;
    }

    public function myFunction() {
        // Do something
    }
}
Loading history...
7435
7436
		// @todo Handle $object arrays for Post Types, Taxonomies, Comments (table pulled from first object in array)
7437
7438
        $info = array(
7439
            //'select' => '`t`.*',
0 ignored issues
show
Unused Code Comprehensibility introduced by
67% of this comment could be valid code. Did you maybe forget this after debugging?

Sometimes obsolete code just ends up commented out instead of removed. In this case it is better to remove the code once you have checked you do not need it.

The code might also have been commented out for debugging purposes. In this case it is vital that someone uncomments it again or your project may behave in very unexpected ways in production.

This check looks for comments that seem to be mostly valid code and reports them.

Loading history...
7440
            'object_type' => $object_type,
7441
            'type' => null,
7442
            'object_name' => $object,
7443
            'object_hierarchical' => false,
7444
7445
            'table' => $object,
7446
            'meta_table' => $object,
7447
            'pod_table' => $wpdb->prefix . 'pods_' . ( empty( $object ) ? $name : $object ),
7448
7449
            'field_id' => 'id',
7450
            'field_index' => 'name',
7451
            'field_slug' => null,
7452
            'field_type' => null,
7453
            'field_parent' => null,
7454
            'field_parent_select' => null,
7455
7456
            'meta_field_id' => 'id',
7457
            'meta_field_index' => 'name',
7458
            'meta_field_value' => 'name',
7459
7460
            'pod_field_id' => 'id',
7461
            'pod_field_index' => 'name',
7462
            'pod_field_slug' => null,
7463
            'pod_field_parent' => null,
7464
7465
            'join' => array(),
7466
7467
            'where' => null,
7468
            'where_default' => null,
7469
7470
            'orderby' => null,
7471
7472
            'pod' => null,
7473
            'recurse' => false
7474
        );
7475
7476
        if ( empty( $object_type ) ) {
7477
            $object_type = 'post_type';
7478
            $object = 'post';
7479
        }
7480
	    elseif ( empty( $object ) && in_array( $object_type, array( 'user', 'media', 'comment' ) ) ) {
7481
		    $object = $object_type;
7482
	    }
7483
7484
        $pod_name = $pod;
7485
7486 View Code Duplication
        if ( is_array( $pod_name ) )
7487
            $pod_name = pods_var_raw( 'name', $pod_name, ( version_compare( PHP_VERSION, '5.4.0', '>=' ) ? json_encode( $pod_name, JSON_UNESCAPED_UNICODE ) : json_encode( $pod_name ) ), null, true );
0 ignored issues
show
Unused Code introduced by
The call to json_encode() has too many arguments starting with JSON_UNESCAPED_UNICODE.

This check compares calls to functions or methods with their respective definitions. If the call has more arguments than are defined, it raises an issue.

If a function is defined several times with a different number of parameters, the check may pick up the wrong definition and report false positives. One codebase where this has been known to happen is Wordpress.

In this case you can add the @ignore PhpDoc annotation to the duplicate definition and it will be ignored.

Loading history...
7488
	    else {
7489
		    $pod_name = $object;
7490
	    }
7491
7492
        $field_name = $field;
7493
7494 View Code Duplication
        if ( is_array( $field_name ) )
7495
            $field_name = pods_var_raw( 'name', $field_name, ( version_compare( PHP_VERSION, '5.4.0', '>=' ) ? json_encode( $pod_name, JSON_UNESCAPED_UNICODE ) : json_encode( $field_name ) ), null, true );
0 ignored issues
show
Unused Code introduced by
The call to json_encode() has too many arguments starting with JSON_UNESCAPED_UNICODE.

This check compares calls to functions or methods with their respective definitions. If the call has more arguments than are defined, it raises an issue.

If a function is defined several times with a different number of parameters, the check may pick up the wrong definition and report false positives. One codebase where this has been known to happen is Wordpress.

In this case you can add the @ignore PhpDoc annotation to the duplicate definition and it will be ignored.

Loading history...
7496
7497
        $transient = 'pods_' . $wpdb->prefix . '_get_table_info_' . md5( $object_type . '_object_' . $object . '_name_' . $name . '_pod_' . $pod_name . '_field_' . $field_name );
7498
7499
        $current_language = false;
7500
        $current_language_t_id = $current_language_tt_id = 0;
7501
7502
	    // Get current language data
7503
		$lang_data = self::get_current_language();
7504
7505
	    if ( $lang_data ) {
0 ignored issues
show
Bug Best Practice introduced by
The expression $lang_data of type array is implicitly converted to a boolean; are you sure this is intended? If so, consider using ! empty($expr) instead to make it clear that you intend to check for an array without elements.

This check marks implicit conversions of arrays to boolean values in a comparison. While in PHP an empty array is considered to be equal (but not identical) to false, this is not always apparent.

Consider making the comparison explicit by using empty(..) or ! empty(...) instead.

Loading history...
7506
		    if ( ! empty( $lang_data['language'] ) ) {
7507
			    $current_language = $lang_data['language'];
7508
		    }
7509
7510
		    if ( ! empty( $lang_data['t_id'] ) ) {
7511
			    $current_language_t_id = $lang_data['t_id'];
7512
		    }
7513
7514
		    if ( ! empty( $lang_data['tt_id'] ) ) {
7515
			    $current_language_tt_id = $lang_data['tt_id'];
7516
		    }
7517
7518
		    if ( ! empty( $lang_data['tl_t_id'] ) ) {
7519
			    $current_language_tl_t_id = $lang_data['tl_t_id'];
7520
		    }
7521
7522
		    if ( ! empty( $lang_data['tl_tt_id'] ) ) {
7523
			    $current_language_tl_tt_id = $lang_data['tl_tt_id'];
7524
		    }
7525
	    }
7526
7527
        if ( !empty( $current_language ) )
7528
            $transient = 'pods_' . $wpdb->prefix . '_get_table_info_' . $current_language . '_' . md5( $object_type . '_object_' . $object . '_name_' . $name . '_pod_' . $pod_name . '_field_' . $field_name );
7529
7530
        $_info = false;
7531
7532
	    if ( isset( self::$table_info_cache[ $transient ] ) ) {
7533
		    // Prefer info from the object internal cache
7534
		    $_info = self::$table_info_cache[ $transient ];
7535
	    } elseif ( pods_api_cache() ) {
7536
		    $_info = pods_transient_get( $transient );
7537
		    if ( false === $_info && ! did_action( 'init' ) ) {
7538
			    $_info = pods_transient_get( $transient . '_pre_init' );
7539
		    }
7540
	    }
7541
7542
	    if ( false !== $_info && is_array( $_info ) ) {
7543
		    // Data was cached, use that
7544
		    $info = $_info;
7545
	    } else {
7546
	        // Data not cached, load it up
7547
		    $_info = $this->get_table_info_load( $object_type, $object, $name, $pod );
7548
		    if ( isset( $_info[ 'type' ] ) ) {
7549
			    // Allow function to override $object_type
7550
			    $object_type = $_info[ 'type' ];
7551
		    }
7552
		    $info = array_merge( $info, $_info );
7553
	    }
7554
7555
	    if ( 0 === strpos( $object_type, 'post_type' ) || 'media' == $object_type || in_array( pods_var_raw( 'type', $info[ 'pod' ] ), array( 'post_type', 'media' ) ) ) {
7556
		    $info[ 'table' ] = $wpdb->posts;
7557
		    $info[ 'meta_table' ] = $wpdb->postmeta;
7558
7559
		    $info[ 'field_id' ] = 'ID';
7560
		    $info[ 'field_index' ] = 'post_title';
7561
		    $info[ 'field_slug' ] = 'post_name';
7562
		    $info[ 'field_type' ] = 'post_type';
7563
		    $info[ 'field_parent' ] = 'post_parent';
7564
		    $info[ 'field_parent_select' ] = '`t`.`' . $info[ 'field_parent' ] . '`';
7565
7566
		    $info[ 'meta_field_id' ] = 'post_id';
7567
		    $info[ 'meta_field_index' ] = 'meta_key';
7568
		    $info[ 'meta_field_value' ] = 'meta_value';
7569
7570
		    if ( 'media' == $object_type )
7571
			    $object = 'attachment';
7572
7573
		    if ( empty( $name ) ) {
7574
			    $prefix = 'post_type-';
7575
7576
			    // Make sure we actually have the prefix before trying anything with the name
7577
			    if ( 0 === strpos( $object_type, $prefix ) )
7578
				    $name = substr( $object_type, strlen( $prefix ), strlen( $object_type ) );
7579
		    }
7580
7581
		    if ( 'media' != $object_type )
7582
			    $object_type = 'post_type';
7583
7584
		    $post_type = pods_sanitize( ( empty( $object ) ? $name : $object ) );
7585
7586
		    if ( 'attachment' == $post_type || 'media' == $object_type )
7587
			    $info[ 'pod_table' ] = $wpdb->prefix . 'pods_media';
7588
		    else
7589
			    $info[ 'pod_table' ] = $wpdb->prefix . 'pods_' . pods_clean_name( $post_type, true, false );
7590
7591
		    $post_type_object = get_post_type_object( $post_type );
7592
7593
		    if ( is_object( $post_type_object ) && $post_type_object->hierarchical )
7594
			    $info[ 'object_hierarchical' ] = true;
7595
7596
            // Post Status default
7597
            $post_status = array( 'publish' );
7598
7599
            // Pick field post_status option
7600
            if ( ! empty( $field['pick_post_status'] ) ) {
7601
                $post_status = (array) $field['pick_post_status'];
7602
            }
7603
7604
		    /**
7605
		     * Default Post Status to query for.
7606
		     *
7607
		     * Use to change "default" post status from publish to any other status or statuses.
7608
		     *
7609
		     * @param  array $post_status List of post statuses. Default is 'publish' or field setting (if available)
7610
		     * @param  string $post_type Post type of current object
7611
		     * @param  array $info Array of information about the object.
7612
		     * @param  string $object	Type of object
7613
		     * @param  string $name Name of pod to load
7614
		     * @param  array $pod Array with Pod information. Result of PodsAPI::load_pod()
7615
		     * @param  array $field		Array with field information
7616
		     *
7617
		     * @since unknown
7618
		     */
7619
		    $post_status = apply_filters( 'pods_api_get_table_info_default_post_status', $post_status, $post_type, $info, $object_type, $object, $name, $pod, $field );
7620
7621
		    $info[ 'where' ] = array(
7622
			    //'post_status' => '`t`.`post_status` IN ( "inherit", "publish" )', // @todo Figure out what statuses Attachments can be
0 ignored issues
show
Unused Code Comprehensibility introduced by
58% of this comment could be valid code. Did you maybe forget this after debugging?

Sometimes obsolete code just ends up commented out instead of removed. In this case it is better to remove the code once you have checked you do not need it.

The code might also have been commented out for debugging purposes. In this case it is vital that someone uncomments it again or your project may behave in very unexpected ways in production.

This check looks for comments that seem to be mostly valid code and reports them.

Loading history...
7623
			    'post_type' => '`t`.`' . $info[ 'field_type' ] . '` = "' . $post_type . '"'
7624
		    );
7625
7626
		    if ( 'post_type' == $object_type )
7627
			    $info[ 'where_default' ] = '`t`.`post_status` IN ( "' . implode( '", "', $post_status ) . '" )';
7628
7629
		    $info[ 'orderby' ] = '`t`.`menu_order`, `t`.`' . $info[ 'field_index' ] . '`, `t`.`post_date`';
7630
7631
            /*
7632
             * @todo wpml-comp Check if WPML filters can be applied afterwards
7633
             */
7634
		    // WPML support
7635
		    if ( did_action( 'wpml_loaded' ) && !empty( $current_language ) && apply_filters( 'wpml_is_translated_post_type', false, $post_type ) && apply_filters( 'wpml_setting', true, 'auto_adjust_ids' )) {
7636
			    $info[ 'join' ][ 'wpml_translations' ] = "
7637
                        LEFT JOIN `{$wpdb->prefix}icl_translations` AS `wpml_translations`
7638
                            ON `wpml_translations`.`element_id` = `t`.`ID`
7639
                                AND `wpml_translations`.`element_type` = 'post_{$post_type}'
7640
                                AND `wpml_translations`.`language_code` = '{$current_language}'
7641
                    ";
7642
7643
			    $info[ 'join' ][ 'wpml_languages' ] = "
7644
                        LEFT JOIN `{$wpdb->prefix}icl_languages` AS `wpml_languages`
7645
                            ON `wpml_languages`.`code` = `wpml_translations`.`language_code` AND `wpml_languages`.`active` = 1
7646
                    ";
7647
7648
			    $info[ 'where' ][ 'wpml_languages' ] = "`wpml_languages`.`code` IS NOT NULL";
7649
		    }
7650
		    // Polylang support
7651 View Code Duplication
		    elseif( ( function_exists( 'PLL' ) || is_object( $polylang ) ) && !empty( $current_language ) && function_exists( 'pll_is_translated_post_type' ) && pll_is_translated_post_type( $post_type ) ) {
7652
			    $info[ 'join' ][ 'polylang_languages' ] = "
7653
                        LEFT JOIN `{$wpdb->term_relationships}` AS `polylang_languages`
7654
                            ON `polylang_languages`.`object_id` = `t`.`ID`
7655
                                AND `polylang_languages`.`term_taxonomy_id` = {$current_language_tt_id}
7656
                    ";
7657
7658
			    $info[ 'where' ][ 'polylang_languages' ] = "`polylang_languages`.`object_id` IS NOT NULL";
7659
		    }
7660
7661
		    $info[ 'object_fields' ] = $this->get_wp_object_fields( $object_type, $info[ 'pod' ] );
7662
	    }
7663
	    elseif ( 0 === strpos( $object_type, 'taxonomy' ) || in_array( $object_type, array( 'nav_menu', 'post_format' ) ) || 'taxonomy' == pods_var_raw( 'type', $info[ 'pod' ] ) ) {
7664
		    $info[ 'table' ] = $info[ 'meta_table' ] = $wpdb->terms;
7665
7666
		    $info[ 'join' ][ 'tt' ] = "LEFT JOIN `{$wpdb->term_taxonomy}` AS `tt` ON `tt`.`term_id` = `t`.`term_id`";
7667
		    $info[ 'join' ][ 'tr' ] = "LEFT JOIN `{$wpdb->term_relationships}` AS `tr` ON `tr`.`term_taxonomy_id` = `tt`.`term_taxonomy_id`";
7668
		    $info[ 'field_id' ] = $info[ 'meta_field_id' ] = 'term_id';
7669
		    $info[ 'field_index' ] = $info[ 'meta_field_index' ] = $info[ 'meta_field_value' ] = 'name';
7670
		    $info[ 'field_slug' ] = 'slug';
7671
		    $info[ 'field_type' ] = 'taxonomy';
7672
		    $info[ 'field_parent' ] = 'parent';
7673
		    $info[ 'field_parent_select' ] = '`tt`.`' . $info[ 'field_parent' ] . '`';
7674
7675
            if ( ! empty( $wpdb->termmeta ) ) {
7676
                $info[ 'meta_table' ] = $wpdb->termmeta;
7677
7678
                $info[ 'meta_field_id' ] = 'term_id';
7679
                $info[ 'meta_field_index' ] = 'meta_key';
7680
                $info[ 'meta_field_value' ] = 'meta_value';
7681
            }
7682
7683
		    if ( 'nav_menu' == $object_type )
7684
			    $object = 'nav_menu';
7685
		    elseif ( 'post_format' == $object_type )
7686
			    $object = 'post_format';
7687
7688
		    if ( empty( $name ) ) {
7689
			    $prefix = 'taxonomy-';
7690
7691
			    // Make sure we actually have the prefix before trying anything with the name
7692
			    if ( 0 === strpos( $object_type, $prefix ) )
7693
				    $name = substr( $object_type, strlen( $prefix ), strlen( $object_type ) );
7694
		    }
7695
7696
		    if ( !in_array( $object_type, array( 'nav_menu', 'post_format' ) ) )
7697
			    $object_type = 'taxonomy';
7698
7699
		    $taxonomy = pods_sanitize( ( empty( $object ) ? $name : $object ) );
7700
7701
		    $info[ 'pod_table' ] = $wpdb->prefix . 'pods_' . pods_clean_name( $taxonomy, true, false );
7702
7703
		    $taxonomy_object = get_taxonomy( $taxonomy );
7704
7705
		    if ( is_object( $taxonomy_object ) && $taxonomy_object->hierarchical )
7706
			    $info[ 'object_hierarchical' ] = true;
7707
7708
		    $info[ 'where' ] = array(
7709
			    'tt.taxonomy' => '`tt`.`' . $info[ 'field_type' ] . '` = "' . $taxonomy . '"'
7710
		    );
7711
7712
            /*
7713
             * @todo wpml-comp WPML API call for is_translated_taxononomy
7714
             * @todo wpml-comp Check if WPML filters can be applied afterwards
7715
             */
7716
		    // WPML Support
7717
		    if ( is_object( $sitepress ) && !empty( $current_language ) && $sitepress->is_translated_taxonomy( $taxonomy ) && apply_filters( 'wpml_setting', true, 'auto_adjust_ids' ) ) {
7718
			    $info[ 'join' ][ 'wpml_translations' ] = "
7719
                        LEFT JOIN `{$wpdb->prefix}icl_translations` AS `wpml_translations`
7720
                            ON `wpml_translations`.`element_id` = `tt`.`term_taxonomy_id`
7721
                                AND `wpml_translations`.`element_type` = 'tax_{$taxonomy}'
7722
                                AND `wpml_translations`.`language_code` = '{$current_language}'
7723
                    ";
7724
7725
			    $info[ 'join' ][ 'wpml_languages' ] = "
7726
                        LEFT JOIN `{$wpdb->prefix}icl_languages` AS `wpml_languages`
7727
                            ON `wpml_languages`.`code` = `wpml_translations`.`language_code` AND `wpml_languages`.`active` = 1
7728
                    ";
7729
7730
			    $info[ 'where' ][ 'wpml_languages' ] = "`wpml_languages`.`code` IS NOT NULL";
7731
		    }
7732
		    // Polylang support
7733 View Code Duplication
		    elseif ( ( function_exists( 'PLL' ) || is_object( $polylang ) ) && !empty( $current_language ) && !empty( $current_language_tl_tt_id ) && function_exists( 'pll_is_translated_taxonomy' ) && pll_is_translated_taxonomy( $taxonomy ) ) {
7734
				$info[ 'join' ][ 'polylang_languages' ] = "
7735
					LEFT JOIN `{$wpdb->term_relationships}` AS `polylang_languages`
7736
						ON `polylang_languages`.`object_id` = `t`.`term_id`
7737
							AND `polylang_languages`.`term_taxonomy_id` = {$current_language_tl_tt_id}
7738
				";
7739
7740
			    $info[ 'where' ][ 'polylang_languages' ] = "`polylang_languages`.`object_id` IS NOT NULL";
7741
		    }
7742
7743
		    $info[ 'object_fields' ] = $this->get_wp_object_fields( $object_type, $info[ 'pod' ] );
7744
	    }
7745
	    elseif ( 'user' == $object_type || 'user' == pods_var_raw( 'type', $info[ 'pod' ] ) ) {
7746
		    $info[ 'table' ] = $wpdb->users;
7747
		    $info[ 'meta_table' ] = $wpdb->usermeta;
7748
		    $info[ 'pod_table' ] = $wpdb->prefix . 'pods_user';
7749
7750
		    $info[ 'field_id' ] = 'ID';
7751
		    $info[ 'field_index' ] = 'display_name';
7752
		    $info[ 'field_slug' ] = 'user_nicename';
7753
7754
		    $info[ 'meta_field_id' ] = 'user_id';
7755
		    $info[ 'meta_field_index' ] = 'meta_key';
7756
		    $info[ 'meta_field_value' ] = 'meta_value';
7757
7758
		    $info[ 'where' ] = array(
7759
			    'user_status' => '`t`.`user_status` = 0'
7760
		    );
7761
7762
		    $info[ 'object_fields' ] = $this->get_wp_object_fields( $object_type, $info[ 'pod' ] );
7763
	    }
7764
	    elseif ( 'comment' == $object_type || 'comment' == pods_var_raw( 'type', $info[ 'pod' ] ) ) {
7765
		    //$info[ 'object_hierarchical' ] = true;
0 ignored issues
show
Unused Code Comprehensibility introduced by
55% of this comment could be valid code. Did you maybe forget this after debugging?

Sometimes obsolete code just ends up commented out instead of removed. In this case it is better to remove the code once you have checked you do not need it.

The code might also have been commented out for debugging purposes. In this case it is vital that someone uncomments it again or your project may behave in very unexpected ways in production.

This check looks for comments that seem to be mostly valid code and reports them.

Loading history...
7766
7767
		    $info[ 'table' ] = $wpdb->comments;
7768
		    $info[ 'meta_table' ] = $wpdb->commentmeta;
7769
		    $info[ 'pod_table' ] = $wpdb->prefix . 'pods_comment';
7770
7771
		    $info[ 'field_id' ] = 'comment_ID';
7772
		    $info[ 'field_index' ] = 'comment_date';
7773
		    $info[ 'field_type' ] = 'comment_type';
7774
		    $info[ 'field_parent' ] = 'comment_parent';
7775
		    $info[ 'field_parent_select' ] = '`t`.`' . $info[ 'field_parent' ] . '`';
7776
7777
		    $info[ 'meta_field_id' ] = 'comment_id';
7778
		    $info[ 'meta_field_index' ] = 'meta_key';
7779
		    $info[ 'meta_field_value' ] = 'meta_value';
7780
7781
		    $object = 'comment';
7782
7783
		    $comment_type = ( empty( $object ) ? $name : $object );
7784
7785
		    $comment_type_clause = '`t`.`' . $info[ 'field_type' ] . '` = "' . $comment_type . '"';
7786
7787
		    if ( 'comment' == $comment_type ) {
7788
			    $comment_type_clause = '( ' . $comment_type_clause . ' OR `t`.`' . $info[ 'field_type' ] . '` = "" )';
7789
		    }
7790
7791
		    $info[ 'where' ] = array(
7792
			    'comment_approved' => '`t`.`comment_approved` = 1',
7793
			    'comment_type' => $comment_type_clause
7794
		    );
7795
7796
		    $info[ 'orderby' ] = '`t`.`' . $info[ 'field_index' ] . '` DESC, `t`.`' . $info[ 'field_id' ] . '`';
7797
	    }
7798 View Code Duplication
	    elseif ( in_array( $object_type, array( 'option', 'settings' ) ) || 'settings' == pods_var_raw( 'type', $info[ 'pod' ] ) ) {
7799
		    $info[ 'table' ] = $wpdb->options;
7800
		    $info[ 'meta_table' ] = $wpdb->options;
7801
7802
		    $info[ 'field_id' ] = 'option_id';
7803
		    $info[ 'field_index' ] = 'option_name';
7804
7805
		    $info[ 'meta_field_id' ] = 'option_id';
7806
		    $info[ 'meta_field_index' ] = 'option_name';
7807
		    $info[ 'meta_field_value' ] = 'option_value';
7808
7809
		    $info[ 'orderby' ] = '`t`.`' . $info[ 'field_index' ] . '` ASC';
7810
	    }
7811 View Code Duplication
	    elseif ( is_multisite() && ( in_array( $object_type, array( 'site_option', 'site_settings' ) ) || 'site_settings' == pods_var_raw( 'type', $info[ 'pod' ] ) ) ) {
7812
		    $info[ 'table' ] = $wpdb->sitemeta;
7813
		    $info[ 'meta_table' ] = $wpdb->sitemeta;
7814
7815
		    $info[ 'field_id' ] = 'site_id';
7816
		    $info[ 'field_index' ] = 'meta_key';
7817
7818
		    $info[ 'meta_field_id' ] = 'site_id';
7819
		    $info[ 'meta_field_index' ] = 'meta_key';
7820
		    $info[ 'meta_field_value' ] = 'meta_value';
7821
7822
		    $info[ 'orderby' ] = '`t`.`' . $info[ 'field_index' ] . '` ASC';
7823
	    }
7824
	    elseif ( is_multisite() && 'network' == $object_type ) { // Network = Site
7825
		    $info[ 'table' ] = $wpdb->site;
7826
		    $info[ 'meta_table' ] = $wpdb->sitemeta;
7827
7828
		    $info[ 'field_id' ] = 'id';
7829
		    $info[ 'field_index' ] = 'domain';
7830
7831
		    $info[ 'meta_field_id' ] = 'site_id';
7832
		    $info[ 'meta_field_index' ] = 'meta_key';
7833
		    $info[ 'meta_field_value' ] = 'meta_value';
7834
7835
		    $info[ 'orderby' ] = '`t`.`' . $info[ 'field_index' ] . '` ASC, `t`.`path` ASC, `t`.`' . $info[ 'field_id' ] . '`';
7836
	    }
7837
	    elseif ( is_multisite() && 'site' == $object_type ) { // Site = Blog
7838
		    $info[ 'table' ] = $wpdb->blogs;
7839
7840
		    $info[ 'field_id' ] = 'blog_id';
7841
		    $info[ 'field_index' ] = 'domain';
7842
		    $info[ 'field_type' ] = 'site_id';
7843
7844
		    $info[ 'where' ] = array(
7845
			    'archived' => '`t`.`archived` = 0',
7846
			    'spam' => '`t`.`spam` = 0',
7847
			    'deleted' => '`t`.`deleted` = 0',
7848
			    'site_id' => '`t`.`' . $info[ 'field_type' ] . '` = ' . (int) get_current_site()->id
7849
		    );
7850
7851
		    $info[ 'orderby' ] = '`t`.`' . $info[ 'field_index' ] . '` ASC, `t`.`path` ASC, `t`.`' . $info[ 'field_id' ] . '`';
7852
	    }
7853
	    elseif ( 'table' == $object_type || 'table' == pods_var_raw( 'type', $info[ 'pod' ] ) ) {
7854
		    $info[ 'table' ] = ( empty( $object ) ? $name : $object );
7855
		    $info[ 'pod_table' ] = $wpdb->prefix . 'pods_' . $info[ 'table' ];
7856
7857
		    if ( !empty( $field ) && is_array( $field ) ) {
7858
			    $info[ 'table' ] = pods_var_raw( 'pick_table', pods_var_raw( 'options', $field, $field ) );
7859
			    $info[ 'field_id' ] = pods_var_raw( 'pick_table_id', pods_var_raw( 'options', $field, $field ) );
7860
			    $info[ 'field_index' ] = $info[ 'meta_field_index' ] = $info[ 'meta_field_value' ] = pods_var_raw( 'pick_table_index', pods_var_raw( 'options', $field, $field ) );
7861
		    }
7862
	    }
7863
7864
	    $info[ 'table' ] = pods_clean_name( $info[ 'table' ], false, false );
7865
	    $info[ 'meta_table' ] = pods_clean_name( $info[ 'meta_table' ], false, false );
7866
	    $info[ 'pod_table' ] = pods_clean_name( $info[ 'pod_table' ], false, false );
7867
7868
	    $info[ 'field_id' ] = pods_clean_name( $info[ 'field_id' ], false, false );
7869
	    $info[ 'field_index' ] = pods_clean_name( $info[ 'field_index' ], false, false );
7870
	    $info[ 'field_slug' ] = pods_clean_name( $info[ 'field_slug' ], false, false );
7871
7872
	    $info[ 'meta_field_id' ] = pods_clean_name( $info[ 'meta_field_id' ], false, false );
7873
	    $info[ 'meta_field_index' ] = pods_clean_name( $info[ 'meta_field_index' ], false, false );
7874
	    $info[ 'meta_field_value' ] = pods_clean_name( $info[ 'meta_field_value' ], false, false );
7875
7876 View Code Duplication
	    if ( empty( $info[ 'orderby' ] ) )
7877
		    $info[ 'orderby' ] = '`t`.`' . $info[ 'field_index' ] . '`, `t`.`' . $info[ 'field_id' ] . '`';
7878
7879
	    if ( 'table' == pods_var_raw( 'storage', $info[ 'pod' ] ) && !in_array( $object_type, array( 'pod', 'table' ) ) ) {
7880
		    $info[ 'join' ][ 'd' ] = 'LEFT JOIN `' . $info[ 'pod_table' ] . '` AS `d` ON `d`.`id` = `t`.`' . $info[ 'field_id' ] . '`';
7881
		    //$info[ 'select' ] .= ', `d`.*';
0 ignored issues
show
Unused Code Comprehensibility introduced by
50% of this comment could be valid code. Did you maybe forget this after debugging?

Sometimes obsolete code just ends up commented out instead of removed. In this case it is better to remove the code once you have checked you do not need it.

The code might also have been commented out for debugging purposes. In this case it is vital that someone uncomments it again or your project may behave in very unexpected ways in production.

This check looks for comments that seem to be mostly valid code and reports them.

Loading history...
7882
	    }
7883
7884
	    if ( !empty( $info[ 'pod' ] ) && is_array( $info[ 'pod' ] ) )
7885
		    $info[ 'recurse' ] = true;
7886
7887
	    $info[ 'type' ] = $object_type;
7888
	    $info[ 'object_name' ] = $object;
7889
7890
	    if ( pods_api_cache() ) {
7891
		    if ( ! did_action( 'init' ) ) {
7892
			    $transient .= '_pre_init';
7893
		    }
7894
		    pods_transient_set( $transient, $info );
7895
	    }
7896
7897
7898
	    self::$table_info_cache[ $transient ] = apply_filters( 'pods_api_get_table_info', $info, $object_type, $object, $name, $pod, $field, $this );
7899
7900
        return self::$table_info_cache[ $transient ];
7901
    }
7902
7903
    /**
7904
     * Export a package
7905
     *
7906
     * $params['pod'] string Pod Type IDs to export
7907
     * $params['template'] string Template IDs to export
7908
     * $params['podpage'] string Pod Page IDs to export
7909
     * $params['helper'] string Helper IDs to export
7910
     *
7911
     * @param array $params An associative array of parameters
7912
     *
7913
     * @return array|bool
7914
     *
7915
     * @since 1.9.0
7916
     * @deprecated 2.0
7917
     */
7918
    public function export_package ( $params ) {
7919
        if ( class_exists( 'Pods_Migrate_Packages' ) )
7920
            return Pods_Migrate_Packages::export( $params );
7921
7922
        return false;
7923
    }
7924
7925
    /**
7926
     * Replace an existing package
7927
     *
7928
     * @param mixed $data (optional) An associative array containing a package, or the json encoded package
7929
     *
7930
     * @return bool
7931
     *
7932
     * @since 1.9.8
7933
     * @deprecated 2.0
7934
     */
7935
    public function replace_package ( $data = false ) {
7936
        return $this->import_package( $data, true );
0 ignored issues
show
Deprecated Code introduced by
The method PodsAPI::import_package() has been deprecated with message: 2.0

This method has been deprecated. The supplier of the class has supplied an explanatory message.

The explanatory message should give you some clue as to whether and when the method will be removed from the class and what other method or class to use instead.

Loading history...
7937
    }
7938
7939
    /**
7940
     * Import a package
7941
     *
7942
     * @param mixed $data (optional) An associative array containing a package, or the json encoded package
7943
     * @param bool $replace (optional) Replace existing items when found
7944
     *
7945
     * @return bool
7946
     *
7947
     * @since 1.9.0
7948
     * @deprecated 2.0
7949
     */
7950
    public function import_package ( $data = false, $replace = false ) {
7951
        if ( class_exists( 'Pods_Migrate_Packages' ) )
7952
            return Pods_Migrate_Packages::import( $data, $replace );
7953
7954
        return false;
7955
    }
7956
7957
    /**
7958
     * Validate a package
7959
     *
7960
     * @param array|string $data (optional) An associative array containing a package, or the json encoded package
7961
     * @param bool $output (optional)
7962
     *
7963
     * @return array|bool
7964
     *
7965
     * @since 1.9.0
7966
     * @deprecated 2.0
7967
     */
7968
    public function validate_package ( $data = false, $output = false ) {
0 ignored issues
show
Unused Code introduced by
The parameter $data is not used and could be removed.

This check looks from parameters that have been defined for a function or method, but which are not used in the method body.

Loading history...
Unused Code introduced by
The parameter $output is not used and could be removed.

This check looks from parameters that have been defined for a function or method, but which are not used in the method body.

Loading history...
7969
        return true;
7970
    }
7971
7972
    /**
7973
     * Import data from an array or a CSV file.
7974
     *
7975
     * @param mixed $import_data PHP associative array or CSV input
7976
     * @param bool $numeric_mode Use IDs instead of the name field when matching
7977
     * @param string $format Format of import data, options are php or csv
7978
     *
7979
     * @return array IDs of imported items
7980
     *
7981
     * @since 1.7.1
7982
     * @todo This needs some love and use of table_info etc for relationships
7983
     */
7984
    public function import ( $import_data, $numeric_mode = false, $format = null ) {
7985
        /**
7986
         * @var $wpdb wpdb
7987
         */
7988
        global $wpdb;
0 ignored issues
show
Compatibility Best Practice introduced by
Use of global functionality is not recommended; it makes your code harder to test, and less reusable.

Instead of relying on global state, we recommend one of these alternatives:

1. Pass all data via parameters

function myFunction($a, $b) {
    // Do something
}

2. Create a class that maintains your state

class MyClass {
    private $a;
    private $b;

    public function __construct($a, $b) {
        $this->a = $a;
        $this->b = $b;
    }

    public function myFunction() {
        // Do something
    }
}
Loading history...
7989
7990
        if ( null === $format && null !== $this->format )
0 ignored issues
show
Deprecated Code introduced by
The property PodsAPI::$format has been deprecated with message: 2.0

This property has been deprecated. The supplier of the class has supplied an explanatory message.

The explanatory message should give you some clue as to whether and when the property will be removed from the class and what other property to use instead.

Loading history...
7991
            $format = $this->format;
0 ignored issues
show
Deprecated Code introduced by
The property PodsAPI::$format has been deprecated with message: 2.0

This property has been deprecated. The supplier of the class has supplied an explanatory message.

The explanatory message should give you some clue as to whether and when the property will be removed from the class and what other property to use instead.

Loading history...
7992
7993
        if ( 'csv' == $format && !is_array( $import_data ) ) {
7994
            $data = pods_migrate( 'sv', ',' )->parse( $import_data );
0 ignored issues
show
Bug introduced by
Are you sure the assignment to $data is correct as pods_migrate('sv', ',')->parse($import_data) (which targets PodsMigrate::parse()) seems to always return null.

This check looks for function or method calls that always return null and whose return value is assigned to a variable.

class A
{
    function getObject()
    {
        return null;
    }

}

$a = new A();
$object = $a->getObject();

The method getObject() can return nothing but null, so it makes no sense to assign that value to a variable.

The reason is most likely that a function or method is imcomplete or has been reduced for debug purposes.

Loading history...
7995
7996
            $import_data = $data[ 'items' ];
7997
        }
7998
7999
        pods_query( "SET NAMES utf8" );
8000
        pods_query( "SET CHARACTER SET utf8" );
8001
8002
        // Loop through the array of items
8003
        $ids = array();
8004
8005
        // Test to see if it's an array of arrays
8006
        if ( !is_array( @current( $import_data ) ) )
8007
            $import_data = array( $import_data );
8008
8009
        $pod = $this->load_pod( array( 'name' => $this->pod ) );
8010
8011
        if ( false === $pod )
8012
            return pods_error( __( 'Pod not found', 'pods' ), $this );
8013
8014
        $fields = array_merge( $pod[ 'fields' ], $pod[ 'object_fields' ] );
8015
8016
        $simple_tableless_objects = PodsForm::simple_tableless_objects();
8017
8018
        foreach ( $import_data as $key => $data_row ) {
8019
            $data = array();
8020
8021
            // Loop through each field (use $fields so only valid fields get parsed)
8022
            foreach ( $fields as $field_name => $field_data ) {
8023
                if ( !isset( $data_row[ $field_name ] ) && !isset( $data_row[ $field_data[ 'label' ] ] ) )
8024
                    continue;
8025
8026
                $field_id = $field_data[ 'id' ];
8027
                $type = $field_data[ 'type' ];
8028
                $pick_object = isset( $field_data[ 'pick_object' ] ) ? $field_data[ 'pick_object' ] : '';
8029
                $pick_val = isset( $field_data[ 'pick_val' ] ) ?  $field_data[ 'pick_val' ] : '';
8030
8031
                if ( isset( $data_row[ $field_name] ) )
8032
                    $field_value = $data_row[ $field_name ];
8033
                else
8034
                    $field_value = $data_row[ $field_data[ 'label' ] ];
8035
8036
                if ( null !== $field_value && false !== $field_value && '' !== $field_value ) {
8037
                    if ( 'pick' == $type || in_array( $type, PodsForm::file_field_types() ) ) {
8038
                        $field_values = is_array( $field_value ) ? $field_value : array( $field_value );
8039
                        $pick_values = array();
8040
8041
                        foreach ( $field_values as $pick_value ) {
8042
                            if ( in_array( $type, PodsForm::file_field_types() ) || 'media' == $pick_object ) {
8043
                                $where = "`guid` = '" . pods_sanitize( $pick_value ) . "'";
8044
8045 View Code Duplication
                                if ( 0 < pods_absint( $pick_value ) && false !== $numeric_mode )
8046
                                    $where = "`ID` = " . pods_absint( $pick_value );
8047
8048
                                $result = pods_query( "SELECT `ID` AS `id` FROM `{$wpdb->posts}` WHERE `post_type` = 'attachment' AND {$where} ORDER BY `ID`", $this );
8049
8050
                                if ( !empty( $result ) )
8051
                                    $pick_values[] = $result[ 0 ]->id;
8052
                            }
8053
                            // @todo This could and should be abstracted better and simplified
8054
                            elseif ( 'pick' == $type ) {
8055
                                $related_pod = false;
8056
8057
                                if ( 'pod' == $pick_object )
8058
                                    $related_pod = $this->load_pod( array( 'name' => $pick_val, 'table_info' => true ), false );
8059
8060
                                if ( empty( $related_pod ) ) {
8061
                                    $related_pod = array(
8062
                                        'id' => 0,
8063
                                        'type' => $pick_object
8064
                                    );
8065
                                }
8066
8067
                                if ( in_array( 'taxonomy', array( $pick_object, $related_pod[ 'type' ] ) ) ) {
8068
                                    $where = "`t`.`name` = '" . pods_sanitize( $pick_value ) . "'";
8069
8070 View Code Duplication
                                    if ( 0 < pods_absint( $pick_value ) && false !== $numeric_mode )
8071
                                        $where = "`tt`.`term_id` = " . pods_absint( $pick_value );
8072
8073
                                    $result = pods_query( "SELECT `t`.`term_id` AS `id` FROM `{$wpdb->term_taxonomy}` AS `tt` LEFT JOIN `{$wpdb->terms}` AS `t` ON `t`.`term_id` = `tt`.`term_id` WHERE `taxonomy` = '{$pick_val}' AND {$where} ORDER BY `t`.`term_id`", $this );
8074
8075
                                    if ( !empty( $result ) )
8076
                                        $pick_values[] = $result[ 0 ]->id;
8077
                                }
8078
                                elseif ( in_array( 'post_type', array( $pick_object, $related_pod[ 'type' ] ) ) || in_array( 'media', array( $pick_object, $related_pod[ 'type' ] ) ) ) {
8079
                                    $where = "`post_title` = '" . pods_sanitize( $pick_value ) . "'";
8080
8081 View Code Duplication
                                    if ( 0 < pods_absint( $pick_value ) && false !== $numeric_mode )
8082
                                        $where = "`ID` = " . pods_absint( $pick_value );
8083
8084
                                    $result = pods_query( "SELECT `ID` AS `id` FROM `{$wpdb->posts}` WHERE `post_type` = '{$pick_val}' AND {$where} ORDER BY `ID`", $this );
8085
8086
                                    if ( !empty( $result ) )
8087
                                        $pick_values[] = $result[ 0 ]->id;
8088
                                }
8089
                                elseif ( in_array( 'user', array( $pick_object, $related_pod[ 'type' ] ) ) ) {
8090
                                    $where = "`user_login` = '" . pods_sanitize( $pick_value ) . "'";
8091
8092 View Code Duplication
                                    if ( 0 < pods_absint( $pick_value ) && false !== $numeric_mode )
8093
                                        $where = "`ID` = " . pods_absint( $pick_value );
8094
8095
                                    $result = pods_query( "SELECT `ID` AS `id` FROM `{$wpdb->users}` WHERE {$where} ORDER BY `ID`", $this );
8096
8097
                                    if ( !empty( $result ) )
8098
                                        $pick_values[] = $result[ 0 ]->id;
8099
                                }
8100
                                elseif ( in_array( 'comment', array( $pick_object, $related_pod[ 'type' ] ) ) ) {
8101
                                    $where = "`comment_ID` = " . pods_absint( $pick_value );
8102
8103
                                    $result = pods_query( "SELECT `comment_ID` AS `id` FROM `{$wpdb->comments}` WHERE {$where} ORDER BY `ID`", $this );
8104
8105
                                    if ( !empty( $result ) )
8106
                                        $pick_values[] = $result[ 0 ]->id;
8107
                                }
8108
                                elseif ( in_array( $pick_object, $simple_tableless_objects ) )
8109
                                    $pick_values[] = $pick_value;
8110
                                elseif ( !empty( $related_pod[ 'id' ] ) ) {
8111
                                    $where = "`" . $related_pod[ 'field_index' ] . "` = '" . pods_sanitize( $pick_value ) . "'";
8112
8113
                                    if ( 0 < pods_absint( $pick_value ) && false !== $numeric_mode )
8114
                                        $where = "`" . $related_pod[ 'field_id' ] . "` = " . pods_absint( $pick_value );
8115
8116
                                    $result = pods_query( "SELECT `" . $related_pod[ 'field_id' ] . "` AS `id` FROM `" . $related_pod[ 'table' ] . "` WHERE {$where} ORDER BY `" . $related_pod[ 'field_id' ] . "`", $this );
8117
8118
                                    if ( !empty( $result ) )
8119
                                        $pick_values[] = $result[ 0 ]->id;
8120
                                }
8121
                            }
8122
                        }
8123
8124
                        $field_value = implode( ',', $pick_values );
8125
                    }
8126
8127
                    $data[ $field_name ] = $field_value;
8128
                }
8129
            }
8130
8131
            if ( !empty( $data ) ) {
8132
                $params = array(
8133
                    'pod' => $this->pod,
8134
                    'data' => $data
8135
                );
8136
8137
                $ids[] = $this->save_pod_item( $params );
8138
            }
8139
        }
8140
8141
        return $ids;
8142
    }
8143
8144
    /**
8145
     * Export data from a Pod
8146
     *
8147
     * @param string|object $pod The pod name or Pods object
8148
     * @param array $params An associative array of parameters
8149
     *
8150
     * @return array Data arrays of all exported pod items
8151
     * @since 1.7.1
8152
     */
8153
    public function export ( $pod = null, $params = null ) {
8154
8155
        if ( empty( $pod ) ) {
8156
            $pod = $this->pod;
8157
        }
8158
8159
        $find = array(
8160
            'limit' => -1,
8161
            'search' => false,
8162
            'pagination' => false
8163
        );
8164
8165
        if ( !empty( $params ) && isset( $params[ 'params' ] ) ) {
8166
            $find = array_merge( $find, (array) $params[ 'params' ] );
8167
8168
            unset( $params[ 'params' ] );
8169
8170
            $pod = pods( $pod, $find );
8171
        }
8172
        elseif ( !is_object( $pod ) ) {
8173
            $pod = pods( $pod, $find );
8174
        }
8175
8176
        $data = array();
8177
8178
        while ( $pod->fetch() ) {
8179
            $data[ $pod->id() ] = $this->export_pod_item( $params, $pod );
8180
        }
8181
8182
        $data = $this->do_hook( 'export', $data, $pod->pod, $pod );
8183
8184
        return $data;
8185
    }
8186
8187
    /**
8188
     * Convert CSV to a PHP array
8189
     *
8190
     * @param string $data The CSV input
8191
     *
8192
     * @return array
8193
     * @since 1.7.1
8194
     *
8195
     * @deprecated 2.3.5
8196
     */
8197
    public function csv_to_php ( $data, $delimiter = ',' ) {
8198
        pods_deprecated( "PodsAPI->csv_to_php", '2.3.5' );
8199
8200
        $data = pods_migrate( 'sv', $delimiter, $data )->parse();
0 ignored issues
show
Bug introduced by
Are you sure the assignment to $data is correct as pods_migrate('sv', $delimiter, $data)->parse() (which targets PodsMigrate::parse()) seems to always return null.

This check looks for function or method calls that always return null and whose return value is assigned to a variable.

class A
{
    function getObject()
    {
        return null;
    }

}

$a = new A();
$object = $a->getObject();

The method getObject() can return nothing but null, so it makes no sense to assign that value to a variable.

The reason is most likely that a function or method is imcomplete or has been reduced for debug purposes.

Loading history...
8201
8202
        return $data[ 'items' ];
8203
    }
8204
8205
    /**
8206
     * Clear Pod-related cache
8207
     *
8208
     * @param array $pod
8209
     *
8210
     * @return void
8211
     *
8212
     * @since 2.0
8213
     */
8214
    public function cache_flush_pods ( $pod = null ) {
8215
        /**
8216
         * @var $wpdb wpdb
8217
         */
8218
        global $wpdb;
0 ignored issues
show
Compatibility Best Practice introduced by
Use of global functionality is not recommended; it makes your code harder to test, and less reusable.

Instead of relying on global state, we recommend one of these alternatives:

1. Pass all data via parameters

function myFunction($a, $b) {
    // Do something
}

2. Create a class that maintains your state

class MyClass {
    private $a;
    private $b;

    public function __construct($a, $b) {
        $this->a = $a;
        $this->b = $b;
    }

    public function myFunction() {
        // Do something
    }
}
Loading history...
8219
8220
        pods_transient_clear( 'pods' );
8221
        pods_transient_clear( 'pods_components' );
8222
8223
        if ( null !== $pod && is_array( $pod ) ) {
8224
            pods_transient_clear( 'pods_pod_' . $pod[ 'name' ] );
8225
            pods_cache_clear( $pod[ 'name' ], 'pods-class' );
8226
8227
            foreach ( $pod[ 'fields' ] as $field ) {
8228
                pods_transient_clear( 'pods_field_' . $pod[ 'name' ] . '_' . $field[ 'name' ] );
8229
            }
8230
8231
            if ( in_array( $pod[ 'type' ], array( 'post_type', 'taxonomy' ) ) )
8232
                pods_transient_clear( 'pods_wp_cpt_ct' );
8233
        }
8234
        else
8235
            pods_transient_clear( 'pods_wp_cpt_ct' );
8236
8237
        // Delete transients in the database
8238
        $wpdb->query( "DELETE FROM `{$wpdb->options}` WHERE `option_name` LIKE '_transient_pods%'" );
8239
        $wpdb->query( "DELETE FROM `{$wpdb->options}` WHERE `option_name` LIKE '_transient_timeout_pods%'" );
8240
8241
        // Delete Pods Options Cache in the database
8242
        $wpdb->query( "DELETE FROM `{$wpdb->options}` WHERE `option_name` LIKE '_pods_option_%'" );
8243
8244
        pods_cache_clear( true );
8245
8246
        pods_transient_set( 'pods_flush_rewrites', 1 );
8247
8248
        do_action( 'pods_cache_flushed' );
8249
    }
8250
8251
    /**
8252
     * Process a Pod-based form
8253
     *
8254
     * @param mixed $params
8255
     * @param object $obj Pod object
8256
     * @param array $fields Fields being submitted in form ( key => settings )
8257
     * @param string $thank_you URL to send to upon success
8258
     *
8259
     * @return mixed
8260
     *
8261
     * @since 2.0
8262
     */
8263
    public function process_form ( $params, $obj = null, $fields = null, $thank_you = null ) {
8264
        $this->display_errors = false;
8265
8266
        $form = null;
8267
8268
        $nonce = pods_var( '_pods_nonce', $params );
8269
        $pod = pods_var( '_pods_pod', $params );
8270
        $id = pods_var( '_pods_id', $params );
8271
        $uri = pods_var( '_pods_uri', $params );
8272
        $form = pods_var( '_pods_form', $params );
8273
        $location = pods_var( '_pods_location', $params );
8274
8275
        if ( is_object( $obj ) ) {
8276
            $pod = $obj->pod;
8277
            $id = $obj->id();
8278
        }
8279
8280
        if ( !empty( $fields ) ) {
8281
            $fields = array_keys( $fields );
8282
            $form = implode( ',', $fields );
8283
        }
8284
        else
8285
            $fields = explode( ',', $form );
8286
8287
        if ( empty( $nonce ) || empty( $pod ) || empty( $uri ) || empty( $fields ) )
8288
            return pods_error( __( 'Invalid submission', 'pods' ), $this );
8289
8290
        $uid = @session_id();
8291
8292
        if ( is_user_logged_in() )
8293
            $uid = 'user_' . get_current_user_id();
8294
8295
		$field_hash = wp_create_nonce( 'pods_fields_' . $form );
8296
8297
        $action = 'pods_form_' . $pod . '_' . $uid . '_' . $id . '_' . $uri . '_' . $field_hash;
8298
8299
        if ( empty( $uid ) )
8300
            return pods_error( __( 'Access denied for your session, please refresh and try again.', 'pods' ), $this );
8301
8302
        if ( false === wp_verify_nonce( $nonce, $action ) )
8303
            return pods_error( __( 'Access denied, please refresh and try again.', 'pods' ), $this );
8304
8305
        $data = array();
8306
8307
        foreach ( $fields as $field ) {
8308
            $data[ $field ] = pods_var_raw( 'pods_field_' . $field, $params, '' );
8309
        }
8310
8311
        $params = array(
8312
            'pod' => $pod,
8313
            'id' => $id,
8314
            'data' => $data,
8315
            'from' => 'process_form',
8316
			'location' => $location
8317
        );
8318
8319
        $id = $this->save_pod_item( $params );
8320
8321
        if ( 0 < $id && !empty( $thank_you ) ) {
8322
            $thank_you = str_replace( 'X_ID_X', $id, $thank_you );
8323
8324
            pods_redirect( $thank_you );
8325
        }
8326
8327
        return $id;
8328
    }
8329
8330
	/**
8331
	 * Get current language information from Multilingual plugins
8332
	 *
8333
	 * @since 2.6.6
8334
	 *
8335
	 * @return array
8336
	 */
8337
	public static function get_current_language() {
8338
8339
		/**
8340
		 * @var $sitepress                    SitePress object
8341
		 * @var $polylang                     object
8342
		 */
8343
        /*
8344
         * @todo wpml-comp Remove global object usage
8345
         */
8346
		global $sitepress, $polylang;
0 ignored issues
show
Compatibility Best Practice introduced by
Use of global functionality is not recommended; it makes your code harder to test, and less reusable.

Instead of relying on global state, we recommend one of these alternatives:

1. Pass all data via parameters

function myFunction($a, $b) {
    // Do something
}

2. Create a class that maintains your state

class MyClass {
    private $a;
    private $b;

    public function __construct($a, $b) {
        $this->a = $a;
        $this->b = $b;
    }

    public function myFunction() {
        // Do something
    }
}
Loading history...
8347
8348
		$lang_data        = false;
8349
		$translator       = false;
8350
		$current_language = false;
8351
8352
		// Multilingual support
8353
		if ( did_action( 'wpml_loaded' ) && apply_filters( 'wpml_setting', true, 'auto_adjust_ids' ) ) {
8354
			// WPML support
8355
			$translator = 'WPML';
8356
8357
			// Get the global current language (if set)
8358
            $wpml_language = apply_filters( 'wpml_current_language', null );
8359
			$current_language = ( $wpml_language != 'all' ) ? $wpml_language : '';
8360
8361
		} elseif ( ( function_exists( 'PLL' ) || is_object( $polylang ) ) && function_exists( 'pll_current_language' ) ) {
8362
			// Polylang support
8363
			$translator = 'PLL';
8364
8365
			// Get the global current language (if set)
8366
			$current_language = pll_current_language( 'slug' );
8367
		}
8368
8369
		/**
8370
		 * Admin functions that overwrite the current language
8371
		 *
8372
		 * @since 2.6.6
8373
		 */
8374
		if ( is_admin() && ! empty( $translator ) ) {
8375
			if ( $translator == 'PLL' ) {
8376
				/**
8377
				 * Polylang support
8378
				 * Get the current user's perferred language.
8379
				 * This is a user meta setting that will overwrite the language returned from pll_current_language()
8380
				 * @see polylang/admin/admin-base.php -> init_user()
8381
				 */
8382
				$current_language = get_user_meta( get_current_user_id(), 'pll_filter_content', true );
8383
			}
8384
8385
			// Get current language based on the object language if available
8386
			if ( function_exists( 'get_current_screen' ) ) {
8387
				$current_screen = get_current_screen();
8388
8389
				/**
8390
				 * Overwrite the current language if needed for post types
8391
				 */
8392
				if ( isset( $current_screen->base ) && ( $current_screen->base == 'post' || $current_screen->base == 'edit' ) ) {
8393
					if ( ! empty( $_GET['post'] ) ) {
8394
						/**
8395
						 * WPML support
8396
						 * In WPML the current language is always set to default on an edit screen
8397
						 * We need to overwrite this when the current object is not-translatable to enable relationships with different languages
8398
						 */
8399
						if (   $translator == 'WPML'
8400
							&& ! apply_filters( 'wpml_is_translated_post_type', false, ( get_post_type( $_GET['post'] ) ) )
8401
						) {
8402
							// Overwrite the current language to nothing if this is a NOT-translatable post_type
8403
							$current_language = '';
8404
						}
8405
8406
						/**
8407
						 * Polylang support (1.5.4+)
8408
						 * In polylang the preferred language could be anything.
8409
						 * We only want the related objects if they are not translatable OR the same language as the current object
8410
						 */
8411
						if (   $translator == 'PLL'
8412
							&& function_exists( 'pll_get_post_language' )
8413
							&& pll_is_translated_post_type( get_post_type( $_GET['post'] ) )
8414
						) {
8415
							// Overwrite the current language if this is a translateable post_type
8416
							$current_language = pll_get_post_language( (int) $_GET['post'] );
8417
						}
8418
					}
8419
8420
					/**
8421
					 * Polylang support (1.0.1+)
8422
					 * In polylang the preferred language could be anything.
8423
					 * When we're adding a new object and language is set we only want the related objects if they are not translatable OR the same language
8424
					 */
8425 View Code Duplication
					if (   $translator == 'PLL'
8426
						&& ! empty( $_GET['new_lang'] )
8427
						&& ! empty( $_GET['post_type'] )
8428
						&& pll_is_translated_post_type( sanitize_text_field( $_GET['post_type'] ) )
8429
					) {
8430
						$current_language = $_GET['new_lang'];
8431
					}
8432
8433
				/**
8434
				 * Overwrite the current language if needed for taxonomies
8435
				 */
8436
				} elseif ( isset( $current_screen->base ) && ( $current_screen->base == 'term' || $current_screen->base == 'edit-tags' ) ) {
8437
					// @todo MAYBE: Similar function like get_post_type for taxonomies so we don't need to check for $_GET['taxonomy']
8438
					if ( ! empty( $_GET['taxonomy'] ) ) {
8439
					    /*
8440
					     * @todo wpml-comp API call for taxonomy needed!
8441
					     * Suggested API call:
8442
					     * add_filter( 'wpml_is_translated_taxonomy', $_GET['taxonomy'], 10, 2 );
8443
					     */
8444
						/**
8445
						 * WPML support
8446
						 * In WPML the current language is always set to default on an edit screen
8447
						 * We need to overwrite this when the current object is not-translatable to enable relationships with different languages
8448
						 */
8449
						if (   $translator == 'WPML'
8450
							&& method_exists( $sitepress, 'is_translated_taxonomy')
8451
							&& ! $sitepress->is_translated_taxonomy( $_GET['taxonomy'] )
8452
						) {
8453
							// Overwrite the current language to nothing if this is a NOT-translatable taxonomy
8454
							$current_language = '';
8455
						}
8456
8457
						/**
8458
						 * Polylang support (1.5.4+)
8459
						 * In polylang the preferred language could be anything.
8460
						 * We only want the related objects if they are not translatable OR the same language as the current object
8461
						 */
8462
						if (   $translator == 'PLL'
8463
							&& ! empty( $_GET['tag_ID'] )
8464
							&& function_exists( 'pll_get_term_language' )
8465
							&& pll_is_translated_taxonomy( sanitize_text_field( $_GET['taxonomy'] ) )
8466
						) {
8467
							// Overwrite the current language if this is a translatable taxonomy
8468
							$current_language = pll_get_term_language( (int) $_GET['tag_ID'] );
8469
						}
8470
					}
8471
8472
					/**
8473
					 * Polylang support (1.0.1+)
8474
					 * In polylang the preferred language could be anything.
8475
					 * When we're adding a new object and language is set we only want the related objects if they are not translatable OR the same language
8476
					 */
8477 View Code Duplication
					if (   $translator == 'PLL'
8478
						&& ! empty( $_GET['new_lang'] )
8479
						&& ! empty( $_GET['taxonomy'] )
8480
						&& pll_is_translated_taxonomy( sanitize_text_field( $_GET['taxonomy'] ) )
8481
					) {
8482
						$current_language = $_GET['new_lang'];
8483
					}
8484
				}
8485
			}
8486
		}
8487
8488
		$current_language = pods_sanitize( sanitize_text_field( $current_language ) );
8489
8490
		if ( ! empty( $current_language ) ) {
8491
			// We need to return language data
8492
			$lang_data = array(
8493
				'language' => $current_language,
8494
				't_id'     => 0,
8495
				'tt_id'    => 0,
8496
				'term'     => null,
8497
			);
8498
8499
			/**
8500
			 * Polylang support
8501
			 * Get the language taxonomy object for the current language
8502
			 */
8503
			if ( $translator == 'PLL' ) {
8504
				$current_language_t = false;
8505
8506
				// Get the language term object
8507
				if ( function_exists( 'PLL' ) && isset( PLL()->model ) && method_exists( PLL()->model, 'get_language' ) ) {
8508
					// Polylang 1.8 and newer
8509
					$current_language_t = PLL()->model->get_language( $current_language );
8510
				} elseif ( is_object( $polylang ) && isset( $polylang->model ) && method_exists( $polylang->model, 'get_language' ) ) {
8511
					// Polylang 1.2 - 1.7.x
8512
					$current_language_t = $polylang->model->get_language( $current_language );
8513
				} elseif ( is_object( $polylang ) && method_exists( $polylang, 'get_language' ) ) {
8514
					// Polylang 1.1.x and older
8515
					$current_language_t = $polylang->get_language( $current_language );
8516
				}
8517
8518
				// If the language object exists, add it!
8519
				if ( $current_language_t && ! empty( $current_language_t->term_id ) ) {
8520
					$lang_data['t_id']  = (int) $current_language_t->term_id;
8521
					$lang_data['tt_id'] = (int) $current_language_t->term_taxonomy_id;
8522
					$lang_data['tl_t_id'] = (int) $current_language_t->tl_term_id;
8523
					$lang_data['tl_tt_id'] = (int) $current_language_t->tl_term_taxonomy_id;
8524
					$lang_data['term']  = $current_language_t;
8525
				}
8526
			}
8527
		}
8528
8529
		/**
8530
		 * Override language data used by Pods.
8531
		 *
8532
		 * @since 2.6.6
8533
		 *
8534
		 * @param array|false    $lang_data {
8535
		 *      Language data
8536
		 *
8537
		 *      @type string       $language  Language slug
8538
		 *      @type int          $t_id      Language term_id
8539
		 *      @type int          $tt_id     Language term_taxonomy_id
8540
		 *      @type WP_Term      $term      Language term object
8541
		 * }
8542
		 * @param string|boolean $translator Language plugin used
8543
		 */
8544
		$lang_data = apply_filters( 'pods_get_current_language', $lang_data, $translator );
8545
8546
		return $lang_data;
8547
8548
	}
8549
8550
    /**
8551
     * Handle filters / actions for the class
8552
     *
8553
     * @since 2.0
8554
     */
8555 View Code Duplication
    private function do_hook () {
0 ignored issues
show
Duplication introduced by
This method seems to be duplicated in your project.

Duplicated code is one of the most pungent code smells. If you need to duplicate the same code in three or more different places, we strongly encourage you to look into extracting the code into a single class or operation.

You can also find more detailed suggestions in the “Code” section of your repository.

Loading history...
8556
        $args = func_get_args();
8557
        if ( empty( $args ) )
8558
            return false;
8559
        $name = array_shift( $args );
8560
        return pods_do_hook( "api", $name, $args, $this );
8561
    }
8562
8563
    /**
8564
     * Handle variables that have been deprecated
8565
     *
8566
     * @since 2.0
8567
     */
8568
    public function __get ( $name ) {
8569
        $name = (string) $name;
8570
8571 View Code Duplication
        if ( !isset( $this->deprecated ) ) {
8572
            require_once( PODS_DIR . 'deprecated/classes/PodsAPI.php' );
8573
            $this->deprecated = new PodsAPI_Deprecated( $this );
8574
        }
8575
8576
        $var = null;
8577
8578
        if ( isset( $this->deprecated->{$name} ) ) {
8579
            pods_deprecated( "PodsAPI->{$name}", '2.0' );
8580
8581
            $var = $this->deprecated->{$name};
8582
        }
8583
        else
8584
            pods_deprecated( "PodsAPI->{$name}", '2.0' );
8585
8586
        return $var;
8587
    }
8588
8589
    /**
8590
     * Handle methods that have been deprecated
8591
     *
8592
     * @since 2.0
8593
     */
8594
    public function __call ( $name, $args ) {
8595
        $name = (string) $name;
8596
8597 View Code Duplication
        if ( !isset( $this->deprecated ) ) {
8598
            require_once( PODS_DIR . 'deprecated/classes/PodsAPI.php' );
8599
            $this->deprecated = new PodsAPI_Deprecated( $this );
8600
        }
8601
8602
        if ( method_exists( $this->deprecated, $name ) )
8603
            return call_user_func_array( array( $this->deprecated, $name ), $args );
8604
        else
8605
            pods_deprecated( "PodsAPI::{$name}", '2.0' );
8606
    }
8607
}
8608