CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog.

3.4.6 - 2024-08-28

Changed

• Add detection of expired drafts

3.4.5 - 2024-07-30

Changed

• Change BatchTaskCleanupTask to delete tasks in batches

3.4.4 - 2024-07-12

Changed

• Fix front for integrations which still doesn't support customs

3.4.3 - 2024-07-08

Changed

• Add unsupported country Algeria

3.4.2 - 2024-07-03

Added

• Upgrade tests to work with PHPUnit 10 and above

3.4.1 - 2024-07-03

Added

• Added compatibility with PHP 8.3

3.4.0 - 2024-05-20

Added

• Added creating customs invoice in Packlink PRO

3.3.21 - 2024-04-02

Changed

• Add unsupported countries Denmark, Norway, Saudi Arabia, Canada, Cyprus, Slovenia and Slovakia
• Add min-height property to lp-content class

3.3.20 - 2024-04-03

Changed

– Add unsupported countries Estonia, Latvia and Romania

3.3.19 - 2024-24-02

Changed

– Add unsupported countries (Bulgaria, Finland, Greece, Australia) – Add French overseas territories

3.3.18 - 2023-11-01

Changed

• Fixed issue with shipping polices

3.3.17 - 2023-09-13

Changed

• Fixed issue with shipping polices

3.3.16 - 2023-07-17

Changed

• Modify regular expression pattern for phone validation to support invisible characters

3.3.15 - 2023-06-05

Changed

• Update link to order draft on Packlink

3.3.14 - 2023-05-09

Changed

• Fixed shipment url opened when 'View on Packlink' button is clicked on order

3.3.13 - 2023-03-08

Added

• Explicitly added order by id to the get config entity query for compatibility with Percona database

3.3.12 - 2023-01-31

Changed

• In DtoValidator email is now trimmed before validation.
• Changed Chrome version to latest in curl user agent.

3.3.11 - 2022-09-26

Added

• Added 'shipment.carrier.delivered' event to the list of valid events that are handled by webhook handler.

3.3.10 - 2022-06-27

Changed

• In FrontDtoValidationException constructor, fourth parameter type changed from object to \Exception.
• Added keep alive mechanism in UpdateShippingServicesTask in case there are too many shipping services that need to be synchronized.

3.3.9 - 2022-05-30

Added

• Added __serialize and __unserialize methods to Serializable interface in order to add compatibility with PHP8.1.
• Implemented __serialize and __unserialize methods in all classes that implement Serializable interface.

3.3.8 - 2022-05-09

Added

• Added carrier logos for Colis Prive and Shop2Shop shipping services.

3.3.7 - 2022-04-04

Changed

• Fixed a frontend issue when adding/deleting pricing policies on the module edit service page.

3.3.6 - 2022-02-09

Changed

• Updated marketing calls flag to always be set to true when registering a new client through modules.

3.3.5 - 2022-01-31

Added

• Added a new configuration flag that specifies whether a given integration supports drop-off carriers or not. The default will be true and only integrations that do not support drop-off carriers should set this flag to false.

Changed

• Fixed a frontend issue when adding/editing a shipping service on the module configuration page.

3.3.4 - 2021-11-30

Changed

• Updated the mechanism for fetching controller URLs on the frontend views.

3.3.3 - 2021-08-26

BREAKING CHANGES

Changed

• Updated order service to set order number as a shipment custom reference instead of order ID when creating a draft. Integrations need to set an order number in the ShopOrderService::getOrderAndShippingData.

3.3.2 - 2021-08-24

Changed

• Reverted Shopware code review changes.

3.3.1 - 2021-08-23

BREAKING CHANGES

Changed

• Updated order service to set shipment custom reference when creating a draft.
• Added additional statuses to shipment status mapper.
• Updated codebase to adhere to the Shopware coding standards. Integrations need to update all classes that extend from the Core Singleton class and implement create method that will return an instance of itself.

3.3.0 - 2021-07-06

BREAKING CHANGES Multi-currency support project changes:

Added

• Added currency details on the shipping method and shipping method response.
• Added a default scope which includes a default fixed price used when misconfiguration is detected.
• Added a system info DTO, service and controller, used for fetching currency configuration for each system in a multi-store environment.
• Added misconfiguration detection and handling to the UI.
• Added a single store price policy JS controller that is responsible for handling price policy configurations for a single store. Integrations should include this script in the main template.

Changed

• Changed shipping services grouping to include the currency.
• Updated pricing policy to be system-specific by adding a system identifier to it.
• Updated shipping cost calculator to allow submitting system ID during shipping cost calculation and take only the policies with that system ID into account when calculating shipping costs.
• State controller configuration has been modified. The integrations will have to modify the index template to include the system ID and the URL to the system info controller.

3.2.2 - 2021-07-01

Changed

• Fixed default platform country for a registration form

3.2.1 - 2021-05-13

Changed

• Fixed registration form

3.2.0 - 2021-04-29

BREAKING CHANGES Whitelabel project changes:

Added

• Added new js component for shipment service settings button. This is added, so we can use settings button in other components. Now you need to reference SettingsButtonService in MyShippingServicesController.js. Now you need to call function displaySettings from SettingsButtonServicein MyShippingServicesController.js function display.
• Added BrandConfigurationService. Integration should register PacklinkConfigurationService instance for Packlink brand or adequate implementation for other brand(s) during the bootstraping.
• Added PacklinkConfigurationService.
• Added FileResolverService. Integration should initialize FileResolverService with an array of folders where source files should be searched for.
• Added new method getLabels to \Packlink\BusinessLogic\CountryLabels\CountryService.

Changed

• Changed logic for setting settings button in shipping service js.
• \Packlink\BusinessLogic\Language\TranslationService renamed to CountryService.
• TranslationService::translate renamed to CountryService::getText.
• Files from Resources/lang moved to Resources/countries. In integration, change path to translations to fit new folder names in core.
• Configuration::getCurrentLanguage and Configuration::setCurrentLanguage changed to Configuration::getUICountryCode and Configuration::setUICountryCode.

Following changes will work properly once BrandConfigurationService is registered in Bootstrap:

• Removed hardcoded source value from ShippingServiceSearch.
• Removed hardcoded platform code from Proxy, Draft and RegistrationRequest.
• Removed platform country code from RegisterModalController.js.
• Added platform_country to RegistrationController:getRegisterData response.
• RegisterController.js function populateInitialValues() populates platform_country.
• Registration link and platform country removed from CountryService::$supportedCountries.
• Removed Packlink\BusinessLogic\Country\RegistrationCountry.
• Added validation for platform country in RegistrationRequest::doValidate and UserAccountService::initializeUser.
• Removed $supportedCountries from CountryService and WarehouseCountryService.
• Packlink\BusinessLogic\Language\TranslationService renamed to CountryService and moved to CountryLabels directory.

3.1.1 - 2021-03-26

Added

• Added additional ISO codes to the postal code transformer.
• Added missing carrier logos for Italy and Spain.

Changed

• Changed setting the language based on user's platform country instead of current shop language during the registration process.

3.1.0 - 2020-12-11

Added

• Added postal code transformer service that transforms postal code into supported postal code format for some countries.
• Added missing carrier logo for DPD Portugal.

Changed

• Changed how the default parcel is validated.
• Changed logic in the shipping cost calculator to use postal code transformer for the delivery postal code before retrieving services from the Packlink API.
• Separated country service into two services which deal with registration and warehouse countries separately. Separated country DTO into two DTOs, with base country DTO and registration country DTO, which adds additional information (registration link and platform country).
• Modified user account service, update shipping services task, and warehouse controller to work with warehouse country service instead of country service.

3.0.6 - 2020-11-05

Added

• Added missing carrier logos. Integrations should refresh their shipping services after updating to this Core version in order to assign these logos to their respective shipping services.
• Fixed setting warehouse postal code and city from the module

3.0.5 - 2020-10-21

Changed

• Fix issue with execution starting logic of multiple non-recurring schedules

3.0.4 - 2020-10-09

Changed

• Fix issue with phone validation.
• Send setup event when first service is activated.

3.0.3 - 2020-09-23

Changed

• Ajax service request headers enhancements

3.0.2 - 2020-09-10

Changed

• Fix get service url.
• Fix issue with adding backup service.
• Fix deserialization of Shipping Method Configuration.

