2.0 Compatible Plugins

<baris>

We will release 2.0 I am going to keep a list of plugins here that are compatible already. If you have any plugins that are not in this list let us know and we will try to get them updated before release.

The migration guide is here.

Bundled plugins

nodebb-plugin-2factor
nodebb-plugin-composer-default
nodebb-plugin-dbsearch
nodebb-plugin-emoji
nodebb-plugin-emoji-android
nodebb-plugin-markdown
nodebb-plugin-mentions
nodebb-plugin-spam-be-gone
nodebb-rewards-essentials
nodebb-theme-lavender
nodebb-theme-persona
nodebb-theme-slick
nodebb-theme-vanilla
nodebb-widget-essentials

Other plugins

nodebb-plugin-adsense
nodebb-plugin-audio-embed
nodebb-plugin-blog-comments
nodebb-plugin-browsing-users
nodebb-plugin-calendar
nodebb-plugin-canned-responses
nodebb-plugin-cards
nodebb-plugin-custom-pages
nodebb-plugin-customize
nodebb-plugin-category-notifications
nodebb-plugin-dwnvtr
nodebb-plugin-emailer-sendgrid
nodebb-plugin-emoji-one
nodebb-plugin-extended-markdown
nodebb-plugin-feed
nodebb-plugin-github-embed
nodebb-plugin-glossary
nodebb-plugin-google-analytics
nodebb-plugin-hashtags
nodebb-plugin-iframely
nodebb-plugin-image-mentions
nodebb-plugin-imgur
nodebb-plugin-knowledge-base
nodebb-plugin-link-mentions
nodebb-plugin-mega-colors
nodebb-plugin-night-mode
nodebb-plugin-osm-map
nodebb-plugin-poll
nodebb-plugin-private-forum
nodebb-plugin-question-and-answer
nodebb-plugin-quickstart
nodebb-plugin-recent-cards
nodebb-plugin-registration-question
nodebb-plugin-rss
nodebb-plugin-session-sharing
nodebb-plugin-shoutbox
nodebb-plugin-soundpack-default
nodebb-plugin-sso-facebook
nodebb-plugin-sso-github
nodebb-plugin-sso-google
nodebb-plugin-sso-twitter
nodebb-plugin-tenor-gif
nodebb-plugin-twitter
nodebb-plugin-two-way-block
nodebb-plugin-undelete-users
nodebb-plugin-user-levels

crazycells

thanks @baris , we have many that are not on the list yet...

scared

alphabetically...

~~nodebb-plugin-audio-embed~~
~~nodebb-plugin-calendar~~
~~nodebb-plugin-cards~~
~~nodebb-plugin-customize~~
~~nodebb-plugin-dwnvtr~~
nodebb-plugin-email-blacklist
nodebb-plugin-embed
~~nodebb-plugin-emoji-one~~
~~nodebb-plugin-extended-markdown~~
~~nodebb-plugin-hashtags~~
~~nodebb-plugin-image-mentions~~
~~nodebb-plugin-knowledge-base~~
~~nodebb-plugin-night-mode~~
nodebb-plugin-osm-map
~~nodebb-plugin-poll~~
~~nodebb-plugin-private-forum~~
nodebb-plugin-session-sharing
~~nodebb-plugin-shoutbox~~
~~nodebb-plugin-twitter~~
~~nodebb-plugin-two-way-block~~

<baris>

@crazycells Updated most of these plugins and the list in the main post.

nodebb-plugin-email-blacklist doesn't work due to the changeds to registration and email being optional.
nodebb-plugin-embed which fork are you using for this?

Remaining
nodebb-plugin-osm-map
nodebb-plugin-session-sharing

yariplus

Naisu!

crazycells

@baris thanks! crossed out the updated ones...

embed plugin is this one:
https://github.com/TheWorms/nodebb-plugin-embed

I missed this plugin:

~~nodebb-plugin-soundpack-default~~

And these four are in our development, we are planning to use them soon:

~~nodebb-plugin-undelete-users~~
https://github.com/NodeBB/nodebb-plugin-undelete-users
nodebb-plugin-makesmart-gallery
https://github.com/me-cooper/nodebb-plugin-makesmart-gallery
nodebb-plugin-btn-spoilers
https://github.com/boydaihungst/nodebb-plugin-btn-spoilers
nodebb-plugin-contact-page
https://github.com/MinecraftForgeFrance/nodebb-plugin-contact-page

