AtlasCMS 0.1.2

dotnet add package AtlasCMS --version 0.1.2                
NuGet\Install-Package AtlasCMS -Version 0.1.2                
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="AtlasCMS" Version="0.1.2" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add AtlasCMS --version 0.1.2                
#r "nuget: AtlasCMS, 0.1.2"                
#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 AtlasCMS as a Cake Addin
#addin nuget:?package=AtlasCMS&version=0.1.2

// Install AtlasCMS as a Cake Tool
#tool nuget:?package=AtlasCMS&version=0.1.2                

This is the Atlas Headless CMS .NET Client SDK (Preview)

!!! NOTE !!!

AtlasCMS is planning to be RTM for all by Jan '23. We are currently on RC phase with just selected customers and professionals working with it. We decided to don't have a WebSite or Documentation online as far as we go RTM.

If you want to try Atlas CMS and be part of the selected community, totally free, before the RTM, write to support@atlascms.io

What is Atlas CMS

Atlas is a Cloud based SaaS Headless CMS. It has been created by developers for Developers, Agencies and Content Creators for the creation of their digital projects.

It wants to be simple, feature rich and with lighting speed performances and it contains the following features:

  • RESTful APIs
  • GraphQL Content Delivery
  • Powerful filters to search any part of the contents
  • Visual Model Builder with automatic API creation
  • Components
  • 30+ ready to go field types
  • Media Library and Media Analyzer
  • Image Editor
  • Image Server (resize, crop, format change, WebP)
  • Admin Users and Permissions
  • Project Users and Permission
  • Multilanguage
  • Webhooks
  • ....many more

Getting started

We recommend you use the NuGet Package Manager to add the library to your .NET Application using one of the following options:

  • In Visual Studio, open Package Manager Console window and run the following command:

    PM> Install-Package AtlasCMS
    
  • In a command-line, run the following .NET CLI command:

    > dotnet add package AtlasCMS
    

Use the Client

var options = new AtlasOptions 
{
    BaseUrl = "<Atlas CMS Base Url>",
	ApiKey = "<Your Api Key or Token>"
};

var client = new AtlasClient(options);

Now you can use all the features exposed by the client. For Example if you want to read a content you can

var myContent = await client.GetContent<object>("<model-api-key>", "<content-id>");

The above request will return a object of type Content<object> where its definition is the following:

public class Content<T> where T : class
 {
     public string Id { get; set; }
     public string Locale { get; set; }
     public DateTime CreatedAt { get; private set; }
     public string ModelId { get; private set; }
     public string ModelKey { get; private set; }
     public string CreatedBy { get; private set; }
     public DateTime ModifiedAt { get; private set; }
     public string ModifiedBy { get; private set; }
     public string Hash { get; private set; }
     public T Attributes { get; set; }
     public List<ContentLocale> Locales { get; private set; } = new List<ContentLocale>();
 }

Strongly Typed Attributes

Each Content in Atlas has Attributes that are the dynamic values based on the Model. If you don't want to work with objects you can create your own class that match the Model Field keys in Atlas and use it. For example, if you created in Atlas a Model called Book with the following keys:

  • Title (text)
  • ISBN (text)
  • NumberOfPages (num int)
  • Tags (array of strings)

you can use the following approach:

public class Book
{
	public string Title { get; set; }
	public string ISBN { get; set; }
	public int NumberOfPages { get; set; }
	public string[] Tags { get; set; }
}

var myBook = await client.GetContent<Book>("<model-api-key>", "<content-id>");

Now in the Attribute property of the Content<Book> you can use your strongly typed class.

Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in 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
0.1.2 472 9/15/2022
0.1.1 399 9/13/2022
0.1.0 392 8/30/2022
0.0.4-Preview 158 8/22/2022
0.0.3-Preview 157 8/14/2022
0.0.2 422 8/13/2022
0.0.1 407 8/13/2022