LocalizationProvider.AspNetCore 8.0.2

There is a newer version of this package available.
See the version list below for details.
dotnet add package LocalizationProvider.AspNetCore --version 8.0.2                
NuGet\Install-Package LocalizationProvider.AspNetCore -Version 8.0.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="LocalizationProvider.AspNetCore" Version="8.0.2" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add LocalizationProvider.AspNetCore --version 8.0.2                
#r "nuget: LocalizationProvider.AspNetCore, 8.0.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 LocalizationProvider.AspNetCore as a Cake Addin
#addin nuget:?package=LocalizationProvider.AspNetCore&version=8.0.2

// Install LocalizationProvider.AspNetCore as a Cake Tool
#tool nuget:?package=LocalizationProvider.AspNetCore&version=8.0.2                

Quality Gate Status

Supporting LocalizationProvider

If you find this library useful, cup of coffee would be awesome! You can support further development of the library via Paypal.

Localization Provider v8.0 IS OUT!

Read more about v8.0 release here.

What is the LocalizationProvider project?

LocalizationProvider project is ASP.NET Core web application localization provider on steroids.

Giving you the main following features:

  • Database-driven localization provider for .Net applications
  • Easy resource registrations via code
  • Supports hierarchical resources (with the help of child classes)

Source Code Repos

The whole package of libraries is split into multiple git repos (with submodule linkage in between). Below is list of all related repositories:

Project Structure

Database localization provider is split into main abstraction projects and .NET Core support project (this).

Getting Started

Bare Minimum to Start With

Below are code fragments that are essential to get started with a localization provider.

Install required packages:

> dotnet add package LocalizationProvider.AspNetCore
> dotnet add package LocalizationProvider.AdminUI.AspNetCore
> dotnet add package LocalizationProvider.Storage.SqlServer

Following service configuration (usually in Startup.cs) is required to get the localization provider working:

public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
        // add your authorization provider (asp.net identity, identity server, whichever..)
    
        services
            .AddControllersWithViews()
            .AddMvcLocalization();
    
        services.AddRazorPages();
        services.AddRouting();
    
        services.AddDbLocalizationProvider(_ =>
        {
            _.UseSqlServer(Configuration.GetConnectionString("DefaultConnection"));
            ...
        });
    
        services.AddDbLocalizationProviderAdminUI(_ =>
        {
            ...
        });
    }

    ...
}

And following setup of the application is required as a minimum (also usually located in Startup.cs):

public class Startup
{
    ...

    public void Configure(IApplicationBuilder app, IHostingEnvironment env)
    {
        app.UseRouting();
        app.UseAuthentication();
        app.UseAuthorization();
    
        app.UseDbLocalizationProvider();
        app.UseDbLocalizationProviderAdminUI();
        app.UseDbLocalizationClientsideProvider(); //assuming that you like also Javascript
    
        app.UseEndpoints(endpoints =>
        {
            endpoints.MapRazorPages();
            endpoints.MapDbLocalizationAdminUI();
            endpoints.MapDbLocalizationClientsideProvider();
        });
    }
}

You can grab some snippets from this sample Startup.cs file:

using System.Collections.Generic;
using System.Globalization;
using DbLocalizationProvider.AdminUI.AspNetCore;
using DbLocalizationProvider.AdminUI.AspNetCore.Routing;
using DbLocalizationProvider.AspNetCore;
using DbLocalizationProvider.AspNetCore.ClientsideProvider.Routing;
using DbLocalizationProvider.Core.AspNetSample.Data;
using DbLocalizationProvider.Core.AspNetSample.Resources;
using DbLocalizationProvider.Storage.SqlServer;
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.AspNetCore.Identity;
using Microsoft.AspNetCore.Localization;
using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Logging;
using Microsoft.Extensions.Options;

namespace SampleApp
{
    public class Startup
    {
        public Startup(IConfiguration configuration)
        {
            Configuration = configuration;
        }

        public IConfiguration Configuration { get; }

        public void ConfigureServices(IServiceCollection services)
        {
            services.AddDbContext<ApplicationDbContext>(
                options => options.UseSqlServer(Configuration.GetConnectionString("DefaultConnection")));

            services
                .AddDefaultIdentity<IdentityUser>()
                .AddRoles<IdentityRole>()
                .AddEntityFrameworkStores<ApplicationDbContext>();

            services
                .AddControllersWithViews()
                .AddMvcLocalization();

            services.AddRazorPages();
            services.AddRouting();

            var supportedCultures = new List<CultureInfo> { new CultureInfo("sv"), new CultureInfo("no"), new CultureInfo("en") };

            services.Configure<RequestLocalizationOptions>(opts =>
            {
                opts.DefaultRequestCulture = new RequestCulture("en");
                opts.SupportedCultures = supportedCultures;
                opts.SupportedUICultures = supportedCultures;
            });

            services.AddDbLocalizationProvider(_ =>
            {
                _.EnableInvariantCultureFallback = true;
                _.ScanAllAssemblies = true;
                _.FallbackCultures.Try(supportedCultures);
                _.UseSqlServer(Configuration.GetConnectionString("DefaultConnection"));
            });

            services.AddDbLocalizationProviderAdminUI(_ =>
            {
                _.RootUrl = "/localization-admin";
                _.ShowInvariantCulture = true;
                _.ShowHiddenResources = false;
                _.DefaultView = ResourceListView.Tree;
            });
        }

