Pods 3.4.0

README.md

@@ -46,9 +46,11 @@ If you find an issue that you believe to be a *bug*, [let us know](https://githu
 
 If you have restrictions on your server or site, these are the minimum versions that Pods will be supported to run on. Running the following minimum versions does bring with it their own risks including security and exposure to additional bugs that may have been resolved by the recommended versions above. 
 
-* WordPress 6.3+
-* PHP 7.2+
-* MySQL 5.5+
+* WordPress 6.8+
+* PHP 8.0+
+* MySQL 5.7+
+
+It's recommended you use the latest stable version of each available to you.
 
 ## Contributions Welcome
 

classes/Pods.php

@@ -673,7 +673,7 @@ public function field( $name, $single = null, $raw = false ) {
 		}
 
 		if ( null !== $params->single ) {
-			$params->single = (boolean) $params->single;
+			$params->single = (bool) $params->single;
 		}
 
 		$params->name = trim( (string) $params->name );
@@ -2404,9 +2404,9 @@ public function find( $params = null, $limit = 15, $where = null, $sql = null )
 			'offset'              => null,
 			'page'                => (int) $this->page,
 			'page_var'            => $this->page_var,
-			'pagination'          => (boolean) $this->pagination,
+			'pagination'          => (bool) $this->pagination,
 			// Search parameters.
-			'search'              => (boolean) $this->search,
+			'search'              => (bool) $this->search,
 			'search_var'          => $this->search_var,
 			'search_query'        => null,
 			'search_mode'         => $this->search_mode,
@@ -2451,8 +2451,8 @@ public function find( $params = null, $limit = 15, $where = null, $sql = null )
 		$this->offset     = (int) $params->offset;
 		$this->page       = (int) $params->page;
 		$this->page_var   = $params->page_var;
-		$this->pagination = (boolean) $params->pagination;
-		$this->search     = (boolean) $params->search;
+		$this->pagination = (bool) $params->pagination;
+		$this->search     = (bool) $params->search;
 		$this->search_var = $params->search_var;
 		$this->filter_var = $params->filter_var;
 		$params->join     = (array) $params->join;
@@ -3644,7 +3644,7 @@ public function helper( $helper, $value = null, $name = null ) {
 		 *
 		 * @since 2.8.0
 		 */
-		$include_obj = (boolean) apply_filters( 'pods_helper_include_obj', false, $params );
+		$include_obj = (bool) apply_filters( 'pods_helper_include_obj', false, $params );
 
 		// Clean up helper callback (if string).
 		if ( is_string( $params['helper'] ) ) {

classes/PodsAPI.php

@@ -1808,7 +1808,7 @@ public function save_pod( $params, $sanitized = false, $db = true ) {
 			$params->name = pods_clean_name( $params->name );
 		}
 
-		$params->overwrite = ! empty( $params->overwrite ) ? (boolean) $params->overwrite : false;
+		$params->overwrite = ! empty( $params->overwrite ) ? (bool) $params->overwrite : false;
 
 		$order_group_fields = null;
 
@@ -3250,8 +3250,8 @@ public function save_field( $params, $table_operation = true, $sanitized = false
 		$params->pod_id = $pod['id'];
 		$params->pod    = $pod['name'];
 
-		$params->is_new    = isset( $params->is_new ) ? (boolean) $params->is_new : false;
-		$params->overwrite = isset( $params->overwrite ) ? (boolean) $params->overwrite : false;
+		$params->is_new    = isset( $params->is_new ) ? (bool) $params->is_new : false;
+		$params->overwrite = isset( $params->overwrite ) ? (bool) $params->overwrite : false;
 
 		$reserved_keywords = pods_reserved_keywords( 'wp-post' );
 
@@ -4268,13 +4268,13 @@ public function save_group( $params, $sanitized = false, $db = true ) {
 		$id_required = false;
 
 		if ( isset( $params->id_required ) ) {
-			$id_required = (boolean) $params->id_required;
+			$id_required = (bool) $params->id_required;
 
 			unset( $params->id_required );
 		}
 
-		$params->is_new    = isset( $params->is_new ) ? (boolean) $params->is_new : false;
-		$params->overwrite = isset( $params->overwrite ) ? (boolean) $params->overwrite : false;
+		$params->is_new    = isset( $params->is_new ) ? (bool) $params->is_new : false;
+		$params->overwrite = isset( $params->overwrite ) ? (bool) $params->overwrite : false;
 
 		if ( ! $pod && ( ! isset( $params->pod ) || empty( $params->pod ) ) && ( ! isset( $params->pod_id ) || empty( $params->pod_id ) ) ) {
 			return pods_error( __( 'Pod ID or name is required', 'pods' ), $this );
@@ -4938,7 +4938,7 @@ public function save_pod_item( $params ) {
 		}
 
 		if ( isset( $params->is_new_item ) ) {
-			$is_new_item = (boolean) $params->is_new_item;
+			$is_new_item = (bool) $params->is_new_item;
 		}
 
 		// Allow Helpers to bypass subsequent helpers in recursive save_pod_item calls
@@ -5448,7 +5448,7 @@ public function save_pod_item( $params ) {
 						|| in_array( pods_v( 'pick_object', $field_data ), $simple_tableless_objects, true )
 					)
 				);
-				$simple = (boolean) $this->do_hook( 'tableless_custom', $simple, $field_data, $field, $fields, $pod, $params );
+				$simple = (bool) $this->do_hook( 'tableless_custom', $simple, $field_data, $field, $fields, $pod, $params );
 
 				$is_repeatable_field = (
 					(
@@ -6678,6 +6678,7 @@ public function duplicate_pod( $params, $strict = false ) {
 	 * $params['id'] int The Group ID.
 	 * $params['name'] string The Group name.
 	 * $params['new_name'] string The new Group name.
+	 * $params['duplicate_fields'] bool Whether to duplicate the fields.
 	 *
 	 * @since 2.8.0
 	 *
@@ -6716,7 +6717,11 @@ public function duplicate_group( $params, $strict = false ) {
 			return false;
 		}
 
+		$pod_data = null;
+
 		if ( $group instanceof Group ) {
+			$pod_data = $group->get_parent_object();
+
 			$group = $group->export(
 				[
 					'include_fields' => true,
@@ -6747,7 +6752,13 @@ public function duplicate_group( $params, $strict = false ) {
 
 		$fields = $group['fields'];
 
-		unset( $group['id'], $group['parent'], $group['object_type'], $group['object_storage_type'], $group['fields'] );
+		unset( $group['id'], $group['object_type'], $group['object_storage_type'], $group['fields'] );
+
+		if ( $pod_data ) {
+			unset( $group['parent'] );
+
+			$group['pod_data'] = $pod_data;
+		}
 
 		try {
 			$group_id = $this->save_group( $group );
@@ -6761,16 +6772,24 @@ public function duplicate_group( $params, $strict = false ) {
 			return false;
 		}
 
-		foreach ( $fields as $field => $field_data ) {
-			unset( $field_data['id'], $field_data['parent'], $field_data['object_type'], $field_data['object_storage_type'], $field_data['group'] );
+		$group_data = $this->load_group( [ 'id' => $group_id ] );
 
-			$field_data['group_id'] = $group_id;
+		if ( ! empty( $params->duplicate_fields ) ) {
+			foreach ( $fields as $field_data ) {
+				try {
+					$field_params = [
+						'pod' => $pod_data,
+						'id' => $field_data['id'],
+						'name' => $field_data['name'],
+						'new_group' => $group_data,
+						'new_group_id' => $group_id,
+					];
 
-			try {
-				$this->save_field( $field_data );
-			} catch ( Exception $exception ) {
-				// Field not saved.
-				pods_debug_log( $exception );
+					$this->duplicate_field( $field_params, true || $strict );
+				} catch ( Exception $exception ) {
+					// Field not saved.
+					pods_debug_log( $exception );
+				}
 			}
 		}
 
@@ -7049,7 +7068,7 @@ public function export_pod_item( $params, $pod = null ) {
 		$params['fields']        = (array) pods_v( 'fields', $params, [], true );
 		$params['depth']         = (int) pods_v( 'depth', $params, 2, true );
 		$params['object_fields'] = (array) pods_v( 'object_fields', $pod->pod_data, [], true );
-		$params['flatten']       = (boolean) pods_v( 'flatten', $params, false, true );
+		$params['flatten']       = (bool) pods_v( 'flatten', $params, false, true );
 		$params['context']       = pods_v( 'context', $params, null, true );
 
 		if ( empty( $params['fields'] ) ) {
@@ -7526,7 +7545,7 @@ public function delete_pod( $params, $strict = false, $delete_all = false ) {
 			$params->delete_all = $delete_all;
 		}
 
-		$params->delete_all = (boolean) $params->delete_all;
+		$params->delete_all = (bool) $params->delete_all;
 
 		// Reset content
 		if ( true === $params->delete_all ) {
@@ -7740,7 +7759,7 @@ public function delete_field( $params, $table_operation = true ) {
 		}
 
 		$simple = ( 'pick' === $field['type'] && in_array( pods_v( 'pick_object', $field ), $simple_tableless_objects, true ) );
-		$simple = (boolean) $this->do_hook( 'tableless_custom', $simple, $field, $pod, $params );
+		$simple = (bool) $this->do_hook( 'tableless_custom', $simple, $field, $pod, $params );
 
 		// @todo Push this logic into pods_object_storage_delete_pod action.
 		if ( $table_operation && $pod && 'table' === $pod['storage'] && ( ! in_array( $field['type'], $tableless_field_types, true ) || $simple ) ) {
@@ -7820,7 +7839,7 @@ public function delete_group( $params, $strict = false, $delete_all = false ) {
 		}
 
 		if ( ! isset( $params->delete_all ) ) {
-			$params->delete_all = (boolean) $delete_all;
+			$params->delete_all = (bool) $delete_all;
 		}
 
 		$group = $this->load_group( $params, false );
@@ -8542,7 +8561,7 @@ public function load_pods( $params = [] ) {
 		$include_internal = false;
 
 		if ( isset( $params['include_internal'] ) ) {
-			$include_internal = (boolean) $params['include_internal'];
+			$include_internal = (bool) $params['include_internal'];
 
 			unset( $params['include_internal'] );
 		}
@@ -8613,7 +8632,7 @@ public function field_exists( $params, $allow_id = true ) {
 		}
 
 		try {
-			return (boolean) $this->load_field( $load_params );
+			return (bool) $this->load_field( $load_params );
 		} catch ( Exception $exception ) {
 			pods_debug_log( $exception );
 
@@ -8889,7 +8908,7 @@ public function load_fields( $params = [] ) {
 		$include_internal = false;
 
 		if ( isset( $params['include_internal'] ) ) {
-			$include_internal = (boolean) $params['include_internal'];
+			$include_internal = (bool) $params['include_internal'];
 
 			unset( $params['include_internal'] );
 		}
@@ -8977,7 +8996,7 @@ public function group_exists( $params, $allow_id = true ) {
 		}
 
 		try {
-			return (boolean) $this->load_group( $load_params );
+			return (bool) $this->load_group( $load_params );
 		} catch ( Exception $exception ) {
 			pods_debug_log( $exception );
 
@@ -9121,7 +9140,7 @@ public function load_groups( $params = [] ) {
 		$include_internal = false;
 
 		if ( isset( $params['include_internal'] ) ) {
-			$include_internal = (boolean) $params['include_internal'];
+			$include_internal = (bool) $params['include_internal'];
 
 			unset( $params['include_internal'] );
 		}
@@ -11582,16 +11601,20 @@ public function csv_to_php( $data, $delimiter = ',' ) {
 	 * @param bool           $flush_rewrites          Whether to flush rewrites.
 	 * @param bool           $flush_groups_and_fields Whether to flush cache for groups and fields.
 	 * @param bool           $static_only             Whether to flush only static caches.
+	 * @param bool           $flush_object_cache      Whether to fully flush object caches.
+	 * @param bool           $delete_transients       Whether to fully delete transients.
 	 *
 	 * @return void
 	 *
 	 * @since 2.0.0
 	 */
 	public function cache_flush_pods(
 		$pod = null,
-		$flush_rewrites = true,
-		$flush_groups_and_fields = true,
-		$static_only = false
+		bool $flush_rewrites = true,
+		bool $flush_groups_and_fields = true,
+		bool $static_only = false,
+		bool $flush_object_cache = false,
+		bool $delete_transients = false
 	) {
 
 		/**
@@ -11666,11 +11689,11 @@ public function cache_flush_pods(
 		pods_init()->refresh_existing_content_types_cache( true );
 
 		if ( ! $static_only ) {
-			// Delete transients in the database
+			// Delete transients in the database.
 			$wpdb->query( "DELETE FROM `{$wpdb->options}` WHERE `option_name` LIKE '_transient_pods%'" );
 			$wpdb->query( "DELETE FROM `{$wpdb->options}` WHERE `option_name` LIKE '_transient_timeout_pods%'" );
 
-			// Delete Pods Options Cache in the database
+			// Delete Pods Options Cache in the database.
 			$wpdb->query( "DELETE FROM `{$wpdb->options}` WHERE `option_name` LIKE '_pods_option_%'" );
 
 			// Maybe use the test-based cache flushing to prevent major slowdowns.
@@ -11684,19 +11707,40 @@ class_exists( WP_UnitTestCase::class )
 				&& class_exists( \Pods_Unit_Tests\Pods_UnitTestCase::class )
 			) {
 				\Pods_Unit_Tests\Pods_UnitTestCase::flush_cache();
-			} else {
+			} else{
 				// Do normal cache clear.
 				pods_cache_clear( true );
 
-				wp_cache_flush();
+				// Maybe flush the full object cache.
+				if ( $flush_object_cache ) {
+					wp_cache_flush();
+				}
+
+				// Maybe delete all transients in the database.
+				if ( $delete_transients ) {
+					$wpdb->query( "DELETE FROM `{$wpdb->options}` WHERE `option_name` LIKE '_transient_%'" );
+					$wpdb->query( "DELETE FROM `{$wpdb->options}` WHERE `option_name` LIKE '_transient_timeout_%'" );
+				}
 			}
 
 			if ( $flush_rewrites ) {
 				pods_transient_set( 'pods_flush_rewrites', 1, WEEK_IN_SECONDS );
 			}
 		}
 
-		do_action( 'pods_cache_flushed' );
+		/**
+		 * Allow hooking into the end of the Pods cache flush process.
+		 *
+		 * @since unknown
+		 *
+		 * @param array|Pod|null $pod                     The pod object or null of flushing general cache.
+		 * @param bool           $flush_rewrites          Whether to flush rewrites.
+		 * @param bool           $flush_groups_and_fields Whether to flush cache for groups and fields.
+		 * @param bool           $static_only             Whether to flush only static caches.
+		 * @param bool           $flush_object_cache      Whether to fully flush object caches.
+		 * @param bool           $delete_transients       Whether to fully delete transients.
+		 */
+		do_action( 'pods_cache_flushed', $pod, $flush_rewrites, $flush_groups_and_fields, $static_only, $flush_object_cache, $delete_transients );
 	}
 
 	/**
@@ -11728,6 +11772,16 @@ public function cache_flush_groups( $flush_fields = true, $static_only = false )
 			pods_static_cache_clear( true, \Pods\Whatsit\Storage\Collection::class . '/find_objects' );
 			pods_static_cache_clear( true, \Pods\Whatsit\Storage\Post_Type::class . '/find_objects/any' );
 		}
+
+		/**
+		 * Allow hooking into the end of the Pods cache flush for groups process.
+		 *
+		 * @since 3.3.2
+		 *
+		 * @param bool $flush_fields Whether to flush cache for fields.
+		 * @param bool $static_only  Whether to flush only static caches.
+		 */
+		do_action( 'pods_api_cache_flush_groups', $flush_fields, $static_only );
 	}
 
 	/**
@@ -11758,6 +11812,15 @@ public function cache_flush_fields( $static_only = false ) {
 
 		pods_static_cache_clear( true, \Pods\Whatsit\Storage\Collection::class . '/find_objects' );
 		pods_static_cache_clear( true, \Pods\Whatsit\Storage\Post_Type::class . '/find_objects/any' );
+
+		/**
+		 * Allow hooking into the end of the Pods cache flush for fields process.
+		 *
+		 * @since 3.3.2
+		 *
+		 * @param bool $static_only Whether to flush only static caches.
+		 */
+		do_action( 'pods_api_cache_flush_fields', $static_only );
 	}
 
 	/**

classes/PodsArray.php

@@ -154,7 +154,7 @@ public function validate( $offset, $default = null, $type = null, $extra = null
 				$value = abs( $value );
 			}
 		} elseif ( 'boolean' === $type || 'bool' === $type ) {
-			$value = (boolean) $value;
+			$value = (bool) $value;
 		} elseif ( 'in_array' === $type && is_array( $default ) ) {
 			if ( is_array( $value ) ) {
 				foreach ( $value as $k => $v ) {