Skip to content

moayyaed/KerykeionCmsCore

Repository files navigation

KerykeionCms

Basic Content Management System for AspDotNet Core environments.

The project itself as wel as a detailed documentation is still under development.

Subject to improvement so feel free to clone and improve to your needs.

Start up

If you want to skip the "Start up" steps you can go and clone a project template I've provided on https://github.com/Kerykeion7/KerykeionCmsTemplate.

In the future there will be public nuget packages for these projects, but for now you can clone this repository and build the projects locally. This will add a local nuget package in the bin\Debug folder of the specific project. Put these in the Program Files (x86)\Microsoft SDKs\NuGetPackages folder so Visual Studio can access these with the package manager.

If you don't want to use the package manager for adding the necessary nuget package simply add the folowing code in the .csproj file.

alt text

Save the file and it will add all needed supplements for the KerykeionCms.

Next create an Entity Framework Context that inherits from KerykeionCmsDbContext like so...

alt text

Update the ConfigureServices method in the Startup.cs file like this...

alt text

Update the Configure method in the Startup.cs file like this...

alt text

The last thing to do is add migrations and update the database. You can add Entities to the Context before you create the database but this can also be done afterwards. These (extra) code first added Entities will be able to be manipulated (performing CRUD operations on them) in the KerykeionCms.

Translations API

Another Necessary step is to clone the following API project https://github.com/Kerykeion7/KerykeionTranslationAPI and add it as an existing project to your solution. You can do this by right clicking your solution > add > Existing Project. Your explorer will open, open the KerykeionTranslationApi folder and double click the KerykeionTranslationAPI.csproj file. This will add the API to the solution.

Run both projects in the solution to be able to consume the KerykeionTranslations API from your project. To run both projects right click your solution and select 'properties', then check the 'multiple startup projects' radio button and set both project actions to 'start'.

alt text

Make sure the TranslationApi project runs on port 44370 you can easily update this in the launchsettings.json file.

Another option is to update the request uri in the KerkeionCmsCore project.

Access

(You can skip this step if you cloned the KerykeionCmsTemplate.)

To access the KerykeionContentManagementSystem pages there will have to be an User that is in an Administrator role. You can do this in the server itself or you can make use of a workaround I've provided.

Add the following highlighted code to the ConfigureServices method in the Startup.cs file of your main project.

alt text

This will grant anyone access to the KerykeionCms pages, so only to be used in Development Environments.

Getting started..

Now go to the url => {YourPort}/kerykeioncms and you can explore the KerykeionCms where you also can add users and apply roles to them.

There is built in documentation provided (still under development). When your on the KerykeionCms pages you will see a blue 'i' on top of the page. Click the i and you will be directed to the documentation page.

alt text

About

Basic Content Management System library for AspDotNet Core environments.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published