Update documentation

dero · dero · commit f6194c20c774 · 2025-03-24T15:41:38.000+01:00
diff --git a/docs/cloudinary_admin_pages.html b/docs/cloudinary_admin_pages.html
@@ -142,7 +142,7 @@ <h5>Parameters:</h5>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="ui-definitions_settings-pages.php.html">ui-definitions/settings-pages.php</a>, <a href="ui-definitions_settings-pages.php.html#line547">line 547</a>
+        <a href="ui-definitions_settings-pages.php.html">ui-definitions/settings-pages.php</a>, <a href="ui-definitions_settings-pages.php.html#line558">line 558</a>
     </li></ul></dd>
     
 
diff --git a/docs/cloudinary_home_url.html b/docs/cloudinary_home_url.html
@@ -191,7 +191,7 @@ <h5>Parameters:</h5>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="php_class-utils.php.html">php/class-utils.php</a>, <a href="php_class-utils.php.html#line1207">line 1207</a>
+        <a href="php_class-utils.php.html">php/class-utils.php</a>, <a href="php_class-utils.php.html#line1200">line 1200</a>
     </li></ul></dd>
     
 
diff --git a/docs/cloudinary_ignored_class_keywords.html b/docs/cloudinary_ignored_class_keywords.html
@@ -145,7 +145,7 @@ <h5>Parameters:</h5>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="php_class-utils.php.html">php/class-utils.php</a>, <a href="php_class-utils.php.html#line826">line 826</a>
+        <a href="php_class-utils.php.html">php/class-utils.php</a>, <a href="php_class-utils.php.html#line827">line 827</a>
     </li></ul></dd>
     
 
diff --git a/docs/cloudinary_ignored_data_keywords.html b/docs/cloudinary_ignored_data_keywords.html
@@ -145,7 +145,7 @@ <h5>Parameters:</h5>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="php_class-utils.php.html">php/class-utils.php</a>, <a href="php_class-utils.php.html#line814">line 814</a>
+        <a href="php_class-utils.php.html">php/class-utils.php</a>, <a href="php_class-utils.php.html#line815">line 815</a>
     </li></ul></dd>
     
 
diff --git a/docs/cloudinary_media_context.html b/docs/cloudinary_media_context.html
@@ -179,7 +179,7 @@ <h5>Parameters:</h5>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="php_class-utils.php.html">php/class-utils.php</a>, <a href="php_class-utils.php.html#line1172">line 1172</a>
+        <a href="php_class-utils.php.html">php/class-utils.php</a>, <a href="php_class-utils.php.html#line1165">line 1165</a>
     </li></ul></dd>
     
 
diff --git a/docs/cloudinary_media_context_query.html b/docs/cloudinary_media_context_query.html
@@ -145,7 +145,7 @@ <h5>Parameters:</h5>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="php_class-utils.php.html">php/class-utils.php</a>, <a href="php_class-utils.php.html#line1024">line 1024</a>
+        <a href="php_class-utils.php.html">php/class-utils.php</a>, <a href="php_class-utils.php.html#line1017">line 1017</a>
     </li></ul></dd>
     
 
diff --git a/docs/cloudinary_media_context_things.html b/docs/cloudinary_media_context_things.html
@@ -145,7 +145,7 @@ <h5>Parameters:</h5>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="php_class-utils.php.html">php/class-utils.php</a>, <a href="php_class-utils.php.html#line1036">line 1036</a>
+        <a href="php_class-utils.php.html">php/class-utils.php</a>, <a href="php_class-utils.php.html#line1029">line 1029</a>
     </li></ul></dd>
     
 
diff --git a/docs/cloudinary_registered_sizes.html b/docs/cloudinary_registered_sizes.html
@@ -140,7 +140,7 @@ <h5>Parameters:</h5>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="php_class-utils.php.html">php/class-utils.php</a>, <a href="php_class-utils.php.html#line962">line 962</a>
+        <a href="php_class-utils.php.html">php/class-utils.php</a>, <a href="php_class-utils.php.html#line955">line 955</a>
     </li></ul></dd>
     
 
