• Share this article:

Updating themes

Theme updates are periodically released to introduce new features and maintain compatibility with the latest RapidWeaver addons and web browsers. You can tell if an update is available, by comparing the number shown next to the theme name in the RapidWeaver Addons Manager, versus the version number shown on the theme product page, on the ThemeFlood website.

Significant theme updates are commonly publicised via the ThemeFlood blog, the RapidWeaver forums and over social media. You are welcome to get in contact and ask if there are any forthcoming updates for themes planned or submit feature requests of your own you want considered.

Theme updates are not sent out automatically by email, because previously it was found many of the emails went missing in junk or spam mail folders. The costs were too prohibitive. Instead updates are provided for free and you're always invited to check for the availability of theme updates yourself. This helps you find and download updates at a time convenient to you.

Please always be certain that your RapidWeaver project files and addons are all backed-up before commencing any updates. You should already have Time Machine enabled on your computer and you can learn more about theme backups in the theme management article.

How themes and theme naming is handled

As of 10th February 2017, updated themes are now installed in RapidWeaver with generic names (like Flood.rwtheme, Lake.rwtheme and Wilderness.rwtheme). We no longer append the version number of the theme after the theme file name. This is to ensure each newer version of the theme you install or update to will overwrite the previous version. However the version number of the theme is still shown to you in the RapidWeaver Addon Manager.

This change has come about to ensure our themes will work more reliably with automated update checking utilities, like the theme update checker in RW7 and the Waterfall plugin by Nimblehost. It will prevent the problem of many dozens of themes showing as needing updates, when you might already have the latest theme version already installed at the top of the list.

As always, our advice remains that you work from duplicated / renamed themes, if you do not want updates to undo modifications (like custom banner images stored in the theme or code modifications in custom.css or custom.js files). It is always better to keep the original theme installed as a 'master' that can fetch your updates. Only apply project files to these 'master' themes if you're not making any modifications directly to the theme files.

Getting theme updates

Nearly all of our theme updates are FREE for existing customers; this is a major benefit of using ThemeFlood RapidWeaver themes. For themes you have purchased after 1st January 2015, simply login to your secure Paddle Account (documented in detail below) to access download links. These download links always point to the latest version of the theme.

If you purchased a theme before 1st January 2015, you most likely purchased the theme via E-Junkie. We no longer use E-Junkie, and therefore any older E-Junkie download links you were emailed will not work. You will instead need to get in contact via the ThemeFlood support page and provide a copy of your PayPal, GoogleCheckout or E-Junkie receipt (or E-Junkie download link). This can then be exchanged for a 100% coupon code that you can use to re-buy the theme with.

The other option for getting updates is to use automated tools; like Nimblehost Waterfall or the theme update checker that was introduced in RapidWeaver 7.3. Both of these tools will check our theme appcast server for any pending theme updates and download the themes.

What if I have duplicated / renamed a theme?

Once you duplicate and rename a theme in RapidWeaver, it is given a special flag to exclude it from automatic update checking. Going forward, the only way to update the theme would be to open the theme contents in Finder and physically copy any changed files across into the new version.

Updating themes using your Paddle Locker

If you purchased themes on or after 10th January 2015, you were invited to provide your email address and a password during the checkout process. With these login credentials, you can access your Paddle Locker. Paddle is the payment and shopping cart provider used on the ThemeFlood and Stacks4Stacks websites. Once you're logged into your secure locker, you can easily re-download themes again. The download links always point to the latest version of the theme. You can change your email address or password at any time in your Paddle Locker too.

Paddle Locker

Of note: if you obtained your copy of a theme before 10th January 2015, you may need to be issued with a new download link. E-Junkie download links no longer work, because changes to taxation laws in Europe (relating to digital downloads) forced us to change the checkout provider from E-Junkie to Paddle. Please get in contact via email and provide details of the theme update(s) you want and provide proof of purchase. Proof of purchase can comprise of your invoice or receipt; or alternatively the name and email address of the purchaser. If no proof of purchase can be located, please purchase the latest version of the theme from the ThemeFlood website.

Updating themes using Waterfall

Waterfall is a small plugin for RapidWeaver, available to purchase from the Nimblehost website. A screenshot of the plugin is pictured below. Waterfall is added to your project as a new page. It lists all the third-party addon themes you've got installed within RapidWeaver and attempts to check for any available updates.

Waterfall theme updater

Theme companies like ThemeFlood have special 'appcast servers' which maintain a list of theme names and version numbers. The Waterfall plugin connects to these servers securly to check for updates. Waterfall will flag any themes that it finds updates for.

Although there have been notworthy discussions in the news recently about security vulnerabilities associated with the Sparkle software update mechanism (that Waterfall and our appcast servers make use of) it is important to remember that RapidWeaver addons are not executable software and therefore cannot cause harm to your computer! The ThemeFlood appcast server has always used SSL encryption and security certificates.

 

 

Currently waterfall will download and install the latest versions; which will be ready the next time you restart RapidWeaver. Older versions of themes will be moved into the /Waterfall/Backups/ folder, in your RapidWeaver addons folder. This may lead RapidWeaver to complain that the theme you were last using is missing. You can resolve this issue by clicking RapidWeaver > Manage Addons in the RapidWeaver menu. Navigate into the /Waterfall/Backups/ folder, where you'll find older copies of your themes. Typically you're see the theme name, with _backup_2016-01-67-47 or similar appended after the name:

Waterfall backups folder

Copy and paste the backup to your desktop and delete everything in the folder name after .rwtheme. Finder will ask if you want to change the file name extension, and you choose to use the .rwtheme extension:

Waterfall file names

At this point, you can just double-click to reinstall the theme again.

If you prefer, you can choose to use Waterfall purely as an update checker and continue to download available theme updates from your Paddle Locker.

Please note that Waterfall update checking only works on ThemeFlood themes installed after 10th January 2015. Free demo versions of themes and copies of themes installed before 10th January 2015 will not check for updates automatically. Waterfall will only update original themes; those which you have previously duplicated and renamed for modification will not be updated.

Provide Feedback

Please use this form to provide feedback about this particular knowledgebase article. For example; to report broken links, errors or things you think could be worded better. We welcome all constructive feedback. All fields are required.

 

Feedback is submitted anonymously (unless you otherwise provide your name or contact details). We don't promise to reply to every feedback message received; neither is this a good place to request technical support. You can continue to request one-to-one support through the ThemeFlood website. See getting in contact for details.