Pods 3.3.5

.distignore

@@ -18,6 +18,7 @@
 # Dot-files
 .babelrc
 .distignore
+.DS_Store
 .editorconfig
 .env
 .env.example
@@ -55,6 +56,7 @@ phpstan.neon
 phpunit.xml.dist
 README.md
 rollup.config.js
+slic.json
 TESTS.md
 webpack.common.js
 webpack.dev.js

.gitattributes

@@ -25,6 +25,7 @@ tests/_support/_generated/* linguist-generated=true
 # Dot-files
 .babelrc export-ignore
 .distignore export-ignore
+.DS_Store
 .editorconfig export-ignore
 .env export-ignore
 .env.example export-ignore
@@ -62,6 +63,7 @@ phpstan.neon export-ignore
 phpunit.xml.dist export-ignore
 README.md export-ignore
 rollup.config.js export-ignore
+slic.json export-ignore
 TESTS.md export-ignore
 webpack.common.js export-ignore
 webpack.dev.js export-ignore

.github/workflows/tests-php.yml

@@ -39,7 +39,7 @@ jobs:
       - name: Configure PHP environment
         uses: shivammathur/setup-php@v2
         with:
-          php-version: 7.4
+          php-version: 8.2
       # ------------------------------------------------------------------------------
       # Checkout slic
       # ------------------------------------------------------------------------------
@@ -86,6 +86,7 @@ jobs:
           ${SLIC_BIN} interactive off
           ${SLIC_BIN} build-prompt off
           ${SLIC_BIN} build-subdir off
+          ${SLIC_BIN} php-version set 8.2 --skip-rebuild
           ${SLIC_BIN} xdebug off
           ${SLIC_BIN} composer-cache set /home/runner/.cache/composer
           ${SLIC_BIN} debug on
@@ -99,14 +100,17 @@ jobs:
           docker network prune -f
           ${SLIC_BIN} use ${GITHUB_REPOSITORY#*/}
           ${SLIC_BIN} composer set-version 2
-          ${SLIC_BIN} composer install
+          ${SLIC_BIN} composer install --ignore-platform-reqs
       # ------------------------------------------------------------------------------
       # Init WordPress container
       # ------------------------------------------------------------------------------
       - name: Init the WordPress container
         run: |
           ${SLIC_BIN} up wordpress
           ${SLIC_BIN} site-cli core version
+          ${SLIC_BIN} site-cli core update
+          ${SLIC_BIN} site-cli core update-db
+          ${SLIC_BIN} site-cli core version
       # ------------------------------------------------------------------------------
       # Install and activate TwentyTwenty
       # ------------------------------------------------------------------------------

classes/Pods.php

@@ -1,5 +1,10 @@
 <?php
 
+// Don't load directly.
+if ( ! defined( 'ABSPATH' ) ) {
+	die( '-1' );
+}
+
 use Pods\Data\Map_Field_Values;
 use Pods\Whatsit\Object_Field;
 use Pods\Whatsit\Field;
@@ -3358,6 +3363,19 @@ public function export_data( $params = null ) {
 		return $this->data->api->export( $this, $params );
 	}
 
+	/**
+	 * Display the pagination controls, types supported by default
+	 * are simple, paginate and advanced. The base and format parameters
+	 * are used only for the paginate view.
+	 *
+	 * @since TBD
+	 *
+	 * @param array|object $params Associative array of parameters.
+	 */
+	public function output_pagination( $params = null ) {
+		echo $this->pagination( $params ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
+	}
+
 	/**
 	 * Display the pagination controls, types supported by default
 	 * are simple, paginate and advanced. The base and format parameters
@@ -3441,6 +3459,17 @@ public function pagination( $params = null ) {
 
 	}
 
+	/**
+	 * Return a filter form for searching a Pod
+	 *
+	 * @since TBD
+	 *
+	 * @param array|string $params Comma-separated list of fields or array of parameters.
+	 */
+	public function output_filters( $params = null ) {
+		echo $this->filters( $params ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
+	}
+
 	/**
 	 * Return a filter form for searching a Pod
 	 *
@@ -3609,7 +3638,7 @@ public function helper( $helper, $value = null, $name = null ) {
 
 		// Clean up helper callback (if string).
 		if ( is_string( $params['helper'] ) ) {
-			$params['helper'] = strip_tags( str_replace( array( '`', chr( 96 ) ), "'", $params['helper'] ) );
+			$params['helper'] = wp_strip_all_tags( str_replace( array( '`', chr( 96 ) ), "'", $params['helper'] ) );
 		}
 
 		if ( ! pods_access_callback_allowed( $params['helper'], $params ) ) {
@@ -3622,10 +3651,10 @@ public function helper( $helper, $value = null, $name = null ) {
 			}
 
 			if ( $include_obj ) {
-				return apply_filters( $params['helper'], $value, $this );
+				return apply_filters( $params['helper'], $value, $this ); // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.DynamicHooknameFound
 			}
 
-			return apply_filters( $params['helper'], $value );
+			return apply_filters( $params['helper'], $value ); // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.DynamicHooknameFound
 		}
 
 		try {
@@ -3879,6 +3908,21 @@ public function template( $template_name, $code = null, $deprecated = false, $ch
 		return apply_filters( 'pods_template_content', $out, $code, $this );
 	}
 
+	/**
+	 * Embed a form to add / edit a pod item from within your theme. Provide an array of $fields to include
+	 * and override options where needed. For WP object based Pods, you can pass through the WP object
+	 * field names too, such as "post_title" or "post_content" for example.
+	 *
+	 * @since TBD
+	 *
+	 * @param array  $params    (optional) Fields to show on the form, defaults to all fields.
+	 * @param string $label     (optional) Save button label, defaults to "Save Changes".
+	 * @param string $thank_you (optional) Thank you URL to send to upon success.
+	 */
+	public function output_form( $params = null, $label = null, $thank_you = null ) {
+		echo $this->form( $params, $label, $thank_you ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
+	}
+
 	/**
 	 * Embed a form to add / edit a pod item from within your theme. Provide an array of $fields to include
 	 * and override options where needed. For WP object based Pods, you can pass through the WP object
@@ -4208,10 +4252,14 @@ public function view( $view_fields = null ) {
 				$field['name'] = $to_merge['name'];
 			}
 
-			if ( pods_v( 'hidden', $field, false, true ) || 'hidden' === $field['type'] ) {
+			if ( pods_v_bool( 'hidden', $field ) || 'hidden' === $field['type'] ) {
 				continue;
 			} elseif ( ! pods_permission( $field ) ) {
-				continue;
+				if ( pods_v_bool( 'read_only_restricted', $field ) ) {
+					$field['read_only'] = true;
+				} else {
+					continue;
+				}
 			}
 
 			$fields[ $field['name'] ] = $field;
@@ -4254,7 +4302,7 @@ public function do_magic_tags( $code ) {
 
 		if ( ! is_string( $code ) ) {
 			_doing_it_wrong( __FUNCTION__, 'Pods::do_magic_tags() must be given a string, a non-string was provided.', '3.3.2' );
-			pods_debug_log( 'Pods::do_magic_tags() called with non-string: ' . var_export( $code, true ) );
+			pods_debug_log( 'Pods::do_magic_tags() called with non-string: ' . wp_json_encode( $code, JSON_PRETTY_PRINT ) );
 
 			return '';
 		}