AFLCoreUmbraco 0.0.1-alpha3

Additional Details

Please use the default Models builder instead

This is a prerelease version of AFLCoreUmbraco.
There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package AFLCoreUmbraco --version 0.0.1-alpha3                
NuGet\Install-Package AFLCoreUmbraco -Version 0.0.1-alpha3                
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-alpha3" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add AFLCoreUmbraco --version 0.0.1-alpha3                
#r "nuget: AFLCoreUmbraco, 0.0.1-alpha3"                
#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-alpha3&prerelease

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

AFL

pipeline status Latest Release

Introduction

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

Older versions of Umbraco

v8: https://www.nuget.org/packages/AFLUmbraco8/ Getting started: todo (contact : kontakt@appstract.dk ) v7: https://www.nuget.org/packages/AFLUmbraco/ Getting started: todo (contact : kontakt@appstract.dk )

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.