allow_avatar_uploads¶

Set whether members can upload their own avatar.

Example Usage:

$config['allow_avatar_uploads'] = 'y';

Also found in CP: Settings ‣ Avatar Settings: Allow members to upload their own avatars

allow_dictionary_pw¶

Set whether words commonly found in the dictionary can be used as passwords. Must be used in combination with name_of_dictionary_file.

Example Usage:

$config['allow_dictionary_pw'] = 'y';

Also found in CP: Settings ‣ Security & Privacy: Allow Dictionary Words as Passwords

allow_extensions¶

Set whether extensions are enabled in the system. Disabling extensions will not uninstall extensions.

Example Usage:

$config['allow_extensions'] = 'y';

Also found in CP: Utilities ‣ Debug Extensions: Disable Extensions?

allow_member_localization¶

Set whether dates and times are localized to each members’ own localization preferences.

Example Usage:

$config['allow_member_localization'] = 'y';

Also found in CP: Settings ‣ Members: Allow members to set their own localization preferences

allow_member_registration¶

Set whether site visitors are allowed to register for accounts.

Example Usage:

$config['allow_member_registration'] = 'y';

Also found in CP: Settings ‣ Members: Allow New Member Registrations

allow_multi_logins¶

Set whether an account can have multiple active sessions at one time.

Example Usage:

$config['allow_multi_logins'] = 'y';

Also found in CP: Settings ‣ Security & Privacy: Allow multiple log-ins from a single account

allow_pending_login¶

Set whether members of the Pending member group can log in or not. By default, Pending members cannot log in.

Example Usage:

$config['allow_pending_login'] = 'y';

allow_signatures¶

Set whether member signatures are enabled.

Example Usage:

$config['allow_signatures'] = 'y';

allow_textarea_tabs¶

Set whether a tab keystroke produces a tab in Publish Page and Template Editor textareas. This is the default behavior.

Example Usage:

$config['allow_textarea_tabs'] = 'y';

allow_username_change¶

Set whether members can change their own usernames after registration.

Example Usage:

$config['allow_username_change'] = 'y';

Also found in CP: Settings ‣ Security & Privacy: Allow members to change their username

app_version¶

The installation’s ExpressionEngine version.

auto_assign_cat_parents¶

Set whether to assign an entry to both the selected category and its parent category.

Example Usage:

$config['auto_assign_cat_parents'] = 'y';

Also found in CP: Settings ‣ Content & Design: Auto-Assign Category Parents

autosave_interval_seconds¶

Set the interval between autosaves on the Publish Page.

Example Usage:

$config['autosave_interval_seconds'] = '30';

autosave_prune_hours¶

Set the age at which Channel Entry autosaves are automatically deleted.

Example Usage:

$config['autosave_prune_hours'] = '4';

avatar_max_height¶

Set the maximum height (in pixels) allowed for user-uploaded avatars.

Example Usage:

$config['avatar_max_height'] = '120';

Also found in CP: Settings ‣ Avatars: Avatar Maximum Height

avatar_max_kb¶

Set the maximum file size (in kilobytes) allowed for user-uploaded avatars.

Example Usage:

$config['avatar_max_kb'] = '200';

Also found in CP: Settings ‣ Avatars: Avatar Maximum Size

avatar_max_width¶

Set the maximum width (in pixels) allowed for user-uploaded avatars.

Example Usage:

$config['avatar_max_width'] = '120';

Also found in CP: Settings ‣ Avatars: Avatar Maximum Width

avatar_path¶

Set the server path to the avatar directory.

Example Usage:

$config['avatar_path'] = '/path/images/avatars/';

Also found in CP: Settings ‣ Avatars: Server Path to Avatar Folder

avatar_url¶

Set the URL to the avatar directory.

Example Usage:

$config['avatar_url'] = 'http://example.com/images/avatars';

Also found in CP: Settings ‣ Avatars: URL to Avatar Folder

ban_action¶

Set the action to be taken when a visitor with a banned IP address attempts access.

Example Usage:

$config['ban_action'] = 'message';

ban_destination¶

Set the redirect destination for visitors with banned IP addresses. Must be used in conjunction with ban_action set to bounce.

Example Usage:

$config['ban_destination'] = 'http://www.example.com';

ban_message¶

Set the message shown to visitors with banned IP addresses. Must be used in conjunction with ban_action set to message.

Example Usage:

$config['ban_message'] = 'This site is currently unavailable.';

banish_masked_ips¶

Set the system to deny a visitor access if the user’s IP address cannot be determined while throttling is enabled.

Example Usage:

$config['banish_masked_ips'] = 'y';

Also found in CP: Settings ‣ Access Throttling: Deny Access if No IP Address is Present

banishment_message¶

Set a custom message to show throttled visitors. Throttling must be enabled and banishment_type must be set to message.

Example Usage:

$config['banishment_message'] = 'You have exceeded the allowed page load frequency.';

Also found in CP: Settings ‣ Access Throttling: Custom Message

banishment_type¶

Set the system’s method for handling throttled web requests.

Example Usage:

$config['banishment_type'] = 'message';

Also found in CP: Settings ‣ Access Throttling: Action to Take

banishment_url¶

Set a URL to serve as the redirect destination for throttled visitors. Throttling must be enabled and banishment_type must be set to redirect.

Example Usage:

$config['banishment_url'] = 'http://www.yahoo.com';

Also found in CP: Settings ‣ Access Throttling: URL for Redirect

banned_emails¶

Specify email addresses to ban from site registration and login. Use wildcards for partial email addresses.

Example Usage:

$config['banned_emails'] = '[email protected]|[email protected]|*@spammydomain.com';

Also found in CP: Members ‣ Manage Bans: Banned Email Addresses

banned_ips¶

Specify IP addresses to ban from site registration and login. Use wildcards to ban blocks of IP addresses.

