AFLCoreUmbraco 0.0.1-alpha4

Additional Details

Please use the default Models builder instead

This is a prerelease version of AFLCoreUmbraco. 
dotnet add package AFLCoreUmbraco --version 0.0.1-alpha4                

                    
                

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

                    
                

            
#r "nuget: AFLCoreUmbraco, 0.0.1-alpha4"
#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 AFLCoreUmbraco as a Cake Addin
#addin nuget:?package=AFLCoreUmbraco&version=0.0.1-alpha4&prerelease

// Install AFLCoreUmbraco as a Cake Tool
#tool nuget:?package=AFLCoreUmbraco&version=0.0.1-alpha4&prerelease

AFL

pipeline status Latest Release

Introduction

v10: https://www.nuget.org/packages/AFLCoreUmbraco/

Older versions of Umbraco

Important Notice

As AFL progresses we will be making a radical change to the framework to be inline with the release philosophy of Umbraco. Sometime during this year we will merge AFLCore and AFLCoreUmbraco. When this happens, it will mark our new approach to primarily support the latest iteration of Umbraco. Previous major Umbraco (Legacy) versions will be kept, but will not have official support - nor receive updates.

Getting Started

  1. Provide a Default Controller Inheriting from UmbracoDefaultControllerbase.
  2. In startup, while ConfiguringServices call the extension method services.InitializeAFL<TDefaultController>(IConfugration) where TDefaulcontroller is your implementation from step1.
  3. In Configure call app.UseAFL(new[] { GetType().Assembly /*.. other assemblies */ }) Its adviced to supply an assembly ending in .Core to store your businesslogic models for the models builder

AFL Basics

Classes representing renderable nodes should be decorated with the [Renderable] Attribute. Every site should have atleast 1 renderable root. TODO: Provide example

Dependency injection.

Basic AFL models now support dependency injection in the constructor. The first argument to a given models constructor should always be IPublishedContent node

ModelBuilder notes

Currently the models builder will first look for a project ending in .Core and write the models there. If none is found it will take the first defined in step 3.

Eventhandling notes

The base events are handled. We could add support for moving trashing and others in the future.

Custom indexes should in theory work, but only the default external index is currently tested.

To search decorate your models properties with the [Searchable] attribute.

In your controller or your model you can now inject the Searcher<TResultType> class, which will return results of type TResultType

Improvement Proposals.

  • IOptions support.
    • After this JSON Schema could be nice, to improve discoverability
  • ModelBuilder, Define path of new models in AppSettings, before looking for a .Core Assembly, or simply taking the first assembly defined.
  • A Wrapper for Element types more logical than AFLModelBase - too many properties doesnt fit ElementTypes.

Manually packing for nuspec

dotnet pack -p:NuspecFile=AFLUmbracoWeb.nuspec

There are no supported framework assets in this package.

Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on AFLCoreUmbraco:

Package Downloads
AFLUmbracoWeb

AFL backoffice extensions for Umbraco 8

GitHub repositories

This package is not used by any popular GitHub repositories.