Description

The "More ..." plugin will truncate long entries and add a hyperlink to the description so that the user can view the full text of the entry.

Installation and Setup

In your global /WEB-INF/plugin.properties file, add the following line:

show-me-more=org.blojsom.plugin.showmore.ShowMeMorePlugin
show-me-more-admin=org.blojsom.plugin.showmore.admin.ShowMeMoreAdminPlugin

You may then add "show-me-more" to one of the flavor-based plugin chains. These plugin chains can be found in the individual user's plugin.properties file. For example:

html.blojsom-plugin-chain=show-me-more

The "more ..." plugin has its own configuration file that is referenced in /WEB-INF/web.xml. For example:

<init-param>
    <param-name>plugin-showmemore</param-name>
    <param-value>showmemore.properties</param-value>
</init-param>

The showmemore.properties file will be located in the respective /WEB-INF/(blog-id) directory and contains three configurable parameters:

entry-length-cutoff=400
entry-text-cutoff=<more/>
show-me-more-text=More ...

entry-length-cutoff defines the number of characters after which the link to view the full text of the entry will be placed. If this value is less than or equal to zero, the plugin will not try to cutoff the entry unless the value for the entry-text-cutoff parameter is present in the description.
entry-text-cutoff defines a special tag or string that you can use in your blog entry to define the place where the plugin should insert a link to view the full text of the entry. If this parameter is present and defined, it will override the entry-length-cutoff parameter.
show-me-more-text controls the text of the hyperlink to view the full text of the entry.

Required Permissions

A user must have the following permissions in order to use the show-me-more administration plugin.

showmemore_admin

Usage and URL Parameters

Usage

There is nothing special you have to do to your blog entries. Blog entries that are shorter than the length defined in entry-length-cutoff will not have a link added to their description.

URL Parameters

The following table describes the URL parameters that affect the output of the "more ..." plugin.