Documentation

Displaying Blogs

Liferay provides two methods for displaying blog entries: display page templates and the Blogs widget.

Using Display Page Templates

You can use display page templates to create reusable dynamic designs for displaying blog entries at their friendly URLs. By default, all blog entries are assigned a unique friendly URL automatically. You can use this URL to view the blog entry at a display page if you’ve selected a display page template to use for blog entries.

The blog’s friendly URL is appended to the display page’s URL (i.e., display-page-url/blog-friendly-url) and can be edited at any time. If you do change it, Liferay stores the previous URL in the entry’s friendly URL history. As long as the old URL remains in this history, it works to access the latest version of the blog entry. See Publishing Content with Display Pages for more instructions on setting up templates for displaying blog entries.

Once you’ve set up display pages for your blog entries, you can use collections to list them in your content pages. See About Collections and Collection Pages for more information.

Friendly URL History

If an old blog entry URL appears in the friendly URL history, it can’t be used for other entries in the same site. You must first remove it from the entry’s friendly URL history before using it for a new entry.

Follow these steps to manage a blog entry’s friendly URL history:

  1. Open the Site Menu ( Site Menu ), expand Content & Data, and go to Blogs.

  2. Click the Actions button ( Actions Button ) for the desired entry and select Edit.

  3. Expand the Configuration section and click the History button ( History Button ) in the Friendly URL field.

    Click the History button for the Friendly URL field.

  4. Click the Restore button ( Restore Button ) to replace the current friendly URL with the selected URL.

  5. Click the Forget URL button ( Forget URL Button ) to remove the selected URL from the entry’s history. Once removed, you can no longer use the URL to access the blog entry.

    Click the Restore or Forget URL buttons.

Changes to the friendly URL history are automatically saved.

Using the Blogs Widget

Adding the Blogs widget to a page exposes the blog interface to Site members. Similarly, adding the widget to a User’s personal Site (Profile) creates a blog just for that User. The widget works the same way in both cases.

Once you’ve added a Blogs widget to a page, there are several display options for configuring the listing to look the way you want.

To configure the widget, click Options (Options icon) → Configuration.

There are different setup options for the Blogs widget

Setup Tab

Enable Ratings: Enable the ratings system for blog entries.

Enable Comments: Enable comments on blog entries.

Show View Count: Enable showing the number of views for each entry.

Social Bookmarks: Enable sharing blog entries on the social media platforms you add to the Current column. To move social networking sites between the Current and Available columns, select the sites and use the arrows between those columns. Similarly, use the up/down arrows beneath the Current column to reorder the sites as they appear on each blog entry.

Display Style: Define how social bookmarks appear. Inline is the default and displays the social bookmark icons in a row. Menu hides them inside a share menu.

Maximum Items to Display: The total number of blog entries to display on the initial page. You can select up to 60 to display at once.

Display Template: Choose the display layout for blogs:

  • Abstract: Displays an abstract of each blog entry.

  • Full Content: Displays the full content of each blog entry.

  • Title: Displays only the title of each blog entry.

  • Basic: A stripped-down version of the Abstract, with less text and no cover image.

  • Card: Displays each blog entry in a card-like rectangle that shows the cover image, title, author, post date, and a few lines of text.

The card display template makes your blog posts look like fun little trading cards.

To select a different application display template (ADT) or create your own, click Manage Templates.

Enable Report Inappropriate Content: Enable flagging content as inappropriate, which sends an email to administrators.

Enable Ratings for Comments: Enable the ratings system for blog entry comments.

Show Related Assets: Enable showing related content from other widgets.

Communication, Sharing, and Scope Tabs

Communication: Lists public render parameters the widget publishes to other widgets on the page. Other widgets can read and take actions on these. For each shared parameter, you can specify whether to allow communication using the parameter and select which incoming parameter can populate it.

Sharing: Embed the widget instance as a widget on any website, Facebook, Netvibes, or as an OpenSocial Gadget.

Scope: Specify the blog instance the widget displays: the current Site’s blog (default), the global blog, or the page’s blog.

Additional Information