Welcome, Guest Login
Higher Logic User Group Site Higher Logic User Group Site Higher Logic Support Center

Support and Documentation

Resource Library: List View and Folder View

Last Updated: Oct 18, 2015 02:22PM EDT

Overview

The access point for all library entries within any library is the "Library" page with page code: librarydocuments.  The display of library entries is provided by the rl:DocumentList User Control found in the Library Documents content item.  This control offers two views, list view and folder view.  With the default configuration list view is the display provided on initial access of the Library page.  

List View

List View shows, by default, the ten most recent Library Entries added to a given library. This default of ten can be changed to any number through a Parameter (see below). Users click "more" to see entries beyond the initial ten or a series of tabs to sort the entries in multiple ways.

Unlike Folder View, List View emphasizes information associated with Library Entries beyond the files.  By default, List View provides the user with the following information and access for Library Entries:

  • Files associated with the Library Entry
  • Posting information, including the author name and posting date
  • The Description for the Library Entry (abbreviated if over 100 characters)
  • Tags, user rating, and other data such as number of views/downloads/comments

List view is a more "socially-centered" interface than Folder View.  It provides details, context and functionality not found on Folder View.

Folder View

Folder View emphasizes the files uploaded to a library.  Information as to the poster, date of posting, and experiences of other users are not immediately available in Folder View.  This and other information contained on the Library Entry level is visible after clicking through to the View Document pages or clicking the list view icon to see library contents in List View.

The Folder View Interface

Admins will recognize the Folder View interface.  Its functionality is very similar to that of the Navigation Page.  Folders are displayed on the left-hand "Folders" side.  All libraries default to have a main folder with the name of the community/library.  All further folders created exist as children of this parent folder.  When a folder is selected at left the contents of that folder are displayed at right.  A Library Entry that consists of a single file will display an icon specifying the file type through standard PDF, MSWord, JPG and other icons.  If the entry has multiple files a unique "multi-file" icon, which looks like four pieces of paper stacked atop each other, will be visible.

Double-clicking on contents at right will open the View Document page for the Library Entry, presenting users with complete information and social interaction tools.

Placing Contents in Folders

For libraries with multiple folders, it is simple to associate a new Library Entry with a specific folder.  When creating a new Library Entry the user must select a Library for the new entry.  If a Library with multiple folders is selected a new drop-down list appears prompting the user to select a folder.  If no folder is selected the new entry will be associated with the main folder.  

Folder-specific URLs 

The left-side toolbar on folder view offers a link icon.  This toolbar option allows a direct link to a specific library folder to be downloaded to the user’s clipboard. When these links are used, the folder structure will be displayed at initial page load regardless of the configured list-view or folder-view default. On page load, the folder selected when the link was created will be selected and its child folders (if any) exposed.

Managing Folders

Admins will often want to create folders for a library with multiple files already associated with it.  While the contents of a folder can only display in alphabetical order, files can be created and named as desired.

Initially, all the library contents will be associated with the main folder, so this is often a two-step process.  The first step is creating new folders.  The second step is moving folder contents into the desired folders. 

Instructions: Creating Library Folders

  1. Consider the organization of your library folders.  Keep in mind, new folders can be nested under any folder.
  2. Click on the main folder with the name of the library/community, then click "New Child" on the left-hand "Folders" side.  The new folder will appear.  Name the folder.
  3. Repeat this process, selecting "New" or "New Child" as necessary.  "New" will create a folder with the same parent as the folder selected.  "New Child" will create a folder nested as a child under the selected folder.

Instructions: Moving Folders within a Library

To relocate an existing folder within the library, take the following steps:

  1. Select the folder to be moved by clicking on it.
  2. Click on the scissors icon to "cut" the folder (the folder will not move or disappear).
  3. Identify the location where you want the folder to be located.
    1. If you want the folder you are moving to be a child folder under another folder, select the folder you want to serve as the parent.  Then click the "paste as child" button on the left-hand "Folders" side (the button looks like a clipboard with an orange arrow over it).
    2. If you want the folder you are moving to be a peer to other folder, click on a folder at the same level at which you want the folder you are moving to appear.  Then click the "paste" icon on the left-hand "Folders" side (the button looks like a clipboard with a piece of paper on it).

Instructions: Moving Library Content from Folder to Folder

Take the following steps to move folder content.  Content must be moved one piece at a time.

  1. Click on the folder currently containing the content you want to relocate. The file/entry will appear on the right-hand "Folder Content" side of the interface.
  2. Select the content you wish to move.  Click on the file/entry you wish to move from the folder.
  3. Click the "cut" button on the right-hand side. The button looks like a scissors.
  4. On the left-hand "Folders" side, select the folder into which you want to paste the file/entry.  Upon doing this the list of content for the current folder holding the file will disappear.
  5. Click the "paste" button on the right-hand side. The button looks like a clipboard with a piece of paper on it.

Determining Default Display

The rl:DocumentList control accepts a DefaultView="string" parameter to determine whether list view or folder view is the default. To achieve list view as the default configure  DefaultView="List" or omit this parameter altogether.  To achieve folder view as the default configure  DefaultView="Folder"

User Controls and Parameters

