Dokümantasyon: intlayer İçindeki getLocalizedPath Fonksiyonu

Açıklama

getLocalizedPath fonksiyonu, verilen locale ve yeniden yazma (rewrite) kurallarına göre bir canonical path'i (uygulama içi yol) hedef dildeki karşılığına çözer. Dil bazlı olarak değişen, SEO dostu URL'ler üretmek için özellikle faydalıdır.

Temel Özellikler:

• [param] sözdizimini kullanarak dinamik rota parametrelerini destekler.
• Yapılandırmanızda tanımlı özel rewrite kurallarına göre yolları çözer.
• Belirtilen locale için herhangi bir rewrite kuralı bulunmazsa otomatik olarak canonical path'e geri dönüşü (fallback) yönetir.

Fonksiyon İmzası

getLocalizedPath(
  canonicalPath: string,         // Gerekli
  locale: Locales,               // Gerekli
  rewriteRules?: RoutingConfig['rewrite'] // İsteğe bağlı
): string

Parametreler

Gerekli Parametreler

• canonicalPath: string

  • Açıklama: Dahili uygulama yolu (ör. /about, /product/[id]).
  • Tür: string
  • Gerekli: Evet

• locale: Locales

  • Açıklama: Yolun yerelleştirileceği hedef yerel.
  • Tür: Locales
  • Gerekli: Evet

İsteğe Bağlı Parametreler

• rewriteRules?: RoutingConfig['rewrite']
  • Açıklama: Özel yeniden yazma kurallarını tanımlayan bir nesne. Sağlanmazsa, proje yapılandırmanızdaki routing.rewrite özelliği varsayılan olarak kullanılır.
  • Tür: RoutingConfig['rewrite']
  • Varsayılan: configuration.routing.rewrite

Dönüş Değeri

• Tür: string
• Açıklama: Belirtilen yerel için yerelleştirilmiş yol.

Örnek Kullanım

Temel Kullanım (Yapılandırma ile)

Eğer intlayer.config.ts dosyanızda özel yeniden yazma kuralları yapılandırdıysanız:

import { getLocalizedPath, Locales } from "intlayer";

// Configuration: { '/about': { en: '/about', fr: '/a-propos' } }
getLocalizedPath("/about", Locales.FRENCH);
// Output: "/a-propos"

getLocalizedPath("/about", Locales.ENGLISH);
// Output: "/about"

Dinamik Rotalarla Kullanım

import { getLocalizedPath, Locales } from "intlayer";

// Configuration: { '/product/[id]': { en: '/product/[id]', fr: '/produit/[id]' } }
getLocalizedPath("/product/123", Locales.FRENCH);
// Output: "/produit/123"

Manuel Yeniden Yazma Kuralları

Ayrıca fonksiyona manuel yeniden yazma kuralları da geçebilirsiniz:

import { getLocalizedPath, Locales } from "intlayer";

const manualRules = {
  "/contact": {
    en: "/contact-us",
    fr: "/contactez-nous",
  },
};

getLocalizedPath("/contact", Locales.FRENCH, manualRules);
// Output: "/contactez-nous"

İlgili Fonksiyonlar

• getCanonicalPath: Yerelleştirilmiş bir yolu dahili kanonik yoluna çözer.
• getLocalizedUrl: Tam yerelleştirilmiş bir URL oluşturur (protokol, host ve dil öneki dahil).