zulip/static/js/onboarding.js

var onboarding = (function () {

var exports = {};

// The ordered list of onboarding steps we want new users to complete. If the
// steps are changed here, they must also be changed in create_user.py.
var steps = ["sent_stream_message", "sent_private_message", "made_app_sticky"];
var step_info = {sent_stream_message: {"user_message": "Send a stream message"},
                 sent_private_message: {"user_message": "Send a private message"},
                 made_app_sticky: {"user_message": "Get our app"}};

var onboarding = false;

function update_onboarding_steps() {
    var step_statuses = [];
    $.each(steps, function (idx, step) {
        step_statuses.push([step, step_info[step].status]);
    });

    $.ajax({
        type: 'POST',
        url: '/json/update_onboarding_steps',
        dataType: 'json',
        data: {"onboarding_steps": JSON.stringify(step_statuses)}
    });
}

function all_steps_completed() {
    return steps.filter(function (step) {
        return step_info[step].status === false;
    }).length === 0;
}


function finish_onboarding() {
    var checklist = $('#onboarding-checklist');
    checklist.empty();
    checklist.html("<i class='icon-vector-check onboarding_success'>Done");
    $('#onboarding').fadeOut(5000, function () {
        $(this).hide();
    });
}

function update_checklist_ui(step) {
    var checklist_item = $($('#onboarding-checklist').find("i")[steps.indexOf(step)]);
    checklist_item.removeClass("icon-vector-check-empty").addClass("icon-vector-check");
    if (all_steps_completed()) {
        finish_onboarding();
    }
}

exports.set_step_info = function (steps) {
    $.each(steps, function (idx, step) {
        var step_name = step[0];
        var status = step[1];
        step_info[step_name].status = status;
        if (status) {
            update_checklist_ui(step_name);
        }
    });
};

exports.mark_checklist_step = function (step) {
    if (!onboarding || step_info[step].status) {
        return;
    }

    step_info[step].status = true;
    update_checklist_ui(step);
    update_onboarding_steps();
};

function set_app_sticky_popover() {
    var item = $("#made_app_sticky");
    item.popover({"placement": "left",
                  "content": templates.render('sticky_app_popover'),
                  "html": true,
                  "trigger": "manual",
                  fixed: true,
                  // This is unfortunately what you have to do to set
                  // a custom width for a popover.
                  "template": '<div class="popover"><div class="arrow">' +
                              '</div><div class="sticky-popover-inner">' +
                              '<h3 class="popover-title"></h3>' +
                              '<div class="popover-content"><p></p></div>' +
                              '</div></div>'});
    // Popover on hover.
    item.mouseenter(function (e) {
        if (!$(this).data('popover').tip().hasClass('in')) {
            item.popover('show');

            // Clicking the Done button inside the popover closes it, removes
            // the mousenter event handler so it doesn't keep popping up if you
            // mouse around in that area, and instead reveals a ? to the right
            // of the checklist item you can click to revisit the content if you
            // want to.
            $("#sticky_done").on("click", function (e) {
                item.popover('hide');
                if (item.find("#pin_info_question").length === 0) {
                    item.unbind("mouseenter");
                    var info_span = $('<span id="pin_info_question">' +
                                      '<i class="icon-vector-question-sign"></i></span>');
                    info_span.click(function () {
                        item.popover("show");
                        $("#sticky_done").on("click", function (e) {
                            item.popover('hide');
                        });
                    });
                    item.append(info_span);
                    exports.mark_checklist_step("made_app_sticky");
                }
            });
        }
    });
}
step_info.made_app_sticky.register = set_app_sticky_popover;

function set_up_checklist() {
    var onboarding_checklist = $('#onboarding-checklist').empty();
    if (all_steps_completed()) {
        return;
    }

    $.each(steps, function (idx, step) {
        var entry = $('<div>');
        if (step_info[step].status) {
            entry.append($("<i class='icon-vector-check'>"));
        } else {
            entry.append($("<i class='icon-vector-check-empty'>"));
        }
        entry.append($('<span>').text(step_info[step].user_message)).attr("id", step);
        onboarding_checklist.append(entry);

        var register_action = step_info[step].register;
        if (register_action !== undefined) {
            register_action();
        }
        $("#onboarding").show();
    });
}

exports.initialize = function () {
    onboarding = true;
    exports.set_step_info(page_params.onboarding_steps);
    set_up_checklist();
};

return exports;
}());