Roller User Guide

8/10/2019 Roller User Guide

1/54

User Guide

Apache Roller Weblogger

Version 5.0.2August 2013

1


2/54

Table of Contents

Table of Contents 1 Overview............................................................................................................................................................. 4

1.1 Copyright and trademark information..........................................................................................................4 1.2 Feedback...................................................................................................................................................... 4 1.3 Acknowledgments........................................................................................................................................ 4 1.4 Modifications and Updates.......................................................................................................................... 4

2 Introduction........................................................................................................................................................5 3 Getting started with Roller............................................................................................................................... 6

3.1 etting started with a new !oller installation.............................................................................................." 3.2 Creating a new #ser and weblog ................................................................................................................. $ 3.3 etting aro#nd in !oller...............................................................................................................................%

4 Creating and editing your weblog.................................................................................................................. 1 4.1 Creating and editing a weblog entry...........................................................................................................11

4.1.1 &eblog editor fields............................................................................................................................12 4.1.2 &eblog editor b#ttons.........................................................................................................................12

4.1.3 &eblog editor pl#gin settings............................................................................................................. 13 4.1.4 &eblog editor ad'anced settings........................................................................................................ 13 4.2 Finding and editing weblog entries............................................................................................................ 14 4.3 Managing categories.................................................................................................................................. 1( 4.4 Managing yo#r weblog)s blogroll...............................................................................................................1" 4.( Uploading images and other files to yo#r weblog .................................................................................... 1$