The primary User Control for Library List View is rl:DocumentList.  Beyond DefaultView="string", numerous parameters can be added to show or hide functionality and order the display of files for Library Entries.

 

Parameter (case sensitive)
showing default variable

Accepted Variables

Functionality

PageSize="#" any number Allows any number of entries to be shown on a Library List page. The default is 10.

ShowAddAsFriendLink="true"

true or false

Shows/Removes the link to "Add Contact" under the profile picture of the author.

ShowBlogThisLink="false"

true or false

Shows/Removes the link to "Blog This".  "Blog This" opens a new blog editor with a link to the Library Entry established in the text field.

ShowCommentsStats="true"

true or false

Shows/Removes the comments statistics at far right of each Library Entry

ShowDelete="false"

true or false

Shows/Removes the link to delete the Library Entry.  This link is only seen by the author and admins if allowed.

ShowDescription="true"

true or false

Shows/Removes the abbreviated description of each Library Entry

ShowDownloadAll="true"

true or false

Shows/Removes the "Download All" link which appears under the file list for all Library Entries with more than one attachment.

ShowDownloadStats="true"

true or false

Shows/Removes the download statistics showing at far right for each Library Entry.

ShowEdit="false"

true or false

Shows/Removes the "Edit" link which appears only to the author of the Library Entry and Admins.

ShowFavorite="true"

true or false

Shows/Removes the link to "Add as Favorite" which appears at right of each Library Entry.

ShowFavoritesStats="false"

true or false

Shows/Removes the data on how many other users have added as a favorite. This information shows at far right for each Library Entry.

ShowFileList="true"

true or false

Shows/Removes the list of files attached (the first three if more than three).  This shows at middle for each Library Entry.

ShowFilesStats="false"

true or false

Shows/Removes the statistic showing the number of files shown at bottom-right of each Library Entry.

ShowIcons="true"

true or false

Shows/Removes all icons for the "share", "permalink", "edit" and "delete".   If set to "false" the links will remain - only the icons are removed.

ShowMarkAsInAppropriate="true"

true or false

Shows/Removes the link to mark a Library Entry as inappropriate.

ShowPermaLink="false"

true or false

Shows/Removes the "permalink" and its icon, which appears at far right of each Library Entry.

ShowPicture="true"

true or false

Shows/Removes the profile picture of the author.  This picture is located at top-right of each Library Entry.

ShowPostedBy="true"

true or false

Shows/Removes the name and hyperlink to the profile page of the author and the timestamp showing the date and time of posting.

ShowPostedIn="true"

true or false

Shows/Removes the name and hyperlink for the library to which the Library Entry is posted.

ShowPostedOn="true"

true or false

Shows/Removes the timestamp showing the date and time of posting.

ShowRating="true"

true or false

Shows/Removes the star rating of the document and the ability of users to rate a Library Entry through List View pages.

ShowRatingCount="true"

true or false

Shows/Removes (rating ) text by the star ratings. This should be set to false or disabled - appears to have not been completed.

ShowRatingsStats="false"

true or false

Shows/Removes the ratings statistics in the statistics list at bottom-right for each Librry Entry.

ShowRelatedStats="false"

true or false

Shows/Removes the statistic showing the number of related documents in the statistics list at bottom-right of each Library Entry.

ShowRss="false"

true or false

Shows/Removes the "Add to RSS feeds" link that appears at far-right for each Library Entry.  Note, this will not remove an identical link at the top-right - that link is removed by establishing "ShowRSS="false" (case sensitive).

ShowRSS="true"

true or false

Shows/Removes the "Add to RSS feeds" link that appears at top-right above the Library Entries.  Note, this will not remove an identical link at the top-right of each Library Entry- that link is removed by establishing "ShowRss="false" (case sensitive).

ShowScore="false"

true or false

Shows/Removes the score of the Library Entry, which is determined by star ratings and usage statistics.  The score defaults to not show as it is somewhat redundant to the star ratings.

ShowShare="false"

true or false

Shows/Removes the link to share the Library Entry through an internal message.  This link appears at far right for each Library Entry.

ShowSharesStats="false"

true or false

Shows/Removes the number of times a Library Entry has been shared through the "share" link.

ShowTabs="true"

true or false

Shows/Removes the tabs which allow users display the Library Entry Lists by such data as "Most Recent", "Most Viewed", and by type of content.  The tabs appear above the main header (the name of the library) and the list of Library Entries.

ShowTags="true"

true or false

Shows/Removes the tags associated with each Library Entry.  The tags are located in the center bottom for each Library Entry.

ShowViewProfileLink="true"

true or false

Shows/Removes the link to the author's profile that appears below the profile picture for each Library Entry.

ShowViewsStats="true"

true or false

Shows/Removes the statistic showing the number of views in the statistics list at bottom-right of each Library Entry.

SortFileListByTitle="false"

true or false If true, displays the file list alphabetically by the "titles" of uploaded files (if present). If no file titles are present it will sort by file name.

SortFileListByFileName="false"

true or false If true, sorts the file list alphabetically by the name of the uploaded file regardless of whether the files have "titles".

 

support@higherlogic.com
http://assets3.desk.com/
false
higherlogic
Loading
seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
about
false
Invalid characters found
/customer/en/portal/articles/autocomplete