diff --git a/docs/cloudinary_rest_url.html b/docs/cloudinary_rest_url.html
@@ -191,7 +191,7 @@ <h5>Parameters:</h5>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="php_class-utils.php.html">php/class-utils.php</a>, <a href="php_class-utils.php.html#line1263">line 1263</a>
+        <a href="php_class-utils.php.html">php/class-utils.php</a>, <a href="php_class-utils.php.html#line1256">line 1256</a>
     </li></ul></dd>
     
 
diff --git a/docs/cloudinary_site_url.html b/docs/cloudinary_site_url.html
@@ -191,7 +191,7 @@ <h5>Parameters:</h5>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="php_class-utils.php.html">php/class-utils.php</a>, <a href="php_class-utils.php.html#line1237">line 1237</a>
+        <a href="php_class-utils.php.html">php/class-utils.php</a>, <a href="php_class-utils.php.html#line1230">line 1230</a>
     </li></ul></dd>
     
 
diff --git a/docs/cloudinary_task_capability.html b/docs/cloudinary_task_capability.html
@@ -214,7 +214,7 @@ <h5>Parameters:</h5>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="php_class-utils.php.html">php/class-utils.php</a>, <a href="php_class-utils.php.html#line228">line 228</a>
+        <a href="php_class-utils.php.html">php/class-utils.php</a>, <a href="php_class-utils.php.html#line229">line 229</a>
     </li></ul></dd>
     
 
diff --git a/docs/cloudinary_task_capability_%7Btask%7D.html b/docs/cloudinary_task_capability_%7Btask%7D.html
@@ -196,7 +196,7 @@ <h5>Parameters:</h5>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="php_class-utils.php.html">php/class-utils.php</a>, <a href="php_class-utils.php.html#line197">line 197</a>
+        <a href="php_class-utils.php.html">php/class-utils.php</a>, <a href="php_class-utils.php.html#line198">line 198</a>
     </li></ul></dd>
     
 
diff --git a/docs/cloudinary_upgrade_sequence.html b/docs/cloudinary_upgrade_sequence.html
@@ -145,7 +145,7 @@ <h5>Parameters:</h5>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="php_class-utils.php.html">php/class-utils.php</a>, <a href="php_class-utils.php.html#line390">line 390</a>
+        <a href="php_class-utils.php.html">php/class-utils.php</a>, <a href="php_class-utils.php.html#line391">line 391</a>
     </li></ul></dd>
     
 
diff --git a/docs/php_class-utils.php.html b/docs/php_class-utils.php.html
@@ -41,6 +41,7 @@ <h1 class="page-title">Source: php/class-utils.php</h1>
 
 namespace Cloudinary;
 
+use Cloudinary\Misc\Image_Sizes_No_Textdomain;
 use Cloudinary\Settings\Setting;
 use Google\Web_Stories\Story_Post_Type;
 use WP_Post;
@@ -506,7 +507,7 @@ <h1 class="page-title">Source: php/class-utils.php</h1>
 					$plugin->version
 				)
 			),
-			'tf_description'  => esc_attr( __( 'Please, provide more details on your request, and if possible, attach a System Report', 'cloudinary' ) ),
+			'tf_description'               => esc_attr( __( 'Please, provide more details on your request, and if possible, attach a System Report', 'cloudinary' ) ),
 		);
 
 		$args = wp_parse_args(
@@ -608,7 +609,7 @@ <h1 class="page-title">Source: php/class-utils.php</h1>
 			// Fallback if rest engine is not setup yet.
 			$rest_base   = wp_parse_url( static::rest_url( '/' ), PHP_URL_PATH );
 			$request_uri = filter_input( INPUT_SERVER, 'REQUEST_URI', FILTER_SANITIZE_URL );
-			$is          = strpos( $request_uri, $rest_base ) === 0;
+			$is          = is_string( $request_uri ) &amp;&amp; strpos( $request_uri, $rest_base ) === 0;
 		}
 
 		return $is;