Example Usage:

$config['banned_ips'] = '123.456.789.1|123.321.*';

Also found in CP: Members ‣ Manage Bans: Banned IP Address

banned_screen_names¶

Specify screen names that cannot be used for member accounts, which can be handy for reserving certain screen names for your own use.

Example Usage:

$config['banned_screen_names'] = 'Garfield|Snoopy|Hobbes';

Also found in CP: Members ‣ Manage Bans: Restricted Screen Names

banned_usernames¶

Specify usernames that cannot be used for member accounts, which can be handy for reserving certain usernames for your own use.

Example Usage:

$config['banned_usernames'] = 'garfield|snoopy|hobbes';

Also found in CP: Members ‣ Manage Bans: Restricted Usernames

base_path¶

Set your site’s base server path for use in other path configurations. Once set, this value is made available via a {base_path} variable that can be placed in server path fields in the control panel for easy environment management.

Example Usage:

$config['base_path'] = '/var/www/html/';

Also found in CP: Settings ‣ URL and Path Settings: Default base path

base_url¶

Set your site’s base URL for use in other URL configurations. Once set, this value is made available via a {base_url} variable that can be placed in other URL configuration fields in the control panel for easy environment management.

Example Usage:

$config['base_url'] = 'http://example.com';

Also found in CP: Settings ‣ URL and Path Settings: Default base URL

cache_driver¶

Specify a different caching driver to use.

Example Usage:

$config['cache_driver'] = 'memcached';

cache_driver_backup¶

Specify a backup caching driver to use in case the one specified in cache_driver isn’t available. Same values accepted and same default as cache_driver.

Example Usage:

$config['cache_driver_backup'] = 'file';

captcha_font¶

Set whether TrueType fonts should be used for CAPTCHA images.

Example Usage:

$config['captcha_font'] = 'n';

Also found in CP: Settings ‣ CAPTCHA: Use TrueType Font for CAPTCHA

captcha_path¶

Set the path to the directory containing CAPTCHA images.

Example Usage:

$config['captcha_path'] = '/path/to/captcha/folder/';

Also found in CP: Settings ‣ CAPTCHA: Server Path to CAPTCHA Folder

captcha_rand¶

Specify whether to add a random three-digit number to the end of each generated CAPTCHA word. This makes it more difficult for scripts to guess or brute-force the form submission.

Example Usage:

$config['captcha_rand'] = 'n';

Also found in CP: Settings ‣ CAPTCHA: Add Random Number to CAPTCHA Word

captcha_require_members¶

Specify whether to require logged-in members to pass CAPTCHA validation to submit front-end forms, such as Channel Form, comment forms and email forms.

Example Usage:

$config['captcha_require_members'] = 'y';

Also found in CP: Settings ‣ CAPTCHA: Require CAPTCHA with logged-in members

captcha_url¶

Set the full URL to the directory containing CAPTCHA images.

Example Usage:

$config['captcha_url'] = 'http://www.example.com/images/captchas';

Also found in CP: Settings ‣ CAPTCHA: Full URL to CAPTCHA Folder

censor_replacement¶

You may optionally specify a word or phrase to be used when replacing censored words. For example, if you set “tisk tisk” as your replacement word, and “shucks” is in your censored list, then anytime “shucks” is used it will be replaced with “tisk tisk”. If you do not set this preference, a pound symbol will be used for each character that is censored, so “shucks” would be converted to “######”.

Example Usage:

$config['censor_replacement'] = 'tisk tisk';

Also found in CP: Settings ‣ Word Censoring: Censoring Replacement Word

censored_words¶

Specify a list of words to censor. Wildcards are allowed. For example, test* would censor the words “test”, “testing”, and “tester”, while *gress would censor the words “progress” and “congress”.

Example Usage:

$config['censored_words'] = 'dagnabbit|consarnit|golly gee willikers';

Also found in CP: Settings ‣ Word Censoring: Censored Words

charset¶

Specify which character set for the system to use by default.

Example Usage:

$config['charset'] = 'UTF-8';

code_block_pre¶

Custom markup to use wrap [code] blocks, works with code_block_post below to wrap the standard <pre><code>...</code></pre> with your custom markup.

Example Usage:

$config['code_block_pre'] = '<div class="codeblock">';
$config['code_block_post'] = '</div>';

code_block_post¶

Custom markup to use wrap [code] blocks, works with code_block_pre above to wrap the standard <pre><code>...</code></pre> with your custom markup.

Example Usage:

$config['code_block_pre'] = '<div class="codeblock">';
$config['code_block_post'] = '</div>';

comment_edit_time_limit¶

Set the length of time in seconds that members have to edit their comments on the front end of the site. Set to 0 for no limit. Members in the Super Admin group are exempt from this time limit.

Example Usage:

$config['comment_edit_time_limit'] = '120';

Also found in CP: Settings ‣ Comment Settings: Comment Editing Time Limit

comment_moderation_override¶

By default, comments are no longer accepted for entries after their comment expiration date has passed. Set this preference to override that behavior and allow moderated comments on entries after comment expiration.

Example Usage:

$config['comment_moderation_override'] = 'y';

Also found in CP: Settings ‣ Comment Settings: Moderate expired entries

comment_word_censoring¶

Apply word censoring to comments, even if censoring is not enabled system-wide.

Example Usage:

$config['comment_word_censoring'] = 'y';

Also found in CP: Settings ‣ Comment Settings: Force word censoring for comments

cookie_domain¶

Optionally specify a domain the cookie is available to. By default, the exact hostname of the requested page is set as the cookie domain. For example, if the page at http://www.example.com/blog/an-entry-title is loaded and the cookie domain is left blank in ExpressionEngine’s configuration, the browser will use www.example.com as the cookie domain. The browser will only make these cookies available when the page’s hostname is exactly www.example.com.

