5.0.0

This breaking release brings the new Enso file system and upgrades all packages to Laravel 9.

The old filesystem was pretty basic and has been upgraded to something more robust by replacing the usage of polymorphic relationships with regular foreign keys (models that were using the HasFile trait now have a file relationship through a file_id column) with more features (such as favorite files) as well leaving room for future functionality.

We've taken advantage of the breaking version state, included other small changes from our backlog and made a slight change to the mechanism for locally extending package forms and tables.

Due to these changes, most packages have had a refactor and dependency list upgrade.

Front-end

clipboard

• updated clipboard size

confirmation

• removed unneded v-bind from dropdown

directives

• improved clickOutside.js

documents

• removed Document.vue component, now we use File.vue instead

files

• major refactor in order to work with the new file system back-end changes
• several fixes & enhancements
• added edit ability for file name

how-to

• fixed uploader

mixins

• improved ensoFile.js, now it's constructor receives a File resource instead of a filename

notifications

• fixed transition group

tables

• cascades reset method
• implemented number formatting for nested columns

themes

• fixed confirmation; removes duplicated & deprecated classes

ui

• added avatarKey in store
• made content relative in default layout
• improved websockets

uploader

• cascades slot in enso-uploader
• small refactor

users

• fixed uploader
• fixed v-click-outside related bug on profile control
• improved Avatar.vue
• added Url component

back-end

All packages have been updated with regards to:

• aligning Form builder, Table builder & Form request validation classes naming conventions, by dropping superfluous prefixes.

• when extending forms, rather than overriding the protected constant TemplatePath (which has now become private), we've added a protected method templatePath() that is used in the forms' constructor. When extending any form builders, you should override this method if you want to use another form template.

• when extending tables, note that the protected constant TemplatePath has now become private, and we've updated the public method templatePath(). When extending any table builders, you should override this method if you want to use another table template.

• due to the major files refactor, all packages that use files have been updated. FileServiceProvider file has been deleted and also removed form composer files.

• the new file system impact has also led to the need of changing the initial order of migrations. For this change it already exists an upgrade, but you should take a note that a lot of package migrations have been renamed.

• all migrations have been upgraded in order to return an anonymous class by the new Laravel 9 style. This way we can avoid class name collision.

• an important note is that the old DataImport and DataExport models have been renamed to Import and Export, respectively.

action-logger

• updated migration style

addresses

• fixed seeders path
• updated migration classes

api

• no longer sends empty request body
• fixed api calls
• added query parameters interface

avatars

• refactor for the new file system
• updated migrations

calendar

• updated migrations

cli

• fixed synthax error in Exceptions/WriterProvider.php
• fixed template path generation for forms and tables

comments

• updated migrations

companies

• fixed seeders path
• updated migrations

control-panel-api

• fixed seeders path
• updated migrations

core

• fixed seeders path
• updated Preference rememberable keys
• fixed password validation when resetting password and email is missing

countries

• updated eea for United Kingdom
• fixed seeders path
• updated migrations

data-export

• refactor for the new file system
• updated migrations
• renamed DataExport model to Export

data-import

• switched order for authenticate / authorize
• refactor for the new file system
• updated migrations
• renamed DataImport model to Import
• the excel seeder has been updated, please see upgrade steps regarding this change

documents

• refactor for the new file system
• updated migrations

files

The file system has been significantly improved and has received a lot of new features, such as:

• switched polymorphic relations to one to one
• updated migrations
• a much more user friendly interface
• added edit ability for file name
• temporary link generation for 5 minutes, 1 hour or 24 hours
• improved inline preview
• allows the transformation of private files into public files and vice versa

filters

• fixed "doesntContain" search mode

google

• updated migrations

helpers

• small refactor

how-to

• refactor for the new file system
• updated migrations

impersonate

• updated migration;

localisation

• added the Full Name key and RO translation
• fixed seeders path
• updated migrations
• the localisation files have been moved from resources/lang directory to lang directory

menus

• updated migrations

notifications

• updated migrations
• updated pusher dependency

pdf

• updated laravel snappy
• added output() to Pdf
• added return types

people

• updated migrations

permissions

• updated migrations

roles

• updated migrations

tables

• added the possibility to conditionally return a table builder using the tableClass($request) method in addition to the $tableClass property, used in the table related controllers (init, data, excel)
• fixed resource collection computor
• refactor for the new file system
• implemented number and date formating for nested columns from loaded relationships

tasks

• updated migrations

tutorials

• updated migrations

user-groups

• fixed seeders path

users

• fixed seeders path
• changed user defaultPreferences visibility to protected
• updated migrations
• updated user preferences to use cache

Private Packages

webshop-commercial

• updated migration
• refactor for the new file system

webshop

• rebuilt assets
• updated registration form label for name to Full Name
• added default for sorting in order to address bot caching of deprecated URLs
• fixed seeders path
• updated migrations
• removed services as dependency
• refactor for the new file system

emag

• added missing branch from the UpdateStock listener; small job rename
• offer now uses dynamic methods
• added conditional trim
• added new Offer::valid scope
• added logic to delete awbs after download
• fixed Job location;
• updated migrations

hr

• fixed seeders path
• updated migrations

projects

• fixed seeders path
• updated migrations

contracts

• updated migrations

commercial

• updated the UpdateStockValues due to supllier pivot refactor
• shipping address is optional on store orders
• added fix for missing address
• made supplier query more specific
• added requests
• fixed issue due to product_supplier pivot id
• updated migrations
• refactor for the new file system

financials

• updated migrations
• refactor for the new file system

inventory

• bundlePacking cleanup
• added withAvailable scope on Product
• updated migrations

discounts

• updated migrations

wiki

• updated migrations
• refactor for the new file system

frisbo

• fixed seeders path
• updated migrations

stripe

• updated migration

eav

• adds publish method AppServiceProvider
• simplified eav validation
• removed unused model
• added default for validator, when eav params payload is missing
• updated migrations

sale-channels

• updated migrations

product-eav

• fixed eav syncing
• simplified logic; removed attribute id from values pivot
• added missing model
• fixed table PK
• added default for eav sync / Update
• fixed the getEav dynamic; transformed the $product->attributes() dynamic relationship into a method
• updated migration
• fixes import

Upgrade steps

First and foremost, be sure the to read the official Laravel 9 upgrade guide to understand all implications.

• before starting to upgrade your project, please read with attention the following step:

Due to the major files package refactor, all the Enso package classes using files will be updated accordingly.

• publish the updated files config with php artisan vendor:publish --tag=files-config --force

• add your local models using files under the upgrade key. The syntax is: old attachable_type name => Model::class.

• if having several models stored under the same folder, then that folder name should be added under the nonStandardFolders key, so that the files could be migrated according to the new convention. The new convention is that the folder will be named as the model, written camelCase.

• if you also want to rename your folder, you'll need to specify the name change under renameFolders key, as 'old name' => 'new name'.

• for all models using files, update your migrations by adding file_id foreign key.

$table->unsignedBigInteger('file_id')->nullable();
$table->foreign('file_id')->references('id')->on('files')
    ->onUpdate('restrict')->onDelete('restrict');

• if using the ensoFile.js mixin locally, when instantiating the class, you should pass a file resource object instead of a filename string

• if you're sending email notifications with mailgun and inline attaching pdf files created with the LaravelEnso\Pdf\Services\Pdf service, you need to use ->output() method:

  ...
  ->attachData($invoice->output(), $this->filename());
  ...
  

• if locally customizing Enso package form builders and providing another template file, while not customizing the constructor, you should

  • change the protected const TemplatePath = ... visibility to private
  • override the parent's templatePath() method:

  protected function templatePath(): string
  {
      return self::TemplatePath;
  }
  

• if locally customizing Enso package table builders and providing another template file, you should

  • change the protected const TemplatePath = ... visibility to private
  • override the parent's templatePath() method:

public function templatePath(): string
    {
        return self::TemplatePath;
    }

• if locally extending any table builder classes, check your imports as names may have changed. Make sure to also check within your app service providers

• if locally extending any request validation classes, check your imports as names may have changed. Make sure to check within your app service providers

• note that the DataImport and DataExport models have been renamed to Import and Export. You should updated your imports accordingly.

• upgrade all package dependencies to their latest version

• if using mailgun, make sure to require symfony/mailgun-mailer and symfony/http-client by using composer require symfony/mailgun-mailer symfony/http-client

• update your config files, .gitignore, Middleware classes, Providers, Exceptions/Handler.php and Http/Kernel.php by following this merge request as an example https://github.com/laravel-enso/enso/pull/417/files

• refactor your local excel seeders by implementing the following methods

    protected function type(): string // If the $type property is overwritten
    {
        return $this->type;
    }

    protected function filename(): string
    {
        return $this->filename;
    }

• if you need to customize the select options sort method, you can do so by publishing the select config using php artisan vendor:publish --tag=select-config --force and updating the sortByOptions key as needed.

• update your DatabaseSeeder by adding LaravelEnso\Files\Database\Seeders\TypeSeeder before UserSeeder

• if using phpinsights, note that there was a bug https://github.com/nunomaduro/phpinsights/issues/565. The bug was fixed, but not tagged, so you need to update your dependency to "nunomaduro/phpinsights": "dev-master",

• note that all all migrations have been upgraded in order to return an anonymous class by the new Laravel 9 style.

• update the Enso version to 5.0.0 in config/enso/config.php

• run composer update in the project's root

• run yarn, yarn upgrade && yarn in /client to ensure you have the latest versions and patches are applied. If necessary, update your patches

• php artisan enso:upgrade --before-migration

• php artisan migrate

• php artisan enso:upgrade

• php artisan enso:upgrade --manual

• make sure permissions are properly configured for each role and then save/refresh the roles configuration files

• as per every release, delete any local, deprecated upgrades

4.9.1

This minor release aims to update front-end packages to use the latest bulma syntax. It also includes many improvements and bug fixes.

Front-end

auth

• fixed password confirmation bug

data-import

• added support for template params options in addition to source

directives

• simplified, improved performance & code readability of v-click-outside

io

• updated navbar-item use

notifications

• updated navbar-item use

roles

• improved configure.vue info

tables

• fixed bug affecting preferences saving caused by the vue3 ugrade

tasks

• updated navbar-item use

themes

• several deprecated helper classes such as has-margin-small, has-padding-small and their derivates have been removed
• [v-cloak] & *:focus styling is included within the package
• since v-tooltip is globally available, its css is loaded within the themes package

ui

• fixed dynamic navbar component registration rendering
• improved navbar-item; added show, hide and touch events

users

• fixed navbar avatar on safari

back-end

core

8ee62af updated meta: removed csrf token

countries

b4bc27f updates eea for United Kingdom

data-import

• added template params options support

permissions

• added short name in permission resource

users

• fixed user preferences reset
• changed the User storePreferences method visibility to public

Private packages

webshop

• removed deprecated css classes
• updated searchable array to use the visibleOnWebshop dynamic

emag

• added check for response error

commercial

• added validation on external fulfilment
• fixed typo

wiki

• removed deprecated css classes

Upgrade steps

• if you're still using the deprecated css which have now been removed, you should update:

  • has-vertically-centered-content to is-flex is-align-items-center

  • has-margin-auto to ma

  • has-margin-xxx, has-padding-xxx and their derivates (top, left, etc) to their corresponding bulma counterparts (m-1, m-2, ml-1, etc). See docs.

    For example:

    • has-margin-large -> m-3
    • has-margin-top-large -> mt-3
    • has-margin-right-small -> mr-1
    • has-margin-bottom-medium -> mb-2
    • has-margin-top-small -> mt-1
    • has-padding-left-large -> pl-3
    • has-padding-large -> p-3
    • has-padding-medium -> p-2
    • has-margin-top-medium -> mt-2

• remove [v-cloak], *:focus & @import 'v-tooltip/dist/v-tooltip'; from client/src/sass/enso.scss

• update the Enso version to 4.9.1 in config/enso/config.php

• run composer update in the project's root

• run yarn, yarn upgrade && yarn in /client to ensure you have the latest versions and patches are applied. If necessary, update your patches

• php artisan enso:upgrade --before-migration

• php artisan migrate

• php artisan enso:upgrade

• as per every release, delete any local, deprecated upgrades

4.9.0

This release upgrades the UI to Vue 3 and also includes under the hood refactor for a few core components. We've tried to maintain overall component compatibility and done our best to document the breaking changes.

Depending on how complex the UI for your project is, the upgrade may take anywhere from a 1.5h to many days, so please take your time to go through the Enso changelog, especially the upgrade steps AND also the Vue3 upgrade guide linked below.

Front-end

All packages have had their dependencies and dev dependencies updated and pruned. Many packages have had linter recommended fixes.

filters

• the DateIntervalFilter & EnsoDateIntervalFilter components have been retired

laravel-validation

• added an all() method, that returns all errors

pull-to-refresh (new)

This a new Enso package, forked from lakb248/vue-pull-refresh and updated to work with Vue3.

select

• fixed element deselection when the select was used in 'object' mode

Private packages

inventory

• aligned products index page style & updated table filters/state

commercial

• updated the invoice issuing routes
• improved items display

emag

• fixed auto pricing controls
• fixed auto pricing conditions
• updated emag dependent filters to auto clear when deactivating emag
• fixed can-access usage; improved Emag.vue
• added new product filters for emag offers; added new visual indicator for "genius"

products

• small fix for products index styling

webshop

• form cleanup

Back-end

categories

• fixed ordering bug

core

• updated state Meta: removed csrf token

localisation

• removed the expanded sidebar key (cleanup)

tables

• fixed excel export on all scenarios
• fixed authenticates on export
• fixed style
• updated to allow sortable for nested columns (should be used carefully);
• extracted Computor from Data
• improved excel export -> fetcher needs to be redesigned
• improved excel preparing

tutorials

• updated form to use the new permissions.options route

Private packages

commercial

• updated addresses logic for the sale form
• fixed status filter
• improved stock values computation
• removed created/updated_by fields from being exportable
• bugfix: only perform invoice cancellation if invoice exits
• implemented the possibility to enable per sale channel opt-in/out for sale notifications
• fixed acquisition price in stock values Computor
• removes unneeded relation loads; fixed style

commercial

• removed the back button for the modal form

eav

• fixed group & attribute reordering bug
• small Attribute factory fix

emag

• fixed missing return
• refined stock management
• improved code to keep the local offer in sync with the emag remote offer on each upload
• improve order flow for edge cases when API is down

frisbo

• added order update webhook endpoint, append product lot to product name and order notes
• small refactor
• added logging for api callbacks
• expiration date flow enhancements

Vue Migration Build

In order to migrate a project, we will use the Vue3 Migration Build as an intermediary step, upgrade the code to make it Vue3 compatible, then finally switch to the regular Vue3 build.

Please read the official documentation linked above, so you have a better understanding of the process.

In order to use the migration build, it needs to be imported and configured:

• in client\package.json: "@vue/compat": "^3.2.20",
• in vue.config.js, within the chainWebpack config:

      config.resolve.alias.set('vue', '@vue/compat');
      config.module
          .rule('vue')
          .use('vue-loader')
          .tap(options => ({
              ...options,
              compilerOptions: {
                  compatConfig: {
                      MODE: 2,
                      COMPILER_V_BIND_OBJECT_ORDER: false,
                      COMPILER_IS_ON_ELEMENT: false,
                  },
              },
          }));
  

• in client\src\js\enso.js:

  Vue.configureCompat({
      RENDER_FUNCTION: false,
      INSTANCE_LISTENERS: false,
      COMPONENT_V_MODEL: false,
      ATTR_FALSE_VALUE: false,
      INSTANCE_ATTRS_CLASS_STYLE: false,
      TRANSITION_GROUP_ROOT: false,
  });
  

The package & snippets are already present in the Enso release, but they will be commented out, so in order to enable the migration build, open the relevant files and uncomment the blocks above.

Note that the compiler migration build flags belong to the vue.config.js file and require the restart of HMR (if using it) while all other flags belong to the client\src\js\enso.js file.

Vue Dev Tools

For Vue3, a new browser devtools plugin is needed and can be installed along side the Vue2 plugin.

Upgrade Steps

In addition to upgrading the Enso UI to make it Vue3 compatible, we've also made some other changes to a few Enso components some of which may impact your local code.

• update the following files with the latest versions

  • .babel.config.js
  • .eslintrc.js
  • vue.config.js
  • client\src\js\enso.js
  • client\package.json
  • client\src\sass\enso.scss

• enable the migration mode, as noted above

• run yarn && yarn upgrade and start HMR

• you should be able to login into the application and will probably have some (lots of) errors and warnings

• the deprecated legacyBuild flow for building the application state has been removed entirely store.js

• we have aimed to remove global components and instead import them for each use case

  • the fa component is no longer global and needs to be imported locally, where used

    import { FontAwesomeIcon as Fa } from '@fortawesome/vue-fontawesome';
    ...
    components: { ..., Fa, ... },
    

  • the global http axios alias is no longer available, instead it should be injected as required: Update:

    myMethod() {
        axios.post(...);
    }
    

    to

    inject: ['http']
    ...
    myMethod() {
        this.http.post(...);
    }
    

• if using any @hook:... hooks, replace all usages with @vnode-... docs

• in all of your renderless components you can set the inheritAttrs: false, attribute to eliminate warnings about inherited attributes

• $listeners has been removed / merged into $attrs. See docs

  You need to remove v-on="$listeners" usages. Note that in such cases, you will probably need to cascade events, either directly or via v-bind="$attrs" if applicable.

• $scopedSlots property is removed and all slots are exposed via $slots as functions. See docs.

  You should replace this.$scopedSlots.xxx with this.$slots.xxx in your render functions

