This plugin is intended as a tool for developers to use as a dependency.  Note that it inherently does nothing by itself.

Sometimes you need to retain styling and markup in an excerpt, and elgg_get_excerpt doesn't cut it

This small plugin provides a global function providing a full HTML excerpt

Usage:

$params = array(

    'html' => $input_html,

    'length' => 250,

    'type' => 'chars', // also 'words'

    'elipses' => '...'

);

$excerpt = html_excerpt($params);

The resulting excerpt with trim textual elements to the resulting length and return valid rebuilt html.

**Note: the excerpt generation is comparably slow process.  Ideally excerpts should be cached after being generated and not generated on the fly repeatedly for multiple views on a page.