3.0.1 - 2020-08-31

Changed

• Fix origin and destination icon size on services page.
• Fix icons on the settings page.
• Fix issue with adding a query parameter to url in register controller.
• Fix translation issue in italian.

3.0.0 - 2020-08-25

Changed

• Module redesign with new pricing policy.

2.2.2 - 2020-08-28

Changed

• Fix bug in weekly schedule for schedules setup to run on Sundays

2.2.1 - 2020-07-28

Changed

• Prevent schedule check task from being enqueued if not necessary

2.2.0 - 2020-07-22

Changed

• UpdateShipmentData task has been declared as deprecated.
• UpdateShipmentData task will not be scheduled anymore in core.
• BREAKING: Methods isFirstShipmentDraftCreated and setFirstShipmentDraftCreated have been removed from Configuration Integration should check if said methods have been utilized and remove them.

2.1.3 - 2020-06-25

Added

• Added additional data (seller user ID and order ID) when creating order shipment draft.

2.1.2 - 2020-06-25

Added

• Added Hungary to the list of supported countries.

2.1.1

Changed

• Added initial page property to JS state controller.

2.1.0

** BREAKING CHANGES **

Added

• Added a socket http client for async requests
• Added task execution priority
• Added async batch starter
• Added task runner keep alive mechanism
• Added batch task cleanup task

Changed

• Changed when the schedules are created
• BaseDto is deprecated

2.0.12 - 2020-05-25

Changed

• Fixed unit tests

2.0.11 - 2020-05-25

Changed

• Fixed unit tests

2.0.10 - 2020-05-20

Added

• Added configuration flag for async request progress callback usage (methods Configuration::isAsyncRequestWithProgress and Configuration::setAsyncRequestWithProgress)

Changed

• Changed default timeout for async requests that utilize progress callback to be the same as for standard sync request. In this case progress callback is controlling request abort based on uploaded data so short timeout is undesirable.

2.0.9 - 2020-05-15

Added

• Added registration request processing

Changed

• Changed CurlHttpClient::executeCurlRequest to return response headers as last item array

Removed

• Method CurlHttpClient::executeRequest is removed
• Method CurlHttpClient::getHeadersFromCurlResponse is removed
• Method CurlHttpClient::getBodyFromCurlResponse is removed
• Method CurlHttpClient::strip100Header is removed

2.0.8 - 2020-05-12

Changed

• Scheduler will not enqueue tasks that are already scheduled for execution or currently executing

2.0.7 - 2020-05-08

Changed

• Fix validation of phone number for warehouse
• Add HTTP request parameters to config service
• Add more setters to the config service

2.0.6 - 2020-04-27

Changed

• Add optional context parameter when checking shipping service task status

2.0.5 - 2020-04-24

Changed

• SendDraftTask will be aborted if order has no order items.

2.0.4 - 2020-04-14

Added

• Fixed setting context when enqueueing update services after the warehouse has changed.
• Fix some unit tests.

2.0.3 - 2020-04-07

Added

• CountryService now has a method for detecting if a given county is one of the four base countries.
• OrderShipmentDetails model is extended to have the shipment URL. It is set automatically when reference is set.

2.0.2 - 2020-04-03

Changed

• Fix registration link for Austria.

2.0.1 - 2020-03-26

Changed

• Fixed location picker input label
• Order shipment data will now be immediately updated after the draft has been created. This is added to immediately set the correct status and Packlink price.
• Changed registration links for all countries.

2.0.0 - 2020-03-05

BREAKING CHANGES This release contains several breaking changes. Check in detail when updating to this version. Contains implementation of the "Core Enhancements 1" set of features. Check the documentation for more info.

Added