If the cookie domain is explicitly specified, however, the browser will make the cookie available whenever the requested page’s hostname contains the cookie domain. For example, setting the cookie domain to .example.com will ensure the cookie is shared whenever the requested page’s hostname includes example.com, www.example.com, admin.example.com, blog.example.com, and so on.

If you’re running multiple subdomains on a single ExpressionEngine installation and want member sessions to be valid across all subdomains, you should explicitly set the cookie domain.

Example Usage:

$config['cookie_domain'] = '.example.com';

Also found in CP: Settings ‣ Security & Privacy: Cookie Domain

cookie_httponly¶

Set the HttpOnly flag when setting a cookie. The HttpOnly flag is a security feature for cookies that prevents a client side script from accessing or deleting the cookie (if the browser supports it, as most modern browsers do). Learn more.

Example Usage:

$config['cookie_httponly'] = 'n';

cookie_path¶

Optionally specify a cookie path. When a cookie path is set, the browser will only share cookies with ExpressionEngine when the beginning of the URL path matches the cookie path. For example, if the cookie path is set to /blog/, a cookie for the domain example.com will only be sent by the browser if the URL begins with http://example.com/blog/. This can be useful if you have ExpressionEngine installed in a sub-directory and want to ensure that only that particular installation has access to the cookies it sets.

Example Usage:

$config['cookie_path'] = '/blog/';

Also found in CP: Settings ‣ Security & Privacy: Cookie Path

cookie_prefix¶

Specify a prefix for the cookie name set by ExpressionEngine. This protects against collisions from separate ExpressionEngine installations on the same cookie domain.

Example Usage:

$config['cookie_prefix'] = 'site1';

Also found in CP: Settings ‣ Security & Privacy: Cookie Prefix

cookie_secure¶

Require a secure connection (HTTPS) for ExpressionEngine to set cookies.

Example Usage:

$config['cookie_secure'] = 'y';

cp_session_type¶

Set the method for session handling in the Control Panel.

Example Usage:

$config['cp_session_type'] = 's';

Also found in CP: Settings ‣ Security & Privacy: Control Panel Session Type

cp_url¶

Set the full URL to your Control Panel.

Example Usage:

$config['cp_url'] = 'http://example.com/admin.php';

Also available for use in the site index file, index.php, and the CP index file, admin.php. Example Usage:

$assign_to_config['cp_url'] = 'http://domain2.com/admin.php';

Also found in CP: Settings ‣ URL and Path Settings: URL to your Control Panel index page

date_format¶

Set the default format for displaying dates. If allow_member_localization is enabled and a member has their own localization preference set, that will override this setting.

Example Usage:

$config['date_format'] = '%F %d %Y';

debug¶

Set display preferences for PHP and database error messages.

Example Usage:

$config['debug'] = '1';

Also found in CP: Settings ‣ Debugging & Output: Debug Preference

default_member_group¶

Set the member group to which new users will be assigned.

Example Usage:

$config['default_member_group'] = '6';

Also found in CP: Settings ‣ Members: Default Member Group Assigned to New Members

default_site_timezone¶

Set the default timezone. All dates and times displayed by ExpressionEngine will be localized to this timezone unless overridden by a member’s own localization preferences.

Example Usage:

$config['default_site_timezone'] = 'America/Los_Angeles';

Also found in CP: Settings ‣ General Settings: Site Timezone

deft_lang¶

Set the default language. ExpressionEngine ships with English, and additional language packs are available for download.

Example Usage:

$config['deft_lang'] = 'french';

deny_duplicate_data¶

Set whether to reject duplicate data submissions. This feature blocks a comment if an identical one already exists on the site.

Example Usage:

$config['deny_duplicate_data'] = 'n';

Also found in CP: Settings ‣ Security & Privacy: Deny Duplicate Data

disable_all_tracking¶

This is an emergency override which will disable all tracking when enabled. This is useful for server administrators who need a way to respond immediately to a traffic spike to help keep the site running smoothly.

Example Usage:

$config['disable_all_tracking'] = 'y';

disable_csrf_protection¶

CSRF protection prevents automated scripts (the most common way spam is generated) from repeatedly submitting comments or other form data. A submission is only allowed when a user manually loads a page and submits the form from your site.

Example Usage:

$config['disable_csrf_protection'] = 'y';

disable_tag_caching¶

Disables tag caching, which if used unwisely on a high traffic site can lead to disastrous disk i/o. This setting allows quick thinking admins to temporarily disable it without hacking or modifying folder permissions.

Example Usage:

$config['disable_tag_caching'] = 'y';

dynamic_tracking_disabling¶

Set a value for the maximum number of online visitors to track. Once this value is exceeded, all of the tracking features will be temporarily disabled until the number of online visitors drops below the indicated value. Recommended values for this feature will vary based on your hosting environment. Check with your server administrator to discuss reasonable limits for your site.

Example Usage:

$config['dynamic_tracking_disabling'] = '350';

Also found in CP: Settings ‣ Hit Tracking: Suspend ALL tracking when number of online visitors exceeds:

email_batch_size¶

Set the number of emails to be sent in each batch. The batch size you should use depend on many things; among them the email protocol you have chosen, the server configuration, and the server power, so you may need to experiment a little to get it right.

If you are using one of the more robust mail protocols, like Sendmail or SMTP, you can set a greater batch total, possibly as high as several hundred or even more if you are on a dedicated server. A batch size of 300 in these cases is a good starting point. If you are having good success you can increase it until you begin experiencing time-outs.

Example Usage:

$config['email_batch_size'] = '300';

email_batchmode¶

Set whether to send email via the Communicate section of the Control Panel in batches.