@@ -958,15 +959,7 @@ <h1 class="page-title">Source: php/class-utils.php</h1>
 		/** This filter is documented in wp-admin/includes/media.php */
 		$image_sizes = apply_filters(
 			'image_size_names_choose',
-			array(
-				// phpcs:disable WordPress.WP.I18n.MissingArgDomain
-				'thumbnail'    => __( 'Thumbnail' ),
-				'medium'       => __( 'Medium' ),
-				'medium_large' => __( 'Medium Large' ),
-				'large'        => __( 'Large' ),
-				'full'         => __( 'Full Size' ),
-				// phpcs:enable WordPress.WP.I18n.MissingArgDomain
-			)
+			Image_Sizes_No_Textdomain::get_image_sizes()
 		);
 
 		$labels = wp_parse_args( $labels, $image_sizes );
diff --git a/docs/php_delivery_class-responsive-breakpoints.php.html b/docs/php_delivery_class-responsive-breakpoints.php.html
@@ -174,7 +174,7 @@ <h1 class="page-title">Source: php/delivery/class-responsive-breakpoints.php</h1
 		$size_transformation = $this->media->get_crop_from_transformation( $this->media->get_transformations_from_string( $src ) );
 		$size_string         = Api::generate_transformation_string( array( $size_transformation ) );
 		$breakpoints         = array();
-		while ( $max > $min ) {
+		while ( $max >= $min ) {
 			if ( $width >= $max ) {
 				$size_transformation['width']  = $max;
 				$size_transformation['height'] = floor( $max / $ratio );
diff --git a/docs/ui-definitions_settings-pages.php.html b/docs/ui-definitions_settings-pages.php.html
@@ -480,12 +480,23 @@ <h1 class="page-title">Source: ui-definitions/settings-pages.php</h1>
 					'collapsible' => 'closed',
 					'content'     => sprintf(
 						// translators: The HTML markup.
-						__( ' To function correctly, the Cloudinary plugin requires an active WordPress REST API connection. Ensure your WordPress setup, including multisite or headless configurations, has the REST API enabled and active for seamless plugin operation.%1$sFor more information, see %2$sWordPress’s REST API Handbook%3$s.', 'cloudinary' ),
+						__( 'To function correctly, the Cloudinary plugin requires an active WordPress REST API connection. Ensure your WordPress setup, including multisite or headless configurations, has the REST API enabled and active for seamless plugin operation.%1$sFor more information, see %2$sWordPress’s REST API Handbook%3$s.', 'cloudinary' ),
 						'&lt;br>&lt;br>',
 						'&lt;a href="https://developer.wordpress.org/rest-api/" target="_blank" rel="noopener noreferrer">',
 						'&lt;/a>'
 					),
 				),
+				array(
+					'type'        => 'panel',
+					'title'       => __( 'Does Cloudinary work on multilingual sites?', 'cloudinary' ),
+					'collapsible' => 'closed',
+					'content'     => sprintf(
+						// translators: The HTML markup.
+						__( 'Absolutely! Cloudinary is fully compatible with WPML, the leading WordPress multilingual plugin, and is officially recommended for seamless media management across multiple languages. Cloudinary ensures that your media assets are efficiently handled on your multilingual site. For more details, visit %1$sWPML\'s official page%2$s on Cloudinary compatibility.', 'cloudinary' ),
+						'&lt;a href="https://wpml.org/plugin/cloudinary/" target="_blank" rel="noopener noreferrer">',
+						'&lt;/a>'
+					),
+				),
 				array(
 					'type'        => 'panel',
 					'title'       => __( "I'm having an incompatibility issue with a theme, plugin, or hosting environment, what can I do?", 'cloudinary' ),
diff --git a/package-lock.json b/package-lock.json
