Endonesia 8.4 : Instalation Manual

e N d o n e s ia

8 .4

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

W

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

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. T h i s ph p scri pts work s on any operati ng sy stem, i nclud i ng 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) and M y S Q L ( v 3 . x and ab ov e) . M ore b etter, on A pach e web serv er.

eN eN eN eN eN

donesia donesia donesia donesia donesia

8.4 8.3 8.2 8.1 8.0

-

May 2006 N ov em b er 2003 A u gu st 2002 J u ne 2002 May 2002

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 released 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 onesi 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 . 2. 3 . 4. 5 . 6. 7.

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

P h oto G allery N ewsletter/ M ai li ng L i st C lassi fi ed A d s 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 $ db $ db $ db

h ost = " l oc al h ost " ; u nam e = " dat ab ase_ u sernam e" ; p ass = " dat ab ase_ p assw ord" ; nam e = " dat ab ase_ nam e" ;

S econd part, S i te I d enti fi cati on: $ sit enam $ p ort al _ u $ p ort al _ m $ st art dat $ adm inm

e= rl = ot e= ail

" Endonesia 84 Engl ish v ersion" ; " h t t p : / / w w w .endonesia.c om " ; t o = " T h e N ex t Y ah oo" ; " May 2006" ; = " rep u b l ik @ indonesia.c om " ;

W

a rn in g

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 t h e end of t h e l ine. D o not p u t any ot h er l ine, inc l u ding b l ank sp ac e, b el ow it .

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 fferences 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 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 ...... 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 < I p h < /

h p .ini c onf igu rat ion f Modu l e m od_ p h p 4.c > p _ v al u e session.sav e_ p at h I f Modu l e>

" ./ sessions"

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 confi 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 ster_ 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 < I p h < /

h p .ini c onf igu rat ion f Modu l e m od_ p h p 4.c > 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

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 ......... 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 efault. 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 < I p h < /

h p .ini c onf igu rat ion f Modu l e m od_ p h p 4.c > 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 =

6 . P o llin g

E_ A L L &

~ E_ N OT I C E

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 easi 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 1 .

iz a t io n

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: content, 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 onesi 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 content) , 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 = T yp e = L engt h / D ef au l t

b l oc k _ order t inyint v al u es = 1 = 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 , ' ab ou t _ b l oc k .p h p ' , 0, 0, ' m anager' , ' A b ou ( N U L L , ' I nf orm asi' , ' m od.p h p ? m od= inf orm ' 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 ' ) ;

' P rof il e' , ' m od.p h p ? m od= ab ou t ' , ' ab ou t .gif ' , ' ab ou t ' , 1, 2, t U s' ) , asi' , ' inf orm asi.gif ' , ' inf orm asi' , 1, 3, ' inf orm asi_ b l oc k .p h p ' , 0, 0, ' 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. 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 ascend 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.

W

e. A d d released F i eld to mod _ pub li sh er T ab el 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 released 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 = T yp e = A t t rib u t D ef au l t

orderid sm al l int es = u nsigned = 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 upload 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 automati 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 T h e ci d h as b een copi ed to mod _ k atalog_ k atak ate.

e no longer need th i s fi eld .

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 nd 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 nformati 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 create 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

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 . 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. W

W

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 mod ule i n y our ad mi n page.

i n th e li st of av ai lab le

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 portal) . 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 lastlogi 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: 'year-m

12: 12'

as y ou wi sh . T h e format i s:

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 anage 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 auth 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@ ' a69b 13b 0b c 4e6ed52ea5e04db c 651314' , 0) ;

adm in.c om ' ,

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 errors.

© May 2006 Endonesia.Org

19

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

D is c la im

e r

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