Site Global Configuration
From Joomla! Documentation
- 1 Description
- 2 How to access
- 3 Screenshot
- 4 Form Fields
- 4.1 Site Tab
- 4.2 System Tab
- 4.3 Server Tab
- 4.4 Logging Tab
- 4.5 Text Filters Tab
- 4.6 Permissions Tab
- 5 Toolbar
- 6 Quick Tips
- 7 Related Information
The Global Configuration screen allows you to configure the Joomla site with your personal settings. Settings made in this screen apply to the whole site.
How to access
- Select System → Setup Panel → Global Configuration in the Administrator menu.
Many of the form field values are stored in the configuration.php file in the root of your site.
Part of the Site Tab is illustrated in the Screenshot. There is a complete image of the Site Tab to look at if you need it.
- Site Name: Enter the name of your Web site. This will be used in various locations (e.g. the backend browser title bar and Site Offline pages).
- Site Offline: (Yes/No). Select whether access to the Site frontend is available. If Yes, the frontend will display or not a message depending on the settings below.
- Offline Message: (Hide/Use Custom Message/Use Site Language Default Message). Display or not a frontend message when the site is offline. The custom offline message uses the value defined in the 'Custom message' field. The language offline message uses the value defined in the site language ini file.
- Custom Message: The custom offline message will be used if the 'Offline Message' field is set to 'Use Custom Message'.
- Offline Image: Select or upload an optional image to be displayed on the default offline page. Make sure the image is less than 400px wide.
- Frontend Editing: (Modules & Menus/Modules/None). Select if you want inline editing for modules and menu items (support may depend on your template).
- Default Editor: (Editor - CodeMirror/Editor - None/Editor - TinyMCE). Select the default text editor for your site. Registered Users will be able to change their preference in their personal details if you allow that option.
- Default Captcha: (None Selected). Select the default captcha for your site. You may need to enter required information for your captcha plugin in the Plugins.
- Default Access Level: (Public/Guest/Registered/Special/Customer Access Level (Example)/Super Users). Select the default access level for new content, menu items, and other items created on your site.
- Default List Limit: (5/10/15/20/25/30/50/...). Sets the default length of lists in the Control Panel for all users.
- Default Feed Limit: (5/10/15/20/25/30/50/...). Select the number of content items to show in the feed(s).
- Feed Email Address: (Author Email/Site Email/No Email). The RSS and Atom newsfeeds include the author's email address. Select Author Email to use each author's email (from the User Manager) in the news feed. Select Site Email to include the site 'Mail from' email address for each article.
- Block FLoC (Yes/No). Whether or not to support the FLoC method of user tracking.
- Site Meta Description: Enter a description of the overall website that is to be used by search engines. Generally, a maximum of 20 words is optimal.
- Robots: (Index, Follow/No index, follow/Index, No follow/No index, no follow). Robots instructions.
- Content Rights: Describe what rights others have to use this content.
- Show Author Meta Tag: (Yes/No). Show the author meta tag when viewing articles.
- Show Joomla! Version: (Yes/No). Show the Joomla! version number in the generator meta tag.
- Search Engine Friendly URLs: (Yes/No). Select if the URLs are optimised for Search Engines.
- Use URL Rewriting: (Yes/No). Select to use a server's rewrite engine to catch URLs that meet specific conditions and rewrite them as directed. Available for IIS 7 and Apache. Apache users only! Rename htaccess.txt to .htaccess before activating. IIS 7 users only! Rename web.config.txt to web.config and install IIS URL Rewrite Module before activating.
- Add Suffix to URL: (Yes/No). If yes, the system will add a suffix to the URL based on the document type.
- Unicode Aliases: (Yes/No). Choose between transliteration and unicode aliases. Transliteration is the default.
- Site Name in Page Titles: (After/Before/No). Begin or end all Page Titles with the site name (for example, My Site Name - My Article Name).
- Cookie Domain: Domain to use when setting session cookies. Precede domain with '.' if cookie should be valid for all subdomains.
- Cookie Path: Path the cookie should be valid for.
There is a complete image of the System Tab to look at if you need it.
- Debug System: (Yes/No). If enabled, diagnostic information, language translation, and SQL errors (if present) will be displayed. The information will be displayed at the foot of every page you view within the Joomla Backend and Frontend. It is not advisable to leave the debug mode activated when running a live website.
- Debug Language: (Yes/No). Select if the debugging indicators (**...**) or (??...??) for the Joomla! Language files will be displayed. Debug Language will work without Debug System being activated, but you will not get the additional detailed references that will help you correct any errors.
- System Cache: (OFF - Caching disabled/ON - Conservative caching/ON - Progressive caching). Enable or disable caching and set caching level. Conservative level: smaller system cache, Progressive level (default): faster, bigger system cache, includes module renderers cache. Not appropriate for extremely large sites.
- Cache Handler: (File). Choose the cache handler. Native caching mechanism is file-based. Please make sure the cache folders are writable.
- Platform Specific Caching: (Yes/No). Enable or disable platform specific caching. Enable when HTML output on mobile differs from other devices. (Default disabled.)
- Cache Time: The maximum length of time in minutes for a cache file to be stored before it is refreshed.
- Path to Cache Folder: Specify a writable folder to store cache files if you do not wish to use the default folder.
- Session Handler: (File System/Database/Others). The mechanism by which Joomla! identifies a User once they are connected to the website using non-persistent cookies.
- The database session handler is the default handler because it is the only one that Joomla can fully configure and control on its own.
- The filesystem handler will be slightly more performant than the database handler, but it requires PHP to be configured properly otherwise it will crash and Joomla will be totally unusable. To use it, select Filesystem and then enter a full filesystem path in the Session Save Path field that appears. Ensure the path has appropriate permissions for PHP to read and write files, and if session garbage collection is enabled to delete files from it. If this path is not set, Joomla will rely on the PHP session.save_path INI configuration or fallback to the system temporary directory (as defined by the sys_get_temp_dir() PHP function). If neither of those paths are configured or the permissions are wrong then it's game over. To recover, edit the configuration.php file and set $session_handler = 'database'.
- Other handlers (APCu, Memcached, Redis, and WinCache) all rely on optional PHP extensions and may be available if your system supports them. APCu or WinCache may be no better than the "plain" filesystem option. The Memcached and Redis handlers are overkill for Joomla in a typical shared hosting environment. Those types of handlers succeed if you are deploying Joomla in a load balanced environment where multiple servers are involved and you need the session data for the application to be available across all servers.
- Session Lifetime: Auto log out a User after they have been inactive for the entered number of minutes. Do not set too high.
- Shared Sessions: (Yes/No). When enabled, a user's session is shared between the frontend and administrator sections of the site. Note that changing this value will invalidate all existing sessions on the site. This is not available when the "Force HTTPS" option is set to "Administrator Only".
There is a complete image of the Server Tab to look at if you need it.
- Path to Temp Folder: Please specify a writable folder to store temporary files.
- Gzip Page Compression: (Yes/No). Compress buffered output if supported.
- Error Reporting. This parameter sets the level of error reporting to be used by PHP on the Joomla site. It has five options: System Default, None, Simple, Maximum and Development. “System Default” leaves the level of PHP error reporting to that set up in the server (usually in the php.ini file). “None” switches off PHP error reporting, and “Simple”, “Maximum” and “Development” override the server setting to give a basic level of reporting (for “Simple”) and the reporting of all errors (“Maximum” and “Development”).
Tip: Should your Joomla site fail to the extent that it is not possible to use the administrator page to activate error reporting, you can switch on full PHP error reporting by editing the configuration.php file. Changing the $error_reporting parameter in that file to a value of 'maximum' is the equivalent to setting Error Reporting to “Maximum”.
- Force HTTPS: (None/Administrator Only/Entire Site). Force site access in the selected areas to occur only with HTTPS (encrypted HTTP connections with the https:// protocol prefix) and also force the use of secure cookies. Note, you must have HTTPS enabled on your server to utilise this option.
- Website Time Zone: (Universal Time, Coordinated (UTC)/Abidjan/Accra/Addis Ababa/Algiers/Asmara/...). Choose a city in the list to configure the date and time for display.
- Enable CORS: (Yes/No). Enable Cross-Origin Resource Sharing (CORS)
- Behind Load Balancer. (Yes/No)
- Enable Outbound Proxy: (Yes/No). Enable Joomla to use a proxy which is needed in some server environments in order to fetch URLs like in the Joomla Update component.
- Outbound Proxy Host.
- Outbound Proxy Port.
- Outbound Proxy Username.
- Outbound Proxy Password.
- Database Type: (MySQL (PDO)/MySQLi). The type of database in use, selected during the installation process. Do not edit this field unless you are migrating to a different type of database, perhaps due to changing your hosting provider.
- Host: The hostname for your database entered during the installation process. Do not edit this field unless absolutely necessary (eg the transfer of the database to a new hosting provider).
- Database Username: The username for access to your database entered during the installation process. Do not edit this field unless absolutely necessary (eg the transfer of the database to a new hosting provider).
- Database Password: The password to be used to access the database. Do not edit this field unless absolutely necessary (eg. after the transfer of the database to a new hosting provider).
- Database Name: The name for your database entered during the installation process. Do not edit this field unless absolutely necessary (eg the transfer of the database to a new hosting provider).
- Database Tables Prefix: The prefix used for your database tables, created during the installation process. Do not edit field unless absolutely necessary (eg the transfer of the database to a new hosting provider).
- Connection Encryption: (Default/One-way Authentication/Two-way Authentication)
- Path to Private Key File: File system location.
- Path to Certificate File: File system location.
- Verify Server Certificate: (Yes/No)
- Path to CA File: File system path.
- Supported Cipher Suite (optional): No entry required (only recommended for experienced users) – for more details, see the documentation of your database.
- Send Mail: (Yes/No). Select Yes to turn on mail sending, select No to turn off mail sending. Warning: It is recommended to put the site offline when disabling the mail function!
- Disable Mass Mail: (Yes/No). Select Yes to disable the Mass Mail Users function, select No to make it active.
- From Email: The email address that will be used to send site email.
- From Name: Text displayed in the header "From:" field when sending a site email. Usually the site name.
- Reply To Email: The email address that will be used to receive end user(s) reply.
- Reply To Name: Text displayed in the header "To:" field when end user(s) replying to received email.
- Mailer: (PHP Mail/Sendmail/SMTP). Select which mailer for the delivery of site email.
There is a complete image of the Logging Tab to look at if you need it.
- Path to Log Folder: Please specify a folder to store log files.
- Log Almost Everything: (Yes/No). Logs everything, except deprecated APIs.
- Log Deprecated API: (Yes/No). Logs deprecated APIs.
Custom Logging Settings
- Log Priorities: Can be used to manage custom logging. Select the events you want to see in the log file. Default is "All". The item(s) can be selected/deselected by clicking the dropdown list.
- Log Categories: A comma separated list of log categories to include or exclude. Common log categories include but are not limited to: database, databasequery, database-error, deprecated and jerror. If empty, custom logging is disabled.
- Log Category Mode: (Include/Exclude). Sets the mode for the list of log categories above.
Text Filters Tab
There is a complete image of the Text Filters Tab to look at if you need it.
These text filter settings will be applied to all text editor fields submitted by users in the selected groups.
These filtering options give more control over the HTML your content providers submit. You can be as strict or as liberal as you require to suit your site's needs. The filtering is opt-in and the default settings provide good protection against markup commonly associated with website attacks.
There is a complete image of the Permissions Tab to look at if you need it.
Manage the permission settings for the user groups below. See notes at the bottom.
- Site Login: (Not Set/Allowed/Denied). Allow or deny Site Login for users in the selected group.
- Administrator Login: (Not Set/Allowed/Denied). Allow or deny Administrator Login for users in the selected group.
- Web Services Login: (Not Set/Allowed/Denied). Allow or deny Web Services Login for users in the selected group.
- Offline Access: (Not Set/Allowed/Denied). Allow or deny Offline Access for users in the Public group. Allows users in the group to access to the Frontend site when site is offline.
- Super User: (Not Set/Allowed/Denied). Allow or deny Super User for users in the Public group. Allows users in the group to perform any action over the whole site regardless of any other permission settings.
- Configure Options Only: (Not Set/Allowed/Denied). Allow or deny Configure Options Only for users in the Public group. Allows users in the group to edit the options except the permissions of any extension.
- Access Administration Interface: (Not Set/Allowed/Denied). Allow or deny Access Administration Interface for users in the Public group. Allows users in the group to access all of the administration interface except Global Configuration.
- Create: (Not Set/Allowed/Denied). Allow or deny Create for users in the Public group. Allows users in the group to create any content in any extension.
- Delete: (Not Set/Allowed/Denied). Allow or deny Delete for users in the Public group. Allows users in the group to delete any content in any extension.
- Edit: (Not Set/Allowed/Denied). Allow or deny Edit for users in the Public group. Allows users in the group to edit any content in any extension.
- Edit State: (Not Set/Allowed/Denied). Allow or deny Edit State for users in the Public group. Allows users in the group to edit the state of any content in any extension.
- Edit Own: (Not Set/Allowed/Denied). Allow or deny Edit Own for users in the Public group. Allows users in the group to edit any content they own in any extension.
- Edit Custom Field Value: (Not Set/Allowed/Denied). Allows users in the group to edit any value of custom fields submitted in any extension.
At the top of the page you will see the toolbar shown in the Screenshot above. The functions are:
- Save. Saves the item and stays in the current screen.
- Save & Close. Saves the item and closes the current screen.
- Close. Closes the current screen and returns to the previous screen without saving any modifications you may have made.
- Help. Opens this help screen.
- Most, if not all, of these settings can be set once and then left alone.
- If major modifications need to be made, then consider taking the site offline to test it and to make sure everything is in working order.
- The settings are saved in '<Joomla-root>/configuration.php'. You have to either activate the FTP-layer or make the 'configuration.php' file writable to save your changes.