README

Count words, get reading times, and convert text to list items.

Requirements

This plugin requires Craft CMS 3.0.0-beta.23 or later.

Installation

To install the plugin, search for Liquid Letters in the plugin store or follow these instructions.

1. Open your terminal and go to your Craft project:

    cd /path/to/project
   

2. Then tell Composer to load the plugin:

    composer require indigoviking/liquid-letters
   

3. In the Control Panel, go to Settings → Plugins and click the “Install” button for Liquid Letters.

Liquid Letters Overview

Liquid Letters adds Twig filters to count words, give reading times, and convert text to list items.

Using Word Count

{{ entry.field | wordCount }}

Will output

100

Using Read Time

The readTime filter requires a timing parameter of seconds(sec), minutes(min), hours(hr), or days(day, just for fun!).

Seconds

{{ entry.field | readTime('sec')

Minuts

{{ entry.field | readTime('min')

Hours

{{ entry.field | readTime('hr')

Days

{{ entry.field | readTime('day')

The output will be the number of the duration to read. If no timing or an invalid timing is submitted, the filter will return the text timing invalid.

Using To List

| toList will convert a multiline text field (rich text) into an unordered list.

If {{ entry.field }} is: `

The quick brown fox...

...an oft repeated sententce.

{{ entry.field | toList }} will return: <ul><li>The quick brown fox...</li><li>...an oft repeated sentence.</li><li>Much ado about this.</li></ul>

|toList accepts 1 parameter to change its output. Passing 'ol' will output a numbered list. {{ entry.field | toList('ol') }} will return: <ol><li>The quick brown fox...</li><li>...an oft repeated sentence.</li><li>Much ado about this.</li></ol>

Passing 'li' will only return the list items. {{ entry.field | toList('li') }} will return: <li>The quick brown fox...</li><li>...an oft repeated sentence.</li><li>Much ado about this.</li>

Brought to you by The Indigo Viking