4.(.1 *ow to #pload files............................................................................................................................ 1+ 4.(.2 *ow to edit and #pdate files...............................................................................................................2, 4.(.3 *ow to #se Media File -irectories.....................................................................................................21 4.(.4 *ow to delete Media Files..................................................................................................................21 4.(.( *ow to delete Media File -irectories................................................................................................ 21 4.(." *ow to post images to yo#r weblog................................................................................................... 21 4.(.$ *ow to post a podcast to yo#r weblog............................................................................................... 21

4." odcasting with !oller............................................................................................................................... 22 4.".1 *ow to create a podcast feed with !oller ..........................................................................................22

4.$ Using a weblog client with !oller..............................................................................................................23 5 !or"ing with co##ents and trac"bac"s...................................................................................................... 24

(.1 Comment notification 'ia email.................................................................................................................24 (.2 Comment management...............................................................................................................................24 (.3 Comment moderation.................................................................................................................................2( (.4 lobal comment management....................................................................................................................2( (.( re'enting weblog spam ........................................................................................................................... 2" (." /ending trackbacks.....................................................................................................................................2$

6 Choosing your weblog the#e ......................................................................................................................... 2$ % &anaging your weblog 're(erences................................................................................................................ 2) $.1 &eblog settings.......................................................................................................................................... 2%

$.1.1 eneral settings ................................................................................................................................. 2% $.1.2 0nternationali ation /ettings...............................................................................................................3, $.1.3 Comments and defa#lt comment settings...........................................................................................3, $.1.4 &eblog client A 0 ..............................................................................................................................31 $.1.( Formatting ......................................................................................................................................... 31 $.1." /pam pre'ention ................................................................................................................................32

2


3/54

$.2 &eblog members managing a gro#p blog.................................................................................................33 $ *sing weblog 'ings...........................................................................................................................................35

+.1 !egistering with an Aggregator................................................................................................................. 3( +.2 ing argets Common and C#stom...........................................................................................................3( +.3 /etting #p A#tomated ings....................................................................................................................... 3( +.4 /ending a Man#al ing.............................................................................................................................. 3$ +.( Creating and 5diting C#stom ing argets................................................................................................ 3$ +." More on !egistering with an Aggregator...................................................................................................3%

) Roller ad#inistration.......................................................................................................................................4 %.1 Managing #sers.......................................................................................................................................... 4, %.2 Config#ring !oller..................................................................................................................................... 42

1 !eblog u'date 'ing ad#inistration............................................................................................................. 45 1,.1 Creating and editing common ping targets.............................................................................................. 4( 1,.2 *ow !oller rocesses &eblog Update ings...........................................................................................4( 1,.3 Config#ration roperties Controlling ing rocessing............................................................................ 4" 1,.4 /#spending all ping processing................................................................................................................4" 1,.( Controlling and disabling ping #sage.......................................................................................................4" 1,." 0nitiali ation of common ping targets...................................................................................................... 4$

11 !eblog +,'ort................................................................................................................................................4$ 12 -lanet Roller ad#inistration ........................................................................................................................4)

12.1 Config#ring lanet !oller........................................................................................................................ 4% 12.2 Adding e6ternal weblogs to lanet !oller................................................................................................(1 12.3 Adding c#stom gro#ps to lanet !oller................................................................................................... (2

13 'ache /o(tware 0icense ersion 2. .......................................................................................................... 53

3


4/54

1 Overview his doc#ment is a #ser g#ide to the Apache !oller &eblogger the 7a'a8based and open so#rce weblog ser'er

that is prod#ced by the Apache !oller pro9ect of the Apache /oftware Fo#ndation.here are separate g#ides a'ailable on other topics: an emplate #ide for those who wish to c#stomi e the

layo#t and design of their weblog pages and an 0nstallation #ide for those installing the !oller software on aweb ser'er.

1.1 Copyright and trademark information he contents of this doc#ment are s#b9ect to the terms of the Apache /oftware ;icense.

All trademarks within this doc#ment belong to legitimate owners.

1.2 Feedback lease direct any comments or s#ggestions abo#t this doc#ment to de'11>,$ !ewrites and #pdates for !oller 4., -a'e 7ohnson

,$>,(>,$ ?ew format>layo#t -a'e 7ohnson,$>31>,$ !oller 4., #pdates from ;inda /krocki

12>23>,+ ?otes on how email addresses are #sed

4


5/54

2 Introduction his #ser g#ide describes how to #se the Apache !oller &eblogger or !oller for short a web application that

can s#pport a single #ser weblog tho#sands of weblogs and>or gro#p weblogs.@o#)ll learn how to register as a new #ser. @o#)ll learn how to create one or more weblogs for yo#rself or agro#p of yo#r friends. @o#)ll learn how to create edit and post weblog entries. &e will also co'er moread'anced topics s#ch as ad9#sting yo#r weblog)s settings how to c#stomi e yo#r blogroller how to manageweblog pings and more.First let)s get some terminology o#t of the way beca#se there)s a lot of 9argon in weblogging. *ere)s a list ofsome of the terms we #se in this man#al witho#t a whole lot of backgro#nd.

!eblog A set of web pages and !//>Atom feeds that display weblog entries written by one or morea#thors #ploaded images bookmarks and comments posted by 'isitors. &eblog entries are displayedon the main page of the weblog and in the weblog)s feeds in re'erse chronological order.

!eblog entry . A single weblog entry with a title p#blication timestamp s#mmary content and somesettings that indicate if and when comments are allowed.

Co##ent . A comment posted by a 'isitor to a weblog and regarding one specific weblog post. Acomment has an email address a p#blication timestamp and some content.

rac"bac" . A comment posted by a remote weblog regarding one specific weblog post. rackbacks arestored as comments by !oller.

e#'lates . 5ach !oller weblog is defined by a set of * M; and C// templates that pro'ide the layo#tand styles for the weblog. ?ormally templates are a#thored #sing elocity template lang#age b#t otherlang#ages are possible 'ia pl#gins Bi.e. roo'y /er'er ages 7!#by etc.

eed . A feed is an DM; representation of the most recent entries comments or other data. Folks cans#bscribe to yo#r feed to be alerted of new weblog entries and comments posted. !oller s#pports both!// and Atom formats for feeds.

eed reader . /oftware that makes it easy to s#bscribe to and read feeds e.g. oogle !eader ?et ?ews&ire Feed -emon etc.

log client . /oftware that makes it easy to post to yo#r weblog e.g. 5cto and Mars 5dit.

&ith that o#t of the way let)s get started blogging with !oller.

(


6/54

3 Getting started with Roller etting started with !oller means different things to different people. 0f yo# are #sing an e6isting !oller ser'er

then getting started means registering a new #ser and creating or 9oining a weblog. 0f that)s the case for yo# skipahead to section 3.2. 0f yo# 9#st finished setting #p yo#r own !oller installation on yo#r own web ser'er thengetting started means a little bit more. @o#)'e got a little post installation work to do.

3.1 Getting started with a new Roller installation =nce yo#)'e got !oller #p and r#nning yo# will see a screen like the one below which e6plains e6actly whatyo#)'e got to do to get started with !oller. First create a new #ser so yo# can login. /econd login and create aweblog for yo#rself or one to ser'er as the front page of the site or both. hird designate which weblog is thefront page weblog.

Creating the (irst user. @o#r first step is to create a new #ser. !emember the first #ser yo# create will be gi'enadministrati'e pri'ileges. @o# might want to #se the #sername EadminE or something similar. ;ater yo# canlogin as the admin #ser when yo# need to change site8wide settings. 0f yo# wish yo# can grant other #sersadmin pri'ileges so they can help o#t with admin d#ties. ;et)s take a look at the #ser registration page. @o# cansee the new #ser registration form in the ne6t section.

Create the (irst weblog s7. ?e6t yo# sho#ld create at least one weblog. /ee section 3.2 below for some moreinformation the create weblog page. 0f yo# are r#nning a personal blog site then yo# might want yo#r weblog toser'e as the front page of yo#r site. 0n that case create a weblog #se a normal weblog theme Bi.e. not the !oller*omepage theme and assign yo#r weblog as the front page weblog of the site.

"

Illustration 1: Welcome to Roller


7/54

0f yo# are r#nning a comm#nity weblog site with m#ltiple weblogs then yo# will probably want to create aweblog to ser'e as the front page of the site. Create a new weblog name it EmainE or Ecomm#nityE orsomething s#itable beca#se its name will appear in U!;s. And we recommend that yo# #se the !oller*omepage theme beca#se it is specially designed to ser'e as a weblog comm#nity front page aggregating all ofthe site)s weblogs together b#t ha'ing no content of its own.

8esignate a (ront 'age weblog. =nce yo#)'e created a front page weblog whether it be a personal weblog or acomm#nity aggregator yo# need to tell !oller. /o select yo#r front page weblog and if yo# are r#nning acomm#nity site then set the Enable aggregated site-wide frontpage checkbo6 before yo# click /a'e.0f yo#)'e read this far yo#)'e probably created yo#r own #ser and weblog and if so yo# can skip the ne6tsection.

3.2 Creating a new user and weblogo create a new #ser #se the !egister link which can be fo#nd in the top right of the !oller login page. hat

link will take yo# to the ?ew User !egistration page shown below.

$

Illustration 2: New User Registration page


8/54

he ?ew User !egistration form is pretty self8e6planatory b#t keep in mind that yo#r #sername cannot bechanged: it is yo#r #ni #e identifier in the system. G#t that)s =H beca#se yo#r screen name is the name thatwill be displayed on yo#r weblog and in yo#r feeds and yo# can change it later if yo# wish.

-ic"ing your language and ti#e9one. @o# can set yo#r lang#age of choice and time one too b#t these 'al#esdon)t do m#ch in !oller. he locale and time one of yo#r weblog are really what matter. he 'al#es yo# set herewill be #sed as yo#r defa#lts when yo# create yo#r weblog.

Creating a weblog . =nce yo#)'e created a #ser then log in and yo#)ll see the !oller Main Men# page and agreeting that reads

You' e got a user account! but no weblog" Would #ou li$e to create one %Follow that link to create yo#r first weblog. @o#)ll see the form below.

he form is designed to be self8e6planatory. ?ote that yo# can change e'erything later e6cept for the webloghandle which is the #ni #e identifier for yo#r weblog.

?ow that yo#)'e got a #ser and a weblog let)s disc#ss how to get aro#nd in the !oller interface.

+

Illustration &: reate Weblog page


9/54

3.3 Getting around in Roller =nce yo#)'e logged into !oller)s editor pages yo# sho#ld be able to find yo#r way aro#nd #sing !oller)s tabbedmen#. o pro'ide a little e6tra assistance !oller displays a stat#s bar at the top of each editor page.For e6ample the stat#s bar below indicates that yo# are logged in as #ser )admin) and yo# are not editing aweblog. @o# can go directly to the front page of the site by clicking the first link on the right Bit might not belabelled Front age on yo#r site to the main men# with the second link and yo# can log o#t entirely by #singthe ;ogo#t.

For e6ample the stat#s bar below indicates that yo# are logged in as #ser )admin) and yo# are editing a weblogwith the handle )adminblog).

0f yo# are not logged into !oller then yo# can either access the login link directly or #se a ;ogin link from oneof the weblogs on the site. he login link is of this form

http >>hostname>roller8#i>login8redirect.rol=r this form if !oller is installed #nder its own conte6t

http >>hostname>roller>roller8#i>login8redirect.rol@o# probably won)t need to c#t8and8paste that link beca#se most weblogs display an a#thor men# like so

?ow that we)'e co'ered the basics of registering a new #ser creating a new weblog and finding yo#r wayaro#nd let)s start blogging.

%

Illustration (: )tatus bar wit*in weblog

Illustration +: )tatus bar! no weblog

Illustration ,: Weblog na igation bar


10/54

4 Creating and editing your weblog First yo# log in to !oller. &hat happens ne6t depends on the n#mber of weblogs that yo# ha'e. 0f yo# ha'e oneweblog yo#)ll be taken directly to the :ew +ntry page for that weblog.0f yo# ha'e more than one weblog or none at all then yo#)ll be taken to the &ain &enu page shown below soyo# can pick which weblog to edit and>or create new weblogs.

he main men# page lists all of yo#r weblogs and for each shows yo# links to its ?ew 5ntry 5ntriesComments heme and /ettings pages. @o# can also create a new weblog edit yo#r #ser profile.0f yo# are logged in as a lobal Administrator yo# will also see a /er'er Admin link in the actions side8bar.And if yo# ha'e !oller)s lanet aggregator enabled then yo# will also see a lanet Admin link there as well.

1,

Illustration : .ain menu


11/54

4.1 Creating and editing a weblog entry Use the Create ; +dit


12/54

4.1.1 Weblog editor fields;et)s disc#ss each of the fields on the ?ew 5ntry page so yo# know how to #se them.

itle I 5ach weblog entry m#st ha'e a title. Ge caref#l when yo# pick yo#r title it will be #sed in thelink to yo#r weblog entry. For best res#lts do #se titles that are short and to8the8point. 3on't incl#de any* M; in yo#r titles 9#st plain te6t I if yo# want yo#r titles to be bold then c#stomi e yo#r templates

instead of embedding * M; in yo#r titles. /tatus I his read8only field tells yo# abo#t the c#rrent state of the weblog entry that yo# are editing.

here are three possible stat#s settings Not )a ed I the entry has ne'er been sa'ed 3raft I the entry is sa'ed as a draft and is not yet 'isible to yo#r weblog)s readers /ublis*ed I the entry has been p#blished and is 'isible to yo#r weblog)s readers

-er#alin" I this read8only field is the permalink link to yo#r weblog entry. 0t is set the first time thatyo# sa'e an entry based on the title at the time yo# sa'e I and it cannot be changed later.

Category I @o# can pick one category for yo#r weblog entry. Categories are for folks who want toorgani ed the entries in their weblog into a small8set of fi6ed and possible hierarchical categoriesdefined by the weblog admin Bthat)s probably yo# . @o# can add and remo'e categories 'ia theCategories page.

ags I Boptional 0n addition to assigning each of yo#r weblog entries to a category yo# can also tagthem. @o# can assign a list of tags to each entry. @o# can #se any tag name yo# want. /eparate yo#r tagswith spaces. C#rrently the only way to do m#lti8word tags is to #se an #nderbar for e6ample to tagsomething with Eapache rollerE yo# wo#ld #se the tag apacheJroller. As yo# type !oller may s#ggesttags that yo#)'e #sed before.

Content I his is the main body of yo#r weblog entry in * M; format. &e try to make that easy by pro'iding two ways to edit the content. ia the /ettings page yo# can pick either of these

Rich e,t +ditor >inha7 I a rich8te6t editor that)s designed to make editing * M; as easy as

#sing M/ &ord or =pen =ffice. e,t +ditor I a plain8te6t editor that yo# can #se to edit the raw * M; mark#p of yo#r weblog

entries. -on)t #se this #nless yo# know * M;. /u##ary I Boptional 0f yo# wish yo# can enter a short s#mmary of yo#r weblog post. 0f yo# do so

then the short s#mmary will be displayed on the main page of yo#r weblog and yo#r readers will ha'e toclick a !ead More link to get to the f#ll8content. /ome bloggers like to do this when they ha'e 'ery long

post and they don)t want that long post to dominate the main page of their weblog.

4.1.2 Weblog editor buttons*ere)s a g#ide to the b#ttons that appear on the &eblog editor page.

