Updates to blojsom are made available from the download section of the SourceForge site. Download the appropriate blojsom-(blojsom version)-update.zip and follow the instructions for the particular version of blojsom accordingly.

Upgrading from blojsom 2.31 to blojsom 2.32

JAR file changes should be made in your /WEB-INF/lib directory unless otherwise indicated.

Upgrading from blojsom 2.30 to blojsom 2.31

JAR file changes should be made in your /WEB-INF/lib directory unless otherwise indicated.

1. If you are using the Delicious Daily Posting plugin, you will want to upgrade to the delicious-java-1.13.jar library.
2. If you are using the Akismet Moderation plugin, you will want to upgrade to the akismet-java-1.02.jar library.

Upgrading from blojsom 2.29 to blojsom 2.30

JAR file changes should be made in your /WEB-INF/lib directory unless otherwise indicated.

1. Add the following to /WEB-INF/plugin.properties to enable the new plugins.

   collection-utilities=org.blojsom.plugin.common.CollectionUtilitiesPlugin

2. If you are using the Akismet Moderation plugin, you will want to upgrade to the akismet-java-1.01.jar library.

Upgrading from blojsom 2.28 to blojsom 2.29

JAR file changes should be made in your /WEB-INF/lib directory unless otherwise indicated.

1. Add the commons-email-1.0.jar file.
2. Add the following to /WEB-INF/plugin.properties to enable the new plugins.

   string-utilities=org.blojsom.plugin.common.StringUtilitiesPlugin

3. If you are using the Delicious Daily Posting plugin, you should upgrade the delicious-java JAR file from delicious-1.6.jar to delicious-2.0.jar.

Upgrading from blojsom 2.27 to blojsom 2.28

JAR file changes should be made in your /WEB-INF/lib directory unless otherwise indicated.

1. Replace the blojsom-XXX-2.27.jar files with the blojsom-XXX-2.28.jar files. Remove the blojsom-XXX-2.27.jar files.
2. Add the following to your /WEB-INF/plugin.properties file if you want to enable the new plugins in the core download.

   permissions-check=org.blojsom.plugin.permission.PermissionCheckPlugin

Upgrading from blojsom 2.26 to blojsom 2.27

JAR file changes should be made in your /WEB-INF/lib directory unless otherwise indicated.

1. Replace the blojsom-XXX-2.26.jar files with the blojsom-XXX-2.27.jar files. Remove the blojsom-XXX-2.26.jar files.
2. Add the following to your /WEB-INF/plugin.properties file if you want to enable the new plugins in the core download.

   xss-filter=org.blojsom.plugin.filter.XSSFilterPlugin

Upgrading from blojsom 2.25 to blojsom 2.26

JAR file changes should be made in your /WEB-INF/lib directory unless otherwise indicated.

1. Replace the blojsom-XXX-2.25.3.jar files with the blojsom-XXX-2.26.jar files. Remove the blojsom-XXX-2.25.3.jar files.
2. Add the following to your /WEB-INF/plugin.properties file to enable the new blojsom plugins.

   footnote=org.blojsom.plugin.footnote.FootnotePlugin
   tag-cloud=org.blojsom.plugin.technorati.TagCloudPlugin
   theme-upload=org.blojsom.plugin.admin.ThemeUploadPlugin

Upgrading from blojsom 2.25 to blojsom 2.25.3

JAR file changes should be made in your /WEB-INF/lib directory unless otherwise indicated.

1. Replace the blojsom-XXX-2.25.jar files with the blojsom-XXX-2.25.3.jar files. Remove the blojsom-XXX-2.25.jar files.

Upgrading from blojsom 2.24 to blojsom 2.25

JAR file changes should be made in your /WEB-INF/lib directory unless otherwise indicated.

1. Replace the blojsom-XXX-2.24.jar files with the blojsom-XXX-2.25.jar files. Remove the blojsom-XXX-2.24.jar files.
2. Move the administration sub-directory and its contents from the update .ZIP file into the directory where blojsom is installed.
3. You can now use MD5 encrypted passwords for blojsom. This is a per-blog setting. Add the following property to your blog.properties file.

   use-encrypted-passwords=true

   You may also use the encrypted password conversion utility to convert your existing authorization.properties file.
   Be sure to backup this file before doing the conversion in case anything should go wrong. Usage of the utility is as follows.

   java -cp blojsom-core-2.25.jar org.blojsom.util.password.EncryptedPasswordConversion full-path-to-authorization.properties-file