        public void Configure(IApplicationBuilder app, IHostingEnvironment env)
        {
            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
            }
            else
            {
                app.UseExceptionHandler("/Home/Error");
                app.UseHsts();
            }

            var options = app.ApplicationServices.GetService<IOptions<RequestLocalizationOptions>>();
            app.UseRequestLocalization(options.Value);

            app.UseRouting();
            app.UseHttpsRedirection();
            app.UseStaticFiles();
            app.UseAuthentication();
            app.UseAuthorization();

            app.UseDbLocalizationProvider();
            app.UseDbLocalizationProviderAdminUI();
            app.UseDbLocalizationClientsideProvider();

            app.UseEndpoints(endpoints =>
            {
                endpoints.MapControllerRoute("default", "{controller=Home}/{action=Index}/{id?}");
                endpoints.MapRazorPages();

                endpoints.MapDbLocalizationAdminUI();
                endpoints.MapDbLocalizationClientsideProvider();
            });
        }
    }
}

Also, you can refer to sample app in GitHub for some more hints if needed.

More Detailed Help

GitHub Source Code Structure

.NET Core support project has its own repo while main abstraction projects are included as submodules here.

How to Contribute

It's super cool if you read this section and are interesed how to help the library. Forking and playing around sample application is the fastest way to understand how localization provider is working and how to get started.

Forking and cloning repo is first step you do. Keep in mind that provider is split into couple repositories to keep thigns separated. Additional repos are pulled in as submodules. If you Git client does not support automatic checkout of the submodules, just execute this command at the root of the checkout directory:

git clone --recurse-submodules git://github.com/...

Building AdminUI.AspNetCore Project

You will need to run npm install at root of the project to get some of the dependencies downloaded to get started. Some files from these packages are embedded as part of the AdminUI - therefore compilation will fail without those files.

Other Versions

v7.0 is OUT

Please read more in this blog post!

What's new in v6?

Please refer to this post to read more about new features in v6.

More Info

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  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 (1)

Showing the top 1 NuGet packages that depend on LocalizationProvider.AspNetCore:

Package Downloads
LocalizationProvider.AdminUI.AspNetCore

Database driven localization provider. Admin UI for Asp.Net Core apps.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
8.1.0 1,899 6/5/2024
8.0.3 3,638 5/5/2024
8.0.2 4,147 3/28/2024
8.0.1 2,130 3/5/2024
8.0.0 1,631 2/17/2024
7.5.2 28,859 12/23/2023
7.5.1 103,776 1/1/2023
7.5.0 19,834 11/12/2022
7.4.0 10,843 9/29/2022
7.3.1 18,722 8/30/2022
7.3.0 13,182 6/9/2022
7.2.1 10,791 3/17/2022
7.2.0 15,794 3/3/2022
7.1.0 1,553 2/10/2022
7.0.0 17,073 1/23/2022
7.0.0-pre-0015 392 1/19/2022
7.0.0-pre-0014 329 1/16/2022
7.0.0-pre-0013 587 12/27/2021
7.0.0-pre-0012 502 11/30/2021
7.0.0-pre-0011 1,830 11/26/2021
7.0.0-pre-0010 5,639 11/24/2021
7.0.0-pre-0009 5,467 11/24/2021
7.0.0-pre-0008 4,740 11/24/2021
7.0.0-pre-0007 6,459 11/23/2021
7.0.0-pre-0006 1,502 10/31/2021
7.0.0-pre-0005 1,026 10/17/2021
7.0.0-pre-0004 567 10/4/2021
7.0.0-pre-0003 833 9/12/2021
7.0.0-pre-0002 517 8/30/2021
7.0.0-pre-0001 515 7/25/2021
6.5.0 9,426 5/7/2021
6.4.0 1,589 12/22/2020
6.3.0 1,130 10/27/2020
6.2.2 6,333 9/9/2020
6.2.1 799 9/9/2020
6.2.0 1,722 7/9/2020
6.1.1 819 6/19/2020
6.1.0 919 6/9/2020
6.0.3 1,251 3/18/2020
6.0.2 774 3/17/2020
6.0.1 866 3/16/2020
6.0.0 964 2/21/2020
5.7.1 8,788 7/14/2019
5.7.0 1,116 6/30/2019
5.6.0 2,058 5/7/2019
5.5.1 1,945 4/19/2019
5.5.0 1,197 4/8/2019
5.4.1 869 3/9/2019
5.4.0 1,161 2/28/2019
5.3.0 1,423 2/10/2019
5.1.0 1,663 1/13/2019
5.0.0 2,575 10/18/2018
4.3.0 2,034 8/22/2018
4.2.2 2,136 4/5/2018
4.1.1 1,175 1/27/2018
4.1.0 1,156 1/23/2018