-ost to weblog I Using this b#tton will p#blish yo#r weblog entry and make it 'isible to the world.Make s#re yo#)re happy with yo#r post before yo# p#blish beca#se once something is p#blished on theweb and grabbed by the blog aggregators and search engines t*ere's reall# no wa# to un-publis* it.

/ub#it (or review I if yo#)re 9#st a limited blogger yo# won)t see the ost to weblog b#tton beca#seyo# cannot post to the web. 0nstead yo#)ll see a /#bmit for re'iew b#tton which yo# can #se to sendyo#r entry to the a#thor>admin of the blog that yo# are working in. 0f they like the post they can p#blishit I or they can ret#rn it to yo# for f#rther edits.

12


13/54

/ave as dra(t I this will sa'e yo#r weblog post for later editing b#t will not p#blish it to the web. &henyo#)re working on a new weblog entry #se /a'e as draft often so yo# won)t lose yo#r post in the e'entof internet connection loss or session time8o#t.

8elete entry I #se this to delete the c#rrent weblog entry yo#)ll be asked to confirm. ull 'review I @o# won)t see this b#tton #ntil yo#)'e sa'ed yo#r entry as a draft. 0t allows yo# to 'iew

in a separate window a pre'iew of yo#r entry displayed #sing the layo#t and style of yo#r blog.

4.1.3 Weblog editor plugin settings0f yo# e6pand the /lugins to ppl# control yo#)ll see a set of check8bo6es one for each &eblog 5ntry l#ginthat is a'ailable. Check the ones that yo#)d like to apply to yo#r c#rrent weblog entry. 0f yo# ha'e a fa'orite

pl#gin one that yo# want to #se on e'ery entry then yo# can set it as a defa#lt on yo#r weblog)s /ettings page.

4.1.4 Weblog editor advanced settings0f yo# e6pand the d anced )ettings control yo#)ll see what)s below.

All of these are optional settings. -ub i#e I if yo#)d like to set the p#blication time of yo#r weblog entry to a specific time possibly one

in the f#t#re yo# can do so here. llow co##ents (or I this setting allows yo# to t#rn comments on>off for yo#r weblog entry and to

limit the n#mber of days that comments are allowed. e,t reads le(t


14/54

4.2 Finding and editing weblog entries All of yo#r weblog entries are sa'ed in a database. =nce yo#r entries scroll off the front page or off the recententries list of the weblog editor page they are still a'ailable 'ia ne6t and pre'io#s links displayed on yo#rweblog and 'ia the weblog calendar that is incl#ded in most weblog themes.@o# can also access yo#r entries 'ia the 5dit 5ntries page which allows yo# to search entries 'ia keywordcategory tags date and stat#s.

14

Illustration 4: Edit entries page


15/54

4.3 Managing categories 5ach weblog can define its own #ni #e list of categories to be #sed for categori ing weblog entries #sing theCategories page shown below. &hen yo# or another a#thor of yo#r weblog creates a new entry yo# must choose one of the categories yo# ha'e defined.

@o# can #se the Categories page to add new categories and to edit yo#r e6isting ones. @o# can change categorynames if yo# wish. And yo# can also delete categories and if a category is in #se yo# will be asked to re8categori e the entries in that category.@o# can also define a hierarchy of categories and mo'e categories aro#nd in that hierarchy b#t s#pport forhierarchical categories is somewhat limited in most !oller themes. Unless yo# are prepared to do somec#stomi ation 'ia template editing yo# probably don)t want to #se hierarchical categories.

1(

Illustration 15: ategories page


16/54

4.4 Managing your weblog's blogroll !oller makes it easy to maintain a blogroll that is a list of yo#r fa'orite weblogs and web sites that is displayedin the sidebar of yo#r weblog. 0ndi'id#al blogroll items are known as boo$mar$s . Use the Create ;+dit? oo"#ar"s page to add edit and delete bookmarks and bookmark folders in yo#r blogroll.

1"

Illustration 11: 6oo$mar$s management page


17/54

4.5 Uploading images and other files to your weblog0f yo#)d like to #pload images or other files for #se in yo#r weblog go to yo#r weblog)s Create ; +dit


18/54

4.5.1 How to upload fileso #pload files yo# follow the dd &edia ile link in the top right of the page. @o# will see the Media File

Add page which is pict#red below.

@o# can #pload #p to fi'e files at a time and yo# can enter information abo#t the images incl#ding titledescription copyright statement and tags. @o# can pick which directory sho#ld recei'e the #ploaded images.@o# can also decide whether or not yo# want yo#r images to be incl#ded in the allery which means that theywill be made a'ailable in the Media File Feed for yo#r blog.

1+

Illustration 1&: dd .edia 7iles page


19/54

After yo#r file #pload completes !oller will show yo# the *'load Co#'lete page Bbelow with the files thatyo# #ploaded and will offer to incl#de them in a new weblog post for yo#. @o# can choose any or all of theimages or yo# can skip this step and ret#rn to the Media File iew.

1%

Illustration 1+: Upload omplete page


20/54

4.5.2 How to edit and update filesFrom the Media File iew page yo# can edit any Media File simply by clicking on it. &hen yo# click yo# will

be shown the Media File 5dit page Bbelow . From this page yo# can edit the same information that yo# enteredwhen yo# #ploaded the file.@o# can also #pload a new 'ersion of the file. he file will maintain the same U!; as before the #pdate so no

worries abo#t broken links. 0f the file is an image a new th#mbnail will be generated for yo# and image si einformation will be #pdated.

2,

Illustration 1(: .edia 7ile Edit page


21/54

4.5.3 How to use Media File Directories@o# can #se directories to organi e yo#r Media Files. @o# canmo'e files aro#nd and not worry abo#t breaking any links

beca#se directory and file names are not part of U!;s.o create a new directory enter a new directory name in the

new directory control and click the create b#tton.o na'igate into a directory in the Media File iew page

simply click on the directory.

4.5.4 How to delete Media Fileso delete Media Files go to the &edia ile iew page select

the checkbo6es of the files yo# wish to delete and then click the -elete b#tton. @o# will ha'e to confirm the delete before ite6ec#tes.

4.5.5 How to delete Media File Directoriesoe delete Media File -irectories yo# m#st first empty them o#t. @o# can only delete directories that are empty.

4.5.6 How to post images to your weblog&e e6plained abo'e how to post imagesd#ring the #pload process. @o# can also postimages to yo#r weblog directly from theMedia File iew page.;ook for the little green pl#s sign and click itto see the Create &eblog ost men#.&hen yo# click -ost in !eblog !oller willcreate a new weblog and incl#de yo#r MediaFile. 0f it)s an image !oller will also incl#dethe image th#mbnail.

4.5.7 How to post a podcast to your weblog;ook for the little green pl#s sign and click it to see the Create &eblog ost men#.

&hen yo# click -ost in !eblog as -odcast !oller will create a new weblog and incl#de yo#r Media File inthe post content and as an enclos#re. As an enclos#re yo#r file will be referenced in yo#r weblog)s !//>Atomfeed so that podcast readers can fetch it.

21


22/54

4.6 Podcasting with Roller !oller incl#des s#pport for podcasting a way to distrib#te files thro#gh yo#r weblog)s newsfeed. ypicallyfolks #se podcasting to distrib#te a#dio files b#t the techni #e can be #sed to distrib#te any type of file./peciali ed podcast client software downloads the a#dio files that are referenced in yo#r newsfeed and copiesthem to an m#sic player s#ch as an M 3 player.0*is section assumes t*at #ou want to upload #our podcasts to some ot*er ser er! one wit* lots of space and

bandwidt*! and not to Roller" If #ou want to upload #our podcasts to Roller! t*en see Section 4.5.7 for ane9planation of posting a .edia 7ile to #our weblog as a podcast"

4.6.1 How to create a podcast feed with Roller0n !oller a odcast is like an attachment to a weblog entry. *ere are the steps in'ol'ed in odcasting with!oller

!ecord an interesting odcast Bthat)s the hard part by the way and sa'e yo#r odcast in M 3 format orwhate'er format yo# prefer.

Upload yo#r odcast to a web ser'er somewhere and take note of yo#r odcast)s U!;. For e6ample ifyo# were to #pload a file to !oller then the U!; might look something like this

*ttp: *ostname roller #ourname resource m#cast"mp& Create a new !oller weblog entry anno#ncing yo#r new odcast. @o# might want to pro'ide a link to it

so that those witho#t a odcast client can click to download it directly. For e6ample ;e# now< I =ust created m# first /odcast #ou can download it *ere:>a *ref?@*ttp: *ostname roller #ourname resource m#cast"mp&@Am#cast"mp&> aA

And the most important step in the lower8half of the weblog editor page yo#)ll see an e6pandablecontrol labelled d anced )ettings . Click on that to e6pand the control and paste in the U!; of yo#r

podcast. =nce yo#r blog post is ready sa'e it as a draft or p#blish it. =nce yo#)'e done that yo#)ll see that the

Ad'anced /ettings control has picked #p the content8type and file8si e of yo#r podcast. 0f not then

!oller co#ld not access yo#r podcast d#e to network problems or perhaps a bad U!;. Make s#re theU!; is correct and sa'e again. 0f yo#r podcast is =H yo#)ll see something like this

!oller will add the podcast to yo#r !// newsfeed as an . @o# can check this by lookingat yo#r !// newsfeed and any podcast software that is s#bscribed to yo#r feed will pick it #pa#tomatically.

22

Illustration 1,: /odcast URB field


23/54

4.7 Using a weblog client with Roller Using a nice weblog client like 5cto or Mars5dit can make it easier for yo# to post to yo#r !oller weblog. @o#can also post to yo#r weblog remotely from ser'ices like Flickr.com and del.icio.#s. his is possible beca#se!oller s#pports a standard p#blishing protocols s#ch as the Meta&eblog A 0 and the Atom #blishing rotocol.*ere)s how to set #p a weblog client to post to !oller.

Con(iguring a weblog client (or use with RollerFirst make s#re to enable weblog client A 0 s#pport in yo#r weblog 'ia yo#r weblog)s &eblog /ettings page.

?e6t start yo#r blogging client find the preferences or acco#nt set#p dialog. @o#)ll need to set the following parameters

*serna#e yo#r !oller #sername -assword yo#r !oller password logI8 the handle of yo#r !oller weblog *R0 the U!; of !oller)s web ser'ices end8point

?ote that yo# may not need to enter yo#r Glog0- beca#se some blog clients will login to !oller and then present yo# with a list of the weblogs that are a'ailable to yo#r #ser.

blogs.sun.co# e,a#'le . For e6ample if yo# ha'e an acco#nt on blogs.s#n.com yo#r #sername is fred andyo#r blog)s handle is fredsblog Bi.e. yo#r weblog)s U!; is *ttp: blogs"sun"com fredsblog then yo#r parameterswo#ld be

*serna#e fred -assword Byo#r password logI8 fredsblog *R0 http >>blogs.s#n.com>roller8ser'ices>6mlrpc

@o# may not need to enter yo#r Glog0- beca#se some blog clients will login to !oller and then present yo#with a list of the weblogs that are a'ailable to yo#r #ser.

@roller.co# e,a#'le . 0f yo# ha'e an acco#nt on 9roller.com yo#r #sername is fred and yo#r blog)s handle isfredsblog Bi.e. yo#r weblog)s U!; is *ttp: =roller"com fredsblog then yo#r parameters wo#ld be

*serna#e fred -assword Byo#r password logI8 fredsblog URL : http://#roller.com/roller-ser$ices/xmlrpc

23

Illustration 1 : Weblog )ettings page: Weblog lient /I


24/54

5 Working with comments and trackbacks !oller s#pports weblog comments and trac$bac$s which pro'ide a way for other bloggers to add comments toyo#r blog remotely. Gy defa#lt comments and trackbacks are enabled b#t yo# can t#rn them off on yo#rweblog)s &eblog /ettings page of yo#r weblog. ?ote that t#rning off comments will disable both comments andtrackbacks.

5.1 Comment notification via email 0f yo#)re going to lea'e comments t#rn on then take the time to read them to respond where appropriate andwhen yo# recei'e spam or other forms of offensi'e comments delete them from yo#r weblog. @o# can)t respondto comments if yo# don)t know when yo# get one so make s#re yo# enable email notification of comments. @o#can do that on the &eblog /ettings page.0f yo#)'e got email t#rned on then yo#)ll recei'e an email e'ery time yo# get a new comment and the email willincl#de the te6t of the comment a link to the entry that was commented #pon and a link to the commentmanagement page shown below where yo# may choose to appro'e mark as spam or e'en delete the newcomment.

5.2 Comment management @o# can #se the Comments page to manage yo#r weblog comments. @o# can mark comments as spam or deletethem entirely. @o# can search comments by keyword date and stat#s. 0f yo#)'e got comment moderation t#rnedon yo# will #se the Comments page to appro'e new comments.

24

Illustration 1 : omments page


25/54

word about status@o# can)t edit comments b#t yo# can mark them as spam or dis8appro'e them. /omeday !oller may pro'idesome spam filtering based on data collected from comments marked as spam b#t c#rrently marking as spamand dis8appro'ing of a comment do the same thing 88 they pre'ent the comment from being displayed on yo#rweblog.

Aow to get to the Co##ents 'agehere are a co#ple of ways to get to the Comments page. @o# can #se !oller)s tabbed men# to go there and

manage comment across yo#r entire weblog. 0f yo#)'e got email notification of new comments t#rned on theyo# might arri'e at the Comments page 'ia a link sent to yo# in yo#r email.@o# can also manage comments for 9#st one weblog. &hen yo# are editing a weblog entry with commentsyo#)ll see a link in the top8right corner of the weblog editor page like the one below which yo# can #se toaccess the entry)s comments.

5.3 Comment moderation 0f yo#)d like to pre'iew and appro'e comments before they are displayed on yo#r weblog then yo#)ll want tot#rn on comment moderation 'ia &eblog /ettings page. &hen comment moderation is enabled then each newcomment will be marked as pending and #nappro'ed and will not appear on yo#r weblog. o check for new

comments go to the Comments page to check for and either appro'e or delete new comments. 0f yo#)'e gotcomment notification enabled make s#re yo# also enable comment notification so yo#)ll know when newcomments arri'e. o moderate comments #se the comment management page described below.

Aow to #oderate co##ents !e'iew each new comment and decide if it is to be appro'ed for display marked as spam and hidden or

deleted entirely. =nly comments that are marked as appro'ed and are not spam will be displayed on yo#r weblog. /o set Bor

#nset the corresponding checkbo6es for each comment or lea'e them the way they are. &hen yo# are done. Click the sa'e changes b#tton at the bottom of the page. @o#)ll see that comments that

were pending are no longer pending and those that yo# marked for delete will be gone.

5.4 Global comment management 0f yo#r #ser has global administration pri'ileges then yo# can manage comments across the entire !oller siteincl#ding e'ery weblog. o do this go to the /erver d#inistration?Co##ents page and yo#)ll see a pagethat is almost identical to the weblog8specific comment management page.

0i#itations o( global co##ent #anage#ent@o# can #se this page to mark as spam or delete any comment in the system howe'er yo# cannot change theappro'al stat#s of comments thro#gh this interface. Appro'ing comments for display is the d#ty andresponsibility of the indi'id#al webloggers so comment appro'al is only a'ailable in the conte6t of a weblog.

2(


26/54

5.5 Preventing weblog spamhere are three forms of comment spam that can affect yo#r weblog

omment spam spam that arri'es 'ia the comment form on yo#r weblog. /ometimes spam comments areadded by a h#man and sometimes by a comp#ter program known as a spambot"

0rac$bac$ spam spam that arri'es 'ia trackbacks sent by a spambot. Referrer spam spam that arri'es in web re #ests and appears on the !eferrers page of yo#r !oller blog or

on yo#r blog Bb#t only if yo#r blog theme #ses the #showReferrers() macro .

Fort#nately there are co#nter8meas#res for each type of spam. *ere are !oller)s b#ilt in spam pre'entionmeas#res

/luggable comment aut*entication . Gy defa#lt !oller asks each commenter a simple math #estion toens#re that they are a person and not a spam robot. @o#r site administrator can t#rn this off or replace itwith another form of a#thentication.

/luggable comment alidation . !oller incl#des fi'e comment 'alidators below. @o#r site administratorcan ad9#st the settings for these 'alidators and can enable>disable them as needed by o'erriding !oller)sconfig#ration properties Bsee the 0nstallation #ide for more information . 56cess links 'alidator will mark comments with more than three links as spam Bdefa#lt on 56cess si e 'alidator marks any comment with more than 1,,, characters as spam Bdefa#lt on Glacklist 'alidator marks comments containing any of yo#r site)s designated bad words as spam

Bdefa#lt on rackback 'erification 'alidator will check incoming trackbacks to ens#re that they link to yo#. Akismet 'alidator allows yo# to #se the Akismet.com spam pre'ention ser'ice.

omment t*rottling . 0f yo#r site is being ab#sed by a spam robot yo#r site administrator can set #pthrottling which will watch for ab#sers and ban 0 addresses that are posting too many comments too

#ickly.

ut nothing beats co##ent #oderation5'en if yo#)'e got all of those meas#res enabled yo# sho#ld still enable email notification of comments so thatyo# are constantly aware of new comments on yo#r weblog. ?one of the meas#res are 1,,K effecti'e. 0f yo#are really concerned abo#t displaying offensi'e content on yo#r weblog e'en for a short time then enablecomment moderation on yo#r weblog.

hree levels o( blac"listing!oller #ses a blac$list a lists of words which are #sed to check incoming comments trackbacks and referrersfor spam. he blacklist incl#des se'eral tho#sand words and reg#lar e6pressions which which are #sed to checkincoming comments and trackbacks. 0f the name U!; or content of a comment or trackback incl#des one of the

blacklist words or matches one of the e6pressions then that comment or trackback is marked as spam and is not

displayed on yo#r weblog #nless yo# #se the comment management page to #nmark it.Act#ally there are three le'els of blacklist

;e'el 1 blacklist his is the b#ilt8in blacklist the one that comes with !oller. his can only be changed by somebody with root access to the !oller ser'er itself.

;e'el 2 blacklist his is the site wide blacklist which can only be edited by a global administrator 'ia the/er'er Admin page.

;e'el 3 blacklist &eblog specific blacklist which yo# control in the &eblog /ettings page of yo#rweblog.

2"


27/54

0ncoming comments and trackbacks are checked against all three le'els of blacklist. 0ncoming referrershowe'er are only checked against the le'els 2 and 3 blacklist.

Aow to add words and e,'ressions to the blac"list

0f yo# ha'e a spam problem on yo#r weblog and yo#)d like to add words to the blacklist it)s probably better foryo# to ask yo#r administrator to add the words to the le'el 2 blacklist for yo#. hat way e'ery blogger on thesite will benefit from the addition. 0f yo# m#st do it yo#rself here)s how yo# do it

o to the &eblog /ettings page and scroll down to the blacklist fields

5nter yo#r spam words one per line ;ines that begin with a left parenthesis will be treated as reg#lar e6pressions Bsee the 7a'a A 0

doc#mentation for #a$ax.util.regex.%attern for a g#ide to reg#lar e6pressions . -on)t try to #sea reg#lar e6pression #nless yo# really know what yo#)re doing.

5.6 Sending trackbacks 0f yo# are writing abo#t something yo# read on another weblog yo# want to let the a#thor and readers of thatweblog know that yo# are doing so and that other weblog is trackback enabled then yo# sho#ld send thatweblog a trackback ping. *ere)s a story that ill#strates how trackback works

@o# read an interesting blog entry on =tto)s blog. @o# notice that =tto)s blog entry has a trackback U!;so instead of lea'ing a comment on =tto)s blog yo# decide to comment by writing a blog entry in yo#rown blog. @o# copy that trackback U!; B#sing A; 8C or right8click8copy or whate'er ca#se yo#)llneed it later.

@o# go to yo#r blog and write a new blog entry in response to =tto)s entry. Click the ost to &eblog b#tton to p#blish yo#r new entry. After yo# p#blish scroll down on the ?ew 5ntry page #ntil yo# see thefollowing te6t field and b#tton

5nter the trackback U!; from =tto)s blog entry into the te6t field and click the /end rackback b#tton.!oller will respond by printing the response recei'ed from =tto)s blog ser'er. 0f the trackback wass#ccessf#l yo# sho#ld see something like this

@o# sho#ld now see yo#r trackback listed among the comments on =tto)s blog entry.

2$

Illustration 14: )end trac$bac$ control


28/54

6 Choosing your weblog themeA weblog theme is a set of templates style8sheets and image that determine how yo#r weblog will be displayed.A theme can define both the layo#t and color8scheme of yo#r weblog. @o# can pick from one of a n#mber of

predefined themes. /ome themes will allow yo# to control design by #sing a stylesheet. =ther themes re #ireyo# to edit the templates that define the theme if yo# want to c#stomi e them.@o# can access !oller)s theme and template feat#res for yo#r weblog 'ia the -esign men# shown below

he heme men# leads yo# to the theme chooser page shown below. Using this page yo# can pick from one ormore different themes for yo#r weblog. 0f none of the themes are appealing to yo# then speak to yo#r siteadministrator abo#t obtaining or de'eloping some additional themes. he !oller /#pport pro9ect is one placewhere yo# can obtain additional themes B http >>roller.de'.9a'a.net not an Apache site .

For more information on c#stomi ing !oller themes refer to the emplate #ide.

2+

Illustration 25: 3esign menu


29/54

7 Managing your weblog preferences As a !oller #ser yo# are free to c#stomi e the settings of yo#r weblog as yo# wish. &hen yo# establish yo#r!oller #ser acco#nt yo# can choose one of the do en or so stock themes for yo#r website. ;ater yo# can #sethe theme switcher to switch to a different theme. =r if yo# know something abo#t * M; and C// yo# canc#stomi e the look8and8feel and layo#t of yo#r weblog yo#rself by modifying the page templates that make #pyo#r site and by adding new pages. Gest of all yo# can do all of this thro#gh the web8based !oller 5ditor U0.

7.1 Weblog settings he -re(erences?/ettings page allows yo# to set the config#ration parameters for yo#r weblog.

*ere is an e6planation of each of the settings on the weblog -re(erences?/ettings page

7.1.1 General settings

itle 8 he title of yo#r weblog may incl#de * M; b#t the * M; will be stripped o#t in yo#r !//feed. @o# can access yo#r title in a page template with the e6pression &sho'(e)site*itle+,

agline I /hort description or s#b title of yo#r weblog. May incl#de * M; b#t the * M; will bestripped o#t in yo#r !// feed. @o# can access yo#r tagline in a page template with the e6pression&sho'(e)site escription+, .

Icon 8 he image file name Be6 th#mbnail.9pg or image #rl Be6 http >>yo#rsite>th#mbnail.com thatshows on some of the defa#lt themes. @o#)ll need to #pload the image 'ia the Create ; +dit? ile*'loads tab first.

2%


30/54

bout your blog I A more detailed description of the blog or blog a#thorBs that shows on some of thedefa#lt themes.

+#ail address o( weblog owner 5nter the email address that yo# wo#ld like people to #se to contactthe person in charge of yo#r blog: #s#ally that)s yo#. o thwart spammers yo#r email address will beobf#scated when displayed on yo#r blog. lease enter a 'alid address otherwise !oller)s email feat#reswill not work.

!eblog editor 'age to be used 8 Choose a weblog editor page some are rich8te6t editors

editor8te6t.9sp /imple te6t editor yo# m#st enter * M; editor8rte.9sp !ich te6t editor Bworks in Firefo6 and 05 b#t not /afari

!eblog is active? #n8check this bo6 to indicate that yo#r weblog is no longer acti'e and sho#ld notappear in hot8blog and other weblog listing on the site. @o# might want to do this if yo# take a 'ery long'acation or if yo# ha'e decided to stop #pdating yo#r weblog for some other reason.

:u#ber o( entries to dis'lay on weblog 5nter the ma6im#m n#mber of entries to be displayed onyo#r weblog.

7.1.2 Internationalization Settings

I 'ublish #y weblog in #ulti'le languages check this bo6 if yo# blog in m#ltiple lang#ages andwo#ld like to specify a lang#age locale for each of yo#r weblog entries.

/how #y weblog entries (ro# all languages on #y ho#e 'age check this bo6 if yo#)d like yo#rweblog)s main page to show yo#r posts in all lang#ages. 0f yo# don)t check it then readers will only seeweblog entries from yo#r defa#lt locale.

0ocale set the defa#lt locale for yo#r weblog. i#e9one? the time one to be #sed in yo#r weblog.

7.1.3 Comments and default comment settings

3,


31/54

llow co##ents (or your weblogB I Check this bo6 to allow 'isitors to lea'e comments on yo#rweblog.

&oderate co##ents I Check this bo6 to enable comment moderation Bi.e. yo# m#st appro'e eachcomment before it is displayed .

?ote the ne6t two options are 'isible only if the !oller Administrator has enabled email notifications for#ser blogs B/ee /ection %.2 !oller Administration

+#ail noti(ication o( co##entsB I Check this bo6 to recei'e an email notification of each newcomments.

8e(ault (ro# e


32/54

7.1.6 Spam prevention

Ignore inco#ing re(errer *R0s that contain any o( these co##a


33/54

7.2 Weblog members: managing a group blog o create a gro#p blog create a new weblog or log into an e6isting weblog that yo#)d like members to

contrib#te to. Creating a weblog for gro#p blogging is the same a creating a personal weblog Bsee section L3 forinstr#ctions . ?a'igate to the &e#bers men# item in the -re(erences tab. he -re(erences?&e#bers pageenables weblog admins to in'ite members to a gro#p blog and manage the gro#p blog #ser access.

@o# can #se the Invite new #e#ber link to in'ite any !oller #ser to 9oin yo#r weblog b#t before yo# do yo#sho#ld #nderstand the three different permission le'els allowed for members of a weblog. hey are

d#in an admin can create>edit weblog entries and p#blish them to the web. hey can also manage theweblog by changing the theme editing the page templates that define the look of the blog and managingthe #sers of the blog. !oller will grant yo# admin rights in any weblog yo# create. Admin #sers can see

both the Create N 5dit tab and the references tab of !oller. uthor a#thor permission allows #sers to create entries edit entries and #pload files. G#t a#thors

cannot change weblog settings modify the theme or manage #sers. A#thors can see the weblog Create N5dit tab b#t not the weblog references tab.

0i#ited limited bloggers can create and edit blog entries and sa'e them as drafts b#t cannot p#blishthem to the web.

/elect Invite new #e#ber from the right na'igation to in'ite Admins A#thors and ;imited a#thors to 9oin thegro#p blog. @o#)ll need to know the #sers indi'id#al blog #sername to find them in the list of #sers. @o# mayscroll thro#gh the list b#t it)s best to begin typing their #sername to locate them. /et the #sers ermissions byselecting Admin A#thor or ;imited. Click on /end Invitation . 0f !oller is not config#red to talk to the mailser'er yo# may get the following messages

ser success ully in$ited.

33

Illustration 21: Weblog permissions page
http://www.rollerweblogger.org/wiki/Wiki.jsp?page=UserGuide_2.x#ref-UserGuide_2.x-3http://www.rollerweblogger.org/wiki/Wiki.jsp?page=UserGuide_2.x#ref-UserGuide_2.x-3


34/54

1121: oti ication email+s, not sent due to 1oller con igurationor mail ser$er pro)lem.

As long as the first message is present the in'ite is s#ccessf#l. he ne6t time the #ser logs into the blog sitethey will see the message show in the screenshot below asking them to accept or decline yo#r in'itation.=nce a #ser is a member of yo#r blog yo# can change their permissions. 7#st click the appropriate radio b#ttonin the table and click the /ave b#tton. @o# can also remo'e #sers from the site b#t note that yo# cannot red#ceyo#r own permissions or remo'e yo#rself from the weblog.

cce't or 8ecline a Grou' log Invitation 0f yo# are in'ited to become a member of a gro#p blog an in'itation will be present at the top of the MainMen# page. 56ample

Click )accept) to become a member of the gro#p blog or )decline) to t#rn down the in'itation.

Contribute to a grou' blog =nce yo#)re a member of a gro#p blog contrib#ting is as easy as creating blog entry content. o access thegro#p blog login from the &ain &enu na'igate to the gro#p blog yo#)d like to contrib#te to and select any ofthe following ?ew 5ntry 5dit 5ntries /ettings Bweblog admins only .For #sers who participate in m#ltiple weblogs it is important to note that the Main Men# page is how yo# switch

between the 'ario#s weblogs yo# can a#thor to. he Main Men# will always show yo# what weblogs yo# are participating in and what pri'ileges yo# ha'e on each weblog.

Resign (ro# a Grou' log o resign from a gro#p blog login on the Main Men# page na'igate to the blog information for which yo#

wish to resign. /elect )!esign).

34

Illustration 22: .ain .enu wit* in itation to =oin a group blog


35/54

8 Using weblog pings &eblog #pdate pings pro'ide a means for yo# to notify aggregation and inde6ing sites Bfor e6ample&eblogs.com echnorati and 9a'ablogs.com that yo#r weblog has changed so that they will pick #p yo#r latestcontent from yo#r !// feed.!oller s#pports the con'entional DM;8! C weblog #pdate ping mechanism #sed by many sites for s#chnotifications.

8.1 Registering with an Aggregator enerally speaking aggregation sites first re #ire yo# to register yo#r weblog with their site. -#ring this

registration process yo# normally pro'ide both the * U!; and the !// feed U!; for yo#r weblog. his isimportant beca#se the ping message con'eys only the normal * U!; of yo#r site and the site will #se thatto look#p the registered !// feed U!; to fetch from.Aggregation sites that accept ping notifications generally p#blish the ping U!; to #se to ping their site on theirBh#man8readable web site. =nce yo# ha'e registered yo#r site with an aggregator yo# can set #p yo#r weblogto deli'er pings to that site.

8.2 Ping Targets, Common and Custom @o# can set #p the !oller ser'er to ping sites of yo#r choice a#tomatically whene'er yo# post p#blished #pdatesto yo#r weblog.!oller #ses the term 'ing target to refer to a site s#ch as an aggregator that accepts weblog #pdate pingnotifications. A ping target is config#red with a Bdisplay name and the ping U!; needed to reach the site.Gefore yo# can send a ping to a site yo# m#st config#re a ping target in !oller for the site. !oller s#pports theconfig#ration of two types of ping targets

co##on 'ing targetshese are ping targets that are config#red by a !oller administrator and are a'ailable to be #sed by all

#sers. his allows the ping U!;s for se'eral well8known aggregator sites to be config#red once fore'erybody.

custo# 'ing targetshese are ping targets that are config#red by indi'id#al #sers. 0f yo# don)t find the site yo# wish to ping

in one of the common ping targets yo# can config#re yo#r own c#stom ping target.

8.3 Setting up Automated Pings =nce a ping target Beither a common ping target or a c#stom ping target has been config#red for the site thatyo# wish to ping yo# can #se the !eblog?-ings page Bshown below to enable a#tomatic pings and sendman#al pings.

3(


36/54

o enable a#tomatic pings to a ping target find the ping target on the page and click the +nable link in theA#tomatic col#mn. he stat#s indicator t#rns to O: and the link changes to 8isable Bas shown for some sites inthe screenshot abo'e . o disable a#tomatic pings to a ping target click the 8isable link in the A#tomaticcol#mn. he stat#s indicator t#rns to O and the link changes to +nable .C#stom ping targets that yo# ha'e config#red are displayed on this page in a separate table below the common

ping targets: they work in the same way. @o# may need to scroll down the page to see them&hen yo# ha'e enabled a#tomatic pinging for a ping target !oller will a#tomatically send a ping to that sitewhene'er yo# p#blish a new weblog entry or #pdate a p#blished weblog entry.

Note: In actualit#! Roller Cueues a reCuest to send t*e ping and processes t*is reCuest in t*ebac$ground! so t*at #ou can get on wit* #our blogging" 0*e ping Cueue is processed at an inter alconfigured b# t*e site administratorD t*is inter al is ( minutes in a default configuration" In case t*eaggregator site is temporaril# unreac*able! Roller will reCueue #our ping reCuest and retr# on

subseCuent passes t*roug* t*e CueueD in a default configuration t*e ping is reCueued for up to & pingattempts"

3"

Illustration 2&: utomatic ping configuration page


37/54

8.4 Sending a Manual Ping @o# can also send a man#al ping to a ping target #sing the /end -ing :ow link listed for the target on the!eblog?-ings page. &hen yo# send a man#al ping the ping is not #e#ed it is sent immediately and attemptedonly once. !oller shows yo# the response stat#s Bs#ccess or a fail#re message that res#lts from the ping. Usingman#al pings yo# can test yo#r c#stom ping targets to make s#re that the U!; yo# ha'e entered is working

properly.@o# do not need to enable a#tomatic pinging in order to send man#al pings. @o# can send a man#al ping

whether or not yo# ha'e enabled a#tomatic pinging for that target.@o# can #se man#al pings if yo# ping a site 'ery rarely or if yo# are feeling a bit impatient and yo# don)t wantto wait for the ne6t #e#e processing inter'al.

8.5 Creating and Editing Custom Ping Targets @o# sho#ld find that most pop#lar ping targets are listed among the common ping targets and yo# can ping thesewitho#t needing to create a new c#stom one. 0f yo# don)t find a common target listed for the site yo# wish to

ping yo# ha'e two options. @o# can re #est that yo#r administrator add a new common ping target Bdirectionsin L21 : most likely yo#r friendly !oller administrator will be happy to add new common ping targets foraggregator sites that many other #sers will also be interested in #sing. Alternati'ely yo# can add yo#r own

c#stom ping target #sing the !eblog?Custo# -ing argets page. Note: ustom ping targets are a feature t*at t*e administrator can disable" If #ou do not seeWeblog:Custom Ping Targets menu item! or an# *eading for ustom /ing 0argets on t*e Weblog:Pings

page! t*en an administrator *as disabled it! and #ou will need to contact an administrator to get a newcommon ping target added"

Gefore adding a c#stom ping target yo# m#st determine the proper ping U!; for the site that yo# wish to ping.@o# m#st get this information from the aggregator)s web site or from another knowledgeable so#rce.0t can be hard to find the aggregator)s doc#mentation telling yo# the specific ping U!; to #se to notify their site.Commonly aggregators list this on their web site #nder a topic pro'iding help abo#t registering yo#r feed or#nder a topic pro'iding information for de'elopers. Heep in mind that some aggregators only #se periodic

polling and do not accept ping notifications at all. 0f yo# can)t find any information abo#t pinging on theaggregator)s web site the site may not s#pport pinging.=nce yo# ha'e fo#nd the proper ping U!; yo# can add yo#r c#stom target #sing the !eblog?Custo# -ing

argets page which looks something like the following screen8shot.

3$
http://www.rollerweblogger.org/wiki/Wiki.jsp?page=UserGuide_2.x#ref-UserGuide_2.x-21http://www.rollerweblogger.org/wiki/Wiki.jsp?page=UserGuide_2.x#ref-UserGuide_2.x-21


38/54

Click the dd :ew b#tton to add a new c#stom ping target. his will bring #p a form with a :a#e field and a-ing *R0 field. Fill in both fields and click the /ave b#tton.

=nce yo# ha'e created a c#stom ping target yo# will see it listed on the !eblog?Custo# -ing argets page.From this page yo# can f#rther edit it or delete it. o enable a#tomatic pings or send man#al #sing yo#r c#stom

ping targets #se the !eblog?-ings page.

he ping target)s name m#st be #ni #e among yo#r own c#stom targets and the ing U!; m#st be a properlyformed U!; with a known hostname Bor a raw 0 address . 0f any of these conditions are not met the /ave willfail and yo# will get an error indication telling yo# what was wrong with yo#r entry

3+

Illustration 2(: Edit ping target form

Illustration 2+: ustom ping targets page


39/54

8.6 More on Registering with an Aggregator &hen yo# register with an aggregator yo# will #s#ally need to pro'ide two pieces of information as part of theregistration yo#r blog)s base B* M; #rl and yo#r !// feed BDM; U!;. Make s#re to read the aggregator)sdoc#mentation and help on registering.For !oller weblogs yo# get yo#r weblog)s base U!; by 'iewing yo#r weblog and taking the U!; to the point

9#st following yo#r weblog)s handle. B0n other words it sho#ld end with page >*andlename*ere .

he !// feed U!; for yo#r whole feed can be obtained by s#bstit#ting page in yo#r weblog)s U!; with 155 .Most browsers will display this link in the stat#s bar when yo# place yo#r mo#se o'er !// badge Bthe littleorange DM; bo6 on yo#r weblog page.@o# also ha'e category8specific feeds which are #sef#l for registering with topical aggregators like @ava.blogs .

o get a category8specific feed U!; 9#st append 6catname= categor# pat* where categor# pat* is the f#ll path of the category. he EbasicE theme has some category !// feeds 9#st below the !// badge in the right8hand 'ertical bar./ome aggregators can also scrape Bread and parse the * M; of yo#r weblog to disco'er the feed U!;a#tomatically when pro'ided with the * M; U!;. he defa#lt !oller theme template pages incl#de hints inthe form of tags that many sites can #se to determine the feed U!; a#tomatically.

3%


40/54

9 Roller administration his section of the !oller #ser g#ide is for #sers with the global admin role. *ow do yo# get the admin roleOhe first #ser created in a !oller system gets that role and then can grant it to other #sers 'ia the Global d#inplanetrss so on a defa#lt !oller install its U!; will be

http://localhost: 0 0/roller/planetrss

his section describes how to add and remo'e weblogs #sing the -lanet d#in


51/54

12.3 Adding custom groups to Planet Roller @o# can also add c#stom aggregation gro#ps and lanet !oller will pro'ide an !// newsfeed for each gro#pyo# add. For e6ample if yo# add gro#ps with the handles music and politics then yo#)ll get two feeds at U!;slike this

http://localhost: 0 0/roller/planetrss6group=music

http://localhost: 0 0/roller/planetrss6group=politics

o add new c#stom gro#ps 9#st #se the -lanet d#in


52/54

13 Apache Software License, Version 2.0 pache ;icense ersion !.0 anuary !004 http://'''.apache.org/licenses/

* 1 5 ?2 @*@2 5 A21 5 1 %12 ?*@2 @5*1@B *@2

. e initions.

";icense" shall mean the terms and conditions or use reproduction and distri)ution as de ined )y 5ections through 9 o this document.

";icensor" shall mean the copyright o'ner or entity authoriCed )y the copyright o'ner that is granting the ;icense.

";egal ntity" shall mean the union o the acting entity and all other entities that control are controlled )y or are under common control 'ith that entity. Aor the purposes o this de inition "control" means +i, the po'er direct or indirect to cause the direction or management o such entity 'hether )y contract or other'ise or +ii, o'nership o i ty percent +D0E, or more o the outstanding shares or +iii, )ene icial o'nership o such entity.

"Fou" +or "Four", shall mean an indi$idual or ;egal ntity

exercising permissions granted )y this ;icense.

