Thanks a lot for your support! HTML sanitizer is a good feature for me. It allows various built in HTML snippets to be available whereas does not expose users security issue. I'll give a try.

@pitaj Global widget is not what I want, as when user click some link inside the forum, the widget loads once again, that is not what I want. I need something like navigation bar.

As NodeBB is partially updated, I wonder if there is a container for a widget or <div> to run across the site. Navigation bar is an example, but there is no user-defined container available till present.

I met the problem, It is maybe not updating fileMap.json. I don't know how to fix it.

When I enable this plugin, I have the following problem:

jQuery.Deferred exception: $(...).unslider is not a function TypeError: $(...).unslider is not a function
    at http://localhost:1111/assets/nodebb.min.js?v=1lv3pl83i9m:1:445193
    at dispatch (http://localhost:1111/assets/nodebb.min.js?v=1lv3pl83i9m:1:46934)
    at g.handle (http://localhost:1111/assets/nodebb.min.js?v=1lv3pl83i9m:1:44855)
    at Object.trigger (http://localhost:1111/assets/nodebb.min.js?v=1lv3pl83i9m:1:76254)
    at http://localhost:1111/assets/nodebb.min.js?v=1lv3pl83i9m:1:76887
    at Function.each (http://localhost:1111/assets/nodebb.min.js?v=1lv3pl83i9m:1:5723)
    at x.fn.init.each (http://localhost:1111/assets/nodebb.min.js?v=1lv3pl83i9m:1:4313)
    at x.fn.init.trigger (http://localhost:1111/assets/nodebb.min.js?v=1lv3pl83i9m:1:76863)
    at Object.e.widgets.render (http://localhost:1111/assets/nodebb.min.js?v=1lv3pl83i9m:1:326728)
    at Object.ajaxify.end (http://localhost:1111/assets/nodebb.min.js?v=1lv3pl83i9m:1:319517) undefined
x.Deferred.exceptionHook @ jquery.js:3818
jquery.js:3827 Uncaught TypeError: $(...).unslider is not a function
    at client.js:2
    at dispatch (jquery.js:5183)
    at g.handle (jquery.js:4991)
    at Object.trigger (jquery.js:8249)
    at jquery.js:8327
    at Function.each (jquery.js:354)
    at x.fn.init.each (jquery.js:189)
    at x.fn.init.trigger (jquery.js:8326)
    at Object.e.widgets.render (widgets.js:61)
    at Object.ajaxify.end (ajaxify.js:213)

Then it points to the following code:

Who do better? I am confused.

Hello, long time no visit this site. Recently I updated my forum to 1.7.3, but gets error on ./nodebb upgrade. Here is the output:

/node_modules/semver/semver.js:293
    throw new TypeError('Invalid Version: ' + version);
    ^

TypeError: Invalid Version: upgrades

more sensitive data omitted

It seems the new version of code has problem.

Is there any hook to perform custom steps, I need to change some text in .tpl file. I am using sed command to perform replacement, this step need to be placed before "nodebb build", and another replacement using sed need to be placed after "nodebb build". So I need the hooks, or is there any way to modify source code to get the same results? Thanks in advance.

I am totally get confused by the output message:

winston.warn('[widgets.render] passing a string is deprecated!, filter:widget.render:' + widget.widget + '. Please set hookData.html in your plugin.');

There isn't any full example showing the correct way to code.
So I turn the forum for help, is there any people who could give me an example showing how to let the warning not showing?

Hope the guys be more professional.

As the above implies, using 3rdparties image host services could help.

You can wait until document is loaded, so async in this situation is not suitable.

Why you still use async way? waiting the document to be ready is needed.

My plugin uses filter:widget.render hook, and recently when I upgrade my forum, the warning shows I need to set hookData.html. Is there any documentation about this? Thanks in advance.

Sorry, it seems that git tags does not shipped with code. So downloaded tags are not completed, when I tappedgit tag command.
However github has its completed tags.
See this link: https://github.com/NodeBB/NodeBB/compare?expand=1

There is some problems on regarding to socket.io, so I need to revert code to see the changes between previous version and the latest, but unfortunately, NodeBB officials does not provide such tags since 1.2.2? I want to know how could I get previous stable version of forum code when possible?

I'm using Qt as our client program to chat with friend within our forum: qtdream.com
But, when I upgraded from 1.4.3 to 1.4.4, we encounter a problem on connect socket.io. the debug log shows:

socket close with reason: {"description":"network error: 302https://qtdream.com/socket.io/?EIO=3&t=5ZGo5Li&transport=polling","type":"TransportError"}

I have been stuck with it for over 3 days, is there any solutions to resolve that? Thanks in advance.

Asset system would be somewhat difficult to understand at the first glance, because we could not the details inside instead given the unused warning. I hope the warning and incompatibilities will be fixed somewhere in the future.

Moreover, is the "upload_path" in config.json bug fully fixed and applicable in newly version on NodeBB?

@PitaJ How many times will // Some code be executed if they are not inside $(document).ready? I know // Some code will be executed once inside $(document).ready.

Another question, which will be executed first? the code inside $(document).ready or the one outside?

Hello everyone.
I'm writing a plugin for NodeBB. and some questions arises.

1. I see many plugins have client.js, the purpose of writing this script is to put a short script which will run as soon as this component is loaded. Is it the true purpose of this file?

2. in client.js, we could see

$(document).ready(function() {
// Some code
}

example from nodebb-plugin-markdown

But we could see another version which does not use this wrap instead expose those statements in global scope.
The question is, which version is better or is recommended?

Thanks in advance!