4. Add the following to your /WEB-INF/plugin.properties file to enable the new blojsom plugins.

   linkspam-moderation=org.blojsom.plugin.moderation.LinkSpamModerationPlugin
   spamphrase-moderation=org.blojsom.plugin.moderation.SpamPhraseModerationPlugin
   spamphrase-moderation-admin=org.blojsom.plugin.moderation.admin.SpamPhraseModerationAdminPlugin
   ip-moderation=org.blojsom.plugin.moderation.IPAddressModerationPlugin
   ip-moderation-admin=org.blojsom.plugin.moderation.admin.IPAddressModerationAdminPlugin
   technorati-tags=org.blojsom.plugin.technorati.TechnoratiTagsPlugin

Upgrading from blojsom 2.23 to blojsom 2.24

Library changes should be made in your /WEB-INF/lib directory unless otherwise indicated.

1. Replace the blojsom-XXX-2.23.jar files with the blojsom-XXX-2.24.jar files. Remove the blojsom-XXX-2.23.jar files.
2. You can now use MD5 encrypted passwords for blojsom. This is a per-blog setting. Add the following property to your blog.properties file.

   use-encrypted-passwords=true

   You may also use the encrypted password conversion utility to convert your existing authorization.properties file.
   Be sure to backup this file before doing the conversion in case anything should go wrong. Usage of the utility is as follows.

   java -cp blojsom-core-2.24.jar org.blojsom.util.password.EncryptedPasswordConversion full-path-to-authorization.properties-file

3. Add the following to your /WEB-INF/plugin.properties file to enable the new blojsom plugins.

   fetcher-helper=org.blojsom.plugin.fetcher.FetcherHelperPlugin
   language-selection=org.blojsom.plugin.language.LanguageSelectionPlugin
   markup-selection=org.blojsom.plugin.markup.MarkupSelectionPlugin
   pingback=org.blojsom.plugin.nofollow.PingbackPlugin
   plugin-helper=org.blojsom.plugin.helper.PluginHelperPlugin

4. You can now add a file called user-macros.vm in your blog's templates directory to add custom Velocity macros for use in your Velocity page templates. You must add this file to the list of Velocimacro library files in /WEB-INF/velocity.properties. For example:

   velocimacro.library=org/blojsom/plugin/admin/templates/admin-macros.vm,org/blojsom/plugin/velocity/page-macros.vm,user-macros.vm

Upgrading from blojsom 2.22 to blojsom 2.23

Library changes should be made in your /WEB-INF/lib directory unless otherwise indicated.

1. Replace the blojsom-XXX-2.22.jar files with the blojsom-XXX-2.23.jar files. Remove the blojsom-XXX-2.22.jar files.
2. The URL to edit your blog via XML-RPC or the Atom API must end with a trailing slash and contain the blog ID. For example, your XML-RPC URL will now look like:

   http://your.host.com/blojsom/xmlrpc/default/

   Your Atom API URL will look like:

   http://your.host.com/blojsom/atomapi/default/

   The Atom API support previously required a trailing slash after the blog ID.

3. Add the following to your /WEB-INF/plugin.properties file.

   basic-authentication=org.blojsom.plugin.security.BasicAuthenticationPlugin
   category-template=org.blojsom.plugin.categories.CategoryTemplatePlugin
   crosspost=org.blojsom.plugin.crosspost.CrosspostPlugin
   enhanced-emoticons=org.blojsom.plugin.emoticons.EnhancedEmoticonsPlugin
   nofollow=org.blojsom.plugin.nofollow.NoFollowPlugin
   weather=org.blojsom.plugin.weather.WeatherPlugin
   edit-blog-permissions=org.blojsom.plugin.admin.EditBlogPermissionsPlugin

4. Add the following to your /WEB-INF/xmlrpc.properties file.

   pingback=org.blojsom.extension.xmlrpc.handlers.PingbackHandler

5. Add the following, permissions.properties file in each of your blog configuration directories. For example, /WEB-INF/default/. For each authorized user for the blog, add the following line.

   blog-authorized-id=*

   Where blog-authorized-id is replaced with the user ID of each authorized user for your blog.

6. If you are using the Caching Fetcher, the OSCache library has been upgraded. Add the oscache-2.1.jar file to your /WEB-INF/lib directory. You may then remove the oscache-2.0.2.jar file.

