This plugin will take a block of text and only return the first line (e.g. everything before a newline/return). It’s useful for showing summaries/excerpts from blog entries or on EE search result pages where you don’t have an exceprt/summary field already setup. HTML is not stripped out either.
Usage is simply:
{exp:summary}
Text to be processed
{/exp:trim_title}
An example would be as follows:
{exp:summary}
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Praesent nulla mauris, pharetra ac iaculis at, aliquet id diam.</p>
<p>Suspendisse sem massa, lacinia ac auctor at, fermentum sed arcu. Quisque lobortis porta neque, ut venenatis magna feugiat vitae.</p>
<p>Mauris vehicula semper accumsan. Proin mollis enim nec enim adipiscing congue. Vestibulum vitae iaculis odio. Ut tincidunt, dolor quis volutpat accumsan, ante massa feugiat nisl, vitae pulvinar leo ipsum at purus.</p>
{/exp:trim_title}
What would be returned is this:
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Praesent nulla mauris, pharetra ac iaculis at, aliquet id diam.</p>
You can also specify how many lines to return by flagging the returns parameter:
{exp:summary returns="2"}
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Praesent nulla mauris, pharetra ac iaculis at, aliquet id diam.</p>
<p>Suspendisse sem massa, lacinia ac auctor at, fermentum sed arcu. Quisque lobortis porta neque, ut venenatis magna feugiat vitae.</p>
<p>Mauris vehicula semper accumsan. Proin mollis enim nec enim adipiscing congue. Vestibulum vitae iaculis odio. Ut tincidunt, dolor quis volutpat accumsan, ante massa feugiat nisl, vitae pulvinar leo ipsum at purus.</p>
{/exp:summary}
...will return the following:
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Praesent nulla mauris, pharetra ac iaculis at, aliquet id diam.</p>
<p>Suspendisse sem massa, lacinia ac auctor at, fermentum sed arcu. Quisque lobortis porta neque, ut venenatis magna feugiat vitae.</p>
If you leave out the returns parameter, it will default to only return the first line.
You can download the latest version here:
