You are on page 1of 21

e N d o n e s ia 8 .

open source portal software, content management


sy stem, si te management sy stem, or wh atev er
y ou want to name i t.

C o n t e n t

A b out eN d onesi a 8 . 4 2

Q ui ck I nstall 4

A d v anced S etup 6

C ommon P rob lems 7

C ustomi z ati on 9

W h at's N ew i n eN d onesi a 8 . 4 1 0

U pgrad e eN d onesi a 8 . 3 to 8 . 4 1 2

T i ps 1 9

S upport and D i sclai mer 20

R esources 21

E n d o n e s ia .C o m
P ortal of I nd onesi a

N urch oli s

J l. R ad ar S elatan 3 6
J ati wari ngi n, P ond ok G ed e
B ek asi 1 741 1
I nd onesi a

T elp: 0 21 -8 48 3 429
repub li k @end onesi a. com

© May 2006 Endonesia.Org 1


A b o u t E n d o n e s ia 8 .4

eN d onesi a 8 . 4 i s a web portal appli cati on, content management sy stem, news pub li sh i ng
sy stems, or wh atev er y ou want to name i t. I t h as b een d ev eloped to enab le people b ui ld
th ei r own i nternet empi re b y prov i d i ng portal for th e pub li c, j ust li k e wh at Y ah oo h as d one,
and G oogle want to d o.

I t's easy to i nstall, use and manage. T h i s wi ll let y ou focus on d eli v eri ng content --wh at
ev er i t i s-- to y our portal v i si tor.

U si ng eN d onesi a 8 . 4, y ou can b ui ld v ari ous portal wi th d i v erse content as y ou wi sh . I ts


mod ular approach enab le y ou to ex tend y our portal b y ad d i ng
His Story
anoth er mod ule.
eN donesia 8.4 - May 2006
eN donesia 8.3 - N ov em b er 2003
T h i s ph p scri pts work s on any operati ng sy stem, i nclud i ng
eN donesia 8.2 - A u gu st 2002
L i nux or W i nd ows, as long as th ey h av e P h p ( v 4. x and ab ov e) eN donesia 8.1 - J u ne 2002
and M y S Q L ( v 3 . x and ab ov e) . M ore b etter, on A pach e web eN donesia 8.0 - May 2002
serv er.

T h ere i s no d emo si te for eN d onesi a 8 . 4. W h o need s a d emo any way ? I t's only tak e a few
mi nutes to i nstall eN d onesi a 8 . 4 and mak e i t work . B ut i f y ou want to see real operati ng
si tes, y ou can v i si t h ttp:/ / www. end onesi a. com, i n I nd onesi a languages, or v i si t h ttp:/ /
www. end onesi a. net for E ngli sh si te.

O n i ts fi rst release, eN d onesi a 8 . x was d ev eloped b ased on ph pW eb S i te. T h e scri pts re-
leased b ecause i n th at ti me I h ate to upgrad e to newer ph pW eb S i te ( 0 . 8 . 2. x ) , b ecause
th ere i s no upgrad e tools. S o, I d eci d ed to re-d ev elop and d i stri b ute i t und er new eN d one-
si a ''b rand '' name.

B y ongoi ng and conti nuous d ev elopment, more functi onali ti es ad d ed . S ome mad e from
scratch , and th e oth ers b y ad opti ng useful functi on from anoth er open source ph p scri pt,
such as P h pN uk e, ph pL i nk , etc.

F e a t u r e

I n i t's core d i stri b uti on, eN d onesi a 8 . 4 come wi th th e followi ng mod ules and tools:

1 . C atalog mod ule, to create web d i rectory wi th unli mi ted category , multi ple category ,
and related category .
2. P ub li sh er mod ule, to create onli ne med i a, also wi th unli mi ted category , multi ple cate-
gory .
3 . D i scussi on mod ule, to mai ntai n d i scussi on forum
4. I nformati on mod ule, to create a b ook li k e i nformati on catalog
5 . C ontent mod ule, to create menu for y our portal
6. A b out mod ule, to create y our portal profi le or y our company profi le
7. P olli ng

© May 2006 Endonesia.Org 2


8 . B anner R otator
9. T ell a fri end
1 0 . C ontact form

E x t r a M o d u le s

O th er th an mod ules th at h av e b een i ntegrated to th e core d i stri b uti on, th ere are some
mod ules y ou can i nstall b y y our own, to ex tend y our portal serv i ce or content.

A v ai lab le mod ules:

1 . P h oto G allery
2. N ewsletter/ M ai li ng L i st
3 . C lassi fi ed A d s
4. A nd more to come. . .

J ust li k e th e core d i stri b uti on fi le, y ou can d ownload all th ose mod ules from our d ownload
page at h ttp:/ / www. sourceforge. net/ proj ects/ end onesi a/

© May 2006 Endonesia.Org 3


Q u ic k I n s t a ll