Upgrading from blojsom 2.21 to blojsom 2.22

Library changes

NOTE: Library changes should be made in your /WEB-INF/lib directory unless otherwise indicated.

1. Replace the blojsom-XXX-2.21.jar files with the blojsom-XXX-2.22.jar files. Remove the blojsom-XXX-2.21.jar files.
2. Replace the velocimacro.library parameter in your /WEB-INF/velocity.properties file with the following text.

   velocimacro.library=org/blojsom/plugin/admin/templates/admin-macros.vm,org/blojsom/plugin/velocity/page-macros.vm

   This enables the set of template macros available for use in your Velocity templates.

3. Copy the quicktags.js file into your blojsom installation directory.

Upgrading from blojsom 2.20 to blojsom 2.21

Library changes

NOTE: Library changes should be made in your /WEB-INF/lib directory unless otherwise indicated.

1. Replace the blojsom-XXX-2.20.jar files with the blojsom-XXX-2.21.jar files. Remove the blojsom-XX-2.20.jar files.
2. Replace the xmlrpc-1.2-b1.jar file with the xmlrpc-1.2-b1-blojsom.jar file. Remove the xmlrpc-1.2-b1.jar file.

Upgrading from blojsom 2.19 to blojsom 2.20

Library changes

NOTE: Library changes should be made in your /WEB-INF/lib directory unless otherwise indicated.

1. Replace the blojsom-XXX-2.19.jar files with the blojsom-XXX-2.20.jar files.
2. If you are using the add-on plugin bundle, replace the radeox-0.9.jar file with the radeox-1.0b2.jar file.
   NOTE: This JAR file is included in the blojsom-2.20-addons.zip download.
3. Replace the sandler-1.01.jar file with the sandler-1.02.jar file.

Properties changes

1. Add the following line in your /WEB-INF/xmlrpc.properties file to add MovableType API XML-RPC methods support.

   mt=org.blojsom.extension.xmlrpc.handlers.MovableTypeAPIHandler

2. Add the following lines in your /WEB-INF/plugin.properties file.

   all-entries=org.blojsom.plugin.common.AllEntriesPlugin
   bookmarklet=org.blojsom.plugin.admin.BookmarkletPlugin
   rss-enclosure=org.blojsom.plugin.common.RSSEnclosurePlugin
   comment-moderation=org.blojsom.plugin.comment.CommentModerationPlugin
   trackback-moderation=org.blojsom.plugin.trackback.TrackbackModerationPlugin
   show-me-more-admin=org.blojsom.plugin.showmore.admin.ShowMeMoreAdminPlugin

Template changes

1. Copy the admin-basic.css and admin-tabs.css files to your blojsom installation directory.

Upgrading from blojsom 2.18 to blojsom 2.19

Library changes

NOTE: Library changes should be made in your /WEB-INF/lib directory unless otherwise indicated.

1. Replace the blojsom-core-2.18.jar, blojsom-extensions-2.18.jar, blojsom-plugins-2.18.jar, blojsom-resources-2.18.jar and blojsom-plugins-templates-2.18.jar with the updated blojsom-core-2.19.jar, blojsom-extensions-2.19.jar, blojsom-plugins-2.19.jar files, blojsom-resources-2.19.jar, and blojsom-plugins-templates-2.19.jar.
2. If you are using the add-on plugin bundle, remove the velocity-tools-view-1.1.jar file and replace it with the velocity-tools-1.1.jar file.

Properties changes

1. Make sure the following line is in your /WEB-INF/velocity.properties file.

   velocimacro.library=org/blojsom/plugin/admin/templates/admin-macros.vm

2. If you want to use the new Theme Switcher plugin, add the following to your /WEB-INF/plugin.properties file.

   theme-switcher=org.blojsom.plugin.admin.ThemeSwitcherPlugin

Upgrading from blojsom 2.17 to blojsom 2.18

Library changes

NOTE: Library changes should be made in your /WEB-INF/lib directory unless otherwise indicated.

1. Replace the blojsom-core-2.17.jar, blojsom-extensions-2.17.jar, blojsom-plugins-2.17.jar, blojsom-resources-2.17.jar and blojsom-plugins-templates-2.17.jar with the updated blojsom-core-2.18.jar, blojsom-extensions-2.18.jar, blojsom-plugins-2.18.jar files, blojsom-resources-2.18.jar, and blojsom-plugins-templates-2.18.jar.
2. Replace the commons-codec-1.2.jar file with the commons-codec-1.3.jar file.

