Contentment v2.2.0

Hey there Umbraco fans!

Hola amigas y amigos! 🌞 The summer may be over, but for today we have... Contentment v2.2.0!

---

Property Editors

• #133, Templated Label - a display label, ideal for showing data from 3rd-party systems.

New features

• #136, 8691c44 Data List - added Umbraco Users data-source
• ae3d69c Data List - added Umbraco User Groups data-source
• d0abd09 Data List - Number Range data-source, added setting for number of decimal places
• 747e3ea Data List - User-defined data-source, auto-populates the item's Value based on the Name
• f83bbb1 Added HasValueFor<T>() IPublishedElement extension method

Changes and bug fixes since the v2.1.0 release

• #126 Corrected typo in Bytes documentation - thanks @BatJan 🌟
• 3a81ea9 Data List - CSV/JSON/XML data-sources, updated default settings
• 2115167 Data List - Countries data-source, refactored to exclude non-countries (e.g. Caribbean, Europe, Latin America, World)
• f9b4483, a36d2c4, 66a8d12, ea617bd, cd5779c, bbb8d4c Updated various icons to use the <umb-icon> directive.
• d46f30d, adc7d38, d3d0c45 Refactored various code to remove System.Linq references - I'm told this can lead to better optimisations 🤷

---

Hacktoberfest 🎃

It's Hacktoberfest time again!

This year I'd like to expand the documentation to include all the Data Sources (for use with Data List + Text Input). So far I have added stub pages for each of the data-sources along with an open issue. You can view all "help wanted" open issues here.

Any contributions will be greatly appreciated. 🙏

---

Enjoy the release!

Cheers,
@leekelleher
✌️❤️🕊️

---

This release is also available on NuGet...

PM> Install-Package Our.Umbraco.Community.Contentment

Contentment v3.0.0-alpha005

Hey there Umbraco fans!

Quickly following on from yesterday's v3.0.0-alpha004 release, there has been a new Umbraco v9.0.0-rc003 release. Unfortunately, when I tried to test the upgrade, there was an error with Contentment, (something about a missing method). I upgraded the Umbraco dependencies and recompiled, and all appears to work now... so yup, it's another Contentment v3.0-alpha release.

---

[Insert usual boilerplate info here]

With Umbraco 9, you can no longer install packages via the CMS backoffice, you must use NuGet.

For those using the NuGet Package Manager...

Install-Package Our.Umbraco.Community.Contentment -Version 3.0.0-alpha005

...or if you are using the dotnet command line interface?

dotnet add package Our.Umbraco.Community.Contentment --version 3.0.0-alpha005

For more general information about the Contentment v3.0-alpha releases, please see the Contentment v3.0.0-alpha001 release notes.

---

Enjoy the release!

Cheers,
@leekelleher
✌️❤️🕊️

Contentment v3.0.0-alpha004

Hey there Umbraco fans!

Due to a few of breaking-changes in Umbraco v9.0.0-rc002, meant that the previous Contentment v3 alpha versions were kaput!
Apologies for any inconvenience caused. 😒

Fortunately, @arknu came to the rescue and quickly resolved the breaking-changes in PR #127! 🌟🙏
Unfortunately, I've had a busy busy work month, so haven't had the free time to get a patch release out. 😕
Until today! 😄

Any bug fixes? Yup, fixed #125 too (incorrect namespace in the Content Blocks preview Razor view).

OK, where can I get it?

With Umbraco 9, you can no longer install packages via the CMS backoffice, you must use NuGet.

For those using the NuGet Package Manager...

Install-Package Our.Umbraco.Community.Contentment -Version 3.0.0-alpha004

...or if you are using the dotnet command line interface?

dotnet add package Our.Umbraco.Community.Contentment --version 3.0.0-alpha004

For more general information about the Contentment v3.0-alpha releases, please see the Contentment v3.0.0-alpha001 release notes.

---

Enjoy the release!

Cheers,
@leekelleher
✌️❤️🕊️

Contentment v3.0.0-alpha003

Exactly the same release as Contentment v3.0.0-alpha001, (and v3.0.0-alpha002), but fixes #124, so tagged as 3.0.0-alpha003.

Contentment v3.0.0-alpha002

Exactly the same release as Contentment v3.0.0-alpha001, but tagged as 3.0.0-alpha002 as I messed up the Umbraco NuGet package names in my dependency references. 🤦

Contentment v3.0.0-alpha001

Hey there Umbraco fans!

Quick note, as of Umbraco v9.0.0-rc002, the latest Contentment v3.0.0 alpha release is 3.0.0-alpha005.

With the release of Umbraco 9.0 Release Candidate, I am excited to announce Contentment v3.0.0-alpha! 🎉

For anyone following along, I had been documenting my developer journey for migrating from Umbraco 8 (.NET Framework 4.x) to Umbraco 9 (.NET Core 5). While there is much celebration around the active Umbraco Package Developers simply migrating their package code over to .NET 5, it is important for me to note the amount of human effort that goes in to these things. For Contentment, the initial migration took around 12 days work, with additional days (this week) to resolve any snags - a rough estimate is 100 hours development time for this release. I mostly say this for empathy reasons, if you hit any snags with the package, be friendly - and keep in mind that no one is intentionally breaking your website. Send praise to your favourite package developers, (okay okay, you know we're mostly talking about @KevinJump right? ❤️)

...and congrats to Umbraco HQ and everyone on the Unicore Team, particularly @bergmania - well done on reaching this v9 milestone! 🏅🎉

---

On with the show...

What's new?

Contentment v3.0.0-alpha003 has all the latest features as last week's v2.1.0 release.

Where can I get it?

With Umbraco 9, you can no longer install packages via the CMS backoffice, you must use NuGet.

For those using the NuGet Package Manager...

Install-Package Our.Umbraco.Community.Contentment -Version 3.0.0-alpha005

...or if you are using the dotnet command line interface?

dotnet add package Our.Umbraco.Community.Contentment --version 3.0.0-alpha005

Any changes?

The biggest change is with the configuration options. Rather than do this within a custom Composer class (on Umbraco 8), these are now done in the appsettings.json file.

Here are Contentment's configuration options, note within the "Umbraco" section:

"Umbraco": {
  "Contentment": {
    "DisableTree":  true,
    "DisableTelemetry": true
  }
}

If you prefer to use a strongly-typed configuration, you can do so in the Startup.cs ConfigureServices() method, like so...

public void ConfigureServices(IServiceCollection services)
{
	services
		.AddUmbraco(_env, _config)
		.AddBackOffice()
		.AddWebsite()
		.AddComposers()
		.AddContentment(
			settings: x => { x.DisableTree = true; x.DisableTelemetry = true; },
			listItems: x => { x.Exclude<Community.Contentment.DataEditors.CountriesDataListSource>(); })
		.Build();
}

Please note, the call to .AddContentment() is optional. If you aren't comfortable with the Startup code, don't worry, the Contentment package will still work as it does on Umbraco 8.

Bugs and snags

If you find any bugs or snags, do let me know. If it's a reproducible bug, then you can raise it on the issues, otherwise if it's more of a feature or suggestion, then starting a discussion is a better way to do that. Keep in mind that the usual contribution rules of engagement apply. 😃

Sponsorship

Only because I'm not promoting it as much as I could be... if my Umbraco packages are super helpful to you and/or your business, you can sponsor me on GitHub! ...and if monthly is too much, there is a one off sponsorship option!

Enjoy the release!

Cheers,
@leekelleher
✌️❤️🕊️

Contentment v2.1.0

Hey there Umbraco fans!

Two weeks since the v2.0.0 release, I present to you... Contentment v2.1.0!

Given the amount of development time I've spent (so far) on v3 (aka my migration of Contentment for Umbraco 9) work, I decided to re-jig my ROADMAP for v2.x. I'd originally wanted to get the Cascading Dropdown List to be a standalone property-editor, but I saw the potential to make it extensible beyond using a Dropdown List, (which I have successfully prototyped), but would require significant development effort to finish off. With Umbraco v9 RC release date due next week, there's an expectation on getting a Contentment v3.0-RC out around the same time. I've postponed the Cascade editor until later on in the year.

In the meantime, there were some enhancements for Data List that I wanted to release before focusing on v3.0-RC.

---

Features

• 22c9be5 Configuration Editor - added item grouping - you'll see this specifically for Data List sources
• c07352a Data List - Unlocked all the hidden data sources! 🤩
  • Yup, that's everything since the v1.4.0 release!
  • The telemetry statistics were indicating that many people weren't aware of the extra data sources.
    With the grouping, the list of available data sources is less intimidating.
• eff90a9 Data List - added .NET Languages data-source
• 75ed137 Data List - added Umbraco Languages data-source
• ae0c273 Data List - added Umbraco Tags data-source
• 08d4da5 Data List - added Number Range data-source
• af30e51 Data List - added XML Sitemap data-sources
• b9342b3 Data List - added help note for developing your own custom data-source
• 790148a Data List Preview - label amend to include the item count for Data Sources tab

Bug fixes

• #118 - Documentation - Corrected code example for disabling telemetry - thank you @abjerner ⭐

---

Enjoy the release!

Cheers,
@leekelleher
✌️❤️🕊️

---

This release is also available on NuGet...

PM> Install-Package Our.Umbraco.Community.Contentment

Contentment v2.0.0

Hey there Umbraco fans!

Contentment is now an award-winning Umbraco package! 🎉

Winner of the Best Editor Experience package at CodeGarden 2021

Today, I am proud to announce the release of version two-point-oh! Oh yes, it's Contentment v2.0.0! 🎉

Quick overview... during the development of v1.x, there were several breaking-changes that I wanted to make, but didn't want to break the flow of the v1.x releases, so ended up stashing them away in a dev/2.0 branch, and it's taken me the best part of a year to get around to releasing it. 🤷

In terms of functionality, the code has been rebased on the latest v1.x release, v1.4.4, so contains all those features, bug fixes, etc.

Please make note of the breaking-changes section. The biggest one should only impact you if you have developed a custom Data List source or editor, as a Group property has been added to the underlying interface.

---

⚠️ Breaking Changes

• a226b65 Increased minimum Umbraco dependency to v8.14.0
• 55f3aa9 Added Group property to DataListItem class.
  • This is not in-use yet. It's a breaking-change for future-proofing. 😘
• 7d162fe Added Group property to IContentmentEditorItem interface
  • ☝️☝️☝️ If you have made a custom Data List source or editor, this will impact you!
• a1f7cf3 Marked the ContentmentTreeController class as internal. It can be disabled using Composition extension method. e.g. composition.DisableContentmentTree();
• d105c86 Renamed ContentmentCompositionExtensions class to CompositionExtensions, for consistency with the other Composition extension classes.
• 93f83f6 Data List Value Converter, sets cache level to PropertyCacheLevel.Snapshot
• 963f3bc Data List Value Converter - changes PropertyValueType from IEnumerable<T> to List<T>

🤩 Features

• 2f09351 Telemetry - switched to use Umbraco Telemetry Id
• 7736257 Content Blocks - added "Blocks" display mode, visually similar to Umbraco's Block List Editor (default label view)
• 7085687 Data List, made User-Defined data-source public (not a secret anymore) 🤫
• db282f5 Data List, added Umbraco Content Type data-source for Data List, (so yeah, another secret) 🤫
• 6431a58 Data List Enum data-source - add support for EnumMember attribute
• 2515b74 Data List Examine data-source - added autocomplete for the fields

🐛 Bug fixes

• #111 e03cb21 Data List Value Converter - workaround for Block List issue
• 0bbd401 Resolved other assembly warnings since upgrading to Umbraco v8.14.0

⭐ Misc / Refactoring / Cosmetics / UI Tweaks

• #38 Decoupling from AngularJS
  • #63 Replaced angular.(to|From)Json with Utilities - thank you @Matthew-Wise
• #39 #64 Decoupling from Underscore.js - thank you @Matthew-Wise
• #44 Configuration Editor overlay: Accessibility amends - thank you @BatJan
• #45 Content Blocks overlay: Accessibility amends - thank you @BatJan
• #49 Data List Item Picker - when overlay is closed, focus state is restored
• #77 2a7bd7f Umbraco Logo in Data List Umbraco Content data source doesn't look correct
• cd08669 Data List User Defined data-source - reduced overlay size
• dab3f0e Back-ported ConfigurationField amends from my v9 migration, more details on commit 5242425
• 58b7d8c Notes - updated CSS for <details/summary>
• c571a8e Data List Image Cropper data-source - removed description
• 68b8c25 Data List SQL data-source - reduced overlay size

---

Enjoy the release!

Thank you to @BatJan, @Matthew-Wise, @bjarnef and @hfloyd for your contributions during this release.

Cheers,
@leekelleher
✌️❤️🕊️

---

This release is also available on NuGet...

PM> Install-Package Our.Umbraco.Community.Contentment

Contentment v1.4.4

Hey there Umbraco fans!

I wasn't going to do another v1.4.x patch release, but @bjarnef flagged up a potential issue (#115) on Umbraco Cloud, and I noticed a few tweaks that I'd made in the v2.0 branch that could be backported, so decided to a Contentment v1.4.4 patch release! 🎉

---

Bug fixes

• #115 ed31f14 Umbraco Cloud/Deploy - Suspect missing routing of nodes after Content Transfer
• 1572c43 Data List Editors - added check for setting Property Actions
• 3de9a6b Data List Tags - removed rogue console.log

UI Tweaks / Cosmetics

• 1b6ac72 Data List Buttons/ItemPicker - amended IconPicker label
• 8ed2adf Data List User-Defined data-source - added help notes
• 973a49d Data List Examine data-source - added autocomplete for the fields
• a20d59d Data List UmbracoContentProperties data-source rephrased description
• 898a1dd Data List ImageCropper data-source - removed description
• e779361 Notes - removed extra <div> tag

---

Enjoy the release!

Thank you to @bjarnef for your feedback during this release.

Cheers,
@leekelleher
✌️❤️🕊️

---

This release is also available on NuGet...

PM> Install-Package Our.Umbraco.Community.Contentment

Contentment v1.4.3

Hey there Umbraco fans!

I'd been focusing efforts on v2.0 and v3.0, but sometimes there are bug fixes that need to be set free... here's Contentment v1.4.3 patch release!

---

Bug fixes

• #108 Data List's Item Picker - "Enable Filter" option doesn't seem to work
• #109 Data List's Item Picker - Selecting items immediately after saving new content/entity does not work
• #111 Data List value returns null when used in Block List settings

---

Enjoy the release!

Thank you to @bjarnef for your feedback during this release.

Cheers,
@leekelleher
✌️❤️🕊️

---

This release is also available on NuGet...

PM> Install-Package Our.Umbraco.Community.Contentment