Dil dosyasına zarar vermeden eklenti kurmak

[ALEXIS]

Ön bilgiler

Dil dosyamız, süreklilik arz eden bir gelişim ve güncelleme sürecindedir. Bazı eklentiler dil dosyası değişikliklerine ve eklemeline sahiptir. Bu değişiklikleri yaptığımızda dil dosyasının bütünlüğü zarar görmüş olur.

Dil dosyalarımız için güncelleme yayınlamak çok fazla değişiklik olduğu için çok zor olmakta. Dosya güncellendiğinde, bu güncellemeyi en kolay adapte etmek için, eklediğiniz eklentilerin dil değişiklikleri ön gördükleri şekilde değil, bu konuda yazacağım şekilde eklemelisiniz.


Giriş

Dil dosyaları birer betik dosyasıdır, betikler web sunucu tarafından yukarıdan aşağıya doğru okunur ve okuma bitiğinde kullanıcıya gönderilir.

Dil dosyasına geçmeden önce olayın mantığını anlamanız için basit bir php örneği vereyim:

Kod: Tümünü seç

$degisken = 'kullanıcı';
$degisken = 'üye';
echo $degisken; 

Kodların sonundaki echo, hangi değişkeni yazar? Elbette ikinci değişken olan "üye" ifadesini yazar. Yukarıdan aşağı okurken, ilk değişken ikinci değişken tarafından değiştirildi (replace edildi). İşte dil dosyamızdaki değişikleri bu mantığa göre yapacağız.


Dil dosyası değişiklikleri

Şimdi yukarıdaki mantığı dil dosyamıza uygulayalım. Eklentimiz aşağıdaki dil değişikliğini ön görsün:

[ AÇ ]

language/tr/common.php

[ BUL ]

Kod: Tümünü seç

   'FORUM_INDEX'         => 'Pano anasayfası',

[ BUNUNLA DEĞİŞTİR ]

Kod: Tümünü seç

   'FORUM_INDEX'         => 'Mesaj panosu',

[ BİTTİ ]

Bu değişikliği dil dosyamıza zarar vermeden, orjinalliğini bozmadan çalışabileceğimiz bir şekle dönüştürelim, bu dönüştürme işlemini ayrı bir belge de değil, direk mantık çerçevesinde dosya içinde uygulayın:

[ AÇ ]

language/tr/common.php

[ BUL ]

Kod: Tümünü seç

?>

[ ÖNCESİNE EKLE ]

Kod: Tümünü seç

$lang = array_merge($lang, array(
   // xxx eklentisi 1.0.0
   'FORUM_INDEX'         => 'Mesaj panosu',
));

[ BİTTİ ]

Bu değişiklik FORUM_INDEX değişkenine, önceki ifadeleri değiştirerek "Mesaj panosu" ifadesini atayacaktır.


Yararı nedir, nasıl kullanılır

Bu tür bir uygulamanın yararı, orijinal dil dosyasına zarar vermeden istediğiniz değişiklikleri ve eklemeleri yapmış olursunuz. Dil dosyası güncellendiğinde, güncelleme için yapmanız gereken tek işlem, yeni dil dosyalarına, eskilerin sonundaki toplu alanı yapıştırmak olacak sadece. Bu güncelleme için harcayacağız zamanı kısaltacak, kafanızı da hiç karıştırmayacak.

Mesela, common.php dosyasının sonuna ben iki alan açtım, ilk alana DEĞİŞTİR tarzı kodları, ikinci alana ise EKLE tarzı kodları yapıştırıyorum:

Kod: Tümünü seç

//----------- [ DEĞİŞİKLİKLER ] ------------------------------------------------------
//

$lang = array_merge($lang, array(
    // xxx eklentisi 1.0.0
    'FORUM_INDEX'            => 'Mesaj panosu',
));


//----------- [ EKLEMELER ] -----------------------------------------------------------
//

$lang = array_merge($lang, array(
    // deneme eklentisi 1.0.0
    'DENEME'        => 'Deneme',
    'DENEME_INDEX'    => 'Deneme Sayfası',
));

//
//----------- [ DOSYA SONU ] ----------------------------------------------------------    

[sabri ünal kullanıcı]

bu konuya ilave olarak ben bir include mantığı önermiştim, lakin önerdiğim başlığı bulamıyorum...

tekrar etmek gerekirse, bütün dil dosyaları ile aynı ismi taşıyan bir de mods klasörü içinde oluşturalım, ve dil dosyalana yapacağımız ilaveleri o dosyalara yapalım

bütün dosyalar da kendi isimleri ile aynı olan bir mods/ilgili dosya .php dosyasını çeksinler!

[ALEXIS]

[ AÇ ]

language/tr/common.php

[ BUL ]

Kod: Tümünü seç

?>

[ ÖNCESİNE EKLE ]

Kod: Tümünü seç

// değişiklik ve eklemeler
include('mods/lang/common.' . $phpEx);

[ OLUŞTUR VE AÇ ]

language/tr/mods/lang/common.php

[ İÇERİK ]

Kod: Tümünü seç

<?php
/**
* @version $Id$
* @author Sevdin Filiz,
* @copyright (c) 2008, Canver Software
*/

/**
* @ignore
*/
if (!defined('IN_PHPBB'))
{
   exit;
}

if (empty($lang) || !is_array($lang))
{
   $lang = array();
}


//----------- [ DEĞİŞİKLİKLER ] ------------------------------------------------------
//

$lang = array_merge($lang, array(
    // xxx eklentisi 1.0.0
    'FORUM_INDEX'            => 'Mesaj panosu',
));


//----------- [ EKLEMELER ] -----------------------------------------------------------
//

$lang = array_merge($lang, array(
    // deneme eklentisi 1.0.0
    'DENEME'        => 'Deneme',
    'DENEME_INDEX'    => 'Deneme Sayfası',
));

//
//----------- [ DOSYA SONU ] ----------------------------------------------------------   

?>

[muiketi]

aslında yeri değil ve kou dışına çıkmış olacağım üzgünüm..

sorum şu.. ilk iletidekine benzer uygulamayı functions.php dosyasında ve/veya diğer dosyalarda da yapabilir miyiz.. yani sözkonusu dosyalarda buna benzer değişikliği yapmamız sorun çıkarır mı?

[ALEXIS]

Kendinize ait fonksiyonları function.php ye ekleyebilirsiniz. Ancak eklentiler dağınık bir yapıya sahiptir, bunun için sorunuz yetersiz kalmakta.

Mesela, lendimizin yazdığı bir fonksiyonu functions.php sonuna ekleyerek istediğimiz tüm dosyalardan çağırabiliriz.

Ya da functions.php sonuna include ile kendi fonksiyon dosyamızı ekleyebiliriz.

[set kullanıcı]

Tüm denilenleri yaptım ama yinede aynı hatayı aldım bunu başka bir şekilde yapma şansımız yok mu yada siz sonuna nasıl eklendiğini kodları koyarak gösetrseniz mümkün mü

[ALEXIS]

Hangi aynı hata ?

[set kullanıcı]

Ha onu çözdüm diğer başlıkta utf8 ve türkçelendirmede dosya vermişsiniz notepad++ onu yükledim onunla yapınca üstte çıkan founction.php ve common.php de verdiği hatalar çıkmadı tşk ederim bilgilendirme için