Panduan praktis tentang fungsi folder /wp-content/languages/, jenis berkas terjemahan (.po, .mo, .pot), cara memasang bahasa, mengatasi masalah umum, dan tips pengelolaan terjemahan situs.
Folder /wp-content/languages/ biasa digunakan untuk menyimpan berkas terjemahan suatu situs berbasis WordPress. Memahami isi dan fungsi folder ini membantu memastikan teks antarmuka, tema, dan plugin tampil dalam bahasa yang diinginkan pengunjung.
Panduan ini menjelaskan jenis berkas terjemahan, lokasi penempatan yang tepat, langkah menambahkan bahasa secara manual maupun melalui antarmuka, serta cara mengatasi masalah umum terkait berkas bahasa.
Folder /wp-content/languages/ adalah lokasi sentral untuk menyimpan berkas terjemahan yang digunakan oleh inti sistem, tema, dan plugin. Ketika antarmuka situs perlu ditampilkan dalam bahasa selain bahasa default, file-file yang ada di folder ini menyediakan pasangan string asli dan terjemahan.
Keuntungan menempatkan berkas terjemahan di folder ini adalah memisahkan terjemahan dari berkas tema atau plugin sehingga update tidak menghapus terjemahan yang sudah dibuat atau dipasang.
Ada beberapa jenis berkas yang umum dipakai: berkas sumber terjemahan (.pot), berkas teks terjemahan (.po), dan berkas hasil kompilasi yang dibaca aplikasi (.mo).
Contoh pola penamaan: untuk bahasa Indonesia pada inti atau plugin biasanya menggunakan kode bahasa-NEGARA seperti id_ID.mo dan id_ID.po. Untuk plugin atau tema, nama berkas sering diawali nama plugin/theme diikuti kode bahasa, misalnya plugin-slug-id_ID.mo.
.po berisi pasangan pesan dan terjemahan dalam format teks sehingga mudah diedit. Setelah selesai, .po dikompilasi menjadi .mo agar sistem dapat memuat terjemahan lebih cepat.
Melalui antarmuka: Banyak instalasi menyediakan pengaturan bahasa di bagian General Settings atau pengaturan bahasa di dashboard. Pilih bahasa yang tersedia dan sistem akan mengunduh paket bahasa secara otomatis jika tersedia.
Secara manual: Jika Anda memiliki berkas .mo atau .po, unggah ke folder /wp-content/languages/. Untuk plugin atau tema, perhatikan penamaan berkas agar sesuai pola yang digunakan oleh plugin/theme tersebut. Setelah berkas ditempatkan, sistem biasanya akan mengambil terjemahan secara otomatis ketika memuat halaman.
Alternatif lain adalah menggunakan alat terjemahan seperti plugin manajemen terjemahan yang menyediakan antarmuka untuk mengedit .po/.mo langsung melalui dashboard. Pilihan ini berguna bila Anda ingin mengubah terjemahan tanpa mengunggah berkas melalui FTP.
File tidak muncul atau menimbulkan kesalahan: Periksa kembali penamaan berkas dan lokasi penyimpanan. Pastikan nama berkas sesuai kode bahasa yang digunakan di pengaturan situs.
Izin folder: Jika berkas tidak dapat dimuat, cek izin folder dan file. Server harus memberikan izin baca pada berkas .mo/.po agar sistem dapat memuat terjemahan.
Cache: Jika perubahan terjemahan tidak terlihat, bersihkan cache aplikasi atau plugin caching yang digunakan. Cache sering menyebabkan tampilan lama tetap muncul meski berkas terjemahan sudah diperbarui.
Prioritas lokasi: Untuk mencegah kehilangan terjemahan pada pembaruan, simpan terjemahan kustom di /wp-content/languages/ daripada menaruhnya di dalam folder tema atau plugin yang dapat ditimpa.
Simpan salinan .po asli: Jika Anda melakukan pengeditan, simpan juga berkas .po agar mudah dikompilasi ulang menjadi .mo saat diperlukan.
Gunakan editor .po yang handal: Alat seperti Poedit atau editor dalam dashboard mempermudah mengelola pasangan string dan melihat konteks terjemahan.
Standarisasi kode bahasa: Gunakan kode bahasa-negara yang benar (misalnya id_ID untuk Bahasa Indonesia) supaya sistem dapat mengenali berkas terjemahan yang tepat.
Dokumentasikan perubahan: Jika beberapa orang mengelola terjemahan, catat perubahan utama atau string yang dimodifikasi agar koordinasi tetap terjaga.