• update the slot syntax, by replacing v-slot:xxx with #xxx

• if you are still using the deprecated named / scoped slot syntax, update it to the latest syntax first (which is already supported in 2.6) For example, replace

  <template slot-scope="{ count }">
  

  to

  <template #default="{ count }">
  

• the beforeDestroy hook has been renamed to beforeUnmount - you should replace all usages project wide. See docs

• when using $el within components, ensure that there is a single root within the element (e.g. <div>)

• when emitting events in components (e.g. $emit('click')), it is recommended to declare/list the emitted events:

  emits: ['click'],
  

• for components, the value property has become modelValue and the input event has been replaced with update:modelValue. See docs

  When listening on 'value' changes on components, you need to replace @input="xxx" with @update:model-value="xxx". In Vue3 you can also have multiple v-model bindings on the same component. See docs

• in all of your renderless components you can set the inheritAttrs: false, attribute to eliminate warnings about inherited attributes

• note that in Vue3 you can no longer programmatically destroy components as the $destroy() method has been removed. See docs

• HTML bound attributes such as :disabled will be rendered as disabled="false" for false values, and if you need to not have them rendered, the bound attribute value needs to be evaluated to null or undefinded. See docs

• if using watch on arrays, you need to add deep: true otherwise the callback may not be triggered. See docs

• you no longer need to use $set & $delete to manage object attributes in order to keep responsiveness, you can use regular JS syntax. See docs.

• if asynchronously loading components, the syntax has changed. See docs.

• transitions have suffered a few changes. See docs

• the render function API has changed. See docs

• if using DateFilter or EnsoDateFilter please note:

  • the default property has been removed
  • the disabledOptions property has been renamed to excluded
  • the default property has been removed
  • value/v-model has become filter
  • using v-model for filter & interval is now required

  For example, replace

  • v-model="params.dateInterval" with v-model:filter="params.dateInterval"
  • :interval="intervals.products.date" with v-model:interval="intervals.products.date"

  where the attributes look like this

  params: {
      dateInterval: 'thisMonth',
  },
  intervals: {
      products: {
          date: {
              max: null,
              min: null,
          },
      },
  },
  

• if emitting/listening to global events, you should import and refactor to using the eventBus instead. See docs.

  import eventBus from '@enso-ui/ui/scrc/core/services/eventBus';
  ...
  eventBus.$emit('my-event');
  eventBus.$on('my-event', this.myHandler);
  

• the <modal> component no longer needs a portal attribute/property, and you should delete all its usages

• the AutosizeTextarea component has been updated and no longer needs to wrap around a textarea. Update:

  <autosize-textarea>
      <textarea v-model="..."/>
  </autosize-textarea>
  

  to

  <autosize-textarea v-model="...">
  

• filters are no longer supported, refactor as needed (you may use methods instead). For example, update:

  {{ value | numberFormat(2) }}
  

  to

  {{ numberFormat(value, 2) }}
  

• if you're using the automatic component registration, the syntax has changed from

  Vue.component('navbar-notification', Notification);
  App.registerNavbarItem('navbar-notification', 300, 'core.notifications.count');
  

  to

  App.registerNavbarItem('navbar-notification', Notification, 300, 'core.notifications.count');
  

• the v-tooltip library has been updated: Import has been updated from

  import { VPopover } from 'v-tooltip';
  

  to

  import { Dropdown } from 'v-tooltip';
  

  Component has been updated:

  <v-popover trigger="hover"
  

  to

  <dropdown :triggers="['hover']"
  

  The slot name has been updated:

  <template v-slot:popover>
  

  to

  <template #popper>
  

• we've switched to the standard (non compatibility) syntax for the animate animations. You should prefix animate related classes with animate__. For example, update:

  <enso-form class="box animated fadeIn">
  

  to

  <enso-form class="box animate__animated animate__fadeIn">
  

  Alternatively, refactor using transition components.

• the @enso-ui/bulma package has been deprecated and will no longer be maintained. You should refactor your components and import components from their respective packages.

Moving forward from Migration Build

Once you've migrated your local pages/components and packages, you may switch from the migration build to the regular Vue3 build.

• remove the customization from vue.config.js i.e. the code related to @vue/compat

  config.resolve.alias.set('vue', '@vue/compat');
  config.module
      .rule('vue')
      .use('vue-loader')
      .tap(options => ({
          ...options,
          compilerOptions: {
              compatConfig: {
                  MODE: 2,
                  COMPILER_V_BIND_OBJECT_ORDER: false,
                  COMPILER_IS_ON_ELEMENT: false,
              },
          },
      }));
  

• remove the compatibility customization to client\src\js\enso.js

  Vue.configureCompat({
      RENDER_FUNCTION: false,
      INSTANCE_LISTENERS: false,
      COMPONENT_V_MODEL: false,
      ATTR_FALSE_VALUE: false,
      INSTANCE_ATTRS_CLASS_STYLE: false,
      TRANSITION_GROUP_ROOT: false,
  });
  

• remove the "@vue/compat": "^3.2.20", dependency from client/package.json
• run yarn, rebuild etc.

Known issues

• in development, you will have warnings about Unexpected mutation of ... prop vue/no-mutating-props which can be ignored for now
• the vuejs/vuex-router-sync has an unresolved issue that, at the time of writing, requires a patch package to fix
• the Chrome devtools plugin is at v6.0.0-beta.21 (pre-release) and may throw a lot of errors such as Timed out getting app record for app which should not affect application functionality

4.8.2

This aims to be the last minor release before upgrading to Vue 3 and includes many improvements, bug fixes and also several new features.

Front-end

addresses

• implemented google package

algolia (new)

• implemented settings package for Algolia

bulma

• added toggle filters
• added users as dependency

charts

• updated Chart.vue
• updated dependencies
• fixed chart instance usage
• brings back default options
• added shortNumber filter

data-import

• improved UX for disabled exports

emails

• updated syntax and eslint config

enums

• updated dependencies and .eslintrc.js

files

• small refactor in index
• removed redundant chart option

filters

• added toggle filters
• added dirty to filter-state
• improved dirty watcher in filter state

forms

• added the ability to reload based on a be flag
• exposed undo()

google

• fixed missing icon import

meili-search (new)

• implemented settings package for MeiliSearch

mixins

• fixed edge case with re-rendering login form after logging in

mobile-app

• added .eslintrc.js
• updated .gitignore and dependencies

range-slider (new)

• Vue Range Slider based on noUiSlider

route-mapper

• updated dependencies
• updated .eslintrc.js
• refactored the mapper class; fixed bug related to optional params; improved logic/flow

scroll-to-top

• fixed bottom margin

search-mode

• renamed algolia to searchProvider

select

• fixed multiple select value mutations when using state options

sentry

• updated dependencies and .eslintrc.js

strings

• fixed slug generation issue to handle cases when regEx matching had no actual matches

tables

• improved key in table header
• reflected filtered state
• added missing mr-1 in controls
• added danger on filter flag
• added support for dropdown actions
• added debounce for filters

themes

• added has-margin-auto
• removed bulma-checkradio
• updated bulma-extensions dependency
• imported minimized css from bulma-extensions

typesense (new)

• typesense integration for laravel-enso

ui

• added integrations.js
• improved app update notification
• updated AppUpdate.vue
• fixed app update v-if
• made app update dropdown always visible
• improved internal AppUpdate flow; fixed issue with showing the modal
• updated bulma-extensions dependency

users

• fixed user profile level margin

back-end

activity-log

• updated for php 8
• updated .styleci.yml

addresses

• deprecated google config key, uses settings from google package
• improved validation for case when postcode exists in the DB, but for a different country
• improved postcode validation
• added GBR addresses
• added Geocoding service; updated Coordinates to use the new service

algolia (new)

• implemented settings package for Algolia

api

• implemented custom headers
• added a throttle helper
• added toJson method to the api resource
• improved adding headers to the request
• added request duration logging
• updated api logger
• decreased duration column size
• removed nullable from duration
• added public apiEnabled: bool on Action
• improved exception message
• updated method visibility

avatars

• made the avatars generators configurable

categories

• added options endpoint
• removed unneeded attribute
• added categories import
• added sync queue for the categories import; if needed, template can be locally customized

charts

• refactored to chartjs 3
• fixes default tooltip config
• implemented backend shortNumbers
• fixed horizontal chart

cnp-validator

• updated CnpValidator.php
• required php 8
• updated strlen usage to mb_strlen

companies

• fixed company fiscal code in factory
• added queue sync for the companies import; if needed, template can be locally customized
• updated import, added new attributes
• added fiscal code to rememberable keys

control-panel-api

• fixed stat class

core

• added structure for integrations
• improved app update event
• added a Login trait to work with the latest changes in laravel-ui
• fixed login test for the new guard config attribute in sanctum.php

countries

• updated eea for United Kingdom

data-import

• fixed the Template's notifies method

documentation

• added route mapper docs stub & mention about transpiling

filters

• renamed algolia to searchProvider; improves searchProvider results

google (new)

• implemented settings package for Google

helpers

• updated searchable trait
• added production check
• configured styleci for php8
• updated Searchable trait due to new Algolia package
• updated price computor constructor and vatPercent use
• fixed searchable for extended / binded models
• added support for meilisearch in searchable
• removed deprecated searchable trait
• fixed Obj casts: set method now performs json encode
• fixed Cash label
• updated codesize/phpmd config rules for constant naming
• removed Sleep
• added new min max utility methods to Decimals

localisation

• updated texts, added new keys & translations
• added missing cleanup for the language update test
• added missing php dependency
• made seeder reusable in local projects

logs

• improved logs collection to handle archives
• fixed tests

meili-search (new)

• implemented settings package for MeiliSearch

phpunit-pretty-print

• updated strlen usage to Str::length

select

• opened up flexibility on Options Service instantiation from OptionsBuilder

tables

• added support for dropdown actions
• resolved resources from service container
• updated template

tasks

• fixed export error

typesense (new)

• new typesense integration for Laravel Enso

unit-conversion (new)

• new unit converter utility classes for Laravel Enso.

upgrade

• added getLength in Column
• added exists() helper for table
• updated upgrade status to address change in Symphony console table
• ignored upgrades from namespaces that are not within autoload

Private packages

webshop-commercial

• added webshop searchable array
• maked default ranking 0 in search provider data
• replaced the product dynamic method WebshopSearchableArray with a simple service
• updated flow for webshopDiscount; now we no longer fall through to general supplier discount but use webshop company if no specific cliend discount exits
• used float casts for searchable attributes
• updated webshop order implementation
• fixed class path and deprecated Online

webshop

• moved search provider product index to webshop from algolia
• hides price and discount when no stock available
• removed webshop-shadow role
• added isActive to the BaseFilters@facets array (excluded facets)
• moved searchable attributes to webshop from webshop commercial
• updated contract & account order actions
• updated BaseFilters.php
• added availability filters
• updated discount observer
• hides empty filters
• added price filter
• added priceFiltered() getter
• added services for search providers
• removed PaymentMethods enum;
• added payment config
• added default sorting to newest
• builded the new price filter
• implemented most popular sort
• various fixes, improvements and refactors

emag

• refactored add invoice -> upload invoice
• refactored product index use
• removed ValidateStoreRequest request, MissingOffer notification, deprecated parents() setter call, measurment units implementation, checker scopes & methods, recheck & cleanup flows and notSyncedYet scenarios branch
• offer download throws exception on error; categories sync service deletes any old emag categories
• updated order flow: now stopping before generating awb if not fully reserved
• emag categories now have parent id
• implemented awb schedule
• added vat id to the offer update resource and conversionable unit Enums
• updated CreateCategoryEmagCategoryPivotTable and CreateEmagOffersTable migration
• now an offer is made inactive when we do not have stock
• removed deprecated NullableCategoryId upgrade
• added emagDiscount() dynamic for services, new headers to all emag requests and check for sync / when not empty
• log now also sends email notification; added checker jobs failure handling
• made the buy button rank array key optional
• set number of offers & best offer sale price as nullable
• renamed last_checked_at to checked_at
• added check for the presence of the emag settings table for further scheduling
• refactors fetchPicture(s) to downloadPictures
• added new emag status
• added upgrade to drop offers discount_percent
• removed auto_pricing from the Offer table resource and urls from the settings form and migration
• removed download after each operation; updated offer fill, using DI resource, new genius column
• added upgrade for removal of old settings url columns
• added commands for activation/deactivation of the emag api
• various fixes and improvements

commercial

• enabled cancel
• removed sort by created_by/updated_by
• removed By columns from being searchable
• added limit for product labels
• updated products template
• refactored grn to goodsReceivedNote
• added bulkStockRemoval
• added limit and ordering for bulk stock removal;
• updated sale cancellation policy to exclude invoiced sales
• added locks
• updated limit to cover all cases
• allowed sale fulfill, on default channel & internal warehouses when missing address
• renamed externallyFullfilled
• added quick fix for sales payment form
• added awb schedule validation and internal code to typeahead controller
• added serializeDate to models and cast to settings
• reverted schema check
• made settings warehouse_id nullable to avoid seed / provider / schedule issues
• updated awb generation schedule to 06:00
• various fixes, refactors and improvements

financials

• date is now required for client payments
• fixed payment due date logic; updated tests
• fixed case when no serial is given
• refactored code
• due date fixes
• added date serialization customization for all relevant models
• updated client invoice form

inventory

• removed manual upgrade from the INsLot upgrade
• fixed reservations count for Reservations.vue update
• added inventoryIn locks as required to avoid over-reserving
• extracted to services
• added is_bundle check
• removed App make from the Inventory interface
• fixed update available emitting

discounts

• refactor for import
• added reset
• improved client product discount importer
• fixed missing param

frisbo

• converted eav grams to kg when publishing product
• updated resource to use the new unit conversion package; added validation
• updated product bundle resource to correctly use bundled quantity

eav

• added a public searchableKey method on the attribute
• improved eav filterable searchable key
• small Attribute factory fix

product-eav

• replaced the EavSearchableArray dynamic product method with a simple service class
• updated searchable array
• improved facets
• added search provider integration
• fixed import

Upgrade steps

• update the Enso version to 4.8.2 in config/enso/config.php
• run composer update in the project's root
• remove the bulma-extensions patch
• run yarn, yarn upgrade && yarn in /client to ensure you have the latest versions and patches are applied. If necessary, update your patches
• after yarn upgrade, update vue.config.js by adding @enso-ui/route-mapper package under transpileDependencies key
• php artisan enso:upgrade --before-migration
• php artisan migrate
• php artisan enso:upgrade
• as per every release, delete any local, deprecated upgrades
• update all models having forms with date fields, by adding the following method:

protected function serializeDate(DateTimeInterface $date)
    {
        return $date->format('Y-m-d H:i:s');
    }

Make sure you have set the $dates property.

4.8.1

Front-end

For most of our frontend packages we've added router error handling.

addresses

• fixed case when address does not have locality/city

charts

• updated Chart.vue

companies

• refactored slot-scope to v-scope

control-panel

• improved layout
• fixed index and stat value format

datepicker

• fixes edge case when attempting to change value during picker reset

forms

• clears errors before autosave

mixins

• added 413 error code handling

modal

• fixes modal and modal template

notifications

• fixed Notification component registration for cases where we might revoke the default notification permission

products

• fixed small bug due to being unable to create slug when name is null
• reverted check for null, and moved it to the slug method

sentry

• added ingored errors (for ChunkLoadError)
• added UnhandledRejection to ignored

strings

• added string validation
• casted args to string
• refactored strings
• updated methods to also handle null parameters, in which case they return an empty string

tables

• fixed number formatter when fullRecordInfo is false
• added ongoing request cancel in before destroy to avoid various timing errors; fixed and refactored NumberFormatter
• renamed method in number formatter

typeahead

• added force-selection

ui

• adds sentry context
• removed duplicated filters
• fixed navbar item registration
• fixed text in dark theme on error pages
• added maintenance mode page
• fixed router error handler; improved middleware

users

• fixed user profile layout

back-end

action-logger

• refactors action logger middleware
• updates .styleci.yml
• removes redundant argument

addresses

• fixed code style

avatars

• improved gravatar; renamed observer to User

companies

• added company fiscal code request validation

control-panel

• drops org url
• adds sentry org to config
• improves config, adds env vars
• fixes return types; refactors switch to matches
• updates id signature & implements id provider
• adds is_active in table builder for apps

control-panel-api

• improves middleware registration
• extracts api middleware group in the api package
• improves database sensor
• removes digits for request monitor
• improves request monitor
• extracts id provider
• improves logic; adds danger class for outdated versions
• fixed type in Services\Statistics

control-panel-common

• added missing return types in contracts
• added IdProvider abstract class

core

• .gitIgnore
• adds alias for ensure-frontent-requests-are-stateful middleware
• extras middleware registration in separate provider
• updates .styleci.yml
• style update
• removes core-api route group
• improves Logout trait to work with non spa env
• reverts logout
• New State logic - customization flexibility #393
• used App::make instead of new for providers instantiation for flexibility on customizing states.

data-export

• fixed export error notification
• added custom row action contract

forms

• fixed section visibility set automatically to visible in the builder

helpers

• added forceable index
• added cascades observers trait

localisation

• updated translations for webshop reviews
• added php version 8 for styleci cfg

roles

• improved syntax in config writer

select

• Options ordering - more sorting flexibility. #46
• created new select config option 'sortByOptions' for controling Select Options sorting.
• used new config 'sortByOptions' inside Options get method

sentry

• added prefix for recent exceptions; added dedupeInterval in publisheable config

tables

• fixed button name check (needed only for row)
• fixed tests

users

• added policy fixes
• implemented cascades observers

Privates

