This is for more advanced users.
/conf folder there is a file called
upgrade_policy_sample.conf. It is recommended that you copy and rename this file to
This will allow b2evolution to perform an Auto Upgrade:
- without leaving unwanted files on your server;
- without overwriting file you don’t want to overwrite (e-g:
In this file you can give all kinds of instructions to b2evolution as to how to handle files during upgrade. Look at the comments in the file for more information.
The default behaviour is that b2evolution will use all the files of the downloaded new version and overwrite your old files with those new files. You can use several commands to force b2evolution to ignore some files or put them in different places.
Here are the possible commands you can use in the file:
Commands that control how the newly downloaded files are processed
- ignore : will ignore a file or a directory from the new version (this file or directory will not be copied to your site). This also means that if you have an old or customized version of this file on your site, it will stay there, untouched.
- softmove : will move a file from the new version to another location than the default location on your site. "soft" means, it will not overwrite any destination file that is already in place.
- forcemove : will move a file from the new version to another location than the default location on your site. "force" means, it will overwrite any destination file that is already in place.
Note: with softmove and forcemove, the file will be moved right after download, from the download location to the desired location without ever being copied to its default location on your site.
Commands that apply to all files present on your site, after DB upgrade
- remove : will remove any file or directory of the specified name from your site at the end of the upgrade. Use this for the install folder for example.
These are the default contents of the file:
; This file allows to configure the automatic upgrade process
; !!! DO NOT USE THIS FILE AS IS !!!
; Please check every line to make sure it fits the needs of your own website.
; supported keywords:
; ignore (file or directory path relative to source basepath)
; softmove (file path relative to source basepath) (file path relative to destination basepath)
; forcemove (file path relative to source basepath) (file path relative to destination basepath)
; remove (file or directory path relative to destination basepath)
; More info: http://b2evolution.net/man/upgrade_policy-conf
; Don't recreate files that are typically used only as starting points
; (and should probably be removed from or replaced on your site once it's in production):
; Don't put back trackback feature if it has been removed (it attracts too much spam):
; Don't create new media files for demo users:
; Ignore basic skin:
; Rename sample .htaccess files to activate them:
; the following line is no longer recommended because the upgrader needs sample.htacess to check if it has changed:
; softmove sample.htaccess .htaccess
forcemove cache/sample.htaccess cache/.htaccess
forcemove conf/sample.htaccess conf/.htaccess
forcemove cron/sample.htaccess cron/.htaccess
forcemove inc/sample.htaccess inc/.htaccess
forcemove locales/sample.htaccess locales/.htaccess
forcemove media/sample.htaccess media/.htaccess
forcemove plugins/sample.htaccess plugins/.htaccess
forcemove rsc/sample.htaccess rsc/.htaccess
forcemove skins/sample.htaccess skins/.htaccess
forcemove skins_email/sample.htaccess skins_email/.htaccess
forcemove skins_site/sample.htaccess skins_site/.htaccess
; Remove the install folder which is no longer needed after install:
; Remove folders and files that shouldn't be on a production server anyways:
; Remove obsolete features: