22d93bc43a
- allows passing of template data to the plugin-outlet to be rendered if no plugin is using that slot - acts as a fallback when no plugin is found - allows wrapping of existing features inside a plugin-outlet that then plugins can overwrite with their own behaviour - backwards compatible - uses invisible emberviews (as Ember.Component does) - the template has full-access to the controller and view, should be totally transparent
98 lines
2.7 KiB
JavaScript
98 lines
2.7 KiB
JavaScript
/**
|
|
A plugin outlet is an extension point for templates where other templates can
|
|
be inserted by plugins.
|
|
|
|
If you handlebars template has:
|
|
|
|
```handlebars
|
|
{{plugin-outlet "evil-trout"}}
|
|
```
|
|
|
|
Then any handlebars files you create in the `connectors/evil-trout` directory
|
|
will automatically be appended. For example:
|
|
|
|
plugins/hello/assets/javascripts/discourse/templates/connectors/evil-trout/hello.handlebars
|
|
|
|
With the contents:
|
|
|
|
```handlebars
|
|
<b>Hello World</b>
|
|
```
|
|
|
|
Will insert <b>Hello World</b> at that point in the template.
|
|
|
|
Optionally you can also define a view class for the outlet as:
|
|
|
|
plugins/hello/assets/javascripts/discourse/views/connectors/evil-trout/hello.js.es6
|
|
|
|
And it will be wired up automatically.
|
|
|
|
**/
|
|
|
|
var _connectorCache;
|
|
|
|
function findOutlets(collection, callback) {
|
|
Ember.keys(collection).forEach(function(i) {
|
|
if (i.indexOf("/connectors/") !== -1) {
|
|
var segments = i.split("/"),
|
|
outletName = segments[segments.length-2],
|
|
uniqueName = segments[segments.length-1];
|
|
|
|
callback(outletName, i, uniqueName);
|
|
}
|
|
});
|
|
}
|
|
|
|
function buildConnectorCache() {
|
|
_connectorCache = {};
|
|
|
|
var uniqueViews = {};
|
|
findOutlets(requirejs._eak_seen, function(outletName, idx, uniqueName) {
|
|
_connectorCache[outletName] = _connectorCache[outletName] || [];
|
|
|
|
var viewClass = require(idx, null, null, true).default;
|
|
uniqueViews[uniqueName] = viewClass;
|
|
_connectorCache[outletName].pushObject(viewClass);
|
|
});
|
|
|
|
findOutlets(Ember.TEMPLATES, function(outletName, idx, uniqueName) {
|
|
_connectorCache[outletName] = _connectorCache[outletName] || [];
|
|
|
|
var mixin = {templateName: idx.replace('javascripts/', '')},
|
|
viewClass = uniqueViews[uniqueName];
|
|
|
|
if (viewClass) {
|
|
// We are going to add it back with the proper template
|
|
_connectorCache[outletName].removeObject(viewClass);
|
|
} else {
|
|
viewClass = Em.View;
|
|
}
|
|
_connectorCache[outletName].pushObject(viewClass.extend(mixin));
|
|
});
|
|
|
|
}
|
|
|
|
export default function(connectionName, options) {
|
|
if (!_connectorCache) { buildConnectorCache(); }
|
|
|
|
var self = this;
|
|
if (_connectorCache[connectionName]) {
|
|
var CustomContainerView = Ember.ContainerView.extend({
|
|
childViews: _connectorCache[connectionName].map(function(vc) {
|
|
return vc.create({context: self});
|
|
})
|
|
});
|
|
return Ember.Handlebars.helpers.view.call(this, CustomContainerView, options);
|
|
} else {
|
|
return Ember.Handlebars.helpers.view.call(this,
|
|
Ember.View.extend({
|
|
isVirtual: true,
|
|
tagName: '',
|
|
template: function() {
|
|
return options.hash.template;
|
|
}.property()
|
|
}),
|
|
options);
|
|
}
|
|
}
|