webshop-commercial

• updated middleware names

webshop

• added exception when attempting navigation to unavailable pages; fixes #46

• removed log

• updated cookie consent blade

• cleanup of unused routes; added local auth middleware instead of package

• customized verifiy active state for webshop

• makes product filters a partial;

• built with latest sentry version

• disabled the form button after submitting a review to avoid double clicks

• updated the Review Submitted notif to include the product name

emag

• handled setting attribute for when value is array; ref #30

• updated offer generation for bundle

• updated new offer resource for bundle products

• updated resource re:ean for packages

financials

• updated flow

• removed hard coded logic for shipping service in XML generation

wiki

• fixes login route

• adds verify active state

frisbo

• adds bundle publishing ability

api

• added logs
• adds core-api midleware group

fetcher

• updates gitlab ci and vue.config

• increased the timeout limit

Upgrade steps

To upgrade:

• run composer update
• run yarn, yarn upgrade && yarn to ensure you have the latest package versions and patches are applied. If necessary, update your patch files.
• php artisan enso:upgrade --before-migration
• php artisan migrate
• php artisan enso:upgrade to execute the upgrades
• if you need to customize the select options sort method, you can do so by publishing the select config using php artisan vendor:publish --tag=select-config --force and updating the sortByOptions key as needed.
• make sure permissions are properly configured for each role and then save/refresh the roles configuration files
• update the Enso version to 4.8.1 in config/enso/config.php

4.8.0

This new release adds the possibility for back-end packages to publish their own state to the front-end as well migrates the framework & packages to PHP 8.0. Where applicable, updated packages to take advantage of the new language features.

Front-end

Most of the packages received a dependency list cleanup.

bulma

• added enhanced progress indicator
• added ProgressIndicator component export

charts

• fixed labels update on structure change
• added display function prop

enums

• renamed the internal i18n attribute to _i18n, to avoid potention conflicts with enum keys

financials

• fixed supplier invoice index layout

localisation

• improved store module

products

• improved the product form to update slug dynamically
• improved product picture styling/layout in table & form
• added newly computed supplier discounted price to the form

progress-indicator

• implemented enhanced indicator; various progress indicator improvements

rating

• updated mobile bottom position

scroll-to-top

• updated mobile bottom position

strings

• fixed the slug helper

tables

• removed the already deprecated money support; templates should now use number - more details are found in the upgrade steps
• added customizable total label via the template's totalLabel property
• fixed page toggling

ui

• improved store module to allow for automatic package store registration
• small refactor and various fixes
• added sentry spike protection

user-groups

• removed unneeded file

Back-end

• all packages have had the route require syntax updated to reqire __DIR__./xxx.php
• all packages that were using money configuration for numeric formatting have been updated to use the already available number configuration
• all packages that were including data imports, have been updated so that importers respect the new methods' signatures
• all get_class($instance) usages refactored to $instance::class
• seeders and factories have been updated, and where it made sense, helper methods (such as test()) were added which create a different factory state (such as for testing)

action-logger

• code cleanup

activity-log

• route refactor

api (new)

• new package that provides boileplate for implementing APIs

categories

• fixed stacked bar chart

charts

• added contains nested scope

companies

• extracted user state to the users package

core

• extracted user state to the users package

currencies

• removed FixesCurrencyApi exception
• refactored to use the new api package

data-export

• added data_exports.name index upgrade

data-import

• improved error logging for local environments
• updated interfaces to pass the import model instead of params/user
• added avoids deletion conflicts and updated delete method
• added notifies boolean flag in json template and notifiableIds config option
• added params to optional attributes

files

• improved the file resource

helpers

• disabled algolia syncing when not in production
• fixed searchable
• added price computor
• added new custom cast for Object

localisation

• added & updated various keys & translations

measurement-units

• added the name attribute to the rememberable keys config array
• added MeasurementUnits enum

products

• updated price computor use
• updated product visibility in the supplier resource
• added newly computed supplier discounted price
• added generateSlug helper
• added part_number index on product_supplier pivot
• updated package_quantity type to int

roles

• added config options for restricting user groups
• improved visible scope

sentry

• extracted sentry functionality from the Core package

services

• made measurement unit not nullable in the table
• improved upgrade

upgrade

• renamed nullable Column method to isNullable
• added isSigned, isUnsigned helpers, getPrecision and getScale for decimals

users (new)

• extracted user functionality from the Core package
• removed title from profile builder
• added state provider
• improved changeGroup policy

user-groups (new)

• extracted user groups functionality from the Core package
• added config options for restricting user groups
• improved visible scope

tables

• added customizable total label
• removed the already deprecated money support; templates should now use number - more details are found in the upgrade steps

Upgrade steps

• run composer update in the project's root
• run the upgrade commands (both regular and before-migration) to ensure database & strucure is up to date, since this release cleans up a lot of package upgrades
• upgrade your machine to php8
• in composer.json update the following dependencies to the given versions:
  • "laravel-enso/core": "^7.0",
  • "sentry/sentry-laravel": "^2.0.0"
  • "laravel-enso/phpunit-pretty-print": "^1.0",
  • "nunomaduro/phpinsights": "^2.0",
• search & replace in your local project (including the database folder) the following namespaces:
  • Core\Models\UserGroup -> UserGroups\Models\UserGroup
  • Core\Enums\UserGroups -> UserGroups\Enums\UserGroups
  • Core\\Enums\\UserGroups -> UserGroups\\Enums\\UserGroups
  • Core\Models\User -> Users\Models\User
  • Core\Policies\User -> Users\Policies\User
  • Core\Models\Session -> Users\Models\Session
  • Core\Http\Controllers\Administration\Users -> Users\Http\Controllers
  • Core\Http\Controllers\Administration\UserGroups -> UserGroups\Http\Controllers
  • Core\Tables\Administration\Users -> Users\Tabels
  • Core\Forms\Administration\Users -> Users\Forms
  • Core\Http\Resources\User -> Users\Http\Resources\User
  • Core\\Http\\Resources\\User -> Users\\Http\\Resources\\User
  • Core\Http\Requests\ValidateUserRequest -> Users\Http\Requests\ValidateUserRequest
  • Core\Database\Factories\UserFactory -> Users\Database\Factories\UserFactory
  • Core\Database\Seeders\UserGroupSeeder -> UserGroups\Database\Seeders\UserGroupSeeder
  • Core\Database\Seeders\UserSeeder -> Users\Database\Seeders\UserSeeder

• remove from config/insights.php the deprecated:

use ObjectCalisthenics\Sniffs\Files\FunctionLengthSniff;
use ObjectCalisthenics\Sniffs\Metrics\MethodPerClassLimitSniff;
use ObjectCalisthenics\Sniffs\NamingConventions\ElementNameMinimalLengthSniff;

• run composer update in the project's root

• update any local person/people factories and seeders and remove the title attribute as it has been dropped
• for your local imports, for the importer & validator classes, update the following method signatures (& logic where necessary):
  • run: public function run(Obj $row, DataImport $import);
  • after: public function after(DataImport $import);
  • authorizes: public function authorizes(DataImport $import): bool;
  • before: public function before(DataImport $import);

• for your local table JSON templates, change any money keys to number, and remove any "thousand" & "decimal" attributes. Number supports precision, symbol and template (e.g. "%v %s" - %v for value, %s for symbol)
• local storage/app/.gitignore should be updated to ignore all and look like this

  *
  !.gitignore
  

  You may also remove .gitignore files from individual enso created, app sub-folders (except public)

• check the local config/enso/tables.php file and if the export.path key is present, update it to export.folder
• local state:
  • remove the local state binding from App\Providers\AppServiceProvider: CoreLocalState::class => LocalState::class,
  • remove the App\Services\LocalState class after moving any logic to one or more state builder services
  • from client/src/js/enso.js, remove the import: import './localState';
  • remove the file client/src/js/localState.js
  • if you moved logic from the old LocalState class, update the file client/src/js/store/local.js as required, otherwise you may delete it. Note that the client/src/js/store folder MUST be present.
• compare config/enso/config.php with vendor/laravel-enso/core/config/config.php and remove any extra, deprecated keys
• still in config/enso/config.php update the Enso version to 4.8.0
• compare config/enso/addresses.php with vendor/laravel-enso/addresses/config/addresses.php and remove any extra, deprecated keys
• update the password config/enso/auth.php key as follows:

  'password' => [
          'lifetime' => env('PASSWORD_LIFETIME', 0),
          'minLength' => env('PASSWORD_MIN_LENGTH', 6),
          'mixedCase' => (bool) env('PASSWORD_MIXED_CASE', 0),
          'numeric' => (bool) env('PASSWORD_NUMERIC', 0),
          'special' => (bool) env('PASSWORD_SPECIAL', 0),
  ],
  

• from Database\Seeders\DatabaseSeeder, from the run() method's unit tests running branch, you may delete the following seeders, as the respective factories have been updated to no longer require this:

              CountrySeeder::class,
              RegionSeeder::class,
              TownshipSeeder::class,
              LocalitySeeder::class,
  

• update/rename the following .env variables:
  • PASSWORD_LENGTH -> PASSWORD_MIN_LENGTH
  • PASSWORD_NUMERIC_CHARACTERS -> PASSWORD_NUMERIC
  • PASSWORD_SPECIAL_CHARACTERS -> PASSWORD_SPECIAL
  • PASSWORD_UPPER_CASE_CHARACTERS -> PASSWORD_MIXED_CASE
• replace LaravelEnso\Core\Exceptions\Sentry usage and import with LaravelEnso\Sentry\Exceptions\Handler in App\Exceptions\Handler.php
• remove bulma-rtl patch from client\patches, as is no longer needed
• run yarn, yarn upgrade && yarn in /client to ensure you have the latest versions and patches are applied. If necessary, update your patches
• php artisan migrate
• php artisan enso:upgrade
• as per every release, delete any local, deprecated upgrades
• it recommended to also run the all the enso tests to make everything is working properly; therefore, compare your local phpunit.xml with Enso's and make sure that you're not missing any package tests.

4.7.1

This is a patch release whose main purpose is to update localisation files.

Upgrade steps

• update the Enso version to 4.7.1 in config/enso/config.php
• run composer update in the project's root
• publish the updated localisation assets with php artisan vendor:publish --tag=enso-localisation --force
• run yarn, yarn upgrade && yarn in /client to ensure you have the latest versions and patches are applied. If necessary, update your patches
• php artisan enso:upgrade --before-migration
• php artisan migrate
• php artisan enso:upgrade
• as per every release, delete any local, deprecated upgrades

4.7.0

This aims to be the last minor release before upgrading to PHP 8 and includes many improvements, bug fixes and also several new features.

Front-end

Most of the packages received a dependency list cleanup.

activity-log

• moved the icons file

addresses

• improved postcode in form

auth

• refactored components

bulma

• added orderable trees

calendar

• added filter in components/CalendarFilter.vue

categories

• updated dependencies: now uses the orderable trees package

clipboard

• updated readme

companies

• small fixes
• removed unused code
• improved people association removal

data-import

• added back cascade of the browseFiles method which makes it easier to use the component standalone, for example in a table
• fixed rejected import download

documents

• added file size limit

emag

• updated commercial form content and components

filters

• added translatable to vue-filter

financials

• updated dashboard chart
• improved client filter

forms

• hided actions in autosave mode
• returned promises from fetch & submit; added submitting and submitted events
• added clearErrorsControl, section-divider class, section visibility and watcher for the form path, so that the form is re-fetched if the path changes
• fixed style and hidden fields
• cleaned and updated CoreForm.vue
• updated FormSection.vue
• removed meta

inventory

• updated product components; moved icons to src

io

• fixed channels, small fixes

notifications

• fixed channels, method name

orderable-trees (new)

• facilitates creating and ordering tree structures with drag-and-drop functionality

products

• fixed images in picture uploader
• fixes missing dependency

rating (new)

• simple component which facilitates star rating

scroll-to-top

• updated mobile margins

switch

• made label clickable
• simplified logic

tables

• fixed boolean classes in table cell and slot

tasks

• used new websocket getter

toastr

• extended HTML support for title similar to body, if html flag is set, treat title (if set) as html.

typeahead

• made search control hidden on mobile
• passed enso error handler
• added taggableoption: can create when typing non existing options; emits keydown events to be used in different implementation scenarios; small internal refactor
• cascaded the core typeahead clear method and made the query & loading values available in the controls slot

ui

• fixed @enso-ui/auth and channels
• improved logo display in navbar
• small refactor

Privates

commercial

• updated pages and components
• integrated sale channel package
• allow issue invoice at all times
• reorders actions to be more natural
• added cancellation
• multiple fixes and enhancements

eav (new)

• provides entity attribute value functionality for entities which require a scalable number of attributes

emag

• added response handling for product publish
• added sale channels and services as dependencies
• added settings table
• added option for manual invoice upload
• various fixes and updates

frisbo (new)

• provides action components for syncing, stock check and dispaching orders on Frisbo platform

inventory

• updated overwritable products pages
• added warehouses store

sale channels (new)

• basic sale channels CRUD components with store functionality

webshop

• added approve & reject action in table
• added sale channels and services as dependencies
• various fixes and improvements

Back-end

addresses

• added rememberable on locality and region
• improved store logic and label
• added cast for addressable_id
• allows multiple billing addresses
• fixed test
• added postcode to label
• added scopes and dynamic user relation

avatars

• updated user_id cast

calendar

• added phpmd config
• fixed notification queue
• updated notification subject

categories

• fixed logic due to illuminate collection constructor update
• added rememberable keys in category, global scope & small changes
• cleanup and fixes
• improved scope by adding the table
• updated parentTree to return only parents
• updated tests to reflect previous changes to the parentTree method
• added contains nested scope

charts

• added colorsConfig setter, updates ChartCard and Chart
• fixed chart options reactivity

cli

• fixed package generation

comments

• updated notification subject

companies

• added rememberable keys in company
• updated factory and tests

core

• extracted impersonate policy
• added version update
• fixed import, style, password reset when email is wrong, notification queue and email footer
• updated Version.php, config.phpand social media icons
• added core version, missing key in guest state and admins & supervisors scopes on user
• improved reset password notification and enso mail theme
• replaced social media icons with svgs; improved publishing aliases
• extended the reset storage command to take optional list of folders (comma separated)
• removed deprecated googleplus and unused import
• reworded reset password notification subject

countries

• added rememberable keys in country for iso.
• added name to rememberable keys
• improved region label

data-export

• fixed notification queue

data-import

• fixed wrong number with restart
• added error in console mode and validations in template export
• updated Chunk.php
• reseted counters to zero when data-import was restarted in all cases.
• removed ImportTypes

departments

• removed useless import

documentation

• updated documentation for Search Modes

enums

• added ability to use private constants for custom logic
• fixed enum localisation and mapping

excel

• refactored in export service

forms

• flexible number of columns
• added visibility
• fixed wrong property, meta test, input "content" validation
• added clearErrorsControl structure option

helpers

• updated Sleep

impersonate

• added gate
• updated AuthServiceProvider.php

io

• made event dispatchable

localisation

• added & improved translations

notifications

• fixed route (http verb name)
• fixed order
• updated test due to route update

packaging-units

• added rememberable keys

pdf

• enabled risky
• updated margins and added footer font size
• added download method

people

• added caching feature to company() helper
• company() always loads relation

products

• refactored form for easier customization
• added internal code management
• improved internal code logic
• added length in config for internal code
• removed unwanted section
• added attachPicture method and acquisition price helper
• implemented product slug
• added wysiwyg form field options
• migrated towards 4 decimals and updated migration
• updated company factory use
• fixed product booted method

rememberable

• added custom key
• added tests
• renamed config key & exception message
• fixed key for polymorphic relation
• raised default to 1h
• various fixes

roles

• updated default menu

services

• small visual refactor
• migrated towards 4 decimals
• removed unneded financials dependency

tables

• no longer added default order by clause when the base query already has order by clauses applied
• improved raw total efficiency
• fixed typo and enum localisation

tasks

• fixed email path
• updated default menu order
• updated notification subject

upgrade

• added nullable helper on column
• added new hasType helper method for the Table utility class

versions

• improved flow

Privates

api (new)

• provides boilerplate and base functionality for implementing external apis

commercial

• made events dispatchable; implemented the new computor; improved client stock import service
• implemented shipping and billing address
• added container resolve for all xlsx document generation instances
• added payment method
• migrated towards 4 decimals
• added undo fullfillment
• refactored invoice & order blades, order email, notifications
• added enum for file formats and refactored order controllers
• added cancelled_at and Cancel controller
• added reservable scope
• updated policies
• added addresses option controller
• multiple fixes and enchancements

discounts

• added service clientDiscounts relation
• removed int cast in discounts
• fixed discount factories

eav (new)

• provides entity attribute value functionality for entities which require a scalable number of attributes

emag

• implemented product publish
• added sale channels and services as dependencies
• added settings
• added voucher handling
• added payment method to sale creation
• implemented free_shipping_above
• added emag orders fallback
• migrated towards 4 decimals
• added Emag courier accounts, AddAttachment action
• added and updated enums
• added invoice upload on sale creation flow
• refactored and added NewOrder, OrderCancellation and awb notifications
• multiple fixes and enchancements

fetcher

• fixed stream closing on upload
• updated notification subjects

financials

• added new Computor; dropped ComputesLines, ComputesTotals, LineComputor, TotalsComputor
• migrated towards 4 decimals
• added discountWithVat helper
• rewrited invoice blades
• added pdf invoice download option
• multiple fixes and enchancements

frisbo (new)

• Frisbo api implementation for external order fulfillment. Provides functionality for managing products, dispaching, updating and syncing orders

inventory

