Roller Developer Resources
This page offers a list of guides, howtos, and other resources to help developers who are working on the Roller source code.
How to contribute to Roller Explains how to contribute, what a committer is, etc. Read this if you want to figure out how to get your changes into Roller or if you'd interested in helping out with any other aspects of Roller.
Building and Deploying Roller A guide on how to get the Roller source code from our subversion repository, how the code is laid out and where to look for things, what the standard build process includes, and how to run the unit tests. This should be the first thing you read if you are planning to work on the Roller code base at all.
Release Process This document describes the process that the Roller team uses to propose new releases, make milestone builds, make final releases and how we use the SVN trunk, branches and tags.
How to create a Roller theme Two part series on how to create a new Roller theme:
How to add new model objects How to make new data available to Roller template authors TBD. For now, check out the ApacheCon 2007 presentation. Also, this email explains how to find and use an example object plugin with docs.
How Authentication Works in Roller - (work in progress) explains how user authentication and authorization works in Roller.
Struts2 Migration Guide Information about the Struts1 -> Struts2 migration work that we did for the Roller 4.0 release. Useful for those trying to understand how Roller's Struts2 actions work.
Working with Apache Roller source code - (April 2014) Blog article by Glen Mazza providing set-up suggestions for coding Roller.
ApacheCon EU 2008 (1.2MB PDF) - Covers advanced Roller topics including: Advanced installation, Page and feed caching, Authentication options, Deployment architecture, Caching with Memcached, Scripting and automation and Plugging in new functionality.
June 2007 - Introduction to Apache Roller (5.1mb PDF)
Slides from a Webinar Matt Raible did for Covalent. This presentation covers Roller 3.1 and explains what Roller is, how to install it, and how to customize it. Other links (registration required): PowerPoint and Recording - 57 min.
ApacheCon 2007 - Roller and blogs as a web development platform (1.6mb PDF)
In this session how to use blogs as a development platform. You'll learn about standards-based approaches that use RSS, Atom and XML-RPC and some approaches specific to the Roller blog server. You'll learn how to use web services to automate web publishing, how to use blog server plugins to integrate new sources of data into your blog server, how generate dynamic feeds with JRuby in Roller and how to use a planet server to create custom feeds for your applications.
ApacheCon 2006 - Apache Roller: an open source Java blog server (1.3mb PDF)
Roller is the open source Java blog server that drives the popular Sun's employee blogs at blogs.sun.com, IBM developerWorks blogs, JRoller.com and numerous other blog sites. Currently making its way through the Apache incubation process, Roller is built on a host of Apache technologies including Struts, Velocity, Lucene, Jakarta Commons, XMLRPC and more. This overview, a primer for Roller users and contributors, covers the Roller feature set, the all-new Roller 3.0 page models/macros, Roller 3.0 architecture, lessons learned, project status and future plans.
Roller data model diagram
There is a data model diagram at the bottom of the POJO package page here: