DragonFly.Templates
1.0.7
There is a newer version of this package available.
See the version list below for details.
See the version list below for details.
dotnet new install DragonFly.Templates::1.0.7
This package contains a .NET Template Package you can call from the shell/command line.
DragonFly » Headless ASP.NET Core CMS + Blazor
Features
- Define schema with custom fields
- Create, update, delete and publish/unpublish content items based on schema
- Create new Fields with FieldGenerator
- Create typed content items with ModelGenerator
- BlockField for structured page content
- TextBlock, HtmlBlock, ColumnBlock, GridBlock, AssetBlock, YouTubeBlock, CodeBlock,..
- Asset management
- Folder tree
- Asset metadata like ImageMetadata and PdfMetadata
- Use IAssetProcessing after asset upload
- Create thumbnails for image and pdf files with ImageWizard
- REST API
- Permissions for content, schema, asset, asset folder, webhooks
- Dynamic permissions for every schema
- Background tasks
- WebHooks
- MongoDB storage
- Create proxies with ProxyGenerator
- Admin interface with Blazor
Getting started
Prerequisites
- .NET 8.0 SDK
- Visual Studio 2022
- MongoDB instance
Create a new project from template
To use the project template you need first to download and install it from NuGet.
dotnet new install DragonFly.Templates
After this you can create the project with:
dotnet new DragonFly
If you have a remote MongoDB instance, you need to add some appsettings:
"MongoDB": {
"Hostname": "localhost",
"Database": "DragonFly_App",
"Port": 27017,
"Username": "",
"Password": ""
},
Use source generators to avoid reflection
- FieldGenerator
- ModelGenerator
- ProxyGenerator
- JsonSerializerContext
Supported fields
- StringField
- FloatField
- BoolField
- AssetField
- ReferenceField
- ComponentField
- ArrayField
- DateField
- IntegerField
- ColorField
- GeolocationField
- SlugField
- XmlField
- HtmlField
- BlockField (HeadingBlock, TextBlock, HtmlBlock, CodeBlock, ContainerBlock, ColumnBlock, AssetBlock, ReferenceBlock, GridBlock,..)
How to create new content schema and content item
IContentStorage contentStorage = ...;//use MongoStorage or ClientContentService (http client)
//create brand schema
ContentSchema schemaBrand = new ContentSchema("Brand")
.AddString("Name")
.AddSlug("Slug")
.AddTextArea("Description");
//Define schema for product
ContentSchema schemaProduct = new ContentSchema("Product")
.AddReference("Brand")
.AddString("Name", options => options.IsRequired = true)
.AddSlug("Slug")
.AddBool("IsAvailable", options => options.DefaultValue = true)
.AddFloat("Price")
.AddTextArea("Description", options => options.MaxLength = 255)
.AddArray("Attributes", options => options
.AddString("Name")
.AddString("Value"));
await contentStorage.CreateAsync(schemaProduct);
//create product by schema
ContentItem contentProduct = schemaProduct
.CreateContent()
.SetReference("Brand", new ContentItem(Guid.Parse(""), schemaBrand))
.SetString("Name", "ProductA")
.SetBool("IsAvailable", true)
.SetFloat("Price", 9.99)
.SetTextArea("Description", "...")
.AddArrayItem("Attributes", schemaProduct, item => item
.SetString("Name", "Size")
.SetString("Value", "M"));
await contentStorage.CreateAsync(contentProduct);
Create typed content
DragonFly.Generator
[ContentItem]
public partial class BlogPost
{
[DateField(Required = true)]
private DateTime? _date;
[StringField(Required = true, Searchable = true, ListField = true, MinLength = 8, MaxLength = 512)]
private string? _title;
[TextField]
private string? _description;
[SlugField(Required = true, Index = true)]
private string? _slug;
[AssetField(ListField = true, ShowPreview = true)]
private AssetField _image;
[BlockField]
private BlockField _mainContent;
}
Register typed content
builder.Services.AddDragonFly()
.AddModels(x => x.Add<BlogPost>());
Use queries for typed content
//get all items
var result = await ContentStorage.QueryAsync<BlogPostModel>(x => x
.Published(true)
.Top(10)
.Slug(x => x.Slug, "my-product")
.Integer(x => x.Quantity, 10, NumberQueryType.Equal)
.String(x => x.Title, "Test", StringQueryType.Equal)
);
BackgroundTask
For long running jobs you can use the BackgroundTaskManager.
IBackgroundTaskManager taskManager = app.Services.GetRequiredService<IBackgroundTaskManager>();
taskManager.Start("Test", async ctx => await Task.Delay(TimeSpan.FromSeconds(60), ctx.CancellationToken));
DragonFly.AspNetCore
builder.Services.Configure<DragonFlyOptions>(Configuration.GetSection("General"));
builder.Services.Configure<MongoDbOptions>(Configuration.GetSection("MongoDB"));
//add DragonFly services
builder.Services.AddDragonFly()
.AddImageWizard()
.AddRestApi()
.AddMongoDbStorage()
.AddMongoDbIdentity()
.AddBlockField()
.AddApiKeys();
var app = builder.Build();
//init DragonFly
await app.InitDragonFlyAsync();
if (env.IsDevelopment())
{
app.UseDeveloperExceptionPage();
app.UseWebAssemblyDebugging();
}
app.UseDragonFly(x => x
.MapImageWizard()
.MapApiKey()
.MapIdentity()
.MapRestApi());
app.UseDragonFlyManager();
app.UseRouting();
app.Run();
DragonFly.Client (Blazor)
var builder = WebAssemblyHostBuilder.CreateDefault(args);
builder.RootComponents.Add<DragonFly.App.Client.App>("app");
//Register DragonFly components
builder.AddDragonFly()
.AddRestApi()
.AddBlockField()
.AddIdentity()
.AddApiKeys();
WebAssemblyHost host = builder.Build();
await host.InitDragonFlyAsync();
await host.RunAsync();
-
net8.0
- No dependencies.
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.0.18 | 67 | 11/19/2024 |
1.0.17 | 79 | 11/17/2024 |
1.0.15 | 288 | 4/27/2024 |
1.0.14 | 113 | 4/27/2024 |
1.0.12 | 248 | 3/19/2024 |
1.0.10 | 213 | 3/19/2024 |
1.0.8 | 468 | 3/8/2024 |
1.0.7 | 244 | 3/3/2024 |
1.0.6 | 419 | 2/22/2024 |
1.0.5 | 555 | 2/7/2024 |
1.0.4 | 682 | 1/19/2024 |
1.0.3 | 393 | 1/10/2024 |
1.0.2 | 1,192 | 12/3/2023 |
1.0.1 | 223 | 12/2/2023 |
1.0.0 | 207 | 11/30/2023 |
0.9.31 | 444 | 7/27/2023 |
0.9.22 | 206 | 6/30/2023 |
0.9.17 | 198 | 5/9/2023 |
0.9.16 | 180 | 4/28/2023 |
0.9.15 | 187 | 4/27/2023 |
0.9.11 | 321 | 3/19/2023 |
0.9.10 | 275 | 3/8/2023 |
0.9.9 | 230 | 3/3/2023 |
0.9.8 | 347 | 1/29/2023 |
0.9.7 | 314 | 1/27/2023 |
0.9.6 | 350 | 1/27/2023 |
0.9.5 | 339 | 1/25/2023 |
0.9.3 | 345 | 1/4/2023 |
0.9.2 | 358 | 1/3/2023 |
0.9.1 | 371 | 12/28/2022 |
0.9.0 | 321 | 12/28/2022 |
0.8.4 | 352 | 12/19/2022 |
0.8.3 | 291 | 12/18/2022 |
0.8.2 | 290 | 12/18/2022 |
0.8.1 | 347 | 12/18/2022 |
0.8.0 | 334 | 12/18/2022 |