Impex ile adım adım forum geçiş rehberi

Impex ile Türkçe karaktere sahip forumları aktarmada sorun yaşayabilirsiniz. Bunun için Technopat olarak kapsamlı bir UTF-8 Impex kullanma kılavuzu hazırlamaya karar verdik.

• Kaynak Forum: PHPBB 3
• Hedef Forum: vBulletin v 4.0.8 PL2

Not: Başlamadan önce lütfen bütün hedef ve kaynak forum içeriğinizi (eklentiler vs.) ve veritabanınızı yedekleyin. Oluşacak herhangi bir veri kaybından dolayı Technopat sorumlu tutulamaz.

• Aktarım esnasında her iki forum da açık ve çalışır durumda olmalıdır.
• ImPex kesinlikle kaynak forumdaki verilerde herhangi bir değişiklik yapmaz. Verileri sadece okur.
• ImPex ile vBulletin 3.5.0 ve sonrasına aktarım yapabilirsiniz.
• ImPex’i çalıştırmak için sunucunuz PHP 4.3.3 veya üstü kullanıyor olmalıdır.
• Aktarmaya başlamadan önce ekler (Attachment) için depolama yerinin dosya sistemi yerine veritabanı olduğundan emin olun.
• Eğer sıfır bir vBulletin foruma aktarım yapıyorsanız forumda varsayılan olarak gelen konuyu silmeniz tavsiye edilir. Aksi takdirde aktarılan forumlar bu varsayılan konunun altına gelebilir.

1- Öncelikle vBulletin forum veritabanı kodlamasını (collation) PHP MyAdmin panelinden  utf8_bin olarak ayarlayın. Buradaki amaç Türkçe karakterle ilgili sorunları ortadan kaldırmak.

Bizim örneğimizde vBulletin 4.0.8 ve PHPBB 3 aynı veritabanını kullanıyordu.

2-

