/**
  * The singleton method
  * 
  * @return Tracker_Hierarchy_HierarchicalTrackerFactory
  */
 public static function instance()
 {
     if (!self::$instance) {
         self::$instance = new Tracker_Hierarchy_HierarchicalTrackerFactory(TrackerFactory::instance(), new Tracker_Hierarchy_Dao());
     }
     return self::$instance;
 }

 public function __construct(AgileDashboard_Kanban $kanban, PFUser $user, $user_is_kanban_admin, $language, $project_id)
 {
     $user_preferences = new AgileDashboard_KanbanUserPreferences();
     $kanban_representation_builder = new Tuleap\AgileDashboard\REST\v1\Kanban\KanbanRepresentationBuilder($user_preferences, new AgileDashboard_KanbanColumnFactory(new AgileDashboard_KanbanColumnDao(), $user_preferences), TrackerFactory::instance(), Tracker_FormElementFactory::instance());
     $this->kanban_representation = json_encode($kanban_representation_builder->build($kanban, $user));
     $this->user_is_kanban_admin = (int) $user_is_kanban_admin;
     $this->language = $language;
     $this->project_id = $project_id;
 }

 public function getConfigFactory()
 {
     if (!$this->config_factory) {
         require_once 'OnTop/ConfigFactory.class.php';
         require_once TRACKER_BASE_DIR . '/Tracker/TrackerFactory.class.php';
         $tracker_factory = TrackerFactory::instance();
         $element_factory = Tracker_FormElementFactory::instance();
         $this->config_factory = new Cardwall_OnTop_ConfigFactory($tracker_factory, $element_factory);
     }
     return $this->config_factory;
 }

 public function __construct(AgileDashboard_Kanban $kanban, PFUser $user, $user_is_kanban_admin, $language, $project_id)
 {
     $user_preferences = new AgileDashboard_KanbanUserPreferences();
     $kanban_representation_builder = new Tuleap\AgileDashboard\REST\v1\Kanban\KanbanRepresentationBuilder($user_preferences, new AgileDashboard_KanbanColumnFactory(new AgileDashboard_KanbanColumnDao(), $user_preferences), new AgileDashboard_KanbanActionsChecker(TrackerFactory::instance(), new AgileDashboard_PermissionsManager(), Tracker_FormElementFactory::instance()));
     $this->kanban_representation = json_encode($kanban_representation_builder->build($kanban, $user));
     $this->user_is_kanban_admin = (int) $user_is_kanban_admin;
     $this->language = $language;
     $this->project_id = $project_id;
     $this->user_id = $user->getId();
     $this->view_mode = $user->getPreference('agiledashboard_kanban_item_view_mode_' . $kanban->getId());
     $this->nodejs_server = ForgeConfig::get('nodejs_server');
 }

 private function getAlreadyExistingTracker()
 {
     foreach ($this->reserved_names as $itemname) {
         if ($this->tracker_factory->isShortNameExists($itemname, $this->project->getId())) {
             return $itemname;
         }
     }
 }

 /**
  * @throws AgileDashboard_UserNotAdminException
  *
  * @return bool
  */
 public function setColumnWipLimit(PFUser $user, AgileDashboard_Kanban $kanban, AgileDashboard_KanbanColumn $column, $wip_limit)
 {
     $project_id = $this->tracker_factory->getTrackerById($kanban->getTrackerId())->getGroupId();
     if (!$this->permissions_manager->userCanAdministrate($user, $project_id)) {
         throw new AgileDashboard_UserNotAdminException($user);
     }
     return $this->column_dao->setColumnWipLimit($column->getKanbanId(), $column->getId(), $wip_limit);
 }

 private function isUserAllowedToAccessKanban(PFuser $user, $tracker_id)
 {
     $tracker = $this->tracker_factory->getTrackerById($tracker_id);
     if (!$tracker) {
         throw new AgileDashboard_KanbanNotFoundException();
     }
     return $tracker->userCanView($user);
 }

 private function getTracker(Tuleap\Tracker\REST\TrackerReference $tracker_reference)
 {
     $tracker = $this->tracker_factory->getTrackerById($tracker_reference->id);
     if (!$tracker) {
         throw new \Luracast\Restler\RestException(404, 'Tracker not found');
     }
     return $tracker;
 }

 /**
  * @see Cardwall_OnTop_Config_Command::execute()
  */
 public function execute(Codendi_Request $request)
 {
     if ($request->get('add_mapping_on')) {
         $new_mapping_tracker = $this->tracker_factory->getTrackerById($request->get('add_mapping_on'));
         if ($new_mapping_tracker && $this->dao->create($this->tracker->getId(), $new_mapping_tracker->getId(), null)) {
             $GLOBALS['Response']->addFeedback('info', $GLOBALS['Language']->getText('plugin_cardwall', 'on_top_mapping_added', array($new_mapping_tracker->getName())));
         }
     }
 }

 public function getChildren($tracker_id)
 {
     if (!isset($this->cache_children_of_tracker[$tracker_id])) {
         $this->cache_children_of_tracker[$tracker_id] = array();
         foreach ($this->hierarchy_dao->searchChildTrackerIds($tracker_id) as $row) {
             $this->cache_children_of_tracker[$tracker_id][] = $this->tracker_factory->getTrackerById($row['id']);
         }
     }
     return $this->cache_children_of_tracker[$tracker_id];
 }

 /**
  * @return Tracker_CrossSearch_SearchView 
  */
 public function build(User $user, Project $project, Tracker_CrossSearch_Query $cross_search_query)
 {
     $report = $this->getReport($user);
     $service = $this->getService($project);
     $criteria = $this->getCriteria($user, $project, $report, $cross_search_query);
     $trackers = $this->tracker_factory->getTrackersByGroupIdUserCanView($project->getGroupId(), $user);
     $tracker_ids = $this->getTrackersIds($trackers);
     $artifacts = $this->getHierarchicallySortedArtifacts($user, $project, $tracker_ids, $cross_search_query);
     $content_view = new Tracker_CrossSearch_SearchContentView($report, $criteria, $artifacts, Tracker_ArtifactFactory::instance(), $this->form_element_factory, $user);
     return new Tracker_CrossSearch_SearchView($project, $service, $criteria, $trackers, $content_view);
 }

 /**
  * @see Cardwall_OnTop_Config_Command::execute()
  */
 public function execute(Codendi_Request $request)
 {
     if (is_array($request->get('custom_mapping'))) {
         foreach ($request->get('custom_mapping') as $mapping_tracker_id => $is_custom) {
             $mapping_tracker = $this->tracker_factory->getTrackerById($mapping_tracker_id);
             if ($this->canDelete($is_custom, $mapping_tracker) && $this->delete($mapping_tracker)) {
                 $GLOBALS['Response']->addFeedback('info', $GLOBALS['Language']->getText('plugin_cardwall', 'on_top_mapping_removed', array($mapping_tracker->getName())));
             }
         }
     }
 }

 /**
  * @return Tracker[]
  */
 public function getTrackersUsedAsKanban(Project $project)
 {
     $trackers = array();
     foreach ($this->dao->getKanbansForProject($project->getId()) as $row) {
         $tracker = $this->tracker_factory->getTrackerById($row['tracker_id']);
         if ($tracker) {
             $trackers[] = $tracker;
         }
     }
     return $trackers;
 }

 /**
  *
  * @param SimpleXMLElement $root
  * Export in XML the list of tracker with a cardwall
  */
 public function export(SimpleXMLElement $root)
 {
     $cardwall_node = $root->addChild(CardwallConfigXml::NODE_CARDWALL);
     $trackers_node = $cardwall_node->addChild(CardwallConfigXml::NODE_TRACKERS);
     $trackers = $this->tracker_factory->getTrackersByGroupId($this->project->getId());
     foreach ($trackers as $tracker) {
         $this->addTrackerChild($tracker, $trackers_node);
     }
     $rng_path = realpath(CARDWALL_BASE_DIR . '/../www/resources/xml_project_cardwall.rng');
     $this->xml_validator->validate($cardwall_node, $rng_path);
 }

 public function exportSingleTrackerToXml(SimpleXMLElement $xml_content, $tracker_id, PFUser $user, ZipArchive $archive)
 {
     $xml_field_mapping = array();
     $xml_trackers = $xml_content->addChild('trackers');
     $tracker = $this->tracker_factory->getTrackerById($tracker_id);
     if ($tracker->isActive()) {
         $tracker_xml = $xml_trackers->addChild('tracker');
         $tracker->exportToXMLInProjectExportContext($tracker_xml, $xml_field_mapping);
         $this->artifact_xml_xport->export($tracker, $tracker_xml, $user, $archive);
     }
     $this->rng_validator->validate($xml_trackers, dirname(TRACKER_BASE_DIR) . '/www/resources/trackers.rng');
     return $xml_trackers;
 }

 /**
  * Process the system event
  *
  * @return Boolean
  */
 public function process()
 {
     try {
         $tracker_id = (int) $this->getRequiredParameter(0);
         $tracker = $this->tracker_factory->getTrackerById($tracker_id);
         $this->actions->reIndexTracker($tracker);
         $this->done('All Tracker artifacts re-indexed correctly');
         return true;
     } catch (Exception $e) {
         $this->error($e->getMessage());
     }
     return false;
 }

 /**
  * @return Tracker
  */
 private function getTrackerFromMailHeader($mail_header)
 {
     $mail_userpart = $this->extractMailUserParts($mail_header);
     if (count($mail_userpart) !== 2) {
         throw new Tracker_Artifact_MailGateway_TrackerIdMissingException();
     }
     $tracker_id = (int) $mail_userpart[1];
     $tracker = $this->tracker_factory->getTrackerById($tracker_id);
     if ($tracker === null) {
         throw new Tracker_Artifact_MailGateway_TrackerDoesNotExistException();
     }
     return $tracker;
 }

 public function getDeniedTrackersForATrackerHierarchy(Tracker $tracker, PFUser $user)
 {
     $concerned_by_scrum = $this->isScrumHierarchy($tracker);
     $concerned_by_kanban = $this->isKanbanHierarchy($tracker);
     if (!$concerned_by_scrum && !$concerned_by_kanban) {
         return array();
     }
     $available_trackers = $this->tracker_factory->getTrackersByGroupIdUserCanView($tracker->getGroupId(), $user);
     if ($concerned_by_scrum) {
         $possible_trackers = $this->getTrackersConcernedByScrum($available_trackers, $tracker->getProject());
         return array_diff($available_trackers, $possible_trackers);
     }
     $possible_trackers = $this->getTrackersConcernedByKanban($available_trackers, $tracker->getProject());
     return array_diff($available_trackers, $possible_trackers);
 }

 /**
  * @see Cardwall_OnTop_Config_Command::execute()
  */
 public function execute(Codendi_Request $request)
 {
     if (!is_array($request->get('mapping_field'))) {
         return;
     }
     $mapping_fields = $this->getMappingFields();
     foreach ($request->get('mapping_field') as $mapping_tracker_id => $mapping_tracker_info) {
         if (!isset($mapping_tracker_info['field'])) {
             continue;
         }
         $field_id = (int) $mapping_tracker_info['field'];
         $mapping_tracker = $this->tracker_factory->getTrackerById($mapping_tracker_id);
         $field = $this->form_element_factory->getFieldById($field_id);
         $this->save($mapping_tracker_info, $mapping_fields, $mapping_tracker, $field);
     }
 }

 private function getTrackerForKanban(AgileDashboard_Kanban $kanban)
 {
     $tracker = $this->tracker_factory->getTrackerById($kanban->getTrackerId());
     if (!$tracker) {
         throw new RestException(500, 'The tracker used by the kanban does not exist anymore');
     }
     return $tracker;
 }