🎯 Giriş

ABP Framework, güçlü bir yerelleştirme (localization) altyapısı ile gelir. Ancak varsayılan olarak çeviri metinleri .json dosyalarında sabitlenmiştir. Bu yapı, çevrimiçi yönetim paneli üzerinden dil içeriğini değiştirme, çok kiracılı uygulamalarda tenant bazlı çeviri sağlama gibi esneklikler sunmaz.

Bu yazıda, ABP Framework’te dinamik olarak veritabanı destekli lokalizasyon işlemini nasıl gerçekleştirebileceğimizi adım adım ele alacağız. Örnek olarak oluşturulmuş AbpDynamicResourceManagement projesinden kod parçalarıyla ilerleyeceğiz.

🧱 Genel Mimari

Dinamik lokalizasyon sistemi şu temel bileşenlerden oluşur:

• Language: Tanımlı dillerin tutulduğu entity
• LanguageText: Her dile ait çevirilerin tutulduğu entity
• ILanguageTextRepository: Veri erişim işlemleri için repository arayüzü
• DynamicLocalizationResourceContributor: ABP'nin localization pipeline’ına entegre edilen özel sağlayıcı
• AbpLocalizationOptions.GlobalContributors: Yeni provider’ı tanıtan yapılandırma

🗣️ Dil Tanımı: Language Entity'si

public class Language : FullAuditedAggregateRoot<Guid>, ILanguageInfo, IMultiTenant
{
    public Guid? TenantId { get; private set; }
    public string CultureName { get; protected set; }
    public string UiCultureName { get; protected set; }
    public string DisplayName { get; protected set; }
    public string? FlagIcon { get; set; }
    public bool IsEnabled { get; set; }
    
    // ...
}

Bu sınıf, sistemdeki dillerin tanımlandığı temel varlıktır. Çoklu tenant desteği için IMultiTenant arayüzü uygulanmıştır.

📝 Çeviri Metinleri: LanguageText Entity'si

public class LanguageText : AuditedAggregateRoot<Guid>, IMultiTenant
{
    public string ResourceName { get; set; }
    public string CultureName { get; set; }
    public string Name { get; set; }
    public string Value { get; set; }
    // ...
}

Her bir çeviri metni, ilgili kültür (CultureName) ve anahtar (Name) ile ilişkilendirilmiştir. Örneğin:

| CultureName | Name | Value | | ----------- | ------------ | ------- | | tr | HelloMessage | Merhaba | | en | HelloMessage | Hello |

📦 Repository Katmanı

Arayüz

public interface ILanguageTextRepository : IRepository<LanguageText, Guid>
{
    Task<LanguageText> GetdByCultureNameAndNameAsync(string cultureName, string name);
    Task<List<LanguageText>> GetListByCultureNameAsync(string cultureName);
}

Uygulama

public class LanguageTextRepository : EfCoreRepository<AbpDynamicResourceManagementDbContext, LanguageText, Guid>, ILanguageTextRepository
{
    public async Task<LanguageText> GetdByCultureNameAndNameAsync(string cultureName, string name)
    {
        var dbSet = await GetDbSetAsync();
        return await dbSet.FirstOrDefaultAsync(l => l.CultureName == cultureName && l.Name == name);
    }

    public async Task<List<LanguageText>> GetListByCultureNameAsync(string cultureName)
    {
        var dbSet = await GetDbSetAsync();
        return await dbSet.Where(l => l.CultureName == cultureName).ToListAsync();
    }
}

Bu sınıf, veritabanı üzerinden dil verilerine ulaşmak için gerekli temel metodları sağlar.

🧩 ABP’ye Entegrasyon: DynamicLocalizationResourceContributor

public class DynamicLocalizationResourceContributor : ILocalizationResourceContributor
{
    private ILanguageTextRepository _languageTextRepository;

    public void Initialize(LocalizationResourceInitializationContext context)
    {
        _languageTextRepository = context.ServiceProvider.GetRequiredService<ILanguageTextRepository>();
    }

    public void Fill(string cultureName, Dictionary<string, LocalizedString> dictionary)
    {
        var texts = AsyncHelper.RunSync(() => _languageTextRepository.GetListByCultureNameAsync(cultureName));
        foreach (var item in texts)
        {
            dictionary[item.Name] = new LocalizedString(item.Name, item.Value);
        }
    }

    public async Task FillAsync(string cultureName, Dictionary<string, LocalizedString> dictionary)
    {
        var texts = await _languageTextRepository.GetListByCultureNameAsync(cultureName);
        foreach (var item in texts)
        {
            dictionary[item.Name] = new LocalizedString(item.Name, item.Value);
        }
    }

    public LocalizedString? GetOrNull(string cultureName, string name)
    {
        var item = AsyncHelper.RunSync(() => _languageTextRepository.GetdByCultureNameAndNameAsync(cultureName, name));
        return item == null ? null : new LocalizedString(name, item.Value);
    }

