BlockFarmEditor.Umbraco
2.0.0
dotnet add package BlockFarmEditor.Umbraco --version 2.0.0
NuGet\Install-Package BlockFarmEditor.Umbraco -Version 2.0.0
<PackageReference Include="BlockFarmEditor.Umbraco" Version="2.0.0" />
<PackageVersion Include="BlockFarmEditor.Umbraco" Version="2.0.0" />
<PackageReference Include="BlockFarmEditor.Umbraco" />
paket add BlockFarmEditor.Umbraco --version 2.0.0
#r "nuget: BlockFarmEditor.Umbraco, 2.0.0"
#:package BlockFarmEditor.Umbraco@2.0.0
#addin nuget:?package=BlockFarmEditor.Umbraco&version=2.0.0
#tool nuget:?package=BlockFarmEditor.Umbraco&version=2.0.0
Block Farm Editor
🚀 Release Candidate Trial Notice
Current Status: Block Farm Editor is currently a Release Candidate and available for a 3-month rolling trial period.
After the Release Candidate period has been determined to be successful, the product will transition to a yearly licensing model. Currently targeting a $50 yearly license per main domain.
If you want to start building sites with it, signup using the following domain registration hubspot form in order to be contacted when fully released. Domain Registration Form
Overview
Block Farm Editor is a visual content editor that enables flexible, block-based content editing. Build reusable content blocks and containers that can be easily managed and rendered throughout your Umbraco website.
Initial Install
dotnet add package BlockFarmEditor.Umbraco
Add AddBlockFarmEditor()
to your UmbracoBuilder.
https://blockfarmeditor.com/readme
Licensing.
Go to the Block Farm Editor settings dashboard. Select your domain and click (Re)Validate.
Create a Block Area
Block Areas are used to define where blocks can be placed in your templates. Use the <block-area> tag helper to define block areas in your templates.
https://blockfarmeditor.com/readme/#create-your-first-block-area
Creating Blocks
1. Build your first block
Blocks are reusable components geared towards easily place content in different areas in your templates. They can be used to create anything from simple text blocks to complex components with multiple properties and behaviors.
Build the Element Type
The intial properties of the block are built out using Umbraco DataTypes just like any other Umbraco Element Type. https://blockfarmeditor.com/readme#building-first-block
Create the partial view
Create a partial view with which to display the properties. You can use standard Umbraco Syntax including the Models Builder.
https://blockfarmeditor.com/readme/#create-the-partial-view
Optional ViewComponent Assembly Attribute
If you prefer to use a viewcomponent for your display vs a direct partial view https://blockfarmeditor.com/readme/#optional-viewcomponent-assembly-attribute
Setup the Block Definition
Go back to the Block’s Element Type. Switch to the Definition tab in order to setup the Block Definition. This is what will allow the Element Type to be selectedable as visual block.
https://blockfarmeditor.com/readme/#setup-the-block-definition
2. Defining Custom Block Property Configs
You are able to directly control the configuration passed into a DataType programatically.
- Use the
BlockFarmEditorConfiguration
attribute to define the custom configuration for a property.
https://blockfarmeditor.com/readme/#defining-block-properties
Key Features
- Flexible Property Editors: Use existing Umbraco data types or property editors
- Custom Configuration: Create reusable configuration classes for property editors
- Template Integration: Simple tag helper syntax for rendering block areas
- View Components Support: Use either Razor views or View Components for rendering
- Container Support: Create nested block structures with container blocks
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net9.0
- BlockFarmEditor.ClientScripts.RCL (>= 2.0.0)
- Umbraco.Cms (>= 16.1.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Switched to using Element Document Types for Blocks.