1 . E x tract or unz i p th e d i stri b uti on fi le, eN d onesi a8 4-en. z i p, k eep th e d i rectory structure
i ntact.

2. E d i t th e confi g. ph p fi le usi ng A S C I I or tex t ed i tor. Y ou can use N otepad , at mi ni mum. D o


not use W ord P ad or W ord . F i nd th e followi ng v ari ab les, and ch ange i t to sui t y our web
h osti ng sy stem.

F i rst part, D atab ase C onfi g:

$ db h ost = " l oc al h ost " ;


$ db u nam e = " dat ab ase_ u sernam e" ; W a rn in g
$ db p ass = " dat ab ase_ p assw ord" ;
$ db nam e = " dat ab ase_ nam e" ; B ef ore sav ing c onf ig.p h p
f il e, m ak e su re t h e p h p
c l osing t ag ( ? > ) b ec om e
S econd part, S i te I d enti fi cati on: t h e end of t h e l ine.

$ sit enam e= " Endonesia 84 Engl ish v ersion" ; D o not p u t any ot h er


$ p ort al _ u rl = " h t t p : / / w w w .endonesia.c om " ; l ine, inc l u ding b l ank
$ p ort al _ m ot t o = " T h e N ex t Y ah oo" ; sp ac e, b el ow it .
$ st art dat e= " May 2006" ;
$ adm inm ail = " rep u b l ik @ indonesia.c om " ;

T o mak e th e scri pts work , y ou only need to ch ange ab ov e v ari ab les. L ater, y ou can ch ange
any oth er v ari ab les to customi z e y our portal.

3 . U pload all th e fi le to y our web si te, ex cept d ocs d i rectory and fi les wi th i n. Y ou can upload
to y our mai n si te, h ttp:/ / www. y our_ portal. com, or to a sub d i rectory ,
h ttp:/ / www. y oursi te. com/ y our_ portal

4. I mport or d ump end onesi a8 4-en. sq l to y our M y S Q L d atab ase. Y ou can use ph pM y A d mi n
to d o th ese.

5 . S et permi ssi ons for th e followi ng i mages d i rectory to 777 or 75 7 ( b etter) , to enab le fi le
or i mage upload or mak e i t wri tab le. T h i s steps only need ed i f y ou use L i nux . F orget i t i f
y ou use W i nd ows.

im ages/ m ain_ p age


m od/ ab ou t / f ot o
m od/ c ont ent / f ot o
m od/ inf orm asi/ f ot o
m od/ p u b l ish er/ m edia
m od/ p u b l ish er/ m edia/ t h u m b nail s

6. D one. F i ni sh . Y our portal i s read y to go.

7. G o to y our portal frontpage, h ttp:/ / www. y our_ portal. com, or y our sub d i rectory to see
y our i nstant portal .

© May 2006 Endonesia.Org 4


8 . G o to y our ad mi n page to manage y our portal. P oi nt y our web b rowser to
h ttp:/ / y our_ portal. com/ ad mi n. ph p

L ogi n usi ng:

L ogin N am e: adm in
P assw ord: endonesia

E x plore th e ad mi n menu, and d on't forget to ch ange th e ad mi n password or create new


ad mi n account ( th rough M anage A d mi n menu) .

© May 2006 Endonesia.Org 5


A d v a n c e d S e t u p

1 . T i me A d j ustment

T o ch ange/ ad j ust y our portal ti me, fi nd $ gmt v ari ab les. T h e d efault v alue i s 0 . C h ange i t
wi th ti me d i fferences b etween y our local ti me ( P C ) and y our serv er or h osti ng ti me. I f th e
ti me d i fferences i s posi ti v e, put th e numb er ''wi th out'' plus si gn + ( e. g. , 7) . I f th e ti me d i f-
ferences i s negati v e, put negati v e si gn ( e. g. , -7) b efore th e numb er.

2. C alend ar T ranslati on

U nd er $ gmt, y ou can fi nd $ translateK al v ari ab le wi th a long. . . . long array , to translate d ay


and month terms from E ngli sh to any oth er languages. T o sui t i t to y our own language,
ch ange ''th e ri gh t part'' of th e array . I t's an easy to d o.

3 . C h ange T h eme

eN d onesi a 8 . 4 come wi th two th emes: D efault and R eli ef. B oth are av ai lab le i n th emes d i -
rectory . T o ch ange i t, j ust replace $ d efault_ th eme v alue i n confi g. ph p to R eli ef.

4. C h ange S ecuri ty H ash

T o i ncrease securi ty of y our portal, ch ange $ securi ty _ h ash v ari ab le i n confi g. ph p. C urrently
th e content i s someth i ng li k e:

$ sec u rit y_ h ash = " 0eX f 5serserw q K U l x a20N 1m v F P " ;

C h ange th e v ari ab le v alue usi ng any ch aracters comb i nati on y ou can i magi ne. T h i s h ash i s
used for ad mi n functi on, and to mak e sure y our h ash i s d i fference from anoth er people
portal.

