How to Take Care of Non-free Libraries on the Kintone CDN

Contents

Overview

As of February 28th 2022, the Kintone CDN no longer hosts non-free versions of jqGrid and Handsontable. This article will guide you on the actions to take, if the library versions above are being used in your domain.

Libraries that will not be Hosted

  • Handsontable：Versions 7.0.0 and onwards Handsontable：Versions 7.0.0 and onwards To check if your Kintone domain is using any of these libraries, follow the guide below:

  • How to Verify the Usage of the Kintone CDN

Actions to take for Kintone Customizations

If any of these libraries are being used in any Kintone customizations, please take one of the following actions:

If you will keep using the library, the following files will need to be updated.

Library name Files
jqGrid
  • jquery.jqGrid.min.js
  • grid.locale-en.js (or the locale you are using)
  • ui.jqgrid.css
Handsontable
  • handsontable.full.min.js
  • handsontable.full.min.css

Keep using the library by purchasing a license

Purchase a license for the library and replace the library file in the App's settings.

  1. Purchase a license and obtain the libraries
    • jqGrid: Purchase a license from the Guriddo website. Follow the instructions on their website to obtain the library files.
    • Handsontable: Purchase a license from the Handsontable website. Follow the instructions on their website to obtain the library files.
  2. Navigate to the App's "JavaScript and CSS Customization" settings. Remove the URL currently pointing to the Kintone CDN. Upload the obtained library file instead.

This is an example screenshot of what the "JavaScript and CSS Customization" settings may look like if this method is proceeded with jqGrid. Notice how the jqGrid files are no longer pointing towards the non-free versions hosted on the Kintone CDN. The library files (of which you purchased the license of) are uploaded instead.

Keep using the library by switching to a free version

Replace the library file in the App's settings with a free version of the library. You may find the free version on the Kintone CDN or on a different CDN service. You may also obtain the file from the owner's GitHub repository.

The free versions of the libraries are as follows:

  • jqGrid: Versions before (and not including) 4.7.1
  • Handsontable: Versions before (and not including) 7.0.0

  1. Obtain the URL to the free library from either the Kintone CDN or a different CDN service. You can also obtain the free library file from the owner's GitHub repository.

    For example:

    Library version Directions
    jqGrid 4.7.0
    1. Download "Source code(zip)" from https://github.com/tonytomov/jqGrid/releases/tag/v4.7.0 (External link)
    2. Extract the file, and obtain the files from the "js" and "css" directory.
    Handsontable 6.2.2
    1. Download "Source code(zip)" from https://github.com/handsontable/handsontable/releases/tag/6.2.2 (External link)
    2. Extract the file, and obtain the files from the "dist" folder.

  2. Navigate to the App's "JavaScript and CSS Customization" settings. Remove the URL currently pointing to the Kintone CDN. Upload the obtained library file instead.

This is an example screenshot of what the "JavaScript and CSS Customization" settings may look like if this method is proceeded with jqGrid. Notice how the jqGrid files are no longer pointing towards the non-free version hosted on the Kintone CDN. They are pointing to the free version hosted on the Kintone CDN instead.

Switching to a free version of the library will downgrade the library version. Depending on how the library is being used, some customizations may not function in the same way as before. Check that the customization works correctly after replacing the library files.

Stop using the library

Navigate to the App's "JavaScript and CSS Customization" settings. Remove the URL currently pointing to the Kintone CDN.

Actions to take for Kintone Plug-ins

If the libraries are being used from within a Kintone plug-in, take one of the following actions:

Keep using the library (free or non-free)

If the plug-in was developed by yourself, delete the library URL from the manifest file. Re-assign a URL or a file for the library by referring to the methods shown in the Actions to take for Kintone Customizations section.

If the plug-in was developed by a third party, contact the developer.

Stop using the library

You can stop using the library by disabling the plug-in (External link) in the App's settings. You can also delete the plug-in from the App's settings, or remove it from your Kintone domain.

Notes

Handsontable versions with patched vulnerabilities will not be hosted on the Kintone CDN. There is a free library similar to jqGrid called free-jqgrid. You may replace your current jqGrid library with this free library at your own responsibility.