Upgrading Portal Libraries

Titania Delivery portal themes rely on front end libraries, which may need to be updated periodically to comply with security standards or enable new features.

Upgrading Bootstrap 4.x to 4.y

Note: Some older themes may use bootstrap version 3.x. These instructions do not apply to those themes. Upgrading from bootstrap 3.x to 4.x requires more extensive changes to the theme.
Note: These instructions apply to themes built from, or modeled after, baseline themes supplied with the Titania Delivery platform. They may not apply to customized themes. Experienced theme developers may choose to implement the upgrade differently.
  1. Download the source files for the desired 4.y bootstrap release corresponding to the theme. Example link : https://getbootstrap.com/docs/4.5/getting-started/download/
    Note: Some older themes may still use bootstrap 3, always check the file in the theme.

    Titania uses the sass files and minified bootstrap.min.js from this download. In the downloaded source files, the minified javascript file is located at [bootstrapRoot]/dist/js. The sass files are located in [bootstrapRoot]/scss for bootstrap 4.

  2. Titania themes typically store the minified boostrap javascript under [themeRoot]/static/scripts/lib/bootstrap. Copy the minified javascript and license into the folder.
  3. Delete the bootstrap sass files in the Titania theme. These are typically located in [themeRoot]/static/style/bootstrapx.x.x.
  4. Create a new folder with the correct version number and copy the new sass into it.
  5. Edit static/style/common/_bootstrap-config.scss to update each file reference to the proper path/version.
    Note: The bootstrap.min.js filename did not change, so existing references to that file in the theme will work as before.