Add canFire option

README.md

@@ -83,6 +83,7 @@ Ouibounce offers a few options, such as:
 - [Timer](#set-a-min-time-before-ouibounce-fires)
 - [Delay](#delay)
 - [Callback](#callback)
+- [CanFire](#canFire)
 - [Cookie expiration](#cookie-expiration)
 - [Cookie domain](#cookie-domain)
 - [Cookie name](#cookie-name)
@@ -133,6 +134,15 @@ _Example:_
 ouibounce(document.getElementById('ouibounce-modal'), { callback: function() { console.log('Ouibounce fired!'); } });
 ```
 
+##### Canfire
+You can add a callback with the `canFire` option, which will check if Ouibounce can be triggered.
+By default, this callback returns true;
+
+_Example:_    
+```js
+ouibounce(document.getElementById('ouibounce-modal'), { canFire: function() { console.log("Actually, I don't want to fire Ouibounce!"); return false; } });
+```
+
 ##### Cookie expiration
 Ouibounce sets a cookie by default to prevent the modal from appearing more than once per user. You can add a cookie expiration (in days) using `cookieExpire` to adjust the time period before the modal will appear again for a user. By default, the cookie will expire at the end of the session, which for most browsers is when the browser is closed entirely.
 

build/ouibounce.js

@@ -18,6 +18,7 @@ return function ouibounce(el, custom_config) {
     sensitivity  = setDefault(config.sensitivity, 20),
     timer        = setDefault(config.timer, 1000),
     delay        = setDefault(config.delay, 0),
+    canFire      = config.canFire || function() { return true; },
     callback     = config.callback || function() {},
     cookieExpire = setDefaultCookieExpire(config.cookieExpire) || '',
     cookieDomain = config.cookieDomain ? ';domain=' + config.cookieDomain : '',
@@ -94,7 +95,7 @@ return function ouibounce(el, custom_config) {
   // You can use ouibounce without passing an element
   // https://github.com/carlsednaoui/ouibounce/issues/30
   function fire() {
-    if (isDisabled()) { return; }
+    if (isDisabled() || !canFire()) { return; }
 
     if (el) { el.style.display = 'block'; }
 

source/ouibounce.js

@@ -6,6 +6,7 @@ function ouibounce(el, custom_config) {
     sensitivity  = setDefault(config.sensitivity, 20),
     timer        = setDefault(config.timer, 1000),
     delay        = setDefault(config.delay, 0),
+    canFire      = config.canFire || function() { return true; },
     callback     = config.callback || function() {},
     cookieExpire = setDefaultCookieExpire(config.cookieExpire) || '',
     cookieDomain = config.cookieDomain ? ';domain=' + config.cookieDomain : '',
@@ -82,7 +83,7 @@ function ouibounce(el, custom_config) {
   // You can use ouibounce without passing an element
   // https://github.com/carlsednaoui/ouibounce/issues/30
   function fire() {
-    if (isDisabled()) { return; }
+    if (isDisabled() || !canFire()) { return; }
 
     if (el) { el.style.display = 'block'; }