"5ource" orm shall mean the pre erred orm or maGing modi ications including )ut not limited to so t'are source code documentation source and con iguration iles.

"2)#ect" orm shall mean any orm resulting rom mechanical trans ormation or translation o a 5ource orm including )ut not limited to compiled o)#ect code generated documentation and con$ersions to other media types.

"(orG" shall mean the 'orG o authorship 'hether in 5ource or 2)#ect orm made a$aila)le under the ;icense as indicated )y a copyright notice that is included in or attached to the 'orG +an example is pro$ided in the ppendix )elo',.

" eri$ati$e (orGs" shall mean any 'orG 'hether in 5ource or 2)#ect

orm that is )ased on +or deri$ed rom, the (orG and or 'hich the editorial re$isions annotations ela)orations or other modi ications represent as a 'hole an original 'orG o authorship. Aor the purposes o this ;icense eri$ati$e (orGs shall not include 'orGs that remain separa)le rom or merely linG +or )ind )y name, to the inter aces o the (orG and eri$ati$e (orGs thereo .

"?ontri)ution" shall mean any 'orG o authorship including the original $ersion o the (orG and any modi ications or additions to that (orG or eri$ati$e (orGs thereo that is intentionally su)mitted to ;icensor or inclusion in the (orG )y the copyright o'ner or )y an indi$idual or ;egal ntity authoriCed to su)mit on )ehal o the copyright o'ner. Aor the purposes o this de inition "su)mitted" means any orm o electronic $er)al or 'ritten communication sent to the ;icensor or its representati$es including )ut not limited to communication on electronic mailing lists source code control systems and issue tracGing systems that are managed )y or on )ehal o the

