# WeSupply_Toolbox


### Installation

With composer:

```sh
$ composer config repositories.wesupply-toolbox git git@github.com:wesupplylabs/WeSupply_Toolbox.git
$ composer require wesupply/toolbox:dev-master
```

Note: Composer installation only available for internal use for the moment as the repository are not public. However, there is a work around that will allow you to install the product via composer, described in the article below: https://support.weltpixel.com/hc/en-us/articles/115000216654-How-to-use-composer-and-install-Pearl-Theme-or-other-WeltPixel-extensions

Manually:

Copy the zip into app/code/WeSupply/Toolbox directory


#### After installation by either means, enable the extension by running following commands:

```sh
$ php bin/magento module:enable WeSupply_Toolbox --clear-static-content
$ php bin/magento setup:upgrade
```

###Release Notes

Version 1.12.13, Jun 24, 2025  
-Resolved a potential issue where the checkout process could hang or enter an infinite loop when placing orders using payment methods with authorize and capture.  

Version 1.12.12, May 28, 2025  
-Improved the iframe resizer to maintain reliable communication between WeSupply and the host pages where its content is embedded.  

Version 1.12.11, May 21, 2025  
-Magento Compatibility: Introduced compatibility with the new Magento 2.4.8 release, as well as the accompanying 2.4.7-p5, 2.4.7-p4, 2.4.7-p3, 2.4.7-p2 and 2.4.7-p1 Security Patches.  
-Added Norton Shopping Guarantee integration – Boosts customer confidence by protecting purchases from checkout through delivery. Learn more: https://norton.buysafe.com/  

Version 1.12.10, November 25, 2024  
-Introduced compatibility with the latest Magento 2.4.7-p3, 2.4.6-p8, 2.4.5-p10 and 2.4.4-p11 versions.  
-Introduced compatibility with the Mageworx Order Editor extension.  
-Added various minor adjustments for increased security.  

Version 1.12.9, July 19, 2024  
-Introduced compatibility with the latest Magento 2.4.7-p1, 2.4.6-p6, 2.4.5-p8 and 2.4.4-p9 versions.  
-Added adjustments to account for new Magento CSP restrictions, particularly on the Checkout.  
-Fixed an issue that would sometimes result in images for Child Products not being pulled.  

Version 1.12.8, March 18, 2024  
-Fixed an issue that would prevent the connection between WeSupply and Magento from being made properly on Magento Commerce instances with website restrictions enabled.  
-Fixed an issue that would prevent product dimensions, such as weight from being imported into WeSupply correctly, when configured in the Toolbox module.  
-Optimized the image fetch process, ensuring the extension now fetches the Small Image from Magento, as opposed to the Base Image, which is larger.  
-Fixed an issue that, in some cases, prevented specific attribute types from being exported from Magento for use in WeSupply via Toolbox options.  
-Fixed a bug related to permissions/ACL that would prevent the extension's settings from being accessed unless the user had an admin role.  
-Updated Magento Admin comments and setting descriptions around options that require a Domain Alias for increased clarity.  
-Confirmed compatibility with the latest 2.4.6-p4, 2.4.5-p6 and 2.4.4-p7 versions.  

Version 1.12.7, September 6, 2023  
-New Feature: Improved the logging process to ensure enough debug information is written into the wesupply.log file when an error occurs during the order import/update process.  
-Fixed an error that would sometimes be thrown when using specific payment methods that capture orders after authorization.  
-Fixed an issue that prevented the extension from correctly reading DB tables that have prefixes.  

Version 1.12.6, April 20, 2023  
-Added compatibility for stores that serve product images from external locations, such as Adobe's Remote Storage or Amazon's S3. Previously, product images would only render correctly if served from the Magento 2 instance.  
-Added functionality to ensure an order update is triggered when a customer updates their email address from within their store account.  
-Added functionality to send Customer Group and Customer Group Description to WeSupply for use with Return Logic Conditions.  
-Fixed a bug that would occasionally prevent certain frontend notification messages from being displayed.  
-Fixed a bug that would result in a console warning related to properly nested and closed HTML tags.  
-Confirmed compatibility with Magento 2.4.6, 2.4.5-p2 and PHP 8.2.  

Version 1.12.5, November 18, 2022  
-Optimized the Magento Order Import process by increasing the XML file size limit.  

Version 1.12.4, July 14, 2022  
-New Feature: Added the possibility of displaying Gift Messages in WeSupply Email templates via variables. This applies to Gift Messages added to the whole order, as well as those added to individual items.  
-Improved the Order Import/Update process, which now better accounts for bulk imports/updates that are sent to WeSupply in in a very short period of time.  
-Fixed an issue that sometimes caused Standard and Virtual/Downloadable Products to be bundled together in the WeSupply Order View.  
-Optimized the extension installation and upgrade process in order to comply with Magento Best Practices.  