• added rememberable on position
• improved fulfilment flow
• added new Order contract
• added reservable scope as needed
• added cancel method in Warehouse model and Fulfilment contract
• various fixes and enchancements

product-eav (new)

• loose coupling package implementation between products and eav for avoiding unwanted dependencies

sale channels (new)

• provides basic sale channels structure

stripe (new)

• Stripe api implementation for processing card payments

webshop

• added missing factory attribute and facebook fields
• added ability to store cart in session if content is not private
• updated stock statuses
• implemented fast registration and free_shipping_above
• improved cart logic
• added google ads support
• updated payment methods
• added welcome_text_on_mobile to migration
• removed external ref in orders table
• fixed seo
• improved ratings and reviews
• added product repository
• thorough layout, flow and functionality refactor
• multiple fixes and enchancements

webshop-commercial

• implemented the new computor, reused dynamics between product and service
• implemented shipping & billing addresses
• added side by side form for adding new card
• implemented free shipping and finalize order on payment creation;
• updated the response to support wire transfer
• updated the Line price method to show unitary price with vat
• refactored notifications
• added stripe checkout
• covered edge case when order payment method is set
• thorough refactor
• multiple fixes and enchancements

Upgrade steps

• update the Enso version to 4.7.0 in config/enso/config.php
• run composer update in the project's root
• run yarn, yarn upgrade && yarn in /client to ensure you have the latest versions and patches are applied. If necessary, update your patches
• php artisan enso:upgrade --before-migration
• php artisan migrate
• php artisan enso:upgrade
• as per every release, delete any local, deprecated upgrades

4.6.0

This release includes improvements, bug fixes, and new features.

Front-end

io

• used new websocket getter

money

• improved focus & blur handling, fixed input event payload
• added the ability to have null value

notifications

• used new websocket getter

select

• added debounce for addTag

tables

• added support for numbers
• added formatted filtered / count
• moved pagination logic to the BE
• added support for selection controls
• fixed pagination when full records info is false

tasks

• added permissions to register
• used new websocket getter

ui

• announce a new release on every chunk load failed error
• added permissions to register ref enso-ui/tasks#6
• fixed auth routes for guests
• removed predefined websocket channels

users

• fixed avatar display when no tooltip is needed

Back-end

addresses

• added new addresses.created_by column; added upgrade
• added PHPMD config
• added factories for Township, Locality and Region

avatars

• removed HasAvatar trait in favor of dynamic method & observer

cli

• fixed routes stub
• fixed UI route component imports
• added common default for the route for the menu config

companies

• added policy for edit page

core

• removed HasAvatar trait
• removed the laravel-enso/teams dependency as the package can be added if required
• binding Faker\Generator in production to Dummy laravel-enso/data-export#10
• added user profile policy
• fixed import in login controller
• added namespace to tests

data-export

• fixed notification path
• added sync excel attaching ability
• updated permission description in structure

data-import

• updated ExcelSeeder
• fixes serializing with postgres

documentation

• updated table docs: references to money vs number
• other table documentation small updates

files

• fixed file path upgrade for projects that don't use data-import

filters

• resolves comparison operators enum from App's container for improved flexibility; ref laravel-enso/filters#4

helpers

• added dummy

localisation

• updated out of stock ro translation

products

• updated test namespace
• updated url for pictures (route name remains the same)

roles

• rolls back ordering removal for the sync command

tables

• improved support for numbers; moved pagination on BE
• fixed test
• added 'selection' ability for global controls
• selection works only on selectable tables, and will send to the BE a selection payload with the selected rows
• buttons that work with selection will be rendered only when a selection is made
• fixed incorrect pages count, fixed incorrect middle pages

tasks

• added taskable contract & factory

private packages

webshop

• added about-us page
• added controller import
• added limited stock limit upgrade
• added favorites database persistent ref laravel-enso/webshop#33
• removed restricted/selective mfr load

emag

• fixed file save
• added authentication in job
• added fetch orders job
• added FetchOrders command to the service provider

Upgrade steps

To upgrade:

• app/Http/Controllers/Auth was removed from enso - if not customized locally, you may remove it as well
• websocket getter changed, and there is a channel getter instead of specific channels getter now; if you are using websocket locally, you need to change the getter(like this)
• the teams package is no longer included with enso by default. If you require it, add it back:
  • add "laravel-enso/teams": "^3.0", to composer.json
  • add "enso-ui/teams": "^2.0", to client/package.json
• remove Broadcast::routes(); from app/Providers/BroadcastServiceProvider.php (like this)
• update the Enso version to 4.6.0 in config/enso/config.php
• run composer update in the project's root
• run yarn, yarn upgrade && yarn to ensure you have the latest versions and patches are applied. If necessary, update your patches
• php artisan enso:upgrade --before-migration
• php artisan migrate
• php artisan enso:upgrade
• as per every release, delete any local, deprecated upgrades

4.5.0

The main reason for this release is the complete overhaul and refactor of the file management flow within Enso, including excel exports and imports. This also means potentially breaking changes, so please read through the entire changelog.

Front-end

auth

• added autocomplete suggestions on auth form

bulma

• added Avatar.vue to the list of bulma components

calendar

• added browser state persisted calendar filter

commercial

• added missing dependencies

data-import

• improved param handling
• improved param structure
• improved page layout

financials

• added missing dependencies

forms

• updated lodash import style

io

• improved progress layout, with more information available and the option to cancel the supported operations
• left room for custom operations

notifications

• fixed dependencies
• fixed duplicated navigation

select

• updated lodash import style

strings

• added lcfirst & ucfirst helpers

tables

• implemented selectLabel for custom internal select filters
• updated lodash import style
• added a small padding between top controls

tasks

• added missing dependencies
• fixed duplicated navigation
• added avatars & updated the allocated.options route
• updated NavbarTasks.vue registration order

typeahead

• updated lodash import style

ui

• the home screen for the enter the application button is in focus by default, so you can now access the application using the keyboard
• fixed NavbarItem vue component name
• added missing favico.js dependency
• attempts to fix chunkLoadError on new releases
• added newRelease state prop in global state
• resolved dependency cycle for router -> store
• added initial login redirect for guests

users

• now avoids navigation duplicated error when visiting the profile page
• adds an index.js file for easier components import
• cleanup of dead styling

Back-end

action-logger

• improved response time by persisting the ActionLog after response
• fixed extra query by disabling guarded

activity-log

• fixed test name
• minor update to the EnumServiceProvider

addresses

• added missing country relation in Region

avatars

• added functionality to be able to add an externally hosted avatar
• improved generation flow and now the impersonator can change the user's avatar
• updated the package due to files refactor

calendar

• the birthdays calendar is now visible depending on user roles
• added publishable calendar configuration for the roles
• updated tests
• calendar reminders are now scheduled from the package service provider and don't need to be added anymore to the local service provider
• renamed readyToNotify scope to shouldSend

cache-chain (new)

• package allows for the definition of a chain of caching layers and the retrieval of elements from within the cache, by going through the cache layers in the defined order

comments

• small refactor
• dropped ordered scope in favor of latest

cli

• now uses newLine() instead of line()
• fixed table template path
• now also creates routes file

core

• added login route for auth users' state
• removed the Uploads trait usage
• removes Impersonate trait usage
• added job_batches migration

countries

• added active state: is_active column, scope, upgrade

control-panel

• added active property for apps

data-export

• major refactor in concert with the files update
• uses the OptimalChunk functionality & removed the config chunk option
• improved the notifications
• added per sheet progress
• allows for the cancellation of an in-progress export
• updated the notification text & added the ability to customize the default notification
• the enso:data-export:purge command is being scheduled from within the package
• the DataExport model has an expired scope which takes into account the configuration value for enso.exports.retainFor

data-import

• complete re-write of the package
• improved before & after hook handling (now they actually run correctly in all cases)
• now uses Laravel's Job batch support
• rejected rows/chunks are now stored in the database vs files written on disk
• updated tests
• updated where impacted by files updates
• updated Model / table structure
• added per sheet progress
• allows for the cancellation of an in-progress import

departments

• fixed import

documents

• updated the package due to files refactor

emails

• updated package to work with the new files

enums

• small code style refactor

excel

• improved service to handle inline/download;
• renamed path to folder in savesToDisk contract
• temp directory gets created if required & does not exist

files

• removed the Uploads trait and relation for user
• added the TEMPORARY_LINK_EXPIRATION env variable
• upgraded FileServiceProvider (breaking change)
• updates the Attachable contract & HasFile traits, which are now lighter. All the file operations will be made from now on using the file relation / model
• renames visible scope to browsable, and forUser scope to for
• removed the File model's path method
• improved upload and attach flows
• improved tests and adds attach file test
• improved upgrade

helpers

• refactor: renamed internal property name
• changed static to self for morphSiblings array in the CascadesMorphMap trait
• added the OptimalChunk service, extracted from tables

how-to

• updated the package due to files refactor

impersonate

• improves logic
• made use of dynamic methods and removed the Impersonates trait

io

• improved code
• added support for better progress reporting
• registered IoTypes enum to app's state
• improved IOOperation contract
• removed IOEvents enum
• removed HasIOStatuses enum
• added missing person relationship load within the IOEvent class

menus

• reordered imports in test

products

• updated due to files upgrade

rememberable

• small cleanup
• removed layers
• now uses cacheLifeTime to limit the cached element lifespan

roles

• removed deprecated order attribute usage

searchable

• fixed code style

services

• fixed code style

tables

• updated the package due to files refactor
• renamed path key to folder in config.export array
• improved export blade
• added generic and enso specific export handling, including notifications
• moved isEnso getter in Config
• added a name ability to Config
• improved fetcher to memoize count
• added fetchMode for Data builder to avoid building actions for exports
• updated optimal chunk logic to return lower values
• made use of the new DataExport
• extracted optimal chunk in helpers

tasks

• added role check when choosing user to allocate to
• added config for roles
• added tests

track-who

• small refactor

upgrade

• updated unsuccessful upgrade error message

Upgrade steps

Although this release contains breaking changes, unless you've been getting deep into the framework, there are high chances these will not affect you.

A files upgrade is included and should run together with any other relevant upgrades, but before running it please read all the notes below.

To upgrade:

• run composer update
• run yarn, yarn upgrade && yarn to ensure you have the latest package versions and patches are applied. If necessary, update your patch files
• composer dump-autoload
• php artisan enso:upgrade --beforeMigration
• php artisan migrate
• php artisan enso:upgrade
• as per every release, delete any local, old upgrades
• if using the calendar package, you should remove the scheduling of the enso:calendar:send-reminders local command as it's being scheduled from within the package
• if using the data-export package, you should remove the scheduling of the enso:data-export:purge local command as it's being scheduled from within the package
• for table exports, data-import & data-exports templates may have changed slightly, if using internationalized texts, you may need to update your translations
• phpunit configuration has become more strict so ensure you have the proper path defided for the following packages:
  • helpers:

  <directory suffix="Test.php">./vendor/laravel-enso/helpers/tests/unit</directory>
  

  • cnpvalidator/cnp-validator:

  <directory suffix="Test.php">./vendor/laravel-enso/cnp-validator/tests/features</directory>
  

  • menu-manager/menus:

  <directory suffix="Test.php">./vendor/laravel-enso/menus/tests/features</directory>
  

if running data imports programmatically

• previously you had to create an UploadedFile instance, then pass it to the Import service:

  $file = new UploadedFile(Storage::path($path), $filename, null, null, true);
  (new Import(self::Type, $file))->handle();
  

• now, you should use the DataImport->attach() method and pass the storage relative path to the file and the filename:

  DataImport::factory()->make(['type' => self::Type])->attach($path, $filename);
  

if generating exports using the data-export package

• the ExportsExcel contract has been updated to support generating multiple sheets:

  public function heading(): array 
  

  becomes

  public function heading(string $sheet): array
  

  public function query(): Builder
  

  becomes

  public function rows(string $sheet): array
  

  public function attributes(): array
  

  becomes

  public function sheets(): array
  

  public function mapping($row): array
  

  becomes

  public function mapping($call): array
  

• the previous BeforeExportHook' &AfterExportHookcontracts have been renamed toBeforeHook&AfterHook` respectively, and allow you to add specific logic before & after running the export as before
• by default, the user running the export is notified upon the export's completion
• there is a new Notifies contract that allows you to replace the default notification logic, which you may also use to disable notifications
• if previously, you were handling notifications for exports, consider using the out-of-the-box functionality and remove the notification logic
• on the exporter, you may optionally add a public function emailSubject(): string method and return a custom subject for the email notification
• on the exporter, you may optionally add a public function notifiables(DataExport $export): Collection method, which should return an array of notifiable entities, that receive the export done notification
• previously, when creating an export, you had to create a DataExport model, the exporter class, instantiate the ExcelExport service, and the call its handle method:

  $exporter = new MyExporter();
  $dataExport = DataExport::create([
      'name' => $exporter->filename(),
      'entries' => 0,
      'created_by' => $user->id,
  ]);
  
  (new ExcelExport($user, $dataExport, $exporter))->handle();
  
  return $dataExport->download();
  

• now, you may call the static excel(...) method on the DataExport model

  $exporter = new MyExporter();
  
  return DataExport::excel($exporter)->file->inline();
  

• if running exports programmatically or from jobs, authenticate using the required user before running the export:

  Auth::setUser($this->user);
  

if working locally with files, or models that work with files

The following Enso models use the HasFile trait: Avatar, Brand, CarouselSlide, Company, DataExport, DataImport, Document, Picture, Poster, RejectedImport, Upload, Video, WebshopPage.

• the included FilePath upgrade will handle the update of files attached to Enso models (such as those above).

  However, the Attachable contract in concert with the HasFile trait allows an attachable model to specify a potentially dynamic folder name where to store files.

  IF you are using this flow for your own local models, you need to handle upgrade for those file records yourself.

• the HasFile trait has been updated and no longer cascades the following methods:

  • inline
  • download
  • temporaryLink
  • attach
  • upload
  • folder

  What this means is that you should load the file and chain/call the desired method on the file model: php $document->file->download();

• the storagePath() method has been removed, both from the trait and the File model. You should use instead:

  Storage::path($document->file->path);
  

• the LaravelEnso\Files\Traits/Uploads.php has been removed

• previously, when using the attach(...) method on the File model or the any Attachable model, through the HasFile proxy method with the same name, the file was being optimized. If you are attaching files that somehow do not come through the Enso flow, handle any needed optimization manually.

• the file relationship as defined in the HasFile provides a default if no file exists:

  public function file(): Relation
      {
          return $this->morphOne(File::class, 'attachable')
              ->withDefault();
      }
  

  Update any checks using truthy logic such as if ($myAttachableModel->file) {...} as required, or you may have unexpected consequences.

4.4.0

The release further decouples ui packages and introduces automatic asset discovery and registration, better files organization to help in the future with adding a new CSS framework as well as various other improvements. This also means breaking changes, so please read through the entire changelog.

Front-end

All packages which depend on the ui package have had their dependency versions updated.

Also, the icons.js files have been moved from the bulma folder one level up, since icons are css framework agnostic.

The packages thus affected have been updated to their next respective major version.

auth (new)

• extracted assets (components, pages, routes, store) from the ui package

bookmarks (new)

• extracted assets (components) from the ui package

charts

• improved chart update
• fixed chart redraw on dataset changes
• improves yAxis callback handling

data-import

• fixed select params label

datepicker

• added new 'value-updated' event on component value change
• improved enso datepicker alt-format handling

filters

• updated eslint config

forms

• implemented field related methods that controls the field's meta.hidden attributes by showField and hideField
• reused these methods inside the showTab/hideTab methods, while avoiding forceUpdate after each meta.hidden change
• fields methods are independent of tabs/sections and target all form fields
• adds ability to handle nested fields withing the form template
• displays default field for a custom field if the slot is empty

io (new)

• extracted assets (components) from the ui package

localisation

• extracted assets (components) from the ui package

notifications (new)

• extracted assets (components, pages, routes) from the ui package

tasks (new)

• front-end for the new task management package

themes

• added flags background color
• made options having warning text more visible in vue-filter

tutorials

• extracted assets (components) from the ui package

tree-view

• small cleanup

user-groups (new)

• extracted assets (pages, routes) from the ui package

users (new)

• extracted assets (components, pages, routes) from the ui package

ui

• implemented automatic registration for package:
  • routes
  • icons
  • custom registration logic
  • store
• extracted various assets to existing or new packages as required

Back-end

activity-log

• fixed test name

avatars

• improved avatar generation during tests, to use a locally generated avatar vs doing a gravatar fetch, which speeds up tests
• fixed gravatar warning message

charts

• added autoYMin() helper
• added support for gridlines
• switched xAxisConfig parameter order and made dataset optional;
• added disableAutoRadius() in bubble; added datalabels config setter
• improved chart customization
• added method return types and typed parameters

cli

• the generated routes now use controller classes

departments

• removes leftover namespace

discussions

• refactored routes
• added xss sanitizer

enums

• added the option to have the key validated when getting a value (disabled by default)
• added the option to have localisation on/off per enum as opposed to all enums, by adding a $localisation variable with the desired value in your enum;

forms

• the Form service now uses the when trait so actions may be chained conditionally

io

• fixed the variable name within the BroadcastServiceProvider

core

• data-import is no longer required and becomes optional

currencies

• fixed CurrencySeeder namespace

control-panel

• switched to using Laravel's Http instead of Guzzle
• refactored services & fixed invalid response edge case bug

helpers

• small refactor in FactoryResolver

products

• added data-import missing dependency

select

• fixed bug for multiple select-filter where values were missing due to failed collection merging

tasks (new)

• task management package

tables

• refines export done notification

upgrade