;icensor or the purpose o discussing and impro$ing the (orG )ut excluding communication that is conspicuously marGed or other'ise designated in 'riting )y the copyright o'ner as " ot a ?ontri)ution."

"?ontri)utor" shall mean ;icensor and any indi$idual or ;egal ntity on )ehal o 'hom a ?ontri)ution has )een recei$ed )y ;icensor and su)seHuently incorporated 'ithin the (orG.

!. Irant o ?opyright ;icense. 5u)#ect to the terms and conditions o this ;icense each ?ontri)utor here)y grants to Fou a perpetual 'orld'ide non-exclusi$e no-charge royalty- ree irre$oca)le copyright license to reproduce prepare eri$ati$e (orGs o pu)licly display pu)licly per orm su)license and distri)ute the

(2


53/54

(orG and such eri$ati$e (orGs in 5ource or 2)#ect orm.

3. Irant o %atent ;icense. 5u)#ect to the terms and conditions o this ;icense each ?ontri)utor here)y grants to Fou a perpetual 'orld'ide non-exclusi$e no-charge royalty- ree irre$oca)le +except as stated in this section, patent license to maGe ha$e made use o er to sell sell import and other'ise trans er the (orG 'here such license applies only to those patent claims licensa)le )y such ?ontri)utor that are necessarily in ringed )y their ?ontri)ution+s, alone or )y com)ination o their ?ontri)ution+s, 'ith the (orG to 'hich such ?ontri)ution+s, 'as su)mitted. @ Fou institute patent litigation against any entity +including a cross-claim or counterclaim in a la'suit, alleging that the (orG or a ?ontri)ution incorporated 'ithin the (orG constitutes direct or contri)utory patent in ringement then any patent licenses granted to Fou under this ;icense or that (orG shall terminate as o the date such litigation is iled.

4. 1edistri)ution. Fou may reproduce and distri)ute copies o the (orG or eri$ati$e (orGs thereo in any medium 'ith or 'ithout modi ications and in 5ource or 2)#ect orm pro$ided that Fou meet the ollo'ing conditions:

+a, Fou must gi$e any other recipients o the (orG or eri$ati$e (orGs a copy o this ;icenseJ and

+), Fou must cause any modi ied iles to carry prominent notices stating that Fou changed the ilesJ and

+c, Fou must retain in the 5ource orm o any eri$ati$e (orGs that Fou distri)ute all copyright patent trademarG and attri)ution notices rom the 5ource orm o the (orG excluding those notices that do not pertain to any part o the eri$ati$e (orGsJ and

+d, @ the (orG includes a " 2*@? " text ile as part o its distri)ution then any eri$ati$e (orGs that Fou distri)ute must include a reada)le copy o the attri)ution notices contained 'ithin such 2*@? ile excluding those notices that do not pertain to any part o the eri$ati$e (orGs in at least one o the ollo'ing places: 'ithin a 2*@? text ile distri)uted as part o the eri$ati$e (orGsJ 'ithin the 5ource orm or documentation i pro$ided along 'ith the eri$ati$e (orGsJ or 'ithin a display generated )y the eri$ati$e (orGs i and 'here$er such third-party notices normally appear. *he contents o the 2*@? ile are or in ormational purposes only and

do not modi y the ;icense. Fou may add Four o'n attri)ution notices 'ithin eri$ati$e (orGs that Fou distri)ute alongside or as an addendum to the 2*@? text rom the (orG pro$ided that such additional attri)ution notices cannot )e construed as modi ying the ;icense.

