#3388 adds unplaceable callback, fixes docs

RELEASE-NOTES.md

@@ -1,5 +1,11 @@
 ## RELEASE NOTES
 
+### Version 2.1.7 Nov 29, 2015
+
+**Bug Fixes**
+
+-**Popup** - Adds `onUnplaceable` callback when element cannot be place in visible screen
+
 ### Version 2.1.6 - Nov 6, 2015
 
 **Bug Fixes**

src/definitions/modules/popup.js

@@ -841,6 +841,7 @@ $.fn.popup = function(parameters) {
                   module.remove.attempts();
                   module.remove.loading();
                   module.reset();
+                  settings.onUnplaceable.call(element);
                   return false;
                 }
               }
@@ -1244,6 +1245,9 @@ $.fn.popup.settings = {
   // callback before hide animation
   onHide       : function(){},
 
+  // callback when popup cannot be positioned in visible screen
+  onUnplaceable: function(){},
+
   // callback after hide animation
   onHidden     : function(){},