One Hat Cyber Team

View File Name : hordecore.js

/**
 * hordecore.js - Horde core AJAX code.
 *
 * This file requires prototypejs v1.8.0+.
 *
 * Events fired:
 *   - HordeCore:ajaxException
 *   - HordeCore:ajaxFailure
 *   - HordeCore:doActionCompleteAfter (since 2.5.0)
 *   - HordeCore:doActionCompleteBefore (since 2.5.0)
 *   - HordeCore:runTasks
 *   - HordeCore:showNotifications
 *
 * @author     Michael Slusarz <slusarz@horde.org>
 * @copyright  2005-2015 Horde LLC
 * @license    LGPL-2.1 (http://www.horde.org/licenses/lgpl21)
 */

var HordeCore = {

    // Vars used and defaulting to null/false:
    //   Growler, audio, conf, inAjaxCallback, is_logout, regenerate_sid,
    //   submit_frame, text

    alarms: [],
    audios: [],
    handlers: {},
    jsfiles: [],
    cssfiles: [],
    loading: {},
    notify_handler: function(m) { HordeCore.showNotifications(m); },
    server_error: 0,
    submit_frame: [],

    doActionOpts: function()
    {
        return {
            evalJS: false,
            evalJSON: true,
            onException: this.onException.bind(this),
            onFailure: this.onFailure.bind(this)
        };
    },

    debug: function(label, e)
    {
        if (!this.is_logout && window.console && window.console.error) {
            window.console.error(label, Prototype.Browser.Gecko ? e : $H(e).inspect());
        }
    },

    onException: function(r, e)
    {
        this.debug('onException', e);
        if (r.opts) {
            this.endLoading(r.opts.loading);
        }
        document.fire('HordeCore:ajaxException', [ r, e ]);
    },

    onFailure: function(t, o)
    {
        this.debug('onFailure', t);
        if (t.request.opts) {
            this.endLoading(t.request.opts.loading);
        }
        this.notify(this.text.ajax_error, 'horde.error');
        document.fire('HordeCore:ajaxFailure', [ t, o ]);
    },

    // opts: (Object) ajaxopts, callback, loading, uri
    doAction: function(action, params, opts)
    {
        params = $H(params).clone();
        opts = opts || {};
        opts.ajaxopts = opts.ajaxopts || {};

        var ajaxopts = Object.extend(this.doActionOpts(), opts.ajaxopts),
            request;

        if (this.regenerate_sid) {
            ajaxopts.asynchronous = false;
            params.set('regenerate_sid', 1);
            delete this.regenerate_sid;
        }

        this.addRequestParams(params);

        ajaxopts.parameters = params;

        this.initLoading(opts.loading);

        ajaxopts.onSuccess = function(t) {
            if (Object.isFunction(opts.ajaxopts.onSuccess)) {
                opts.ajaxopts.onSuccess(t);
            }
            this.doActionComplete(action, t, opts);
        }.bind(this);

        request = new Ajax.Request(
            (opts.uri ? opts.uri : this.conf.URI_AJAX) + action,
            ajaxopts
        );
        request.action = action;
        request.opts = opts;

        return request;
    },

    // form: (Element) DOM Element (or DOM ID)
    // opts: (Object) ajaxopts, callback, loading
    submitForm: function(form, opts)
    {
        opts = opts || {};
        opts.ajaxopts = opts.ajaxopts || {};

        var ajaxopts = Object.extend(this.doActionOpts(), opts.ajaxopts);

        this.initLoading(opts.loading);

        ajaxopts.onSuccess = function(t) {
            if (Object.isFunction(opts.ajaxopts.onSuccess)) {
                opts.ajaxopts.onSuccess(t);
            }
            this.doActionComplete(form, t, opts);
        }.bind(this);
        ajaxopts.parameters = $H(ajaxopts.parameters || {});
        this.addRequestParams(ajaxopts.parameters);

        $(form).request(ajaxopts);
    },

    // Do a raw submit (non-AJAX).
    // form: (Element) DOM Element (or DOM ID)
    // opts: (Object) callback
    submit: function(form, opts)
    {
        form = $(form);
        opts = opts || {};

        var params = $H();

        this.addRequestParams(params);

        params.each(function(pair) {
            if (!form.down('INPUT[name=' + pair.key + ']')) {
                form.insert(new Element('INPUT', {
                    name: pair.key,
                    type: 'hidden'
                }).setValue(pair.value));
            }
        });

        if (opts.callback) {
            this.handleSubmit(form, {
                callback: opts.callback
            });
        }

        /* This adds both token and SID information to the URL also. Allows
         * recovery from failure server-side if max-POST limit is exceeded.
         * jsonhtml param indicates we want a text/html return for error
         * messages - otherwise, IE8 will download the incoming JSON
         * instead. */
        form.action = this.addURLParam(form.action, { jsonhtml: 1 });

        form.submit();
    },

    // @todo This should be handled entirely within submit()
    handleSubmit: function(form, opts)
    {
        form = $(form);
        opts = opts || {};

        var sf, fid = form.identify();

        if (!this.submit_frame[fid]) {
            sf = new Element('IFRAME', { name: 'submit_frame', src: 'javascript:false' }).hide();
            $(document.body).insert(sf);

            sf.observe('load', function(sf) {
                this.doActionComplete(form, {
                    responseJSON: (sf.contentDocument || sf.contentWindow.document).body.innerHTML.unescapeHTML().evalJSON(true)
                }, opts);
            }.bind(this, sf));

            this.submit_frame[fid] = sf;
        }

        form.writeAttribute('target', 'submit_frame');
    },

    // params: (Hash) URL parameters
    // @todo: Put internal params (SID, token, regenerate_sid) into special
    //        container only accessible to base Ajax Application object.
    addRequestParams: function(params)
    {
        var sid = this.sessionId();

        if (sid) {
            params.update(sid.toQueryParams());
        }
        params.set('token', this.conf.TOKEN);
    },

    sessionId: function(sid)
    {
        var conf = this.baseWindow().HordeCore.conf;

        if (conf.SID) {
            if (sid) {
                conf.SID = sid;
            }
            return conf.SID;
        }
    },

    // action = Action (string or DOM element if form submission)
    // resp = Ajax.Response object
    // opts = HordeCore options (callback, loading)
    doActionComplete: function(action, resp, opts)
    {
        this.inAjaxCallback = true;

        if (!resp.responseJSON) {
            if (++this.server_error == 3) {
                this.notify(this.text.ajax_timeout, 'horde.error');
            }
            if (resp.request) {
                resp.request.options.onFailure(resp, {});
            }
            this.endLoading(opts.loading);
            this.inAjaxCallback = false;
            return;
        }

        var r = resp.responseJSON, head;

        if (r.reload) {
            if (r.reload === true) {
                window.location.reload();
            } else {
                window.location.assign(r.reload);
            }
            return;
        }

        if (!r.msgs) {
            r.msgs = [];
        }

        if (this.server_error >= 3) {
            r.msgs.push({
                message: this.text.ajax_recover,
                type: 'horde.success'
            });
        }
        this.server_error = 0;

        if (r.cssfiles) {
            head = $(document.head || document.getElementsByTagName('head')[0]);
            r.cssfiles.each(function(j) {
                if (this.cssfiles.indexOf(j) === -1) {
                    head.insert(new Element('LINK', {
                        href: j,
                        type: 'text/css',
                        rel: 'stylesheet'
                    }));
                    this.cssfiles.push(j);
                }
            }, this);
        }
        if (r.jsfiles) {
            head = $(document.head || document.getElementsByTagName('head')[0]);

            r.jsfiles.each(function(j) {
                if (this.jsfiles.indexOf(j) === -1) {
                    head.insert(new Element('SCRIPT', {
                        src: j,
                        type: 'text/javascript'
                    }));
                    this.jsfiles.push(j);
                }
            }, this);
        }

        if (r.tasks) {
            document.fire('HordeCore:runTasks', {
                response: resp,
                tasks: r.tasks
            });
        }

        if (r.response) {
            document.fire('HordeCore:doActionCompleteBefore', {
                action: action,
                ajaxresp: resp,
                response: r.response
            });

            if (Object.isFunction(opts.callback)) {
                try {
                    opts.callback(r.response, resp);
                } catch (e) {
                    this.debug('doActionComplete', e);
                }
            }

            document.fire('HordeCore:doActionCompleteAfter', {
                action: action,
                ajaxresp: resp,
                response: r.response
            });
        }

        this.notify_handler(r.msgs);

        this.endLoading(opts.loading);

        this.inAjaxCallback = false;
    },

    initLoading: function(id)
    {
        if (id && id.length) {
            if (this.loading[id]) {
                ++this.loading[id];
            } else {
                this.loading[id] = 1;
                document.fire('HordeCore:loadingStart', id);
            }
        }
    },

    endLoading: function(id)
    {
        if (id && id.length && this.loading[id]) {
            if (this.loading[id] == 1) {
                delete this.loading[id];
                document.fire('HordeCore:loadingEnd', id);
            } else {
                --this.loading[id];
            }
        }
    },

    showNotifications: function(msgs)
    {
        if (!msgs.size() || this.is_logout) {
            return;
        }

        if (!this.Growler) {
            return this.showNotifications.bind(this, msgs).defer();
        }

        msgs.find(function(m) {
            var alarm, growl, message, select;

            if (!Object.isString(m.message)) {
                return;
            }

            switch (m.type) {
            case 'audio':
                // Only play one instance of an alarm sound.
                if (m.flags && m.flags.id) {
                    if (this.audios.include(m.flags.id)) {
                        break;
                    }
                    this.audios.push(m.flags.id);
                }

                if (!this.audio) {
                    this.audio = new Element('AUDIO');
                    $(document.body).insert(this.audio);
                }
                this.audio.pause();
                this.audio.writeAttribute('src', m.message);
                this.audio.play();
                break;

            case 'horde.ajaxtimeout':
            case 'horde.noauth':
                this.logout(m.message);
                return true;

            case 'horde.alarm':
                alarm = m.flags.alarm;
                // Only show one instance of an alarm growl.
                if (this.alarms.include(alarm.id)) {
                    break;
                }

                this.alarms.push(alarm.id);

                if (!alarm.params) {
                    break;
                }

                message = alarm.title.escapeHTML();

                if (alarm.params.desktop) {
                    this.desktopNotify({
                        icon: alarm.params.desktop.icon,
                        text: Object.isUndefined(alarm.params.desktop.subtitle) ? '' : alarm.params.desktop.subtitle,
                        title: message,
                        url: alarm.params.desktop.url,
                        onclick: function() {
                            var ajax_params = $H({
                                alarm: alarm.id,
                                snooze: -1
                            });
                            this.addRequestParams(ajax_params);
                            new Ajax.Request(this.conf.URI_SNOOZE, {
                                parameters: ajax_params,
                                onSuccess: function() {
                                    this._desktopNotify({
                                        icon: alarms.params.desktop.icon,
                                        title: message,
                                        text: HordeCore.text.dismissed
                                    });
                                    if (alarms.params.desktop.url) {
                                        window.open(alarms.params.desktop.url, '__blank');
                                    }
                                }.bind(this)
                            });
                        }.bind(this)
                    });
                }

                if (alarm.params.notify) {
                    if (alarm.params.notify.url) {
                        message = new Element('A', { href: alarm.params.notify.url }).insert(message);
                    }
                    if (alarm.params.notify.sound) {
                        Sound.play(alarm.params.notify.sound);
                    }
                    message = new Element('DIV').insert(message);
                    if (alarm.params.notify.subtitle) {
                        message.insert(new Element('BR')).insert(alarm.params.notify.subtitle);
                    }
                    if (alarm.user) {
                        select = '<select>';
                        $H(this.text.snooze_select).each(function(snooze) {
                            select += '<option value="' + snooze.key + '">' + snooze.value + '</option>';
                        });
                        select += '</select>';
                        message.insert('<br /><br />' + this.text.snooze.interpolate({ time: select, dismiss_start: '<input type="button" value="', dismiss_end: '" class="horde-default" />' }));
                    }
                    growl = this.Growler.growl(message, {
                        className: 'horde-alarm',
                        life: 8,
                        log: false,
                        opacity: 0.9,
                        sticky: true
                    });
                    growl.store('alarm', alarm.id);
                    m.flags.growl = growl;

                    if (alarm.user) {
                        message.down('select').observe('change', function(e) {
                            if (e.element().getValue()) {
                                this.Growler.ungrowl(growl);
                                var ajax_params = $H({
                                    alarm: alarm.id,
                                    snooze: e.element().getValue()
                                });
                                this.addRequestParams(ajax_params);
                                new Ajax.Request(this.conf.URI_SNOOZE, {
                                    parameters: ajax_params
                                });
                            }
                        }.bindAsEventListener(this))
                        .observe('click', Event.stop);
                        message.down('input[type=button]').observe('click', function() {
                            var ajax_params = $H({
                                alarm: alarm.id,
                                snooze: -1
                            });
                            this.Growler.ungrowl(growl);
                            this.addRequestParams(ajax_params);
                            new Ajax.Request(this.conf.URI_SNOOZE, {
                                parameters: ajax_params
                            });
                        }.bind(this));
                    }
                }
                break;

            case 'horde.error':
            case 'horde.message':
            case 'horde.success':
            case 'horde.warning':
                this.Growler.growl(
                    (m.flags && m.flags.include('content.raw')) ? m.message : m.message.escapeHTML(),
                    {
                        className: m.type.replace('.', '-'),
                        life: (m.type == 'horde.error' ? 12 : 8),
                        log: 1,
                        opacity: 0.9,
                        sticky: m.flags && m.flags.include('sticky')
                    }
                );
                break;

            case 'webnotification':
                this.desktopNotify({
                    icon: m.webnotify.icon,
                    text: m.webnotify.text,
                    title: m.message
                });
                break;
            }

            document.fire('HordeCore:showNotifications', m);
        }, this);
    },

    notify: function(msg, type)
    {
        this.showNotifications([ {
            message: msg,
            type: type
        } ]);
    },

    // msg: icon, onclick, text, title, url
    desktopNotify: function(msg)
    {
        if (window.Notification) {
            if (window.Notification.permission != 'granted') {
                window.Notification.requestPermission(function() {
                    this._desktopNotify.bind(this, msg).delay(1);
                }.bind(this));
            } else {
                this._desktopNotify.bind(this, msg).delay(1);
            }
        }
    },

    _desktopNotify: function(msg)
    {
        var n = new window.Notification(msg.title, {
            body: msg.text,
            icon: msg.icon,
            url: msg.url
        });
        if (msg.onclick) {
            n.onclick = msg.onclick;
        }
    },

    // url: (string) TODO
    // params: (object) TODO
    // opts: (object) 'height', 'name', 'onload', 'width'
    popupWindow: function(url, params, opts)
    {
        opts = opts || {};
        params = $H(params || {});

        this.addRequestParams(params);

        var p = {
            height: opts.height || this.conf.popup_height,
            name: (opts.name || '_hordepopup').gsub(/\W/, '_'),
            noalert: true,
            onload: opts.onload,
            params: params,
            url: url,
            width: opts.width || this.conf.popup_width
        };

        if (!HordePopup.popup(p)) {
            this.notify(HordePopup.popup_block_text, 'horde.warning');
        }
    },

    /**
     * @todo Remove for H6.
     */
    closePopup: function()
    {
        // Mozilla bug/feature: it will not close a browser window
        // automatically if there is code remaining to be performed (or, at
        // least, not here) unless the mouse is moved or a keyboard event
        // is triggered after the callback is complete. (As of FF 2.0.0.3 and
        // 1.5.0.11).  So wait for the callback to complete before attempting
        // to close the window.
        if (this.inAjaxCallback) {
            this.closePopup.bind(this).defer();
        } else {
            window.close();
        }
    },

    // url: (string) Logout URL to redirect to
    logout: function(url)
    {
        this.is_logout = true;
        this.redirect(url || this.conf.URI_LOGOUT);
    },

    // url: (string) URL to redirect to
    redirect: function(url)
    {
        window.location.assign(this.addURLParam(url));
    },

    // Redirect to the download link.
    download: function(name, params)
    {
        var url = this.addURLParam(this.conf.URI_DLOAD, params);
        // Guaranteed to have at least one URL parameter, since download
        // URL requires the app name. So just append filename to end.
        url += '&fn=/' + encodeURIComponent(name);
        window.location.assign(url);
    },

    // id: (string) The ID to use for the loading image.
    // base: (Element) The base element over which the loading image should
    //       appear.
    // show: (boolean) If true, show image; if false, hide image.
    loadingImg: function(id, base, show)
    {
        var elt = $(id);

        if (show) {
            if (!elt) {
                elt = new Element('SPAN', { className: 'loadingImg', id: id }).hide();
                $(document.body).insert(elt);
            }

            elt.clonePosition(base, {
                setHeight: false,
                setWidth: false
            }).setOpacity(1).show();
        } else if (elt) {
            elt.fade({ duration: 0.2 });
        }
    },

    // url: (string) URL
    // params: (object) List of parameters to add to URL
    addURLParam: function(url, params)
    {
        var p = $H(),
            q = url.indexOf('?');

        if (q != -1) {
            p = $H(url.toQueryParams());
            url = url.substring(0, q);
        }

        p.update(params);
        this.addRequestParams(p);

        return p.size()
            ? (url + '?' + p.toQueryString())
            : url;
    },

    baseWindow: function()
    {
        try {
            if (parent.opener &&
                parent.opener.location.host == window.location.host &&
                parent.opener.HordeCore) {
                return parent.opener.HordeCore.baseWindow();
            }
        } catch (e) {}

        return window;
    },

    initHandler: function(type)
    {
        var h, t;

        if (!this.handlers[type]) {
            switch (type) {
            case 'click':
            case 'dblclick':
                h = this.clickHandler;
                t = [ type ];
                break;

            case 'mousewheelY':
                h = this.mousewheelYHandler;
                t = ('onwheel' in document || (document.documentMode >= 9))
                    ? [ 'wheel' ]
                    : [ 'mousewheel', 'DomMouseScroll' ];
                break;

            default:
                return;
            }

            this.handlers[type] = h.bindAsEventListener(this);
            t.each(function(e) {
                document.observe(e, this.handlers[type]);
            }, this);
        }
    },

    // 'HordeCore:click'/'HordeCore:dblclick' is fired on every element up
    // to the document root. The memo attribute is the original Event. If
    // this original Event contains a non-zero value of hordecore_stop,
    // bubbling is immediately stopped.
    clickHandler: function(e)
    {
        if (e.isRightClick()) {
            return;
        }

        var elt = e.element();

        while (Object.isElement(elt)) {
            elt.fire('HordeCore:' + e.type, e);
            if (e.hordecore_stop) {
                e.stop();
                break;
            }
            elt = elt.up();
        }
    },

    // 'HordeCore:mousewheelY' is fired on a vertical mouse wheel scroll event
    // for every element up to the document root. The memo attribute is
    // an integer: either -1 or 1.
    //
    // @since 2.11.0
    mousewheelYHandler: function(e)
    {
        var delta = 0;

        if (e.wheelDelta) {
            delta = e.wheelDelta;
        }
        if (e.detail) {
            delta = e.detail * -1;
        }
        if (e.deltaY) {
            delta = e.deltaY * -1;
        }
        if (!Object.isUndefined(e.wheelDeltaY)) {
            delta = e.wheelDeltaY;
        }

        if (delta) {
            e.element().fire('HordeCore:mousewheelY', (delta > 0) ? 1 : -1);
        }
    },

    tasksHandler: function(e)
    {
        var t = e.tasks || {};

        if (t['horde:regenerate_sid']) {
            this.regenerate_sid = true;
        }

        if (t['horde:sid']) {
            this.sessionId(t['horde:sid']);
        }
    },

    onGrowlerDestroy: function(e)
    {
        var id = e.element().retrieve('alarm');
        if (id) {
            this.alarms = this.alarms.without(id);
        }
    },

    onDomLoad: function()
    {
        // @todo: Remove for H6
        try {
            if (parent.opener &&
                parent.opener.location.host == window.location.host &&
                parent.opener.HordeCore) {
                this.base = parent.opener.HordeCore.base || parent.opener;
            }
        } catch (e) {}

        /* Add Growler notification handler. */
        if (window.Growler) {
            if (this.conf.growler_log) {
                this.Growler = new Growler({
                    clear: this.text.growlerclear,
                    info: this.text.growlerinfo,
                    location: 'br',
                    log: true,
                    noalerts: this.text.growlernoalerts
                });
            } else {
                this.Growler = new Growler({ location: 'br' });
            }
        }
    }

};

document.observe('dom:loaded', HordeCore.onDomLoad.bind(HordeCore));
document.observe('Growler:destroyed', HordeCore.onGrowlerDestroy.bindAsEventListener(HordeCore));
document.observe('Growler:linkClick', function(e) {
    window.location.assign(e.memo.href);
});
document.observe('HordeCore:runTasks', function(e) {
    this.tasksHandler(e.memo);
}.bindAsEventListener(HordeCore));