© May 2006 Endonesia.Org 6


C o m m o n P r o b le m s

1 . S e s s io n s D ir e c t o r y

W h en y ou access th e mai npage or frontpage of y our eN d onesi a 8 . 4 si te and get errors li k e:

W arning: op en( / t m p / sess_ b 04835d83f f 9ee8f 0c 19a6214827f 389, O_ R D W R ) f ail ed: P erm ission denied ......
W arning: F ail ed t o w rit e session dat a ( f il es) . P l ease v erif y t h at t h e c u rrent set t ing of session.sav e_ .....

th e prob lem h appened d ue to th e scri pt could n't fi nd a sessi ons d i rectory or fold er to store
sessi on d ata.

T o solv e th i s prob lem, fi rst, create y our own sessi ons d i rectory on y our si te. F or ex ample
create a d i rectory named " 'sessi ons. " M ak e i t wri teab le b y ch ange i ts permi ssi on to 777,
75 7, or 70 0 .

S econd , create . h taccess fi le and put i t on y our portal mai n d i rectory , i n th e same locati on
as confi g. ph p. P ut th e followi ng content to th e . h taccess fi le. I f y ou're alread y h av e
a . h taccess fi le, ad d to i t.

# p h p .ini c onf igu rat ion


< I f Modu l e m od_ p h p 4.c >
p h p _ v al u e session.sav e_ p at h " ./ sessions"
< / I f Modu l e>

I f y ou i nstall eN d onesi a 8 . 4 on y our own pc or serv er, y ou can ch ange y our ph p. i ni con-
fi gurati on to enab le sessi ons d i rectory .

P lease note th at th i s soluti on only work s wi th A pach e.

2 . A d m in C a n 't L o g in

T h e prob lem caused b y unav ai lab i li ty of sessi ons d i rectory . U se th e N o. 1 soluti on.

3 . R e g is t e r _ g lo b a ls

I n recent v ersi ons of P H P , th e regi ster_ glob als i s set b y d efault to O ff. T h i s wi ll mak e eN -
d onesi a 8 . 4 mod ules won't work well. S o, wh at y ou h av e to d o i s to turn on th e regi s-
ter_ glob als b y ov erri d i ng th e ph p. i ni setti ng.

T o ov erri d e th e ph p. i ni setti ng, th e soluti on to th i s prob lem i s si mi lar to soluti on no 1 . J ust


create . h taccess wi th followi ng content. O r ad d i t to y our current . h taccess.

# p h p .ini c onf igu rat ion


< I f Modu l e m od_ p h p 4.c >
p h p _ f l ag regist er_ gl ob al s on
< / I f Modu l e>

I f y ou i nstall eN d onesi a 8 . 4 on y our own pc or serv er, y ou an ch ange y ou ph p. i ni to mak e


th e regi ster_ glob als on.
© May 2006 Endonesia.Org 7
4 . M o d u le s W o n 't W o r k

I f y ou fi nd th e followi ng error message, i t i s d ue to regi ster_ glob al h as b een set to off. T o


solv e th e prob lem, use soluti on N o. 3 .

W arning: m ain( ./ m od/ / index .p h p ) : f ail ed t o op en st ream : N o su c h f il e or direc t ory in .........


W arning: m ain( ) : F ail ed op ening ' ./ m od/ / index .p h p ' f or inc l u sion ( inc l u de_ p at h = ' .; \ p h p 4\ p ear' ) in.......

5 . E r r o r M e s s a g e s H a n d lin g

R ecent v ersi ons of P H P come out wi th a too much aggressi v e errors report b eh av i or b y d e-
fault. T h i s wi ll cause eN d onesi a 8 . 4 d i splay a lot of warni ng, noti ce, and errors.

T h e soluti on i s to put or ad d th e followi ng content to y our . h taccess.

# p h p .ini c onf igu rat ion


< I f Modu l e m od_ p h p 4.c >
p h p _ v al u e error_ rep ort ing 7
< / I f Modu l e>

I f y ou i nstall eN d onesi a 8 . 4 on y our own pc or serv er, y ou can ch ange y ou ph p. i ni to mak e


th e error reporti ng setti ng li k e th i s:

error_ rep ort ing = E_ A L L & ~ E_ N OT I C E

6 . P o llin g M o d u le E r r o r

S ome people reported th at th ey found v ari ous errors caused b y polli ng mod ule, or can
mak e th e poll mod ule work . I n case y ou ex peri enced i t on d efault setup, or th e poll d i d n't
sh ow up i n ri gh t column, j ust d o not turn on th e current poll.

O r, i f y ou li k e, and i t would b e b etter, d elete poll row from mod ules tab le, and d elete poll
d i rectory ( and fi les wi th i n) form mod d i rectory . I n sh ort, let's h av e fun and mak e li fe eas-
i er: d o not use th e poll mod ule.

