/conf/_advanced.php includes advanced settings for b2evolution.
To learn more about these variables, see Debugging.
$date_default_timezone for setting a default timezone, if necessary.
These are the thumbnail size definitions. This also gets used for general resizing, e.g. in the Profile Picture widget.
$thumbnail_sizes = array( 'fit-1280x720' => array( 'fit', 1280, 720, 85 ), 'fit-720x500' => array( 'fit', 720, 500, 90 ), 'fit-640x480' => array( 'fit', 640, 480, 90 ), 'fit-520x390' => array( 'fit', 520, 390, 90 ), 'fit-400x320' => array( 'fit', 400, 320, 85 ), 'fit-320x320' => array( 'fit', 320, 320, 85 ), 'fit-256x256' => array( 'fit', 256, 256, 85 ), 'fit-192x192' => array( 'fit', 192, 192, 85 ), 'fit-160x160' => array( 'fit', 160, 160, 80 ), 'fit-160x160-blur-13' => array( 'fit', 160, 160, 80, 13 ), 'fit-160x160-blur-18' => array( 'fit', 160, 160, 80, 18 ), 'fit-160x120' => array( 'fit', 160, 120, 80 ), 'fit-128x128' => array( 'fit', 128, 128, 80 ), 'fit-80x80' => array( 'fit', 80, 80, 80 ), 'crop-480x320' => array( 'crop', 480, 320, 90 ), 'crop-256x256' => array( 'crop', 256, 256, 85 ), 'crop-192x192' => array( 'crop', 192, 192, 85 ), 'crop-128x128' => array( 'crop', 128, 128, 85 ), 'crop-80x80' => array( 'crop', 80, 80, 85 ), 'crop-64x64' => array( 'crop', 64, 64, 85 ), 'crop-48x48' => array( 'crop', 48, 48, 85 ), 'crop-32x32' => array( 'crop', 32, 32, 85 ), 'crop-15x15' => array( 'crop', 15, 15, 85 ), 'crop-top-320x320-blur-8' => array( 'crop-top', 320, 320, 80, 8 ), 'crop-top-320x320' => array( 'crop-top', 320, 320, 85 ), 'crop-top-200x200' => array( 'crop-top', 200, 200, 85 ), 'crop-top-160x160' => array( 'crop-top', 160, 160, 85 ), 'crop-top-80x80' => array( 'crop-top', 80, 80, 85 ), 'crop-top-64x64' => array( 'crop-top', 64, 64, 85 ), 'crop-top-48x48' => array( 'crop-top', 48, 48, 85 ), 'crop-top-32x32' => array( 'crop-top', 32, 32, 85 ), 'crop-top-15x15' => array( 'crop-top', 15, 15, 85 ), );
The params for each defined size are:
- type :
- fit will preserve the image dimensions ratio and reduce the image to make it fit into the specified dimensions
- crop will crop exactly to the required dimensions
- crop-top will crop by using preferably the top of picture (where the faces tend to be, when cropping vertical pictures)
- width (or max height in case of "fit")
- height (or max height in case of "fit")
- quality (for JPEG compression)
- percent of blur effect
See: Image Size.
$demo_mode: If enabled, this will enable Demo mode where:
- updating of files in the file manager is not allowed
- changes to the ‘demouser’ and ‘admin’ account/group is not allowed
- Blog media directories can only be configured to be inside of the media path
$allow_install_test_features: If enabled, this will create additional demo contents and enable more features during installation. This may result in an overloaded/bloated blog.
$home_url: URL of the Home link at the top left. By default, this is the same as the base URL and unless you do a complex installation, there is no need to change this.
$resample_all_images: By default, images get copied into b2evo cache without resampling if they are smaller than requested thumbnails.
If you want to use the BeforeThumbCreate event (such as the case with the Watermark Plugin), this should be set to
true to make sure that smaller images are also processed.
$instance_name : It is very important to change this if you run multiple installations of b2evolution on the same webserver and/or on the same domain. Failure to use unique instance names for multiple b2evolution installations on the same server/domain may result in:
- Cookie conflicts and impossibility to log in and/or log out
- Cache (APC, memcache, etc.) conflicts and blocks of content from one system appearing on the other!
$obhandler_debug: When debugging obhandler functions, we may need to stop polluting the output with debug info.
Set this to
true to prevent displaying minor changing elements (like time) in order not to have artificial content changes
$cookie_path: This is the path that will be associated with cookies. That means cookies set by this b2evo install won’t be seen outside of this path on the domain below. This applies only to the backoffice. For the front-office, the URL will be dynamically generated by function
$cookie_domain: That means cookies set by this b2evo install won’t be seen outside of this domain.
$cookie_session: Name used for session cookies.
$cookie_url: Names used for other cookies.
$cookie_expires: Expiration for comment meta data cookies. Note that user sessions use different settings (config in admin). Value in seconds, set this to
0if you wish to use non permanent cookies (erased when browser is closed).
$cookie_expired: Expired-time used to erase comment meta data cookies. Note: user sessions use different settings (config in admin)
$crumb_expires: Crumb expiration time
For all these, please see: Troubleshooting Cookies.
$pagecache_max_age: Page cache expiration time. This controls how old can a cached object get before we consider it outdated.
$dummy_fields; An associative array of dummy field names to obfuscate spam bots. We use funky field names to defeat the most basic spam bots in the front office public forms.
$dummy_fields = array( 'login' => 'x', 'pwd' => 'q', 'pass1' => 'm', 'pass2' => 'c', 'email' => 'u', 'name' => 'i', 'url' => 'h', 'subject' => 'd', 'content' => 'g' );
- You should only move these around if you really need to.
- You should keep everything as subdirectories of the base folder
$baseurlwhich is set in
_basic_config.php, default is the
- Remember you can set the baseurl to your website root
$force_upload_forbiddenext: File extensions that the admin will not be able to enable in the Settings
$admins_can_manipulate_sensitive_files: set to
true to allow admins to upload/rename/edit files that are considered sensitive file types. See Allow upload setting in File Type Editing.
The admin can configure the regexp for valid file names in the Settings interface
However, if the following values are set to non empty, the admin will not be able to customize these values.
$filename_max_length controls the maximum length of a file name. On new uploads file names with more characters are not allowed. The default value for this parameter is 64.
$dirpath_max_length controls the maximum length of a file absolute path is controlled by the value assigned to
$dirpath_max_length. Creating folders/files with longer path then this value is not allowed.
- 247 is the max length of an absolute path a PHP file operation functions can handle on Windows.
- On UNIX systems, the file path length is not an issue, so we can allow a higher value. The OS independent max length is 767, because that is what b2evolution can handle correctly.
$filemanager_allow_dotdot_in_filenames: Allows double dots in file names. Use
true if you want to allow
.. in file and directory names like
$debug_xmlrpc_logging: Set this to
1 to log XMLRPC calls received by this server into
$pwdchange_request_delay: Password change request delay in seconds. Only one email can be requested for one login or email address in each second defined.
$enabled_password_drivers: List what drivers must be enabled on your server. By default, only the first driver (which is supported by the server configuration) will be used to store new updated passwords in the DB. Possible driver values are:
- evo_md5 (Use this driver as last choice only)
$tags_dash_fix: Enable a workaround to allow accessing posts with URL titles ending with a dash (workaround for old bug).
$use_hacks: Use hacks file. See
$failed_logins_before_lockout: Maximum number of failed login attempts before account lockout.
$failed_logins_lockout: Length of time the account is locked out in seconds.
$reserved_logins: list of logins that are reserved ( admin, administrator, webmaster, etc. ). Normal users can’t register with these and can’t change their current login to one of these. Only User Admins with permission to modify other users can assign these logins.
Most of the time, the best security practice is to NOT allow redirects from your current site to another domain. That is, unless you specifically configured a redirected post. If this doesn’t work for you, you can change this security policy here.
$allow_redirects_to_different_domain = 'only_redirected_posts';
- ‘always’ : Always allow redirects to a different domain
- ‘all_collections_and_redirected_posts’ ( Default ): Allow redirects to all collection domains, ALL SUB-DOMAINS of
$basehostor redirects of posts with redirected status
- ‘only_redirected_posts’: Allow redirects to a different domain only in case of posts with redirected status
- ‘never’ : Force redirects to the current domain in all case, and never allow redirects to a different domain
Turn this on to simulate email sends instead of really sending them through SMTP.
This is useful if you are debugging a production database on a development machine.
It will prevent from sending test notifications to real user accounts.
You will still be able to see the emails that would have been sent through the Emails > Sent tab in the back-office.
Turn this off to prevent sending of emails if no external SMTP gateway is configured.
true and no SMTP gateway is configured, b2evolution will behave the same as with
$email_send_simulate_only = true;
This is useful to avoid sending email (especially campaigns) through a bad IP by mistake.
$use_cdns: Set to
trueto use CDNs as defined in the array
$library_cdn_urls: let you decide which CDNs to use for loading common libraries. Each line starts with the js or css alias. The first string is the production (minified URL), the second is the development URL (optional). If you don’t want to use a CDN and want to use the local version, comment out the line.
Example ( only a few positions included in this page, you can find all the options directly in the file ) :
$library_cdn_urls = array( '#jquery#' => array( '//code.jquery.com/jquery-1.11.1.min.js', '//code.jquery.com/jquery-1.11.1.js' ), //'#jqueryUI#' => array( '//code.jquery.com/ui/1.10.4/jquery-ui.min.js', '//code.jquery.com/ui/1.10.4/jquery-ui.js' ), //'#jqueryUI_css#' => array( '//code.jquery.com/ui/1.10.4/themes/smoothness/jquery-ui.min.css', '//code.jquery.com/ui/1.10.4/themes/smoothness/jquery-ui.css' ), '#bootstrap#' => array( '//netdna.bootstrapcdn.com/bootstrap/3.0.0/js/bootstrap.min.js', '//netdna.bootstrapcdn.com/bootstrap/3.0.0/js/bootstrap.js' ), );
$library_local_urls: The aliases for all local JS and CSS files that are used when CDN url is not defined in $library_cdn_urls. It has the same structure than
Example ( only a few positions included in this page, you can find all the options directly in the file ) :
$library_local_urls = array( '#jquery#' => array( 'jquery.min.js', 'jquery.js' ), '#jqueryUI#' => array( 'jquery/jquery.ui.b2evo.min.js', 'jquery/jquery.ui.b2evo.js' ), '#jqueryUI_css#' => array( 'jquery/smoothness/jquery-ui.b2evo.min.css', 'jquery/smoothness/jquery-ui.b2evo.css' ), );
$library_cdn_urlswill have precedence over the same libraries declared in
$library_local_urls. There is no fallback between them, which means that if a library can’t be loaded from a remote CDN, you must exclude it from the first array in order to load the local copy.
$allow_post_pings_on_localhost: Allow sending of outbound pings on localhost.
Set these if you need b2evolution to use a proxy for all outbound communications, like auto-upgrade, pinging b2evolution.net or twitter, etc.
Leave empty if you don’t want to use a proxy.
$check_browser_version: Check for old browsers like IE and display info message. Set to
false if you do not want this check and never inform users if they use an old browser.
$max_skin_api_version: Maximum skin API version which is supported by current version of b2evolution. Skin API version is defined in the method
Skin::get_api_version() of each skin.
$enable_blacklist_server_API: Set to
trueif the server should be used as central antispam server.
$tinymce_content_css: This is for plugins to add CS files to the TinyMCE editor window.
Created by • Last edit by on Oct 08, 2019