oo

Publishing Documents

Liferay makes it easy to publish and showcase documents and other types of media files. As you begin uploading media files, you probably want to start sharing them on your site.

The available widgets can highlight your documents and media files: Media Gallery, Documents and Media, and Asset Publisher. You can choose an appropriate widget based on your use case.

You can embed and display Documents and Media files on other assets such as Web Content, Blogs, or Wiki pages.

This widget publishes your media in a simple gallery-like style. It shows a large thumbnail of each file, offers file downloads, and has slideshow capabilities. A common way to use the Media Gallery is to have a separate page for displaying media and add a Media Gallery widget to it. The widget displays only audio or video files.

To use the Media Gallery widget,

  1. From the Content Management category of widgets, add the Media Gallery widget to a page.

    Locate the Media Gallery widget listed under the Content Management section of widgets.

  2. Once the widget appears, any media files previously uploaded should already be visible. If you wish to add additional media files, they can be uploaded from Documents and Media.

The Media Gallery widget has several options you can configure by clicking Options (Options icon) → Configuration:

The configuration window has four different tabs.

Display Settings: Show each file’s actions, filter the media types to display, and choose a display template for your media.

Folders Listing: Select a Document Library folder to serve as the root folder from which to display files. This folder becomes the highest-level folder the widget can access.

In the widget, clicking on any media file automatically starts a slideshow of all the files.

Clicking on a media file will start a slideshow

On each file is an Options (Options icon) icon:

You have different options when you click on the Options icon.

  • Download
  • Edit
  • Permissions
  • Delete

Using the Documents and Media Widget

This widget provides a way to publish all types of files. Unlike the Media Gallery widget, you can publish documents and other types of media.

  1. From the Content Management section, add the Documents and Media widget to a page.

    Locate the Documents and Media widget listed under the Content Management section of widgets.

  2. If you wish to add additional media files, they can be uploaded from the Documents and Media application.

You can configure Documents and Media via its Options button (Options button):

The configuration window has four different tabs.

Display Settings: Show each file’s actions, show the search bar, show related assets, set maximum number of files per page, and enable different view options.

Folders Listing: Select a Document Library folder to serve as the root folder from which to display files. This folder becomes the highest-level folder the widget can access.

Entries listing for table display style: Set what type of file information to display when the user selects Table view.

Ratings: Enable or disable the ratings system.

The toolbar at the top of Documents and Media provides these functions:

Access different tools from the toolbar at the top of the widget

Checkbox: Select all the media files.

Filter and Order: Filter files by document type. You can also sort your files by different parameters.

Click on filter and order to choose different ways to organize and sort your files.

Reverse: The Reverse icon (Reverse icon) reverses the direction of the sorting.

Search: Search through your media files by keyword.

Information: The Information icon (Click on the information icon to display file info.) provides details about the media files within the folder.

Display Style: The Display Style icon (Click on the display style icon to choose your display option.) switches between three display types: Cards, List and Table view.

Choose between cards, list, or table view to display your files.

Users can choose the display type of their choice.

Selecting a file reveals several options:

Click a checkbox for a file and access additional options.

Clear: Clear your current selection.

Information: The Information icon (Information icon) shows detailed information about the file.

Download: The Download icon (Download icon) downloads the file.

Move: Click the Move icon (Move icon) to move the file to a different folder.

Edit Tags: Click the Edit Tags icon (Edit icon) to edit the existing tags of a file.

Delete: Click the Trash icon (Trash icon) to delete a file.

Actions: The Actions icon (Actions icon) has options, including Checkin and Checkout. See Google Drive Integration, Office 365 Integration, and LibreOffice Integration.

Using the Asset Publisher Widget

The Asset Publisher widget can publish different assets and collections based on criteria. You can use it to display content from your Documents and Media library.

Using Documents in Other Assets

It is easy to add your documents or media files to other types of assets:

Web Content

  1. To be able to add documents or media to your Web Content, first create a Structure that contains a field for documents and media.

  2. Go to the Structures tab of the Web Content application to create a new Structure. Drag and drop the Documents and Media field onto the Structure.

    Drag and drop the Documents and Media field onto the Structure.

  3. Under the Web Content tab, click on the Add icon (Add icon) to create new Web Content. Select the Structure you just created as your template.

    Select the new Structure you just created

  4. You can now select documents or media files and add them to your Web Content.

Blogs

  1. To add documents and media to your blog, first navigate to the Blog application.

  2. Click the Add icon (Add icon) to add a new blog entry.

  3. Under Related Assets, click the Select button to select your documents and media to be added to your blog post.

    Under Related Assets, click on the select button to add your documents or media files.

Wikis

  1. Navigate to the Wiki node.

  2. Under Related Assets, click on the Select button and to select your documents and media to be added to your Wiki page.

    Under Related Assets, click on the select button to add your documents or media files.