• added pre-migration option for the upgrade command; upgrades that run pre-migration are also visible in the status report
• refactored the MigratesStructure contract
• fixed missing Priority column in the status report

Upgrade steps

As this new release cleaned up the @enso-ui/ui package and simplified icon and route registration, a bit of cleanup is also required in the local project.

Also, a new php artisan enso:upgrade --before-migration command is available that is meant be used to run upgrade commands before the php artisan migrate command, which should help with complex upgrade scenarios.

To upgrade:

• within client/.env the following entry must be added:
  • VUE_APP_PROFILE=bulma The .env file must also be available during the build stage, so take that into account if using CI flows.
• the @core alias has been renamed to @ui, so update all usages, including
  • local resources (pages, components)
  • the client/.eslintrc.js file
• bump at least the following dependencies within client\package.json:
  • "@enso-ui/activity-log": "^3.0
  • "@enso-ui/bulma": "^4.0",
  • "@enso-ui/calendar": "^3.0",
  • "@enso-ui/data-import": "^3.0",
  • "@enso-ui/how-to": "^3.0",
  • "@enso-ui/tasks": "^2.0",
  • "@enso-ui/tutorials": "^3.0",
  • "@enso-ui/ui": "^4.0",
  • "eslint-config-airbnb-base": "14.2.0", Depending on your project requirement, the following dependencies might also need bumping:
  • "@enso-ui/categories": "^2.0",
  • "@enso-ui/commercial": "^4.0",
  • "@enso-ui/discounts": "^3.0",
  • "@enso-ui/emag": "^4.0",
  • "@enso-ui/financials": "^3.0",
  • "@enso-ui/inventory": "^3.0",
  • "@enso-ui/measurement-units": "^3.0",
  • "@enso-ui/products": "^3.0",
  • "@enso-ui/services": "^3.0",
  • "@enso-ui/themes": "^2.0",
• remove any package icon imports from client/src/js/app.js, as they're no longer required
• if using the dashboard page/component & menu, import the menu icon in client/src/js/app.js:

  import { library } from '@fortawesome/fontawesome-svg-core';
  import { faTachometerAlt } from '@fortawesome/free-solid-svg-icons';
  library.add(faTachometerAlt);
  

• unless using them in your local resources, you may remove package aliases from client/vue.config.js
• the avatar (Avatar.vue) component has been moved from the ui package to the users package, if you're using it locally, update the imports.
• within the composer.json scripts/post-update-cmd section add the command:
  • "php artisan enso:upgrade:status"
• the data-import package has been made optional, if you still require it, add it to:
  • composer.json : "laravel-enso/data-import": "^5.0",
  • package.json: "@enso-ui/data-import": "^3.0",
• the tasks package has been made optional, if you added it & still require it, add it to:
  • composer.json : "laravel-enso/tasks": "^1.0",
  • package.json: "@enso-ui/tasks": "^2.0",
• remove the following files as they're no longer required:
  • client/src/js/store.js
  • client/src/js/router.js
• look within this PR and update:
  • client/src/js/enso.js
  • client/src/js/localState.js
• run composer update
• run yarn, yarn upgrade && yarn to ensure you have the latest package versions and patches are applied. If necessary, update your patch files
• php artisan migrate
• composer dump-autoload
• php artisan enso:upgrade
• publish the updated localisation assets with php artisan vendor:publish --tag=enso-localisation and copy the ru.json file from the above commit into the local resources/lang/app folder
• in Envoyer and/or during your deployment process, add the new command: php artisan enso:upgrade --before-migration
• update the Enso version to 4.4.0 in config/enso/config.php
• as per every release, delete the old upgrades

4.3.0

This release aims to upgrade the Enso ecosystem to Laravel 8.

Front-end

select

• the api request payload was cleaned up and null values are no longer sent to the back-end

Back-end

Where necessary, packages have been updated to add Laravel 8 compatibility. Changes affect:

• factories
• seeders
• routes (now using imported controller classes instead of strings & namespaces)
• tests
• upgrades (older upgrades were deleted)
• dependencies versions

Where possible, we've kept packages backwards compatible.

logs

• fixes multiple log file types edge case bug

products

• removed default supplier limitation, where previously the default supplier had to have the lowest aquisition price

forms

• added support for the searchMode meta attribute, which can be used for select fields

Upgrade steps

First and foremost, be sure the to read the official Laravel 8 upgrade guide to understand all implications.

Since we liked the previous flow of publishing factories and customizing them, we've created a FactoryResolver class that is used to emulate the old behavior. Basically, when using a factory to create a model, we first search in the local project factories folder and try to find a suitable factory class, otherwise we search for a factory in the factories folder in the laravel-enso package which contains the respective model.

The limitation for the factory naming convention is that if you have two models with the same name, with different namespaces, you'll need to customize the models' newFactory() method and implement your own strategy.

Also, note that starting with this release we're no longer doing a yarn legacy build (only modern) so please take a look at package.json & babel.config.js and update if necessary.

To upgrade:

• within composer.json
  • update the versions for the following require packages

  "fruitcake/laravel-cors": "^2.0",
  "guzzlehttp/guzzle": "^7.0.1",
  "laravel-enso/core": "^6.0",
  "laravel/horizon": "^5.0",
  "laravel/telescope": "^4.0",
  "laravel/ui": "^3.0",
  

  • update the versions for the following require-dev packages

  "facade/ignition": "^2.3.6",
  "nunomaduro/collision": "^5.0",
  "phpunit/phpunit": "^9.3"
  

  • add the following namespaces to the autoload/psr-4 section:

  "Database\\Factories\\": "database/factories/",
  "Database\\Seeders\\": "database/seeders/"
  

  • remove the classmap block and its contents from the autoload section
• update where necessary by following this merge request for a list of other updated files (local factories and seeders cleanup, config files and more).
• run composer update
• run yarn, yarn upgrade && yarn to ensure you have the latest package versions and patches are applied. If necessary, update your patch files
• php artisan migrate
• composer dump-autoload
• php artisan enso:upgrade
• update the Enso version to 4.3.0 in config/enso/config.php

Remember:

• you can delete any non customized local seeders and import them from their package
• update factories & seeders to
  • use namespaces
  • convert to classes
  • rename the 'seeds' folder to 'seeders'
• update models with factories and add the new trait HasFactory
• update tests to
  • use the new factories
  • refactor around the deprecated json methods
• update routes by importing controllers as per the new syntax
• after updating your routes by importing the controller classes, you need to remove the protected $namespace = 'App\Http\Controllers'; line in RouteServiceProvider

4.2.0

This release includes many improvements, bug fixes and a few new features.

Front-end

accessories

• removed unused dependency

data-import

• improved date params usage
• added the missing vuex dependency
• added the functionality to cancel ongoing or stuck imports

date (new)

This package extracts a collection of date parsing and formatting helpers form enso-ui/ui.

datepicker

• fixed flatpickr timing error when setting the datepicker value to null

forms

• updated the DateField component to cascade the datepicker clear() method
• added encrypt type which enables the ability to hide the currently stored value for fields of this type

mixins

• added handling for Axios request cancellation in errorHandler

packaging-units (new)

The package creates the structure and includes the functionality for working with product packaging units.

• facilitates defining packaging units for products
• designed for better product management

products

• added enso-ui/packaging-units as dependency

tables

• uses the new enso-ui/date
• added the date-picker dependency
• added ability to conditionally render row actions

typeahead

• added search label property for the search button
• updated the CoreTypeahead search method to no longer mutate the query before emitting the search event
• added focus

ui

• removed date helpers and added enso-ui/date dependency
• translated hard-coded footer texts

PRIVATE REPOS:

commercial

• updated address select to include any params passed from the template
• updated sample products index page
• fixed translation keys
• updated index pages' filters
• added permission check for inventory quantity adjustment control
• fixed missing inject/import in PositionsManager
• added permission check for inventory quantity adjustment control
• added missing inject/import
• fixes editing fulfilled orders when the computed value had the wrong value

emag

• updated sample products index page
• updated the reference FormContent component
• updated the Order component
• reverted the Order component field label
• added new fetch picture button & functionality

financials

• switched interval filters from using date to using due date

inventory

• added the ProductLocations component
• updated sample products index page

Back-end

addresses

• updated region abbreviation column to support up to three characters
• added new states to USA
• added abbreviation as query attribute to address options
• added json file for romanian townships
• refreshed json files structures and updated values
• added townships table
• removed siruta from localities
• added township_id column to the localities and postcodes tables
• renamed township to township_name

avatars

• no longer passes the user as method parameter when attaching a newly generated avatar
• integrated Gravatar

cli

• added type properties when generating structure migrations
• fixed error when defining models with namespace

cnp-validator

• Added Laravel 8 support

core

• fixed password resetting
• fixed logout for inactive user
• adds region upgrade
• adds DataImport Upgrade
• added xss-sanitizer
• removed the Upgrade command from AppServiceProvider. Upgrades are now entirely handled by the laravel-enso/upgrade package
• refactored namespace for existing upgrades to work with the new package
• purged old upgrade classes

data-import

• added Authorizes contract for restricting users' ability to perform specific imports
• added params column to data_imports table for storing request parameters
• improved postgres support
• added the option to cancel an import (both ongoing and 'stuck')

enums

• fixes translation issue with applications where using a different default language (not english)

files

• updated attach method signature in HasFiles trait - the user parameter defaults to null

forms

• added encrypt type which enables the ability to hide the currently stored value for fields of this type

helpers

• added Searchable trait exclusion when running tests
• added Encrypt helper which aids in encrypting and decrypting values

localisation

• fixed json encoding
• removed leftover files
• added and updated many keys/translations

multitenancy

• refactored and upgraded for Enso v4

roles

• fixed default menu alias in query
• fixed role seeder

tables

• added default sort for all table queries
• added notVisible attribute for hiding specific columns by default
• fixed export bug for nested columns when values don't exist
• fixed count when using group by
• fixed entries counting when exporting excel in non-Enso environments
• fixed when multiple filters exist for a field
• added new feature that supports conditional table row actions therefore being able to further customize which actions apply to each row

upgrade

• implemented auto discovery of local and package upgrade classes when placed in app/Upgrades or src/Upgrades
• added the ability to set priorities for upgrades
• added new command: enso:upgrade:status which show the status of upgrades
• added MigratesPostDataMigration interface to Structure
• added Applicable interface which should be used to define if an upgrade should run or not
• added ShouldRunManually option
• now uses an Enum for the upgrade status table header

PRIVATE REPOS:

commercial

• added invoice issued event
• updated the Sale & Sale return templates regarding the address select
• removes unused traits in SaleInvoiceIssued event
• small refactor
• added missing client order ref in the Sale form template
• added update & delete policies to all line types; improved line update time limit handling
• added check when creating a sale payment to ensure the sale is not already linked to a payment

discounts

• small refactor in the SaleDiscountFor dynamic method

emag

• updated Sale form template regarding the address select
• removed customizations to the Sale form & table regarding client_order_reference as they're no longer required
• updated the EmagPayments import
• added new functionality to fetch a product picture for products with valid Emag offers

financials

• updated invoiceable entity info to use the billing address; client invoice now support dynamic relations
• added generic invoice imports to the package
• updated all package index tables to include record create/update timestamp & user information
• added a new Online payment type
• implemented conditional action for client payment (receipt) printing

inventory

• added available() method on the Stock model
• small refactor
• added a new StockUpdated event and a product emitStockUpdated method

webshop

• improved internet explorer warning
• fixed company address deletion bug
• added toastr message when address cannot be deleted
• update orderConfirmation.blade.php
• added missing authorizations
• refactored translation method usage
• removed the address policy and its registration from the AuthServiceProvider
• improved form request validations
• added product manufacturerName dynamic method; updated templates
• small changes & comments
• updates order payment_method keys to int; improved order validation => payment order
• extracted company & related scripts into partials from the cart form.blade.php blade
• updated stock computation
• cleaned up imports
• improved the settings form layout
• refactored StockStatuses constant from OnDemand to SupplierStock
• translated hardcoded text
• added VueJS component for product prices
• refactored code to fluent syntax in AuthServiceProvider
• replace span with template in Price.vue
• translated hard-coded texts; fixed a company update bug
• fixed error on product show page when a suggested product did not have a manufacturer set
• removed the js nullish coalescing operator as it is not 100% supported
• moves cookieConsent to cookieConsent.blade.php
• added phone number as required to user registration
• adds clear cart command
• fixes N+1 case for product ManufacturerName via using Rememberable
• removed the authorizePayment method
• added featured brand & label for the webshop brands
• updates scss for brand / logo
• integrated new User Registration Confirmation notification
• extracted hardcoded shipping cost mentions and replaced with partial
• added Terms and Conditions to the order review page
• various small fixes
• improved redirects from the Payment & Pay controllers to avoid infinite redirection edge cases
• fixed the user password reset mechanism
• integrated the form field encryption where necessary
• added the new product webshop label feature
• added a new publish command, that publishes the compiled package assets
• small product card manufacturer logo render improvement

webshop-commercial

• moved email template notification table in the partials folder
• refactored the event listener to async and notification to sync
• updated 'pay later' orders storing process
• added missing providers
• added missing column to the migration file
• updated migration payment method column
• removed leftover provider inclusion
• fixed not translated / hard coded text in the blade templates
• updated model as per latest contract updates
• added shipping changes partial template
• updated contract implementations
• updated webshop dependency version
• corrected PaymentIntent callback due to flawed refactor
• various other fixes and refactor
• added functionality to generate a Sale Payment when client makes a successful card payment
• removed the paid column from the webshop_orders table & refactored as required

Upgrade steps

To upgrade:

• run composer update
• run yarn, yarn upgrade && yarn to ensure you have the latest package versions and patches are applied. If necessary, update your patch files.
• php artisan migrate
• composer dump-autoload
• run php artisan enso:upgrade to execute the upgrades (you may also runphp artisan enso:upgrade:status to view the upgrades' statuses)
• make sure permissions are properly configured for each role and then save/refresh the roles configuration files
• update the Enso version to 4.2.0 in config/enso/config.php
• in composer.json, in the scripts.post-update-cmd section add the following scripts:
  • "php artisan telescope:publish",
  • "php artisan horizon:publish",
  • "php artisan enso:webshop:publish", (if applicable)

4.1.0

This release includes many improvements, bug fixes and also several new features.

Front-end

addresses

• added postcode address detection
• added locality_id in AddressForm
• added street to postcode
• added isBilling & isShipping to AddressCard; updated Addresses
• reordered fields in address form according to template
• added form payload to the form-loaded event

bulma

• exported form field group
• fixed export

categories

• added level maxNestingLevel property and level method in CategoryTree.vue
• improved logic
• fixed dragging and nesting
• fixed max level validation error display

commercial (private)

• updated FormContent due to supplier_number to supplier_order_reference refactor

companies

• fixed company type in Edit.vue

data-import

• added new Params, String, Date, CustomSelect and Boolean components
• uses the new Params component in Index.vue
• small clean up

datepicker

• fixed disabled property in CoreDatepicker

dropdown

• added show() method

emag (private)

• updated due to emag_number to client_order_reference refactor

forms

• added form-field-group field for has-addons or is-grouped scenarios

laravel-validation

• added first() method

people

• updated type in Edit.vue

roles

• fixed route in Edit.vue

select

• made dropdown available when no options but using taggable
• added show() and hide() methods in EnsoSelect and VueSelect components

ui

• added sessions & token management
• updated Edit.vue
• updated Sessions.vue

back-end

We have updated README.md and codacy badge for several packages.

addresses

• added show route
• renamed permission
• added postcode auto complete
• added romania postcodes
• added directory for cities & regions
• updated timestamps
• removed unused StateSeeder
• improved seeders logic
• added street to postcode
• added is_billing and is_shipping
• added casts
• updated factory & migration
• added is_billing and is_shipping to options
• updated OneLiner.php
• improved address form
• improved is_default, is_shipping, is_billing handling
• enabled the bool flags in the address form
• added tests for billing & shipping
• added missing routes
• updated makeDefault, makeBilling and toggleShipping
• made makeBilling method public

categories

• improved max nesting level validation message
• fixed recursive relations
• fixed order in tree() method
• removed hasChildren scope
• added risky in .stypeci.yml
• added new depth() method in model
• removed currentAndBelowIds and flatten methods
• added flattenCurrentAndBelow
• added test
• renamed publishing tag from categories-factories to categories-factory

cli

• added type for migration

commercial (private)

• renamed supplier_number to supplier_order_reference
• replaced index()->unique() with unique() in migrations
• removed timestamps from the history model fillable attribute; renamed table column
• updated client stocks import with the new params template feature
• updated the Sale model trait usage
• updated DailyUpdateStockValues logic and rules

control-panel-api

• renamed routes

core

• updated AddressPermissions
• added import.show permission
• added core-api middleware group
• added upgrade command to rename permissions
• added role filter in users
• added sessions (index & delete)
• added tokens (create & index & delete)
• added permission migration
• updated UserTokenPermissions.php
• updated UserSessionPermissions.php
• added postcode permission
• added postcode upgrade
• added street to postcode
• updated Addresses upgrade command to add is_billing and is_shipping columns
• added force to postcode seeder
• added post migration in Addresses upgrade command

data-import

• fixed comment spacing
• added params validation
• added support for params in template
• small refactor
• added import.show permission
• small refactor and clean up
• added seederPath option in config; updated ExcelSeeder

documentation

• added extra instructions regarding Sanctum's SANCTUM_STATEFUL_DOMAINS env value
• updated data-import docs

inventory (private)

• updated positions import to use the new data-import template params flow

localisation

• added language options controller
• simplified options controller

products

• added risky in .stypeci.yml
• updated categories dependency

roles

• fixed the scenario where roles without a default menu had the first parent menu
• skips an extra permission query

tables

• added default sort
• added notVisible column and visibility method in Columns builder
• updates ColumnTest
• renamed sort classes
• added defaultSort for all queries. dtRowId will be used if not customized by template
• fixed default sort when there are columns with same name

upgrade

• added foreign key helper

Upgrade steps

To upgrade:

• run composer update
• run yarn, yarn upgrade && yarn to ensure you have the latest versions and patches are applied. If necessary, update your patch files
• due to control-panel-api routes rename, we need to update ControlPanelApiSeeder: php artisan vendor:publish --tag=control-panel-api-seeder --force
• you need to publish addresses seeders by running: php artisan vendor:publish --tag=addresses-seeds --force
• publish also addresses factory: php artisan vendor:publish --tag=addresses-factory --force
• if using categories package, you need to:
  • update in composer.json the categories dependency "laravel-enso/categories": "^2.0"
  • publish factory by running: php artisan vendor:publish --tag=categories-factory --force
  • add the categories test suite to phpunit.xml:

      <testsuite name="categories">
          <directory suffix="Test.php">./vendor/laravel-enso/categories/tests</directory>
      </testsuite>
  

• php artisan migrate
• composer dump-autoload
• php artisan enso:upgrade
• ensure that permissions are properly configured for each role and then save/refresh the roles configuration files
• update the Enso version to 4.1.0 in config/enso/config.php

4.0.1

This is a patch release, therefore it includes several bug fixes and very small changes.

front-end

We have updated in all our packages the animated dependency to 4.0.0

calendar

• fixed deleting event in a sequence
• fixed drag event in EnsoCalendar

commercial (private)

• updated input clear
• added settings

financials (private)

• fixed VAT display, now shows numerical value

how-to

• updated Index.vue to add tag only when having access to store route

mixins

• updated error code from 555 to 488

modal

• improved portal creation into instance root

back-end

We have updated DynamicsRelations namespace to DynamicRelations in order to be PSR4 compliant for all packages and removed throttle

calendar

• drops create action from edit

commercial (private)

• removed InvoiceableEntity
• refactored position adjustment request
• replaced onceUsingId with setUser
• sale now uses the Methods trait; fixed the Person resource
• added settings
• updated the settings form; updated virtual position id references; removed the package config file

control-panel-api

• improved logic in seeder

core

• fixed reset password
• added PosterMorphKey upgrade command

data-export

• fixed comment typo

data-import

• replaced onceUsingId with setUser
• fixed comment spacing

discounts (private)

• fixed redirect on delete bug; fixed model import after refactor

financials (private)

• added new InvoiceableEntity exception
• updated number type form unsignedInteger to string for payments and invoices
• fixed client table filters bug; updated auto number; fixed model load issue after refactor

forms

• fixed typo in comment

how-to

• added CascadesMorphMap trait for Poster and updated AppServiceProvider

impersonate

• fixed typo in middleware
• fixed middleware and added provider method
• fix authentication

inventory (private)

• removed show button from the form as route is necessary
• improved the position form

tables

• replace onceUsingId with setUser
• fixes mail driver

teams

• fixed namespaces in AppServiceProvider and Teams

tutorials

• corrected folder name

Upgrade steps

To upgrade:

• run composer update
• run yarn, yarn upgrade && yarn to ensure you have the latest versions and patches are applied. If necessary, update your patch files
• php artisan enso:upgrade
• all Auth:onceUsingId() uses should be updated to Auth::setUser($user) due to sanctum addition
• remove 'throttle:60,1' from App\Http\Kernel
• replace tables.export.notifications email to mail
• upgrade "animate.css": "^4.0.0" in package.json
• update in enso.scss animate import to animate.compat.css instead of animate.css
• update MAILGUN_ENDPOINT in your .env files to api.mailgun.net instead of api.eu.mailgun.net
• ensure that permissions are properly configured for each role and then save/refresh the roles configuration files
• update the Enso version to 4.0.1 in config/enso/config.php

4.0.0

With this release we added sanctum to our core, opening the way for mobile applications and better integrations with external apis. We have also refactored all of our backend packages. Among the changes we have brought to our backend code, we have managed to:

• remove App namespace from our backend packages. We started with our left foot regarding this when we split Enso into specialized packages and we carried the bad decision along the way. It was time to revert this
• add typed properties to Structure Migrations
• gave up using fillable in our models in favour of $guarded = ['id']
• many other punctual improvements and bug fixes which further hone our ecosystem.
• remove how-to, activity-log, tutorials, comments, documents, discussions as core dependencies. Made cli as dev-dependency
• move helpers from classes to services
• update the docker image

Since we consider that Enso has matured enough, starting with 4.0.0 we are going to use semver. As a result, we have updated all package dependencies and incremented the major version where the case.

front-end

Most of the packages received a dependency list update. For all packages, we've refactored the modal uses according to its latest version by dropping the show control property. We've also refactored the new toastr uses by injecting it where needed instead of using the globally available $toastr property.

accessories

• split accessories to new packages: addresses, comments, discussions and documents
• removed App from namespace

addresses (new)

• created new addresses package, subtracted from the accessories

bulma

• added the new addresses, comments, discussions and documents packages as dependencies
• removed App from namespace

calendar

• updated vuecal event creation

charts

• added cancelToken for subsequent requests

comments (new)

• created new comments package subtracted from the accessories

commercial (private)

• added the comments, documents packages as dependencies
• removed App from namespace

companies

• added the addresses package as dependency
• removed comments, discussions and documents from accessories
• removed App from namespace

contracts (private)

• added the documents package as dependency
• removed App from namespace

discussions (new)

• created new discussions package subtracted from the accessories
• removed App from namespace

documents (new)

• created new documents package subtracted from the accessories

dropdown

• exposed a bool selection flag in dropdown's render

erd

• updated readme

financials (private)

• added the comments, documents packages as dependencies
• removed App from namespace

forms

• tweaked reveal password
• extracted toastr from CoreForm
• shows reveal password only when specified

hr (private)

• split accessories to new packages
• removed App from namespace

inventory (private)

• split accessories to new packages
• removed App from namespace

mixins

• removed i18n and updated error handler to use the new toastr

mobile-app (new)

• this is our first iteration of a ready to publish (IOS, Android) mobile app based on Expo.

modal

• improved the modal behaviour
• dropped the need for the show control prop. Now the modal will have to be controlled by v-if="something". This is breaking and need refactor in all uses
• fixed a bug when the modal was open, and the router was used to switch the page, which let the modal hang forever and needed a page reload
• added a transitionDuration prop that allows using the transition also for the above case
• overall refactor

people

• split accessories to new packages
• removed App from namespace

products

• split accessories to new packages
• removed App from namespace

projects

• split accessories to new packages
• removed App from namespace
• added project status

tables

• added dateFormat for the new internal filters

toastr

• improved toastr use; now instead of defining it globally it can be imported / injected where is needed

typeahead

• improved the select logic; added in the select event the selected item, if any
• fixed edge case for query and min query length

ui

• changed Authorization from header to cookie
• renamed is-webview to webview
• added generate token to user and checks for access permission
• added RevealPassword component in AuthForm
• fixed search bug, ToastrPosition
• refactored mixins
  • updated the use of toastr by importing and providing it for injection, in App
  • improved store by making use of vue-router-sync -> this adds a breaking change for the setPageTitle store action that now requires only the new title as param
• removed how-to/activity-log/tutorials dependencies
• disabled impersonate in webview
• fixed style
• added pusher
• fixed navbar avatar, now we use Avatar component instead of img in Operation component

back-end

action-logger

• removed ActionLogs trait and replaced it with a dynamic relation to user

activity-log

• fixed helpers services namespace
• updated web middleware group to api for sanctum

addresses

• dropped the defaultAddress() method, instead, the address() relation will always return the default address
• added return type in isLocalized helper
• added isLocalized helper
• replaced web middleware group with api for sanctum
• updated codacy badge

avatars

• dropped direct relation
• updated web middleware group to api for sanctum

calendar

• removed default value parentMenu
• changed web middleware to api

categories

• improved config
• removed unused AuthServiceProvider
• added Abilities trait in model and removes Relations
• renamed migrations
• updated web middleware group to api for sanctum

cli

• generate files & namespace according to v4

comments

• removed the old comments trait and adds dynamic relations to the core user
• updated web middleware group to api for sanctum
• fixed store controller

companies

• added abilities & routes notifications to company
• renamed CompanyStatuses with Statuses
• replaced web middleware group with api
• renamed obs to notes
• added filters request to request validator and fixes store/update controllers
• fixed helpers services namespace
• removed accessories, leaves only addresses

control-panel

• updated controllers to use Illuminate\Routing\Controller instead of App\Http\Controllers\Controller
• fixed style
• added FilterRequest in ValidateApplicationRequest
• updated Application update controller to except token field from request

control-panel-api

• changed token to sanctum
• fixed conflicting routes
• added seeder for generating monitoring user
• changed web middleware to api
• moved database to root

control-panel-common

• updated codacy badge

core

• added sanctum, new tests and authorization key to cookie
• renamed is-webview to webview
• added EnsureFrontendRequestsAreStateful for webview
• added new mapMorph
• refactored services into controller
• added api group & monitoring user
• added route & refactor control panel
• changed web middleware to api
• updated relations
• removed activity-log, tutorials, how-to dependencies.
• renamed obs to notes
• added rename migration upgrade

countries

• changed web middleware to api

currencies

• replaced web middleware group with api for sanctum
• renamed migration

data-export

• refactored ASP

data-import

• replaced web middleware group with api for sanctum
• fixed helpers services namespace

departments

• renamed migrations

discussions

• updated relation
• changed web middleware to api

documents

• replaced web middleware group with api for sanctum
• updated codacy and style ci badges

dynamic-methods

• added an Abilities trait suited for models, containing relations, scopes & mutators

enums

• fixed stub

files

• changed web middleware to api
• updated relation
• updated codacy badge
• fixed namespaces
• renamed publicPath to storagePath
• updated & casted env pagination key; refactored upload service provider;

filters

• updated codacy badge

helpers

• added FiltersRequest trait
• improved filters request to receive array or argument list
• improved CascadeMorphMap to always resolve the last model binding
• improved Searchable to detect changes in algolia camelCase keys also
• updated enso exception error code to 488

history-tracker

• updated codacy badge

how-to

• changed web middleware to api
• replaced direct relation traits with dynamic relations
• updated relation
• updated codacy badge
• removed storage folder that is now managed by core
• renamed migrations

impersonate

• added sanctum

io

• fixed avatar in IOEvent
• small refactor
• improved logic in IOEvent and updated IOObserver

localisation

• changed web middleware to api

logs

• replaced web middleware group with api for sanctum
• fixed helpers services namespace

measurement-units

• changed web middleware to api
• renamed migrations

menus

• changed web middleware to api

notifications

• changed web middleware to api
• updated codacy badge

pdf

• updated codacy badge

people

• replaced web middleware group with api for sanctum
• updated codacy badge
• renamed obs to notes

permissions

• added abilities trait
• added comments and documents as dependencies
• added HtmlDescription to validation
• removed tutorial permission (added dynamically from the tutorials package)
• updated web middleware group to api for sanctum

products

• changed web middleware to api
• updated relation
• updated codacy badge

rememberable

• updated codacy badge

roles

• changed web middleware to api
• updated HasRoles
• removed todo

searchable

• changed web middleware to api
• updated codacy badge

services

• changed web middleware to api

tables

• updated codacy badge
• updated helpers namespace

teams

• changed web middleware to api
• replaced direct relation traits with dynamic relations
• updated codacy badge

track-who

• use Config facade instead of helper
• refined tests

tutorials

• added tutorials dynamic relations to permission
• updated web middleware group to api for sanctum

upgrade

• updated codacy badge

versioning

• updated codacy badge

upgrades steps

Backend

1. update dependencies to next major for example core ^5.0 (like this)
2. run composer update
3. add SANCTUM_STATEFUL_DOMAINS to .env (like this)
4. remove App from namespace of packages,(you can use this regex, LaravelEnso\\(.*)\\App\\ replace with LaravelEnso\\$1\\)
   • you need to replace laravel-enso/(.*)/src/App/ with laravel-enso/$1/src/ too
5. Comments, Discussions & Replies traits were removed and you need remove them from User.php (like this)
6. run composer dump-autoload
7. you need to add the AuthorizationCookie and EnsureFrontendRequestsAreStateful middleware classes to middleware group (like this)
8. if you didn't bind Core/User to the local User, you need to do this now in AppServiceProvider (like this )
9. you need to replace the web middleware with api in RouteServiceProvider.php and in your local api.php routes (like this)
10. you must update the configuration values for defaults.guard to api and api.driver to sanctum (like this)
11. we have replaced the fillable property with guarded on all of our models, so make sure to update the local models accordingly
12. the CompanyStatuses enum was renamed to Statuses
13. you need to add types to LaravelEnso/Migrator Migration class fields (like this)
14. you may need to fix routes in imports and static files (like this) (you can use this pattern for searching laravel-enso/.*/src/database)
15. publish the sanctum config php artisan vendor:publish --tag=sanctum-config
16. publish the monitoring seeder php artisan vendor:publish --tag=control-panel-api-seeder (optional, if you’re using Control Panel Api)
17. add Broadcast::routes(['middleware' => ['auth:sanctum']]); to routes/api.php(like this)
18. search & replace use LaravelEnso\Helpers\Classes\ with use LaravelEnso\Helpers\Services\
19. companies doesn't have documents, comments, discussion as dependencies anymore, if you still need them you need to install them and using DynamicMethod (like dynamic-methods, AppServiceProvider.php, composer.json)
20. how-to, activity-log & tutorials were removed from the laravel-enso/core, therefore if you need to use them you need install too (like this)
21. obs field was replaced with notes, you need to update migrations and factories regarding this change
22. replace the deprecated defaultAddress() method with address where necessary
23. publish the telescope assets by running php artisan telescope:publish
24. publish the horizon assets by running php artisan horizon:publish
25. update version 4.0.0

FrontEnd:

1. update dependencies to the next major version (for example "@enso-ui/ui": "^3.0") except (clipboard, confirmation, datepicker, directives, divider, dropdown-indicator, enums, erd, laravel-validation, money, progress-bar, progress-circle, route-mapper, strings, switch, tabs, textarea, themes, transitions, wysiwyg, uploader) (like this)
2. run yarn, yarn upgrade && yarn to ensure you have the latest versions and patches are applied. If necessary, update your patch files
3. remove the eslintrc.js file from the project root
4. remove App from namespace of packages (you can use this regex, search for LaravelEnso\\(.*)\\App\\ and replace with LaravelEnso\\$1\\)
5. how-to, activity-log, tutorials were removed from the enso-ui/ui, therefore if you need to use them you should install the packages and set them up (you can look at .eslintrc.js, app.js, vue.config.js, router.js)
6. companies doesn't depend on documents, comments or discussion anymore, if you still need them you can use patch (like this)
7. toastr was changed in this version, and you need to inject it wherever you need(like this) (it's optional but recommended)
8. modal was changed and the :show property has been removed, you need to use v-if instead of :show (like this and this)
9. documents, comments, addresses & discussions were extracted from Accessories therefore if you need them you can import them from @enso-ui/bulma instead of @enso-ui/accessories (like this)

3.9.5

front-end

accessories

• updated components to use the User resource format for avatar
• added localization button for addresses

activity-log

• updated components to use the User resource format for avatar

calendar

• fixed EventConfirmation
• upgraded to vue-cal 3
• fixed style

categories

• updated for the new BE
• added laravel-validation as dependency

charts

• small refactor

commercial (private)

• added laravel-validation as dependency
• updated import of Errors class in RowLine to use the new laravel-validation package

contracts (private)

• updated Card component to use the User resource format for avatar
• uses Avatar component instead of img in Card.vue

directives

• fixed clickOutside when the target isn't a child of container
• for solving this issue, added a deep modifier to check contains with positions
• updated clickOutside

dropdown

• removed stop propagation as it uses the improved v-clickOutside
• added disable-controls boolean prop
• fixed disableControls reactivity

emails

• added laravel-validation as dependency

files

• updated components to use the user resource format for avatar
• added clipboard to Url.vue

financials (private)

• added laravel-validation as dependency

forms

• added the ability to customize wysiwyg's toolbar
• extracted Errors in its own package
• added a new RevealPassword component
• uses RevealPassword in InputField

inventory (private)

• added laravel-validation as dependency

laravel-validation (new)

• new package that contains an Errors class that maps on the Laravel ValidationException messages

mixins

• parses number for type safety in shortNumber
• removed unneeded dependency

permissions

• added cssClass for menus

projects (private)

• added laravel-validation as dependency

roles

• updated FE for the new BE Permission resource

tables

• merged custom and column internal filter and smalls fixes
• small refactor in label
• added in-place editing filter
• improved logic in Filters and Labels components
• fixed eslint
• small refactor
• fixed internal filters without custom

teams

• updated components to use the User resource format for avatar
• uses Avatar component instead of img in AvatarList

textarea

• updated eslint

typeahead

• improved behaviour when no results are found
• added min-query-length property
• added search event when pressing enter
• fixed axios cancel token
• provided query on item slot
• added optional search button

ui

• fixed theme and rtl
• updated preferences.js
• updated AuthForm to display error messages instead of toastr
• uses the new RevealPassword component in AuthForm

webshop (new) (private)

wysiwyg

• updated eslint

back-end

activity-log

• updated Timeline response to use User resource instead of TrackWho

addresses

• updated validator: changes is_default to be required
• removed unnecessary query
• removed form builder region label usage
• added rememberable in address
• fixed one liner
• added localisation functionality with google maps integration
• uses laravel Http instead of guzzle; refactor and cleanup

calendar

• added fixes such that:
  • when an event in the middle of the sequence is deleted, then it should break the sequence first then delete events
  • when series of events are updated in the middle of the sequence then it should not change the frequency
  • when a sequence of events is deleted, then the cache will be invalid
• fixed frequency update, type equality in ValidateEventRequest.php and edge case when update date of an event in the middle of the sequence

categories

• improved recursive relations
• renamed recursiveParents relation to recursiveParent
• added currentAndBelowIds and relations trait
• updated self relations to static
• added parentTree helper

commercial (private)

• updated client stock import
• cleanup in company service provider

contracts (private)

• updated AdditionalAct resource to use User resource instead of TrackWho

core

• added products and localize upgrade
• updated LoginController to use ValidationException instead of Authentication
• fixed ValidatePasswordRequest and ForgotPasswordController

countries

• added region label model helper

discussions

• updated resources to use User resource instead of TrackWho

documentation

• updated documentation for categories and products

dynamic-methods

• added scope support

files

• updated File resource to use User resource instead of TrackWho
• added new publicPath method in trait & contract

io

• updated IO resource to use User resource instead of TrackWho

measurement-units

• renamed UNITS constant from seeder to Units

permissions

• improved permissions types, added Permission resource

products

• added html_description, dynamic scopes to product and dynamic relations to category
• removed unused hasMappedProducts and adds manufacturedProducts for companies

roles

• improved roles validation
• uses resource in permission tree

tables

• fixed export edge case
• updated Enum.php

teams

• updated Team resource to use User resource instead of TrackWho

Upgrade steps

To upgrade:

• run composer update in the project's root
• run yarn, yarn upgrade && yarn to ensure you have the latest versions and patches are applied. If necessary, update your patches
• update the Enso version to 3.9.5 in config/enso/config.php
• the Errors class was extracted from enso-ui/forms to it's own package enso-ui/laravel-validation. If using it locally, make sure to update the imports.
• ensure that the php artisan enso:upgrade command is run
• there is a new localize addresses route added, please ensure that the roles/permissions are correctly configured for your projects and then save the roles configurations
• update the client/src/js/enso.js file using the package version as reference
• make sure to have vuex-router-sync dependency in package.json

front-end

accessories

• updated the user options route used for tagging

charts

• added a short number option to the Chart.vue component

commercial

• updated the bundled products index sample page

emag

• added a products index sample page

financials

• updated the index pages' filters to filter on date instead of due date

inventory

• updated the bundled products index sample page
• switched from using the RoAddresses component to using the Addresses component
• updated the Addresses related components: cleanup and refactor due to new structure & fields

modal

• test if we are ready to release the new refactored modal

products

• added a product picture column for the index table
• made the product image clickable, which opens the image in a new tab

quick-view

• updated the default size (width)

roles

• fixed the configure and save buttons in role edit form

search-mode

• added Algolia support

tables

• fixes custom boolean internal table filters

ui

• fixed duplicate requests being made on language change
• removed deprecated media resources, which have been moved to the back-end core package (and need to be published)
• added custom modal for offering the choice of deleting a user simultaneously with its person

back-end

addresses

• the addresses package was completely refactored. It now supports regions and localities, and some functionality was integrated from the ro-addresses package which will be deprecated. The update includes:
  • the addition of the region & locality model, relationships, routes, etc
  • the Country model now has relationships with the above models
  • the update of the table and structure migrations
  • the addition of an address select route/controller/resource
  • the removal redundant country relationship load on the select options flow
  • the update & enhancement of the address form and template
  • the update of the address factory & seeders
  • the addition of an unique index to regions
  • the inclusion of a Region seeder for Romanian counties and US states
  • the inclusion of a Locality seeder for Romanian localities
• the AddressFetch validator now uses the TransformMorphMap trait

avatars

• removed the ensureFolderExists method call
• updated the Files test folder references as the config key enso.files.paths.testing has been updated to enso.files.testingFolder
• the Avatar model now uses the CascadesMorphMap trait
• morphMap is now used for the Avatar model

calendar

• renamed notification template and updated button color

categories

• added a hasChildren scope and an isParent helper method on the Category model
• updated request validator due to MapsRequestKeys refactor

core

• the php artisan enso:storage:reset also handles the creation of missing storage folders
• the image resources previously present in the @enso-ui/ui package have been moved to the this package
• renamed the resource publishing tag from core-images to core-assets
• added a FilesIndex upgrade service that attempts to set and unique index on the files table to avoid any duplicates. If there are duplicated records present, the upgrade will list the duplicates and skip adding the index
• added upgrades for Addresses, Documents, Files, Discussions, Comments, morphMap, which replaces class names with their corresponding short morph map keys
• fixed user notifications which sometimes were not found
• added the ability to delete the attached person when deleting a user
• refreshed the email theme
• added an Addresses migrator due to the addresses' package refactor
• removed the avatar label in the users table
• removed avatar label in users table

companies

• refactored to use mapMorphs: the Company model now uses the CascadesMorphMap trait

comments

• added controller for customizing taggable users
• the Comment model now uses the CascadesMorphMap trait

countries

• added the Relations trait on the model, so it can support dynamic relationships

data-export

• refactored to use mapMorphs: the DataExport model now uses the CascadesMorphMap trait

data-import

• updated the files test folder references
• refactored to use mapMorphs
• fixed rejected import deletion bug causing rejected files to not be deleted
• fixed rejected import file name bug causing the file to have the extension added twice
• added a cleanup upgrade for left-over rejected models & files in core

documents

• updated the files test folder references
• added the $folder variable to the Document model
• the request validator now uses the TransformMorphMap trait
• the Document model now uses the CascadesMorphMap trait
• morphMap is now used for the Document model

discussions

• the request validator now implements the TransformsMorphMap interface
• refactored to use mapMorphs: the Discussion model now uses the CascadesMorphMap trait

files

• refactored the paths config: now attachable models should have a $folder property or a folder() method
• updated the Files test folder references as the config key enso.files.paths.testing has been updated to enso.files.testingFolder
• added handling logic for tests within the HasFile folder() method
• refactored to use mapMorphs: the Upload model now uses the CascadesMorphMap trait

filters

• adds Algolia support in search mode

forms

• when building the form, the enums are now resolved from the service container
• fixed the toggling of tab visibility
• makes section's columns size customizable when building a form via the columns(string $field, int $value) method, where the $field parameter is used to identify the section to be modified

helpers

• added a searchable trait for Scout that makes sure that reindexing is performed only when indexed attributes are changed, avoiding unnecessary Algolia operations
• added the Sleep service class that can be used to sleep during code execution !!
• moved the VatRates enum from the financials package
• improves MapsRequestKeys trait
• added morphMapKey() method to the CascadesMorphMap trait which determines the model's morph map key
• added the TransformMorphMap trait

how-to

• refactored to use mapMorphs: the Video model now uses the CascadesMorphMap trait

localisation

• updated language resources
• fixed some bugs found when adding keys
• renamed localisation-lang-files tag into enso-localisation. Under this tag we're publishing only Laravel's lang files
• removed unused localisation files from the app directory
• local translations are now saved to the local app directory when adding or updating
• core translations are now saved to the enso localisation package directory when adding or updating
• local app localisation resource files are now merged with the enso package's localisation resource files
• added SanitizeAppKeys class in order to remove from app localisations the keys found also in enso localisations
• added some missing translations

menus

• add the isParent & isNotParent scopes on the Menu model

people

• added internal table filter for filtering people with/without users
• refactored to use mapMorphs: added CascadesMorphMap on the Person model
• optimizes the company() helper query
• person now touches user on each edit

products

• added name and part_number to the options builder $queryAttributes variable
• the Picture model now implements AuthorizesFileAccess and access is allowed by default
• added validation to disallow the selection of a parent category in the product form
• added product pictures to the products table
• updated publish tag & paths from 'products-resources', 'enso-resources' to 'products-assets', 'enso-assets'
• updated the default image
• removed package's VatRates enum and switched to using the VatRates from the Helpers package
• updates package product factory re: measurement units, causing the creation of a new measurement unit if one was not provided to the factory
• shortened the picture label in table template
• the picture now touches the product

ro-addresses (deprecated)

• the package is now deprecated, will not be maintained and should no longer be used

select

• added Algolia support, which is disabled by default

services

• updated VatRates import post enum refactor
• fixed service factory re: measurement units bug, causing the creation of a new measurement unit when one was not provided
• the vat percent is now a selectable value within the form
• fixed description field width (full column)

tables

• on big tables, totals are shown only when forceInfo is true
• fixes raw total edge case when using bindings in the query select statement
• added Algolia support, which is disabled by default
• fixed internal bug in custom filters without server side options

upgrade

• small refactor & fixes; updated structure migration reported message

Upgrade steps

To upgrade:

• run composer update in the project's root
• run yarn, yarn upgrade && yarn to ensure you have the latest versions and patches are applied. If necessary, update your patches
• update the Enso version to 3.9.4 in config/enso/config.php
• if using the MapsRequestKeys trait, within the respective request validators, update the controllers to use $request->validated() instead of $request->mapped()
• for all the enso models that use the Addressable, Commentable, Discussable, Documentable traits, we are now using Relation::morphMap(...) and short keys instead of default namespaces as this solves issues with relationships breaking when extending models which use morph relationships. For consistency, you should do the same to your local models (you may look at the Company model & companies AppServiceProvider classes as example)
• the files test folder config key has been updated from enso.files.paths.testing to enso.files.testingFolder. If you are customizing the value, make sure to update the config file structure. Also make sure to update the local file after the one in the files package.
• if using the products package, note that the validator's validateUnicity method has been renamed to validateUniqueness - update your local validator if required
• for this release, we've switched from using predis to using phpredis. Ensure that:
  • the phpredis extension is installed on your (live) machines
  • the redis.client configuration option is set to phpredis in your config/database.php
  • if present in your env, the REDIS_CLIENT key value is phpredis
  • remove the predis package from your composer.json
• we've consolidated some assets (picture) locations and simplified the build process. You should:
  • run the php artisan vendor:publish --tag=core-assets command
  • cleanup the multiple CopyPlugin instances and keep just the command that copies assets from ../resources/images to images. Use enso's vue.config.js file as an example
• the VatRates enum was removed from the financials & products packages and put in the helpers package. If using it locally, update the namespace to LaravelEnso\Helpers\App\Enums\VatRates
• the localisation package and flow has been enhanced. To update for the new flow do the following:
  • remove the enso resource directory from local language resources. From now on, when merging translations the core translations will be taken directly from the package resources
  • run php artisan vendor:publish --force --tag=enso-localisation
  • remove from your local composer.json file "php artisan vendor:publish --tag=localisation-lang-files" from under the post-update-cmd section
• since the email theme assets were updated, if you want to use the refreshed theme, you should publish the assets with php artisan vendor:publish --force --tag=enso-email
• the addresses package has been refactored and updated. You should:
  • publish the package seeders with php artisan vendor:publish --force --tag=addresses-seeds
  • publish the AddressFactory.php file with php artisan vendor:publish --force --tag=addresses-factory
  • if present, delete the local RoAddress factory from the factories folder
  • if using the addresses package WITHOUT the ro-addresses extension, make sure that the php artisan enso:upgrade command is run AFTER php artisan migrate
  • if using the addresses package WITH the ro-addresses extension, make sure that the php artisan enso:upgrade command is run BEFORE php artisan migrate
  • update the local/published addresses config file using the package version as reference
  • since there are some new addresses routes added, please ensure that the roles/permissions are correctly configured for your projects and then save the roles configurations
• run php artisan enso:upgrade considering the mentions above (in the addresses section)

front-end

categories

• removed deprecated routes & pages
• added the CategoryTree Vue component featuring an improved flow, CRUD & reorder abilities
• updated dependencies
• updated move route
• now the selected category is cleared when destroying category
• fixed the package entry point

calendar

• added translation for the calendar's name

charts

• fixes typo/leftover regarding the label formatter function
• fixed data-labels with formatter
• fixed progress in info-panel

commercial

• added short numbers to the stats info panel
• added picture to items
• pictures are now vertically aligned in the product selection typeahead

control-panel

• removed unneeded dependency
• made all top columns narrow

emag

• updated routes
• ui updates
• adjusted for missing match's pictures
• refactor to make available more information in sub components
• fixed enum option name
• unmatched products with a selection of emag products are now styled differently
• refactored components
• fixed missing product id
• now modal is closed when match choice is made
• matching process fixes
• further tweak for the modal closing; removes published/is_published usage

financials

• added short-numbers to info panel

modal

• removed deregisteration from close, added it to beforeDestroy

products

• updated form for the new CategoryTree.vue component
• added box on categories in form
• added picture gallery
• updated BaseForm for gallery
• added missing dependency
• added missing import

select

• fixed bug related to the disabled selection of options while loading the option list

ui

• parses number for type safety for the shortNumber formatter

uploader

• added support for manual uploading

back-end

categories

• updated factory
• fixed validation bug
• fixed moving of categories within the tree
• updated the move route

cli

• refactored to get rid of deprecation notice

core

• adds categories upgrade
• fixes user conflict exception

files

• changed resize / optimize order

image-transformer

• allows transformer to work with local files too

products

• added product pictures
• fixed reordering
• added a picture relation for the default picture (order_index 1)
• removed active filter from product options controller

roles

• updated to use injected service in command handle method

upgrade

• fixed default role permission syncing
• updated Structure.php
• fixed typo and default role query
• added a new ShouldRunInConsole contract
• removes invalid logic
• removed deprecated exception

Upgrade steps

To upgrade:

• run composer update in the project's root
• run yarn, yarn upgrade && yarn to ensure you have the latest versions and patches are applied. If necessary, update your patches
• update the Enso version to 3.9.3 in config/enso/config.php
• if using the categories package, ensure that the php artisan enso:upgrade command is run

3.9.2

front-end

Front-end packages have had their yarn.lock file removed as it wasn't mandatory and fixed various automated depencency vulnerability warnings.

accessories

• removed tooltip.js as direct dependency
• fixed comments' avatar display
• reverted to 'component'-wrapper class names for the Discussions and Comments components

categories (new)

• created a new package which is currently a dependency of the products package

charts

• added a new component, info panel to the package
• added slot for controls
• now performs fetch on source change
• added missing shortNumber filter
• added default min:0 for y axis ticks
• improved chart to use formatter function on y axis

commercial

• added stats example page
• added missing package dependencies
• fixed product select template
• updated QuickView component import
• added a github issue template to the repository

confirmation

• removes tooltip.js as direct dependency

data-import

• updated/fixed the Enum usage
• added a github issue template to the repository

departments

• updated menu icon
• updated ui dependency requirement

directives

• added a new v-resize directive, meant to be used with input fields, that resizes the field based on its content length

dropdown

• removed popper.js as dependency
• cascaded the hide() method;
• fixed the proper closing of drop-downs when dealing with multiple drop-downs
• added stopPropagation for click events
• tweaked the component height to have it aligned with other Enso UI components

enums (new)

• micro package that exposes Enum functionality, similar the the back-end package with the same name

filters

• removed tooltip.js as direct dependency
• @enso-ui/strings was added as a dependency as some utility methods are used within CoreDateFilter

forms

• removes tiptap as dependency

hr

• added fa-pro dependency
• removed unneded dep

inventory

• added addresses to the warehouse edit form as a result of adding an address relationship to the warehouse model
• the @enso-ui/products dependency was updated to the new minor version
• added a github issue template to the repository

permissions

• the permission.js mixin was converted to a module
• added a github issue template to the repository

quick-view

• added a github issue template to the repository
• removes unneeded @enso-ui/card dependency

roles

• updated the roles configuration component to work with the new permission module
• added a github issue template to the repository

search-mode (new)

• added support for exact and doesn't contain matching
• added stopPropagation for the click event

strings (new)

• micro package that contains a set of string manipulation methods

tables

• added support for configurable, state persistent, general filters
• addressed bug tooltip position bug for some tables with one or two rows
• translation support was added the column visibility selection
• @enso-ui/select was added as dependency as dropdown usage was replaced by select
• @enso-ui/enums was added as dependency as Enum computation was added to the front-end
• added support for average totals
• extracted search in its own component
• fixed some layout problems in the top controls
• fixed a bug where a double fetch was performed when resetting preferences
• trimmed down request by removing garbage data
• fixed preferences handling

teams

• added a github issue template to the repository
• fixes team name padding in card

themes

• added the sidebar.scss component as part of the fix for the UI menu issue

tutorials

• updated column name in the index table
• updates enum slot to the new table
• added a github issue template to the repository

typeahead

• itemEvents & highlight attributes are now exposed in items slot

products

• fixed directives requirement/import
• added category selection to the product form as the product model now has a category relationship
• @enso-ui/categories was added as a dependency
• added a github issue template to the repository

select

• updated the multi-select trigger css (set height & min-height)
• extended selection slot to also cover the 'no selection' or 'no options' scenarios
• fixed bug where select height was not matched with inputs
• fixed select / deselect events payload to include full object when working in objects mode

ui

• fixes collapsed sidebar label position on scroll
• removed tooltip.js as direct dep
• fixed navbar search tag filtering
• @enso-ui/enums was added as a dependency
• fixed bug related to missing a background color for the menu, on mobile usage mode
• used interpolation syntax for scss variables usage

back-end

addresses

• replaces helper with facade
• added checks for single vs multi address support

avatars

• now the supervisor can update the avatar of the impersonated user
• refactored Default Avatar service, the create method returns now the freshly created avatar
• improveed the logic in test

calendar

• removed event body from the birthday calendar
• refactored event request validator
• fixed logic in event policy causing users with the proper roles to not be able to edit certain events

categories (new)

• the package adds categories functionality and is currently a dependency of the products package

charts

• now axes are displayed by default

cli

• removed log
• fixed bug that was not allowing the creation of a parent menu with null route

control-panel

• fixed bug caused by url leading slashes

comments

• fixed the user resource used for displaying the avatar

companies

• fixed the publish tag
• added importer & excel seeder
• fixed enum usage
• updated the static Company model owner method

currencies

• added slot for the symbol table column

data-import

• fixed rejected import download
• removed deprecated attribute from table select
• fixed enum usage in table

filters

• fixed Hour typo related bug
• added TimeSegments enum & timeSegment getter and property in the Interval service
• extended comparison operators with Equal, Is, IsNot, NotLike, NotILike
• extended search modes with exact and doesn't contain matching
• fixed a bug in the search service when having falsies as value
• adds tests for the new search modes

forms

• enums are now resolved from the service container

localisation

• updated a 'ro' translation value

permissions

• improved computed type by adding a Verbs enum

phpunit-pretty-print (new)

• created a phpunit pretty printer package

products

• added vat rates enum
• improved form
• added category attribute & functionality to the package
• added upgrade service to products

ro-addresses

• added missing facade import
• updated index controller for the new for scope
• refactors seeders
• added factory & tests
• fixes validator by adding missing attribute

select

• fixed resource instantiation via the usage of dependency injection

tables

• refactored optimal chunk service & its respective test
• enums are now resolved from the service container
• fixes enum localisation when building template
• added support for configurable, state persistent, general filters
• updated api version
• filterable is now a supported meta attribute within the json table configuration files used to mark columns that are filterable using the new filtering functionality
• average is now a supported meta attribute within the json table configuration files used to mark columns for which we want a average type of total
• updates backend for the new trimmed request
• added some missing return types for methods
• fixed a bug in rawTotals where the result was being cast to int
• fixed an inconsistence where the columns was mapped in a Collection instead of a Obj
• added support for exact and doesn't contain search modes
• removed Enum computation in favor of front-end handling
• renamed the fetchMode method to serverSide
• added enum transformation for front-end enum processing

upgrade

• fixed exception method signature
• fixed admin role syncing in production for structure upgrade

The new tables filters

While the new minimum configuration table filters are implemented and you may test drive them (by adding the "filterable" attribute in the table columns' meta arrays, and then configuring the filters from the table's UI), please note that some of the filters configuration options/values/structure may change. We therefore don't recommend using them just yet in production.

When this feature will reach what we consider a stable form, the various options will be explained and the documentation updated.

Upgrade steps

To upgrade:

• remove from client/package.json:
  • extract-text-webpack-plugin
  • popper.js
  • postcss-cssnext
• add in client/package.json
  • postcss-preset-env
• run `composer require --dev laravel-enso/phpunit-pretty-print
• add in phpunit.xml printerClass="LaravelEnso\PHPUnitPrettyPrint\PrettyPrint"
• run composer update in the project's root
• run yarn && yarn upgrade && yarn to ensure you have the latest versions and patches are applied. If necessary, update your patches
• update the Enso version to 3.9.2 in config/enso/config.php
• in config/enso/tables.php update the comparisonOperator and searchModes keys to:

'comparisonOperator' => ComparisonOperators::Like,
'searchModes' => [
    SearchModes::Full, SearchModes::StartsWith, SearchModes::EndsWith,
    SearchModes::ExactMatch, SearchModes::DoesntContain,
],

• in config/enso/select.php update the comparisonOperator and searchMode keys to:

'comparisonOperator' => ComparisonOperators::Like,
'searchMode' => SearchModes::Full,

• in config/enso/imports.php:
  • add the new companies importer under the configs array

  'companies' => [
      'label' => 'Companies',
      'template' => 'vendor/laravel-enso/companies/src/App/Imports/Templates/companies.json',
  ],
  

  • update app namespace to App for userGroups' importer
• update resources/preferences.json and change the expandedMenu key to expandedSidebar
• if using the products package:
  • add the LaravelEnso\Products\App\Services\Upgrades\Products upgrade service class to your upgrade logic and if customizing the validation/form, extending the model, ensure that the new attribute is fillable/etc as required
  • since products now depends on the @enso-ui/categories package, you should also import the package's icon and routes

3.9.1

The release includes a complete refactor of the main Menu and many small changes and fixes both on the back-end and the front-end.

front-end

accessories

• updated avatarLink usage
• removes quick-view due to extracting it to its own package

calendar

• switched vuecal to default grey theme
• added translation for the small calendar

card

• added is-naked on card control

checkbox

• updated the CheckboxItems.vue component class

commercial

• updated enso date filters usage

contracts

• fixed parties enum in Index.vue
• updated enso date filters usage

financials

• updated enso date filters usage

how-to

• fixed template upload vertical alignment

logs

• log card controls are now naked instead of success/info/danger

mixins

• updated last route / intended route mutation usage

modal

• small refactor

projects

• fixed icon for the ProjectCard component

quick-view (new)

• replaced hardcoded scss top value with variable in order to detect navbar height

route-mapper (new)

• new micro package which contains the route mapping logic

tables

• fixed tag width on boolean columns
• removed unnecessary span around cells
• improved top controls
• updated search layout
• enhanced column visibility & style selector
• added helper for invisible columns

teams

• fixed team name padding in card

themes

• renamed the is-hoverable helper to is-hoverable-item
• added a settings component
• improved the font import, made it easier to customize
• added Muli as family secondary font, used for the refactored menu
• adjusted shadows for is-raised, raises-on-hover, box and card
• made changes to improve contrast for both themes

typeahead

• drop down events are now cascaded
• exposed itemEvents & highlight in the items slot

toastr

• vertically centered the message icon

ui

• removed deprecated Route.js
• refactored document title, route.js
• small refactor in Loader.vue
• now using intendedRoute & intendedPath when redirecting a logged out user after login
• renamed MenuState to SidebarState
• implemented sidebar and navbar variables
• updated aside shadow to be more discreet
• changed page header animations to simple fade
• updated navbar elements
  • changed order for sidebar control
  • added tooltip on env indicator
  • removed arrow from notifications
  • added a long awaited user dropdown when clicking the user profile link that allows quick logout
  • upgraded search:
    • by default it is hidden
    • can be activated by clicking the search icon or using the / key
    • on esc & blur it hides itself
• updated sidebar / menu style:
  • made the sidebar wider
  • added a new font
  • increased the menu-label & menu-item font
  • updated highlighting and selected state of menu
  • the parent menu now remains open when changing to a menu with a different parent
  • added a visual indicator / handle for menu reorder
  • refactored the way active menus are managed
• refactored store
  • renamed menus store module to menu
  • renamed layout/menu module to layout/sidebar
  • renamed layout/settingsBar to layout/settings
  • added a layout/search module for managing the global search state
  • integrated the logout request into the auth.js module
• made the user group forms smaller
• updated the avatar component to use the user resource format
• added footer resize on sidebar collapse
• added footer transition
• made bookmarks shadow similar to that of the sidebar
• renamed sidebar related classes (menu => sidebar)
• set the menu font smaller (0.95em)
• fixed bug in search when selecting from list
• updated the sidebar state's label

back-end

All back-end packages have been updated due to renaming the app folder to App. You can find more information below.

avatars

• fixed trait folder name
• added unique constraint for the user_id column

cli

• refactored logic & tests as needed to support the generation of files in both local & package modes, using the correct case for the App folder

companies

• added a default, open/permissive policy for the controller actions
• project specific logic can be created locally when needed, by extending and binding a new policy

core

• added a role relation to user group
• adjusted the user group form
• updated the way the avatar is shown in users table
• added a unique constraint for the user_id column in the avatars table
• fixed namespace for the avatars upgrade command

currencies

• dropped Types from migrations

data import

• removed deprecated parameter from the UploadedFile constructor call

excel

• fixed namespace for ExcelExport from LaravelEnso\Excel\App\Exports to LaravelEnso\Excel\App\Services

filters

• fixed incorrect interval filtering by returning copies of the carbon objects
• adds a new search service to be used for query builder searching

helpers

• added a new When helper trait which can be used in a similar fashion to query builder style

localisation

• added translation keys for the Sentry front-end error report form
• small keys cleanup
• updated localisation form layout
• updated user translation for the 'ro' language files

menus

• moved attribute set from tree builder to resource
• added an active attribute to the resource

people

• added a default, open/permissive policy for the controller actions
• project specific logic can be created locally when needed, by extending and binding a new policy
• multi-tenant specific request authorization logic has been removed form the request validation
• fixed test

products

• fixes failing tests when suppliers are not given

searchable

• implemented the new search service from laravel-enso/filters; removed local logic

select

• refactored traits, used the new When helper trait for a more fluent, conditional flow

tables

• implemented the new search service from laravel-enso/filters; removed local logic

upgrade

• fixed the structure migration
• fixed the default role permission syncing
• refactored native php function to collection for better readability

Upgrade steps

It was necessary to rename the app folders as with newer composer versions, the tool would complain (show notices) about the namespace not being psr4 compliant.

If these notices were to be present when deploying, Envoyer would stop the deploy process.

However, since the namespaces remained the same, these changes should not affect you.

To upgrade:

• run composer update in the project's root
• run yarn, yarn upgrade && yarn to ensure you have the latest versions and patches are applied. If necessary, update your patches
• update the Enso version to 3.9.1 in config/enso/config.php
• if using the ExcelExport class locally, search & replace LaravelEnso\Excel\App\Exports\ExcelExport with LaravelEnso\Excel\App\Services\ExcelExport
• if directly using import templates from any of the Enso packages, update the path to the JSON templates in config/enso/imports.php

3.9.0

This release includes many improvements and new features, bugfixes as well as the upgrade to Laravel 7.*.

Since the Laravel upgrade contains some pontetially breaking changes, you should take a look at the official upgrade instructions to see if/how you're affected.

front-end

bulma

• added components: TreeView, CheckboxManager, CheckboxItems, QuickView

calendar

• fixed the event slot, due to the VueCal update
• fixed an UI template issue when the selected option was not ready
• added an update action when an event was modified via drag & drop due to the new VueCal feature
• fixed display for long calendar names
• refactored event update confirmation modal - now uses buttons instead of radio buttons

categories (new)

• created package that handles product categories

checkbox (new)

• created package with checkbox items & manager components - extracted from the roles package (role configurator)

clipboard

• added clipboard support for passing an argument to the copy method - the argument represents the value that you want copied to the clipboard

commercial

• small UI updates for the order lines
• cleanup of unused injection in FormContent
• implemented order lines reload when trying to add a line to an order with stale data

companies

• added a new website attribute to the company model and as a result, a new column is visible and clickable in the index table
• a corresponding upgrade was added to Enso (more information below)

discounts

• small refactor of the package's pages, removing duplicated code

dropdown

• updated dropdown item selector strategy

emag

• updated form content & extracted logic into the EmagOrder component
• added check for the presence of the emag order id value

filters

• removed the deprecated SimpleDateFilter/ EnsoSimpleDateFilter components
• refactored & improved date filter to handle more intervals

financials

• improved payment type filtering logic, to work better with internationalization
• improved client filter to work better when used together with local state loading

mixins

• fixes throwing unkown errors
• makes errorHandler more readable

permissions

• permission type was extracted to a dynamic computed property and the db table's column was dropped
• added mixin with the CSS class used for the different permission types

roles

• Configure.vue now uses the new @enso-io/checkbox functionality which was extracted to a distinct package that roles now depends on

search-mode (new)

• a new dependency package that permits switching between the different search modes (full, starts with, ends with)
• this new package is now utilized by select, typeahead and tables

select

• fixes the shouldDisableDropdown/dropdownDisabled computed property
• improves the reload handling
• added a searchLimit property, with the default value fo 10
• added the new search mode functionality (hidden by default)

quick-view (new)

• a new dependency package that contains the QuickView component, extracted from the accessories package
• the quick view default width was updated (is a little larger)

tables

• enhances support for highlighting rows
• fixes tr :key attribute

themes

• added an is-hoverable helper class

toastr

• added a when method that allows fluent syntax while having conditionals

tree-view (new)

• added new package for the TreeView component

typeahead

• fixed the display of the 'no results' message visible when there are no results available
• added ongoing request cancellation when multiple requests are made
• added the new search mode functionality (hidden by default)

ui

• fixed the shortNumber filter, so that it does not alter 0 as well negative numbers
• fixed an edge case in Enum.js
• removed the dashboard route and page from the ui package (were moved to the local project)
• menus related components refactor (has_children attribute usage changed to hasChildren)
• refactored toastr usage in Notifications.vue & fixed small bug when toaster level was not specified
• adds support for redirect after login
• fixes edge case where error was sometimes not thrown when using the the errorHandler
• updated Sentry integration, the RAVEN_DSN key is no longer required

back-end

The type attribute has been deprecated for structure migrations - all the packages with such migrations have been updated and have had the attribute removed.

Also, dependencies were updated as required.

action logger

• adds index on created_at column

avatars

• adds avatar resource

calendar

• refactors tests, adds validation for event destroy, updates validation for event, refactors frequency and sequence logic
• adds formatting for reccurence end date for parent event
• adds check for sequence break so it is no longer performed when not needed, if performing update on first event in the sequence
• renames update type enum labels
• fixes bugs

categories (new)

• added new package that handles product categories

cli

• removes deprecated permission Types from stubs

commercial

• refactors inCents to decimal, small changes due to refactor
• updates migrations
• client stocks supplier is now optional
• updates client stock import

companies

• adds new website attribute (nullable)

core

• updates for Laravel 7
• removes jessengers/date
• adds DB upgrade for permissions
• adds enso-aggregator to composer.json
• extracts upgrade logic in its own package
• update due to JsonParser to JsonReader rename
• adds companies upgrade command due to new website attribute
• updates failed jobs id to bigIncrements
• adds User & Grup resources
• refactors AppState to return resources

countries

• update due to JsonParser to JsonReader rename

data import

• fixes edge case for cells that need trimming
• fixes tests to work with the new UploadedFile
• returns array from template show / store controllers
• update due to JsonParser to JsonReader rename

discounts

• decimal discounts refactor

files

• adds a model helper to the facade
• refactors deprecated getClientSize and getClientMimeType in Files.php

filters (new)

• new package that can work in tandem with the front-end date filter component to generate date interval values for queries, graphs etc

forms

• update due to JsonParser to JsonReader rename

financials

• refactors inCents
• modifies computors
• fixes supplier payment factory
• various small updates: updates suppplier payment validator, adds return types for methods, adds typed properties, updates factories, updates tests
• reverted to explicit asserts

helpers

• JsonParser was renamed to JsonReader
• adds When helper trait

hr

• refactors inCents

inventory

• fixes manual transactions for persistent processes
• refactors inCents

localisation

• updates middleware to use Carbon instead of Jessengers\Date
• update due to JsonParser to JsonReader rename
• fixes typo in factory

menus

• adds a Menu resource
• updates tree builder to return collection

notifications

• fixes test to fit the new Carbon serialization for models

people

• adds person resource

permissions

• small fixes
• refactors type into computed property

products

• refactors inCents to decimal
• updates request validation by adding internal code unique rule

projects

• removes Types from migration

rememberable

• adds return null if id is null

roles

• refactors permission tree to work with permission computed type
• encapsulates config writing in model
• adds a role resource

select

• adds searchMode

services

• refactors inCents to decimal

tables

• fixes global button filtering
• uses getCountForPagination to fix count for queries that use group
• update due to JsonParser to JsonReader rename
• adds datetime support
• adds a dateTimeFormat config option

upgrade (new)

• new package, contains upgrade logic for your local project

Upgrade steps

• due to the upgrade to Laravel 7, there are quite a few small changes you have to do in your local project. Take a look at this commit and check the list of changes. You should ignore:
  • composer.lock
  • client/yarn.lock
  • .styleci.yaml
  • telescope and horizon assets (you will publish these in the next steps)
• you may safely remove the RAVEN_DSN key from your .env* files as it's no longer required
• update TelescopeServiceProvider using this as example
• update the sentry config file using this as example
• run composer update in the project's root
• run php artisan horizon:install
• run php artisan telescope:install
• edit client/package.json and
  • update @enso-ui/ui to 2.5.x
  • update pusher-js to ^5.0.0
• rename in your .env* files MAIL_DRIVER to MAIL_MAILER
• run yarn, yarn upgrade && yarn to ensure you have the latest versions and patches are applied. If necessary, update your patches
• update the Enso version to 3.9.0 in config/enso/config.php
• run php artisan vendor:publish --tag=select-config" to publish theselect.php` config
• note that the type attribute present in structure migrations has been deprecated and is no longer required - you may update your migrations, but it's not breaking if you leave it
• the database upgrade service has been refactored and extracted to its own package. If you have upgrade logic in your local project you may need to update it. You should use as an updated example the core upgrade here and here
• update config/cors.php if your project requires it
• update local factories
• find any local LaravelEnso\Helpers\App\Classes\JsonParser usages and update to LaravelEnso\Helpers\App\Classes\JsonReader
• note that for Permission, the name should be unique; update the factory, look here for example
• update App\Exceptions\Handler, use this as model
• make sure that in your composer.json you still have the following dependencies:
  • "doctrine/dbal": "^2.8",
  • "predis/predis": "^1.1"
• note that the vuex state structure is slightly changed. If you rely on the user's state in your front end components, make sure to update your logic according to the new User Resource format. Eg: replace this.$store.state.user.role_id with this.$store.state.user.role.id