B ut i f b y d efault th e poll mod ule work s fi ne, use i t.

© May 2006 Endonesia.Org 8


C u s t o m iz a t io n

1 . C reate y our own th emes

T o create y our own th emes, y ou can start b y copy i ng av ai lab le th emes d i rectory . F or ex -
ample, copy D efault d i rectory and gi v e new name to th e new copy .

N o matter h ow much new th emes y ou created , d o not d elete D efault th emes. B ut y ou can
ch ange th e content. T h e i mportant th i ng y ou must h av e i s a d i rectory named D efault.

M ore gui d e on creati ng th emes comi ng soon. . . .

2. C reate y our own mod ules

I f y ou want to create new mod ules, please use pub li sh er mod ule or k atalog mod ules as a
reference. T h e conti nui ng d ev elopment of eN d onesi a 8 . x wi ll b e d ev eloped b ase on b oth
mod ules.

M ore gui d e on creati ng mod ules comi ng soon. . . .

© May 2006 Endonesia.Org 9


W h a t 's N e w in e N d o n e s ia 8 .4

P u b lis h e r

• N ow y ou can put a news or arti cle i nto sev eral categori es.
• T h ere i s an opti on to mak e released d ate of an arti cle d i fferent from th e posti ng d ate.
T h i s enab le y ou to pub li sh old arti cles.
• A new tool, F rontpage M anager, h as b een ad d ed to manage news categori es th at y ou
want to d i splay on th e frontpage of y our portal, as well as on th e ri gh t column. Y ou can
also speci fy h ow many news to b e appeared , and wh eth er i t wi ll b e accompani ed b y a
th umb nai l ph oto or not.

• S end arti cle to fri end h as b een i ntegrated i nto pub li sh er mod ule.

• A new fi le, pub li sh er_ b lock . ph p, h as b een ad d ed to d i splay news category on left or
ri gh t column, j ust li k e si mi lar b lock i n th e d i scussi on forum mod ule.

K a t a lo g

• Y ou can li st a li nk or U R L can b e i nserted i nto sev eral categori es.

• Y ou can create related category for each category .

• F i le k atalog_ b lock . ph p ad d ed to d i splay category b lock on left or ri gh t column.

D is c u s s io n F o r u m

N o ch ange. E x cept an ad d i ti on of P H P generi c word wrap functi on to wrap too long word .

P o llin g

N o ch ange.

M o d u le E d it o r

M od ule ed i tor i s a new tool to ch ange th e confi gurati on of a mod ule d i rectly from th e
ad mi n page. Y ou can use i t to control wh ere a mod ule b lock wi ll b e appeared : left, ri gh t, or
center column.

M e m b e r s h ip

• A d d i ti onal fi eld s h av e b een ad d ed to users tab le to record user regi strati on d ate and th e

© May 2006 Endonesia.Org 10


last logi n d ate.

• N ew functi onali ti es to search and sort memb ers b y v ari ous opti on.

U s e r p a g e

U serpage mod ule no longer av ai lab le. I ts functi on tak en ov er b y th ree new mod ules: con-
tent, ab out, and i nformasi .

N e w M o d u le s :

I n f o r m a s i - mod ule to create i nfo page, prod uct catalog, faq , h elp, etc.

C o n t e n t - mod ule to create y our portal menu.

A b o u t - y ou can use th i s mod ule to create y our portal profi le or y our own profi le.

© May 2006 Endonesia.Org 11


U p g r a d e e N d o n e s ia 8 .3 t o 8 .4

T h i s gui d e assumed th at y ou are upgrad i ng from eN d onesi a 8 . 3 core d i stri b uti on to eN d o-


nesi a 8 . 4 core d i stri b uti on. I f y ou alread y mod i fy or customi z e y our eN d onesi a 8 . 3 portal,
please mak e necessary ad j ustment.

T h e upgrad e process consi st of sev eral steps to create new tab les i n y our ex i sti ng M y S Q L
d atab ase, and ad d i ti onal fi eld s i n ex i sti ng tab les. W e wi ll also d elete some tab les and fi eld s
th at no longer need ed b y eN d onesi a 8 . 4.

T h e new tab les wi ll b e use b y th ree new mod ules: content, ab out, and i nformasi . A d d i -
ti onal tab les also need ed b y pub li sh er and k atalog mod ules.

N ew fi eld s wi ll b e ad d ed to sev eral tab le th at b ei ng used b y pub li sh er and k atalog mod ules,
as well as users and mod ules tab le.

T ab les th at wi ll b e d eleted are menu and mod _ user_ page_ d ata.

L et start th e upgrad e b y i mplementi ng th e followi ng two mai n process:

1 . U p lo a d e N d o n e s ia 8 .4 S c r ip t

