Merge pull request #3195 from ether/feature/new_hook_when_pad_is_copied

[feat] New server-side hook: padCopy

doc/api/hooks_server-side.md

@@ -106,7 +106,7 @@ Here you can add custom toolbar items that will be available in the toolbar conf
 
 Usage examples:
 
-* [https://github.com/tiblu/ep_authorship_toggle]()
+* https://github.com/tiblu/ep_authorship_toggle
 
 ## padCreate
 Called from: src/node/db/Pad.js
@@ -137,6 +137,20 @@ Things in context:
 
 This hook gets called when an existing pad was updated.
 
+## padCopy
+Called from: src/node/db/Pad.js
+
+Things in context:
+
+1. originalPad - the source pad instance
+2. destinationID - the id of the pad copied from originalPad
+
+This hook gets called when an existing pad was copied.
+
+Usage examples:
+
+* https://github.com/ether/ep_comments
+
 ## padRemove
 Called from: src/node/db/Pad.js
 
@@ -146,6 +160,10 @@ Things in context:
 
 This hook gets called when an existing pad was removed/deleted.
 
+Usage examples:
+
+* https://github.com/ether/ep_comments
+
 ## socketio
 Called from: src/node/hooks/express/socketio.js
 

src/node/db/Pad.js

@@ -592,6 +592,11 @@ Pad.prototype.copy = function copy(destinationID, force, callback) {
       setTimeout(function(){
         padManager.getPad(destinationID, null, callback) // this runs too early.
       },10);
+    },
+    // let the plugins know the pad was copied
+    function(callback) {
+      hooks.callAll('padCopy', { 'originalPad': _this, 'destinationID': destinationID });
+      callback();
     }
   // series
   ], function(err)