XperienceCommunity.Localization 1.0.7-pre.903c108

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

// Install XperienceCommunity.Localization as a Cake Tool
#tool nuget:?package=XperienceCommunity.Localization&version=1.0.7-pre.903c108&prerelease                

XperienceCommunity.Localization

CI: Build and Test Localization NuGet Package

Description

This project enables creating and using localizations and translations in Xperience by Kentico project. Create translations in Xperience admin UI or programatically and use in your pages.

Screenshots

Administration localization edit form Administration translation edit form Administration key listing page Administration translation listing page

Library Version Matrix

Xperience Version Library Version
>= 28.4.3 1.0.0

Dependencies

Package Installation

Add the package to your application using the .NET CLI

dotnet add package XperienceCommunity.Localization

Quick Start

  1. Add this library to the application services.

    // Program.cs
     builder.Services.AddNittinLocalization();
    
  2. Create a localization key in Xperience's Administration within the Localization application added by this library. Administration localization edit form

  3. Create a translation for this key in Xperience's Administration within the Localization application added by this library. Administration translation edit form

  4. Display the results on your site with a ViewComponent.

    
    // ViewModelLocalizedWidgetViewComponent.cs
    private readonly IKenticoStringLocalizer localizer;

    public ViewModelLocalizedWidgetViewComponent(IKenticoStringLocalizer localizer)
        => this.localizer = localizer;

    public IViewComponentResult Invoke()
    {
        var model = new ViewModelLocalizedWidgetViewModel
        {
            Title = localizer["Title"],
            Content = localizer["Content"]
        };

        return View("~/Components/Widgets/ViewModelLocalizedWidget/_ViewModelLocalizedWidget.cshtml", model);
    }

Administration string localizer example

  1. Or display the results on your site with a Razor View 👍

@using XperienceCommunity.Localization

@inject IKenticoHtmlLocalizer localizer

<div>
    <h1>@localizer["Title"]</h1>
    <p>@localizer["Content"]</p>
</div>

Administration html localizer example

Contributing

Instructions and technical details for contributing to this project can be found in Contributing Setup.

License

Distributed under the MIT License. See LICENSE.md for more information.

Support

This project has Limited support.

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 (1)

Showing the top 1 NuGet packages that depend on XperienceCommunity.Localization:

Package Downloads
XperienceCommunity.Baseline.Localization.Admin.Xperience

The Baseline a set of Core Systems, Tools, and Structure to ensure a superior Kentico Website that's easy to migrate, for Kentico Xperience 13 and eventually Xperience by Kentico

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
2.0.0 66 12/20/2024
1.4.1 188 10/18/2024
1.4.1-pre.9c79180 82 10/18/2024
1.4.1-pre.782df4b 74 10/18/2024
1.4.1-pre.501b2b6 71 10/18/2024
1.2.2 255 7/11/2024
1.2.2-pre.e63914d 74 10/18/2024
1.2.2-pre.95a5373 38 7/11/2024
1.2.2-pre.8fa780a 52 7/11/2024
1.2.2-pre.614044a 68 10/18/2024
1.2.2-pre.2a9f442 70 10/18/2024
1.2.2-pre.107ba0f 38 7/11/2024
1.2.1 92 7/11/2024
1.2.1-pre.db6a0d4 53 7/11/2024
1.2.1-pre.8fa780a 53 7/11/2024
1.1.1 348 5/15/2024
1.1.1-pre.5b89503 53 5/14/2024
1.1.1-pre.2aea3c9 40 7/11/2024
1.0.7-pre.bb77ad6 57 5/14/2024
1.0.7-pre.903c108 64 5/14/2024
1.0.6 110 5/14/2024
1.0.6-pre.bb77ad6 52 5/14/2024
1.0.4 103 5/14/2024
1.0.4-pre.5b89503 48 5/14/2024