U pload th e enti re scri pt of eN d onesi a 8 . 4, ex cept d ocs d i rectory or fold er and th e fi les
wi th i n. K eep th e d i rectory structure i ntact. A llow new fi les to replace th e old one. A nd
mak e th e followi ng d i rectori es wri tab le ( ch mod 777 or 75 7) .

im ages/ m ain_ p age


m od/ ab ou t / f ot o
m od/ c ont ent / f ot o
m od/ inf orm asi/ f ot o
m od/ p u b l ish er/ m edia
m od/ p u b l ish er/ m edia/ t h u m b nail s

2 . D u m p F i l e u p g r a d e -e n d o n e s i a 8 4 -e n . s q l

D ump or i mport fi le upgrad e-end onesi a8 4-en. sq l from d ocs d i rectory to y our ex i sti ng eN -
d onesi a 8 . 3 d atab ase, usi ng e. g. ph pM y A d mi n.

T h e sq l fi le wi ll create sev eral new tab les for th e new mod ules ( i nformasi , ab out, and con-
tent) , as well as new tab le for k atalog and pub li sh er mod ules ( mod _ pub li sh er_ frontpage,
mod _ pub li sh er_ topi k , mod _ k atalog_ k atak ate, and mod _ k atalog_ related ) .

A fter completi ng ab ov e process, let's conti nue th e upgrad e process, manually , wi th sev eral
speci fi c task s. I t's more fun and ex peri enci ng to d o th e upgrad e manually .

© May 2006 Endonesia.Org 12


U p g r a d e m o d u le s T a b e l

eN d onesi a 8 . 4 h as a new tool, M od ule E d i tor, th at can b e used b y A d mi n to confi gure mod -
ules setti ng. A n E d i t li nk h as b een ad d ed nex t to I nstalled M od ule to access th i s new tools.
B ut b efore usi ng M od ule E d i tor, let's upgrad e mod ules tab le, a tab le i n y our d atab ase th at
contai n all i nformati on related to y our current i nstalled mod ule.

W e wi ll upgrad e th e tab le b y ad d i ng a new fi eld , b lock _ ord er, to th e tab le. T h e fi eld wi ll
store sort ord er numb er of each mod ule, th at wi ll b e tak en b y th e scri pt to d i splay y our
mod ule b lock accord i ng to i ts ord er numb er ( on top or b elow oth er mod ule) .

a. A d d i ng b lock _ ord er F i eld

T o ad d th i s new fi eld , use y our ph pM y A d mi n and go to mod ules tab le. U se A d d F i eld s tool
to ad d one fi eld after b lock _ pos fi eld . F i ll i n th e followi ng d ata:

F iel d = b l oc k _ order
T yp e = t inyint
L engt h / v al u es = 1
D ef au l t = 0 ( read: z ero)

b . I nsert D ata for A b out, I nformasi , and C ontent M od ules

U se ph pM y A d mi n S Q L tool to ex ecute th e followi ng q uery .

