TruncHTML Documentation
Installation:
Unzip the archive and copy the file pi.trunchtml.php into the plugins-directory inside your Expression Engine system-directory.
Usage example:
Wrap any text/html you want to be truncated inside an {exp:trunchtml}-tag-pair.
{exp:trunchtml chars="300" ending="<a href='{path=site/comments}'>read on</a>"}{body}{/exp:trunchtml}
Parameters:
chars="100"
Defaults to 500. Number of characters that are to be returned.
ending="..."
Optional. String to be added after the output.
inline="..."
Optional. This string is placed directly after the truncated text and before any closing tags. If you want the first character to be a space, use an underscore
e.g. inline=“_continue”
exact="yes"
If this is set, text will be truncated after exactly the specified number of chars. Otherwise text will be cut after a space to prevent cutting words in the middle.
threshold="X"
If this is set the text will only be truncated if it at least X characters long.
Otherwise the full text is returned.
Questions / bug reports
For general comments, brickbats & bouquets please use the form over here.Page 1 of 4 pages 1 2 3 > Last »
User Talk
2010-08-21 08:10
Thank you for this very useful plugin. Can you suggest a way to handle this special case?
It would be useful to have two different links, one for viewing entries longer than the number of characters to truncate to (current parameter) and a different link if the entry is shorter than or equal to the truncate parameter.
It would seem that this would require two “ending=” parameters, the existing one for entries that are longer than the specified number, and one for the case when the entry is shorter.
Thanks
2010-03-21 05:23
Thank you very much for this little plugin! It is extremely helpful and I wish I would have found it a lot sooner!
2009-10-13 03:50
Thanks, that was it! I overwrote with the newest one from here and it worked like a charm.
Dude, this is one of those EXTREMELY useful plugins that lures you into thinking its insignificant because it’s small, but it’s actually well thought out on your part. Thanks for a great job!
2009-10-12 18:30
Thanks for this addon! It’s just what I needed.
I’m having probs getting “inline” to work. Using ENDING places the “...” after a on the next line. But inline=”...” isn’t working at all for me.
Here is my full code: {exp:trunchtml chars=“180” inline=“_…”}{event_details}{/exp:trunchtml}
2009-09-10 00:59
Using TruncHTML 1.3.2, it seems that when the truncation cuts off immediately before a closing tag, none of the open tags are closed. Inserting a single additional character fixes the problem, and all the tags close properly.