This mode splits up large numbers of emails into small batches which are sent at short intervals. This gives you the ability to send email to very large mailing lists without running up against your server’s execution time limit. By default, PHP limits any process to 30 seconds, which is not enough time to send a large amount of email. Enabling the batch mode can prevent server time-outs. A secondary benefit is that it is less taxing on your mail server and, in the case of people on shared hosting accounts, less likely to cause problems with your server administrator.

Example Usage:

$config['email_batchmode'] = 'y';

email_charset¶

Set the character encoding used on the content of outgoing messages.

Example Usage:

$config['email_charset'] = 'utf-8';

Also found in CP: Settings ‣ Outgoing Email: Email Character Encoding

email_console_timelock¶

Set the number of minutes that must lapse before a member is allowed to send another email.

Example Usage:

$config['email_console_timelock'] = '300';

email_crlf¶

If set, this overrides the core Email class setting for crlf characters in quoted-printable encoded emails (Email class $crlf property).

Example Usage:

$config['email_crlf'] = "\r\n";

email_newline¶

If set, overrides the core Email class setting for newline characters (Email class $newline property).

Example Usage:

$config['email_newline'] = "\r\n";

email_smtp_crypto¶

Cryptographic protocol for SMTP, when a secure connection is required.

Example Usage:

$config['email_smtp_crypto'] = 'tls';

emoticon_url¶

Set the URL to the base folder where smiley graphics are stored.

Example Usage:

$config['emoticon_url'] = 'http://example.com/images/smileys/';

Also found in CP: Settings ‣ Content & Design: URL to the folder containing your smileys

enable_avatars¶

If enabled, users can associate an image with their account that you can optionally display with entries, comments, and forum posts.

Example Usage:

$config['enable_avatars'] = 'n';

Also found in CP: Settings ‣ Avatar Settings: Enable Avatars

enable_censoring¶

If enabled, the system will censor any specified words in channel entries, comments, forum posts, etc. Censored words will be replaced with the censoring replacement word.

Example Usage:

$config['enable_censoring'] = 'y';

Also found in CP: Settings ‣ Word Censorship: Enable Word Censoring

enable_emoticons¶

If enabled, smileys entered as text will be displayed with graphic representations.

Example Usage:

$config['enable_emoticons'] = 'y';

Also found in CP: Settings ‣ Content & Design: Display Smileys

enable_entry_view_tracking¶

If enabled, the Entry “Views” Tracking Tag feature of the Channel module is available for use.

Example Usage:

$config['enable_entry_view_tracking'] = 'y';

Also found in CP: Settings ‣ Hit Tracking: Enable Channel Entry View Tracking

enable_hit_tracking¶

If enabled, the hit will be tracked each time a template is loaded.

Example Usage:

$config['enable_hit_tracking'] = 'y';

Also found in CP: Settings ‣ Hit Tracking: Enable Template Hit Tracking

enable_online_user_tracking¶

If enabled, online user statistics are tracked and the user-based variables in the Statistics module are available for use.

Example Usage:

$config['enable_online_user_tracking'] = 'y';

Also found in CP: Settings ‣ Hit Tracking: Enable Online User Tracking

enable_search_log¶

If enabled, each searched term will be logged and can be viewed in the Search Log.

Example Usage:

$config['enable_search_log'] = 'n';

enable_sql_caching¶

Improves the speed at which the Channel Entries tag is rendered by caching queries that are normally executed dynamically.

Example Usage:

$config['enable_sql_caching'] = 'n';

Also found in CP: Settings ‣ Content & Design: Cache Dynamic Channel Queries

enable_template_routes¶

This setting toggles whether or not Template Routes are used. If this is set to no, templates will not be accessible by their routes. When disabled the Template Route options will not appear in the Template Manager.

Example Usage:

$config['enable_template_routes'] = 'y';

enable_throttling¶

If enabled, the system will throttle excessive web requests from potentially malicious users.

Example Usage:

$config['enable_throttling'] = 'y';

Also found in CP: Settings ‣ Access Throttling: Enable Throttling

encode_removed_text¶

If set and $this->encode_email is set to FALSE in the Template class—which is not the default—this text will replace all instances of the encode global variable.

Example Usage:

$config['encode_removed_text'] = 'Encoded emails not allowed';

encryption_key¶

May be used by third parties as part of encoding and decoding encrypted data. The recommended length of the key is 32 characters (128 bits). The key should include numbers and uppercase and lowercase letters.

Example Usage:

$config['encryption_key'] = 'sy22k6QK6JzH38u4nLZ65bHOdK6VL89d';

expire_session_on_browser_close¶

Set the system to end a user’s session when the browser is closed. (In the case of Mac OS X, this means quitting the browser application.)

Example Usage:

$config['expire_session_on_browser_close'] = 'y';

filename_increment¶

Forces filenames of uploaded files to be unique. Secondary uploads of existing files or uploads that share a filename with an existing file will have an incrementing number appended to the filename.

Example Usage:

$config['filename_increment'] = 'y';

force_query_string¶

If enabled, ExpressionEngine will render URLs with a question mark following index.php in order to pass along segment information as a standard query string:

http://example.com/index.php?/channel/joe/

This is necessary for only a few types of web servers to process ExpressionEngine’s URLs correctly. ExpressionEngine’s default is a much more search-engine friendly format:

http://example.com/index.php/channel/joe/

In rare circumstances, you may need to use this variable in conjunction with editing the $qtype variable in your main site index.php file.

Example Usage:

$config['force_query_string'] = 'y';

Also found in CP: Settings ‣ Debugging & Output: Force URL query strings

forum_is_installed¶

Automatically enabled when the Discussion Forum module is installed.

Example Usage:

$config['forum_is_installed'] = 'y';

forum_trigger¶

Sets the forum triggering word if the Discussion Forum module is installed.

Example Usage:

$config['forum_trigger'] = 'eerox';

Also found in CP: Developer Tools ‣ Add-On Manager ‣ Discussion Forum Settings ‣ Edit: Forum Triggering Word

