Our.Umbraco.Community.Contentment.Core 3.3.1

.NET 5.0 .NET Framework 4.7.2
There is a newer version of this package available.
See the version list below for details. 
dotnet add package Our.Umbraco.Community.Contentment.Core --version 3.3.1
NuGet\Install-Package Our.Umbraco.Community.Contentment.Core -Version 3.3.1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="Our.Umbraco.Community.Contentment.Core" Version="3.3.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
paket add Our.Umbraco.Community.Contentment.Core --version 3.3.1
#r "nuget: Our.Umbraco.Community.Contentment.Core, 3.3.1"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
// Install Our.Umbraco.Community.Contentment.Core as a Cake Addin
#addin nuget:?package=Our.Umbraco.Community.Contentment.Core&version=3.3.1

// Install Our.Umbraco.Community.Contentment.Core as a Cake Tool
#tool nuget:?package=Our.Umbraco.Community.Contentment.Core&version=3.3.1

<img src="../docs/assets/img/logo.png" alt="Contentment for Umbraco logo" title="A state of Umbraco happiness." height="130" align="right">

Contentment for Umbraco

contentment /kənˈtɛntm(ə)nt/ - a state of happiness and satisfaction

What is it?

This is a collection of Umbraco components that I have developed for use on my own Umbraco implementation projects.

Some components may be innovative, others may be a reimagining of existing components, property-editors, features and other community packages.

Why should I use it?

I'm sharing my code with the world. It is your choice (and responsibility) whether you would like to use it. No pressure or marketing spin from me.

What's on offer?

Let's take a look inside...

Property Editors
  • Bytes - a read-only label to display file sizes in relative bytes.
  • Code Editor - a code snippet editor, (using the ACE library that is bundled with Umbraco).
  • Content Blocks - a block editor, configurable using element types.
  • Data List - an editor that combines a custom data source with a custom list editor.
  • Editor Notes - Similar to Notes, with enhanced UI options.
  • Icon Picker - an editor to select an icon (from the Umbraco icon library).
  • Notes - a read-only label to display rich-text instructional messages for content editors.
  • Number Input - a numeric editor, with sizing configurations.
  • Render Macro - a read-only label dynamically generated from an Umbraco Macro.
  • Templated Label - a display label, ideal for showing data from 3rd-party systems.
  • Textbox List - a multi-textstring editor, adds a textbox for each item in a custom data source.
  • Text Input - a textstring editor, configurable with HTML5 options.
Telemetry

Information about the telemetry feature.

Releases

Downloads are available on the releases page.

Installation

Please note...

  • v3.x has been developed against Umbraco v8.17.0 and Umbraco v9.0.0 and will support those versions and above.
  • v2.x has been developed against Umbraco v8.14.0 and it will still work on current Umbraco v8.x releases.
  • v1.x has been developed against Umbraco v8.6.1, it will still work on current Umbraco v8.x releases.

With Contentment v3.x on Umbraco v9.0 (.NET 5), you can only install a package from the NuGet package repository. For Umbraco v8.x, the package can still be installed from either Our Umbraco or NuGet package repositories.

NuGet package repository

To install from NuGet, you can run the following command from within Visual Studio:

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

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

dotnet add package Our.Umbraco.Community.Contentment
Our Umbraco package repository

If you are using Umbraco v8.x, and prefer to install Contentment from the backoffice, the package can be downloaded from the Our Umbraco package repository:

https://our.umbraco.com/packages/backoffice-extensions/contentment/

Demo website

A demo website is available for testing purposes. (Please note, you will need to clone the repository and run locally.)

Documentation

Documentation for each of the components - with screenshots, use-cases and code examples - can be found in the /docs folder.

Please note, you may find other components within Contentment that have not yet been documented.<br> Let's call those "life's little surprises".

Known issues
  • Data List
    • When using the Umbraco Content data source with an XPath query, inside a Nested Content editor, it will not be able to identify the contextual containing node ID. e.g. your XPath query will not work. See #30 for details.
    • When using the Umbraco Content data source with an XPath query that contains a $ prefix parameter, the preview will not display the items. See #120 for details.
    • With Umbraco v9 (Contentment v3), SQL data source does not support querying SQL CE. See #172 for details.

Roadmap

If you would like to know what is coming up in future releases, then take a look at the roadmap.

Support

I've been doing open source for a long time. I have suffered my fair share of burnout and empathy fatigue.

I reserve the right to address bug reports or feature requests in my own time, or ignore them completely.

Any feedback is welcome and appreciated. But please keep in mind, I am not your personal support developer.

If you are really stuck, do remember that the Umbraco community is amongst the friendliest on our planet, learn to embrace it. Ask for help on the Our Umbraco support forum, I am sure someone can help you there.

Contributions, collaborations, rules of engagement

If you would like to contribute to this project, please start a discussion before spending time and energy on a pull request. Your time is precious too.

Please make sure that you read the CONTRIBUTING guidelines.

This project is governed by a Code of Conduct. Play nice or go home. ✌️:heart::dove:

If you are unhappy with the project or documentation, please help to identify specific issues and work towards resolving them. Otherwise you are completely free to not use this software, complain on your favourite social network, or go shout into the void.

Unacceptable behaviour towards myself (or contributors) may result in being blocked from accessing this repository.

License

Copyright © Lee Kelleher.

All source code is licensed under the Mozilla Public License.

A note about licensing

Historically, I used the MIT license for my open-source projects, regretfully I no longer feel MIT reflects my spirit of encouraging open source collaboration. The main difference with the Mozilla Public License is that if you make any modifications to the source code, then you must make those changes publicly available.

More give, less take.

If you do not to intend to modify the source code, then you will still have the same freedoms as when using the MIT license.

For more information about the Mozilla Public License, please visit: https://www.mozilla.org/en-US/MPL/2.0/FAQ/

Acknowledgements

Developers

<details> <summary>Current development effort: <b>1145+ hours</b> (between 2019-03-13 to 2022-02-10)</summary>

To give you an idea of how much human developer time/effort has been put into making this package.

</details>

Special thanks
  • Thank you to Umbrella for facilitating the time and resource to help me initiate this project.

The package logo uses the Happy (by Nick Bluth) icon from the Noun Project, licensed under CC BY 3.0 US.

Product Compatible and additional computed target framework versions.
.NET net5.0 is compatible.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Framework net472 is compatible.  net48 was computed.  net481 was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (5)

Showing the top 5 NuGet packages that depend on Our.Umbraco.Community.Contentment.Core:

Package Downloads
N3O.Umbraco.Extensions

TODO
Our.Umbraco.Community.Contentment

Contentment, a collection of components for Umbraco.
Etch.Cms.Umbraco.Core The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

Package Description
Etch.CMS.Umbraco.Template.Models The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

Package Description
Etch.Cms.Integrations.Workable.Umbraco The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

Package Description

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
4.7.0 1,227 4/19/2024
4.6.1 25,797 3/12/2024
4.6.0 53,462 12/14/2023
4.5.1 34,139 11/9/2023
4.5.0 17,315 10/11/2023
4.4.6 25,965 9/12/2023
4.4.5 19,681 8/14/2023
4.4.4 97,190 5/17/2023
4.4.3 6,052 5/10/2023
4.4.2 107,793 3/1/2023
4.4.1 39,944 1/27/2023
4.4.0 86,509 12/8/2022
4.3.0 22,325 12/1/2022
4.3.0-beta 790 11/27/2022
4.2.1 50,232 11/27/2022
4.2.0 186,986 10/17/2022
4.1.5 152,503 9/12/2022
4.1.4 1,327 9/12/2022
4.1.3 20,048 9/5/2022
4.1.2 164,582 8/24/2022
4.1.1 156,425 7/22/2022
4.1.0 1,494 7/22/2022
4.0.0 301,025 6/16/2022
3.4.0 5,204 6/16/2022
3.3.1 309,428 5/11/2022
3.3.0 330,941 4/21/2022
3.2.0 690,520 3/9/2022
3.1.0 7,249 2/11/2022
3.0.1 17,047 10/27/2021
3.0.0 3,006 10/20/2021
2.2.2 5,946 11/23/2021
2.2.1 2,892 10/15/2021
2.2.0 4,220 10/5/2021
2.1.0 14,450 7/2/2021
2.0.0 3,407 6/18/2021
1.4.4 11,165 6/8/2021
1.4.3 4,008 5/25/2021
1.4.2 3,718 4/28/2021
1.4.1 1,702 4/21/2021
1.4.0 4,376 4/15/2021
1.3.0 1,249 4/7/2021
1.2.1 1,595 3/10/2021
1.2.0 1,915 3/5/2021
1.1.3 12,777 12/30/2020
1.1.2 1,179 12/22/2020
1.1.1 1,295 12/11/2020
1.1.0 2,439 12/3/2020
1.0.1 17,177 8/28/2020
1.0.0 4,461 8/12/2020