provide the submodule plugin option 'mediator' to use a custom mediator

plugins/README.md

@@ -245,9 +245,10 @@ core.register("parent", function(sandbox){
 
 // register the submodule plugin
 core.use(scaleApp.plugins.submodule, {
-  inherit: true,          // use all plugins from the parent's Core
-  use: [somePlugins],     // use some additional plugins
-  useGlobalMediator: true // emit and receive all events from the parent's Core
+  inherit: true,             // use all plugins from the parent's Core
+  use: [somePlugins],        // use some additional plugins
+  useGlobalMediator: true,   // emit and receive all events from the parent's Core
+  mediator: myCustomMediator // 'useGlobalMediator' has to be falsy
 });
 
 core.start("parent");

plugins/spec/scaleApp.submodule.spec.coffee

@@ -123,6 +123,27 @@ describe "submodule plugin", ->
     @core.permission.add "parent", "on", "to parent"
     @core.start "parent"
 
+  it "provides an option to use the custom mediator", (done) ->
+
+    mySubModule = (sb) -> init: -> sb.emit "x", "z"
+
+    mediator = new @scaleApp.Mediator
+
+    mediator.on "x", (y) ->
+      (expect y).to.eql "z"
+      done()
+
+    myModule = (sb) ->
+      init: ->
+        sb.sub.register "sub", mySubModule
+        sb.sub.start "sub"
+    core = new @scaleApp.Core
+    core
+      .use(@plugin, {mediator: mediator})
+      .boot()
+      .register("parent", myModule)
+      .start "parent"
+
   it "provides an option to use the global mediator", (done) ->
 
     mySubModule = (sb) -> init: -> sb.emit "event", "hello"

plugins/src/scaleApp.submodule.coffee

@@ -22,6 +22,9 @@ plugin = (core, options={}) ->
     if options.useGlobalMediator
       core._mediator.installTo subCore._mediator, true
 
+    else if options.mediator?
+      options.mediator?.installTo? subCore._mediator, true
+
     # make sure that plugins do not modify the original
     # Sandbox class.
     subCore.Sandbox = class SubSandbox extends core.Sandbox