Properties changes

NOTE: The following properties file change is not required.

If you are using multiple blogs on the same blojsom instance, you can separate out each blog on a separate line in your /WEB-INF/blojsom.properties file for the blojsom-users property. Previously, this property would look like:

blojsom-users=blog1, blog2, blog3

This would now be changed to look as follows:

blojsom-users=blog1
blojsom-users=blog2
blojsom-users=blog3

Upgrading from blojsom 2.16 to blojsom 2.17

Library changes

NOTE: Library changes should be made in your /WEB-INF/lib directory unless otherwise indicated.

1. Replace the blojsom-core-2.16.jar, blojsom-extensions-2.16.jar, blojsom-plugins-2.16.jar, blojsom-resources-2.16.jar and blojsom-plugins-templates-2.16.jar with the updated blojsom-core-2.17.jar, blojsom-extensions-2.17.jar, blojsom-plugins-2.17.jar files, blojsom-resources-2.17.jar, and blojsom-plugins-templates-2.17.jar.
2. Replace the sandler-0.7.jar file with the sandler-1.01.jar file.

Configuration file changes

1. The Days Since Posted Plugin and Word Count Plugin have been moved to the statistics package. The package name in your global /WEB-INF/plugin.properties will need to change from org.blojsom.plugin.common to org.blojsom.plugin.statistics.
2. Add the following to your /WEB-INF/plugin.properties file.

   reload-blog-properties=org.blojsom.plugin.admin.ReloadBlogPropertiesPlugin

Template changes

1. Copy the admin-basic.css and admin-tabs.css files to your blojsom installation directory. You can remove the blojsom-admin.css file.
2. Copy the atom.vm or atom.jsp to your individual blog's templates directory.

Upgrading from blojsom 2.15 to blojsom 2.16

Library changes

NOTE: Library changes should be made in your /WEB-INF/lib directory unless otherwise indicated.

1. Replace the blojsom-core-2.15.jar, blojsom-extensions-2.15.jar, blojsom-plugins-2.15.jar, blojsom-resources-2.15.jar and blojsom-plugins-templates-2.15.jar with the updated blojsom-core-2.16.jar, blojsom-extensions-2.16.jar, blojsom-plugins-2.16.jar files, blojsom-resources-2.16.jar, and blojsom-plugins-templates-2.16.jar.
2. Replace the commons-logging-1.0.3.jar file with the commons-logging-1.0.4.jar file.

NOTE: If you are using the CachingFetcher for enabling caching of your blog entries to serve pages faster, there is an update on the download site to the blojsom-addon-core-2.16.jar file. This fixes an issue with populating the cache correctly when linear post navigation is enabled under caching.

Configuration file changes

1. Add the following to your /WEB-INF/plugin.properties file.

   list-web-admin-plugins=org.blojsom.plugin.admin.ListWebAdminPluginsPlugin
   macro-expansion-admin=org.blojsom.plugin.macro.admin.MacroExpansionAdminPlugin
   moblog-admin=org.blojsom.plugin.moblog.admin.MoblogAdminPlugin

Template changes

1. Copy the quicktags.js file to your blojsom installation directory.

Upgrading from blojsom 2.14 to blojsom 2.15

Library changes

NOTE: Library changes should be made in your /WEB-INF/lib directory unless otherwise indicated.

1. Replace the blojsom-core-2.14.jar, blojsom-extensions-2.14.jar, blojsom-plugins-2.14.jar, blojsom-resources-2.14.jar and blojsom-plugins-templates-2.14.jar with the updated blojsom-core-2.15.jar, blojsom-extensions-2.15.jar, blojsom-plugins-2.15.jar files, blojsom-resources-2.15.jar, and blojsom-plugins-templates-2.15.jar.
2. Replace the sandler-0.6.jar (or other version) file with the sandler-0.7.jar file.
3. Replace the textile4j-1.10.jar file with the textile4j-1.20.jar file.

Configuration file changes

1. Add the following to your /WEB-INF/plugin.properties file.

   forgotten-password=org.blojsom.plugin.admin.ForgottenPasswordPlugin

Template changes

1. Replace the rss2.vm (or rss2.jsp) template in each individual user's templates directory.
2. Replace the atom.vm (or atom.jsp) template in each individual user's templates directory.
3. Add the quicktags.js file to your blojsom installation directory.