LIFERAY QUICKSTART GUIDE

Rich Sezov
Liferay Quickstart Guide
Richard L. Sezov, Jr.
Copyright 200 !y Liferay, "#c.
$his %ork is offered u#der the Creative Co&&o#s 'ttri!utio#(Share ')ike *#ported )ice#se.
+ou are free,
to share-to copy, distri!ute, a#d tra#s&it the %ork
to re&i.-to adapt the %ork
*#der the fo))o%i#g co#ditio#s,
Attribution. +ou &ust attri!ute the %ork i# the &a##er specified !y the author or )ice#sor
/!ut #ot i# a#y %ay that suggests that they e#dorse you or your use of the %ork0.
Share Alike. "f you a)ter, tra#sfor&, or !ui)d upo# this %ork, you &ay distri!ute the resu)ti#g
%ork o#)y u#der the sa&e, si&i)ar or a co&pati!)e )ice#se.
$he fu)) versio# of this )ice#se appears i# the appe#di. of this !ook, or you &ay vie% it o#)i#e here,
http,11creativeco&&o#s.org1)ice#ses1!y(sa12.0
Table of Contents Table of Contents
1. Introduction and Installation......................................................................................................5
L"34R'+ "5S$'LL'$"65..............................................................................................................................................7
2. Initial Administration.................................................................................................................9
3. Building Your Intranet..............................................................................................................15
C65$45$ 8'5'G4845$..........................................................................................................................................97
CR4'$"5G '5 ':8"5"S$R'$";4 <'G4..........................................................................................................................9=
<6LLS <6R$L4$S....................................................................................................................................................9>
?L6GS '5: ?L6GS 'GGR4G'$"65...............................................................................................................................29
?R4':CR*8?S '5: 84SS'G4 ?6'R:S.........................................................................................................................22
54@S '5: RSS 344:S............................................................................................................................................27
<R6J4C$S '5: @"A"S..............................................................................................................................................2B
6RG'5"C'$"65 <'G4S.............................................................................................................................................2>
$D484S...............................................................................................................................................................20
4. Installing Your Intranet on a Real Serer.................................................................................33
iii
1.
1.
I
INTRODUCTION NTRODUCTION
AND AND
I
INSTALLATION NSTALLATION
@e)co&e to the Liferay Quickstart GuideE $his docu&e#t is i#te#ded to get you up a#d ru##i#g
%ith Liferay as Fuick)y as possi!)e. $o do this, %e %i)) %a)k through the steps of i&p)e&e#ti#g Liferay for a
corporate "#tra#et, o#e of &a#y app)icatio#s for %hich Liferay <orta) is used. "f this is your i&p)e&e#ta(
tio#, you %i)) !e a!)e to direct)y app)y the co#cepts here to your "#tra#et. "f #ot, you %i)) sti)) !e a!)e to use
these tech#iFues to !ui)d your site, as %e %i)) !e i&p)e&e#ti#g &a#y of LiferayGs !ui)t(i# features, a#d you
%i)) !e a!)e to see ho% they %ork firstha#d.
'#d so, %ithout further ado /this is a !uickstart Guide after a))0, )etGs get started.
Liferay Installation
' prereFuisite for i#sta))i#g Liferay is to have the J:A /Java :eve)op&e#t Ait0 i#sta))ed first. "f
youGre ru##i#g Li#u. or a 8ac o# your &achi#e, the J:A is ge#era))y provided !y the ve#dor of your oper(
ati#g syste&, either o# a C: or i# a do%#)oada!)e soft%are repository.
"f youGre ru##i#g @i#do%s, itGs a )itt)e &ore co&p)icated. Go to http,11Hava.su#.co& a#d do%#)oad
the )atest versio# of the J:A. "t is )ike)y )a!e)ed IJava S4J i# the Popular Downloads sectio#. @he# you i#sta))
it, do#Gt i#sta)) it i# the defau)t )ocatio#. "#stead, i#sta)) it to a fo)der #ear the root fo)der o# your &achi#e,
such as C,KJava. *se the su!fo)der #a&e that it gives you /i.e., Hdk9.B.0L0B0 so that the fu)) path )ooks so&e(
thi#g )ike C,KJavaKHdk9.B.0L0B. @he# the i#sta))er for the JR4 co&es up, cha#ge the path for that too so that
it is i#side C,KJava.
@he# you are fi#ished, go to your Co#tro) <a#e) a#d c)ick the Syste& ico#. Go to 'dva#ced, a#d
c)ick the 4#viro#&e#t ;aria!)es !utto#. 'dd a syste& varia!)e /#ot a user varia!)e0 ca))ed J';'LD684, a#d
poi#t it to the directory to %hich you i#sta))ed the J:A /i.e., C,KJavaKHdk9.B.0L0B0. C)ick 6A, a#d the# edit the
<ath varia!)e, %hich youG)) fi#d i# the )ist of syste& varia!)es. 't the !egi##i#g of the varia!)e, add a sec(
tio# %hich reads MJ';'LD684MK!i# a#d put a se&ico)o# /N0 after it. C)ick 6A u#ti) you co&e out of a)) the
dia)og !o.es, a#d the# ope# a Co&&a#d <ro&pt %i#do%. $ype Hava Oversio# a#d press 4#ter. "f you get a
&essage te))i#g you the versio# of Java, youPve correct)y co#figured the J:A. "f #ot, check your J';'LD684
varia!)e to see if you have it poi#ti#g to the )ocatio# of your J:A i#sta)) correct)y, a#d &ake sure your sy#(
ta. is correct i# your <ath varia!)e.
"#troductio# a#d "#sta))atio#
Liferay <orta) is provided as o#e of severa) co#ve#ie#t app)icatio# server !u#d)es. $his is !y far the
fastest a#d easiest %ay to i#sta)) Liferay, so %e %i)) use it. +ou ca# gra! the reco&&e#ded !u#d)e at Lifer(
ayGs do%#)oad page, http,11%%%.)iferay.co&1%e!1guest1do%#)oads1porta). $he )i#k %i)) !e right there at
the top of the pageN c)ick it a#d do%#)oad the !u#d)e to a co#ve#ie#t )ocatio# o# the &achi#e upo# %hich
you %a#t to !ui)d your site.
$he reco&&e#ded !u#d)e uses the )ight%eight $o&cat serv)et co#tai#er as a# app)icatio# server
to host Liferay. $o i#sta)) it, si&p)y u#zip it. "t %i)) create a fo)der a#d a fo)der structure u#der#eath that
fo)der. "t does#Gt &odify co#figuratio# fi)es, cha#ge registry setti#gs, or a#ythi#g )ike that. *#i#sta))i#g Lif(
eray is as si&p)e as de)eti#g this fo)der.
6#ce youGve u#zipped Liferay, you ca# ru# it i&&ediate)y. "t uses a# e&!edded data!ase to
achieve this so you ca# get up a#d ru##i#g Fuick)yN ho%ever, the defau)t e&!edded data!ase is popu)ated
%ith LiferayGs %e! site. @eGre goi#g to create our o%# %e! site, so )etGs start %ith a# e&pty data!ase.
5avigate to the fo)der to %hich you i#sta))ed Liferay. "#side this fo)der shou)d !e a fo)der ca))ed binN
ope# this fo)der. "#side you %i)) fi#d severa) fi)es. 8ove lportal.properties a#d lportal.log out of this fo)der, or
de)ete the&.
5o% you are ready to start LiferayE "f you are o# @i#do%s, dou!)e(c)ick o# the startup.bat fi)e thatGs
i# this fo)der. "f you are o# Li#u. or 8ac, )au#ch the startup.sh fi)e. Liferay %i)) start a#d %i)) create a #e%,
!)a#k data!ase auto&atica))y. "f you are ru##i#g @i#do%s, the @i#do%s 3ire%a)) &ay pop up. 8ake sure
you u#!)ock Liferay, or you %o#Gt !e a!)e to co##ect to it via your !ro%ser o#ce it starts, %hich &akes this
%ho)e e.ercise a &oot poi#t.
$o see your #e% porta), ope# up a !ro%ser a#d type the fo))o%i#g *RL i#to the address !o.,
http,11)oca)host,00
+ou %i)) see LiferayGs defau)t ho&e page,
B Liferay "#sta))atio#
Illustration 1: Setting the environment variables on Windows.
"#troductio# a#d "#sta))atio#
Co#gratu)atio#sE +ou have Hust i#sta))ed Liferay <orta)E
Liferay "#sta))atio# =
Illustration 2: Liferays default home page.
2.
2.
I
INITIAL NITIAL
A
ADMINISTRATION DMINISTRATION
5o% that you have Liferay <orta) ru##i#g, you ca# !egi# setti#g up your "#tra#et. 6# the )eft side
of your scree# is the Sig# "# port)et. Log i# %ith the fo))o%i#g crede#tia)s,
"ogin# testQ)iferay.co&
$ass%ord# test
$he first ti&e you )og i#, you %i)) !e prese#ted %ith the $er&s of *se page. Scro)) do%# to the !ot(
to& of your scree# a#d c)ick the I !gree !utto#. $he $er&s of *se scree# ca# !e disa!)ed or custo&ized )at(
er if you %ish. 6#ce you c)ick the !utto#, you %i)) !e prese#ted %ith the ad&i#istrative userGs perso#a)
ho&e page.
$his page is accessi!)e o#)y to the 'd&i#istrator, !ecause that accou#t has the <o%er *ser ro)e.
+ou %i)) proceed first to custo&ize this page i# order to create a# accou#t for yourse)f a#d &ake yourse)f
a# 'd&i#istrator.
')) of the sFuare !o.es o# the page are k#o%# as portlets. <ort)ets are %e! app)icatio#s that ca# !e
added to a page to provide fu#ctio#a)ity. Si#ce Liferay is a porta) server, a)) of the fu#ctio#a)ity it provides
has !ee# i&p)e&e#ted as port)ets. $he port)ets that are o# the ad&i#istratorGs page !y defau)t are good for
e.p)ori#g so&e of LiferayGs fu#ctio#a)ity, !ut they are #ot very usefu) to ad&i#ister Liferay. So %e %i)) re(
&ove these port)ets a#d add ad&i#istrative port)ets to the page i#stead.
C)ick the red R ico# i# the top right cor#er of each port)et %i#do% u#ti) you have c)eared the page
co&p)ete)y. $he# &ove your &ouse cursor up to the :ock, %hich is i# the top right of your !ro%ser %i#(
do%, disp)ayi#g the &essage I@e)co&e $est $estEJ @he# your &ouse touches it, it %i)) e.pa#d to sho%
&ore )i#ks. C)ick the o#e )a!e)ed Layout "emplate. Choose the 2 #olumns $%&'% )ayout a#d c)ick Save.
5e.t, go !ack up to the :ock a#d c)ick !dd !ppli(ation. ' categorized )ist of app)icatio#s /i&p)e(
&e#ted as port)ets0 %i)) appear. C)ick o# the 'd&i# category to e.pa#d it. +ou %i)) see a )ist of port)ets that
ca# !e added to the page. :rag the )nterprise !dmin port)et off of the )ist a#d o#to the )eft co)u&# of your
page a#d drop it there.
"#itia) 'd&i#istratio#
5e.t, drag the !dmin port)et i#to the right ha#d /s&a))er0 co)u&# a#d drop it there. 3i#a))y, ope#
the Co&&u#ity category a#d drag a#d drop the #ommunities port)et i#to the )eft co)u&# u#der#eath the
4#terprise 'd&i# port)et.
$hese are a)) the port)ets you %i)) #eed to do your i#itia) ad&i#istratio# of your #e% Liferay <orta)
server. C)ose the 'dd 'pp)icatio# %i#do% !y c)icki#g o# the red R i# the top right cor#er. +ou shou)d #o%
have a scree# that )ooks )ike this,
90 "#itia) 'd&i#istratio#
Illustration ': Dragging and dropping the )nterprise !dmin portlet onto your page.
"#itia) 'd&i#istratio#
+ou are #o% ready to !egi# creati#g your porta)E
LetGs create the orga#izatio# %hose porta) this is. 3or the purposes of this docu&e#t, %eG)) ca)) it
&' (om)an'. C)ick the *rgani+ations ta! i# the 4#terprise 'd&i# port)et, a#d the# c)ick the !dd *rgani+a,
tion !utto#.
Give your orga#izatio# a
#a&e of -y #ompany a#d choose a
cou#try a#d regio# for the co&pa(
#y. C)ick Save.
+ou %i)) see that the for&
has #o% !ee# e.pa#ded to a))o%
you to add a)) ki#ds of i#for&atio#
a!out the co&pa#y, i#c)udi#g
e&ai) addresses, &ai)i#g addresses,
%e! sites, a#d &ore. 3or #o%, %e
%o#Gt e#ter a#ythi#g e)se, !ut you
ca# a)%ays co&e !ack a#d add
&ore data a!out your co&pa#y
here.
C)ick the .a(/ ta! to go !ack to the )ist of orga#izatio#s. +ou %i)) #o% see the 8y Co&pa#y orga#i(
zatio# i# the )ist. 6# the right side of the scree# is a !utto# )a!e)ed !(tions. C)ick this !utto# a#d the# c)ick
the !dd 0ser )i#k fro& the )ist that appears.
' #e% for& %i)) appear a))o%i#g you to e#ter #e% user i#for&atio#. *se this for& to create a# ac(
cou#t for yourse)f i# the porta). 't a &i#i&u&, you %i)) #eed to give yourse)f a scree# #a&e, a# e&ai) ad(
dress, a first #a&e, a#d a )ast #a&e. C)ick Save. 's !efore, the for& %i)) reappear %ith &ore fie)ds, a))o%i#g
you to e#ter a )ot &ore data a!out yourse)f, i#c)udi#g a picture to use for your avatar. "f you have a picture
ha#dy, go ahead a#d add it.
"#itia) 'd&i#istratio# 99
Illustration 1: #ompleted page of administrative portlets.
Illustration 2: #reating -y #ompany.
"#itia) 'd&i#istratio#
8ost i&porta#t)y, if you %ere
ru##i#g Liferay o# a server
%hich a)so %as host to a &ai)
server, you %ou)d have received
a pass%ord fro& the syste& i#
your i#!o.. Si#ce it is )ike)y that
you do#Gt have a &ai) server o#
the sa&e &achi#e upo# %hich
youGve i#sta))ed Liferay, you %i))
have to cha#ge your pass%ord
so you ca# )og i#.
C)ick the Password ta!
a#d put the pass%ord you %a#t
to use i# the t%o fie)ds, a#d
the# c)ick Save.
$he #e.t thi#g %e %a#t
to do is give your accou#t the
sa&e ad&i#istrative rights that
the defau)t ad&i#istrator accou#t has. 6#ce %eGve do#e that, %e ca# cha#ge the pass%ord o# the defau)t
ad&i#istrator accou#t so that it is #ot at the defau)t setti#g a#d )og out. @he# %e )og !ack i#, %eG)) )og i#
%ith your accou#t a#d !ui)d the porta) usi#g your user ":.
C)ick the .a(/ ta! a#d the# c)ick the 3oles ta!. C)ick the !(tions !utto# #e.t to the Administrator
ro)e a#d c)ick !ssign -embers. +ou %i)) see a )ist of peop)e %ho are curre#t)y i# the ro)e /Hust the defau)t ad(
&i#istrator, as that is the o#)y accou#t i# the syste&0. C)ick the !vailable ta!. +our #a&e %i)) !e i# the )ist.
Check it a#d c)ick the 0pdate !sso(iations !utto#. Co#gratu)atio#sE +ou are #o% a porta) ad&i#istrator.
5o% %e #eed to cha#ge the defau)t ad&i#istratorGs pass%ord. Go up to the :ock a#d c)ick the -y
!((ount )i#k. +ou %i)) see the sa&e user for& you fi))ed out ear)ier. C)ick the Password ta! a#d cha#ge the
pass%ord to so&ethi#g other tha# the defau)t. 6#ce you have do#e that, you ca# go ahead a#d )og out of
the porta).
Log !ack i# usi#g your #e% accou#t. Re&e&!er, your )ogi# is your e&ai) address, a#d the pass(
%ord is %hatever you set. +ou %i)) agai# #eed to agree to the ter&s of use, a#d the# you %i)) !e !rought to
your custo& ho&e page. +ou are the o#)y perso# %ho ca# access this page. $his ti&e, )eave it a)o#eN you
pro!a!)y %i)) %a#t to re&ove so&e of the port)ets o# this page, !ut you &ay a)so %a#t to keep %a#t so&e
of the& /such as the Ca)e#dar0. +ou ca# decide that )ater.
"#stead, c)ick the !dd Page )i#k i# the top #avigatio#. 5a&e your page !dmin a#d press 4#ter. $he
#e% page %i)) !e created. C)ick o# the )i#k a#d you %i)) see your #e%, !)a#k 'd&i# page. 's !efore, use the
Layout "emplate )i#k i# the :ock to choose the 2 #olumns $%&'% )ayout, a#d add the 4#terprise 'd&i#, Co&(
&u#ities, a#d 'd&i# port)ets to the page.
+ou have a fe% &ore ad&i#istrative tasks to do !efore %e ca# start !ui)di#g your "#tra#et. 3irst,
%e #eed to &ake your accou#t a &e&!er of the Guest co&&u#ity. $he Guest co&&u#ity ships %ith Liferay
as the ho&e page of your porta). +ou %i)) #eed to !e a &e&!er of the co&&u#ity for its )i#ks to sho% up i#
the :ock %he# you are )ogged i#. 6# the Co&&u#ities port)et, c)ick the !ll #ommunities ta!. C)ick the !(,
tions !utto# #e.t to the Guest co&&u#ity a#d c)ick 4oin.
5o% %e %a#t to &ake it so that a)) #e%)y registered users auto&atica))y !eco&e &e&!ers of the
Guest co&&u#ity. $o do this, %e #eed to go !ack to the 4#terprise 'd&i# port)et. C)ick the 3eturn to full
page )i#k i# the top right cor#er of the Co&&u#ities port)et a#d the# c)ick the arro% ta! i# the 4#terprise
92 "#itia) 'd&i#istratio#
Illustration 5: !dding a new user.
"#itia) 'd&i#istratio#
'd&i# port)et. 5e.t, c)ick the Settings ta!. 6# this page, %e ca# cha#ge so&e g)o!a) setti#gs for your porta).
Cha#ge the 5a&e to &yco&pa#y.co& a#d cha#ge the 8ai) :o&ai# to &yco&pa#y.co&. Cha#ge the $i&e
Co#e to your ti&e zo#e, a#d the# c)ick the Save !utto#.
5e.t, c)ick the Default 0ser !sso(iations ta!. "# the fie)d o# the top /defau)t co&&u#ity #a&es0, put
6uest a#d the# c)ick the Save !utto#. 5o% %he# you register a#yo#e #e% /or if they register the&se)ves0,
they %i)) auto&atica))y !eco&e &e&!ers of the Guest co&&u#ity. $his a))o%s the& to vie% !oth the pu!)ic
a#d private pages of the co&&u#ity, a#d gives the& defau)t per&issio#s i# the co&&u#ity to do such
thi#gs as post to &essage !oards, add docu&e#ts to a docu&e#t )i!rary, etc. +ou ca# a)%ays custo&ize
these per&issio#s )ater.
+ou are #o% ready to !egi# !ui)di#g your "#tra#et.
"#itia) 'd&i#istratio# 92
3.
3.
B
BUILDING UILDING
Y
YOUR OUR
I
INTRANET NTRANET
$he re&ai#der of this docu&e#t %i)) %a)k you through creati#g pages i# Liferay a#d )oadi#g the&
%ith co#te#t. @e %i)) see a )ot of the !ui)t(i# features of Liferay. ?ecause Liferay is a porta) server, you ca#
add #e% features to it yourse)f !y do%#)oadi#g or purchasi#g third party port)ets-or !y deve)opi#g so&e
port)ets yourse)f.
Content Management
Go up to the :ock a#d scro)) to -y Pla(es ,7 6uest a#d c)ick Publi( Pages. $his the ho&e page of your
porta), a#d itGs pretty sparta# at this poi#t. So )etGs Hazz it up.
Go up to the :ock a#d c)ick Layout "emplate. <ick 2 #olumns $%&'% a#d c)ick Save. 5o% drag the Sig#
"# port)et over to the co)u&# o# the right. Re&ove the De))o @or)d port)et. Go up to the :ock a#d c)ick !dd
!ppli(ation. 3ro& the C8S category, drag a Jour#a) Co#te#t port)et to the )eft co)u&# a#d drop it there.
C)ick the !dd !rti(le ico# %hich appears i# the port)et. +ou %i)) see a co#te#t &a#age&e#t %i#do% appear.
$his is part of LiferayGs Co#te#t 8a#age&e#t syste&, a#d it a))o%s you to create static co#te#t for your %e!
pages.
@eGre goi#g to put Hust a tit)e at the top of the page. Give the artic)e the #a&e Wel(ome a#d type the
%ord Wel(ome8 i#to the rich te.t editor. Digh)ight the te.t you typed a#d choose 99,Large fro& the Si+e drop
do%#. C)ick the "e:t #olor ico# %hich is right #e.t to it a#d choose a co)or you )ike. 3i#a))y, c)ick the .old
ico# a#d c)ick the Save and !pprove !utto# at the !otto& of the page.
+ouG)) !e !ack to your ho&e page, !ut this ti&e it %i)) !e disp)ayi#g the Jour#a) artic)e you created
i# a port)et %i#do%. +ou ca# add as &a#y Jour#a) Co#te#t port)ets as you )ike to popu)ate your page %ith
co#te#t. Go ahead a#d use the :ock to add three &ore Jour#a) Co#te#t port)ets to your page, t%o u#der(
#eath your %e)co&e &essage a#d o#e i# the right ha#d co)u&# u#der#eath the Sig# "# port)et.
+ou ca# add %hatever co#te#t you )ike to the t%o port)ets i# the co)u&# o# the )eft, youGd ge#era)(
)y %a#t to put #e%s a##ou#ce&e#ts hereN thi#gs youGd %a#t everyo#e to see %he# they co&e to your cor(
porate ho&e page. <ut a CafS 8e#u i# the port)et o# the right, so your visitors ca# see %hat your cafeteria
is servi#g this %eek. "f you do#Gt have rea) co#te#t, have fu# &aki#g it upE
@he# youGre fi#ished, you shou)d have a page that )ooks so&ethi#g )ike this,
?ui)di#g +our "#tra#et
5o% %e %a#t to add a page for co&&u#ity a#d co))a!oratio#. C)ick the !dd Page )i#k at the top of
the page. Give the page the #a&e #ommunity. Go up to the :ock, c)ick Layout "emplate, a#d se)ect the ' #ol,
umn )ayout.
@e %i)) !e &aki#g this page the ce#tra) focus of g)o!a) co))a!oratio# for your "#tra#et. Later, you
ca# actua))y create orga#izatio#s for the various groups %ithi# your co&pa#y to have their o%# co))a!ora(
tio# spaces, !ut this %i)) !e a shared area %here everyo#e ca# go.
Go up to the :ock a#d c)ick !dd !ppli(ation. 3ro& the C8S category, add the 5avigatio# port)et to
the )eft co)u&#. 3ro& the Co))a!oratio# category, add the Rece#t ?)oggers port)et to the )eft co)u&# u#der
the 5avigatio# port)et.
"# the &idd)e co)u&#, add a Jour#a) Co#te#t port)et fro& the C8S category a#d the Co&&u#ities
port)et fro& the Co&&u#ity category.
"# the right co)u&#, add a <o))s :isp)ay port)et fro& the <o))s category a#d the <age Co&&e#ts
port)et fro& the #ommunity category. C)ose the !dd !ppli(ation %i#do%. 'dd a# artic)e e.p)ai#i#g %hat this
page is for to the Jour#a) Co#te#t port)et you added to the &idd)e co)u&#.
Creating an Administrative Page
5otice that severa) of the port)ets have #o co#te#t i# the&T $hese port)ets reFuire co#te#t to !e
created i# other areas of the porta) !efore a#y co#te#t %i)) sho% up. LetGs take the si&p)est o#e first a#d fi))
9B Creati#g a# 'd&i#istrative <age
Illustration $: ;ome page after adding some (ontent.
?ui)di#g +our "#tra#et
it %ith co#te#t. $o do this, %e %i)) create a specia) ad&i#istrative private page i# your "#tra#et.
Go up to the :ock, #avigate to -y Pla(es ,7 -y #ommunity ,7 Private Pages. C)ick o# the !dmin page
you created ear)ier. "# the Co&&u#ities port)et, c)ick the !ll #ommunities ta!. C)ick the !(tions !utto# a#d
se)ect -anage Pages. +ou shou)d see the fo))o%i#g scree#,
+ou ca# see o# the )eft a hierarchy of pages that you have !ee# creati#g. So far, you have a f)at )ist
of pages, !ut you ca# #est the& as deep)y as you %a#t. Aeep i# &i#d if you do this that &ost of LiferayGs
the&es o#)y provide #avigatio# for the top )eve), so you %i)) have to put a 5avigatio# or ?readcru&! port(
)et o# these pages i# order to e#a!)e users to get to the&. @e have a)ready do#e this o# the Co&&u#ity
page you have created, !ecause %e %i)) !e addi#g a #ested page u#der the Co&&u#ity page.
'cross the top you have ta!s for <u!)ic <ages, <rivate <ages, a#d Setti#gs. Setti#gs affect the pages
for the %ho)e co&&u#ity. +ou ca# set virtua) hosts, e#a!)e Goog)e '#a)ytics o# your pages, a#d a %ho)e
host of other thi#gs. @e %o#Gt go i#to that here, !ut fee) free to e.p)ore the i#terface yourse)f.
So far, %e have !ee# creati#g pu!)ic pages. $his ti&e, %e are goi#g to create a# ad&i#istrative pri(
vate page. ' pu!)ic page is vie%a!)e !y everyo#e, eve# those %ho are #ot )ogged i# to your porta). ' private
page is vie%a!)e o#)y !y &e&!ers of the co&&u#ity. ?y creati#g a private page i# the Guest co&&u#ity,
%e are e#suri#g that o#)y peop)e %ho are )ogged i# to the porta) ca# vie% it, !ecause %e ear)ier &ade ev(
eryo#e %ho is registered i# the porta) a &e&!er of the Guest co&&u#ity !y defau)t. 3or this reaso#, &ak(
i#g the ad&i#istrative page a private page %i)) o#)y protect it fro& peop)e %ho are #ot )ogged i# to the por(
ta)-hard)y a good security &easure. So after %e create the page, %e %i)) p)ace custo& security restrictio#s
o# it so that o#)y the peop)e %e specify &ay vie% the page.
C)ick the Private Pages ta!. +ou %i)) see that there are #o pages i# the hierarchy o# the )eft, !ecause
Creati#g a# 'd&i#istrative <age 9=
Illustration <: Liferays -anage Pages interfa(e.
?ui)di#g +our "#tra#et
there are #o private pages yet. 6# the right side of the scree#, give the page the #a&e !dmin a#d c)ick the
!dd Page !utto#. 5o% you have a page i# the tree o# the )eft. C)ick o# your #e% page, a#d the# c)ick the
Page ta! o# the right side of the scree#. C)ick the Permissions !utto# at the !otto&. +ou %i)) see Liferay <or(
ta)Gs per&issio#s scree#. C)ick the #ommunity 3oles ta!, a#d the# c)ick the !vailable ta!. +ou shou)d see the
fo))o%i#g,
Se)ect Co&&u#ity 'd&i#istrator a#d Co&&u#ity 6%#er !y c)icki#g the check !o.es to the )eft of
their #a&es a#d the# c)ick 0pdate Permissions.
+ou %i)) #o% set the per&issio#s for the first ro)e you se)ected. Se)ect the =iew per&issio# a#d
c)ick the arro% to &ove it over to the )eft. ?y doi#g this, you are sayi#g that users %ith the Co&&u#ity 'd(
&i#istrator Ro)e ca# ;ie% this page. C)ick the >e:t !utto#.
+ou %i)) the# !e a!)e to set the per&issio#s for the Co&&u#ity 6%#er ro)e. Se)ect a)) the per&is(
sio#s a#d &ove the& to the )eft. $he# c)ick the ?inished !utto#.
9 Creati#g a# 'd&i#istrative <age
Illustration @: Liferays permissions interfa(e.
?ui)di#g +our "#tra#et
're %e do#e yetT 5o, #ot yet. @hyT ?ecause, though %e have gra#ted ad&i#istrators access to the
page, %e have #ot yet take# a%ay access fro& the rest of the co&&u#ity. So c)ick the #ommunity ta!.
?y defau)t, the co&&u#ity ca# add discussio# /if youGve added the <age Co&&e#ts port)et to a
page0 or vie% a#y page i# the co&&u#ity. @eGre goi#g to take these per&issio#s a%ay. 8ove the !dd Dis,
(ussion a#d =iew per&issio#s to the right /'vai)a!)e0 co)u&# a#d c)ick Save. 5o% c)ick the .a(/ ta!.
Polls Portlets
LetGs put so&e port)ets o# this page #o%. C)ick the =iew
Pages !utto# i# the top )eft cor#er. +ou %i)) prese#ted %ith a #o%(
fa&i)iar !)a#k porta) page. Go up to the :ock a#d c)ick !dd !ppli(a,
tion. 3ro& the <o))s category, add the <o))s port)et. 5otice that the <o))s port)et has a purp)e ico# a#d the
<o))s :isp)ay port)et has a gree# ico#. $his is te))i#g you that the <o))s port)et is a non,instan(eable port)et
a#d the <o))s :isp)ay port)et is a# instan(eable port)et.
$his &ea#s that the <o))s port)et ca# !e added to a co&&u#ity o#ce, a#d it ho)ds o#e set of data. "#
this case, you %i)) !e addi#g po)) Fuestio#s %ith &u)tip)e choice a#s%ers. $he set of Fuestio#s !e)o#gs to
the co&&u#ity as a %ho)e. So if you add the <o))s port)et to a#other page i# the co&&u#ity, the sa&e set of
Fuestio#s %i)) !e disp)ayed. $he <o))s :isp)ay port)et, ho%ever, is differe#t. "t ca# !e added &a#y ti&es to
pages i# the co&&u#ity, a#d each i#sta#ce of the port)et ca# ho)d a differe#t po)) Fuestio#. So you use the
<o))s port)et to create Fuestio#s a#d the <o))s :isp)ay port)et to disp)ay the& a#d a))o% users to a#s%er
the&.
"f you %ere to add the <o))s port)et to a#other co&&u#ity, that co&&u#ity %ou)d get its o%# set
of Fuestio#s that is differe#t fro& the o#es i# the Guest co&&u#ity. ?ut each i#sta#ce of that port)et has
the sa&e set of data %ithi# that co&&u#ity. $hat is %hat &akes it #o#(i#sta#cea!)e.
6#ce you have added the <o))s port)et to the page, c)ose the !dd !ppli(ation %i#do%. +ou have o#e
!utto# i# a defau)t <o))s port)et, !dd Auestion. Go ahead a#d c)ick it. +ou %i)) see a for& %hich a))o%s you to
add a Fuestio# a#d the &u)tip)e choice a#s%ers. +ou ca# eve# add choices !eyo#d the defau)t t%o !y c)ick(
i#g the !dd #hoi(e !utto#. Dave fu#. 8ake up a Fuestio#. @he# youGre fi#ished, you shou)d have so&ethi#g
<o))s <ort)ets 9>
Illustration 1%: Setting permissions on a role.
Illustration 11: Polls portlets
?ui)di#g +our "#tra#et
%hich )ooks )ike the fo))o%i#g,
C)ick Save. +ou have #o% added a <o)) Fuestio# o# the ad&i#istrative page. $his &akes it so that
o#)y ad&i#istrators ca# create po)) Fuestio#s. +ou are #o% ready to disp)ay this Fuestio# o# the #ommunity
page, %here you added the <o))s :isp)ay port)et.
Go up to the :ock a#d go to -y Pla(es ,7 6uest ,7 Publi( Pages. C)ick the )i#k to the #ommunity page
you created. "# the <o))s :isp)ay port)et-%hich you added to the co)u&# o# the right-c)ick the Co#figura(
tio# ico#. "t )ooks )ike a gear. +ou %i)) get a si&p)e drop do%# se)ectio# !o. %hich a))o%s you to choose a
Fuestio# fro& the <o))s port)et to !e disp)ayed i# the <o))s :isp)ay port)et. Choose your Fuestio# a#d c)ick
Save. $he# c)ick the 3eturn to ?ull Page )i#k.
+ou %i)) #o% see that your po)) Fuestio# is !ei#g disp)ayed i# the <o))s :isp)ay port)et. $his a))o%s
your users to vote o# the Fuestio#, a#d it keeps track of a)) the votes. 6#ce a user has voted, it does #ot a)(
)o% that user to vote agai#.
+ou shou)d #o% have a page that )ooks so&ethi#g )ike this,
20 <o))s <ort)ets
Illustration 12: "he Polls portlet.
?ui)di#g +our "#tra#et
Blogs and Blogs Aggregation
5otice that there is a)so #othi#g i# the Rece#t ?)oggers port)et. $hat is !ecause you have #o users
%ho are !)oggers yet. Si#ce you are the o#)y user i# the syste&, if you create a !)og for yourse)f o# your
perso#a) pu!)ic page, it ca# sho% up i# the Rece#t ?)oggers port)et.
Go up to the :ock a#d se)ect -y Pla(es ,7 -y #ommunity ,7 Private Pages. C)ick o# your !dmin page
you created ear)ier. C)ick the 0sers ta! i# the 4#terprise 'd&i# port)et. C)ick the !(tions !utto# #e.t to your
user #a&e a#d se)ect the -anage Pages )i#k. +ou %i)) !e !rought to the 8a#age <ages scree# you used ear)i(
er to create pages i# the Guest co&&u#ity, !ut this ti&e you are )ooki#g at your o%#, perso#a) pu!)ic
pages. '#d as you ca# see fro& the hierarchy o# the )eft, you have #o pages. So go ahead a#d create a page
ca))ed ;ome. C)ick the =iew Pages !utto#.
+ou %i)) see that you #o% have a !)a#k page. Go up to the :ock a#d c)ick !dd !ppli(ation. 3ro& the
Co))a!oratio# category, add the ?)ogs port)et to the right co)u&# o# your page a#d c)ose the !dd !ppli(ation
%i#do%.
@he# there are #o !)og e#tries i# the ?)ogs port)et, it co#tai#s o#)y o#e !utto#, !dd .log )ntry.
C)ick this !utto# a#d add a !)og e#try. +ou %i)) see that it uses the sa&e @+S"@+G editor that the Jour#a)
port)ets use. +ou ca# use this to add te.t a#d i&ages to your !)og e#tries. @he# you are fi#ished %ith your
!)og e#try, c)ick Save.
"f you %ish, you ca# add other port)ets to the )eft ha#d co)u&# or cha#ge the )ayout to a o#e co)(
u&# )ayout to &ake the page )ook a !it !etter. "# a#y case, you shou)d have a !)ogs port)et that )ooks so&e(
thi#g )ike this,
?)ogs a#d ?)ogs 'ggregatio# 29
Illustration 1': #ommunity page with your poll Buestion displayed.
?ui)di#g +our "#tra#et
5o% use the :ock to #avigate !ack to the Guest co&&u#ity, %here your "#tra#et pages are. $o do
this, se)ect -y Pla(es ,7 6uest ,7 Publi( Pages. $he# c)ick the Co&&u#ity )i#k. +ou %i)) #o% see that you have
a !)og e#try )isted i# the Rece#t ?)oggers port)et. <eop)e ca# c)ick the )i#k to go direct)y to your !)og a#d
vie% the e#tries. ?y defau)t, the Rece#t ?)oggers port)et %i)) sho% every !)og i# the porta). +ou ca# use the
Co#figuratio# ico# to &odify it so it disp)ays o#)y !)ogs fro& users of a particu)ar orga#izatio#. 3or #o%, %e
%i)) )eave it a)o#e.
@e have desig#ed this page so that as users !egi# usi#g the porta), creati#g !)og e#tries, a#d co&(
&e#ti#g o# the page, the port)ets %i)) gro% do%# to%ard the !otto& of the page as the co#te#t %ithi#
the& cha#ges. $his is ge#era))y a good practice, as you %a#t to &ake sure that a)) of the co#te#t types
avai)a!)e to your users are a!ove %hat is ca))ed the fold of the page. +ou do#Gt %a#t to hide a#y co#te#t at
the !otto&, !ecause users &ight &iss it e#tire)y. "f, ho%ever, your users ca# see that IRece#t ?)oggersJ or
I<age Co&&e#tsJ co#ti#ue do%# the page, they &ay decide that they %a#t to scro)) do%# to vie% that co#(
te#t, si#ce it is o!vious that it is there. $his is a good page desig#.
't this poi#t, you shou)d have a Co&&u#ity page that )ooks so&ethi#g )ike this,
22 ?)ogs a#d ?)ogs 'ggregatio#
Illustration 11: "he Liferay .logs portlet with a single blog entry.
?ui)di#g +our "#tra#et
Breadcrumbs and Message Boards
LetGs #o% give your users a# area %here they ca# discuss particu)ar topics of i#terest to the&. Go
up to the :ock a#d c)ick -anage Pages. C)ick the #hildren ta!. +ou are goi#g to create a chi)d page u#der the
Co&&u#ity page ca))ed si&p)y, 3oru&s. So #a&e the page ?orums a#d c)ick the !dd Page !utto#. +ou %i))
see that there is #o% a# arro% #e.t to the Co&&u#ity page i# the hierarchy o# the )eft. $his i#dicates that
there is at )east o#e other page u#der#eath Co&&u#ity. C)ick the arro%, a#d the hierarchy %i)) e.pa#d.
C)ick the 3eturn to ?ull Page )i#k i# the top right cor#er of the port)et %i#do%. 5otice that the 5avi(
gatio# port)et #o% has a )i#k to your #e%)y created 3oru&s page, a#d that there is #o )i#k to that page i#
the #avigatio# that ru#s across the top of the scree#. 8ost Liferay the&es do#Gt have drop(do%# &e#us
that ca# disp)ay the fu)) page hierarchy, so you #eed to provide your o%# #avigatio# to the& !y usi#g a
5avigatio# or a ?readcru&! port)et. 6f course, you ca# a)%ays !ui)d your o%# the&e %hich i#c)udes this
fu#ctio#a)ity if you #eed it. @e %i)) )ook at the&es a )itt)e )ater i# this docu&e#t.
C)ick o# the 3oru&s )i#k i# the 5avigatio# port)et, a#d you %i)) !e take# to your #e%, !)a#k 3o(
ru&s page. Go up to the :ock, c)ick Layout "emplate, choose the 1 #olumn )ayout, a#d c)ick Save. Go !ack up
to the :ock a#d c)ick !dd !ppli(ation. 6pe# the #-S category a#d c)ick the !dd !utto# #e.t to the ?read(
cru&! port)et. 6pe# the #ollaboration category a#d c)ick the !dd )i#k #e.t to the 8essage ?oards port)et.
C)ose the !dd !ppli(ation %i#do%.
+ou ca# see that the ?readcru&! port)et sho%s you a trai) of the )ocatio#s to %hich you have #avi(
gated i# the page hierarchy. $he first thi#g %e %i)) do is re&ove the port)et !orders fro& this port)et so
that it )ooks &ore #atura) o# the page.
C)ick the Loo/ and ?eel ico# i# the top right cor#er of the ?readcru&! port)et %i#do%. "t )ooks )ike a
pai#terGs pa)ette. ' %i#do% %i)) pop up a))o%i#g you to cha#ge a)) ki#ds of )ook a#d fee) setti#gs for this
port)et. ')) %e %a#t to do is re&ove the !orders, so u#check the Show .orders check !o. a#d c)ick Save.
C)ose the %i#do% !y c)icki#g o# the red R i# the upper right cor#er. 5o% use your !ro%serGs 3efresh !utto#
to refresh the page. $he port)et !o. is #o% go#eE *sers %ho are #ot ad&i#istrators %i)) #ot see the co#figu(
ratio# )i#ks a!ove the port)etN for a)) i#te#ts a#d purposes, the port)et co#te#t is #o% e&!edded i# the
page.
?readcru&!s a#d 8essage ?oards 22
Illustration 12: #ontinuing with the #ommunity page.
?ui)di#g +our "#tra#et
5o% )etGs co#figure the &essage !oards. +ou have pro!a!)y see# &essage !oards a)) over the "#ter(
#et, a#d these are rea))y #o differe#t. C)ick the !dd #ategory !utto# to add a discussio# category. ' good o#e
to start %ith is 6eneral Dis(ussion. 6#ce youGve added the #a&e a#d descriptio#, c)ick Save.
LiferayGs &essage !oards a))o% users to su!scri!e to &essage topics. "f they do this, they %i)) re(
ceive a# e&ai) %he#ever so&e!ody rep)ies to a topic to %hich they are su!scri!ed. $hese e&ai)s !y defau)t
co&e fro& IJoe ?)oggsJ %ho has the e&ai) address testCliferay.(om. $his is pro!a!)y #ot %hat you %a#t.
C)ick the #onfiguration ico# /)ooks )ike a gear0 i# the top right cor#er of the port)et %i#do%. Set the
#a&e a#d e&ai) address to so&ethi#g thatGs appropriate, such as
*ame# <orta) 'd&i#
Address# ad&i#Q&yco&pa#y.co&
C)ick Save. 's you ca# see, you ca# custo&ize the &essages o# other ta!s of this scree#. @e %o#Gt
!e doi#g this here, !ut fee) free to e.p)ore this sectio# )ater. +ou ca# a)so custo&ize the user Ira#ks,J
%hich are %hi&sica) )a!e)s p)aced o# users %ho post certai# a&ou#ts of &essages to the !oards. $he de(
fau)t ra#ks go fro& +ou#g)i#g /zero to 2U posts0 a)) the %ay up to +oda /9000 or &ore posts0. +ou ca# &odi (
fy the ra#k #a&es a#d the post a&ou#ts to a#ythi#g you %a#t.
$here are other setti#gs, !ut %eGre #ot goi#g to cha#ge a#y other setti#gs right #o%. C)ick the 3e,
turn to ?ull Page )i#k to get !ack to the foru&s. "f you %ish, you ca# create &ore &essage categories. @he#
fi#ished, go i#to the Ge#era) :iscussio# category %e created ear)ier. 5otice that you ca# add !oth su!cate(
gories a#d threads. +ou ca# #est categories as deep as you )ike. 3or #o%, %eGre Hust goi#g to post a thread to
the !oards. C)ick the Post >ew "hread !utto#.
+ou %i)) see a for& that a))o%s you to post a &essage to the &essage !oard. $here is a# editor
%hich has a sy#ta. si&i)ar to those youGd fi#d o# other &essage !oards. Go ahead a#d post a &essage.
@he# you are fi#ished %riti#g your &essage, c)ick Save.
+ou shou)d #o% see your &essage. "t shou)d )ook so&ethi#g )ike this,
News and RSS eeds
@hat "#tra#et %ou)d !e co&p)ete %ithout i#dustry #e%s feeds co))ecti#g #e%s a!out a)) of your
co&petitors fro& a)) over the "#ter#etT LetGs create that page #e.t.
Go up to the :ock a#d c)ick -anage Pages. @eGre goi#g to create a top()eve) page, so c)ick the 6uest
)i#k at the top of the hierarchy o# the )eft. Give your #e% page the #a&e >ews a#d c)ick the !dd Page !ut(
to#. C)ick the 3eturn to ?ull Page )i#k a#d the# c)ick the )i#k to your #e% page i# the top )eve) #avigatio#. *s(
2U 5e%s a#d RSS 3eeds
Illustration 15: -essage boards post.
?ui)di#g +our "#tra#et
i#g the :ock, c)ick Layout "emplate a#d pick the 2 #olumns 2%&2% )ayout.
Go !ack up to the :ock a#d se)ect !dd !ppli(ation. 3ro& the >ews category, add the 5e%s port)et to
the )eft co)u&# a#d the RSS <ort)et to the right co)u&#. 5otice that !oth of these port)ets are instan(eable
port)ets. $his &ea#s you ca# add as &a#y of the& as you )ike to a#y page a#d ca# co#figure each i#sta#ce
to ho)d differe#t data.
@he# the port)ets appear, you ca# see that they a)ready have #e%s i# the&. $hey are co#figured
!y defau)t to co##ect to certai# feeds. 6f course, you ca# co&p)ete)y custo&ize this.
"# the 5e%s port)et, c)ick the Preferen(es ico#, %hich )ooks )ike a pe#ci) a#d paper. Dere you ca# se(
)ect fro& &u)tip)e categories of #e%s feeds to disp)ay i# the port)et. ?y defau)t, Society (V "#ter#atio#a) Re(
)atio#s a#d $op Stories (V $op Stories are se)ected. @eGre )ooki#g for so&e specific #e%s )i#ks, so )etGs &ake
so&e assu&ptio#s.
+our !usi#ess does so&e outsourci#g, so you are i#terested i# #e%s o# outsourci#g. C)ick .usiness:
general, a#d the# se)ect 6utsourci#g 5e%s. C)ick Save a#d the# c)ick .a(/. ?ecause of your i#dustry, you
co&pete %ith severa) co&pa#ies. C)ick #ompanies, a#d the# check off so&e co&pa#ies a#d c)ick Save a#d
the# c)ick .a(/.
+ou get the idea. @e cou)d se)ect &ore #e%s feeds fro& &ore categories, a#d you ca# certai#)y do
that )ater if you %a#t. 3or #o%, c)ick the 3eturn to ?ull Page )i#k. +ou %i)) see that #e%s artic)es fro& a)) the
categories you se)ected are #o% !ei#g disp)ayed.
$he RSS port)et is a !it &ore free(for&. "t a))o%s you to add a#y feed you ca# fi#d o# the "#ter#et
to your porta). "s there a feed you )ikeT "f so, go fi#d it a#d copy the *RL to your c)ip!oard. "f #ot, hereGs a
ha#dy feed for you to use,
http,11%%%.)iferay.co&1%e!1guest1ho&e1Hour#a)1rss19U1#e%s
C)ick the #onfiguration ico# /)ooks )ike a gear0. +ou ca# see that three feeds are a)ready co#figured
i# the port)et. "f you )ike the&, you ca# )eave the& there. "f #ot, you ca# c)ick the 3emove ico# #e.t to the
feed to re&ove it. "# either case, you %i)) #eed to c)ick the !dd ?eed ico# to add a#other feed to the )ist.
<aste your feed i#to the *RL fie)d, a#d optio#a))y give it a tit)e. Se)ect the #u&!er of e#tries you %a#t to
disp)ay a#d c)ick Save.
+ou shou)d #o% have a page that )ooks so&ethi#g )ike this,
5e%s a#d RSS 3eeds 27
?ui)di#g +our "#tra#et
Pro!ects and "i#is
4very "#tra#et shou)d have a co))a!oratio# area %here users ca# go to %ork o# their docu&e#ts
a#d share data pertai#i#g to the&. 8a#y porta)s use o#)i#e :ocu&e#t Li!raries a#d discussio# foru&s for
these, a#d Liferay has this fu#ctio#a)ity as %e)). ?ut pro!a!)y the &ost idea) too) for this sort of thi#g is a
@iki. So )etGs set up a <roHects page for users to co))a!orate o# their proHects.
C)ick the !dd Page )i#k i# your top )eve) #avigatio# a#d give the page the #a&e ProDe(ts. C)ick o#
your #e% page. Go to the :ock a#d pick Layout "emplate. Choose the 1 #olumn )ayout a#d c)ick Save. 5o% go
to the :ock agai# a#d c)ick o# !dd !ppli(ation. 'dd the @iki port)et fro& the Wi/i category.
LiferayGs %iki is a fu))(f)edged, po%erfu) %iki app)icatio# that supports every %iki feature you cou)d
%a#t,
3)e.i!)e @iki sy#ta. /Creo)e for&at0
"&ages fro& the "#ter#et or attached to the page
8u)tip)e %ikis i# the sa&e co&&u#ity
Distory
'ttach&e#ts of fi)es
2B <roHects a#d @ikis
Illustration 1$: Eour news feeds.
?ui)di#g +our "#tra#et
<ri#t <revie%
<age &ovi#g /%ithout !reaki#g e.isti#g )i#ks to the page0
:iff of page versio#s
4&ai) su!scriptio#s to cha#ges
$a!)e of Co#te#ts
6pti&istic Locki#g /#otificatio# that so&e!ody e)se is editi#g the sa&e page0
Chi)d pages
$ag !ased #avigatio#
'#d yes, there is &ore. @e %o#Gt have ti&e to e.p)ore &a#y of these features here, !ut suffice it to
say that LiferayGs %iki %i)) !e sufficie#t to the task /a#d )ike)y %i)) e.ceed the #u&!er of features #ecessary0
for &a#agi#g your co&pa#yGs %iki.
LetGs edit the &ai# page first a#d add so&e i#troductory te.t. $hereGs a )i#k that says I$his page is
e&pty. 4dit to add so&e te.t.J Go ahead a#d c)ick that )i#k.
+ou are !rought to a page %hich a))o%s you to e#ter te.t, either i# @iki sy#ta. or via the @+S"(
@+G D$8L editor youGve used previous)y. LetGs use the @iki editor.
4#teri#g te.t i#to a @iki is do#e via %iki sy#ta.. LiferayGs %iki uses the Creo)e sy#ta., %hich is a
co&&o# %iki sy#ta. that has !ee# desig#ed to !e a sta#dard for %ikis goi#g for%ard. ?ecause &a#y %iki
&arkup e#gi#es have i# the past had s)ight)y differe#t sy#ta., this is a# effort to sta#dardize the&. $here is
a cheat sheet for the sy#ta. to the right of the %iki editor.
4#ter so&e te.t i#to the editor. DereGs so&e e.a&p)e te.t,
== Projects ==
Welcome to the projects page! Here you can get an overview of the projects being worked on
internally and optionally gain access to contribute to them. Ask your project manager for
further details.
@he# you are fi#ished, c)ick the Save !utto#. +ou %i)) #otice that your te.t has #o% !ee# for&at(
ted proper)y via the %iki sy#ta.. $here is a)so a )i#k !e)o% the page stati#g there are 0 attach&e#ts. LetGs
add a# attach&e#t to the artic)e !y c)icki#g that )i#k.
+ou %i)) !e !rought to a#other page %hich ho)ds &eta data a!out the page. 6#e of the ta!s o# that
page is )a!e)ed 'ttach&e#ts. C)ick the !dd !tta(hments !utto# a#d attach a docu&e#t fro& your &achi#e to
the page. *se the &u)tip)e fi)e up)oader /reFuires 3)ash0 or the c)assic up)oader to up)oad a docu&e#t.
?efore %e )eave this sectio# of the page, c)ick o# the 6eneral ta!. 5otice that you ca# provide RSS
feeds to your @iki co#te#t fro& here. $his a))o%s you to pu!)ish %iki co#te#t to other areas of your porta)
or to other %e! sites. $here is a)so a per&issio#s )i#k here %hich a))o%s you to per&issio# this %iki page
Hust )ike a#y other asset i# the porta).
$he ;istory ta! %i)) )et you see a)) the revisio#s of the page, co&pare !et%ee# those revisio#s, a#d
eve# revert to a previous revisio# of the page if you %ish to.
$hereGs &ore to e.p)ore here, !ut for #o%, c)ick the !ack ico# #e.t to the tit)e of the page /3ro#t(
<age0. +ouG)) !e take# !ack to the fro#t page of the %iki, a#d #o% it %i)) !e sayi#g thereGs o#e attach&e#t.
$hereGs a s&a)) ico# at the top right cor#er. "f you ro)) your &ouse over it, a )a!e) pops up, -anage
Wi/is. Go ahead a#d c)ick it. $his is %here you ca# create various %ikis for various proHects. Right #o%,
<roHects a#d @ikis 2=
?ui)di#g +our "#tra#et
there is o#)y o#e, )a!e)ed -ain. $his is fi#e a#d ca# serve as a# i#troductio# to the page or as a Iro)) upJ
%iki that a proHect &a#ager &ight use to su&&arize the status of &a#y proHects. +ou have a)ready added a
page to this %iki.
LetGs create a #e% %iki for a#other proHect. C)ick the !dd Wi/i !utto#. Give your proHect a coo)
#a&e, )ike ProDe(t Idioglossia. C)ick Save. 5o% you %i)) see that there are t%o %ikis, the &ai# o#e a#d o#e for
your #e% proHect. +ou ca# add as &a#y as you %a#t. 5otice the !(tions !utto# #e.t to the %ikis. +ou ca#
use this !utto# to per&issio# the %ikis !y user group, orga#izatio#, co&&u#ity, or ro)e so that o#)y the
proHect tea& %orki#g o# that particu)ar proHect ca# update that %iki. 's you did !efore, you ca# go i# a#d
e.a&i#e the per&issio#s that are there !y defau)t to deter&i#e %hether they are appropriate. 3or #o%,
c)ick the .a(/ ta!.
5o% you ca# see that <roHect "diog)ossia has a )i#k up at the top of the port)et %i#do% a)o#g %ith
the &ai# %iki. $o get to that %iki, si&p)y c)ick o# the )i#k a#d !egi# addi#g pages a#d attach&e#ts.
@e have o#e &ore thi#g to do to this page. Si#ce thereGs o#)y o#e port)et o# this page, a#d it takes
up the %ho)e page, do#Gt you thi#k it %ou)d )ook !etter if %e re&oved the port)et %i#do% !ordersT C)ick
the Loo/ and ?eel ico# /the pai#terGs pa)ette0, u#check Show .orders a#d c)ick Save. C)ose the %i#do% a#d re(
fresh the page. +ou shou)d #o% have a page that )ooks so&ethi#g )ike this,
$rgani%ation Pages
+our porta) does #ot have to !e !ui)t so)e)y i# the Guest co&&u#ity. $here %i)) !e ti&es %he# cer(
tai# orga#izatio#s %ithi# your co&pa#y #eed their o%# space. "# this case, you ca# a))o% the& to create
pages for their o%# use.
4very co&pa#y has a &arketi#g orga#izatio# i# order to spread the %ord a!out the co&pa#yGs
products so they ca# !e so)d. So )etGs create a &arketi#g orga#izatio# for 8y Co&pa#y a#d a))o% the& to
create their o%# pages.
Go !ack to your perso#a) co&&u#ity via the :ock, -y Pla(es ,7 -y #ommunity ,7 Private Pages. Go to
your 'd&i# page. C)ick the *rgani+ations ta!. C)ick the !(tions !utto# #e.t to 8y Co&pa#y a#d the# c)ick
!dd Suborgani+ation. Ca)) it -y #ompany -ar/eting a#d give it a cou#try 1 regio#, a#d the# c)ick Save.
?ecause you created the orga#izatio#, you auto&atica))y !eco&e its o%#er. Do%ever, youGre #ot i#
&arketi#g, youGre a porta) ad&i#istrator. So you #eed to create a#d per&issio# a &arketi#g user %ho %i))
ad&i#ister the &arketi#g orga#izatio#. C)ick the !(tions !utto# #e.t to 8y Co&pa#y 8arketi#g a#d c)ick
2 6rga#izatio# <ages
Illustration 1<: "he proDe(t page with the wi/i portlet.
?ui)di#g +our "#tra#et
!dd 0ser /if the user a)ready e.isted i# the porta), you cou)d have c)icked !ssign -embers0. 'dd a user. 8ake
up his or her #a&e if you %a#t to. @he# fi#ished, c)ick Save. 's !efore, cha#ge the pass%ord so you ca# )og
i# as this user. C)ick the 3eturn to ?ull Page )i#k i# the top right of the port)et %i#do%.
5o% %e %a#t to &ake our &arketi#g user a# ad&i#istrator of the &arketi#g orga#izatio#. C)ick
the *rgani+ations ta! agai# a#d c)ick the !(tions !utto# #e.t to 8y Co&pa#y 8arketi#g. Se)ect !ssign 0ser
3oles. C)ick the *rgani+ation *wner ro)e. +ou %i)) see that you are i# this ro)e, !ecause you created the orga(
#izatio#. C)ick the !vailable ta!, a#d you shou)d see your #e% user i# the )ist. Check off the userGs #a&e a#d
c)ick the 0pdate !sso(iations !utto#. $he user you created is #o% a# o%#er of the &arketi#g orga#izatio# i#
the porta), %ith the a!i)ity to create users, pages, add port)ets, a#d &a#age per&issio#s o# resources i# the
orga#izatio#. C)ick the 3eturn to ?ull Page )i#k.
$he &arketi#g orga#izatio# ca# #o% have their o%# co&p)ete)y separate %e! site i# the porta).
$he i#terface for creati#g it is e.act)y the sa&e as %hat you have !ee# usi#g to create the site i# the Guest
co&&u#ity. "# the :ock, you #o% have access to the &arketi#g orga#izatio#Gs pages i# -y Pla(es. $here are
#o pages i# there yet, !ut %e ca# create o#e.
C)ick the *rgani+ations ta! i# the 4#terprise 'd&i# port)et. C)ick the !(tions !utto# #e.t to the 8y
Co&pa#y 8arketi#g orga#izatio# a#d the# c)ick -anage Pages. +ou ca# add !oth pu!)ic pages %hich every(
o#e ca# see /eve# Guests0 or private pages that o#)y &e&!ers of the 8y Co&pa#y 8arketi#g orga#izatio#
ca# see. Si#ce %e created this orga#izatio# !ecause the &arketi#g peop)e %a#ted their o%# space, that
pro!a!)y &ea#s they %a#t private pages. So %eG)) create a ho&e page for the& there a#d the# se#d the
user you Hust created a# e&ai) te))i#g her that she ca# #o% !egi# creati#g pages.
C)ick the Private Pages ta!. +ou %i)) !e at the #e% page i#terface auto&atica))y. Give the page the
#a&e ;ome a#d c)ick !dd Page. C)ick the =iew Pages )i#k i# the top )eft cor#er to go to the page. Go up to the
:ock, c)ick !dd !ppli(ation, a#d fro& the #-S category, add a Jour#a) Co#te#t port)et to the page. 'dd a# ar(
tic)e ca))ed -ar/eting ;ome a#d put so&e i#troductory te.t i#to it. @he# fi#ished, c)ick Save and !pprove.
's you ca# see, you ca# !ui)d porta)s for your e#tire orga#izatio#a) hierarchy i# Liferay. +ou ca#
a)so create co&&u#ities %hich cut across orga#izatio#a) hierarchies to provide services that a#yo#e ca#
access. '#d for those %ho %a#t a private sectio# of the site to do their %ork, you ca# create that too.
+ou ca# go a#d se#d that e&ai) #o%. +our &arketi#g perso# pro!a!)y %a#ts to get started.
T&emes
?ui)di#g out your i#tra#et has !ee# pretty easy, has#Gt itT ?ut thereGs o#e g)ari#g o&issio# i# %hat
%eGve !ee# !ui)di#g, a)) the pages )ook the sa&e, a#d they have the Liferay )ogo sitti#g i# the top )eft cor(
#er. +ou pro!a!)y %a#t the 8y Co&pa#y )ogo up there, a#d &ay!e a %ho)e differe#t )ook a#d fee).
:eve)opers ca# create #e% the&es for Liferay that co&p)ete)y cha#ge the %ay it )ooks. @ith a good
the&e, it ca# !e hard to te)) that your site is eve# ru##i#g Liferay. 3or #o%, though, you do#Gt have to %ait
for a deve)oper to create your the&e, you ca# gra! o#e of the o#es fro& LiferayGs repository o# the "#ter(
#et.
Go up to the :ock, a#d se)ect -y Pla(es ,7 -y #ommunity ,7 Private Pages. C)ick o# the 'd&i# page.
Go !ack to the :ock a#d c)ick !dd !ppli(ation. 3ro& the !dmin category, add the <)ugi# "#sta))er to the page
u#der the Co&&u#ities port)et i# the )eft co)u&#. $his port)et a))o%s you to do%#)oad a#d i#sta)) #e%
port)ets a#d the&es fro& LiferayGs i#ter#et repository. "# additio# to that, you ca# add other repositories
that you create i#ter#a))y or others create.
C)ick the "heme Plugins ta!. ?ro%se the the&es a#d %he# you fi#d o#e you )ike, c)ick o# it. +ou ca#
see a scree# shot of it a#d if you c)ick the scree# shot, you ca# see a )arger versio#. $o i#sta)) the the&e,
si&p)y c)ick the Install !utto#, the the&e %i)) !e auto&atica))y do%#)oaded a#d i#sta))ed.
$he&es 2>
?ui)di#g +our "#tra#et
+ou ca# app)y the&es to %ho)e co&&u#ities, i#dividua) pages, a#d everythi#g i# !et%ee#. ?efore
you app)y a the&e to the Guest co&&u#ity, you &ay %a#t to try it o# your perso#a) co&&u#ity first to
&ake sure that it )ooks )ike %hat you %a#t. Go up to the :ock a#d c)ick -anage Pages. C)ick the Loo/ and ?eel
ta!. +ou shou)d see the the&e or the&es you i#sta))ed i# the )ist. Choose it a#d the page %i)) auto&atica))y
refresh %ith the #e% the&e.
Look to the )eft, %here the page hierarchy is. +ou ca# see that the !dmin page is se)ected. +ou have
Hust app)ied the the&e to the 'd&i# page i# your perso#a) co&&u#ity. "f you %ere to #avigate to the ;ome
page, it %ou)d sti)) have the o)d the&e. $o app)y the the&e to the %ho)e co&&u#ity, c)ick the co&&u#ity
#a&e at the top of the hierarchy-%hich i# this case is your #a&e. C)ick the Loo/ and ?eel ta! agai#, a#d se(
)ect the the&e. 5o% it is app)ied to every page i# your co&&u#ity.
5o% %eGve take# care of the )ook a#d fee), !ut %hat a!out that pesky Liferay )ogoT @e %a#t to re(
p)ace it %ith the )ogo of our co&pa#y. $his ca# !e do#e i# severa) p)aces.
"f you %a#t to rep)ace it for the e#tire porta), c)ick the arro% ta! i# the 4#terprise 'd&i# port)et.
C)ick the Settings ta!. +ou ca# see #o% %here the Liferay )ogo is set. C)ick the #hange )i#k u#der#eath it.
C)ick the .rowse !utto# a#d fi#d the )ogo you %a#t to use o# your &achi#e. C)ick *F a#d the# c)ick Save.
$he )ogo %i)) cha#ge to your co&pa#y )ogo across the porta).
"f you %a#t to rep)ace the )ogo Hust for a particu)ar co&&u#ity or orga#izatio#, you ca# do that
too. C)ick the 3eturn to ?ull Page )i#k a#d the# c)ick the !ll #ommunities ta! i# the Co&&u#ities port)et. C)ick
the !(tions !utto# #e.t to the Guest co&&u#ity a#d the# c)ick -anage Pages. C)ick the Settings ta! a#d the#
c)ick the Logo ta!. +ou ca# !ro%se for a )ogo that %i)) !e disp)ayed Hust for this co&&u#ity.
Go ahead a#d cha#ge the the&e for the Guest co&&u#ity to o#e of the the&es that you do%#)oad(
ed. +ou ca# do this !y accessi#g the -anage Pages i#terface through the Co&&u#ities port)et. "f youGre a)(
ready there, c)ick the .a(/ ta! fro& the )ogo page. C)ick the #a&e of the co&&u#ity /Guest0 %hich is at the
top of the hierarchy. $he# c)ick the Loo/ and ?eel ta! a#d se)ect your the&e. $o see your #e% "#tra#et page
%ith the the&e app)ied, access it via the :ock, -y Pla(es ,7 6uest ,7 Publi( Pages.
+ou &ay %a#t to custo&ize the tit)es of your port)ets #o% /%hich you ca# do !y c)icki#g o# the&0,
or re&ove the port)et %i#do%s a)together. 8odify the page as you see fit. @he# you are fi#ished, you
shou)d have so&ethi#g that )ooks )ike this,
20 $he&es
?ui)di#g +our "#tra#et
+ou are do#eE
@e hope you have e#Hoyed creati#g a# "#tra#et fro& scratch usi#g LiferayE
$he&es 29
Illustration 1@: "he final home page of your Intranet. "his theme is (alled Dreamy.