Wholething.FallbackTextProperty 0.1.6

There is a newer version of this package available.
See the version list below for details. 
dotnet add package Wholething.FallbackTextProperty --version 0.1.6                

                    
                

            
NuGet\Install-Package Wholething.FallbackTextProperty -Version 0.1.6
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="Wholething.FallbackTextProperty" Version="0.1.6" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
paket add Wholething.FallbackTextProperty --version 0.1.6                

                    
                

            
#r "nuget: Wholething.FallbackTextProperty, 0.1.6"
#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 Wholething.FallbackTextProperty as a Cake Addin
#addin nuget:?package=Wholething.FallbackTextProperty&version=0.1.6

// Install Wholething.FallbackTextProperty as a Cake Tool
#tool nuget:?package=Wholething.FallbackTextProperty&version=0.1.6

Wholething Fallback Text Property

This Umbraco package provides two custom text property editors that allow developers to enter "fallback value", rendered from a Mustache template. The fallback can be built from other node properties and properties of other specific nodes in the content tree.

The included example project uses the default Umbraco starter-kit and there are minimal changes.

Team

This property editor is a collaboration between Harry Gordon and Wholething (Dean Leigh and Ault Nathanielsz).

Installation

You can find the package on NuGet: https://www.nuget.org/packages/Wholething.FallbackTextProperty/0.1.6

Configuration and editor experience

When you configure a "Textstring with Fallback" or "Textarea with Fallback" property you must configure a Mustache template to generate the fallback value.

fallback-text-1

In the example we use the following template: {{1104:heroHeader}} - {{pageTitle}} - Bar. In this case pageTitle refers to the nodes own property, 1104:heroHeader refers to the site home node's property heroHeader and the rest is literal. The result can be seen below:

fallback-text-2

Implementation

The implementation is fairly straight-forward and involves the following:

  • The property editor builds a dictionary of node properties and their values and does the same for any other nodes mentioned in the template.
  • The property editor renders the fallback template but does not store that in the field value (to avoid "caching" depedent values).
  • There is a value converter that returns either the entered value or renders the fallback value.

Limitations

There are a few notable limitations:

  • The fallback template can only handle simple properties. For example referring to other fallback properties in a fallback template wouldn't work.
  • The fallback template rendering does not currently use live values, just whatever is in the model when the editor is loaded.
  • Referring to other nodes in the template by node ID is not ideal, it's a suitable proof of concept but we'd like to look at other ways (for example, by name, doc type or URL).
There are no supported framework assets in this package.

Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.3.0 686 7/18/2022
1.2.0 493 6/16/2022
1.1.25 601 2/17/2022
1.1.22 607 2/14/2022
1.1.16 1,631 12/1/2021
0.2.26 1,100 9/9/2021
0.1.23 374 3/24/2021
0.1.21 343 3/24/2021
0.1.11 338 2/3/2021
0.1.6 348 1/27/2021