Intlayer İçerik Yönetim Sistemi (CMS) Dokümantasyonu

Intlayer CMS, bir Intlayer projesinin içeriğini dışa aktarmanıza izin veren bir Uygulamadır.

Bunun için, Intlayer 'uzak sözlükler' kavramını tanıtır.

Uzak sözlükleri anlama

Intlayer 'yerel' ve 'uzak' sözlükler arasında bir ayrım yapar.

• Bir 'yerel' sözlük, Intlayer projenizde bildirilen bir sözlüktür. Örneğin bir düğmenin bildirim dosyası veya navigasyon çubuğunuz. Bu durumda içeriğinizi dışa aktarmak mantıklı değildir çünkü bu içerik sık sık değişmemelidir.

• Bir 'uzak' sözlük, Intlayer CMS aracılığıyla yönetilen bir sözlüktür. Ekibinizin içeriğinizi doğrudan web sitenizde yönetmesine izin vermek için yararlı olabilir ve ayrıca A/B testi özelliklerini ve SEO otomatik optimizasyonunu kullanmayı amaçlar.

Görsel düzenleyici vs CMS

Intlayer Görsel düzenleyici, yerel sözlükler için içeriğinizi görsel bir düzenleyicide yönetmenize izin veren bir araçtır. Bir değişiklik yapıldığında, içerik kod tabanında değiştirilecektir. Bu, uygulamanın yeniden oluşturulacağı ve yeni içeriği görüntülemek için sayfanın yeniden yükleneceği anlamına gelir.

Buna karşılık, Intlayer CMS, uzak sözlükler için içeriğinizi görsel bir düzenleyicide yönetmenize izin veren bir araçtır. Bir değişiklik yapıldığında, içerik kod tabanınızı etkilemeyecektir. Ve web sitesi değiştirilen içeriği otomatik olarak görüntüleyecektir.

Entegrasyon

Paketi nasıl yükleyeceğiniz hakkında daha fazla ayrıntı için aşağıdaki ilgili bölüme bakın:

Next.js ile Entegrasyon

Next.js ile entegrasyon için kurulum kılavuzuna bakın.

Create React App ile Entegrasyon

Create React App ile entegrasyon için kurulum kılavuzuna bakın.

Vite + React ile Entegrasyon

Vite + React ile entegrasyon için kurulum kılavuzuna bakın.

Konfigürasyon

Intlayer konfigürasyon dosyanızda, CMS ayarlarını özelleştirebilirsiniz:

import type { IntlayerConfig } from "intlayer";const config: IntlayerConfig = {  // ... diğer konfigürasyon ayarları  editor: {    /**     * Gerekli     *     * Uygulamanın URL'si.     * Bu, görsel düzenleyici tarafından hedeflenen URL'dir.     */    applicationURL: process.env.INTLAYER_APPLICATION_URL,    /**     * Gerekli     *     * İstemci kimliği ve istemci sırrı düzenleyiciyi etkinleştirmek için gereklidir.     * İçeriği düzenleyen kullanıcıyı tanımlamaya izin verirler.     * Intlayer Dashboard - Projects'te yeni bir istemci oluşturarak elde edilebilirler (https://intlayer.org/dashboard/projects).     * clientId: process.env.INTLAYER_CLIENT_ID,     * clientSecret: process.env.INTLAYER_CLIENT_SECRET,     */    clientId: process.env.INTLAYER_CLIENT_ID,    clientSecret: process.env.INTLAYER_CLIENT_SECRET,    /**     * İsteğe bağlı     *     * Intlayer CMS'yi kendiniz barındırıyorsanız, CMS'nin URL'sini ayarlayabilirsiniz.     *     * Intlayer CMS'nin URL'si.     * Varsayılan olarak https://intlayer.org olarak ayarlanır     */    cmsURL: process.env.INTLAYER_CMS_URL,

İstemci kimliğiniz ve istemci sırrınız yoksa, Intlayer Dashboard - Projects'te yeni bir istemci oluşturarak bunları elde edebilirsiniz.

Tüm kullanılabilir parametreleri görmek için konfigürasyon dokümantasyonuna bakın.

CMS'yi Kullanma

Konfigürasyonunuzu gönderin

Intlayer CMS'yi yapılandırmak için intlayer CLI komutlarını kullanabilirsiniz.

npx intlayer config push

intlayer.config.ts konfigürasyon dosyanızda ortam değişkenleri kullanıyorsanız, --env argümanını kullanarak istenen ortamı belirtebilirsiniz:

npx intlayer config push --env production

Bu komut konfigürasyonunuzu Intlayer CMS'ye yükler.

Bir sözlüğü gönderin

Yerel ayar sözlüklerinizi uzak bir sözlüğe dönüştürmek için intlayer CLI komutlarını kullanabilirsiniz.

npx intlayer dictionary push -d my-first-dictionary-key

intlayer.config.ts konfigürasyon dosyanızda ortam değişkenleri kullanıyorsanız, --env argümanını kullanarak istenen ortamı belirtebilirsiniz:

npx intlayer dictionary push -d my-first-dictionary-key --env production

Bu komut ilk içerik sözlüklerinizi yükler, bunları Intlayer platformu aracılığıyla eşzamansız alma ve düzenleme için kullanılabilir hale getirir.

Sözlüğü düzenleyin

Ardından sözlüğünüzü Intlayer CMS'de görebilir ve yönetebilirsiniz.

Sıcak yeniden yükleme

Intlayer CMS, bir değişiklik algılandığında sözlükleri sıcak yeniden yükleyebilir.

Sıcak yeniden yükleme olmadan, yeni içeriği görüntülemek için uygulamanın yeni bir yapısı gerekecektir.

liveSync konfigürasyonunu etkinleştirerek, uygulama algılandığında güncellenen içeriği otomatik olarak değiştirecektir.

import type { IntlayerConfig } from "intlayer";const config: IntlayerConfig = {  // ... diğer konfigürasyon ayarları  editor: {    // ... diğer konfigürasyon ayarları    /**     * Bir değişiklik algılandığında uygulamanın yerel ayar konfigürasyonlarını sıcak yeniden yükleyip yüklemeyeceğini belirtir.     * Örneğin, yeni bir sözlük eklendiğinde veya güncellendiğinde, uygulama sayfada görüntülemek için içeriği günceller.     *     * Sıcak yeniden yükleme sunucuya sürekli bir bağlantı gerektirdiği için, sadece `enterprise` planının müşterileri için kullanılabilir     *     * Varsayılan: false     */    liveSync: true,  },};export default config;

Sıcak yeniden yükleme içeriği hem sunucu hem de istemci tarafında değiştirir.

• Sunucu tarafında, uygulama sürecinin .intlayer/dictionaries dizinine yazma erişimi olduğundan emin olun.
• İstemci tarafında, sıcak yeniden yükleme uygulamanın içeriği tarayıcıda sıcak yeniden yüklemesine izin verir, sayfayı yeniden yüklemeye gerek olmadan. Ancak, bu özellik sadece istemci bileşenleri için kullanılabilir.

Sıcak yeniden yükleme bir EventListener kullanarak sunucuya sürekli bir bağlantı gerektirdiği için, sadece enterprise planının müşterileri için kullanılabilir.

Hata Ayıklama

CMS ile ilgili herhangi bir sorunla karşılaşırsanız, aşağıdakileri kontrol edin:

• Uygulama çalışıyor.

• editor konfigürasyonları Intlayer konfigürasyon dosyanızda doğru şekilde ayarlandı.

  • Gerekli alanlar:
    • Uygulama URL'si düzenleyici konfigürasyonunda ayarladığınızla eşleşmelidir (applicationURL).
    • CMS URL'si

• Proje konfigürasyonunun Intlayer CMS'ye gönderildiğinden emin olun.

• Görsel düzenleyici web sitenizi görüntülemek için bir iframe kullanır. Web sitenizin İçerik Güvenlik Politikası'nın (CSP) CMS url'sini frame-ancestors olarak izin verdiğinden emin olun (varsayılan olarak 'https://intlayer.org'). Herhangi bir hata için düzenleyici konsolu kontrol edin.

Doküman Geçmişi