Version 1.12.2, May 23rd, 2022  
-Fixed an error specific to Magento 2.4.4 that prevented Shipping Options from loading on the Checkout Page when the Estimated Delivery Date functionality was enabled  
-Fixed an issue that prevented Estimate Delivery Ranges from functioning properly in the Cart and on the Checkout Page when set to "As Range: Earliest - Latest"  
-Fixed a bug that prevented Estimated Delivery Dates from being calculated for non-swatch type attributes  
-Fixed a bug that prevented orders which contained products with no images from being imported into WeSupply while using PHP 8.1  
-Fixed an error that was thrown on the Tracking Page when it was set to "Open in Magento" while using PHP 8.1  

Version 1.12.1, April 25th, 2022  
-Confirmed compatibility with the latest Magento 2.4.4 and 2.3.7-p3 versions, as well as PHP 8.1  
-Added a new option that allows for invoices to be generated automatically in Magento when an order is marked as Picked Up in WeSupply  
-Fixed an issue that caused the Estimates functionality to become hidden on Product Pages when using an invalid ZIP code. An error message was also added to inform the user of the invalid ZIP code  
-Fixed an issue that would, in certain cases, cause a connection reset when switching between WeSupply accounts connected to the same Magento instance  
-Adjusted Order View and Return List button links in the Magento Admin  
-Adjusted links to pages displayed in the Help Center section of the extension in the Magento Admin  

Version 1.11.1, Jan 21th, 2022  
-Added functionality to be able to partially refund returns, and to be able to split a return in multiple refunds  
-Improved messages for Credit Memo  
-Improved code to better compatiblity with custom code that changes the default Magento checkout flow  
-Improved the cron that collects orders that were created via custom code   
-Fixed an issue when the refund was set as Store credit  
-Fixed an error for delivery estimation functionality that was generated when custom checkouts are used.  
-Fixed an issue that generated an exception on Track page when using PHP 7.2. 


Version 1.10.21, Dec 16th, 2021  
-Added performance optimizations for DBs with a large number of orders  
-Optimized the cleanup cron job that removes old entries from the WeSupply DB table  
-Optimized the import/update process for orders imported/updated via external APIs  
  
Version 1.10.20, Nov 15th, 2021  

-Added new WeSupply Return option: Instant Credit (by creating a Magento Coupon Code)  
-Fixed an issue related to Auto Close process of WeSupply Returns  

Version 1.10.19, Sept 14th, 2021  

-Optimized the order export functionality to include updates on orders, invoices and shipments created from an external processor or custom modules  
-Fixed an issue related to connection between WeSupply and Multi Websites Magento configuration  

Version 1.10.18, Aug 30th, 2021  
  
-Improved order export functionality to include orders imported from eBay and Amazon that have hidden or missing customer billing address  
-Fixed the issue related to the timezone of the displayed order created date  

Version 1.10.17, Aug 20th, 2021  

-Fixed a display/design issue related to the SMS Notification Sign Up Widget  
-Replaced the default Magento tracking number link with the WeSupply Branded Tracking Page  
  
Version 1.10.16, Jul 29th, 2021  

-Added new options in the Toolbox configuration section that allow for replacing the default Magento Order List with the one imported into the WeSupply Platform  
-Improved the return and refund functionalities to avoid duplicate refunds on slower servers  
-Fixed a bug related to canceled orders that were placed using the In-store Pick Up delivery method  

Version 1.10.15, Jul 14th, 2021  

-Optimized database performance by adding a cron job that removes orders older than 6 months from WeSupply table  
-Enhanced compatibility with 3rd party ERP software by adding a cron job that automatically detects order updates  
-Fixed an error that was thrown when WeSupply tried to import an order containing a product that no longer exists  
-Fixed an issue that prevented pickup and curbside orders from being canceled via the frontend  

Version 1.10.14, Jun 8th, 2021  

-New Feature: Added a new option in the Toolbox configuration section that allows for excluding orders in the "Complete" status from being imported into WeSupply (this applies only to orders created directly with the "Complete" status)  
-Added XSS security enhancements  

Version 1.10.13, May 10th, 2021  
  
-Extended WeSupply import process to include Virtual and Downloadable products  
-Optimized the order export functionality to avoid duplicate items in case the shipment is created/updated from an external processor, via an API call  
-Fixed a bug related to Estimated Delivery Date range calculation and display  

Version 1.10.12, April 8th, 2021  

-New Feature: Added a new option in the Toolbox configuration section that allows for excluding pending orders from being imported into WeSupply  
-Fixed a bug that prevented estimation ranges from being displayed on the frontend  

