jamalkaksouri / Blogifier.Core

Blogifier.Core project

Blogifier.Core

Blogifier.Core.PostgreSql

The goal of this project is to "blogify" ASP.NET applications; Blogifier.Core built and published as a Nuget package that can be installed by ASP.NET application to provide common blogging functionality.

Demo site

The demo site is a playground you can use to check out Blogifier features. You can register new user and write post to test admin panel.

System Requirements

• Windows or Linux
• ASP.NET Core 1.1
• .NET Framework 4.5.2
• Visual Studio 2017 or VS Code
• Authentication enabled
• SQL Server (Windows) or PostgreSql (Linux)

Designed for cross-platform development, every build pushed to Windows and Linux servers.

Getting Started

1. Open in VS 2017 and run WebApp sample application
2. Register new user
3. You should be able navigate to /blog and /admin

Using Blogifier.Core Nuget Package

1. In VS 2017, create new ASP.NET Core 1.1 Web Application with user authentication (single user accounts)
2. Open Nuget Package Manager console and run this command:

Install-Package Blogifier.Core

3. Configure services and application in Startup.cs:

public void ConfigureServices(IServiceCollection services)
{
  ...
  Blogifier.Core.Configuration.InitServices(services, Configuration);
}
public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)
{
  ...
  Blogifier.Core.Configuration.InitApplication(app, env, loggerFactory);
}

4. You should be able to run application and navigate to /blog and /admin

Security

• Blogifier.Core inherits user authentication from parent application and acts accordingly.
• If user authenticated but there is no profile for user identity, navigating to /admin will redirect to profile page. Filling in profile will effectively create a new blog.
• First application user will be marked as application administrator and will be able manage application settings.

Application Settings

Default application settings can be overwritten in application appsettings.json configuration file (you can add one if not exists). For example, to change connection string for your database provider:

{
  "Blogifier": {
    "ConnectionString": "your connection string here"
  }
}

More on application settings

Database Providers

Blogifier.Core implements Entity Framework (code first) as ORM. It uses MS SQL Server provider for Blogigier.Core package and PostgreSql provider for Blogifier.Core.PostgreSql

Connection string cascades based on conditions:

• Use default built-in Blogifier connection string
• Use default parent application connection string in appsettings.json
• Use Blogifier connection string in appsettings.json.

{
  "Blogifier": {
    "ConnectionString": "Server=.\\SQLEXPRESS;Database=Blogifier;Trusted_Connection=True;"
  }
}

Administration