    public async Task<IEnumerable<string>> GetSupportedCulturesAsync()
    {
        return (await _languageTextRepository.GetListAsync()).Select(x => x.CultureName).Distinct();
    }
}

Bu sınıf, ABP’nin localization altyapısına bağlanarak .json yerine veritabanından verileri alır.

⚙️ Modül Yapılandırması

public class AbpDynamicResourceManagementDomainModule : AbpModule
{
    public override void ConfigureServices(ServiceConfigurationContext context)
    {
        Configure<AbpLocalizationOptions>(options =>
        {
            options.Languages.Add(new LanguageInfo("en", "en", "English"));
            options.Languages.Add(new LanguageInfo("tr", "tr", "Türkçe"));

            options.GlobalContributors.Add<DynamicLocalizationResourceContributor>();
        });
    }
}

GlobalContributors koleksiyonuna DynamicLocalizationResourceContributor eklenerek sistemde kullanılacak lokalizasyon sağlayıcısı tanıtılır.

🧪 Kullanım Örneği

Bir sayfada lokalize bir mesaj göstermek istediğinizde ABP’nin sağladığı IStringLocalizer ya da IStringLocalizerFactory kullanılabilir:

public class MyService : ITransientDependency
{
    private readonly IStringLocalizer<TestResource> _localizer;

    public MyService(IStringLocalizer<TestResource> localizer)
    {
        _localizer = localizer;
    }

    public void Foo()
    {
        var str = _localizer["HelloWorld"];
    }
}

🧩 Çok Kiracılı (Multi-Tenant) Destek

Her iki entity (Language, LanguageText) IMultiTenant arayüzünü uyguladığı için ABP’nin tenant filtreleme altyapısından otomatik olarak faydalanır.

📌 Sonuç

Bu yapı sayesinde:

• .json dosyalarına bağlı kalmadan içerikleri dinamik olarak yönetebilirsiniz.
• Yönetici paneli üzerinden canlı dil güncellemeleri yapabilirsiniz.
• Her tenant için farklı dil çevirileri sunabilirsiniz.

ABP Framework’ün sunduğu altyapı ile birlikte dinamik lokalizasyon, özellikle SaaS mimarilerinde çok güçlü bir özelliktir.

🎯 Amaç

Bu yazıda, ABP Framework kullanan bir Single Layer Razor Pages projesinde kullanıcıya özel ayarların nasıl yönetileceğini öğreneceğiz. Örnek senaryo olarak kullanıcıların açık veya koyu tema tercihini uygulama arayüzüne yansıttığımız bir yapı geliştireceğiz.

🧩 Bu uygulamayla neler yapacağız?

• Her kullanıcı kendi tema tercihini seçebilecek
• Seçilen tema veritabanında kullanıcıya özel olarak saklanacak
• Kullanıcı uygulamaya tekrar girdiğinde, seçtiği tema otomatik olarak yüklenecek

Bu senaryo, kişisel ayarların kullanıcı bazlı nasıl yönetileceğini ve ABP Framework’ün ISettingManager servisiyle nasıl çalıştığını pratik bir şekilde gösterecek.

📁 Proje Yapısı

UserBasedSetting.Web/
├── Pages/
│ ├── Index.cshtml / Index.cshtml.cs
│ └── Settings.cshtml / Settings.cshtml.cs
├── Settings/
│ ├── UserSettings.cs
│ └── UserThemeSettingDefinitionProvider.cs
└── UserBasedSettingWebModule.cs

📌 1. Ayar Anahtarının Tanımı

public static class UserSettings
{
    public const string PreferredTheme = "AbpUserBasedSetting.User.PreferredTheme";
}

🧠 2. Ayar Tanımını Kaydet (UserThemeSettingDefinitionProvider)

public class UserThemeSettingDefinitionProvider : SettingDefinitionProvider
{
    public override void Define(ISettingDefinitionContext context)
    {
        context.Add(
            new SettingDefinition(
                UserSettings.PreferredTheme,
                defaultValue: "light",
                isVisibleToClients: true
            )
        );
    }
}

⚙️ 3. Ayar Sağlayıcısını Module Sınıfında Kaydet

Configure<AbpSettingOptions>(options =>
{
    options.DefinitionProviders.Add<UserThemeSettingDefinitionProvider>();
});

💾 4. Tema Seçimi Sayfası (Settings.cshtml)

📄 Pages/Settings.cshtml

@page
@model AbpUserBasedSetting.Pages.SettingsModel
@{
}

<h3>Theme Preferences</h3>

<form method="post">
    <select name="theme" asp-for="Theme">
        <option value="light">Light Theme</option>
        <option value="dark">Dark Theme</option>
    </select>
    <button type="submit">Save</button>
</form>

📄 Pages/Settings.cshtml.cs

[Authorize]
public class SettingsModel : PageModel
{
    private readonly ISettingManager _settingManager;
    private readonly ICurrentUser _currentUser;

