@header@
Upgrade Notes

If upgrading to a newer version of Pebble, please ensure that your application/web server working/temporary directories are empty to prevent the following problems occurring.

  • Compilation errors from JSPs in the supplied themes.
  • Previous versions of pages displayed.
Also, it is recommended that you set your theme back to default as theme incompatibilities between versions can generate errors that are hard to track down and vary between application servers. You should then only start to upgrade your theme or customize an existing one when Pebble has been upgraded.

From 1.8 to 1.9

After logging in, you will need to convert flat categories to hierarchical categories by using the link on the Utilities page. Following this, you should rebuild your search index so ensure it is up to date. Pebble 1.8 themes are more or less compatible, albeit there are a few minor non-functional look and feel tweaks. The only major change is in the way that categories are displayed in the header of the page (you may get "All" twice). To fix this, substitute the following block in your template.jsp file

<div id="categories">
  ...
</div>

with

<%@ include file="/common/jsp/categories.jspf" %>


To add a link to the advanced search feature, you can use the following code: <a href="search.action"><fmt:message key="search.advancedSearch" /></a>

Copy the following styles from the new default/theme.css into your own theme and customise as necessary : .tags, .tags a:link, .tags a:visited, .tags a:active, .tagCloud, .tagCloud1 to .tagCloud10

From 1.7.2 to 1.8

If you've customized the default template, you will find that the list of selected categories at the top of the page no longer works. To fix this, copy the <div id="categories"> block from the default template (default/jsp/template.jsp) into your own version.

From 1.7.1 to 1.7.2

To initialise the IP address blacklist and whitelist used by the new IpAddressListener, use the utility provided by clicking Utilities after logging in.

From 1.7 to 1.7.1

Copy the approved, pending and rejected styles from the default theme to your own theme, if applicable.

From 1.6.1 to 1.7

Blog entry e-mail notifications are now handled using plugins. To enable this feature, add net.sourceforge.pebble.event.blogentry.EmailNotificationListener to your list of blog entry listeners.

Blog entry XML-RPC ping notifications are now handled using plugins. To enable this feature, add net.sourceforge.pebble.event.blogentry.XmlRpcNotificationListener to your list of blog entry listeners.

Comment and TrackBack e-mail notifications are now handled using plugins. To enable these features, add net.sourceforge.pebble.event.comment.EmailNotificationListener and net.sourceforge.pebble.event.trackback.EmailNotificationListener to your list of comment and TrackBack listeners respectively.

By default, the list of referers is no longer available unless you are logged in, although this can be changed. To do this, simply uncomment the viewReferers line in the /WEB-INF/classes/action.properties file and restart your server.

Assuming that your theme includes the default versions of the blogEntry.jsp, staticPage.jsp, comment.jsp and trackback.jsp : copy the item, blogEntry, comment and trackback styles from the default theme, modifying any colours, etc as necessary.

Change references from ${blog.recentResponses} to ${blog.responseManager.recentResponses} (in sidebar.jsp or rightnav.jsp). This also applies to recentComments and recentTrackBacks.

From 1.6 to 1.6.1
A new style has been added to the theme stylesheet (theme.css) and should be added into your own version if you are not using one of the supplied themes.

  .help, .help a:link, .help a:visited, .help a:active {
    color: gray;
    font-weight: bold;
    font-size: 11px;
    text-align: right;
  }

From 1.5 to 1.6
Any JSP pages that are simple JSP includes don't need upgrading. Typically, most Pebble users only change the theme.css, template.jsp and rightnav.jsp files, although here are some details on what needs changing if you've changed some of the others too.

blogEntry.jsp
Remove <pebble:inCategory> and </pebble:inCategory> tags
Change previousBlogEntry.permalink to previousBlogEntry.localPermalink
Change nextBlogEntry.permalink to nextBlogEntry.localPermalink
Change

<a href="javascript:openWindow('editBlogEntry.secureaction?entry=<c:out value="${blogEntry.id}"/>', 'editBlogEntry<%= session.getId()%>', 640, 640);" title="Edit this entry">Edit</a>

To

<a href="editBlogEntry.secureaction?entry=<c:out value="${blogEntry.id}"/>" title="Edit this entry">Edit</a>

rightnav.jsp
Rename rightnav.jsp to sidebar.jsp
Change viewDailyStatistics.action to viewReferers.action
Change

<c:forEach var="recentDailyBlog" items="${blog.recentDailyBlogs}" >
  <c:forEach var="recentDailyBlogEntry" items="${recentDailyBlog.entries}" >
    <div class="small">
      <a href="<c:out value="${recentDailyBlogEntry.permalink}"/>" title="Link to this entry"><c:out value="${recentDailyBlogEntry.title}"/></a>
    </div>
  </c:forEach>
</c:forEach>

To

<c:forEach var="recentBlogEntry" items="${blog.recentBlogEntries}" >
  <div class="small">
    <a href="<c:out value="${recentBlogEntry.permalink}"/>" title="Link to this entry"><c:out value="${recentBlogEntry.title}"/></a>
  </div>
</c:forEach>

Instead of showing just the recent comments, you can now additionally show recent TrackBacks or a combined list of recent responses. See the /jsp/sidebar.jsp page in the default theme for the code for this.

template.jsp
Change <jsp:include page="rightnav.jsp"/> to <jsp:include page="sidebar.jsp"/>

@footer@