This document outlines the procedures for creating and managing navigation trees within the system. It covers the overall purpose and scope of navigation management, details the roles and access privileges required, and describes the editor's layout, including its three-pane structure and responsive design. Additionally, the document explains the functionalities of the Trees, Levels, and Keyword Manager panes, and provides guidance on saving changes and ensuring availability. Finally, it assesses the user experience impact, highlighting what end users will encounter as a result of these navigation structures.  

Purpose and scope

Navigation trees define the guided paths end users follow to find videos and their events. As an administrator or moderator, you create and maintain these trees so users can explore reliably with up to five levels. 


Roles and access

  • Who can edit: Administrators and Moderators of the channel. 
  • Where (two ways): 
    1. From Keyword Filters → Cogwheel: in the Keyword Filters pane, click the cogwheel to open Keyword Manager, then use the hamburger menu (top-left) to switch to Navigation Trees. 
    2. From Explore: on the page where navigation trees are listed, click Edit navigation trees (pencil) to open the Navigation trees editor. 

 

 

Editor layout (three panes + responsive behavior)

The editor is split into three panes laid out left→right: 

  • Trees — manage the list of navigation trees.
  • Levels — define and reorder the levels of the selected tree.
  • Keyword Manager — work with keyword categories and keywords. 


Responsive layout: 

  • Wide screens: three panes side by side (Trees | Levels | Keyword Manager).
  • Medium screens: two columns — left column stacked (Trees on top, Levels below), Keyword Manager on the right.
  • Small screens: single-pane view with quick controls to switch between Trees, Levels, and Keyword Manager. 


Trees pane (create, name, order, purge) 


  • Create new tree (Alt+N). The default name is Undefined. 
    •  Auto-naming: if you add a first level before renaming, the tree automatically takes the name of that level.
    • Manual naming sticks: once you edit the tree name manually, that name is preserved regardless of later changes. 
  • Rename tree (Enter) at any time.
  • Move selected tree up / Move selected tree down (drag and drop or buttons).
  • Delete selected tree (Delete).
  • Purge invalid trees removes trees referencing deleted or invalid categories.
  • Save all changes (Alt+S). After saving, the updated trees are immediately available in Explore.
  • Revert all changes (Alt+Z).
  • Exit warning: if you try to close with unsaved changes, you’ll be prompted to Save or Exit without saving. 


Levels pane (define the hierarchy) 

  • Add level: drag and drop keyword categories from Keyword Manager, or select a category and click Add selected category.
  • Order matters: video categories must come before event categories.
  • Move selected level up / Move selected level down (drag and drop or buttons).
  • Delete selected level removes it from the current tree.
  • Maximum: up to five levels per tree.
  • No duplicates: once a category is used in the tree, attempts to add it again are blocked with a notification. 


Keyword Manager pane  

  • Find categories: browse or search the channel’s keyword categories.
  • Add to tree to send the selected category to the Levels pane.
  • Create/edit categories: add missing categories or adjust existing ones while building a tree.
  • For a comprehensive guide to this panel, see Keyword Manager on dartfish.tv. 


User experience impact (what users will see) 

  • Explore shows 1–20 trees on the Channel Home page and on the Videos page. 
  • At each level, only values that lead to content are shown.
  • At any level, users can click All Videos Of: {Category} — {Keyword} to exit the tree at that point and display all videos matching the selected category value.
  • Results can be viewed in Grid or List. In List, users can expand a video to view matching events.
  • When filters target events, users can View playlist to play the filtered playlist of events back to back. 


FAQ

  • Why is my tree labelled broken? 

           One or more referenced categories were deleted or are invalid; fix the levels or use Purge invalid trees. 

  • Can I put event categories before video categories? 

           No. Validation requires video categories first, then event categories. 

  • Why can’t I add a sixth level? 

           Trees are limited to five levels. 

  • Users say some values are missing — is it a bug? 

           Not necessarily. Values that don’t lead to content in the current path are intentionally hidden. 


Keyboard shortcuts

Use these shortcuts in the Navigation tree editor:

  • Arrow keys: move focus across tree rows and controls.
  • Enter: start renaming the focused tree.
  • Alt+↑ / Alt+↓: move the focused tree up/down.
  • Alt+N: create a new tree (default name “Undefined”). 
  • Delete: delete the focused tree.
  • Alt+S: save changes.
  • Alt+Z: revert all changes. 


Note: shortcuts act on the currently focused row/control.