| Global Configuration |
|
Title:com_config Access:menu=>Site=> or Quick Icons=>Global Configuration User Level:Super Administrator Screenshot:
The Global Configuration screens. Description:The Global Configuration panel controls Joomla!'s operational settings. Changes made on this screen will update the configuration.php file. This file needs to be writable in order for the configuration to be editable. For security it is advisable to make this file unwritable on a "Live" web site on the Internet once the configuration is set up as required. Toolbar:
Save: Click Save to save any changes made during the current editing session and return to the Control Panel screen. Apply: Click Apply to save any changes made so far in the current editing session, but remain in the Global Configuration screen to continue editing. Once the editing session is complete click Save as above. Cancel: Clicking Cancel at any point ends the current editing session and returns the display to the Control Panel screen. Any changes made since the session commenced, or since the last time Apply was clicked, will be lost. Help: Click Help at any point opens this Help Screen page. Make Global Configuration Unwritable / Writable:When entering the Global Configuration panel for the first time the write status message “configuration.php is: writable” will be visible on the top line of the panel. To the right of the write status is a check box labelled "Make unwritable after saving". Checking this box will change the file permissions of configuration.php to unwritable once the changes have been applied or saved. When configuration of the site has been completed, it is a good idea to make configuration.php Unwritable for security reasons. This will also prevent accidental changes being made as well! It will be noted that the write status has changed to “configuration.php is: Unwritable” If there is a need to alter any of the Global Configuration settings thereafter it is possible to temporarily activate the write permissions by checking the check-box now labelled “Override write protection while saving” and upon clicking either the Apply or Save icons the current changes will be written to the configuration.php file before the setting automatically returns to Unwritable again. To make a more permanent change, to make the file Writable, requires direct manual editing of the file permissions settings of configuration.php file using FTP software, or direct access to the file through the server control panel, or operating system. Just remember to switch it back to Unwritable again afterwards.
Site Tab:Site Offline: Selecting either the No or Yes radio buttons will determine whether the Front-end is accessible via the Internet or not. If Yes is selected the Front Page will be replaced with a temporary “Site is Unavailable” page. The message that is displayed is determined in the Offline Message field that follows this one. The Administrator Back-end is unaffected by this action. Use this facility when updating or installing templates, extensions, or data, when visitors should be unable to view the site until the changes are completed. It is also possible to edit the Site is Unavailable display by direct editing of the HTML within the offline.php file in the joomla_root/ directory of the Joomla! installation on the web server. Adding site specific images, organisation logos, titles, for example. Select the No option to return the web site to normal viewing accessibility (remembering to first check the “Override write protection while saving“ check box within the Global Configuration panel).
Offline Message: When the Site Offline is set to Yes, the content of this field forms the basis of a message that displays as the Front Page of the web site to the public. Edit the content of this field, if appropriate. The default message is "This site is down for maintenance. Please check back again soon." It might be of benefit to post the time and date that the site became unavailable together with the expected duration of this downtime. System Error Message: This message will automatically display if the initial database connection fails. Once again any message can be entered in this box. However, something friendly, informative, and apologetic, stating that the web site will be available again as soon as possible would be appreciated by the web site Users. Include a link or e-mail address so that the problem can be reported as there is often a chance that the site administrator does not know about it.
Site Name: Set the name that will display in the Title Bar of a Users web browser when they access the web site. The entry can simply be the name of the web site, or can include some additional, brief wording. This is the field that was completed during the installation procedure of Joomla!. Special characters can also be used in this field. The title can also be entered into the site template by inserting the following code statement into the Site Template file joomla_root/templates/template_name/index.php. This would be wherever it is intended that the Site Name should appear: <?php echo $_CONFIG->SITENAME; ?> Show Unauthorised Links: This option controls whether all visitors can see all registered content in the Front-end to which they would not otherwise have access. If set to Yes they would be able to see Content Items that had been given an Access Level of Registered or Special. They would only be able to see the Intro part of a Content Item and would have to register in order to see any more Content following a Read more... link. Once registered they would have access to the full Content Item(s). If this option is set to No then only content with an Access Level of Public will be viewable without being registered and logged in.
Allow User Registration: Set whether visitors to the web site site can register for a User account. If set to Yes the Login Form will also include the link... No account yet? Create one... If set to No there will be no option to register and only existing Registered Users will be able to access the member areas of the web site. Use New Account Activation: As an additional security measure it is possible to require new Users to confirm the e-mail address that was provided during the registration process is in fact valid. If this process is required by the site administrators then set the radio button to Yes. An activation link will be sent in an e-mail to the new User's e-mail address. New Users will be unable to log in to the web site until they have clicked the activation link. This link takes them to an activation page which would then confirm that they are able to log in. If the "No" radio button is chosen, Users will be able to log in right away without any further activation requirements. Front-end Login: Choose whether to have the Login Form fields displayed or not. This allows control of when Users can login to the web site but without making the site Offline or Unpublishing the Login Form Module . Select Yes to show the Username, Password, and ...No account yet? Create one...(if enabled above) fields and message. Select No to hide these same elements. Front-end User Param's: This option controls the additional functionality available to Users in the Front-end of the web site. For example: If set to No, Users are unable to choose which Editor is available to them and this defaults to the system choice or the selection made by the site administrators in the Back-end User Manager screen. They would normally be able to edit these parameters in the, default titled, Your Details selection of the Front-end User Menu. If set to Yes then a User has full access to any of the additional parameters (functionality) that may be allowed within Your Details. Require Unique E-mail: Select Yes to prevent registration with duplicate e-mail addresses. In combination with User activation, this option prevents Users from signing up more than once with the same e-mail address.Debug Site: Setting this to Yes allows PHP and database errors to be displayed. It is a tool for debugging (tracing) problems in code or connections and for reporting errors to the system administrator or web host. The levels of error reporting can be set under the Global Configuration=>Server tab. The levels available are:
The output of the debugger is shown at the foot of the current page. Even a page that is functioning without error shows a list of tests that the system has run, together with the resulting data.
Default WYSIWYG Editor: Choose, from the displayed list, which of the installed Text Editors should be used as the Global Default Editor to edit Content Items within the web site. This affects both Front-end and Back-end use. Selecting the No WYSIWYG option will open a very basic, plain text, editor for all authoring/editing functions on the web site. Additional editors can be installed. See the Joomla! Extensions Directory for a selection. If the Front- end User Param's (see above) is set to Yes then Users may select their own preference, but until they do this is the editor that will be set for them. List Length: It is possible to set a default length for all the lists in the Administrator (Back-end). These are the lists of Categories, Sections, Content Items, for example. Select the optimum number required from the drop down list.
Favourites Site Icon: This sets the icon that appears in a browsers address bar next to the name and/or address of the web site. By default this is the Joomla! icon. The image is, by default, called favicon.ico and is located in the joomla_ root/images directory of the installation. If a different icon is required to show up, a company or organisation logo for example, upload another icon to replace the Joomla! icon. Then type in the address of the icon in this field. Alternatively, change the name of the current icon to something else and upload the new icon to the same location and name it as favicon.ico. If no favourite icon is required to show at all, simply enter /. (forward slash and a full stop) and the default browser icon will be displayed instead.
Locale Tab:Language: English is the Language that is installed when a Joomla! web site is first created. It is set as the default Language. If a Language other than English is required the Language files must be installed first using the Language Installer - menu=>Installers=>Languages. See Install new Language - Site. Select the required Language from the drop down list. Time Offset: Identifies the time zone in which the web site is to operate. The time offset is set in hours +/- between the web site location and UTC (Universal Time Coordinated - formerly referred to as GMT (Greenwich Mean Time)). Select the time zone from the drop down list. Server Offset: Shows the number of hours between the time zone indicated in the Time Offset field above and the timezone in which the server itself is operating. This is a calculated field and cannot be altered. This offset is automatically applied by Joomla! to the Creation Date, Start and Finish Publishing criteria, amongst others.
Country Locale: Enter the location code of the web site. For instance en_GB is the Language (en) and country (GB) code for the UK.
Content Tab:Linked Titles: Select Yes, and the title of a Content Item will be hyper-linked to the full article. Selecting No creates a Read On... link to appear beneath the Intro text that links to the remainder of the Content Item that would have been typed in the Main Text screen during creation. Read More Link: This function creates an active link to additional pages of an article. Selecting Show displays the text Read more at the end of the Intro Text of a Content Item. To remove the link click Hide. Item Rating/Voting: This option allows Users to rate the Content Items of the web site. Select Yes, and a rating Star Bar will be shown on each Content Item, as well as a mini form comprising a series of 5 radio buttons and a submit button, for Users to submit their rating of the Content Item. Control who can vote in the Front-end using the the Access Level variable in Site Mambot: [ MOS Rating ]. Author Names: Select whether the name of the author of Content Items is displayed within the article. Select Hide to prevent the display and Show to activate the function. Created Date and Time: Select Show to display the date and time that the Content Items within the web site were created. Select Hide to prevent the date and time of creation from being displayed. Modified Date and Time: It is also possible to identify when a Content Item was last updated. Select the radio button Show, to allow the last modified date and time to be displayed. Select Hide to prevent the Last Modified time and date from being displayed. Hits: Hits displays the number of times the full article has been visited by Users. It does not count the number of times an item may have appeared if it is set to Show on Front Page. For a Hit to be registered the Linked Title or Read More links need to have been clicked upon. Select Show to display the number of hits a Content Item has received and Hide to conceal the display of this information. This does not affect the system counting the number of hits that an article has received, this data will still be recorded.
PDF Icon: Identify whether Users have the option to save a Content Item as a PDF file. Select the radio button Show to display the
Print Icon: Identify whether Users have the option that will allow them to print a copy of the Content Item to their local print spooler. Select the radio button Show
to display the
E-mail Icon: Identify whether Users have the option to e-mail the current Content Item to a friend. Select the radio button Show
to display the
Icons: If using icons for the e-mail, PDF and Print options does not suit the style of web site that is being developed, it is possible to include the functions but with simple word links instead of the icons. Choose the radio button Show to display the icons for these functions. Select the radio button Hide to show the basic hyperlink text version. Table of Contents on multi-page items: Select Show to display a Table of Contents for multiple page Content Items. This option is controlled by the Site Mambot: [ MOS Pagination ] .To disable this function select Hide.
Back Button: Select the radio button Show to include a navigational [ Back ] button on each page. This has a similar effect to a User clicking the Back arrow in their web browser. Select Hide to prevent this function being available. Content Item Navigation: Choose the radio button Show, to publish <<Prev...Next>> links when viewing Content Items in a Category or to change pages within the same article. The actual visual appearance of the link is controlled by the Site Template and CSS file.
Database Tab:
The settings displayed in this tab are those that were entered during the Installation procedure for this Joomla! web site.
If changes are made to these settings in the Global Configuration, and they do not match the MySQL settings themselves, the web site will become inoperable. Equally, if any of these settings are changed in the MySQL database then those changes MUST also be made in the following fields. Hostname: This is the name of the host of the database server and, therefore, the database upon which Joomla! is storing its data. For most web developers testing on a local machine, or a dedicated root server localhost is the default name. For those on shared or virtual host servers then this name will probably be different. MySQL Username: This is the username entered by the MySQL database administrator to access the database.
MySQL Password: This is the password - entered during the installation of Joomla! -
that together with the Username above, is used to access the MySQL
database upon which Joomla! stores its data. Do not edit this setting
unless absolutely necessary. MySQL Database: This is the name of the MySQL database upon which Joomla! stores its data. MySQL Database Prefix: This is the prefix that was entered during the installation of Joomla! It is used for the tables and records in the MySQL database. The default prefix for Joomla! is jos_.
Check the Joomla! Forums for further information.
Server Tab:Some of the information in this tab is for display purposes only. These items were defined during the installation of Joomla! and are not editable through this tab.
Absolute Path: This is the path to the root directory of the Joomla! installation, (referred to as joomla_root/) in the web servers file system. The information used by Joomla! to orientate it to the surrounding system. It will be necessary to edit this setting when, for example, changing server hosts, or when uploading a site from a local web server to an online web server. Live Site: This is the absolute URL (web address) for this installation of Joomla!. It may be necessary to edit this setting when, for example, changing server hosts, or when uploading a site from a local web server to an online web server. Secret Word: This is a unique alpha-numeric code for every Joomla! installation. It is created when Joomla! is first installed. It is used for security functions. See below...
GZIP Page Compression: Selecting the Yes radio button will allow the web server to send compressed data, if supported by the server, to the client web browser. This could significantly decrease the time taken for the site to load in a visitors web browser and therefore increase the usability of the web site. Select No to disable this feature. Site Session Lifetime: Enter the maximum number of seconds that Registered Users are allowed to be logged in to the Front-end of the web site, without activity, before automatic logout occurs. After automatic logout, the Registered User is required to login again using the correct Username and password to access any of the non-public Content Items or functions. Admin Session Lifetime: Enter the maximum number of seconds that administrators are allowed to be logged in to the Back-end of the web site, without activity, before automatic logout occurs. After automatic logout, the administrator is required to login again using the correct Username and password to access any of the Back-end functions.
Remember Expired Admin page: If an administrator logs back
in within ten minutes after the automatic logout they will be returned to the page they were
viewing prior to the automatic logout. If this was an editable page they will return to the Manager of that page and the Item will appear Session Authentication Method: Control how Session Authentication is handled within Joomla!. Select one of three options the first of which is the default level:
Level 3 Security creates a session_id based on the mosConfig_secret reference + a Random Number + the Users Full IP address + the User Agent reference. Level 2 Security creates a session_id based on the mosConfig_secret reference + a Random Number + the Users Subnet IP address + the User Agent reference. This was developed to assist web sites whose Users may primarily connect via AOL or are behind a Proxy bank. This is a less secure option than Level 3. Level 1 Security creates a session_id based only on a Random Number + the Users Full IP address. This is an old and outdated way of doing things. This is the least secure method and should not really be considered. In the above descriptions the following describes the individual element:
Error Reporting: This option sets the level of PHP error reporting that is produced when the Debug Site option is set to Yes in the Site Tab of the Global Configuration screen. For full details of PHP Error Reporting visit http://www.php.net/error-reporting. Options are:
Help Server: Enter the full URL of the server with the Help content upon it. By default this is set to http://help.joomla.org. This can be set to a local address if site specific Help files have been created. File Creation: Files created during the installation of new Components, Modules, and Mambots will automatically inherit the web server default file permissions. Selecting the option CHMOD new files allows the settings to be made manually for all files.
Directory Creation: Directories created during the installation of new Components, Modules, and Mambots will automatically inherit the web server default directory permissions. Selecting the option CHMOD new directories allows the settings to be made manually for all directories.
Meta data Tab:Global Site Meta Description: Enter a description of the web site that is to be used by Search Engines. The meta description tag takes the following form:
Consider the following ideas when creating the entry:
Global Site Meta Keywords: The meta keywords tag takes the following form:
The following should be kept in mind:
Show Title Meta Tag: Includes a "title" meta tag when viewing a Content Item. Show Author Meta Tag: Includes an "author" meta tag when viewing a Content Item.
Mail Tab:Mailer: Select the method that is to be used to send e-mails from the web site. Select from the choices in the drop down list:
Mail From: Enter the e-mail address that will appear on all e-mails sent out by the web site. For example admin@mydomainname.com From Name: Enter the name that will appear in the From field on all e-mails sent out by the web site. For example: The Admin Team; The Web Master; Sendmail Path: This field displays the path to the Sendmail program on the host. This field is only used if the Mailer field is set to Sendmail and the mail server is running the Sendmail program. SMTP Auth: Select Yes if SMTP Authentication is required by the host mail server. This field is only used if the Mailer field is set to SMTP Server. SMTP User: If SMTP Authentication is required by the host mail server, enter the Username for the account. This field is only used if the Mailer field is set to SMTP Server and the SMTP Auth field is set to Yes. SMTP Pass: If SMTP Authentication is required by the host mail server, enter the Password for the account. This field is only used if the Mailer field is set to SMTP Server and the SMTP Auth field is set to Yes. SMTP Host: The web server identifies itself to the mail server with this name when sending mail. This is normally set to localhost if the mail server is on the same machine as the web server, but it may be necessary to check this detail with the hosting company, as appropriate, if this is unclear. This field is only used if the Mailer field is set to SMTP Server.
Cache Tab:Caching is a means to improve the speed at which Joomla! shows its Content to a visitor when they select a Content Item. In essence Joomla! creates a copy of the database Content Items on the server hard disk. When a particular Content Item is requested by a visitor Joomla! will check the cache for the item and display it much quicker than if it had to send the request to the MySQL database. Caching: Select Yes to allow caching of certain elements within the Joomla! web site. Caching will generally improve the performance of the web site. Cache Folder: This is the path to, and directory where, Joomla! will store the cache files. This directory must be writable for caching to be successfully implemented. Cache Time: Edit the maximum length of time, in seconds, for a cache file to be stored before it is refreshed. If the Content on the web site is continually being updated as would be the case for example with an active forum, then a more frequent refresh rate would be justified. If, however, the web site is orientated more towards static Content, then setting a refresh rate of 12 or even 24 hours may be in order.
Statistics Tab:Statistics: Select Yes, to collect the browser and visitor domain statistics based upon the settings configured in the Content Tab. If this is set to No, the browser and visitor statistics will not be collected. If the web site experiences a slight delay whenever a User visits the site for the first time, set this to No. Log Content Hits by Date: Select Yes to enable logging of the hits on Content Items, on a daily basis. There are currently no in-built analysis routines, to complement this logging feature, for example, to remove extraneous commas. Select No to disable this feature.
Log Search Strings: Choose Yes to enable logging of the search text entered by a User. Such logging facilitates tuning of the web site. It may give an insight into how Users are trying to find the information they seek. It may also prove an invaluable resource in identifying potential weak areas in the web site content, particularly on more technically orientated sites. Analysis reporting is provided under menu=> Site=>Statistics=>Search Text.
SEO Tab:Search Engine Friendly URL's: This feature changes the way site links are presented and optimises them so that Search Engines can access more of your site. This option is ONLY available to sites hosted on Apache servers. Select Yes to enable Joomla! to output friendly URL's rather than normal, database generated URL's. If this feature is used then the htaccess.txt file must be renamed to .htaccess. This file is located by default in the root (or top) directory of your Joomla! installation. Select No to disable this feature. Dynamic Page Titles: Choose Yes to set the page descriptions that appear at the title bar of a viewers browser, to be the same as the page title they are viewing, rather than just the Site Name as entered in the Site Tab above. Again this helps Search Engines. Related Information:
Thank you!
The User Documentation Team |
|||||||||||||||||||||
| Last Updated ( Wednesday, 11 July 2007 ) | |||||||||||||||||||||