From 9f56d61305fd33e6f8f0e6ef443614b567655468 Mon Sep 17 00:00:00 2001
From: Robin Ward <robin.ward@gmail.com>
Date: Wed, 17 Feb 2016 12:19:07 -0500
Subject: [PATCH] Backported PluginAPI for compatibility with plugins

---
 .../discourse/lib/plugin-api.js.es6           | 27 +++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/app/assets/javascripts/discourse/lib/plugin-api.js.es6 b/app/assets/javascripts/discourse/lib/plugin-api.js.es6
index 5008c963e2..f6c58bf9d8 100644
--- a/app/assets/javascripts/discourse/lib/plugin-api.js.es6
+++ b/app/assets/javascripts/discourse/lib/plugin-api.js.es6
@@ -14,3 +14,30 @@ export function decorateCooked(container, cb) {
   decorate(container.lookupFactory('view:embedded-post'), 'didInsertElement', cb);
   decorate(container.lookupFactory('view:user-stream'), 'didInsertElement', cb);
 }
+
+// This is backported so plugins in the new format will not raise errors
+//
+// To upgrade your plugin for backwards compatibility, you can add code in this
+// form:
+//
+//   function newApiCode(api) {
+//     // api.xyz();
+//   }
+//
+//   function oldCode() {
+//     // your pre-PluginAPI code goes here. You will be able to delete this
+//     // code once the `PluginAPI` has been rolled out to all versions of
+//     // Discourse you want to support.
+//   }
+//
+//   // `newApiCode` will use API version 0.1, if no API support then
+//   // `oldCode` will be called
+//   withPluginApi('0.1', newApiCode, { noApi: oldCode });
+//
+export function withPluginApi(version, apiCodeCallback, opts) {
+  console.warn(`Plugin API v${version} is not supported`);
+
+  if (opts && opts.noApi) {
+    return opts.noApi();
+  }
+}