jcdcdev.Umbraco.ReadingTime 0.1.1

jcdcdev.Umbraco.ReadingTime

Custom Data Type for calculating reading time.

The following editors are currently supported:

• Rich Text
• Markdown
• Block Grid
• Block List
• Nested Content
• Textstring
• Textarea

Quick Start

1. Install the NuGet package in your Umbraco CMS website project.
2. Add the Reading Time data type to a document type.
   • Note: You can configure the words per minute in the data type settings.
3. Save and publish content.
4. Reading Time will display in the backoffice

Using the value in your templates

In your template, you can accessing the Reading Time property.

<div class="alert alert-info">
    Read in @Model.ReadingTime.DisplayTime()
</div>

Configuration

You can change the average words per minute in the data type settings.

When creating a new data type, the default will be 200 words per minute. To change this default, adjust your appsettings.json file:

{
  "ReadingTime": {
    "WordsPerMinute": 200
  }
}

Limitations

Values are derived from published content only.

Draft content is not included in the calculation.

Extending

You can extend the data type to support additional editors by implementing the IReadingTimeValueProvider interface.

public class MyCustomReadingTimeValueProvider : IReadingTimeValueProvider
{
    public bool CanConvert(IPropertyType type)
    {
        return type.EditorAlias == "MyCustomEditorAlias";
    }

    public TimeSpan? GetReadingTime(IProperty property, string? culture, string? segment, IEnumerable<string> availableCultures, ReadingTimeConfiguration config)
    {
        var value = property.GetValue(culture, segment, true);
        if (value is string text)
        {
            return text.GetReadingTime(config.WordsPerMinute);
        }

        return null;
     }
 }

Don't forget to register your custom value provider:

public class Composer : IComposer
{
    public void Compose(IUmbracoBuilder builder)
    {
        builder.ReadingTimeValueProviders().Append<MyCustomReadingTimeValueProvider>();
    }
}

Contributing

Contributions to this package are most welcome! Please read the Contributing Guidelines.

Acknowledgments (thanks!)

• LottePitcher - opinionated-package-starter