gmail_duplication_prevention¶

Gmail email addresses can optionally include any number of .’s and they’re equivalent to the same address without .’s. For example example@gmail.com is the same as e.x.a.m.p.l.e@gmail.com. By default, ExpressionEngine prevents duplicate registration from the same address, but you can disable the prevention.

Example Usage:

$config['gmail_duplication_prevention'] = 'n';

gzip_output¶

Set the system to serve compressed front-end pages for faster load times as long as the requesting browser supports gzip compression, PHP’s zlib extension is loaded, and the web server is not already serving compressed pages. It’s a good idea to enable this setting in most production environments.

Example Usage:

$config['gzip_output'] = 'y';

Also found in CP: Settings ‣ Debugging & Output: Enable GZIP Output

hidden_template_indicator¶

Specify the character(s) that denote a hidden template when used to prefix a template name. The default is an underscore, e.g. _my_hidden_template.

Example Usage:

$config['hidden_template_indicator'] = '.';

hidden_template_404¶

Set the system to show either a 404 page or the template group’s index page when a hidden template is directly loaded in a browser.

Example Usage:

$config['hidden_template_404'] = 'y';

htaccess_path¶

Set the server path used by the Blacklist/Whitelist module to write rules to your .htaccess file.

Example Usage:

$config['htaccess_path'] = '/server/path/to/your/.htaccess/';

image_library_path¶

Set the path to the selected image library.

Example Usage:

$config['image_library_path'] = '/usr/bin/';

Also found in CP: Settings ‣ Content & Design: Image Converter Path

image_resize_protocol¶

Specify the image manipulation library to use. You may need to contact your web host or sysadmin to determine which protocols are installed and available on your server.

Example Usage:

$config['image_resize_protocol'] = 'netpbm';

Also found in CP: Settings ‣ Content & Design: Image Resizing Protocol

include_seconds¶

Set the system to include seconds when time is displayed in the interface.

Example Usage:

$config['include_seconds'] = 'y';

ip2nation¶

Enable checks against the IP to Nation database.

Example Usage:

$config['ip2nation'] = 'n';

is_site_on¶

Specify whether the site should be viewable by the general public or taken offline. This can be helpful when performing maintenance on only one of several MSM sites.

Example Usage:

$config['is_site_on'] = 'n';

Also available for use in the site index file, index.php. Example Usage:

$assign_to_config['is_site_on'] = 'n';

Also found in CP: Settings ‣ General Settings: Is site on?

is_system_on¶

Specify whether the system’s front-end should be viewable by the general public or taken offline. This can be helpful when performing maintenance.

Example Usage:

$config['is_system_on'] = 'y';

Also found in CP: Settings ‣ General Settings: Is system on?

lockout_time¶

Set the length of time a throttled visitor will be locked out of the site.

Example Usage:

$config['lockout_time'] = '30';

Also found in CP: Settings ‣ Access Throttling: Lockout Time

log_date_format¶

Set the timestamp format for all items added to the log file.

Example Usage:

$config['log_date_format'] = 'Y-m-d H:i:s';

log_email_console_msgs¶

Enable logging of all messages sent via the email console in the member profile pages.

Example Usage:

$config['log_email_console_msgs'] = 'n';

log_referrers¶

Enable referrer tracking. When enabled, one additional database access query will be performed for each page load so that the statistics can be generated.

Example Usage:

$config['log_referrers'] = 'n';

log_search_terms¶

Unused in first party files, this configuration item exists to allow backwards compatibility for any third party add-ons using it.

log_threshold¶

Set an error threshold to determine how much information is logged.

Example Usage:

$config['log_threshold'] = '1';

mail_format¶

Set the default mail format selection for emails sent via the Communicate section.

Example Usage:

$config['mail_format'] = 'plain';

Also found in CP: Settings ‣ Outgoing Email: Default Mail Format

mail_protocol¶

Set the system’s method for sending email.

Example Usage:

$config['mail_protocol'] = 'smtp';

Also found in CP: Settings ‣ Outgoing Email: Email Protocol

max_logged_searches¶

Set the maximum number of most recent search terms to save in the search log.

Example Usage:

$config['max_logged_searches'] = '500';

max_page_loads¶

Set the maximum number of times a visitor is allowed to load your web pages within a given time interval before being locked out. If you set this preference to 5 page loads within 10 seconds, a user can not browse more than 5 pages within a 10 second interval or the throttling feature will be triggered, locking them out for the given lockout time.

Example Usage:

$config['max_page_loads'] = '10';

Also found in CP: Settings ‣ Access Throttling: Maximum Number of Page Loads

max_tmpl_revisions¶

Set the maximum number of template revisions to save if template revisions are enabled.

Example Usage:

$config['max_tmpl_revisions'] = '10';

Also found in CP: Settings ‣ Template Settings: Maximum Number of Revisions to Keep

max_url_segments¶

Set the maximum number of URL segments allows in requests made to your site.

Example Usage:

$config['max_url_segments'] = '12';

mbr_notification_emails¶

List of email addresses to notify if notification is enabled for new member registrations.

Example Usage:

$config['mbr_notification_emails'] = '[email protected], [email protected]';

Also found in CP: Settings ‣ Members: Email address for notifications

memcached¶

If Memcached is the specified cache_driver, allows configuration of multiple Memcached servers to be used for cache storage.

Example Usage:

$config['memcached'] = array(
  array(
    'host' => '192.168.1.100',
    'port' => 11211,
    'weight' => 2,
  ),
  array(
    'host' => '192.168.1.101',
    'port' => 11211,
    'weight' => 1,
  )
);

member_theme¶

Set the default member profile theme.

Example Usage:

$config['member_theme'] = 'default';

Also found in CP: Settings ‣ Members: Default Member Profile Theme

memberlist_order_by¶

