strapi/docs/3.0.0-beta.x/migration-guide/migration-guide-beta.18-to-beta.19.md
soupette 9dec284470 Update migration guide
Signed-off-by: soupette <cyril.lpz@gmail.com>
2020-03-04 17:39:40 +01:00

2.1 KiB

Migration guide from beta.18.x to beta.19

Upgrading your Strapi application to v3.0.0-beta.19.

Make sure your server is not running until then end of the migration

Upgrading your dependencies

Start by upgrading your dependencies. Make sure to use exact versions.

Update your package.json accordingly:

{
  //...
  "dependencies": {
    "strapi": "3.0.0-beta.19",
    "strapi-admin": "3.0.0-beta.19",
    "strapi-connector-bookshelf": "3.0.0-beta.19",
    "strapi-plugin-content-manager": "3.0.0-beta.19",
    "strapi-plugin-content-type-builder": "3.0.0-beta.19",
    "strapi-plugin-email": "3.0.0-beta.19",
    "strapi-plugin-graphql": "3.0.0-beta.19",
    "strapi-plugin-upload": "3.0.0-beta.19",
    "strapi-plugin-users-permissions": "3.0.0-beta.19",
    "strapi-utils": "3.0.0-beta.19"
  }
}

Then run either yarn install or npm install.

Policies syntax change

We decided to change the policies naming convention to match with the future naming convetion we will be using throughout the project.

Before

  • Global policy: global.{policy}.
  • Plugin policy: plugins.{pluginName}.{policy}.

After

  • Global policy: global::{policy}.
  • Plugin policy: plugins::{pluginName}.{policy}.

We are also introductin application naming so you can access an api policy easily or reference it absolutely when the context doesn't allow forto find out directly.

You can now reference a policy located at ./api/{apiName}/config/policies/{policy} with the following syntax: {apiName}.{policy}.

Although we do not recommend it (error prone), you can still access a local policy with the syntax {policy} . This syntax will only allow access to a policy declared in the api you are referencing it from. (e.g, polici in restaurant api and route in restaurant api only).

Rebuilding your administration panel

Now delete the .cache and build folders. Then run yarn develop.

::: warning NOTE

If you have modified the admin/src/config.js file you need to update its content with:

export const LOGIN_LOGO = null;
export const SHOW_TUTORIALS = false;
export const SETTINGS_BASE_URL = '/settings';

:::