Version 1.10.11, March 11th, 2021  

-New Feature: Implemented the In store pickup functionality  
-New Feature: Added new admin configuration options for Estimated Delivery Date frontend display  
-Added Help Center Pages in the Magento Admin WeSupply section  
-Fixed a height issue related to the Shipment Tracking iFrame  

Version 1.10.10, February 1st, 2021  

-Fixed an issue specific to Magento 2.4.x which prevented estimates from working on configurable products  
-Fixed a height issue related to the store locator iframe  
-Added more detailed error logs in case of failed refunds  

Version 1.10.9, December 8th, 2020  

-Fixed an issue whereby online refunds would sometimes be processed offline  
-Fixed a small Shipping Method Title display issue on the Checkout Page  

Version 1.10.8, November 25th, 2020  
                  
-Fixed an issue related to processing refunds when the Magento MSI functionality was disabled  

Version 1.10.7, November 23th, 2020  

-Added compatibility with Magento's In-Store pickup functionality (Magento 2.4.x)  
-Added more specific messages in case of errors during return process 
-Optimized iframe resizer for Open in Modal order view behavior  
-Updated product image path generation process  
  
Version 1.10.6, November 5th, 2020  

-Updated order export functionality to include compatibility with the Magento Multi Source Inventory  
  
Version 1.10.5, October 19th, 2020  

-Removed deprecated refund method 

Version 1.10.4, October 9th, 2020  

-Orders excluded through the import process are no longer saved in the DB. This avoids accidental duplicate orders  in WeSupply  
  
Version 1.10.3, September 29th, 2020  

-Optimized and improved FetchSingleOrder API functionality  
-Style adjustments for embedded store locator iframes  

Version 1.10.2, September 9th, 2020  

-Fixed an issue related to SMS Notification subscribe functionality on the Success Page  

Version 1.10.1, September 2nd, 2020  

-Adjusted deprecated callbacks of iframeResizer library  
-Added more specific targeting to WeSupply iFrames  
-Bypassed CDN for iframeResizer JS loading. JS files now load directly via the server, and not via a CDN  

Version 1.10.0, August 11th, 2020  

-Whitelisted WeSupply domain for Content Security Policies  
-Fixed and improved domain alias functionality  
-Changed the WeSupply links for Order View and Returns to be displayed as a dropdown  
-Confirmed compatibility with the newly released Magento 2.4.0 version  
-Confirmed compatibility with PHP7.4  

Version 1.9.12, July 1st, 2020  

-Removed an unnecessary hidden input that, in some cases, caused an error on the checkout if no estimates were available  
-Added new config fields to map and export to WeSupply the product attributes used to define weight and measurements  
-Rebuilt delivery estimation functionality based on the newly created config fields  

Version 1.9.11, June 26th, 2020  

-Added WeSupply Order View and Returns List as embedded iFrames under Magento's Admin > Sales > Order View page, which offers the possibility to directly interact with the orders and returns synced with the WeSupply platform  

Version 1.9.10, June 17th, 2020  

-Added new functionality that allows for choosing additional product attributes which can be used for setting up WeSupply Return Logic  
-Added the delivery date selected by the customer in the checkout process to the order export  

Version 1.9.9, April 22th, 2020  

-Optimized WeSupply connection steps  
-Small bug fixes and other minor optimizations  

Version 1.9.8, March 25th, 2020  

-Added new functionality that allows setting multiple refunds types on the same return request  
-Other minor optimizations / improvements  

Version 1.9.7, March 2nd, 2020  

-Added new functionality that allows for choosing which Magento orders are exported to WeSupply: All Orders, No Orders or Exclude Specific Orders based on shipping country  
-Added link to product in WeSupply confirmation email templates  
-Fixed a bug which caused the WeSupply view orders functionality in Magento to break on Safari (iOS) by adding a new option in WeSupply called "Domain Alias"  
-Added more customer details to exported orders from Magento to WeSupply  
-Added WeSupply Return comments in Magento Credit Memo history  
-Other minor optimizations / improvements  

Version 1.9.6, February 14th, 2020  

-Improved functionality of SMS Notification subscription  
-Added SMS Notification unsubscription functionality  

Version 1.9.5, February 6th, 2020

-WeSupply and Magento connection errors are now more specific. Before this version, a generic "Invalid API credentials" error was thrown.  
-Orders are now updated in the WeSupply dashboard based on tracking number modifications/updates via Magento.  
-A new "None" option was added in the WeSupply dashboard for the Refund Processor setting. Before this update, the only available option was "Magento", and could not be deselected after being saved once.  
-Upon issuing a refund via WeSupply, if there is no Refund Processor selected, the Refund button is now disabled and a notice is shown which prompts you to set a Refund Processor.  
