Actions

J1.5

Difference between revisions of "Global configuration"

From Joomla! Documentation

m (“Mail Settings” Group)
m (The Permissions Tab Options: breaking link, archiving done)
 
Line 1: Line 1:
{{underconstruction}}
+
{{version|1.5}}{{RightTOC}}
{{JVer|1.5}}{{JVer|1.6}}{{JVer|1.7}}  
+
 
== Introduction to Global Configuration ==
 
== Introduction to Global Configuration ==
This wiki article to expand on the information given about Global Configuration in the Joomla online Help, and also to provide hints and tips about use of the settings found in this part of the administrative interface. This article is written to support Joomla versions 1.5.x to 1.7.x.
+
This wiki article expands on the information given about Global Configuration in the Joomla online Help, and also to provide hints and tips about use of the settings found in this part of the administrative interface. This article is written to support Joomla versions 1.5.x to 3.1.x.
  
The Global Configuration area is part of the administrative interface, accessed via [http://example.com/pathtojoomla/administratora http://example.com/pathtojoomla/administrator] (also referred to as the “back end”). This area is accessible only if you are logged-in as a member of a group having the attribute of being Super Administrators (by default the Super Users group only). Once logged in, to access the page, go to '''Site > Global Configuration''' or click the Global Configuration icon from the main control panel.
+
The Global Configuration area is part of the administrative interface, accessed via [http://example.com/pathtojoomla/administratora http://example.com/pathtojoomla/administrator] (also referred to as the “backend”). This area is accessible only if you are logged-in as a member of a group having the attribute of being Super Administrators (by default the Super Users group only). Once logged in, to access the page go to '''Site > Global Configuration''' or click the Global Configuration icon from the main control panel.
  
 
== Overview ==
 
== Overview ==
As the title implies, Global Configuration is the area of the Joomla administrative interface where a user with Super Administrator attributes is able to make changes that globally affect the behaviour of the web site and also some default settings for the presentation of, and access to site content.
+
As the name implies, Global Configuration is the area of the Joomla administrative interface where a user with Super Administrator attributes is able to make changes that globally affect the behaviour of the web site and also alter some default settings for the presentation of, and access to site content.
  
All the parameters under the Site, System and Server tabs in the Global Configuration are stored as values in the file ''config.php'', found in the root folder of Joomla installation. This file is set up automatically by the software installation process and thus many of the parameters appearing in the Global Configuration screens are best left in their initial settings.
+
All the parameters under the Site, System and Server tabs in the Global Configuration are stored as values in the file ''configuration.php'', which you will find in the root folder of Joomla installation. This file is set up automatically by the software installation process and thus many of the parameters appearing in the Global Configuration screens are best left as their initial settings. Should Joomla be unable to update ''configration.php'' a message such as "Could not save data. Error: Could not write to the configuration file." will be displayed, rather than the usual "Configuration successfully saved.". There are a number of ways of overcoming this problem, please refer to [[Cannot save Global Configuration changes]] for further information.
  
The parameters controlled by a third tab, Permissions, (present only with Joomla v1.6.x and later) differ from those controlled via the other tabs in that they are stored within the site's database.
+
The parameters controlled by a third tab, Permissions, (present only with Joomla v1.6.x and later) differ from those controlled via the other tabs in that they are stored within the web site's database.
  
 
== The Toolbar ==
 
== The Toolbar ==
Line 21: Line 20:
 
* '''Close.''' Returns to the Administrator welcome screen without saving any changes to the Global Configuration.
 
* '''Close.''' Returns to the Administrator welcome screen without saving any changes to the Global Configuration.
 
* '''Help.''' Opens the Help Screen for Global Configuration.
 
* '''Help.''' Opens the Help Screen for Global Configuration.
 
=== The Joomla 1.6.x and Later Toolbar ===
 
* '''Save.''' Saves the any changes made under any tab and and the Global Configuration screen remains open so that editing or checking of global parameters can continue.
 
* '''Save & Close'''. As Save, but returns to the Administrator welcome screen.
 
* '''Cancel.''' Returns to the Administrator welcome screen without saving any changes to the Global Configuration.
 
* '''Help. '''Opens the Help Screen for Global Configuration.
 
  
 
== The Site Tab Options ==
 
== The Site Tab Options ==
'''Note: '''the order in which these items appear on the screen vary slightly between versions of Joomla
+
'''Note: '''the order in which these items appear on the screen vary slightly between the different versions of Joomla.
  
 
=== “Site Settings” Group ===
 
=== “Site Settings” Group ===
 
This group of options control a miscellaneous collection of parameters that broadly control the behaviour of the public web pages of the Joomla site.
 
This group of options control a miscellaneous collection of parameters that broadly control the behaviour of the public web pages of the Joomla site.
  
* '''Site Name.''' The name of the web site. This text provides an single-point of update of the site name and is typically used by site templates as the header text of each web page.  
+
* '''Site Name.''' The name of the web site. This text provides an single-point of update of the site name and is frequently used by site templates as the header text of each web page.  
  
 
* '''Site Offline.''' This setting provides a means of putting a site offline to general users by changing the default setting of “No” to “Yes”. When offline the public pages of the web site will be replaced by the Offline Message (see below) and a log-in form. Only Administrators are able to to log in the site when set to offline using this option. Once logged-in, Adminstrators are able to see the the web site and work on it as normal.
 
* '''Site Offline.''' This setting provides a means of putting a site offline to general users by changing the default setting of “No” to “Yes”. When offline the public pages of the web site will be replaced by the Offline Message (see below) and a log-in form. Only Administrators are able to to log in the site when set to offline using this option. Once logged-in, Adminstrators are able to see the the web site and work on it as normal.
Line 40: Line 33:
 
* '''Default Editor.''' The default text [http://help.joomla.org/proxy/index.php?option=com_help&view=help&keyref=Content_creators#Content_Editors editor] for use when creating or updating articles on the site. This may be “No editor” (edit raw HTML code only), one of editors pre-installed in Joomla, or an editor installed subsequently as an extension. The editor loaded when a registered site user starts editing text content may be overridden on a user-by-user basis, but in the absence of any such override it will be the Default Editor as set here.
 
* '''Default Editor.''' The default text [http://help.joomla.org/proxy/index.php?option=com_help&view=help&keyref=Content_creators#Content_Editors editor] for use when creating or updating articles on the site. This may be “No editor” (edit raw HTML code only), one of editors pre-installed in Joomla, or an editor installed subsequently as an extension. The editor loaded when a registered site user starts editing text content may be overridden on a user-by-user basis, but in the absence of any such override it will be the Default Editor as set here.
 
* '''Default Access Level.''' (only present in Joomla v1.6.x and later) The access level given by default to new content items, menu entries, etc. By default this is “Public”, but could be changed to other levels if – for example – it was undesirable for newly created items to be visible to all site users. The access level for any items may be overridden when created, or changed at a later point by anyone logged-in with the appropriate permissions.
 
* '''Default Access Level.''' (only present in Joomla v1.6.x and later) The access level given by default to new content items, menu entries, etc. By default this is “Public”, but could be changed to other levels if – for example – it was undesirable for newly created items to be visible to all site users. The access level for any items may be overridden when created, or changed at a later point by anyone logged-in with the appropriate permissions.
* '''Default List Limit.''' This sets the maximum number of items per page in lists displayed in various pages of the Joomla administrative interface, although this value may be overridden temporarily within the list pages themselves. . By default, this parameter is set to&nbsp;20 but may be changed to any of a number of values ranging from 5 to 100. <br />'''Tip:''' Use a larger value (50 or 100)&nbsp;than the default as it is usually easier to scroll up and down a list on a single page than to move between lots of short pages. Also if all items are on one page, it is much easier to a global search, for example for text in an article title.
+
* '''Default List Limit.''' This sets the maximum number of items per page in lists displayed in various pages of the Joomla administrative interface, although this value may be overridden temporarily within the list pages themselves. By default, this parameter is set to&nbsp;20 but may be changed to any of a number of values ranging from 5 to 100. <br />'''Tip:''' Use a larger value (50 or 100)&nbsp;than the default as it is usually easier to scroll up and down a list on a single page than to move between lots of short pages. Also if all items are on one page, it is much easier to carry out a global search, for example for text in an article title.
 
* '''Default Feed Limit.''' The number of content items to be shown in any RSS newsfeeds set up on the web site. By default, this is set to&nbsp;10, although unless the site is very active a smaller number may be better.
 
* '''Default Feed Limit.''' The number of content items to be shown in any RSS newsfeeds set up on the web site. By default, this is set to&nbsp;10, although unless the site is very active a smaller number may be better.
 
* '''Feed Email.''' Atom and RSS newsfeeds generated from site content by the Joomla “Syndicate feeds” (“Syndication” in Joomla v1.5.x) site module may include an e-mail address as part of the author's identity. This parameter determines the source of that email address: the “Author Email” setting will use the email address held on the site for content author, “Site E-mail” will use the “From email” address set up under the Server tab (see below) for emails generated automatically by the web site.<br />'''Tip:''' “Site E-mail” is usually the preferred setting if content syndication is being used on a web site. This is because the alternative will expose the content authors' email addresses to collection by spam lists.
 
* '''Feed Email.''' Atom and RSS newsfeeds generated from site content by the Joomla “Syndicate feeds” (“Syndication” in Joomla v1.5.x) site module may include an e-mail address as part of the author's identity. This parameter determines the source of that email address: the “Author Email” setting will use the email address held on the site for content author, “Site E-mail” will use the “From email” address set up under the Server tab (see below) for emails generated automatically by the web site.<br />'''Tip:''' “Site E-mail” is usually the preferred setting if content syndication is being used on a web site. This is because the alternative will expose the content authors' email addresses to collection by spam lists.
  
 
=== “Metadata Settings” Group ===
 
=== “Metadata Settings” Group ===
This group of options control the presence or content of several of the metadata entries (i.e. code like ''<nowiki><meta name = …. \></nowiki>'') in the header of each page of the web site. Although not visible to the site user, metadata entries may be used in various ways by web search engines and their appropriate use can significantly aid the search rankings and visibility of a web site. Note that several of the following metadata parameters my be overridden at the content category and individual content item levels.  
+
This group of options control the presence or content of several of the metadata entries (i.e. code like ''<nowiki><meta name = …. \></nowiki>'') in the header of each page of the web site. Although not visible to the site user, metadata entries may be used in various ways by web search engines and their appropriate use can significantly aid the search rankings and visibility of a web site. Note that several of the following metadata parameters my be overridden for the content categories and individual content items.  
  
 
* '''Site Meta Description.''' Text added here appears in web page headers as the “description” metadata entry. Search engines often use this to provide descriptive text for your web pages in place some (possibly inappropriate) text from the content of the web page. A description of around 20 words is recommended. This metadata entry is omitted from web pages if this entry is blank.
 
* '''Site Meta Description.''' Text added here appears in web page headers as the “description” metadata entry. Search engines often use this to provide descriptive text for your web pages in place some (possibly inappropriate) text from the content of the web page. A description of around 20 words is recommended. This metadata entry is omitted from web pages if this entry is blank.
Line 56: Line 49:
 
SEO is an abbreviation of ''Search Engine Optimization''. Settings in this group alter the format of URLs for pages in the web site, and this may have a significant effect of the search rankings of individual pages, as well as making URLs more human-friendly.
 
SEO is an abbreviation of ''Search Engine Optimization''. Settings in this group alter the format of URLs for pages in the web site, and this may have a significant effect of the search rankings of individual pages, as well as making URLs more human-friendly.
  
'''Tip:''' after making any changes to the settings in this group, refresh any of the web site's pages already open in your web browser (usually Ctrl+R will do this). Failure to so this will likely mean that the format of web links internal to the site no longer match that which Joomla is expecting and give the appearance of broken links.
+
'''Tip:''' after making any changes to the settings in this group, refresh any of the web site's pages already open in your web browser (usually Ctrl+R will do this). Failure to so this will likely mean that the format of web links internal to the site no longer match that which Joomla is expecting and thus give the appearance of broken links.
  
 
'''Tip: '''Avoid if at all possible altering the SEO Settings once a web site is established. Changing any of the first three items below will mean that nearly all of a site's URLs will also change and result in broken links from other sites and perhaps a temporary drop in search engine rankings.
 
'''Tip: '''Avoid if at all possible altering the SEO Settings once a web site is established. Changing any of the first three items below will mean that nearly all of a site's URLs will also change and result in broken links from other sites and perhaps a temporary drop in search engine rankings.
  
* '''Search Engine Friendly URLs.''' Joomla's internal representation of URLs tends to be lengthy and also difficult to interpret by humans and search engine spiders. This is a typical example of the internal URL for a page displaying a content item: [http://www.example.com/index.php?option=com_content&view=article&id=22&Itemid=437 www.example.com/index.php?option=com_content&view=article&id=22&Itemid=437]If this Global Configuration option is set to “yes”, the URL is modified into a shorter and more meaningful form: [http://www.example.com/index.php/getting-started www.example.com/index.php/getting-started]The identifying text in the URL (in this case “getting_started”) is derived from the Alias text set up for each Category, content item, and Menu item. The default setting is&nbsp;“No”.
+
* '''Search Engine Friendly URLs.''' Joomla's internal representation of URLs tends to be lengthy and also difficult to interpret by humans and search engine spiders. This is a typical example of the internal URL for a page displaying a content item: [http://www.example.com/index.php?option=com_content&view=article&id=22&Itemid=437 www.example.com/index.php?option=com_content&view=article&id=22&Itemid=437]. If this Global Configuration option is set to “yes”, the URL is modified into a shorter and more meaningful form: [http://www.example.com/index.php/getting-started www.example.com/index.php/getting-started]. The identifying text in the URL (in this case “getting_started”) is derived from the Alias text set up for each Category, content item, and Menu item. The default setting is&nbsp;“No”.
* '''Use Apache&nbsp;mod_rewrite. '''When this parameter is set to&nbsp;“Yes, Joomla will use the&nbsp;mod_rewrite&nbsp;function of Apache web servers to eliminate the ''index.php'' part of the URL. Thus when this is operating the “search engine friendly” URL shown above will become:[http://www.example.com/getting-started www.example.com/getting-started]<br />'''Note:''' This parameter is set to “No” by default. It should not be set to “Yes” unless the web server uses Apache software and has been set up so that mod_rewrite is installed and will work with your web site (see [[How to check if mod rewrite is enabled on your server|here]] for how to check). Also for this function to work, the&nbsp;''htaccess.txt&nbsp;''file installed in the root directory of the web site (or preferably a copy of it) should be renamed to''&nbsp;.htaccess''. As an incorrectly configured ''.htaccess'' file can easily cause major server errors, so do not modify the ''.htaccess''&nbsp;file unless you understand how it works.
+
* '''Use Apache&nbsp;mod_rewrite. '''When this parameter is set to&nbsp;“Yes, Joomla will use the&nbsp;mod_rewrite&nbsp;function of Apache web servers to eliminate the ''index.php'' part of the URL. Thus when this is operating the “search engine friendly” URL shown above will become: [http://www.example.com/getting-started www.example.com/getting-started].<br />'''Note:''' This parameter is set to “No” by default. It should not be set to “Yes” unless the web server uses Apache software and has been set up so that mod_rewrite is installed and will work with your web site (see [[How to check if mod rewrite is enabled on your server|here]] for how to check). Also for this function to work, the&nbsp;''htaccess.txt&nbsp;''file installed in the root directory of the web site (or preferably a copy of it) should be renamed to''&nbsp;.htaccess''. As an incorrectly configured ''.htaccess'' file can easily cause major server errors, so do not modify the ''.htaccess''&nbsp;file unless you understand how it works.
* '''Adds Suffix to URL.''' When set to&nbsp;“Yes”, Joomla will add&nbsp;''.html&nbsp;''to the end of the most site URLs thus simulating static file-based web content. The URLs shown above will then become: [http://www.example.com/getting-started.html www.example.com/index.php/getting-started.html]or[http://www.example.com/getting-started.html www.example.com/getting-started.html]This setting is largely down to personal preference, but bearing in mind that it is easy to confuse ''.htm'' and .''html'' suffixes when typing URLs, the advantage my lie with having this feature switched off. The default setting is&nbsp;“No”.
+
* '''Adds Suffix to URL.''' When set to&nbsp;“Yes”, Joomla will add&nbsp;''.html&nbsp;''to the end of the most site URLs thus simulating static file-based web content. The URLs shown above will then become: [http://www.example.com/getting-started.html www.example.com/index.php/getting-started.html] or [http://www.example.com/getting-started.html www.example.com/getting-started.html]. This setting is largely down to personal preference, but bearing in mind that it is easy to confuse ''.htm'' and .''html'' suffixes when typing URLs, the advantage my lie with having this feature switched off. The default setting is&nbsp;“No”.
* '''Unicode aliases. '''(Only present in Joomla v1.6.x and later.) Choose between “Transliteration” and “Unicode” aliases. When saving edited content, the former setting attempts to convert, where appropriate, any alias text into the corresponding Latin characters. The latter setting leaves unchanged any non-Latin characters in the alias text. Changing this parameter does not retrospectively change aliases, it just changes the behaviour of automatic alias generation for future content editing and creation. “Transliteration” is default.
+
* '''Unicode aliases. '''(Only present in Joomla v1.6.x and later.) Choose between “Transliteration” and “Unicode” aliases. When saving edited content, the former setting attempts to convert, where appropriate, any alias text into the corresponding Latin characters. The latter setting leaves any non-Latin characters in the alias text unchanged. Changing this parameter does not retrospectively change aliases, it just changes the behaviour of automatic alias generation for future content editing and creation. “Transliteration” is the default setting.
 
* '''Add Site Name To Page Titles.''' (Only present in Joomla v1.6.x and later.) Appends the site name to page titles in the ''<nowiki><title></nowiki>'' tag of each web page header. (This text usually appears in the top bar of the web browser window and/or on the browser tab.) Joomla v1.6.x introduced this feature as an option to either include the site name text before the page title (e.g. ''Site Name – Page Name'') or omit it. With Joomla v1.7.x the options also include inserting the site name after the page name (e.g. ''Page Name – Site Name'') as well as before.
 
* '''Add Site Name To Page Titles.''' (Only present in Joomla v1.6.x and later.) Appends the site name to page titles in the ''<nowiki><title></nowiki>'' tag of each web page header. (This text usually appears in the top bar of the web browser window and/or on the browser tab.) Joomla v1.6.x introduced this feature as an option to either include the site name text before the page title (e.g. ''Site Name – Page Name'') or omit it. With Joomla v1.7.x the options also include inserting the site name after the page name (e.g. ''Page Name – Site Name'') as well as before.
  
Line 69: Line 62:
 
Only present in Joomla v1.6.x and later, these settings allow the site cookies to be modified to suit certain circumstances. For the majority of web sites these entries may be left blank.
 
Only present in Joomla v1.6.x and later, these settings allow the site cookies to be modified to suit certain circumstances. For the majority of web sites these entries may be left blank.
  
* '''Cookie Domain.''' Overrides the site's default cookie domain with .the domain added here. The most likely situation when this would be needed is when the Joomla sit is “bridged with other sites (e.g. forum or ecommerce) in subdomains of the Joomla site. The default cookie domain may be like [http://www.example.com/ www.example.com], but using [http://.example.com/ .example.com] (note the leading dot) here will deliver cookies valid for any subdomain of example.com.<ref>[http://forum.joomla.org/viewtopic.php?p=1383912| FEATURE REQ: Cookie settings in Global Configuration]</ref>
+
* '''Cookie Domain.''' Overrides the site's default cookie domain with .the domain added here. The most likely situation when this would be needed is when the Joomla sit is “bridged with other sites (e.g. forum or e-commerce) in sub-domains of the Joomla site. The default cookie domain may be like [http://www.example.com/ www.example.com], but using [http://.example.com/ .example.com] (note the leading dot) here will deliver cookies valid for any sub-domain of example.com.
 
* '''Cookie Path.''' Overrides the site's default path for which the cookie is valid&nbsp;with the path added here.
 
* '''Cookie Path.''' Overrides the site's default path for which the cookie is valid&nbsp;with the path added here.
  
Line 82: Line 75:
 
This section of the interface is present here only in Joomla v1.5.x. In later versions of Joomla it is accessed through the Options button on the User Manager screen (Users > User manager).
 
This section of the interface is present here only in Joomla v1.5.x. In later versions of Joomla it is accessed through the Options button on the User Manager screen (Users > User manager).
  
Note: the User Settings parameters are an exception in that they are not stored in the ''configuration.php'' file, but are held in the site database as parameters of the Users Component.
+
'''Note:''' the User Settings parameters are an exception in that they are not stored in the ''configuration.php'' file, but are held in the site database as parameters of the Users Component.
  
 
* '''Allow User Registration.''' If set to “Yes” enables new users to create an account and adds a “Create an account”link to the standard login form. As a security measure this should be set to “No” unless there is a need for self-registration of new users.
 
* '''Allow User Registration.''' If set to “Yes” enables new users to create an account and adds a “Create an account”link to the standard login form. As a security measure this should be set to “No” unless there is a need for self-registration of new users.
 
* '''New User Registration Type.''' The Access Level automatically allocated to users self-registering on the web site. The default is “Registered”.
 
* '''New User Registration Type.''' The Access Level automatically allocated to users self-registering on the web site. The default is “Registered”.
* '''New User Account Activation.''' If set to “Yes”, new users will be emailed on registration with a link to a web page. They must then visit this web page before they are able to log in to the web site using their new account.
+
* '''New User Account Activation.''' If set to “Yes”, new users will be emailed on registration with a link to a web page. They must then visit this web page before they are able to log in to the web site using their new account. This process validates the email address given by the new user, and confirms that the user has access to it.
 
* '''Front-end User Parameters.''' If set to “Yes”, users will be able to access a form where they will be able to change change their preferences for site languages, content editor, time zone settings, and source of help pages. This is in addition to being able to change their name, email address and password, all available independently of this setting.
 
* '''Front-end User Parameters.''' If set to “Yes”, users will be able to access a form where they will be able to change change their preferences for site languages, content editor, time zone settings, and source of help pages. This is in addition to being able to change their name, email address and password, all available independently of this setting.
  
Line 95: Line 88:
  
 
* '''Legal Extensions (File Types).''' This is a comma-separated list of file name extensions that defines the types of files that users may upload. The default list includes all the common image and media file formats likely to be used on a web site.
 
* '''Legal Extensions (File Types).''' This is a comma-separated list of file name extensions that defines the types of files that users may upload. The default list includes all the common image and media file formats likely to be used on a web site.
* '''Maximum Size (in bytes). '''The maximum size of file in bytes that size users are allowed to upload to the web site. The default setting is “10000000”&nbsp;(or 10MB).'''Note:''' that you may also have to change some server parameters to enable the web site to upload large files, for example upload parameters in ''php.ini''.
+
* '''Maximum Size (in bytes). '''The maximum size of file in bytes that size users are allowed to upload to the web site. The default setting is “10000000”&nbsp;(or approx. 10MB).<br/>'''Note:''' that you may also have to change some server parameters to enable the web site to upload large files, for example upload parameters in ''php.ini''.
* '''Path to Media Folder.''' This is the path, relative to the folder where the Joomla site is installed, where media files will be stored. The default is – confusingly – “images. '''Note: '''the path entry should not include leading and trailing forward slashes.
+
* '''Path to Media Folder.''' This is the path, relative to the folder where the Joomla site is installed, where media files will be stored. The default is – confusingly – “images. <br/>'''Note: '''the path entry should not include leading and trailing forward slashes.
* '''Path to Image Folder.''' This is the path, relative to the folder where the Joomla site is installed, where image files will be stored. The default is “images/stories”. '''Note: '''the path entry should not include leading and trailing forward slashes.
+
* '''Path to Image Folder.''' This is the path, relative to the folder where the Joomla site is installed, where image files will be stored. The default is “images/stories”.<br/>'''Note: '''the path entry should not include leading and trailing forward slashes.
 
* '''Restrict Uploads.''' If set to “Yes” (the default and recommended setting) Joomla will restrict uploads to image file formats only. This restriction applies only to uploads by users with permission levels below Manager. The restriction only applies if the web server does not have installed either of the PHP modules ''Fileinfo'' or ''mime_magic''. These modules are used to detect the type of a file independently of its name extension. They are used in Joomla – if available – to enhance site security by confirming that any uploads are not a file format that could be used for malicious purposes.
 
* '''Restrict Uploads.''' If set to “Yes” (the default and recommended setting) Joomla will restrict uploads to image file formats only. This restriction applies only to uploads by users with permission levels below Manager. The restriction only applies if the web server does not have installed either of the PHP modules ''Fileinfo'' or ''mime_magic''. These modules are used to detect the type of a file independently of its name extension. They are used in Joomla – if available – to enhance site security by confirming that any uploads are not a file format that could be used for malicious purposes.
* '''Minimum User Level for Media Manager.''' This sets the lowest level of user that is able to use the media upload function in the “frontend” content editor. The selected user level and any higher levels will be able to use this function.
+
* '''Minimum User Level for Media Manager.''' This sets the lowest level of user that is able to use the media upload function in the “fron-tend” content editor. The selected user level and any higher levels will be able to use this function.
 
* '''Check MIME Types. '''Check the type of contents in a file (the “MIME Type”) by examining the data rather than depending on the file name extension. (see ''Fileinfo'' and ''mime_magic ''under Restrict Uploads above''.'') This is a useful security feature so the default is “Yes”, but may be switched off if it causes an unacceptable level of error messages.
 
* '''Check MIME Types. '''Check the type of contents in a file (the “MIME Type”) by examining the data rather than depending on the file name extension. (see ''Fileinfo'' and ''mime_magic ''under Restrict Uploads above''.'') This is a useful security feature so the default is “Yes”, but may be switched off if it causes an unacceptable level of error messages.
 
* '''Legal Image Extensions (File Types)'''. Defines the file types that may be uploaded as site images. This is a comma-separated list of filename extensions denoting the acceptable file types.
 
* '''Legal Image Extensions (File Types)'''. Defines the file types that may be uploaded as site images. This is a comma-separated list of filename extensions denoting the acceptable file types.
* '''Ignored Extensions. '''Defines the file types will not be subjected to MIME Type checking. This is a comma-separated list of filename extensions for the ignored file types and is blank by default.
+
* '''Ignored Extensions. '''Defines the file types that will not be subjected to MIME Type checking. This is a comma-separated list of filename extensions for the ignored file types and is blank by default.
* '''Legal MIME Types'''. This sets the list of acceptable MIME (file content) types for Media uploads. By default, this list includes the standard file types likely to be used. It is recommended that you do not alster this parameter unless you&nbsp;are familiar with MIME Types and their application.
+
* '''Legal MIME Types'''. This sets the list of acceptable MIME (file content) types for Media uploads. By default, this list includes the standard file types likely to be used. It is recommended that you do not alter this parameter unless you&nbsp;are familiar with MIME Types and their application.
 
* '''Illegal MIME Types.''' This sets the list of blocked MIME (file content) types for Media uploads. By default, this list includes just one item, ''text/html.'' If permitted, this data format could be used to embed malicious code in the site content.
 
* '''Illegal MIME Types.''' This sets the list of blocked MIME (file content) types for Media uploads. By default, this list includes just one item, ''text/html.'' If permitted, this data format could be used to embed malicious code in the site content.
  
 
=== “Debug Settings” Group===
 
=== “Debug Settings” Group===
* '''Debug System.''' If set to “Yes”, Joomla will add debug information on every web page, below the normal page content. This will include various forms of diagnostic information, including the full database queries used in generating the page. The default setting is “No”. The mix and format of diagnostic information presented by the debug function may be altered by editing the parameters of the Debug - System plug-in (Extensions > Plug-in Manager). '''Note:''' the debug information displayed with this parameter set to “Yes” is visible to all users and thus may be a security risk if used on a public web site. The debug information is visible even if Site Offline is set to “Yes”.  
+
* '''Debug System.''' If set to “Yes”, Joomla will add debug information on every page, below the normal web page area. This information will include various forms of diagnostic information, including the full database queries used in generating the page. The default setting is “No”. The mix and format of diagnostic information presented by the debug function may be altered by editing the parameters of the Debug - System plug-in (Extensions > Plug-in Manager).<br/>'''Note:''' the debug information displayed with this parameter set to “Yes” is visible to all users and thus may be a security risk if used on a public web site. The debug information is visible even if Site Offline is set to “Yes”.  
 
* '''Debug Language. '''<nowiki>If set to “Yes”, Joomla will activate features designed to help debug language translations for a Joomla site. This includes the addition of language translation information to page debug information (requires Debug System also set to “Yes”), and markers to show translated content within the web pages themselves. For further information, refer to</nowiki> [[Debugging a translation]].
 
* '''Debug Language. '''<nowiki>If set to “Yes”, Joomla will activate features designed to help debug language translations for a Joomla site. This includes the addition of language translation information to page debug information (requires Debug System also set to “Yes”), and markers to show translated content within the web pages themselves. For further information, refer to</nowiki> [[Debugging a translation]].
  
Line 113: Line 106:
 
'''Note: '''The order shown below is that used in Joomla V1.5.x. The positions of Cache Time and Cache Handler are reversed in later versions.
 
'''Note: '''The order shown below is that used in Joomla V1.5.x. The positions of Cache Time and Cache Handler are reversed in later versions.
  
* '''Cache''' This setting controls whether or not site caching is enabled. When enabled, web pages are held for a period of time in cache storage and are retrieved from there rather than being re-created each time required. Caching is a strategy to reduce the loading presented by busy web sites to a web server. The default setting is “No”.'''Tip: '''When debugging a Joomla site, switch off the cache as it may hide changes to web pages. and thus mask the effect of modifications to web site code.
+
* '''Cache''' This setting controls whether or not site caching is enabled. When enabled, web pages are held for a period of time in cache storage and are retrieved from there rather than being re-created each time required. Caching is a strategy to reduce the loading presented by busy web sites to a web server. The default setting is “No”.<br/>'''Tip: '''When debugging a Joomla site, switch off the cache as it may hide changes to web pages. and thus mask the effect of modifications to web site code.
 
* '''Cache Time.''' This parameter defines the maximum time for which web pages are held in the cache storage before being updated with the current version. The default is 15 minutes.
 
* '''Cache Time.''' This parameter defines the maximum time for which web pages are held in the cache storage before being updated with the current version. The default is 15 minutes.
* '''Cache Handler.''' This setting defines the mechanism used to manage the cache storage. <ref>[[Cache|Joomla! Cache Documentation]]</ref>
+
* '''Cache Handler.''' This setting defines the mechanism used to manage the cache storage.<ref>[[Cache|Joomla! Cache Documentation]]</ref>
  
 
=== “Session Settings” Group===
 
=== “Session Settings” Group===
The “session” is the data that identifies and relates to a specific web site user and persists as that user moves from page to page.
+
The “session” is the data that identifies and relates to a specific web site user, and which persists as that user moves from page to page.
  
* '''Session Lifetime.''' This parameter determines how long a before user is automatically logged off for being inactive. The default setting is 15 minutes, although it can be useful to lengthen this parameter on development sites to avoid having to repeatedly log back in.
+
* '''Session Lifetime.''' This parameter determines how long a before user is automatically logged off for being inactive. The default setting is 15 minutes, although it can be useful to temporarily lengthen this parameter on development sites to avoid having to repeatedly log back in.
 
* '''Session Handler.''' Selects the mechanism used to hold session information between one page request and the next one from the same user. The options are “Database” (the default) and “None”. The former stores session information as entries in a table in the site's Joomla database, the latter uses the session handling mechanism built in to PHP.
 
* '''Session Handler.''' Selects the mechanism used to hold session information between one page request and the next one from the same user. The options are “Database” (the default) and “None”. The former stores session information as entries in a table in the site's Joomla database, the latter uses the session handling mechanism built in to PHP.
  
Line 127: Line 120:
 
* '''Path to Temp Folder.''' This is the full path to the folder on the server that Joomla and its extensions&nbsp;will use for temporary file storage. This folder location is set up on Joomla installation and should not normally be changed.
 
* '''Path to Temp Folder.''' This is the full path to the folder on the server that Joomla and its extensions&nbsp;will use for temporary file storage. This folder location is set up on Joomla installation and should not normally be changed.
 
* '''GZIP Page Compression.''' If set to “Yes”, the web server will compress the content sent out from your Joomla site. This will speed-up page load times, especially for web site users who have a low-bandwidth connection. The default setting is “No”.
 
* '''GZIP Page Compression.''' If set to “Yes”, the web server will compress the content sent out from your Joomla site. This will speed-up page load times, especially for web site users who have a low-bandwidth connection. The default setting is “No”.
* '''Error Reporting. '''This parameter sets the level of error reporting to be used by PHP on the Joomla site. It has four options: System Default, None, Simple, and Maximum. 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” and “Maximum” override the server setting to give a basic level of reporting and the reporting of all errors, respectively. '''Tip:''' Should your Joomla site fail to the extent that it is not possible to use the Administrator pages 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 '6143' is the equivalent to setting Error Reporting to “Maximum”. <ref>[http://www.technowise.in/2011/02/turning-on-error-reporting-in-joomla.html | Turning On Error Reporting in Joomla]</ref>.
+
* '''Error Reporting. '''This parameter sets the level of error reporting to be used by PHP on the Joomla site. It has four options: System Default, None, Simple, and Maximum. 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” and “Maximum” override the server setting to give a basic level of reporting and the reporting of all errors, respectively. <br/>'''Tip:''' Should your Joomla site fail to the extent that it is not possible to use the Administrator pages 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 '6143' is the equivalent to setting Error Reporting to “Maximum”.
* '''Force SSL.''' This parameter has three options: “None”, “Administrator Only”, and “Entire Site”. Using the appropriate setting, this parameter forces any web browser connections to the administrative “backend”, or to the complete Joomla site, to use the secure HTTP protocol (HTTPS). The “Entire Site” setting is appropriate where security of any web transaction (e.g. e-commerce) is important. Ideally there should also be an appropriate certificate in place to verify the identity of your web site. The “Administrator Only” setting is ideal for enhancing the security of other types of web site as it encrypts “backend” content and passwords that could be put to malicious use if intercepted. '''Note:''' before moving away from the default setting of “None”, it is essential that you check the server delivering your web site is capable of operating in HTTPS mode.
+
* '''Force SSL.''' This parameter has three options: “None”, “Administrator Only”, and “Entire Site”. Using the appropriate setting, this parameter forces any web browser connections to the administrative “backend”, or to the complete Joomla site, to use the secure HTTP protocol (HTTPS). The “Entire Site” setting is appropriate where security of any web transaction (e.g. e-commerce) is important. Ideally there should also be an appropriate certificate in place to verify the identity of your web site. The “Administrator Only” setting is ideal for enhancing the security of other types of web site as it encrypts “backend” content and passwords that could be put to malicious use if intercepted. <br/>'''Note:''' before moving away from the default setting of “None”, it is essential that you check the server delivering your web site is capable of operating in HTTPS mode.
  
 
=== “Location Settings” Group ===
 
=== “Location Settings” Group ===
 
Appears as “Locale Settings” in v1.5.x
 
Appears as “Locale Settings” in v1.5.x
  
* '''Server Time Zone '''('''Time Zone'''<nowiki> in V1.5.x). Sets the time zone for use across the web site, based on a choice of capital cities. (default is “London”, UTC 00:00) Internally, Joomla stores the date and time of events as UTC</nowiki><ref>[[wikipedia:Coordinated_Universal_Time|Wikipedia - Coordinated Universal Time]]</ref>. <nowiki>It then uses “Server Time Zone” to set the appropriate offset to display time and date information on the web site in the server's local time zone. </nowiki>'''Note:''' that each user also has a time zone parameter that, by default, is the same as the Server Time Zone but which may be changed to reflect the preferred time zone of that user.
+
* '''Server Time Zone '''('''Time Zone'''<nowiki> in V1.5.x). Sets the time zone for use across the web site, based on a choice of capital cities. (default is “London”, UTC 00:00) Internally, Joomla stores the date and time of events as UTC</nowiki><ref>[[wikipedia:Coordinated_Universal_Time]]</ref>. <nowiki>It then uses “Server Time Zone” to set the appropriate offset to display time and date information on the web site in the server's local time zone. </nowiki>'''Note:''' that each user also has a time zone parameter that, by default, is the same as the Server Time Zone but which may be changed to reflect the preferred time zone of that user.
  
 
=== “FTP Settings” Group ===
 
=== “FTP Settings” Group ===
 
A significant problem with running scripted programs – such as Joomla – on Linux and similar servers is that the files and folders making up the program are not owned by the same identity as the one used to execute the web server code. The files and folders making up the web site will usually be put in place on the server by means of FTP, and thus will be owned by the personal log-in identity used for FTP access. In contrast, the web server code will be executed by a generic identity used for automatic processes within the server.  
 
A significant problem with running scripted programs – such as Joomla – on Linux and similar servers is that the files and folders making up the program are not owned by the same identity as the one used to execute the web server code. The files and folders making up the web site will usually be put in place on the server by means of FTP, and thus will be owned by the personal log-in identity used for FTP access. In contrast, the web server code will be executed by a generic identity used for automatic processes within the server.  
  
Because the of this difference between the FTP upload and web server identities, automatic updates of the web site code (e.g. installing or updating extensions) will be blocked by the security features that prevent one user's files being altered by others.
+
Because the of this difference between the FTP upload and web server identities, automatic updates of the web site code (e.g. installing or updating extensions) will be blocked by the security features that prevent one user's files being altered by another user.
  
The solution to this problem is for Joomla to use FTP when installing or deleting files, and it is essential that the FTP log-on credentials used are the same as used in installing the original Joomla web site.
+
One solution to this problem is for Joomla to use FTP when installing or deleting files, and if this is used it is essential that the FTP log-on credentials are the same as those used when installing the Joomla web site.
  
 
The FTP option is generally only needed on shared servers using Linux and Unix-like operating systems. The problem does not arise with other operating systems, and on dedicated servers there is the alternative option of changing the ownership and/or permissions of the web site files so that they may be modified by the web server processes.
 
The FTP option is generally only needed on shared servers using Linux and Unix-like operating systems. The problem does not arise with other operating systems, and on dedicated servers there is the alternative option of changing the ownership and/or permissions of the web site files so that they may be modified by the web server processes.
Line 149: Line 142:
 
* '''FTP Host.''' The URL to be used for FTP access to the Joomla web site files.
 
* '''FTP Host.''' The URL to be used for FTP access to the Joomla web site files.
 
* '''FTP Port. '''Generally “21”. You will be advised by your web hosting provider if a different port number needs to be used for FTP access to your site files.
 
* '''FTP Port. '''Generally “21”. You will be advised by your web hosting provider if a different port number needs to be used for FTP access to your site files.
* '''FTP Username.''' The user identity that Joomla will use forFTP access. This must be the same identity as used in setting up the web site.
+
* '''FTP Username.''' The user identity that Joomla will use for FTP access. This must be the same identity as used in setting up the web site.
 
* '''FTP Password. '''The password for the above user identity.
 
* '''FTP Password. '''The password for the above user identity.
* '''FTP Root.''' This is the path from the FTP log-in location to the folder that holds the Joomla site.  
+
* '''FTP Root.''' This is the path from the FTP log-in location to the folder that holds the Joomla site.
  
 
=== “Database Settings” Group ===
 
=== “Database Settings” Group ===
These parameters identify the database location, the database and tables within that database that hold configuration and content information for your web site. It also includes the username required for accessing the database contents, but '''not''' the password associated with that username. Should you need to change the database password, edit the line defining the value of ''$password'' in the file ''configuration.php'', to be found in the Joomla installation folder.
+
These parameters identify the database location, the database and tables within that database that hold configuration and content information for your web site. It also includes the username required for accessing the database contents, but '''not''' the password associated with that username. Should you need to change the database password, edit the line defining the value of ''$password'' in the file ''configuration.php'', which you will find in the Joomla installation folder.
  
* '''Database Type.'''<nowiki> This determines the type of the database being used by this Joomla installation and also the type of interface used to access the database. Current versions of Joomla only operate with MySQL databases, with v1.6.x and later versions offering a choice of “MySQL” and “MySQLi”. These are two different PHP interfaces to MySQL databases. The latter should be used if possible as it should work with all modern implementations of MySQL server, and offers a number of advantages over the MySQL interface. <ref>[[http://uk2.php.net/manual/en/mysqli.overview.php |]]PHP MySQLi Overview</ref></nowiki>
+
* '''Database Type.'''<nowiki> This determines the type of the database being used by this Joomla installation and also the type of interface used to access the database. Current versions of Joomla only operate with MySQL databases, with v1.6.x and later versions offering a choice of “MySQL” and “MySQLi”. These are two different PHP interfaces to MySQL databases. The latter should be used if possible as it should work with all modern implementations of MySQL server, and offers a number of advantages over the MySQL interface.</nowiki><ref>[http://uk2.php.net/manual/en/mysqli.overview.php|PHP MySQLi Overview]</ref>
 
* '''Host '''('''Hostname''' in v1.5,x). The hostname of the database server to be used. In most web hosting situations, the database server is located in the same system as the web server and this parameter should then be set to “localhost”. Otherwise this setting should be the server name or IP address (e.g. “mysql.example.com”).
 
* '''Host '''('''Hostname''' in v1.5,x). The hostname of the database server to be used. In most web hosting situations, the database server is located in the same system as the web server and this parameter should then be set to “localhost”. Otherwise this setting should be the server name or IP address (e.g. “mysql.example.com”).
* '''Database Username''' ('''Username''' in v1.5.x). The username required to acccess the database carrying the Joomla site's data tables.
+
* '''Database Username''' ('''Username''' in v1.5.x). The username required to access the database carrying the Joomla site's data tables.
 
* '''Database Name''' ('''Database''' in v1.5.x). The name of the database carrying the Joomla site's data tables.
 
* '''Database Name''' ('''Database''' in v1.5.x). The name of the database carrying the Joomla site's data tables.
 
* '''Database Table Prefix. '''The prefix applied to the name of the database tables used by this Joomla installation. For Joomla v1.5.x and v1.6.x this is “jos_” by default, and should another Joomla site have to share the same database, the database tables would be kept separate by setting up this second site with a different prefix – e.g. “jos2_”. With Joomla v1.7.x the same result is achieved by using a prefix that is a randomly generated alphabetic code and underscore – e.g. “vduea_”.
 
* '''Database Table Prefix. '''The prefix applied to the name of the database tables used by this Joomla installation. For Joomla v1.5.x and v1.6.x this is “jos_” by default, and should another Joomla site have to share the same database, the database tables would be kept separate by setting up this second site with a different prefix – e.g. “jos2_”. With Joomla v1.7.x the same result is achieved by using a prefix that is a randomly generated alphabetic code and underscore – e.g. “vduea_”.
  
 
=== “Mail Settings” Group ===
 
=== “Mail Settings” Group ===
This group is used to set up the sending and format of automatically generated emails from this web site.  
+
This group is used to set up the sending of automatically generated emails from the Joomla web site.
  
* '''Mailer.''' This sets the mechanism to be used when sending automatically generated emails. The choice is between “PHP Mail” (the PHP ''mail()'' function,) “Sendmail” (an email handling program available in some web servers), or “SMTP” (a separate email delivery server similar to those used by most email clients). The default setting is “PHP Mailer”.
+
* '''Mailer.''' This sets the mechanism to be used when sending automatically generated emails. The choice is between “PHP Mail” (the PHP ''mail()'' function,) “Sendmail” (an email handling program available in many web servers), or “SMTP” (a separate email delivery server similar to those used by most email clients). The default setting is “PHP Mailer”.
 
* '''From email''' ('''Mail from''' in v1.5.x). The email address to be used as “from” address in any outgoing emails generated by the Joomla site.
 
* '''From email''' ('''Mail from''' in v1.5.x). The email address to be used as “from” address in any outgoing emails generated by the Joomla site.
 
* '''From Name.''' This defines the “from” name in any outgoing emails generated by the Joomla site.
 
* '''From Name.''' This defines the “from” name in any outgoing emails generated by the Joomla site.
Line 182: Line 175:
 
This tab is only present in Joomla v1.6.x and later as it reflects the enhanced flexibility of access control introduced with V1.6. It provides the means to set up the default permissions for all of the groups of users in terms their ability to edit site content and other settings of the site, and to access administrative functions.
 
This tab is only present in Joomla v1.6.x and later as it reflects the enhanced flexibility of access control introduced with V1.6. It provides the means to set up the default permissions for all of the groups of users in terms their ability to edit site content and other settings of the site, and to access administrative functions.
  
There are comprehensive descriptions of the use of the settings under this tab at --- needs reference here --- and the general principles of permissions in Joomla V1.6 and later at --- needs reference here---.
+
There are comprehensive descriptions of the use of the settings under this tab and the general principles of operation and set-up of permissions in Joomla V1.6 and later here:  <- ACL_Tutorial_for_Joomla_1.6#Global_Configuration|ACL Tutorial for Joomla 1.6 ->(link no longer valid).
  
 
==References==
 
==References==
 
<references>
 
<references>
  
[[Category:Joomla! 1.5]][[Category:Joomla! 1.6]][[Category:Joomla! 1.7]][[Category:Installation]][[Category:Security]]
+
<noinclude> </noinclude>
 +
 
 +
[[Category:Archived version Joomla! 1.5]]

Latest revision as of 09:25, 29 April 2013