Fou may add Four o'n copyright statement to Four modi ications and may pro$ide additional or di erent license terms and conditions or use reproduction or distri)ution o Four modi ications or or any such eri$ati$e (orGs as a 'hole pro$ided Four use reproduction and distri)ution o the (orG other'ise complies 'ith the conditions stated in this ;icense.

D. 5u)mission o ?ontri)utions. nless Fou explicitly state other'ise any ?ontri)ution intentionally su)mitted or inclusion in the (orG )y Fou to the ;icensor shall )e under the terms and conditions o this ;icense 'ithout any additional terms or conditions.

ot'ithstanding the a)o$e nothing herein shall supersede or modi y the terms o any separate license agreement you may ha$e executed 'ith ;icensor regarding such ?ontri)utions.

K. *rademarGs. *his ;icense does not grant permission to use the trade names trademarGs ser$ice marGs or product names o the ;icensor except as reHuired or reasona)le and customary use in descri)ing the origin o the (orG and reproducing the content o the 2*@? ile.

. isclaimer o (arranty. nless reHuired )y applica)le la' or agreed to in 'riting ;icensor pro$ides the (orG +and each ?ontri)utor pro$ides its ?ontri)utions, on an " 5 @5" B 5@5 (@*L2 * ( 11 *@ 5 21 ?2 @*@2 5 2A F M@ either express or

(3


54/54

implied including 'ithout limitation any 'arranties or conditions o *@*; 2 -@ A1@ I * 1?L * B@;@*F or A@* 55 A21 % 1*@? ; 1 % 1%25 . Fou are solely responsi)le or determining the appropriateness o using or redistri)uting the (orG and assume any risGs associated 'ith Four exercise o permissions under this ;icense.

. ;imitation o ;ia)ility. @n no e$ent and under no legal theory 'hether in tort +including negligence, contract or other'ise unless reHuired )y applica)le la' +such as deli)erate and grossly negligent acts, or agreed to in 'riting shall any ?ontri)utor )e lia)le to Fou or damages including any direct indirect special incidental or conseHuential damages o any character arising as a result o this ;icense or out o the use or ina)ility to use the (orG +including )ut not limited to damages or loss o good'ill 'orG stoppage computer ailure or mal unction or any and all other commercial damages or losses, e$en i such ?ontri)utor has )een ad$ised o the possi)ility o such damages.

