/**
  * returns a nicely formated string with <option>...</option> tags that can be
  * used in a <select> list. It will nest the album names in order to graphically
  * describe hierarchies, for easier understanding of how our album structure
  * is built
  *
  * @param userId
  * @return A string
  */
 function getNestedDropDownListContents($userId)
 {
     // fetch the list of albums properly arranged
     $albums = new GalleryAlbums();
     $userAlbums = $albums->getUserAlbumsGroupedByParentId($userId);
     // printing format
     $format = '<option value="{id}">{name}</option>';
     // call the method and return the results
     $result = GalleryTemplateTools::_printNested($userAlbums, $format, "&nbsp;&nbsp;&nbsp;");
     return $result;
 }