chore: Release version 4.2.1

Merge branch 'release/4.2.1'

Author: MdAsifHossainNadim

CHANGELOG.md

@@ -1,3 +1,25 @@
+### v4.2.1 ( Dec 04, 2025 ) ###
+- **new:** Added a "Filter by Vendor Sub-orders" option to the WooCommerce Orders page to easily filter specific marketplace orders.
+- **update:** Redesigned the Admin Panel "Not Found" page template for a better look and user experience.
+- **update:** Ensured full compatibility for the legacy admin panel store support page.
+- **update:** Improved how tooltips appear and remain visible in both the Dokan vendor and admin panels.
+- **update:** Clicking the site title in the new vendor dashboard now redirects to the marketplace main site URL.
+- **update:** Added support for legacy URL settings to the "Visit Dashboard" button within the Admin Setup Wizard.
+- **fix:** Applied menu manager support to correctly control the vendor sidebar menus in the new dashboard layout.
+- **fix:** Added the ability to sort the vendor management table by registration date.
+- **fix:** Corrected the default toggle switch states when creating a new vendor to ensure they start in the intended position.
+- **fix:** Added checks to ensure users without a vendor account are redirected to a proper "404 Not Found" page instead of an error.
+- **fix:** Allowed vendors to correctly enter decimal amounts in the withdrawal request popup.
+- **fix:** Ensured that admin-configured banner dimensions are correctly displayed in the admin vendor settings.
+- **fix:** Fixed an issue where manual withdrawal requests now correctly reflect the settings configured by the admin.
+- **fix:** Updated the correct method for translating text (text domain handling) for recommended plugins.
+- **fix:** Prevented the "Complete Your Marketplace Setup" widget from showing up after the vendor has finished all the onboarding steps.
+- **fix:** Added support for including product variations in products rest api requests.
+- **fix:** Stopped unnecessary warnings and notices from appearing during the initial store setup process.
+- **fix:** Restored the side-by-side layout for the main Admin Dashboard panel.
+- **fix:** Prevent console warning from admin panel setup guide banner elements.
+- **fix:** Remove setup guide banner for admin setup guide pages.
+
 ### v4.2.0 ( Nov 24, 2025 ) ###
 - **update:** Ensured full compatibility for the legacy admin panel across Subscriptions, Announcements, Wholesale, Product Ads, Abuse Reports, Seller Badge, and Refund pages.
 - **update:** The vendor dashboard now supports modern, full-width theme layouts, providing a more spacious user experience.

assets/src/js/script.js

@@ -167,39 +167,15 @@ jQuery(function($) {
           dokan.store_banner_dimension['flex-height'],
           10
         ),
-        ratio,
-        xImg,
-        yImg,
         realHeight,
         realWidth,
         imgSelectOptions;
 
       realWidth = attachment.get('width');
       realHeight = attachment.get('height');
 
-      this.headerImage = new api.HeaderTool.ImageModel();
-      this.headerImage.set({
-        themeWidth: xInit,
-        themeHeight: yInit,
-        themeFlexWidth: flexWidth,
-        themeFlexHeight: flexHeight,
-        imageWidth: realWidth,
-        imageHeight: realHeight
-      });
-
-      controller.set('canSkipCrop', !this.headerImage.shouldBeCropped());
-
-      ratio = xInit / yInit;
-      xImg = realWidth;
-      yImg = realHeight;
-
-      if (xImg / yImg > ratio) {
-        yInit = yImg;
-        xInit = yInit * ratio;
-      } else {
-        xInit = xImg;
-        yInit = xInit / ratio;
-      }
+      var control = controller.get('control');
+      controller.set('canSkipCrop', !control.mustBeCropped(flexWidth, flexHeight, xInit, yInit, realWidth, realHeight));
 
       imgSelectOptions = {
         handles: true,
@@ -211,19 +187,12 @@ jQuery(function($) {
         x1: 0,
         y1: 0,
         x2: xInit,
-        y2: yInit
+        y2: yInit,
+        aspectRatio: xInit + ':' + yInit,
+        maxHeight: yInit,
+        maxWidth: xInit,
       };
 
-      if (flexHeight === false && flexWidth === false) {
-        imgSelectOptions.aspectRatio = xInit + ':' + yInit;
-      }
-      if (flexHeight === false) {
-        imgSelectOptions.maxHeight = yInit;
-      }
-      if (flexWidth === false) {
-        imgSelectOptions.maxWidth = xInit;
-      }
-
       return imgSelectOptions;
     },
 
@@ -310,6 +279,45 @@ jQuery(function($) {
 
       settings.uploadBtn = this;
 
+      var cropControl = {
+        id: "control-id",
+        params: {
+          width: parseInt(dokan.store_banner_dimension.width, 10),
+          height: parseInt(dokan.store_banner_dimension.height, 10),
+          flex_width: !!parseInt(dokan.store_banner_dimension['flex-width'], 10),
+          flex_height: !!parseInt(dokan.store_banner_dimension['flex-height'], 10),
+        }
+      };
+
+      cropControl.mustBeCropped = function(flexW, flexH, dstW, dstH, imgW, imgH) {
+        // If the width and height are both flexible then the user does not need to crop the image
+        if (true === flexW && true === flexH) {
+          return false;
+        }
+
+        // If the width is flexible and the cropped image height matches the current image height, then the user does not need to crop the image.
+        if (true === flexW && dstH === imgH) {
+          return false;
+        }
+
+        // If the height is flexible and the cropped image width matches the current image width, then the user does not need to crop the image.
+        if (true === flexH && dstW === imgW) {
+          return false;
+        }
+
+        // If the cropped image width matches the current image width, and the cropped image height matches the current image height, then the user does not need to crop the image.
+        if (dstW === imgW && dstH === imgH) {
+          return false;
+        }
+
+        // If the destination width is equal to or greater than the cropped image width then the user does not need to crop the image
+        if (imgW <= dstW) {
+          return false;
+        }
+
+        return true;
+      };
+
       settings.frame = wp.media({
         multiple: false,
         button: {
@@ -326,9 +334,9 @@ jQuery(function($) {
             suggestedWidth: dokan.store_banner_dimension.width,
             suggestedHeight: dokan.store_banner_dimension.height
           }),
-          new wp.media.controller.Cropper({
-            suggestedWidth: 5000,
-            imgSelectOptions: settings.calculateImageSelectOptions
+          new wp.media.controller.CustomizeImageCropper({
+            imgSelectOptions: settings.calculateImageSelectOptions,
+            control: cropControl
           })
         ]
       });