由于很忙,主要是在roller上做二次开发,一直没有时间总结一下心得。有很多内容想记录下来,但感觉太多,太乱,没有很好的组织,一直就放着。今天简单说一下吧,希望对别人有点帮助。
如果你用roller做个博客网站,那么原来的主题模板肯定是不够用的,而且给你的业务没有关系,用起来那是相当的别扭。那么,如何为roller增加新的主题呢?下面就step-by-step吧。
这里说的是增加roller的共享主题,其他的就不说了。
1、 在拷贝已有的主题上修改。
不知道别人是怎么用roller的,我是放到ide里开发的,自己做了一些目录结构上的变更。在roller源代码rar包里apache-roller-src-4.0.1\apps\weblogger\web\themes目录下,拷贝一个子目录重命名(保证部署后war里面有这个命名后的目录)。比如我们拷贝sotto目录,重名为abc
在abc目录先把文件名带有sotto的改为abc,文件内容也是。这样就可以增加一个共享主题啦。但跟原来的sotto是一样的,有什么意义呢?你需要做的工作还是很多。比如修改样式、换个图片等等,这些都是比较简单的工作。比较难一点的请看第二步。
2、 增加一个新的展现页面
你的博客业务本来跟roller就不一样,如果一样就不需要继续看了。那么有什么不同呢?比如你的博客需要加一个关于博主介绍的页面,就是加个aboutme的连接。这个页面内容、展现方式和其他页面都不一样,这时你需要一个单独的网页模板来展现。
在abc目录下拷贝permalink.vm重命名为aboutme.vm,其中permalink.vm是展现一篇日志的页面模板。你认为aboutme有什么内容和展现方式就自己修改aboutme.vm吧。
仅有模板是不够的,还要让roller理解你这个http://xxxx.com/zhangsan/aboutme/这个连接,它才能根据你的指示来展现aboutme.vm.。那么怎么做呢?
3、修改theme.xml文件
拷贝permalink节点修改
<template action="aboutme"> <name> aboutme </name> <description> aboutme </description> <link></link> <navbar>false</navbar> <hidden>true</hidden> <templateLanguage>velocity</templateLanguage> <contentType>text/html</contentType> <contentsFile> aboutme.vm</contentsFile> </template>
4、 修改java文件
修改那些文件我会列出来,但为什么修改就不做解释了。自己去看源代码,或者看我之前写的博客,o(∩_∩)o…。
A、修改ThemeTemplate接口,增加一个页面名字action常量。
public static final String ACTION_MEMBERS = "aboutme"; public static final String[] ACTIONS = { ACTION_WEBLOG, ACTION_PERMALINK, ACTION_SEARCH, ACTION_TAGSINDEX, ACTION_ABOUTME };
B、修改WeblogPageRequest类,增加一个分支判断让其不要抛出异常
} else if ("aboutme".equals(this.context)) { /** 增加一个页面 */ } else { throw new InvalidRequestException("context "+this.context+ "not supported, "+request.getRequestURL()); }
C、修改PageServlet类,增加一个判断,使得通过页面名字获取模板
} else if (pageRequest.getWeblogAnchor() != null) { try { page = weblog.getTheme().getTemplateByAction(ThemeTemplate.ACTION_PERMALINK); } catch (Exception e) { log.error("Error getting weblog page for action 'permalink'", e); } /** 增加一个页面 */ else if ("aboutme".equals(pageRequest.getContext())) { try { page = weblog.getTheme().getTemplateByAction(ThemeTemplate.ACTION_ABOUTME); } catch (Exception e) { log.error("Error getting weblog page for action 'permalink'", e); } }
D、修改WeblogPageCache类的generateKey方法,目的是使得roller能为新的页面模板生成唯一的key,以便缓存后能定位到。
/** 增加一个页面 */ if("aboutme".equals(pageRequest.getContext())) { key.append("/aboutme/"); }
通过这个过程就可以创建一个共享主题模板了。
另外由于WeblogPageRequest的构造函数代码的原因,连接最好是http://xxxx.com/zhangsan/aboutme/xx否则将抛出异常,因为roller要通过url来获取参数。