9. ccepting (arranty or dditional ;ia)ility. (hile redistri)uting the (orG or eri$ati$e (orGs thereo Fou may choose to o er and charge a ee or acceptance o support 'arranty indemnity or other lia)ility o)ligations and/or rights consistent 'ith this ;icense. Lo'e$er in accepting such o)ligations Fou may act only on Four o'n )ehal and on Four sole responsi)ility not on )ehal o any other ?ontri)utor and only i Fou agree to indemni y de end and hold each ?ontri)utor harmless or any lia)ility incurred )y or claims asserted against such ?ontri)utor )y reason o your accepting any such 'arranty or additional lia)ility.

2A * 1 5 ?2 @*@2 5

%% @N: Lo' to apply the pache ;icense to your 'orG.

*o apply the pache ;icense to your 'orG attach the ollo'ing )oilerplate notice 'ith the ields enclosed )y )racGets "OP" replaced 'ith your o'n identi ying in ormation. + onQt include the )racGetsR, *he text should )e enclosed in the appropriate comment syntax or the ile ormat. (e also recommend that a ile or class name and description o purpose )e included on the same "printed page" as the copyright notice or easier identi ication 'ithin third-party archi$es.

?opyright OyyyyP Oname o copyright o'nerP

;icensed under the pache ;icense ersion !.0 +the ";icense",J you may not use this ile except in compliance 'ith the ;icense.

Fou may o)tain a copy o the ;icense at

http://'''.apache.org/licenses/;@? 5 -!.0

nless reHuired )y applica)le la' or agreed to in 'riting so t'are distri)uted under the ;icense is distri)uted on an " 5 @5" B 5@5 (@*L2 * ( 11 *@ 5 21 ?2 @*@2 5 2A F M@ either express or implied. 5ee the ;icense or the speci ic language go$erning permissions and limitations under the ;icense.

Documents

Roller User Guide