I N S ER T I N T O ` m odu l es` V A L U ES ( N U L L , ' P rof il e' , ' m od.p h p ? m od= ab ou t ' , ' ab ou t .gif ' , ' ab ou t ' , 1, 2,
' ab ou t _ b l oc k .p h p ' , 0, 0, ' m anager' , ' A b ou t U s' ) ,
( N U L L , ' I nf orm asi' , ' m od.p h p ? m od= inf orm asi' , ' inf orm asi.gif ' , ' inf orm asi' , 1, 3, ' inf orm asi_ b l oc k .p h p ' , 0, 0,
' m anager' , ' I nf orm at ion C ent er' ) ,
( N U L L , ' H OME' , ' m od.p h p ? m od= c ont ent ' , ' c ont ent .gif ' , ' c ont ent ' , 1, 1, ' c ont ent _ b l oc k .p h p ' , 0, 0, ' m anager' , ' P ort al
C ont ent ' ) ;

c. E d i t P ub li sh er and K atalog R ow

A fter ad d i ng th e new fi eld , b rowse th e mod ules tab le. F i nd row or record th at contai n P ub -
li sh er and K atalog d ata. E d i t b oth row b y i nserti ng 'pub li sh er_ b lock . ph p' and
'k atalog_ b lock . ph p' i nto b lock _ fi le fi eld .

A fter completi ng th e ab ov e task , and y ou b rowse th e tab le, all rows wi ll


h av e . . . . _ b lock . ph p, ex cept P olli ng.

d . W h en y ou h av e completed th e enti re upgrad e process, from eN d onesi a 8 . 3 to eN d onesi a


8 . 4, y ou can play wi th th i s M od ule E d i tor b y cli ck i ng E d i t li nk nex t to I nstalled M od ule i n
ad mi n page to confi gure y our mod ules.

A t mi ni mum y ou can use th e M od ule E d i tor to confi gure wh ere y ou want y our mod ule b lock
to appear: left, ri gh t, center. Y ou can set th e posi ti on b y usi ng 0 ,1 ,2,3 . 0 = d o not sh ow th e
b lock . 1 = sh ow th e b lock on left column. 2= C enter. 3 = R i gh t.

Y ou can also set th e b lock appearance, on top or b elow oth er mod ules, b y prov i d i ng as-
cend i ng numb er.

© May 2006 Endonesia.Org 13


U p g r a d e P u b lis h e r M o d u le

a. U pload upgrad e_ pub li sh er_ i nd ex . ph p and upgrad e_ pub li sh er_ ad mi n. ph p from y our d ocs
d i rectory ( P C ) to y our pub li sh er mod ule d i rectory on y our web h osti ng ( mod / pub li sh er) .
B oth fi les contai n some functi ons need ed to upgrad e th e mod ule.

b . R ename i nd ex . ph p and pub li sh er_ ad mi n. ph p fi les wh i ch ex i st i n y our pub li sh er mod ule


d i rectory to new_ i nd ex . ph p and new_ pub li sh er_ ad mi n. ph p

c. R ename upgrad e_ pub li sh er_ i nd ex . ph p and upgrad e_ pub li sh er_ ad mi n. ph p fi les y ou j ust
upload ed to i nd ex . ph p and pub li sh er_ ad mi n. ph p

d . I nsert D ata to mod _ pub li sh er_ topi k T ab le

W h en y ou i mport upgrad e-end onesi a8 4-en. sq l, y ou also create mod _ pub li sh er_ topi k tab el.
T h i s tab le wi ll b e used to store relati on d ata b etween news i d and category i d , and i t wi ll
enab le th e multi -category feature.

W e fi ll th e tab le wi th th e relati on d ata b y runni ng th e followi ng pub li sh er functi on wi th y our


b rowser. Y ou h av e to logi n as ad mi n b efore run th i s process.

http://www.your_portal.com/mod.php?mod=publisher&op=topik_content

N otes: replace www.your_portal.com wi th y our own portal U R L

E x ecute th e U R L one ti me only . I n case of y ou ex ecuti ng th e U R L twi ce, y ou h av e to empty


mod _ pub li sh er_ topi k tab le, and run th e U R L agai n.

e. A d d released F i eld to mod _ pub li sh er T ab el

W e need new fi eld , released , to b e ad d ed to mod _ pub li sh er_ tab le. T h i s fi eld wi ll store re-
leased d ate of an arti cle. W i th th i s new fi eld , we wi ll h av e two d ateti me fi eld i n
mod _ pub li sh er_ tab le. T h e old one i s ti me fi eld .

released fi eld wi ll b e used to sort and li st y our portal news, wh i le th e ti me fi eld wi ll b e used
only as a note on wh en y ou i nsert th e news. B y separati ng th i s d ateti me, we ab le to pub -
li sh old news, or set pub li sh i ng d ate of news.

U se ph pM y A d mi n and go to mod _ pub li sh er tab le. U se ad d fi eld tool to ad d one fi eld after
ti me fi eld , and i nsert th e followi ng d ata.

F iel d = rel eased


T yp e = dat et im e
D ef au l t = 0000-00-00 00: 00: 00

A fter creati ng th e fi eld , we wi ll copy ti me fi eld content to th e released fi eld . L ogi n as


ad mi n, and ex ecute th e followi ng functi on:

http://www.your_portal.com/mod.php?mod=publisher&op=time_released

N otes: replace www. y our_ portal. com wi th y our portal U R L .

© May 2006 Endonesia.Org 14


f. D elete F i eld ci d from mod _ pub li sh er T ab le

W h i le y ou are play i ng wi th mod _ pub li sh er tab le, th ere i s anoth er task to d o: d elete fi eld
ci d . W e no longer need th i s fi eld , as we j ust copy th e ci d content to mod _ pub li sh er_ topi k ,
and wi ll use ci d from th i s tab le to run th e pub li sh er mod ule. ci d used to store y our news
category numb er.

T o d elete ci d fi eld form mod _ pub li sh er tab le, j ust use y our ph pM y A d mi n.

g. A d d ord eri d F i eld to mod _ pub li sh er_ categori es T ab le

T h i s ord eri d fi eld wi ll b e used to sort y our news category appearance i n left or ri gh t b lock .
U se ph pM y A d mi n to ad d th i s fi eld after parenti d fi eld , and ad d th e followi ng:

F iel d = orderid
T yp e = sm al l int
A t t rib u t es = u nsigned
D ef au l t = 0 ( read: z ero)

N otes: ord eri d wi ll only b e used to sort th e mai n category , non sub -category .

A fter creati ng th e ord eri d fi eld , b rowse y our mod _ pub li sh er_ categori es tab le, and sort th e
row b y parenti d . C li ck ch eck b ox on all rows th at h av e parenti d = 0 , and ed i t th e row. F i ll i n
sort ord er numb er ( 1 ,2,3 ,. . . . ) to ord eri d fi eld ( j ust fi ll i t, y ou can ch ange i t later th rough
y our portal) , and sav e i t.

h . P ub li sh er upgrad e almost completed . T h e last steps i s to rev erse step b and c. D elete
i nd ex . ph p and pub li sh er_ ad mi n. ph p from pub li sh er mod ule d i rectory , and th an rename
new_ i nd ex . ph p and new_ pub li sh er_ ad mi n. ph p to i nd ex . ph p and
pub li sh er_ ad mi n. ph p.

© May 2006 Endonesia.Org 15


U p g r a d e K a t a lo g M o d u le

a. U pload upgrad e_ k atalog_ i nd ex . ph p and upgrad e_ k atalog_ ad mi n. ph p fi les from d ocs d i -


rectory ( i n y our P C ) to k atalog mod ule d i rectory on y our web h osti ng ( mod / k atalog) . B oth
fi les contai n some functi on need to d o th e upgrad e.

b . R ename i nd ex . ph p and k atalog_ ad mi n. ph p fi les i n y our k atalog mod ule d i rectory to


new_ i nd ex . ph p and new_ k atalog_ ad mi n. ph p

c. R ename upgrad e_ k atalog_ i nd ex . ph p and upgrad e_ k atalog_ ad mi n. ph p fi les y ou j ust up-


load ed to i nd ex . ph p and k atalog_ ad mi n. ph p

d . F i ll mod _ k atalog_ k atak ate T ab le

W h en y ou i mport upgrad e-end onesi a8 4-en. sq l to y our ex i sti ng M y S Q L d atab ase, y ou auto-
mati caly create mod _ k atalog_ k atak ate tab le. T h i s new tab le wi ll b e used to store relati on
d ata b etween li nk and categori es of y our web d i rectory .

T o fi ll th i s tab le, logi n as ad mi n and run th e followi ng li nk / functi on i n y our b rowser:

http://www.your_portal.com/mod.php?mod=katalog &op=katakate

N O T E S : replace www.your_portal.com wi th y our portal U R L .

D o th i s step one ti me only . I n case y ou ex ecuted i t more th an once, y ou h av e to empty


y our mod _ k atalog_ k atak ate tab le usi ng ph pM y A d mi n and re-run th e process.

e. D elete F i eld ci d from mod _ k atalog T ab le

U si ng ph pM y A d mi n, d elete fi eld ci d from mod _ k atalog tab le. W e no longer need th i s fi eld .
T h e ci d h as b een copi ed to mod _ k atalog_ k atak ate.

f. T h e upgrad e almost completed . T h e fi nal step i s to rev erse step b and c. D elete i n-
d ex . ph p and k atalog_ ad mi n. ph p from k atalog mod ul fold er and th an rename
new_ i nd ex . ph p and new_ k atalog_ ad mi n. ph p to i nd ex . ph p and k atalog_ ad mi n. ph p.

© May 2006 Endonesia.Org 16


U p g r a d e U s e r p a g e t o A b o u t a n d I n f o r m a s i M o d u le

I n eN d onesi a 8 . 3 , we use userpage to create i nd epend ent web page for presenti ng i nfor-
mati on such as y our profi le or any k i nd of i nformati on. W e recogni z ed th i s tool b y W e b
P a g e : new web page and web page li st on ad mi n page.

I n eN d onesi a 8 . 4, th ere are new mod ules to create y our profi le ( A b out mod ule) and to cre-
ate any i nformati on page ( I nformasi mod ule) .

U nfortunately , th ere i s no tool to transfer content of y our current userpage i nto b oth new
mod ules. P lease re-create usi ng b oth mod ules, later.

S o, th e steps y ou h av e to tak e i n th i s upgrad e process are:

a. d elete mod _ userpage_ d ata tab le from y our d atab ase


b . d elete userpage d i rectory ( and th e fi les wi th i n) from y our mod d i rectory

U p g r a d e M e n u t o C o n t e n t M o d u le

W e wi ll no longer use menu tools, k nown as M ai n T h i ng: E d i t M ai n M enu i n eN d onesi a 8 . 3 .


W
e wi ll use th e new C ontent mod ule to create menu. I n sh ort, we h av e turn E d i t M ai n
M enu tool i nto C ontent mod ule.

B y d efault, i n eN d onesi a 8 . 4, th i s mod ule can b e i d enti fi ed as H O M E i n th e li st of av ai lab le


mod ule i n y our ad mi n page.

J ust li k e ab ov e step, th ere i s no upgrad e tool for th i s step. S o, wh at y ou h av e to d o now i s,


usi ng ph pM y A d mi n, d elete menu tab le from y our d atab ase.

© May 2006 Endonesia.Org 17


U p g r a d e U s e r s T a b le

T h i s i s th e last step i n th e enti re upgrad e processes: ad d i ng two fi eld s i nto users tab le. T h e
fi eld s are regd ate ( regi strati on d ate) and lastlogi n ( th e last li me a user logi n to y our por-
tal) .

U se ph pM y A d mi n to ad d two fi eld s A t E n d o f T a b l e . O ne for regd ate, th e oth er for lastlogi n.


B oth h av e same format. T h e d i fference i s only on th e fi eld name. P ut regd ate b efore last-
logi n.

F or regd ate fi eld :

F iel d = regdat e
T yp e = dat et im e
D ef au l t = 0000-00-00 00: 00: 00

F or lastlogi n fi eld :

F iel d = l ast l ogin


T yp e = dat et im e
D ef au l t = 0000-00-00 00: 00: 00

B rowse users tab le after completi ng th e fi eld s ad d i ti on. Y ou wi ll noti ce th at all users wi ll
h av e same regd ate d an lastlogi n: 0 0 0 0 -0 0 -0 0 0 0 :0 0 :0 0 .

A s th i s i s th e fi rst ti me we record memb ers acti v i ti es, let replace th at ti me wi th tod ay or


current ti me.

U se S Q L tool of ph pM y A d mi n to ex ecute th i s q uery :


u p dat e u sers set regdat e= ' 2006-05-12 12: 12: 12' , l ast l ogin= ' 2006-05-12 12: 12: 12' ;

C h ange th e v alue of '2006-05-12 12: 12: 12' as y ou wi sh . T h e format i s:

'year-m ont h -day h ou r: m inu t e: sec ond'

B y ad d i ng th ese new fi eld s, now we can moni tor memb ers acti v i ti es th rough th e new M an-
age U ser tools i n ad mi n page. I f some d ay y ou fi nd , e. g. nex t th ree month s, th at th e v alue
of regd ate i s sti ll si mi lar to lastlogi n, y ou may consi d er to d elete th ose memb er as th ey
nev er came b ack to y our portal.

© May 2006 Endonesia.Org 18


T I P S

1 . R estore A d mi n P assword

I n case y ou forgot y our ad mi n password , th e si mplest way to restore i t i s b y empty i ng au-


th ors tab le and rei nsert i ts ori gi nal content. H ere i s th e d efault v alue ( ad mi n= end onesi a) .
U se S Q L tool of ph pM y A d mi n to ex ecute i t.

I N S ER T I N T O ` au t h ors` V A L U ES ( ' adm in' , ' adm in' , ' ' , ' adm in@ adm in.c om ' ,
' a69b 13b 0b c 4e6ed52ea5e04db c 651314' , 0) ;

2. D o N ot U se D oub le Q uotes

T h e use of d oub le q uotes ( " ) i s forb i d d en i n wri ti ng any content ( pub li sh er, forum, etc) . I f
y ou li k e, y ou can replace i t b y ty pi ng si ngle q uote ( ') twi ce.

3 . T urn O ff M od ules E rror

T h ere are mi lli on way s to create error message i n ph p scri pt. T oward eN d onesi a 8 . x , some
people li k e to play wi th not i nstalled or non ex i sti ng mod ule. L i k e enteri ng mod . ph p?
mod = y ah oo i nto y our portal url.

I t would b e wi se for y ou to turn off th e error mad e b y such game b y ad d i ng '@' sy mb ol to


th e mod . ph p fi le. S o, open y our mod . ph p fi le and ch ange th e content to:

@i nclud e( " . / mod / $ mod / i nd ex . ph p" ) ;

U se th i s si mple meth od only i f y ou th i nk th at y our portal i s alread y runni ng well.

I f somed ay y ou want to mod i fy y our ph p scri pt, remov e th e @ sy mb ol to ch eck for any er-
rors.

© May 2006 Endonesia.Org 19


S u p p o r t a n d D is c la im e r

D is c la im e r

eN d onesi a 8 . 4. i s open source. G P L . Y ou can use, mod i fy , and so on. . . for free.

I f someth i ng goi ng wrong wi th y our portal, fi x i t. D on't b lame me. . .

S u p p o r t

Y ou can ask for support, or sh are y our ex peri ence, at our forum:
h ttp:/ / www. end onesi a. org/ mod . ph p? mod = d i sk usi

I f y ou can speak I nd onesi an language, y ou can v i si t I nd onesi an support forum:


h ttp:/ / www. end onesi a. com/ mod . ph p? mod = d i sk usi

© May 2006 Endonesia.Org 20


R e s o u r c e s

P h pW eb si te h ttp:/ / ph pweb si te. apstate. ed u


P h pN uk e h ttp:/ / www. ph pnuk e. com
P h pL i nk s h ttp:/ / www. ph pli nk s. org

N otetab h ttp:/ / www. notetab . com - multi tab tex t and A S C I I ed i tor

S ourceforge h ttp:/ / www. sourceforge. net

eN d onesi a D ownload C enter - h ttp:/ / www. sourceforge. net/ proj ects/ end onesi a

© May 2006 Endonesia.Org 21

You might also like