Rehber XenForo 2.3.10 – Geliştiriciler İçin Yenilikler

[XFSkins]

XenForo 2.3.10 dün yayınlandı ve geliştiriciler için oldukça işe yarar iki yenilik getiriyor: Phrase Araçları ve AI Skills Kurulumu. Gelin bu yeniliklere birlikte bakalım.

Phrase Araçları​

Eklenti geliştirirken en sık yaşanan sorunlardan biri, şablonlara ve PHP dosyalarına sabit metin (hardcoded string) yazıp sonradan bunları phrase'e çevirmeyi unutmaktır. XenForo 2.3.10 ile bu süreci otomatikleştiren üç yeni CLI komutu geldi.

Şablon Phraser'ı​

xf-dev:template-phraser komutu, eklentinizdeki şablonları tarayarak phrase'e dönüştürülmesi gereken sabit metinleri otomatik olarak tespit eder.

Açıklama:
  Şablonlardaki phrase değişikliklerini analiz eder ve uygular

Kullanım:
  xf-dev:template-phraser [seçenekler]
  xf-dev:phraser-template

Seçenekler:
      --addon=ADDON                  İşlenecek eklenti ID'si
      --template=TEMPLATE            type:title formatında şablon
      --all                          Eklentinin tüm şablonlarını işle (--template belirtilmezse varsayılan)
      --phrase-prefix=PHRASE-PREFIX  Oluşturulan phrase adları için ön ek
      --dry-run                      Yalnızca analiz et ve önizle; değişiklik uygulama
      --yes                          Onay istemlerini atla
      --json                         JSON olarak çıktı ver
      --preview-lines=PREVIEW-LINES  Her değişiklik etrafında bağlam satırı sayısı [varsayılan: 2]

Komutu --addon seçeneğiyle çalıştırdığınızda, eklentinizin geliştirme çıktısı taranır ve phrase'e dönüştürülmesi önerilen metinler listelenir. Şablon şablon gösterilen bu listeden istediğiniz değişiklikleri seçip uygulayabilirsiniz. Eğer tespit edilen metin zaten bir phrase olarak mevcutsa, doğrudan o phrase kullanılması önerilir.

Metnin birden fazla satıra yayıldığı veya HTML içerdiği durumlarda başlangıç ve bitişi açıkça belirtmek için çift tilde sınırlayıcısı kullanılır. Örneğin:

Edit note <b>{$note.title}</b>

Yukarıdaki satırın tamamının phrase'lenmesini istiyorsanız şu şekilde sarmalayın:

~~Edit note <b>{$note.title}</b>~~

Değişken interpolasyonu da desteklenmektedir.

xf-dev:template-modification-phraser komutu da aynı mantıkla çalışır; farkı şablon değişiklikleri (template modifications) üzerinde çalışmasıdır.

Dosya Phraser'ı​

PHP dosyaları için ise xf-dev:file-phraser komutu kullanılır. Şablon phraser'ından tek farkı, PHP dosyalarında phrase'lenecek metinlerin mutlaka ~~ ile sarmalanmış olması gerekmesidir; aksi takdirde tespit edilmez.

Açıklama:
  Eklenti PHP dosyalarındaki phrase değişikliklerini analiz eder ve uygular

Kullanım:
  xf-dev:file-phraser [seçenekler]
  xf-dev:phraser-file

Seçenekler:
      --addon=ADDON                  İşlenecek eklenti ID'si
      --file=FILE                    Eklenti köküne göreli tek dosya yolu
      --all                          Tüm phraseable dosyaları işle (--file belirtilmezse varsayılan)
      --phrase-prefix=PHRASE-PREFIX  Oluşturulan phrase adları için ön ek
      --dry-run                      Yalnızca analiz et; değişiklik uygulama
      --yes                          Onay istemlerini atla
      --json                         JSON olarak çıktı ver

Kullanılmayan Phrase'leri Bulma​

Eklentinizi geliştirdikçe ve kodu yeniden düzenledikçe artık kullanılmayan phrase'ler birikmeye başlar. xf-dev:unused-phrase-finder komutu bu phrase'leri tespit eder; --delete-all seçeneğiyle onay sonrasında hepsini temizleyebilirsiniz.

Açıklama:
  Bir eklentiye ait kullanılmayan master phrase'leri bulur ve isteğe bağlı olarak siler

Kullanım:
  xf-dev:unused-phrase-finder [seçenekler]

Seçenekler:
      --addon=ADDON     İşlenecek eklenti ID'si
      --json            JSON olarak çıktı ver
      --show-unknown    Bilinmeyen kullanılan phrase başlıklarını göster
      --delete=DELETE   Silinecek phrase ID/başlıkları (virgülle ayrılmış, yalnızca kullanılmayanlar)
      --delete-all      Kullanılmayan tüm phrase'leri sil
      --yes             Onay istemlerini atla

XenForo AI Skills Kurulumu​

XenForo gibi ticari ve kendine özgü mimarisi olan bir framework'te yapay zeka ajanlarıyla çalışmak çoğu zaman hayal kırıklığı yaratır. Ajan, XenForo'ya özgü desenleri bilmediği için yanlış veya hayali kod üretebilir.

Bu sorunu çözmek için XenForo 2.3.10, xf-dev:install-ai-agents komutunu getiriyor. Bu komut, kullandığınız yapay zeka ajanı için XenForo'ya özel kapsamlı bir talimat seti oluşturur ve dosyaları doğru konumlara yerleştirir.

Açıklama:
  Yapay zeka ajan kural dosyalarını kurar

Kullanım:
  xf-dev:install-ai-agents [seçenekler]

Seçenekler:
  -f, --force           Dosyalar zaten varsa üzerine yaz
      --with-claude     Varsayılan dosyaların yanı sıra Claude uyumlu dosyaları da kur
      --only-claude     Yalnızca Claude uyumlu dosyaları kur
      --dry-run         Değişiklik yapmadan hangi dosyaların yazılacağını göster

Seçenek belirtmeden çalıştırırsanız ChatGPT Codex veya Open Code gibi araçlarla uyumlu AGENTS.md dosyası oluşturulur. Yalnızca Claude kullanıyorsanız --only-claude, birden fazla araç arasında geçiş yapıyorsanız --with-claude seçeneğini kullanın.

Oluşturulan Dosyalar​

CLAUDE.md / AGENTS.md: Framework'e genel bakış, dosya konumları ve temel desenler. Skill'lerin özeti de burada yer alır.

xf-shared-policy: Geliştirme çıktı sistemi, xf-make komutları ve genel ilkeler.

xf-core-dev: XenForo çekirdek geliştirme kuralları (çoğunluk için gerekli değil).

xf-addon-dev: Eklenti ID'si, sürüm numaraları, .xml dosyalarına manuel müdahale edilmemesi gerektiği ve benzeri referanslar.

xf-scaffold-make: xf-make komutlarının ayrıntılı kullanımı ve yapılması/yapılmaması gerekenler.

xf-template-phrase: Şablon ve phrase sisteminin nasıl çalıştığı; XenForo şablon sözdizimi referansı.

---

Bu skill dosyaları bir arada, yapay zeka ajanlarıyla XenForo eklenti geliştirmeyi çok daha kararlı ve öngörülebilir hale getiriyor. Yine de ajanların ürettiği kodun her satırını gözden geçirmeyi ihmal etmeyin.