A versioned API for client side plugins

[eviltrout (Robin Ward)]

@stevenpslade

Will you be updating the Beginner’s Guide to Creating Discourse Plugins?

It’s on my list to review it. I suspect most of the steps will stay the same but I will confirm.

@cpradio

previously I had initialize(container) so I could access siteSettings to enable/disable the showing of a toolbar button. In the new API, that seems to be via api.container, which is fine, but how do I do it with noApi?

You should use api.container in your new code, but you can just pass the container to your old code like this:

initialize(container) {
   withPluginApi('0.1', api => newCode(api), { noApi: () => oldCode(container) });
}

(I doubt I will ever remove container from initialize BTW. The api object just has it for convenience so you don’t have to pass it around).