And finally;

~~nodebb-plugin-mega-colors~~

actually since we have switched to extended-markdown , we do not use mega-colors anymore; but I thought it might be useful for others.

phit

I got a couple that we will definitely need on 2.0, really mostly all by @yariplus

GitHub - yariplus/nodebb-plugin-featured-topics-extended: Adds a customisable news/blog page and some widgets using featured topics.

Adds a customisable news/blog page and some widgets using featured topics. - yariplus/nodebb-plugin-featured-topics-extended

GitHub (github.com)

GitHub - yariplus/nodebb-plugin-newsletter: Send an email newsletter to all users or a group of users.

Send an email newsletter to all users or a group of users. - yariplus/nodebb-plugin-newsletter

GitHub (github.com)

https://github.com/yariplus/nodebb-widget-game-server-query

https://github.com/psychobunny/nodebb-plugin-secure-images

yariplus

@phit You got it boss!

julian

@yariplus If you run into a breaking change we didn't account for in the Migration Guide, please let us know!

yariplus

@julian

Not really a breaking change (yet), but the module definitions in plugin.json are kinda, odd...

I would expect the key to be the module name, but it's actually the filename. That makes sense in RJS world, where the file name needs to end in .js, but not so much in plugin.json world. You end up with this weirdness:
https://github.com/NodeBB/NodeBB/blob/master/src/meta/js.js#L90-L113

Where you could just use the module name and add the .js in the build step:
https://github.com/NodeBB/NodeBB/blob/master/src/meta/js.js#L178

destPath: path.join(__dirname, '../../build/public/src/modules', relPath + ".js"),

It would make this more readable too since both the json and js would use the string 'jquery'.
https://docs.nodebb.org/development/plugins/libraries/

Yes, I am very nit-picky.

julian

@yariplus That's good feedback, and yes, it is an unfortunate artefact of our RJS implementation.

I even remember the headspace I was in that day... I had implemented the modules logic and my brain was basically scrambled egg at that point, since for whatever reason I can never wrap my head around module loaders. I ended up with an implementation that worked, and called it quits. That's likely why the key is a relative path, simply appended to the base directory (and resolved if needed, to get rid of ../, etc.), and ends in js. They're symlinks, and so I needed to build an absolute path out of them.

Webpack upends this behaviour, so it's no longer necessary, so it's something we can consider. If anything, we can just make the .js suffix optional, and check for .js and .min.js if no extension is passed in.

julian

Out of the top 30 plugins requested via nbbpm, the following are not in the list at top:

nodebb-plugin-category-notifications (@baris done)
nodebb-plugin-embed (which @crazycells mentioned above)
nodebb-plugin-discord-notification (
https://github.com/amargon/nodebb-plugin-discord-notification/pull/12)
nodebb-plugin-emoji-apple
nodebb-plugin-adsense (@baris done)

<baris>

nodebb-plugin-category-notifications should work, added to list.

julian

@baris said in 2.0 Compatible Plugins:

Remaining
nodebb-plugin-osm-map
nodebb-plugin-session-sharing

Done, list updated.

DownPW

maybe this :

https://github.com/dealbee/nodebb-plugin-user-level

<baris>

@DownPW Forked that plugin here https://github.com/NodeBB-Community/nodebb-plugin-user-level. Will update for 2.0

phenomlab

This one by @exodo would be fantastic
https://github.com/exo-do/nodebb-plugin-reputation-rules

phenomlab

@baris There seems to be an error in nodebb-plugin-polls as below

2022-03-08T17:38:48.973Z [4567/50454] - error: [build]          requirejs modules  build failed
2022-03-08T17:38:48.973Z [4567/50454] - error: [build] Encountered error during build step
Error: ENOENT: no such file or directory, stat '/home/sudonix/nodebb/node_modules/nodebb-plugin-poll/vendor/dayjs.min.js'
2022-03-08T17:38:48.973Z [4567/50454] - error: admin.reload
Error: ENOENT: no such file or directory, stat '/home/sudonix/nodebb/node_modules/nodebb-plugin-poll/vendor/dayjs.min.js'

<baris>

@phenomlab Is the file in that folder?

phenomlab

@baris Well, I've since rebuilt and restarted and now the error doesn't appear anymore so possibly a red herring. Sorry

yariplus

Is there a branch we can test against?