Apache Roller 4.0 – Beginner's Guide — Save 50%
A comprehensive, step-by-step guide on how to set up, customize, and market your blog using Apache Roller
There are times when logging into your Roller weblog to post a new entry can be a tedious process, especially when you have two or more weblogs about different subjects. Let's say that you have to write stuff in your company's blog, and you also write in your personal Roller blog. You can open two web browser windows and log into each blog separately, but it would be better to use a weblog client, as I'll show you in the next exercise.
Time for action – using Google docs as your weblog client
In this exercise, you'll learn to use Google docs as your weblog client to post entries in your Roller weblogs without having to log in:
- Open your web browser, go to http://docs.google.com, log in with your username and password (if you don't have a Google account, this is your chance to get one!), then click on the New button, and select the Document option:
- Your browser will open a new tab for the new Google docs document. Type This is my first post to my Roller weblog from Google Docs! in the word processor writing area, as shown in the following screenshot:
- Now click on the File menu and select the Save option to save your draft in Google docs:
- Google docs assigns the title for your document automatically, based on its content. To change the title of your post, click on it:
- Type Posting to Roller from Google Docs in the dialog that will show up next, and click on OK to continue:
- Google docs will show the new title for your post:
- Now click on the Share button and select the Publish as web page option:
- The Publish this document dialog will appear. Click on the change your blog site settings link to enter your Roller weblog information:
- The Blog Site Settings dialog will appear next. Choose the My own server / custom option and select MetaWeblog API in the API field. In the URL field you need to type the complete path to Roller's web services—http://alromero.noip.org/roller/roller-services/xmlrpc, in my case. You just need to replace the alromero.no-ip.org part with your dynamic hostname. Then type your Roller username, password, and weblog name, and select the Include the document title when posting option, as shown in the following screenshot:
- Click on the OK button to save your weblog settings, and then click on the Post to blog button in the Publish this document dialog:
- A confirmation dialog will pop-up, asking if you want to post the document to your blog now. Click on OK to continue:
- Google docs will show the This document has been published to your blog success message:
- Click on the Save & Close button at the upper-right part of the screen to save your document and return to the Google docs main page, then click on Sign out to exit Google docs. Now go to your Roller weblog's main page, to see the post you published from Google docs:
What just happened?
See how easy it is to use a weblog client, so that you don't need to log into your Roller weblog to post a new entry? And if you want to post to a different Roller weblog, you just need to change your username, blog ID, or URL. There are several other weblog clients available that you can use, depending on your operating system, but all weblog clients work in a similar way.
Have a go hero – try out other weblog clients
Go and try out some other weblog clients, to see which one is best for you. In Windows, you can use Windows Live Writer (http://download.live.com/writer) and w.bloggar (http://bloggar.com/). In Linux, you can try out BloGTK (https://launchpad.net/blogtk/).
eBook Price: $26.99
Book Price: $44.99
How about having your very own weblog community? Well, Roller is prepared to assist you in that matter. Planet Roller is an aggregator that takes care of all the stuff required to run your community blog server. You just have to invite other people to join in as Roller users, and you can even include external blogs related to your community's content! Stick with me and I'll show you how easy it is to create a Roller weblog community.
Time for action – using Planet Roller
In this exercise, you'll learn to enable and use the Planet Roller aggregator to run your own community of weblogs:
- If you're using Linux, create a directory named roller_data inside your home directory, and then create a directory named planetcache inside roller_data (for example, I'm using /home/ibacsoft/roller_data/planetcache). You also need to give permission to the Tomcat user to write in this directory (use sudo chown –R tomcat:tomcat /home/ibacsoft/roller_data). In Windows, you can use C:roller_dataplanetcache, and you don't need to assign special permissions to the directory.
- Open the roller-custom.properties file located inside Roller's WEB-INF/classes directory, and add the following lines at the end (the following code is for a Linux installation; if you're using Windows, make sure to change the correct path to the planetcache directory):
# Tasks which are enabled. Only tasks listed here will be run.
# Set of page models specifically for site-wide rendering
- Now create a new file named planet-custom.properties in the same directory as roller-custom.properties, and type the following lines inside this file (remember to change the path in cache.dir when using Windows):
- Save the file and restart Tomcat to apply the changes. Then open your web browser and log into your Roller weblog using the following URL: http://alromero.no-ip.org/roller/roller-ui/admin/globalConfig.rol. Once you type your username and password, Roller will take you directly to the Roller Configuration page:
- Click on the Planet Admin tab and use the following screenshot as a guide to fill in the required fields:
- Click on Save when finished. Roller will show the Saved Planet configuration message inside a green box. Now click on the Main Menu link from Roller's menu bar and then on the Settings link in your frontpage blog:
- The Weblog Settings page will appear next. Click on the Design tab to go to the Weblog Theme page, and select the Custom Theme option:
- Scroll down the page and click on the Update Theme button to continue. Now click on the Templates link and then select the Weblog template:
- Scroll down the page until you locate the ## 1) SITE-WIDE entries (the default) line, then change the #set($pager = $site.getWeblogEntriesPager($since, $maxResults)) line to ## set($pager = $site.getWeblogEntriesPager($since, $maxResults)), and the ## set($pager = $planet.getAggregationPager($since, $maxResults)) line to #set($pager = $planet.getAggregationPager($since, $maxResults)), as shown in the following screenshot:
- Click on the Save button when finished. Now click on the Main Menu link from Roller's menu bar and then click on the Planet administration link under the Actions panel:
- The Planet Configuration page will appear next. Click on the Subscriptions link and then type http://rollerweblogger.org/project/feed/entries/rss in the Newsfeed URL field:
- Click on the Save button to add the Roller Weblogger RSS feed to your Planet aggregator. Now type http://www.packtpub.com/rss.xml in the Newsfeed URL field and click on Save again to add the Packt Publishing newsfeed:
- Now you just have to wait until Roller starts to aggregate content from the Packt Publishing and Roller Weblogger newsfeeds. The following screenshot shows my Roller Planet aggregator in action, listing content from Roller and from the Packt Book Feed:
What just happened?
Your very own Planet Roller aggregator! Congratulations! You can also add some more external newsfeeds to keep your community engaged in their topics of interest. This is a great way to collaborate with bloggers from other communities, and you can also use trackbacks and comments to interact!
Have a go hero – spice up your Planet Roller
Edit the Frontpage template to your liking: change the logo, add some Flash animation, change the background/foreground color, and so on. Check out some other aggregators to get fresh ideas about how to display your aggregator's information in a cool way for your visitors!
I hope this article was as entertaining for you to read as it was for me to write. There are a lot of subjects I didn't cover because of space restrictions.
Specifically, we covered:
- How to manage group blogs, create new users, and enable a front page weblog to show all the recent entries from all the users' weblogs
- How to use aggregators and blog search engines such as Technorati to promote your Roller weblog via automatic pings
- How to configure Google webmaster tools to find out about visitors to your blog, popular keywords used, and potential errors
- How to use podcasts in your weblog entries to attract visitors that use podcatcher software such as iTunes
- How to use Google docs as a weblog client to publish entries in your Roller weblog, without having to log in
- How to use the Planet Roller aggregator to show external feeds from other blogs, along with all the weblogs in your Roller server
If you have read this article you may be interested to view :
- Advanced Blog Management with Apache Roller 4.0: Part 1
- Advanced Blog Management with Apache Roller 4.0: Part 2
- Creating a Roller theme from scratch using Apache Roller 4.0
- Working with Templates in Apache Roller 4.0
- Velocity Model and Data Objects in Apache Roller
- Spicing Up Your Blog: Uploading Files and Images to your Weblog using Apache Roller
eBook Price: $26.99
Book Price: $44.99
About the Author :
Alfonso Romero is a freelance computer consultant and translator from Mexico. He's been working with Linux and open source software since 1999. He started operating his first web server (Apache) from a PC at home, offering free hosting services to experiment with Postfix, Squirrel Mail, MySQL, Apache, Tomcat, and Virtual Hosting. Since then, he's been working as a computer consultant for several clients in Mexico – writing Java, C++, and Web applications. Since 2000, he has worked for Pearson Education in Mexico as a computer books freelance translator and consultant. His latest book translations are the Spanish versions of Java How to Program, Seventh Edition, from Deitel & Deitel, and C++ How to Program, Sixth Edition, also from Deitel & Deitel. Al enjoys writing tutorials and teaching about Java, C++, PHP, the Apache Web server, Tomcat, MySQL, Web applications like Apache Roller, and all of the wonderful open source applications used today, and when he's not experimenting with new trends in Open Source applications, he enjoys playing his electric guitar.