    public SettingsModel(ISettingManager settingManager, ICurrentUser currentUser)
    {
        _settingManager = settingManager;
        _currentUser = currentUser;
    }

    [BindProperty]
    public string Theme { get; set; }


    public async Task OnGetAsync()
    {
        if (_currentUser.IsAuthenticated)
        {
            Theme = await _settingManager.GetOrNullForUserAsync(UserSettings.PreferredTheme, _currentUser.Id.Value);
        }
    }

    public async Task<IActionResult> OnPostAsync()
    {
        if (_currentUser.IsAuthenticated)
        {
            await _settingManager.SetForUserAsync(_currentUser.Id.Value, UserSettings.PreferredTheme, Theme);
        }

        return RedirectToPage("/Index");
    }
}

🏠 5. Tema Uygulaması (Ana Sayfa Index.cshtml)

📄 Pages/Index.cshtml

@{
    var theme = Model.Theme ?? "light";
}
<a href="/settings" class="btn btn-primary mb-2 mt-2 ml-2 @theme">Settings</a>

📄 Pages/Index.cshtml.cs

public class IndexModel : AbpPageModel
{
    private readonly ISettingManager _settingManager;
    private readonly ICurrentUser _currentUser;

    public IndexModel(ISettingManager settingManager, ICurrentUser currentUser)
    {
        _settingManager = settingManager;
        _currentUser = currentUser;
    }

    public string Theme { get; set; }

    public async Task OnGetAsync()
    {
        if (_currentUser.IsAuthenticated)
        {
            Theme = await _settingManager.GetOrNullForUserAsync(UserSettings.PreferredTheme, _currentUser.Id.Value);
        }

        Theme ??= "light";
    }
}

📄 Pages/Index.cshtml.css

a.light {
    background-color: white;
    color: black;
}

a.dark {
    background-color: #121212;
    color: white;
}

🔍 Nasıl Çalışır? AbpUserBasedSetting.User.PreferredTheme adlı özel bir ayar tanımlanır. /Settings sayfasında kullanıcı tema tercihini belirler. Tercih ISettingManager.SetForUserAsync ile kullanıcıya özel kaydedilir. /Index sayfası açıldığında tema tercihi uygulanır.

🚀 Kurulum Adımları

1. Repoyu Klonla

git clone https://github.com/icagatay/AbpUserBasedSetting.git
cd AbpUserBasedSetting

2. Veritabanı Güncelle ve Projeyi Başlat

dotnet ef database update
dotnet run

🎉 Sonuç Bu örnekle, ABP Framework’te ISettingManager kullanarak kullanıcı bazlı ayarların nasıl geliştirileceğini pratik bir şekilde uyguladık. Benzer şekilde dil tercihi, e-posta bildirim tercihi gibi birçok kişisel ayarı da aynı yöntemle yönetebilirsiniz.

ABP Framework: Paylaşımlı Hosting Ortamında PFX Sertifikası Olmadan OpenIddict Yayınlamak

🎯 Amaç

Bu repo, ABP Framework kullanılarak geliştirilen bir uygulamanın paylaşımlı hosting ortamında .pfx sertifikasına ihtiyaç duymadan OpenIddict ile token imzalama işlemini nasıl gerçekleştireceğini gösterir.

⚠️ Neden .pfx Dosyası Sorun Olur?

Paylaşımlı hosting ortamlarında:

• .pfx dosyasını okumak genellikle yasaktır,
• Uygulama başlatılamaz veya token üretimi başarısız olur.

✅ Çözüm: Kalıcı RSA Anahtarı ile Sertifikasız Token İmzalama

OpenIddict, .pfx yerine kalıcı bir RSA özel anahtar dosyasını (PEM) doğrudan kabul eder.

1. RSA Anahtarı Oluştur

openssl genpkey -algorithm RSA -out signing-key.pem -pkeyopt rsa_keygen_bits:2048

Oluşan dosyayı keys/ klasörüne yerleştirin.

2. Anahtarı Yükle (C#)

using System.Security.Cryptography;

public static class RsaKeyLoader
{
    public static RSA LoadPrivateKey(string filePath)
    {
        var keyBytes = File.ReadAllBytes(filePath);
        var rsa = RSA.Create();
        rsa.ImportFromPem(System.Text.Encoding.UTF8.GetString(keyBytes));
        return rsa;
    }
}

ImportFromPem() .NET 5+ sürümlerinde desteklenir.

3. OpenIddict’e Entegre Et

MyProjectWebModule dosyasında:

PreConfigure<OpenIddictServerBuilder>(builder =>
{
    var rsa = RsaKeyLoader.LoadPrivateKey(Path.Combine("keys", "signing-key.pem"));

    builder.AddSigningKey(new RsaSecurityKey(rsa)
    {
        KeyId = "my-signing-key"
    });
});

Güvenlik Tavsiyeleri keys/signing-key.pem dosyasını .gitignore ile gizleyin:

/keys/*.pem

Üretim ortamında bu dosyayı kimseyle paylaşmayın.