• Added a TaskClenupTask for removing unnecessary queue items (tasks) from the database.
• OrderShipmentDetailsService is added. This service is in charge of working with the OrderShipmentDetails entity.
• OrderShipmentDetailsRepository is added for getting and storing the OrderShipmentDetails entity.
• SendDraftTask and UpdateShipmentDataTask tasks were updated to reflect the above changes. Most notably, they now call either OrderShipmentDetailsService or ShopOrderService separately where needed.
• Added task abortion functionality. If needed, a task should throw AbortTaskExecutionException to abort it. Aborted tasks will not be restarted by the queue service.
• FrontDTO and associated factory FrontDtoFactory is added. Now, any frontend DTO should be instantiated only through the factory method. If input data is not correct, a FrontDtoValidationException will be thrown containing ValidationError array.
• ShopShippingMethodService interface has a new method getCarrierLogoFilePath.
• WarehouseService is introduced to manipulate the data for default warehouse. This service should be used to fetch and save warehouse data instead of direct call to the ConfigurationService.

Changed

• OrderRepository interface is changed. It is renamed to ShopOrderService and now the only responsibility of this service is to work with an order in the shop/integration. Most of the methods are removed.
• OrderShipmentDetails entity does not contain a reference to a task anymore.
• DraftController is renamed to ShipmentDraftService and handles both immediate and delayed SendDraftTask enqueueing. It provides a method for getting current status of the SendDraftTask for specific order.
• DashboardStatus is now a frontend DTO and a signature for the generated array is changed.
• Warehouse DTO changed namespace.
• ShippingMethodsController now adds logo URL to the ShippingMethod, so integrations do not need to set it.

v1.5.2 - 2019-12-04

Changed

• Replaced substr with mb_substring to prevent cutting the string in the middle of the special unicode character.

v1.5.1 - 2019-11-28

Changed

• AjaxService.js:call method now removes the protocol from the URL in order to use the current page's protocol.

v1.5.0 - 2019-11-18

Added

• isRegistered method in RepositoryRegistry.
• isShipmentLabelsAvailable method in OrderService

Removed

• OrderService::updateShipmentLabel method.
• OrderRepository::isLabelSet method.
• OrderRepository::setLabelsByReference method.

Changed

NON-BREAKING CHANGES

• SendDraftTask is now idempotent.
• ShippingMethodConfiguration DTO and ShippingMethod model are modified to enable setting list of allowed destination countries for a shipping method.
• UpdateShipmentDataTask checks for update with different frequencies for orders with different statuses. NOTICE For existing users delete old scheduled UpdateShipmentDataTasks and schedule new ones in the same manner as they are scheduled in core.
• AbstractGenericStudentRepositoryTest extended to cover every ORM operator.

BREAKING CHANGES

• The lowest boundary in fixed price can be higher than zero. NOTICE Each integration for from input field must remove "disabled" directive in template file as disabling from input field is now handled by js library.
• Advanced serialization mechanism has been implemented.NativeSerializer and JsonSerializer have been introduced. This is a breaking change and each integration should register preferred serializer in bootstrap.
• OrderRepository introduced new method getOrderReferencesWithStatus. This method must be implemented in each integration.
• Removed OrderRepository::setLabelsByReference method.

v1.4.1 - 2019-10-14

Added

• DraftController is added to decrease the code in integrations related to creation of the draft
• ConfigurationService is extended with a flag whether to run async process with POST or GET call, defaults to POST. Integration can just override this constant and the task runner service will use that. Also, if integration has a validation in async process controller whether the call is a POST call, it should be removed if this flag is changed.

Changed

• Fixed double spinner problem in shipping services page.
• Fixed tax selector bug - using the already selected value.
• Fixed some tests.

v1.4.0 - 2019-08-28

Added

• Tests for AbstracGenericStudentRepository and AbastractGenericQueueItemRepository have been improved to support multiple conditions in filters for select.
• Auto-Test and Auto-Configuration features (CR-12)
• UpdateShippingServicesTaskStatusController for checking the current status of the UpdateShippingServicesTask.
• TranslationMessages.js is added to give an example of what should be provided by integrations. This does not need to be included on any page.

Changed

This version contains several BREAKING CHANGES, so please review the log.

JS changes:

• AjaxService.js is now easily extendable so integrations can adjust the calls.
• FooterController.js now listens to the Escape key to close the debug popup.
• ShippingMethodsController.js is adjusted to support auto-configuration feature if the integration supports it. Also, behavior for getting shipping services is changed. Now, controller expects a status check URL (given as the shippingMethodsGetStatusUrl parameter of the State controller constructor config object) and it first checks the status of the task for getting shipping services task. For this, new UpdateShippingServicesTaskStatusController can be used in integrations. If task completed, shipping services will be retrieved.
• UtilityService.js is extended with new method pad.

