openproject/frontend/app/routing.js

//-- copyright
// OpenProject is a project management system.
// Copyright (C) 2012-2015 the OpenProject Foundation (OPF)
//
// This program is free software; you can redistribute it and/or
// modify it under the terms of the GNU General Public License version 3.
//
// OpenProject is a fork of ChiliProject, which is a fork of Redmine. The copyright follows:
// Copyright (C) 2006-2013 Jean-Philippe Lang
// Copyright (C) 2010-2013 the ChiliProject Team
//
// This program is free software; you can redistribute it and/or
// modify it under the terms of the GNU General Public License
// as published by the Free Software Foundation; either version 2
// of the License, or (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program; if not, write to the Free Software
// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
//
// See doc/COPYRIGHT.rdoc for more details.
//++

angular.module('openproject')

.config([
  '$stateProvider',
  '$urlRouterProvider',
  '$urlMatcherFactoryProvider',
  function($stateProvider, $urlRouterProvider, $urlMatcherFactoryProvider) {

  (function() {
    function valToString(val) { return val !== null ? val.toString() : val; }
    function valFromString(val) { return val !== null ? val.toString() : val; }
    function regexpMatches(val) {
      /*jshint validthis:true */
      // I'm not really sure why `val` can be undefined here, but undefined errors
      // kept appearing after moving the routes around.
      // This "fixes" it. Sorry.
      return angular.isUndefined(val) ? false : this.pattern.test(val);
    }
    $urlMatcherFactoryProvider.type('projectPathType', {
        encode: valToString,
        decode: valFromString,
        is: regexpMatches,
        pattern: /.*/
      });
  })();

  // redirect to default activity tab when user lands at /work_packages/:id
  // TODO: Preserve #note-4 part of the URL.
  $urlRouterProvider.when('/work_packages/{id}', '/work_packages/{id}/activity');

  $stateProvider
    .state('work-packages', {
      url: '',
      abstract: true,
      templateUrl: '/templates/work_packages.html',
      controller: 'WorkPackagesController',
      resolve: {
        latestTab: function($state) {
          var stateName = 'work-packages.list.details.overview'; // the default tab

          return {
            getStateName: function() {
              return stateName;
            },
            registerState: function() {
              stateName = $state.current.name;
            }
          };
        }
      }
    })

    .state('work-packages.show', {
      url: '/work_packages/{workPackageId:[0-9]+}?query_props',
      templateUrl: '/templates/work_packages.show.html',
      controller: 'WorkPackageShowController',
      controllerAs: 'vm',
      abstract: true,
      resolve: {
        workPackage: function(WorkPackageService, $stateParams) {
          return WorkPackageService.getWorkPackage($stateParams.workPackageId);
        },
        // TODO hack, get rid of latestTab in ShowController
        latestTab: function($state) {
          var stateName = 'work-package.overview'; // the default tab

          return {
            getStateName: function() {
              return stateName;
            },
            registerState: function() {
              stateName = $state.current.name;
            }
          };
        }
      }
    })
    .state('work-packages.show.activity', {
      url: '/activity',
      templateUrl: '/templates/work_packages/tabs/activity.html'
    })
    .state('work-packages.show.activity.details', {
      url: '#{activity_no:[0-9]+}',
      templateUrl: '/templates/work_packages/tabs/activity.html'
    })
    .state('work-packages.show.relations', {
      url: '/relations',
      templateUrl: '/templates/work_packages/tabs/relations.html'
    })
    .state('work-packages.show.watchers', {
      url: '/watchers',
      controller: 'DetailsTabWatchersController',
      templateUrl: '/templates/work_packages/tabs/watchers.html'
    })

    .state('work-packages.list', {
      url: '{projectPath:projectPathType}/work_packages?query_id',
      controller: 'WorkPackagesListController',
      templateUrl: '/templates/work_packages.list.html'
    })
    .state('work-packages.list.new', {
      url: '/create_new?query_props&type',
      controller: 'WorkPackageNewController',
      controllerAs: 'vm',
      templateUrl: '/templates/work_packages.list.new.html'
    })
    .state('work-packages.list.details', {
      url: '/details/{workPackageId:[0-9]+}?query_props',
      templateUrl: '/templates/work_packages.list.details.html',
      controller: 'WorkPackageDetailsController',
      resolve: {
        workPackage: function(WorkPackageService, $stateParams) {
          return WorkPackageService.getWorkPackage($stateParams.workPackageId);
        }
      }
    })
    .state('work-packages.list.details.overview', {
      url: '/overview',
      controller: 'DetailsTabOverviewController',
      templateUrl: '/templates/work_packages/tabs/overview.html',
      controllerAs: 'vm'
    })
    .state('work-packages.list.details.activity', {
      url: '/activity',
      templateUrl: '/templates/work_packages/tabs/activity.html'
    })
    .state('work-packages.list.details.activity.details', {
      url: '#{activity_no:[0-9]+}',
      templateUrl: '/templates/work_packages/tabs/activity.html'
    })
    .state('work-packages.list.details.relations', {
      url: '/relations',
      templateUrl: '/templates/work_packages/tabs/relations.html'
    })
    .state('work-packages.list.details.watchers', {
      url: '/watchers',
      controller: 'DetailsTabWatchersController',
      templateUrl: '/templates/work_packages/tabs/watchers.html',
      controllerAs: 'watchers'
    })
}])

.run([
  '$location',
  '$rootElement',
  '$browser',
  '$rootScope',
  function($location, $rootElement, $browser, $rootScope) {
    // Our application is still a hybrid one, meaning most routes are still
    // handled by Rails. As such, we disable the default link-hijacking that
    // Angular's HTML5-mode turns on.
    $rootElement.off('click');
    $rootElement.on('click', 'a[data-ui-route]', function(event) {
      if (!jQuery('body').has('div[ui-view]').length) return;
      if (event.ctrlKey || event.metaKey || event.which == 2) return;

      // NOTE: making use of event delegation, thus jQuery-only.
      var elm          = jQuery(event.target);
      var absHref      = elm.prop('href');
      var rewrittenUrl = $location.$$rewrite(absHref);

      if (absHref && !elm.attr('target') &&
        rewrittenUrl &&
        !event.isDefaultPrevented()) {

        event.preventDefault();
        if (rewrittenUrl != $browser.url()) {
          // update location manually
          $location.$$parse(rewrittenUrl);
          $rootScope.$apply();
          // hack to work around FF6 bug 684208 when scenario runner clicks on links
          window.angular['ff-684208-preventDefault'] = true;
        }
      }
    });
  }
]);