1.7.0 Breaking Changes

[baris]

Please see the following issues for breaking changes to plugins and themes.

https://github.com/NodeBB/NodeBB/issues?q=is%3Aissue+label%3A"breaking+change+(plugins)"+milestone%3A1.7.0+is%3Aclosed
https://github.com/NodeBB/NodeBB/issues?q=is%3Aissue+milestone%3A1.7.0+label%3A"breaking+change+(themes)"+is%3Aclosed

If you have any plugins using any of those hooks/methods, please upgrade your plugin and add

"nbbpm": {
   "compatibility": "^1.7.0"
}

to your package.json.

[baris]

Please take a look at this issue https://github.com/NodeBB/NodeBB/issues/5804. If you have any plugins relying on getting user data that is not in the whitelist, you will have to use the new hook filter:user.whitelistFields and add the field name into the whitelist property. Here is a sample plugin function that adds a new field into the whitelist.

myPlugin.whitelistField = function (hookData, callback) {
    hookData.whitelist.push('myNewField');
    callback(null, hookData);
};

[baris]

Due to changes introduced to loading javascript assets in 1.7.0, using jquery in widgets requires waiting for the page load event.

Sample widget for 1.7.0+

if (window.jQuery) {
    doStuffThatUsesJquery();
} else {
    window.addEventListener('load',  doStuffThatUsesJquery);
}