Anda di halaman 1dari 13

eNdonesia 8.

3 Manual

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
republik@endonesia.com

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 = "republik@endonesia.com";

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:

<IfModule mod_php4.c>
php_flag register_globals on
</IfModule>

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.

<IfModule mod_php4.c>
php_value session.save_path "./sessions"
</IfModule>

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