Manual
eNdonesia 8.3
Bikin Portal Itu Gampang
Daftar Isi Sekilas eNdonesia 8.3
2
Instalasi Cepat
3
Instalasi Lanjutan
5
Problem Instalasi
7
Memodifikasi eNdonesia 8.3
9
Yang Baru di eNdonesia 8.3
10
Hijrah dari eNdonesia 8.2
11
Support dan Disclaimer
13
eNdonesia His Story eNdonesia 8.3 - Nopember 2003 eNdonesia 8.2 - Agustus 2002 eNdonesia 8.1 - Juni 2002 eNdonesia 8.0 - Mei 2002
Endonesia.Com Portal daripada Indonesia Nurcholis Jl. Radar Selatan 36 Jatiwaringin, Pondok Gede Bekasi 17411 021-8483429
[email protected] www.endonesia.com
1
eNdonesia 8.3
Manual
Sekilas eNdonesia 8.3 eNdonesia 8.3 merupakan software atau script untuk membangun portal di internet. Selain itu, eNdonesia 8.3 bisa juga difungsikan untuk membuat media online, surat kabar online, atau sekedar website biasa. Dengan menggunakan eNdonesia 8.3, proses membangun dan mengelola portal menjadi mudah. Instalasi dan penggunaannya pun terbilang gampang.Semua urusan manajemen portal bisa dilakukan hanya dengan menggunakan browser. Software ini didistribusikan secara gratis atau sebagai produk open source. Harapannya, eNdonesia 8.3 dapat digunakan oleh siapa pun tanpa harus membuang dana atau investasi yang tak perlu. Awalnya eNdonesia 8.3 dikembangkan dari software portal open source lainnya, phpWebSite (http://phpwebsite.apstate.edu). Seiring kebutuhan dan berjalannya waktu, berbagai utilitas dan fungsionalitas pun ditambahkan. Ada yang dikembangkan sendiri, ada yang mencomot dari software open source lainnya, semacam phpNuke (http://www. phpnuke.com), phpLinks (http://www.phplinks.org), dan lain-lain. Agar bisa berfungsi dengan baik, eNdonesia 8.3 harus diinstall di web hosting berbasis Linux yang menyediakan PHP versi 4.0.6 (atau berikutnya) dan database MySQL. eNdonesia 8.3 Mengandung Apa? eNdonesia 8.3 mengandung aneka fasilitas yang biasa ditemukan di sebuah portal. Fasilitas ini bersifat modular, bisa ditambah dan dikurangi seperlunya. Pada distribusi standardnya, eNdonesia 8.3 mengandung modul sebagai berikut: 1. Modul News Publishing 2. Modul Katalog Website 3. Modul Forum diskusi 4. Modul Poll 5. Mainpage (kover depan) 6. Userpage (untuk membuat halaman web bebas) 7. Form mail 8. Form rekomendasi / send to friend Modul Ekstra Modul lain yang sudah tersedia dan tidak diikutkan pada distribusi standar adalah: 1. Modul Galeri Foto 2. Modul Iklan Baris 3. Modul Mailing List eNdonesia 8.3 dan seluruh modulnya bisa di-download di: http://www.sourceforge.net/projects/endonesia. www.endonesia.com
2
eNdonesia 8.3
Manual
Instalasi Cepat 1. Unzip file eNdonesia.8.3.zip ke harddisk PC Anda. Sebaiknya, buatkan direktori tersendiri untuk menampungnya dan pertahankan struktur direktori sesuai aslinya. 2. Edit file config.php dengan menggunakan teks atau ASCII editor, misalnya Notepad. Jangan pakai Microsoft Word dan sejenisnya. Untuk tahap awal dan agar bisa langsung dioperasikan, ada dua bagian yang perlu diedit. Pertama, pada bagian Database Config. Isinya seperti berikut: $dbhost = "localhost"; $dbuname = "user_database"; $dbpass = "password_database"; $dbname = "database_anda"; Isi keempat item itu sesuai dengan info yang Anda dapat dari penyedia web hosting Anda. Kedua, pada bagian Site Identification. Isinya seperti berikut $sitename = "Endonesia"; $portal_url = "http://www.endonesia.com"; $portal_motto = "Portal daripada Indonesia"; $startdate = "April 3001"; $adminmail = "
[email protected]"; Ubah semua item di atas sesuai kebutuhan Anda. Bagian lain dari file config.php ini tak usah diutak-atik dulu. Kalau portalnya sudah jalan, silakan diutak-atik untuk lebih menyesuaikannya dengan kebutuhan portal Anda. Sebelum men-save file config.php, pastikan tak ada baris kosong di akhir halaman atau di akhir file config.php. Tanda atau kode "?>", yang merupakan tanda penutup script PHP, harus menjadi baris terakhir. Sekali lagi, tak boleh ada baris kosong di bawahnya. 3. Upload semua file (kecuali direktori doc dan file di dalamnya) ke website Anda, terserah ke direktori mana. Anda bisa menguploadnya ke direktori utama website Anda, bisa juga ke sub-direktori. Yang penting, jangan mengubah struktur direktori dan file hasil unzip. 4. Ubah permission untuk 4 direktori berikut menjadi 777, agar Anda bisa mengupload images. images/ images/main_page/ mod/userpage/images/ mod/publisher/media/ mod/publisher/media/thumbnails/ 5. Masukkan atau dump file "tabel.sql" dan "data.sql" yang ada di direktori Doc ke database www.endonesia.com
3
eNdonesia 8.3
Manual
MySQL website Anda. Biasanya, penyedia hosting menyediakan phpMyAdmin untuk memasukkan tabel dan data ke database. Masukkan lebih dulu "table.sql" dan baru kemudian "data.sql." Keduanya harus dimasukkan. 6. Selesai. Portal Anda kini sudah jadi. 7. Anda sudah bisa mengakses portal Anda memakai browser. Kalau Anda tadi mengupload ke direktori utama, langsung saja arahkan browser Anda ke alamat website Anda (http://www.website_anda.com). Kalau tadi menguploadnya ke sub-direktori, arahkan browser Anda ke subdirektori tersebut (http://www.website_anda.com/subdirektori). 8. Sebagai pemilik portal, Anda wajib mendatangi fasilitas Admin. Arahkan browser Anda ke http://www.website_anda.com/admin.php. Lantas, login dengan memakai login name dan password berikut. login name : admin password : endonesia 9. Setelah login, ada baiknya Anda mengganti password di atas dengan password baru. Atau lebih baik lagi, coba buat account admin yang baru lewat menu yang ada di Admin Menu. Buat nama dan password baru sesuka Anda. Setelah dibuat, silakan logout dan coba login lagi dengan account yang baru. Kalau beres, hapus account yang asli (admin = endonesia). 10. Selamat menikmati: silakan obok-obok semua fasilitas yang ada di portal baru Anda.
www.endonesia.com
4
eNdonesia 8.3
Manual
Instalasi Lanjutan 1. Konversi Hari, Bulan, Tahun, dan Jam Secara default, waktu atau penanggalan yang dipakai adalah waktu sesuai dengan waktu server hosting Anda. Bila ingin menyesuaikannya atau mengkonversi ke waktu lokal, misalnya ke WIB, ada ubahan sederhana yang mesti dilakukan. Caranya, buka file config.php, dan pergi ke baris-baris menjelang akhir. Cari subbagian Konversi Kalender. Di sana akan ada $gmt. $gmt = "0"; Defaultnya adalah 0. Untuk mengkonversi ke waktu lokal, ganti 0 dengan selisih waktu antara waktu lokal Anda dengan waktu server. (Tak usaha pedulikan apa arti kata gmt, itu simbol saja). Jika waktu lokal lebih cepat, dari waktu server, isikan dengan angka selisih normal (positif). Misalnya angka 7. Tak usah gunakan tanda + (plus). Kalau selisih waktunya negatif, atau waktu lokal lebih lambat dari waktu server, isikan selisih waktu dengan tanda negatif. Misalnya -7. Ingat, gunakan tanda minus. Kalau waktu versi server hosting Anda sudah sama dengan waktu lokal Anda, ya biarkan saja terisi dengan angka 0. Dengan mengubah hal di atas, maka setiap data (tulisan, berita, diskusi, dll) yang Anda tuliskan di portal Anda, waktu postingnya akan menggunakan waktu lokal. 2. Mengganti Theme eNdonesia 8.3 menyediakan dua theme: Default dan Merah. Keduanya tersimpan pada direktori themes website Anda. Kalau belum diubah, theme yang dipergunakan adalah yang Default. Kalau ingin mengganti dengan yang Merah, ganti saja isi $default_theme yang ada di file config.php. Untuk mengubahnya, cari bagian seperti ini di file config.php: $default_theme = "Default"; Ganti menjadi, misalnya: $default_theme = "Merah";
www.endonesia.com
5
eNdonesia 8.3
Manual
3. Mengubah Security Hash Guna meningkatkan security website Anda, ganti pula $secutirty_hash yang ada di config. php. Isinya seperti berikut. $security_hash = "0eXf5serserwqKUlxa20N1mvFP"; Ganti aneka hurup yang tak jelas bunyinya itu sesuka Anda, Yang penting isinya berbeda dari portal lain (Tanda petik jangan dihilangkan). Security hash ini bertujuan untuk mengamankan hak akses admin, agar tak sama dengan akses website atau portal lain.
www.endonesia.com
6
eNdonesia 8.3
Manual
Problem Instalasi Berbagai error yang terjadi saat instalasi eNdonesia 8.x, umumnya disebabkan oleh konfigurasi server PHP di pihak penyedia hosting. Dan sebenarnya, itu pun bukan error, melainkan ‘’tuntutan’’agar Anda menyesuaikan diri dengan adat-istiadat server penyedia hosting. Ada dua error yang umum terjadi, yakni Register Globals disetel OFF dan tak adanya direktori untuk menyimpan data session. Berikut contoh dan solusinya. 1. PHP Register Globals Dalam versi standardnya, PHP mutakhir men-set register globals ke posisi OFF. Banyak penyedia hosting pun tetap membiarkannya seperti itu. Bila dibiarkan seperti itu, maka bisa dipastikan eNdonesia 8.3 tak bisa berjalan sempurna. Admin dan User kemungkinan tak bisa login, dan modul-modul yang ada pun tak bisa jalan. Solusinya, Anda harus ‘’menimpa’’setting tersebut agar menjadi ON. Kalau webserver Anda menggunakan Apache, buat file .htaccess berisi perintah untuk meng-on-kan Register Globals. Adapun isi file .htacces hanya tiga baris perintah berikut:
php_flag register_globals on Bila sudah dibuat, upload dan tempatkan file .htaccess tersebut di direktori utama portal Anda. Solusi ini untuk web hosting sewaan, di mana Anda tak punya akses ke php.ini. Kalau di server atau komputer sendiri, Anda bisa meng-on-kan Register Global dengan mengubah settingnya di php.ini. 2. PHP Sessions Directory Bila ketika mengakses portal berbasis eNdonesia 8.3 Anda menemukan error seperti berikut ini, maka bisa dipastikan web hosting Anda tidak menyediakan direktori untuk menyimpan data PHP session. Warning: open(/tmp/sess_b04835d83ff9ee8f0c19a6214827f389, O_RDWR) failed: Permission denied (13) in Unknown on line 0 Warning: Failed to write session data (files). Please verify that the current setting of session. save_path is correct (/tmp) in Unknown on line 0
Data Session, sesuai default dari PHP, umumnya disimpan/direkam pada direktori /tmp atau /temp. Namun tak sedikit penyedia hosting yang sama sekali tidak menyediakannya. Kalau yang seperti ini terjadi, mau-tak-mau Anda mesti membuat sendiri direktori untuk menyimpan data Session. Akibat tak adanya direktori untuk menyimpan session, admin jadi tak bisa login. Atau kalau pun bisa login, ia akan ditentang logout lagi ketika mengklik menu di area admin.
www.endonesia.com
7
eNdonesia 8.3
Manual
Sama seperti problem dengan Register Globals, solusi untuk masalah ini pun tak sulit. Solusinya, lagi-lagi, Anda tinggal membuat file .htacces yang akan memerintahkan PHP untuk menyimpan data Session ke direktori buatan Anda sendiri. Cara melakukannya sederhana saja. Pertama, buat direktori untuk menyimpan data session. Namanya terserah Anda, boleh tmp, boleh session, boleh sessions (seperti contoh di bawah ini), boleh apa saja. Lalu, ubah permission direktori tersebut agar bisa ditulis. Misalnya dengan men-chmod 700. Setelah itu, buat file .htaccess dengan isi seperti berikut, dan upload ke direktori portal Anda.
php_value session.save_path "./sessions" Solusi ini hanya berlaku kalau webserver Anda menggunakan Apache. Kalau webserver-nya lain, silakan baca manual software server Anda. Juga, solusi itu berlaku kalau Anda menggunakan hosting sewaaan yang tak menyediakan akses ke php.ini (umumnya pasti tidak). Kalau di server sendiri, atau di komputer sendiri, ubah saja setting session save path yang ada di php.ini. Kalau pada direktori portal Anda sudah ada .htaccess, atau Anda sudah membuat .htaccess sesuai Solusi Nomor 1, tambahkan saja tiga baris perintah tadi di bawahnya, atau sebaliknya. 3. Tak Bisa Upload Foto Error lain yang sering muncul adalah Anda tidak bisa meng-upload foto untuk Mainpage, Userpage, maupun Publisher. Hal ini mungkin terjadi jika penyedia hosting tidak membolehkan file upload alias servernya beroperasi dengan kondisi safe mode-nya ON. Kalau sudah begini, ini tak bisa ditawar lagi. Settingnya tak bisa ditimpa dengan membuat file .htaccess. Anda memang diharamkan mengupload file via php. Jadi… pindah hosting saja… . Meski begitu, sebelum menyalahkan kepengecutan penyedia hosting Anda, tak ada salahnya Anda mencek lebih dulu apakah Anda sudah men-chmod direktori yang jadi tujuan upload dengan benar, seperti yang diminta pada panduan instalasi.
www.endonesia.com
8
eNdonesia 8.3
Manual
Memodifikasi eNdonesia 8.3 1. Membuat Theme Sendiri Kalau Anda biasa utak-atik desain web, Anda bisa membuat sendiri theme atau template portal Anda. Ikuti saja themes yang ada, yang tersimpan di direktori themes. Isi filenya mudah diedit, tak banyak beda dengan kode html biasa. 2. Membuat Modul Lain Membuat modul lain tak sulit. Tiru saja modul yang ada. Kalau mau meniru, amat disarankan untuk berangkat dari modul Publisher atau Katalog Website.
www.endonesia.com
9
eNdonesia 8.3
Manual
Yang Baru di eNdonesia 8.3 Publisher Fungsi submit berita untuk user dihadirkan kembali. Berita pun kini bisa disimak arsipnya berdasarkan tahun dan bulan. Title Halaman Semua halaman bisa menampilkan title tersendiri yang akan muncul pada browser. Kategori Kategori untuk Publisher, Katalog, dan lain-lain sudah bisa tersortir dengan benar, alfabetis. Thanks to phpLinks (http://www.phplinks.org). Forum Diskusi Forum diskusi diganti sepenuhnya dengan modul yang lebih simpel dan gampang dipakai. Kalau ingin menggunakan modul forum versi baru, silakan konversi data forum lama ke forum baru memakai script yang disediakan. Kalau tak mau pakai yang baru, silakan tetap pakai forum yang lama, yang masih bisa berjalan normal di eNdonesia 8.3. Tanggal Semua post date mengikuti waktu lokal. Dengan demikian data penanggalan yang tersimpan di MySQL adalah tanggal lokal, bukan tanggal server. User Login Sejumlah kolom telah dibuang dari tabel users: umode, uorder, thold, noscore, commentmax. Kalau Anda pernah mengutak-atik cookies, silakan sesuaikan. Mainpage Update mainpage telah diintegrasikan. File update mainpage yang ada di area Download Sourceforge.net tak usah dipakai lagi. PHP Code Penulisan kode sudah semakin bening dan mulus. Mengeditnya jadi lebih mudah. ‘Kali.... Dan lain-lain...
www.endonesia.com
10
eNdonesia 8.3
Manual
Hijrah dari eNdonesia 8.2 Konversi data ini hanya perlu dilakukan jika Anda pindah dari eNdonesia 8.2 ke 8.3. 1. Konversi Tanggal
Seperti sudah disebutkan, post date di eNdonesia 8.3 kini menggunakan waktu lokal. Bukan waktu server. Dengan begitu, data post date yang ada di mod_publisher (field time) dan mod_katalog (field date) mesti diubah agar tetap sesuai dengan tanggal aslinya. Mengkonversi tanggal sangat gampang dilakukan. Kalau Anda pakai phpMyAdmin, cemplungkan saja perintah berikut ke form SQL query. update mod_publisher set time=DATE_ADD(time, INTERVAL 15 HOUR); Atau bisa juga pakai yang berikut: update mod_publisher set time=time + INTERVAL 15 HOUR; Ubah angka sebelum HOUR sesuai beda waktu lokal Anda dengan waktu server, atau sesuai angka $gmt yang Anda pakai di eNdonesia 8.2. Ada baiknya Anda mencoba melakukan update dengan data lain. Atau lebih baik lagi, dengan memakai PhpMyAdmin, copy saja table mod_publisher atau mod_katalog ke table baru. Setelah itu coba lakukan update tanggal dengan memakai table kopian tadi. 2. Konversi Forum Diskusi Kalau Anda ingin memakai modul forum diskusi yang baru, Anda bisa memindahkan data yang ada di forum diskusi lama secara otomatis dengan menggunakan script yang disediakan. Kalau tak ingin pakai forum diskusi yang baru, ya tak usah ikuti petunjuk berikut. Konversi dilakukan dengan memindahkan data dari mod_forum dkk (table untuk forum diskusi lama) ke mod_diskusi dkk (table untuk forum diskusi baru). Tidak semua data akan dipindahkan karena forum diskusi baru memang dibuat lebih simpel. Yang akan dipindahkan hanya kategori forum dan pesan yang diposting user. Sebelum melakukan konversi, Anda sudah harus menginstall lebih dulu script modul forum diskusi yang baru. Pastikan juga table yang diperlukan untuk forum diskusi baru sudah dibuat (mod_diskusi dkk). Kalau perlu, silakan test dulu apakah modul baru ini sudah berjalan baik atau belum. Kalau sudah OK, kosongkan lagi table-nya. Selanjutnya, silakan tengok directory Doc hasil unzip eNdonesia 8.3. Di sana tersedia dua file untuk melakukan konversi. Yakni, forum_konversi.php dan forum_index.php. Ubah nama keduanya menjadi konversi.php dan index.php. Lalu, upload ke direktori diskusi, yang merupakan direktori baru untuk modul forum diskusi (forum lama menggunakan direktori forum). Biarkan index.php versi konversi ini menimpa index.php yang ada.
www.endonesia.com
11
eNdonesia 8.3
Manual
Ada tiga tahapan yang mesti dijalani untukmemindahkan data dari mod_forum dkk ke mod_diskusi dkk. Pertama, memindahkan kategori forum Caranya, buka browser Anda dan pergi ke http://www.websiteanda.com/mod.php?mod=diskusi&op=konversi_kat Ketika halaman tersebut terbuka, Anda akan disuguhi halaman berisikan daftar kategori yang ada di forum diskusi lama. Klik tombol Update yang ada di bagian akhir, maka data kategori akan ditransfer dari forum lama ke forum diskusi baru (ke table mod_diskusi_categories). Kedua, memindahkan posting user Caranya, buka browser Anda dan pergi ke http://www.websiteanda.com/mod.php?mod=diskusi&op=konversi Ketika halaman tersebut terbuka, Anda akan disuguhi halaman berisikan daftar posting yang ada di forum lama. Kalau jumlah posting banyak, kemungkinan Anda mesti agak bersabar untuk menunggu seluruh posting muncul. Kalau postingnya sedikit, ya cepat munculnya. Jika semua sudah muncul, akan muncul tombol Update di bagian akhir. Klik tombol tersebut, maka data tersebut akan ditransfer ke forum diskusi baru (ke table mod_diskusi) Ketiga, memindahkan comment atau respon Caranya, buka browser dan pergi ke http://www.websiteanda.com/mod.php?mod=diskusi&op=konversi_res Ketika halaman tersebut terbuka, Anda akan disuguhi halaman berisikan daftar comment atau respon yang ada di forum lama. Kalau commentnya banyak, perlu sabar menunggu seluruh halaman muncul secara utuh. Kalau sudah, akan muncul juga tombol update. Klik tombol tersebut dan data akan ditransfer ke table mod_diskusi_response. Setelah ketiga proses itu selesai, silakan simak forum diskusi baru Anda. Coba simak penanggalannya. Kalau penanggalannya tak sesuai dengan waktu lokal, gunakan cara update tanggal yang sudah diceritakan di bagian sebelumnya. Tips: Agar lebih pede dalam melakukan konversi, lebih baik lakukan konversi di webserver pada PC Anda sendiri. Bukan langsung di hosting online.
Jika semua sudah beres, silakan delete dua file yang tadi Anda upload (index.php dan konversi.php). Lalu, upload lagi file index.php yang ada di direktori modul diskusi.
www.endonesia.com
12
eNdonesia 8.3
Manual
Support Kalau ada masalah, jangan sungkan datang ke Endonesia.Com (http://www.endonesia.com). Anda bisa menjumpai info tentang software ini di Topik atau Berita tentang eNdonesia dan juga di Forum Diskusi tentang eNdonesia. Jika ingin mempostingkan suatu masalah di forum, tak ada salahnya Anda membaca dulu Topik eNdonesia atau posting yang ada di Forum, siapa tahu jawaban atas masalah Anda sudah diutarakan di sana. Disclaimer Endonesia.Com mengajak anda untuk membangun portal dengan menggunakan eNdonesia 8.x. Meski begitu Endonesia.Com tidak bertanggung jawab atas resiko kerusakan atau keberuntungan yang Anda dapatkan. Semua resiko dan kebahagiaan jadi tanggungan dan milik Anda sendiri. GPL Licence This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
www.endonesia.com
13
