Skip to content
Permalink
Branch: master
Find file Copy path
Find file Copy path
1 contributor

Users who have contributed to this file

120 lines (91 sloc) 5.2 KB

Getting Started (Asp.Net Core)

Install Package

PM> Install-Package LocalizationProvider.AspNetCore

Configure Services

In your Startup.cs class you need to add stuff related to Mvc localization (to get required services into DI container - service collection).

And then services.AddDbLocalizationProvider(). You can pass in configuration settings class (parameter name cfg) and setup provider's behavior.

public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
        // add basic localization support
        services.AddLocalization();

        // add localization to Mvc
        services.AddMvc()
                .AddViewLocalization()
                .AddDataAnnotationsLocalization();

        services.AddDbLocalizationProvider(cfg =>
        {
            cfg...
        });
    }
}

Following configuration options are available:

Option Description
CacheManager Gets or sets cache manager used to store resources and translations (InMemory by default)
Connection Gets or sets the name of the database connection (e.g. "DefaultConnection").
CustomAttributes Gets or sets list of custom attributes that should be discovered and registered during startup scanning.
DefaultResourceCulture Gets or sets the default resource culture to register translations for newly discovered resources.
DiagnosticsEnabled Gets or sets value enabling or disabling diagnostics for localization provider (e.g. missing keys will be written to log file).
DiscoverAndRegisterResources Gets or sets the flag to control localized models discovery and registration during app startup.
EnableInvariantCultureFallback Gets or sets flag to enable or disable invariant culture fallback (to use resource values discovered & registered from code).
EnableLocalization Gets or sets the callback function for enabling or disabling localization. If this returns false - requested resource key will be returned as translation.
Export Gets or sets settings used for export of the resources.
ForeignResources Gets or sets collection of foreign resources. Foreign resource descriptors are used to include classes without [LocalizedResource] or [LocalizedModel] attributes.
Import Gets or sets settings to be used during resource import.
ModelMetadataProviders Settings for model metadata providers.
PopulateCacheOnStartup Gets or sets a value indicating whether cache should be populated during startup (default = true).
TypeFactory Returns type factory used internally for creating new services or handlers for commands.
TypeScanners Gets list of all known type scanners.

Following ModelMetadataProviders configuration options are available:

Option Description
MarkRequiredFields Set true to add translation returned from RequiredFieldResource for required fields.
ReplaceProviders Gets or sets a value to replace ModelMetadataProvider to use new db localization system.
RequiredFieldResource If MarkRequiredFields is set to true, return of this method will be used to indicate required fields (added at the end of label).
UseCachedProviders Gets or sets a value to use cached version of ModelMetadataProvider.

After then you will need to make sure that you start using the provider:

public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
        ...
    }

    public void Configure(IApplicationBuilder app, IHostingEnvironment env)
    {
        ...

        app.UseDbLocalizationProvider();
    }
}

Using localization provider will make sure that resources are discovered and registered in the database (if this process will not be disabled via AddDbLocalizationProvider() method by setting ConfigurationContext.DiscoverAndRegisterResources to false).

Working with [LocalizedResource] & [LocalizedModel] Attributes

For more information on how localized resources and localized models are working - please read docs in main package repo.

Adding Additional Cultures

Localization is all about translations into multiple languages. So it's often required to add more supported languages to the application. LocalizationProvider uses RequestLocalizationOptions to understand what languages application is supporting. You can configure this setting using ConfigureServices startup method.

public void ConfigureServices(IServiceCollection services)
{
    ...
    // just adding English and Latvian support
    services.Configure<RequestLocalizationOptions>(opts =>
    {
        var supportedCultures = new List<CultureInfo>
                                {
                                    new CultureInfo("en"),
                                    new CultureInfo("lv")
                                };

        opts.DefaultRequestCulture = new RequestCulture("en");
        opts.SupportedCultures = supportedCultures;
        opts.SupportedUICultures = supportedCultures;
    });
}

Add AdminUI

For adding AdminUI to your application - refer to instructions here.

You can’t perform that action at this time.