This article...
- Focuses on the widgets that are available with the Library module.
- Details how to access Page Designer in order to add Library widgets to a community page, and how to manage these widgets.
- Describes the Library widget that provides browsing, filtering, and managing Library content in communities.
- Discusses the widgets that populate the content on the Library Entry "Details" page.
- Details other Library widgets that enable file uploads from any page.
- Provides troubleshooting guidance if Library content unexpectedly displays in multiple widgets.
Higher Logic provides dozens of widgets that you can use to:
- modernize the look of your community pages,
- enhance the usefulness of your site, and
- increase member engagement.
In this article, we'll .
NOTE: Only widgets associated to our redesigned library are discussed in this article.
Access the widgets
You have to edit a page in order to access and manage (add, edit, remove) the widgets that it hosts.
To edit a page:
- Navigate to the page that you want to manage and click Edit Page on the Admin Toolbar (or right click for a new tab).
Alternatively, you can click Edit Navigation to access the CMS from which you can access any page.
- In Page Designer, click the Build tab and scroll down to the Widget section.
The section defaults to displaying All widgets.
- Click the Category dropdown and click Library to refine the view to just the Library widgets (these are discussed in this article).
Alternatively, you can type in the search field to quickly find one or more widgets.
NOTE: The search field queries the names of the widgets. If you type lib, seven of the eight Library widgets display; searching on "lib" does not return the Media Display widget.
Redesigned Library widget
The Library Entries widget, discussed below, is the primary Library widget that powers the redesigned Library experience.
Library Entries
In a default community configuration, this widget is used on the Browse > Library Entries page and on the Library tab for individual communities.
This single widget powers Higher Logic's redesigned Library experience.
- If your organization uses our redesigned library, the Library Entries widget is used on the main "Library Entries" page, as well as the Library tab for individual communities.
- If your organization does not leverage our redesigned library interface, the Library Entry List widget is used instead. To learn more about updating to the redesigned library experience, see Upgrading to the Redesigned Library.
This widget displays a list of Library Entries in either a list or card view, toggleable via the View icons, and allows entries to be filtered by type and sorted in various ways. In addition, users can create entries and select an entry to view its details in the expanded Preview Panel, providing several management actions.
Example
Options
You can configure the Library Entries widget via the following options:
Options for Standalone Libraries
Library: Use this option to choose which library the widget displays when it is placed on a page outside of a community context. On community landing pages and websites, this does not need to be configured because the widget respects the current community and displays only that community’s library entries. On standalone pages, selecting a library lets you create a library experience for one specific library instead of showing entries from all libraries the user can access.
Featured/Pinned Entry Options
-
Include A Featured Card Row Of Pinned items?: Use this option to control whether the widget displays a featured card row at the top of the page. This is useful when you want to highlight important or popular entries separately from the main list. If you use the featured row to surface pinned entries, those entries are highlighted there instead of also being pinned to the top of the main list.
Featured Row Filler Content: Use this option to choose what fills the featured card row. You can use it to feature pinned entries, most-viewed entries, or a combination of both. Use it to control whether the highlighted content emphasizes administrator-curated entries, user-popular entries, or a mix of both.
Filter and Sort Options
-
Show Folder View?: Use this option to let users browse entries by folder. This is useful when your library uses folders as an important part of how content is organized. Note that folder view is not available in the broad all-libraries browsing context outside of a community.
Load With Folders View Open?: Use this option to control whether the widget opens with the folder view already expanded. Enable it when you want folders to be the primary browsing method as soon as the page loads.
Show Number Of Entries In Folder?: Use this option to show or hide the entry count next to each folder name. This helps users understand how much content is in each folder before they open it.
Default Sort Option: Use this option to choose how entries are sorted when the page first loads. This controls the widget’s initial sort behavior, such as whether users see the newest entries first or entries sorted by title or activity. Users can still change the sort after the page loads if sorting controls are available in the experience.
-
Show thread attachments in Library?: Use this option to control whether files attached to discussion posts appear as library entries in the library experience. Use it when you want thread attachments to be discoverable alongside other library content, or disable it when you want the library to focus only on entries created directly in the library workflow.
Show Users A Filter For Attachments Visibility?: Use this option to control whether users can filter thread attachments in or out of the library display. Enable it when you want users to decide for themselves whether to include discussion-attachment entries in the library view. Disable it when you want that visibility handled only by the widget configuration.
Default User Filter Settings: Use this option to choose the initial attachment-visibility filter that users see when the page loads. Use it to set the starting view for whether thread attachments are shown or hidden in the library results.
Library List & Card Display Options
Default View For Library: Use this option to choose how library entries display when users first land on the page. T\his controls whether the library opens in a list-based or card-based layout. Use it to match the default browsing experience to the type of content you want to emphasize.
Show Authored By Line?: Use this option to show or hide the authored-by line for each library entry. Enable it when the contributor’s identity is useful context for readers evaluating the content.
Show The Community The Entry Was Posted In?: Use this option to show or hide the community associated with each entry. This is only relevant when users are browsing entries outside of a single-community context, where showing the source community helps users understand where the content came from.
Show Creation Date?: Use this option to show or hide each entry’s creation date. Enable it when users need to quickly judge how recent a file or resource is.
Show Description In List View?: Use this option to show or hide each entry’s description when the widget is in list view. Enable it when users need more context about a file before opening it; disable it when you want a more compact list.
Max Length Of Description: Use this option to control how much description text displays in list view. Use it to balance context against page density, especially when descriptions are long.
Show Tags In List View?: Use this option to show or hide tags for each entry in list view. Tags can help users quickly understand the topic or category of an entry and can make the list easier to scan.
Show Entry Statistics?: Use this option to show or hide entry statistics in list view and card view. This includes view and download statistics, which can help users gauge how frequently content is being used.
Show Entry Thumbnails in List View?: Use this option to show or hide thumbnail images for entries in list view. Enable it when you want the library to be more visual; disable it when you want a denser, more compact list layout.
Entry Preview Panel
Show Comments?: Use this option to show or hide comments in the entry preview panel. Enable it when you want users to see discussion and feedback related to the entry without leaving the library page.
Show Related Links?: Use this option to show or hide related links in the entry preview panel.
Show Tags?: Use this option to show or hide the entry’s tags in the preview panel. Enable it when tags provide useful classification or topical context for users viewing the entry details.
-
Show Download Button?: Use this option to control whether the preview panel displays a download button for the entry. The button appears unless the content type or its settings prevent downloading. Use it when you want to give users a direct download action from the preview experience.
Hide Download Button if The Video is Playable in Browser?: Use this option to hide the download button for videos that can be played inline in the browser’s viewer. Use it when you want users to watch playable video content in the site experience rather than downloading the file immediately.
Library Entry widgets
These widgets are used on the View Entry page that displays when users click to view an individual Library Entry.
NOTE: The easiest way to access the default View Entry page is to navigate to a Library, click to view an Entry, and then click Edit Page in the Admin Toolbar.
Reference the image to the widgets discussed below.
1 - Library Entry Actions
Inserts an Actions dropdown on a Library Entry page allowing users to perform several actions, such as:
- Viewing the Entry's permalink
- Editing the Entry (admin only)
- Pinning the Entry to the top of the Entry list (admin only)
- Deleting the Entry (admin only)
2 - Library Entry Statistics
Can display the following activity/statistics for a Library Entry:
- number of times favorited
- number of comments
- number of total views
- number of files
- number of times shared
- number of downloads
When configuring the widget, you can choose which statistics to display.
3 - Library Entry Details
Displays an Entry's description, if one has been provided.
4 - Library Entry Attachments
Displays a Library Entry's associated files.
You can configure a few options, such as setting the maximum number of files to show, sorting the files by name, and more.
Media Display widget
The Media Display widget allows you to embed video content from the selected Library Entry on any page across your site.
This functionality is useful for sharing important video content in several locations across your Higher Logic Community to ensure it's accessible to all users it may pertain to.
Other Library widgets
There are two other Library widgets: Create/Edit a Library Entry and Quick Library Entry Upload. These can be:
- added to any page across your site, and
- both of them allow users to upload files to a Library.
Create/Edit a Library Entry
This is the default widget that is used in your community when Create > Library Entry is chosen.
- It provides the full, step-by-step process to upload a file to a Library, as explained in Upload & Download Files.
- The upload process that is based on this widget allows users to provide more details about a file before uploading it.
Options
You can configure the Create/Edit a Library Entry widget via the following options:
Allow the Owner to be Changed?: Use this option to control whether users can change the library entry’s owner while creating or editing the entry. When this option is enabled, the Owner field remains available. When it is disabled, the Owner field is hidden so the owner cannot be changed through the widget. In the library-entry workflow, the owner is the person who manages the entry and its details.
Library: Use this option to choose which library the entry is added to. On community landing pages and websites, this does not need to be configured because the widget respects the community context and automatically uses the affiliated library.
-
Show Library Folders?: Use this option to control whether users can view and choose library folders while creating or editing an entry. Enable it when you want users to be able to file entries into folders within the selected library. Disable it when you want to simplify the experience and prevent folder selection.
Library Folder: Use this option to set a default folder for new library entries when the selected library uses folders. Users can then add the entry to that default folder, and, if folder selection is available, choose another folder from the dropdown instead.
-
Show Description?: Use this option to control whether the entry-description field is shown in the widget. Enable it when you want users to be able to add explanatory text that provides more context about the file or entry.
Allow HTML in Description?: Use this option to control which editor is used for the description field. When enabled, users get the HTML editor. When disabled, they use a simpler plain-text editor. Enable it when users need richer formatting in entry descriptions.
Quick Library Entry Upload
The Quick Library Entry Upload widget offers a simplified upload experience that has fewer options and it limits the amount of detail that can be included about the file that is being uploaded.
If this widget is added to a page that is:
- within a community, the default behavior is to upload the Library Entry to that community's Library. (A different community can be selected, if preferred.)
- not associated to a community, you must specify which community Library to upload it to; otherwise, the widget will not function.
Files that are uploaded via this widget do not display in the widget. They are uploaded to the community where the widget is located or to the configured community. This widget simply serves as a vehicle to allow file uploads via a simple interface.
Example
Options
You can configure the Quick Library Entry Upload widget via the following options:
Allow Users to Add a Library Entry Description?: Use this option to control whether users can add a description when they upload a file. Enable it when you want users to provide more context about what the file is, why it was uploaded, or how it should be used. Disable it when you want the upload experience to stay as simple and fast as possible.
Allow Users to Tag the Library Entry?: Use this option to control whether users can apply tags to the library entry during upload. Enable it when you want uploads to be easier to organize, filter, and find later by topic or category.
Allow Users to View the Library Entry Title?: Use this option to control whether the title is shown during upload. If a library entry formula is configured, this setting lets users see the generated title. If no formula is configured, it lets users edit the title directly. Disable it when you want the title to stay hidden from the upload experience.
Button Text: Use this option to set the label on the upload button. Change it when you want the action text to better match your site’s terminology or make the upload action clearer to users.
Community: Use this option to choose which community library receives uploaded files. This setting is especially important when the widget is used on a standalone page that is not associated with a community, because the widget will not function unless a destination community library is specified.
Library Entry Title Formula: Use this option to define a naming pattern for uploaded library entries. The title can be built from variables such as
[Day],[Month],[Year],[LibraryName], and[FolderName]. Use it when you want uploaded entries to follow a consistent naming convention automatically, especially for high-volume or structured uploads.
Troubleshoot: Duplicate content across Library pages
If you encounter a situation in which unexpected library content displays on a library page, the cause might be in the configuration of the content widget on that page: namely, the content widgets on both pages are set to filter by the same library.
Understand the cause
The content widget on each library page controls which content displays on that page. If a widget's Library filter is not correctly configured, it could pull content from an unintended library.
EXAMPLE: The widgets on Page A and Page B display the same content: that of Library A instead of Page B displaying content from Library B.
Fix the Library selection
To fix a Library selection on the widget:
- Navigate to the page on which the content incorrectly displays.
- In the Admin Toolbar, click (or right click for a new tab) Edit Page.
- In Page Designer, locate the content widget that displays the library items and click it to select it.
- Click the widget's pencil (edit) icon.
- On the configuration panel, check the Library field and select the library that has the content that you want displayed on the current page.
EXAMPLE: From the earlier example, the widget on Page B should be set to Library B (not Library A).
- Click Save and, in the bottom-right of Page Designer, click Save and then click Publish.
- On the community page (e.g., Page B), verify that the widget now displays content from the expected library (e.g., Library B).
TIP: Repeat these steps for any other pages that display unexpected library content.
Best practices
You can prevent occurrences of duplicate content in these Library widgets if you:
- Always verify the Library settings when you add or edit a widget.
- Clearly label your libraries so that they're easier to correctly select when a widget is added or edited.
- Preview the new or edited widget on the page to ensure that it displays the expected content; immediately fix it if it displays the wrong content.