Django cradmin 3.0.0 releasenotes

Note

This release marks the end of long lasting major releases. From now on we will release a major release when adding anything major, or when introducing any changes that require some kind of manual or dangerous update of existing projects.

Whats new

  • Add a new set of icon mixins and standard icons. Font-awesome is implemented as the default, but adding other icon sets is fairly easy. This is documented in Creating a custom theme.
  • Update the javascript with the new icon css classes.

Note

There is no changes to the Python code, only so the theme .scss and javascript files.

Migrate from 2.x to 3.x

Update .scss files

After updating to 3.x, your custom themes will break. You will need to update so that you include @import 'basetheme/3__base/cricon/cricon-font-awesome'; before @import 'basetheme/3__base/all';.

So if you had the following with cradmin 2.x:

@import 'basetheme/1__settings/all';
@import '1__settings/all';

@import 'basetheme/2__generic/all';
@import '2__generic/all';

@import 'basetheme/3__base/all';
@import '3__base/all';

@import 'basetheme/4__components/all';
@import '4__components/all';

You will have the following with 3.x+:

@import 'autogenerated_partials/variables';
@import 'basetheme/1__settings/all';
@import '1__settings/all';

@import 'basetheme/2__generic/all';
@import '2__generic/all';

@import 'basetheme/3__base/cricon/cricon-font-awesome';  // This line is new!
@import 'basetheme/3__base/all';
@import '3__base/all';

@import 'basetheme/4__components/all';
@import '4__components/all';

Furthermore, if you have a custom $font-size variable you need to ensure you have all the required sizes in the map:

  • xxsmall
  • xsmall
  • small
  • medium
  • large
  • xlarge
  • xxlarge
  • xxxlarge
  • smallcaps

Update javascript

You need to update your package.json to have “django_cradmin_js”: “^3.0.0” as a requirement.