Other changes:

• ShopShippingMethodService has been extended with methods for adding and deleting backup carrier. They have to be implemented in the integration.
• Proxy::sendDraft() method will now throw an exception if the draft response does not contain the reference.
• Infrastructure/Configuration/Configuration class is extended to support the auto-configuration feature.
• HttpClient is adjusted for the auto-configuration. Check the diff to see the method signature changes.
• CurlHttpClient is changed to support easier extendability. It is adjusted to the changes in HttpClient. It now supports:
  • a timeout on synchronous requests (60 seconds by default)
  • auto-redirect feature if the FOLLOW_LOCATION cannot be set
  • adjustments of the cURL parameters based on the custom HTTP options set in the configuration
  • some functions are renamed and signature changed - review the diff
  • it supports a single extension point in the method executeCurlRequest. This is called for both sync and async calls.
• Logger\LogData is converted to entity. This does not break current integrations.

v1.3.1 - 2019-07-16

Changed

• Fixed sending draft full address.

v1.3.0 - 2019-07-10

Changed

• Updated task for updating shipment data to report the progress and handle base errors.

Removed

BREAKING CHANGES

• Removed Zend framework PDF library since it creates a lot of dependencies and might conflict with other systems. Because of this, utility PdfMerge is removed! To use PDF merging for shipping labels, do composer require iio/libmergepdf:3.0.0. Then, in your code add the following:

  $merger = new \iio\libmergepdf\Merger();
  $merger->addIterator($paths);
  $file = $merger->merge();
  

  where $paths is the array of local paths of the files. $file will be a string representation of the resulting PDF file.
• Removed symfony php 5.4 and 5.5 utilities since they are not needed. Added only custom implementation of array_column in class Packlink\BusinessLogic\Utility\Php\Php55.
• Removed Proxy::callAsync method as it is not used nor needed.

v1.2.2 - 2019-06-20

Added

• Added support for some PHP functions (e.g. array_column) that are not natively supported by PHP versions prior to 5.5 by requiring Symfony packages that add this support.

v1.2.1 - 2019-06-18

Changed

• Analytics endpoint now adds module version as well
• JS StateController now supports additional configuration options in the configuration parameter:
  • configuration.sidebarButtons: can contain an array of keys for additional sidebar buttons
  • configuration.submenuItems: can contain specific settings submenu items (keys)
  • configuration.pageConfiguration: contains specific configuration for additional pages added in configuration.sidebarButtons. See StateController.js for the details of the implementation.

v1.2.0 - 2019-05-31

BREAKING CHANGES:

Added

• Business logic ConfigurationService has new abstract methods getModuleVersion(), getECommerceName, and getECommerceVersion.
• Custom HTTP headers are added to the Proxy. This required the above configuration service methods. (CR 14-01)
• Support for sending analytics based on certain events in the shop (CR Set 14-02). Modules have to call methods from AnalyticsController::sendOtherServicesDisabledEvent if a user chooses to disable other shipping methods upon activating the first Packlink service.
• OrderShipmentDetails entity is added to the core. It holds the information about Packlink shipment for a specific shop order.

Changed

• Schedule now had additional property for marking it recurrent (true by default). This enables creating one-time schedules.
• Schedule now has a context so that its tasks can hold the context data
• Proxy::__contruct has changed parameters since configuration service is now needed.
• Tests updated to follow new implementations.

v1.1.0 - 2019-05-29

BREAKING CHANGES:

Added

• OrderRepository interface has a new method isLabelSet($shipmentReference).

Changed

• Method signature changed for OrderRepository::updateTrackingInfo.
• Method signature changed for OrderService::updateShipmentLabel.
• Method signature changed for OrderService::updateShippingStatus.
• Method signature changed for OrderService::updateTrackingInfo.
• Shipment labels are now fetched from Packlink only when order does not have labels set and shipment status is in one of:
  • READY_TO_PRINT
  • READY_FOR_COLLECTION
  • IN_TRANSIT
  • DELIVERED

v1.0.0 - 2019-05-24

• First stable release