• CuteFTP gibi bir FTP istemcisi ile sunucunuza bağlanın ve forum klasörünüz içindeki /includes/config.php dosyasını açın
• Forumu halihazırda kurduğunuzu varsayıyoruz, şimdi forum-veritabanı bağlantınızı UTF-8 yapmanız gerekiyor.
• Bunun için en baştaki iki çizgiyi (//) silerek  bu kodu devreye sokun: // $config[‘Mysqli’][‘charset’] = ‘utf8’;  ()
• Dosyada yaptığınız değişiklikleri kaydedin.

3-

• http://members.vbulletin.com/ adresine girin ve ImPex 1.100 sürümünü ZIP olarak indirin.
• İnen dosyayı WinRAR ile klasöre çıkartın
• upload/impex/systems klasöründe kaynak forum türü hariç diğer bütün klasörleri silin
• Bizim örneğimizde kaynak forum PHPBB 3 olduğu için sadece phpBB3 klasörü ve index.html dosyasını bıraktık
• /upload/impex klasörünü açın ve ImpExConfig.php.new dosyasını bulup bu dosyanın sonundaki .new uzantısını kaldırın.
• Şimdi ImpExConfig.php dosyasını WordPad ile açın  (Notepad kullanmayın!) ve hem hedef hem de kaynak foruma ait veritabanı bilgilerini girin:

Target Database Information – Hedef Veritabanı Bilgisi: Verileri hangi veritabanına aktaracağız? (Bizim örneğimizde vBulletin 4)

Eğer ImPex halihazırda yüklüyse ve Admin panelinde gözüküyorsa bu adımı atlayabilirsin zira ImPex verileri vBulletin Config dosyasından okuyacaktır. Bizim örneğimizde verileri elle girdik.

Source Database Information – Kaynak Veritabanı Bilgisi: Hangi veritabanından verileri alacağız? (Bizim örneğimizde phpBB3.)

Özel durumlar için tanımlar (Neyi açıp kapamak istiyoruz ?)

ImpExConfig.php dosyasını düzenlemeyi bitirdiğinizde yaptığınız değişiklikleri kaydedin ve dosyayı sunucuya göndermek için hazır hale getirin.

4- Yukarıda anlatılan bütün ayarlara ek olarak Türkçe karakterlerde herhangi bir sorun olmaması için dosyada birkaç kod değişikliği  daha yapmak gerekiyor.

Var olan kod:

// Advanced Target
$impexconfig['target']['databasetype'] = 'mysql'; // currently mysql only
$impexconfig['target']['charset'] = '';
$impexconfig['target']['persistent'] = false; // (true/false) use mysql_pconnect

// Advanced Source
$impexconfig['source']['charset'] = '';
$impexconfig['source']['persistent'] = false;


Yerine gelecek kod:

// Advanced Target
$impexconfig['target']['databasetype'] = 'mysql'; // currently mysql only
$impexconfig['target']['charset'] = 'utf8';
$impexconfig['target']['persistent'] = true; // (true/false) use mysql_pconnect

// Advanced Source
$impexconfig['source']['charset'] = 'utf8';
$impexconfig['source']['persistent'] = true;


5- Bu değişikliği de yaptıktan sonra dosyayı kaydedip Upload klasörünün içeriğini olduğu gibi sunucunuzda forumunu bulunduğu klasöre yollayın.

Bizim örneğimizde httpdocs içinde siteye ait dosyalar, bu dosyalar içinde de forumun yer aldığı /forum klaösrü olduğu için Upload klasörünün içeriğini forum klasörüne kopyalıyoruz.

Diğer örnekler ise şu şekilde:

• public_html/forum/impex/
• www/forum/impex
• htdocs/forum/impex

6- Upload işlemi esnasında “includes/xml” klasörünün halihazırda var olduğu ve üstüne yazılıp yazılmayacağı sorulacaktır. Bu soruya evet diyerek “cpnav_impex.xml” dosyasının forum/includes/xml klasörüne yerleşmesini sağlayın. Böyleye forum yönetim paneline girdiğiniz sol kısma ImPex’in eklenmiş olduğunu göreceksiniz.

Eğer forum/includes/xml içerisinde cpnav_impex.xml dosyası yoksa bu dosyayı impex klasöründen kesip forum/includes/xml klasörüne yapıştırın.

7- Her ne kadar bizim sunucumuzda olmasa da VPS kullananlar için PHP.ini ayarları ( Bu seçeneği görmezden gelebilirsiniz):

mbstring.language = Turkish
mbstring.internal_encoding = UTF-8
mbstring.http_input = UTF-8
mbstring.http_output = UTF-8
mbstring.encoding_translation = On
mbstring.detect_order = UTF-8

8- Forumda kullanmakta olduğunuz dil dosyasının da UTF-8 kodlanmış olduğundan emin olduktan sonra artık yönetim paneline girerek ImPex’i kullanmaya başlayabilirsiniz.

• Yönetim panelinin en üstündeki İçeri aktar> İçeri aktar seçeneğine tıklayın
• vBulletin müşteri numaranızı (Customer Number) girin ve Continue deyin
• Bu aşamadan sonra birer birer modülleri çalıştırıp aktarım işlemine başlayabilirsiniz

9- Aktarım adımları:

001 – Check and Update Database – Bu seçenek kaynak veritabanını kontrol edip bütün tabloların yerinde olup olmadığını ve erişilebilir olup olmadıklarını kontrol edecektir. Çalıştırdıktan sonra yeşil satırlar görmeniz gerekmekte. Her şey yerli yerindeyse Impex, aktarım işlemine başlamak için sonraki adımlara geçişe izin verecektir. Aksi takdirde bir hata mesajı alacaksınız ve aktarım iptal edilecektir.

ImPex, hedef veritabanında da bazı değişiklikler yaparak aktarım ID numaralarına zemin hazırlayacaktır. Çok büyük bir forumu aktarıyorsanız bu işlem uzun sürebilir.

002 – Associate users – Bu seçenek sadece ve sadece hem vBulletin forumunuzda hem de kaynak forumda var olan fakat e-posta adresleri farklı olan kullanıcılar için çalıştırılması gereken bir modüldür. Eğer temiz bir aktarıma yapıyorsanız bu modülü çalıştırmayın. Bizim örneğimizde de bu modül atlandı.

Buradan sonra her modülü bir bir çalıştırın ve her bir modül %100 olmadan hiç bir bağlantıya tıklamayın, geri tuşuna sakın basmayın ve sayfadan da ayrılmayın. Her ekranda yazanları iyicene okuyun ve herhangi bir hata olduğunda bunu iyicene not ettikten sonra desteğe başvurun.

Bir modülü yeniden çalıştırdığınızda her ne sebepten olursa olsun bu türde aktarılmış bütün veriyi temizleyecektir.

Örneğin phpBB için içe aktarım modülünü konular için bir defa çalıştırdığınızda phpBB içerisindeki bütün konular vBulletin forumuna taşınacaktır.

Her konunun bir kimlik numarası olacaktır ve bu kimlik numarası, phpBB’deki konu kimliğinden alınır. vBulletin forumda halihazırda konular varsa onların aktarım kimlik numarası olmayacaktır zira bu konular orijinal konulardır.

Bu durumda herhangi bir modülü ikinci defa çalıştırdığınızda aktarım kimlik numarası olan o türdeki her şey silinecektir. Bu seçenek, kaynak forumda bir değişiklik yaptınız ve bunu tekrar aktarmak istiyorsanız faydalıdır. Bizim örneğimizde hiç bir modül tekrar çalıştırılmadı.

10- Son Aktarım Adımları:

İzinler

Aktarımdan sonra mutlaka moderatörler ve forumlar için izin ayarlarını kontrol edin zira her zaman düzgün bir eşleşme garanti edilemez.

Admin CP -> Forums & Moderators -> Show All Moderators -> Edit
Admin CP -> Forums & Moderators -> Forum Permissions

Forum Ön Belleği

Forum ön belleğini yeniden inşa etmek için forum yöneticisini açın ve görüntüyü kaydedin.

Sayaçlar

Aktarımdan sonra doğru değerleri elde etmek için konu ve forum sayaçlarını güncelleyin. Önce konu, sonra forum sayacı!

Maintenance > Update Counters > Rebuild Thread Information
Maintenance > Update Counters > Rebuild Forum Information

Kullanıcı Grupları

Birçok durumda aktarılan kullanıcıları yerleştirmek için kullanıcı grupları da taşınacaktır. Aktarılan kullanıcıları vBulletin’in standart kayıtlı kullanıcıları arasına yerleştirmek için kullanıcı gruplarını silin.

vBulletin’den vBulletin’e aktarımlarda dahi kullanıcı grupları yeniden oluşturulacaktır. Bu sayede eski ve yeni kullanıcıları kolayca yönetebilirsiniz.

Admin CP -> Usergroups -> Usergroup Manager -> Edit Usergroup

Arama İndeksi

Aktarılan konular arasında arama yapmak istiyorsanız arama indeksini de güncelleştirmelisiniz.

Maintenance > Update Counters > Rebuild Search Index

ImPex dosyalarını silin

Aktarımı bitirdiniz ve forumunuz da sorunsuz çalışıyorsa bütün ImPex dosyalarını sunucunuzdan silin. Bu sayede ileride bir başka aktarım yapacaksanız ImpEx’i tekrar indirmeniz gerekeceği için en son sürümü kullanıyor olacaksınız.

Yine ImPex dosyaları veritabanı erişim bilgileriniz içerdiği için de silmeniz yararınıza olacaktır.

Aktarılan Şifreler

Her sistem kullanıcıların şifrelerini düzgün aktaramayabilir. Bunun nedeni şifrelerin kaydedilme biçimidir. Her aktarıcı, şifrelerin düzgün aktarılıp aktarılmayacağını bildirir.

Eğer şifreler düzgün aktarılmadıysa kullanıcılarınıza bu durumu e-posta ile bildirmeyi unutmayın. E-posta içerisinde forumunuzun şifre resetleme sayfasının adresini eklemeyi de unutmayın.

Users > Send Email to Users

Şimdi ne olacak?

Aktarımı bitirdiğinizde ImPex sayfasından işlemin ne kadar sürdüğüne dair bir fikir edinebilirsiniz.

Eğer ters giden bir şeyler olduysa veya aklınıza takılan bir soru varsa destek forumuna göz atabilirsiniz.

ImPex Destek Forumu

Yine anlamadığınız bir konu varsa makalenin altına yorum yaparak da sorabilrisiniz.

Makale Sürümü: 1.0

Recep Baltaş – Kaynak gösterilmeden alıntılanamaz!