1.11.0 Breaking Changes

[baris]

We are dropping support for NodeJS v6.x in 1.11.0.

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

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

If you have plugins that are affected, please update your plugin and add the below to your package.json

"nbbpm": {
   "compatibility": "^1.11.0"
}

[baris]

Groups.join takes an array of groupNames
https://github.com/NodeBB/NodeBB/pull/6834

[baris]

remove filter:post.getPostData and filter:post.getPostsData · Issue #6850 · NodeBB/NodeBB

use filter:post.getFields instead

GitHub (github.com)

[baris]

remove deprecated methods · Issue #6851 · NodeBB/NodeBB

GitHub (github.com)

[baris]

remove deprecated routes, use /assets routes · Issue #6852 · NodeBB/NodeBB

GitHub (github.com)

[julian]

Theme changes required:

NodeBB/NodeBB#6849 / NodeBB/NodeBB#6841

[baris]

action:group.destroy replaced with action:groups.destroy.

plugins.fireHook('action:groups.destroy', { groups: groupsData });

[baris]

/user/__self__/* removed please use /me/* For example to have a link in the nav bar to the users bookmarks use `/me/bookmarks/ as the navigation route.

[Michael Pfaff]

Hi guys. What do I need to upgrade my NodeJS to before upgrading NodeBB? Sorry, kind of a noob.

[PitaJ]

@Michael-Pfaff you need at least Node 8, but I recommend Node 10, as it's the latest LTS

[Michael Pfaff]

@PitaJ said in 1.11.0 Breaking Changes:

@Michael-Pfaff you need at least Node 8, but I recommend Node 10, as it's the latest LTS

Great, thanks. I feel like last time I upgraded Node it broke NodeBB, so it's been a while. I'll upgrade to 10.

[Normando]

Sorry for post here. We have a lot of plugins that now are breaked in v1.11.0. Because plugins authors delay to fix them, can help me to do a dirty fix to these? I knows JS and nodeJS. But no knows internals of NodeBB plugins architecture. These are the errors

2018-12-04T07:23:19.503Z [8888] - warn: [plugins/require] Cannot find module './topics', please update your plugin!
2018-12-04T07:23:19.503Z [8889] - warn: [plugins/require] Cannot find module './topics', please update your plugin!
    at /opt/vapor/nodebb/node_modules/nodebb-plugin-highlights/library.js:7:29
    at /opt/vapor/nodebb/node_modules/nodebb-plugin-highlights/library.js:7:29
2018-12-04T07:23:19.503Z [8889] - warn: [plugins/require] Cannot find module './user', please update your plugin!
    at /opt/vapor/nodebb/node_modules/nodebb-plugin-highlights/library.js:8:25
2018-12-04T07:23:19.504Z [8888] - warn: [plugins/require] Cannot find module './user', please update your plugin!
    at /opt/vapor/nodebb/node_modules/nodebb-plugin-highlights/library.js:8:25
2018-12-04T07:23:19.589Z [8889] - warn: [plugins/require] Cannot find module './settings', please update your plugin!
    at /opt/vapor/nodebb/node_modules/nodebb-plugin-imgbed/library.js:9:32
2018-12-04T07:23:19.589Z [8889] - warn: [plugins/require] Cannot find module './posts/cache', please update your plugin!
    at /opt/vapor/nodebb/node_modules/nodebb-plugin-imgbed/library.js:10:29
2018-12-04T07:23:19.590Z [8889] - warn: [plugins/require] Cannot find module './socket.io/admin', please update your plugin!
    at /opt/vapor/nodebb/node_modules/nodebb-plugin-imgbed/library.js:11:35
2018-12-04T07:23:19.598Z [8888] - warn: [plugins/require] Cannot find module './settings', please update your plugin!
    at /opt/vapor/nodebb/node_modules/nodebb-plugin-imgbed/library.js:9:32
2018-12-04T07:23:19.598Z [8888] - warn: [plugins/require] Cannot find module './posts/cache', please update your plugin!
    at /opt/vapor/nodebb/node_modules/nodebb-plugin-imgbed/library.js:10:29
2018-12-04T07:23:19.599Z [8888] - warn: [plugins/require] Cannot find module './socket.io/admin', please update your plugin!
    at /opt/vapor/nodebb/node_modules/nodebb-plugin-imgbed/library.js:11:35
2018-12-04T07:23:19.621Z [8888] - warn: [plugins/require] Cannot find module './posts/cache', please update your plugin!
2018-12-04T07:23:19.621Z [8889] - warn: [plugins/require] Cannot find module './posts/cache', please update your plugin!
    at Object.<anonymous> (/opt/vapor/nodebb/node_modules/nodebb-plugin-iframely/library.js:11:31)
    at Object.<anonymous> (/opt/vapor/nodebb/node_modules/nodebb-plugin-iframely/library.js:11:31)

2018-12-04T07:23:20.177Z [8888] - warn: [plugins/load] The following plugins may not be compatible with your version of NodeBB. This may cause unintended behaviour or crashing. In the event of an unresponsive NodeBB caused by this plugin, run `./nodebb reset -p PLUGINNAME` to disable it.
  * nodebb-theme-va

2018-12-04T07:23:20.232Z [8888] - warn: [plugins/require] Cannot find module './database', please update your plugin!
    at Object.YoutubeLite.init [as method] (/opt/vapor/nodebb/node_modules/nodebb-plugin-youtube-embed/library.js:20:22)
2018-12-04T07:23:20.232Z [8889] - warn: [plugins/require] Cannot find module './database', please update your plugin!
    at Object.YoutubeLite.init [as method] (/opt/vapor/nodebb/node_modules/nodebb-plugin-youtube-embed/library.js:20:22)

Thank you so much. Really we need these plugins.

[baris]

Those are just warnings the plugins should still work, I am sending PRs to those plugins to fix the warnings.

[faizanzahid]

@baris thabks alot , we r waiting for new version of node bb with plugins compatibility before we di update coz we r using many plugins which might break.

@fais3000

[PitaJ]

@faizanzahid the current version of NodeBB still has compatibility with those plugins. Future version will not.