Set the default sorting criteria for the member list.

Example Usage:

$config['memberlist_order_by'] = 'total_posts';

Also found in CP: Settings ‣ Members: Member List - Sort By

mime_whitelist_additions¶

With an array, add Mime Types to the whitelist.

Example Usage:

$config['mime_whitelist_additions'] = array(
  'image/vnd.adobe.photoshop'
);

mime_whitelist_member_exception¶

Specify member IDs to exclude from Mime Type whitelist restrictions.

Example Usage:

$config['mime_whitelist_member_exception'] = '3, 14, 83';

mime_whitelist_member_group_exception¶

Specify member group IDs to exclude from Mime Type whitelist restrictions.

Example Usage:

$config['mime_whitelist_member_group_exception'] = '2, 5';

moblog_allow_nontextareas¶

Remove Moblog’s textarea-only restriction for Channel Fields.

Example Usage:

$config['moblog_allow_nontextareas'] = 'y';

memberlist_row_limit¶

Set the default number of rows for the member list to display.

Example Usage:

$config['memberlist_row_limit'] = '20';

Also found in CP: Settings ‣ Members: Member List - Rows

memberlist_sort_order¶

Set the default member list sort order.

Example Usage:

$config['memberlist_sort_order'] = 'desc';

Also found in CP: Settings ‣ Members: Member List - Order

multiple_sites_enabled¶

Enable Multiple Site Manager.

Example Usage:

$config['multiple_sites_enabled'] = 'y';

Also found in CP: Settings ‣ General Settings:

name_of_dictionary_file¶

Filename for the dictionary file. The official dictionary file is available for download. Must be used in combination with allow_dictionary_pw.

Example Usage:

$config['name_of_dictionary_file'] = 'dictionary.txt';

Also found in CP: Settings ‣ Security & Privacy: Name of Dictionary File

new_member_notification¶

Enables notification of a given notification list for new member registrations.

Example Usage:

$config['new_member_notification'] = 'n';

Also found in CP: Settings ‣ Members: Send new member notifications

new_posts_clear_caches¶

Set caches to clear when new entries are posted.

Example Usage:

$config['new_posts_clear_caches'] = 'n';

Also found in CP: Settings ‣ Content & Design: Clear all caches when new entries are posted

new_version_check¶

Set ExpressionEngine to periodically check for available updates.

Example Usage:

$config['new_version_check'] = 'n';

Also found in CP: Settings ‣ General Settings: New Version Auto Check

newrelic_app_name¶

Sets the application name that is reported in the New Relic dashboard. If you’re using New Relic to monitor the performance of multiple ExpressionEngine installations, you’ll likely want those installations to show up separately in your New Relic dashboard.

Example Usage:

$config['newrelic_app_name'] = 'My Site';

Also available for use in the site index file, index.php, and the CP index file, admin.php. Example Usage:

$assign_to_config['newrelic_app_name'] = 'My Second Site';

newrelic_include_version_number¶

Whether or not to append the version number to the Application name in the New Relic dashboard.

Example Usage:

$config['newrelic_include_version_number'] = 'y';

password_lockout¶

If enabled, the system will lock a member account if more than four invalid login attempts are made within a specified time period. This is designed to deter hackers from using collision attacks to guess poorly chosen passwords. The account remains locked for the duration of the password lockout time period.

Example Usage:

$config['password_lockout'] = 'n';

Also found in CP: Settings ‣ Security & Privacy: Enable Password Lockout

password_lockout_interval¶

Set the time period for measuring invalid login attempts and locking accounts.

Example Usage:

$config['password_lockout_interval'] = '2.5';

Also found in CP: Settings ‣ Security & Privacy: Time Interval for Lockout

popup_link¶

Specify whether links created by the Typography class open in a new window.

Example Usage:

$config['popup_link'] = 'y';

profile_trigger¶

Set the triggering word for the front-end members section. The default is “member”, and the word you set cannot be the name of an existing template group.

Example Usage:

$config['profile_trigger'] = 'accounts';

Also found in CP: Settings ‣ URL and Path Settings: Profile Triggering Word

proxy_ips¶

Whitelist of reverse proxy servers that may forward the visitor’s IP address.

Example Usage:

$config['proxy_ips'] = '10.0.1.25, 10.0.1.26';

prv_msg_throttling_period¶

Set the length of time users must wait between sending private messages.

Example Usage:

$config['prv_msg_throttling_period'] = '60';

prv_msg_upload_path¶

Set the server path to the private messages uploads directory.

Example Usage:

$config['prv_msg_upload_path'] = '/path/images/pm_attachments/';

Also found in CP: Settings ‣ Messages: Server Path for Attachment Upload Directory

prv_msg_waiting_period¶

Set the length of time members must wait after registration before being allowed to send private messages.

Example Usage:

$config['prv_msg_waiting_period'] = '4';

publish_page_title_focus¶

Specify whether the title field should gain focus when the publish page is loaded.

Example Usage:

$config['publish_page_title_focus'] = 'n';

pw_min_len¶

Set the minimum number of characters allowed for member passwords.

Example Usage:

$config['pw_min_len'] = '8';

Also found in CP: Settings ‣ Security & Privacy: Minimum Password Length

recount_batch_total¶

Set the batch size for recounting statistics.

Because the recounting of statistics can impose some load on your server, the recounting is performed in batches. This setting allows you to define how large each processing batch should be. For most servers, a value of 1000 works well. For high-performance or dedicated servers you can increase this number and if your server is low on resources you may need to lower the number.

Example Usage:

$config['recount_batch_total'] = '200';

redirect_method¶

Set the method the system uses for page redirection.

Example Usage:

$config['redirect_method'] = 'redirect';

Also found in CP: Settings ‣ Debugging & Output: Redirection Method

redirect_submitted_links¶

Apply rank denial to user-submitted links. This feature rewrites links submitted in comments so they first point to an intermediate redirect page, helping deter comment spammers by preventing linked sites from gaining a search engine page rank advantage.

Example Usage:

$config['redirect_submitted_links'] = 'y';

redis¶

If Redis is the specified cache_driver, allows configuration of a Redis server to be used for cache storage.

Example Usage:

$config['redis'] = array(
  'host' => '127.0.0.1',
  'password' => NULL,
  'port' => 6379,
  'timeout' => 0
);

relaxed_track_views¶

Allow Entry Views Tracking to work for ANY combination that results in only one entry being returned by the tag, including Channel query caching.

Example Usage:

$config['relaxed_track_views'] = 'y';

remove_close_all_button¶

Remove the button to close all HTML tags from the publish page and user-side HTML formatting buttons. Most browsers no longer need it.

Example Usage:

$config['remove_close_all_button'] = 'y';

remove_unparsed_vars¶

Remove unparsed ExpressionEngine variables upon output when the debug has been set to 0.

Example Usage:

$config['remove_unparsed_vars'] = 'y';

req_mbr_activation¶

Specify whether new member activation is automatic, requires email verification, or requires an administrator’s approval.

Example Usage:

$config['req_mbr_activation'] = 'none';

Also found in CP: Settings ‣ Members: Require Member Account Activation

require_captcha¶

When enabled, site visitors will be required to pass a CAPTCHA to submit any front-end form, including Channel Form, comment forms, and member registrations.

Also found in CP: Settings ‣ CAPTCHA: Require CAPTCHA

require_ip_for_login¶

Require users have a valid IP address and browser user agent when logging in. This helps prevent hackers from logging in using direct socket connections or trying to access the system with a masked IP address.

Example Usage:

$config['require_ip_for_login'] = 'n';

Also found in CP: Settings ‣ Security & Privacy: Require IP Address and User Agent for Login

require_ip_for_posting¶

Require users have a valid IP address and browser user agent when posting comments or Channel Form entries.

Example Usage:

$config['require_ip_for_posting'] = 'n';

Also found in CP: Settings ‣ Security & Privacy: Require IP Address and User Agent for posting

require_secure_passwords¶

Require users’ passwords to contain at least one uppercase character, one lowercase character, and one numeric character. Passwords that follow this basic formula are much more difficult to guess.

Example Usage:

$config['require_secure_passwords'] = 'n';

Also found in CP: Settings ‣ Security & Privacy: Require Secure Passwords

require_terms_of_service¶

Require new members to agree to your terms of service upon registration.

Example Usage:

$config['require_terms_of_service'] = 'n';

Also found in CP: Settings ‣ Members: Require Terms of Service

reserved_category_word¶

If use_category_name is enabled, specify a word to use in category URLs to indicate to the system that the following segment is the category URL title. For example, if the indicator is set to “category” and the category URL title is “blogging”:

http://example.com/index.php/site/category/blogging/

The word you set cannot be the name of an existing template group or template.

Example Usage:

$config['reserved_category_word'] = 'category';

Also found in CP: Settings ‣ URL and Path Settings: Category URL Indicator

rte_default_toolset_id¶

Set the default RTE toolset shown for any member that has not specifically chosen one in Rich Text Editor Preferences.

Example Usage:

$config['rte_default_toolset_id'] = '2';

Also found in CP: Developer Tools ‣ Add-On Manager ‣ Rich Text Editor Settings: Default Toolset

rte_enabled¶

If enabled, the Rich Text Editor will be applied to any Textarea (Rich Text) Channel Field. Otherwise, the field will appear as a normal textarea instead.

Example Usage:

$config['rte_enabled'] = 'y';

Also found in CP: Developer Tools ‣ Add-On Manager ‣ Rich Text Editor Settings: Enable Rich Text Editor

save_tmpl_files¶

Enable the saving of templates as files.

Example Usage:

$config['save_tmpl_files'] = 'y';

Also found in CP: Settings ‣ Template Settings: Save Templates as Files

save_tmpl_revisions¶

Enable template revisions. Template history is saved when changes are made within the template editor.

Example Usage:

$config['save_tmpl_revisions'] = 'y';

Also found in CP: Settings ‣ Template Settings: Save Template Revisions

sc_certificate_id¶

Specify the unique ID that is supplied by PayPal after providing them with a public certificate.

Example Usage:

$config['sc_certificate_id'] = 'SX4DT7FDO1234';

Also found in CP: Developer Tools ‣ Add-On Manager ‣ Simple Commerce Settings: ID Given to Public Certificate by PayPal

sc_encrypt_buttons¶

Enable encryption for PayPal purchase links and buttons created by Simple Commerce.

Example Usage:

$config['sc_encrypt_buttons'] = 'y';

Also found in CP: Developer Tools ‣ Add-On Manager ‣ Simple Commerce Settings: Encrypt PayPal Buttons and Links?

sc_paypal_account¶

Specify the primary email address associated with the PayPal account processing payments for store purchases.

Example Usage:

$config['sc_paypal_account'] = '[email protected]';

Also found in CP: Developer Tools ‣ Add-On Manager ‣ Simple Commerce Settings: PayPal Account

sc_paypal_certificate¶

Specify the path to the PayPal-provided certificate file. Please read the section on Encrypted Website Payments for full details.

Example Usage:

$config['sc_paypal_certificate'] = "/path/to/paypal_certificate.pem";

Also found in CP: Developer Tools ‣ Add-On Manager ‣ Simple Commerce Settings: PayPal Certificate Path

sc_private_key¶

Specify the path to the private key file. Please read the section on Encrypted Website Payments for full details.

Example Usage:

$config['sc_private_key'] = "/path/to/private_key.pem";

Also found in CP: Developer Tools ‣ Add-On Manager ‣ Simple Commerce Settings: Private Key Path

sc_public_certificate¶

Specify the path to the public certificate file. Please read the section on Encrypted Website Payments for full details.

Example Usage:

$config['sc_public_certificate'] = "/path/to/public_certificate.pem";

Also found in CP: Developer Tools ‣ Add-On Manager ‣ Simple Commerce Settings: Public Certificate Path

sc_temp_path¶

Specify the path to the temporarily stored encrypted files. Please read the section on Encrypted Website Payments for full details.

Example Usage:

$config['sc_temp_path'] = "/path/to/tmp";

Also found in CP: Developer Tools ‣ Add-On Manager ‣ Simple Commerce Settings: Temporary Encrypted Files Path

send_headers¶

Specify whether the system should automatically send HTTP page headers when it serves pages to a visitor.

Example Usage:

$config['send_headers'] = 'n';

Also found in CP: Settings ‣ Debugging & Output: Generate HTTP Page Headers

server_offset¶

When a server’s clock is off and you are unable to correct it at the server level, use this preference to correct the disparity. Use a positive integer to correct a server clock that is too slow, and a negative integer to correct a server clock that is too fast.

Example Usage:

$config['server_offset'] = '-15';

show_profiler¶

Enable Output Profiler. When enabled, Super Admins will see benchmark results, SQL queries, and submitted form data displayed at the bottom of the browser window. Template debugging is included on the front end.

Example Usage:

$config['show_profiler'] = 'y';

Also found in CP: Settings ‣ Debugging & Output: Display Output Profiler

sig_allow_img_hotlink¶

Specify whether members can link to images hosted on other websites as their signature image.

Example Usage:

$config['sig_allow_img_hotlink'] = 'n';

sig_allow_img_upload¶

Set whether members can upload their own signature image.

Example Usage:

$config['sig_allow_img_upload'] = 'y';

sig_img_max_height¶

Set the maximum height (in pixels) allowed for user-uploaded signature images.

Example Usage:

$config['sig_img_max_height'] = '150';

sig_img_max_kb¶

Set the maximum file size (in kilobytes) allowed for user-uploaded signature images.

Example Usage:

$config['sig_img_max_kb'] = '50';

sig_img_max_width¶

Set the maximum width (in pixels) allowed for user-uploaded signature images.

Example Usage:

$config['sig_img_max_width'] = '150';

sig_img_path¶

Set the server path to the signature images directory.

Example Usage:

$config['sig_img_path'] = '/path/image/folder/';

sig_img_url¶

Set the URL to the signature images directory.

Example Usage:

$config['sig_img_url'] = 'http://example.com/images/signatures/';

sig_maxlength¶

Set the maximum number of characters allowed in a member’s signature.

Example Usage:

$config['sig_maxlength'] = '500';

site_404¶

Set which template should be displayed when a visitor tries to access an invalid URL.

Example Usage:

$config['site_404'] = 'site/404';

Also available for use in the site index file, index.php. Example Usage:

$assign_to_config['site_404'] = 'site/notfound';

Also found in CP: Settings ‣ Template Settings: 404 Page

site_index¶

Set the filename of the site index file. By default, this will be index.php, which is located in the base folder. You will only need to alter this setting if you have changed the filename or you want to remove index.php from your site’s URLs.

Example Usage:

$config['site_index'] = 'coolpage.php';

Also available for use in the site index file, index.php. Example Usage:

$assign_to_config['site_index'] = 'secondsite.php';

Also found in CP: Settings ‣ URL and Path Settings: Name of your site’s index page

site_name¶

Set the short name of the site. The site created upon installation is named default_site, so this is typically only helpful for additional sites in MSM-enabled installations.

Available for use only in the site index file, index.php, and the CP index file, admin.php. Example Usage:

$assign_to_config['site_name'] = 'domain2_short_name';

Also found in CP: Developer Tools ‣ Site Manager ‣ Edit: Site Short Name

site_url¶

Set the full URL to the site’s web root.

Example Usage:

$config['site_url'] = 'http://example.com';

Also available for use in the site index file, index.php. Example Usage:

$assign_to_config['site_url'] = 'http://domain2.com';

Also found in CP: Settings ‣ URL and Path Settings: URL to the root directory of your site

smart_static_parsing¶

When enabled, parsing of embedded templates that are not saved as static templates will still be parsed as if they were, if at all possible (i.e. they contain no PHP or ExpressionEngine tags). This setting is enabled by default.

Example Usage:

$config['smart_static_parsing'] = 'n';

smtp_password¶

If mail protocol is set to smtp, this sets the password the system will use to authenticate with the SMTP server. This information can be obtained from your email provider.

Example Usage:

$config['smtp_password'] = 'ic6XpWJnv4ip';

Also found in CP: Settings ‣ Outgoing Email: SMTP Password

smtp_port¶

If mail protocol is set to smtp, this sets the mail server port. This information can be obtained from your email provider.

Example Usage:

$config['smtp_port'] = '2525';

smtp_server¶

If mail protocol is set to smtp, this sets the mail server hostname. This information can be obtained from your email provider.

Example Usage:

$config['smtp_server'] = 'mail.example.com';

Also found in CP: Settings ‣ Outgoing Email: SMTP Server Address

smtp_username¶

If mail protocol is set to smtp, this sets the username the system will use to authenticate with the SMTP server. This information can be obtained from your email provider.

Example Usage:

$config['smtp_username'] = '[email protected]';

Also found in CP: Settings ‣ Outgoing Email: SMTP Username

spellcheck_language_code¶

Set the language used by spell check.

Example Usage:

$config['spellcheck_language_code'] = 'en';

strict_urls¶

Set whether the system will allow templates from your default template group to be directly accessed in the first URL segment. If enabled, the system will require that the first URL segment be a valid template group only or a 404 page will be shown.

Example Usage:

$config['strict_urls'] = 'n';