Actions

Help15

Difference between revisions of "Screen.config.15"

From Joomla! Documentation

(Version Changes)
m (category fix)
 
(40 intermediate revisions by 10 users not shown)
Line 1: Line 1:
{{inuse}}
+
==How to access==
 
+
To access the page, either click on ''Global Configuration'' in the main [[screen.cpanel.15|Control panel]] or go to '''Site > Global Configuration'''.
  
 
==Description==
 
==Description==
 
The Global Configuration screen allows you to configure the Joomla! site with your personal settings.
 
The Global Configuration screen allows you to configure the Joomla! site with your personal settings.
  
==Version Changes==
+
==Site==
The following the what has changed from version 1.0.x to 1.5:
+
===Screenshot===
* The following tabs has been removed:
+
[[Image:Global.Config_Site.png]]
** Locale
+
** Content
+
** Database
+
** Metadata
+
** Mail
+
** Cache
+
** Statistics
+
** SEO
+
* The following changes has been made to the [[#Site | Site]] tab:
+
** Options that's been removed:
+
*** System Error Message
+
*** Front-end Login
+
*** Favourites Site Icon
+
** '''Show Unauthorised Links''' was moved to the '''Parameters''' options of the [[screen.content.15 | Article Manager]]
+
** The following has been moved to the new [[#System | System]] tab
+
*** Allow User Registration
+
*** Use New Account Activation
+
*** Front-end User Params
+
** All settings originally under the '''Metadata''' tab has been grouped together as [[#Metadata_Settings | Metadata Settings]] and placed under this tab
+
** All settings originally under the '''SEO''' tab has been grouped together as [[#SEO_Settings | SEO Settings]] and placed under this tab
+
*** Dynamic Page Titles has been changed to '''Add suffix to URLs'''
+
*** '''Use Apache ''mod_rewrite''''' has been added
+
** Has been grouped together and labeled as [[#Site_Settings | Site Settings]]:
+
*** Site Offline
+
*** Offline Message
+
*** Site Name
+
*** Default WYSIWYG Editor
+
*** List Length
+
* The following changes has been made to the [[#Server | Server]] tab
+
** Options that's been removed
+
*** Absolute Path
+
*** Live Site
+
*** Admin Session Lifetime
+
*** Remember Expired Admin page
+
*** Session Authentication Method
+
*** File Creation
+
*** Directory Creation
+
** '''Time Offset''', originally under the '''Locale''' tab, is now under this tab under [[#Locale_Settings | Locale Settings]]
+
** All settings originally located under the '''Database''' tab has been grouped together as [[#Database | Database]] and placed under this tab
+
** '''Site Session Lifetime''' has been renamed to '''Session Lifetime''' and has been moved to the new [[#System | System]] tab under [[#Session_Settings | Session Settings]]
+
** '''Help Server''' has been changed to a drop down box
+
** All settings originally located under the '''Mail''' tab has been grouped together as [[#Mail_Settings | Mail Settings]] and placed under this tab
+
* All settings originally located in the '''Content''' tab has been moved to the new '''Parameters''' options of the [[screen.content.15 | Article Manager]]
+
* All settings originally located in the '''Cache''' tab has been moved to the new [[#System | System]] tab.
+
** Cache Folder has replaced with a drop down box unable to be changed.
+
 
+
==Column Headers==
+
===Site===
+
 
+
[[Image:Gc-site.jpg|right|500px]]
+
  
 +
===Setting Groups===
 
====Site Settings====
 
====Site Settings====
; Site Offline : Tells Joomla! whether the site is to be online or to show an offline message.  Only Administrators will be able to see the site when ''Site Offline'' is set to Yes.  By default, this is set to '''No'''.
+
* '''Site Offline'''. This setting shows when the site is offline.  Only Administrators will be able to see the site when ''Site Offline'' is set to Yes.  The default setting is '''No'''.
; Offline Message : The message that will be display on the site when the site is offline.
+
* '''Offline Message'''. The message that will be displayed on the site when the site is offline.
; Site Name : The name of the site.
+
* '''Site Name'''. The name of the site.
; Default WYSIWYG Editor : (WYSIWYG stands for What You See Is What You Get) The default editor to use when creating articles.
+
* '''Default WYSIWYG Editor'''. (WYSIWYG stands for What You See Is What You Get) The default [[Content creators#Content_Editors|editor]] to use when creating articles.
; List Length : The length of lists in the Control Panel for all Users.  By default, this is set to '''20'''.
+
* '''List Length'''. The length of lists in the Control Panel for all Users.  By default, this is set to '''20'''.
; Feed Length : The number of content items to be shown in the feed(s).  By default, this is set to '''10'''.
+
* '''Feed Length'''. The number of content items to be shown in the feed(s).  By default, this is set to '''10'''.
  
 
====Metadata Settings====
 
====Metadata Settings====
; Global Site Meta Description : This is the description of the site which is indexed by search engine spiders.
+
* '''Global Site Meta Description'''. This is the description of the site which is indexed by search engine spiders.
; Global Site Meta Keywords : This is keywords that help describe the site and helps search engine spiders better index the site based off the keywords provided.
+
* '''Global Site Meta Keywords'''. These keywords describe the site and are the basis for improving the ability of search engine spiders ability to index the site.
; Show Title Meta Tag : Shows the Meta information of the articles which is used by search engine spiders when indexing the site.  Each article could have their own Meta Data information which could be set under the '''Metadata Information''' pane when creating or editing an article.  Refer to [[screen.content.edit.15 | Article Manager - New/Edit]] for more information.
+
* '''Show Title Meta Tag'''. It shows the Meta information of each article.  This Meta information is used by search engine spiders when indexing the site.  Each article can have its own Meta Data information (set under the '''Metadata Information''' pane when creating or editing an article).   
; Show Author Meta Tag : Shows the Author Meta information of the articles which is used by search engine spiders when indexing the site.  Refer to [[screen.content.edit.15 | Article Manager - New/Edit]] for more information.
+
* '''Show Author Meta Tag'''. It shows the Author Meta information for articles and is used by search engine spiders when indexing the site.
  
 
====SEO Settings====
 
====SEO Settings====
 
SEO stands for ''Search Engine Optimization''.
 
SEO stands for ''Search Engine Optimization''.
  
; Search Engine Friendly URLs : When set to ''Yes'', URLs are rewritten to be more friendly on search engine spiders when indexing your page. How it works is that, instead of getting an URL of ''www.yourname.com/index.php?option=com_content&view=etc...'', the URLs will be ''www.yourname.com/alias''.  Most of the items created in Joomla! has an Alias box that can be filled out which is used to create the search engine friendly URLsBy default, this setting is set to '''No'''.
+
* '''Search Engine Friendly URLs'''. When set to ''Yes'', URLs are rewritten to be more friendly for search engine spiders. For example, the URL: ''www.example.com/index.php?option=com_content&view=etc...'', would turn into: ''www.example.com/alias''.  Most of the items created in Joomla! have an Alias box where a search engine friendly URL can be insertedThe default setting is '''No'''.
; Use Apache ''mod_rewrite'' : When set to ''Yes'', Joomla! will use the ''mod_rewrite'' settings of Apache when creating search engine friendly URLs.  Please note that is it required to use the included '''.htaccess''' file provided with Joomla! if planned on using this setting by renaming '''htaccess.txt''' to '''.htaccess'''It is advised that you do not modify the '''.htaccess''' file without working knowledge of how it works and use.  To learn more about '''.htaccess''' files, refer to Apache.org's Documentation[http://httpd.apache.org/docs/1.3/howto/htaccess.html].  By default, this setting is set to '''No'''.
+
* '''Use Apache ''mod_rewrite'''''. When set to ''Yes'', Joomla! will use the ''mod_rewrite'' settings of Apache when creating search engine friendly URLs.  Please note: it is advised that you do not modify any '''.htaccess''' file without an understanding of how it works. You must use the '''.htaccess''' file provided with Joomla! in order to use this setting.  To use this file, rename the '''htaccess.txt''' file (found in the root directory) to '''.htaccess'''. By default, this setting is set to '''No'''.
; Add suffix to URLs : When set to ''Yes'', Joomla! will add '''.html''' at the end of the URLs.  By default, this setting is set to '''No'''.
+
* '''Add suffix to URLs'''. When set to ''Yes'', Joomla! will add '''.html''' to the end of the URLs.  The default setting is '''No'''.
  
===System===
+
==System==
 
+
===Screenshot===
[[Image:Gc-system.jpg|right|500px]]
+
[[Image:Global.Config_System.png]]
  
 +
===Setting Groups===
 
====System Settings====
 
====System Settings====
; Secret Word : This is generated when Joomla! is first installed and is not changeable.  Used for security functions.
+
* '''Secret Word'''. This is generated when Joomla! is first installed and is not changeable.  It is used internally by Joomla! for security purposes.
; Path to Log folder : The path where the logs should be stored.  Joomla! installer should automatically filled this in.
+
* '''Path to Log folder'''. The path where the logs should be stored.  The Joomla! installer should automatically fill in this folder.
; Enable Web Services : This enables the ability of Joomla! to make RPC (Remote Procedure Calls) using HTTP as the transport medium and XML as the encoding language.  This function should remain on to ensure that many third party extensions works.  By default, this setting is set to '''Yes'''.
+
* '''Enable Web Services'''. This feature enables Joomla! to make RPC (Remote Procedure Calls) using HTTP as the transport medium and XML as the encoding language.  This function should remain on to ensure that many third party extensions works.  The default setting '''Yes'''.
; Help Server : The server used to get help information when clicking the '''Help''' image when going through many of the screens and options of the administration panel.  By default, it uses Joomla!'s main help site.
+
* '''Help Server'''. The place Joomla! looks for help information when you click the '''Help''' button (visible in many screens and options of the administration panel).  By default, it uses Joomla!'s main help site.
  
 
====User Settings====
 
====User Settings====
; Allow User Registration : This determines whether users can register on the site.  By default, this setting is set to '''Yes'''.
+
* '''Allow User Registration'''. This determines whether users can register on the site.  The default setting is '''Yes'''.
; New User Registration Type : If ''Allow User Registration'' is set to ''Yes'', this setting tells Joomla! what level of access should be given to new users who register.  By default, this is set to '''Registered'''.
+
* '''New User Registration Type'''. If ''Allow User Registration'' is set to ''Yes'', this setting tells Joomla! what level of access should be given to new users who register.  The default setting is '''Registered'''.
; New User Account Activation : This setting determines whether a new user will have to activate their account before they can use it.  If set to '''Yes''', users will be sent an email containing a link to a web address.  Following the link will activate the account.  By default, this setting is set to '''Yes'''.
+
* '''New User Account Activation'''. This setting determines whether a new user will have to activate their account before they can use it.  If set to '''Yes''', users will be sent an email containing a link to a web address.  The user must follow this link to activate his/her account.  By default, this setting is set to '''Yes'''.
; Front-end User Parameters : When set to ''Show'', users will be able to select their language, article editor, and help site preferences from within their Details screen when logged in via the front-endBy default, this setting is set to '''Show'''.
+
* '''Front-end User Parameters'''. When set to ''Show'', users will be able to select their language, article editor, and help site preferences from within their Details screen.  The default setting is '''Show'''.
  
 
====Media Settings====
 
====Media Settings====
; Legal Extensions (File Types) : The file types allowed for uploading.  By default, when Joomla! is installed, the basic image and document files are set.
+
* '''Legal Extensions (File Types)'''. These are the file types users are allowed to upload.  By default, when Joomla! is installed, basic image and document files are allowed.
; Maximum Size (in bytes) : The maximum file size allowed for an upload in bytes. By default, the setting is set to '''10000000'''.
+
* '''Maximum Size (in bytes)'''. The maximum file size users are allowed to upload, in bytes. The default setting is '''10000000''' (or 10mb).
; Path to File Folder : The path where non-images media files are located (non-images refers to files such as videos and document files). This is automatically filled in by Joomla! on install and may be modified to fit how the directories is setup on the site.
+
* '''Path to Media Folder'''. The path where non-image media files are located, including videos and document files. The default is "<Joomla! home>/images". You can create a new folder to use with the Media Manager and enter the path to that folder here. '''Warning''': ''Do not delete or rename the existing "<Joomla! home>/images" folder on your server.'' This folder and its subfolders "images/banners", "images/M_images", "images/smiles", and "images/stories" are used by Joomla!. Deleting or renaming these folders may cause errors.  
; Path to Image Folder : The path where images are stored.  This is automatically filled in by Joomla! on install and may be modified to fit how the directories is setup on the site.
+
* '''Path to Image Folder'''.  The path where images are stored.  The default is "<Joomla! home>/images/stories". You can create a new folder to use with the Media Manager and enter the path to that folder here. If you want to access this folder from the Media Manager, either use the default value or make the new folder a sub-folder of the Media Manager folder. '''Warning''': ''Do not delete or rename the existing "images/stories" folder on your server.'' This folder is used by Joomla! and deleting or renaming it will cause errors.
; Restrict Uploads : This restricts the uploads to just images for lower than manager usersBy default, this setting is set to '''Yes'''.
+
* '''Restrict Uploads'''. This feature restricts uploads by user typeThe default setting is '''Yes'''.
; Check MIME Types : This uses MIME Magic or Fileinfo to attempt to verify files.  By default, this setting is set to '''Yes'''.  If getting invalid MIME type errors, set this to ''No''.
+
* '''Check MIME Types'''. This uses MIME Magic or Fileinfo to verify files.  The default setting is '''Yes'''.  By checking the MIME information, you help ensure users don't upload malicious files to your site.  If invalid MIME type errors are received then change the setting to ''No''.
; Legal Image Extensions (File Types) : This sets what legal images allowed to be uploaded which it's checked for file image headers.  By default, Joomla! only includes '''bmp,gif,jpg,png'''.
+
* '''Legal Image Extensions (File Types)'''. This allows you to limit the types of images that can be uploaded. It operates by checking the file image headers.  By default, Joomla! only allows '''bmp,gif,jpg,png'''.
; Ignored Extensions : This sets what extensions are ignored for MIME type checking and restricts uploads.  By default, no extensions are added.
+
* '''Ignored Extensions'''. This sets which extensions are ignored for MIME type checking and restricts uploads.  By default, no extensions are ignored.
; Legal MIME Types : This sets the list of legal MIME types for uploads.  By default, Joomla! automatically includes the standard file types.  It is recommended that you should not touch this setting unless you know what you are doing.
+
* '''Legal MIME Types'''. This sets the list of legal MIME types for uploads.  By default, Joomla! automatically includes some standard file types.  It is recommended that you do not touch this setting unless you know what you are doing.
; Illegal MIME Types : This sets the list of illegal MIME types for uploads.  By default, Joomla! automatically blocks HTML MIME types.  It is recommended that you should not touch this setting unless you know what you are doing.
+
* '''Illegal MIME Types'''. This sets the list of illegal MIME types for uploads.  By default, Joomla! automatically blocks HTML MIME types.  It is recommended that you do not touch this setting unless you know what you are doing.
 +
* '''Enable Flash Uploader'''. This setting enables the integrated Flash Uploader which is used for example at the Media Management. If enabled it is possible to upload several files at once. Default setting is '''No'''. '''''Tip''': if enabled and the download does not work, disable the flash uploader (can happen due incompatible flash settings by Adobe)''
  
 
====Debug Settings====
 
====Debug Settings====
; Debug System : This will turn on the debugging system of Joomla!.  When set to '''Yes''', this will provide you with diagnostic information, language translations, and SQL errors, if any, which will be displayed at the bottom of the page below the footer on every page regardless of it being the front-end or back-end.
+
* '''Debug System'''. This will turn on the debugging system of Joomla!.  When set to '''Yes''', this tool will provide diagnostic information, language translations, and SQL errors. If any such issues or errors occur, they will be displayed at the bottom of each page, in both the front-end and back-end.
; Debug Language : This will turn on the debugging indicators (*...*) or (?...?) for the Joomla! Language files.  Debug Language will work without Debug System being on but it won't provide additional detailed references which would help in correcting any errors.
+
* '''Debug Language'''. This will turn on the debugging indicators (*...*) or (?...?) for the Joomla! Language files.  Debug Language will work without the Debug System tool set to on.  But it will not provide additional detailed references which would help in correcting any errors.
  
 
====Cache Settings====
 
====Cache Settings====
; Cache : This setting sets whether site caching is enabled or not.  When enabled, it keeps a local copy of the content on the server for used to speed up accessing and less stress on the database.  By default, this setting is set to '''No'''.
+
* '''Cache'''. This setting sets whether site caching is enabled or not.  When enabled, it keeps a local copy of the content on the server to speed up accessing and lessen stress on the database.  The default setting is '''No'''.
; Cache Time : This setting sets the maximum length of time (in minutes) for a cache file to be stored before it gets refreshed.  By default, this setting is set to '''15'''.
+
* '''Cache Time'''. This setting sets the maximum length of time (in minutes) for a cache file to be stored before it is refreshed.  The default setting is '''15''' minutes.
; Cache Handler : This setting sets how it should be cache.  There's only one caching mechanism which is file-based.
+
* '''Cache Handler'''. This setting sets how the cache operates.  There is only one caching mechanism which is file-based.
  
 
====Session Settings====
 
====Session Settings====
; Session Lifetime : This setting sets how long the session should last and keep a user signed in for before logging them off for being inactive.  By default, the setting is set to '''15''' minutes.
+
* '''Session Lifetime'''. This setting sets how long a session should last and how long a user can remain signed in for (before logging them off for being inactive)The default setting is '''15''' minutes.
; Session Handler : This setting sets how the session should be handle once a user connects and logs into the site.  By default, the setting is set to '''Database'''.
+
* '''Session Handler'''. This setting sets how the session should be handled once a user connects and logs into the site.  The default setting is set to '''Database'''.
  
===Server===
+
==Server==
 
+
===Screenshot===
[[Image:Gc-server.jpg|right|500px]]
+
[[Image:Global.Config_Server.png]]
  
 +
===Setting Groups===
 
====Server Settings====
 
====Server Settings====
; Path to Temp-folder : The path where files are temporary stored.  This is filled in by default when Joomla! is installed.
+
* '''Path to Temp-folder'''. The path where files are temporarily stored.  This is filled in by default when Joomla! is installed.
; GZIP Page Compression : This sets rather or not to compress the pages.  This typically speeds up the site.  By default, the setting is set to '''No'''.
+
* '''GZIP Page Compression'''. Compressing pages typically increases your site's speedThe default setting is '''No'''.
; Error Reporting : This sets the appropriate level of reporting.  By default, the setting is set to '''System Default'''.
+
* '''Error Reporting'''. This sets the appropriate level of reporting.  The default setting is '''System Default'''.
 +
* '''Force SSL''. This setting forces the site access for selected areas under SSL (https). '''Note'': you must have set already the server to use SSL. Options are:
 +
** '''None'''. SSL is not activated
 +
** '''Administrator Only'''. SSL is only valid for the backend.
 +
** '''Entire Site'''. SSL is valid for the whole site (front- & backend).
  
 
====Locale Settings====
 
====Locale Settings====
; Time Zone : Sets the current date and time to displayThis should be set where the server is located atBy default, the setting is set to '''(UTC 00:00) Western Europe Time, London, Lisbon, Casablanca'''.
+
* '''Time Zone'''. This tool sets the current date and time.  The set time should be where the site's server is located.  The default setting is '''(UTC 00:00) Western Europe Time, London, Lisbon, Casablanca'''.
  
 
====FTP Settings====
 
====FTP Settings====
FTP stands for File Transfer Protocol.  Most of these settings was set during the initial setup of Joomla!
+
FTP stands for File Transfer Protocol.  Most of these settings are set during the initial Joomla! installation.
  
; Enable FTP : This setting tells Joomla! to use it's built in FTP function instead of the normal upload progress of Joomla!
+
* '''Enable FTP'''. This setting tells Joomla! to use it's built-in FTP function instead of the normal upload process used by PHP.
; FTP Host : The URL of the host where the FTP functionally should connect to.
+
* '''FTP Host'''. The host server's URL connecting the FTP.
; FTP Port : The port of where the FTP functionally should accessed.  By default, the setting is set to '''21'''.
+
* '''FTP Port'''. The port where the FTP is accessed.  The default setting is '''21'''.
; FTP Username : The username that Joomla! should use when accessing the FTP server.  It is recommended that another FTP user account should be created with only accessed to the folder where files will be uploaded to for security reasons.
+
* '''FTP Username'''. The username that Joomla! will use when accessing the FTP server.  Security recommendation: create another FTP user account to access a folder where files will be uploaded to.
; FTP Password : The password that Joomla! should use when accessing the FTP server.  It is recommended that another FTP user account should be created with only accessed to the folder where files will be uploaded to for security reasons.
+
* '''FTP Password'''. The password that Joomla! will use when accessing the FTP server.  Security recommendation: create another FTP user account to access the folder where files will be uploaded to.
; FTP Root : The root directory of where the files should be uploaded to.
+
* '''FTP Root'''. The root directory where files should be uploaded to.
  
 
====Database Settings====
 
====Database Settings====
These settings are set during the initial setup of Joomla!  It is advised that no settings should be changed in this section without working knowledge of how databases work.
+
These settings are set during the initial setup of Joomla!  It is advised to leave these settings the way they are, unless you have a good understanding of how databases work.
  
; Database Type : The type of databased being used.  By default, the setting is set to '''mysql''' unless changed during the initial setup of Joomla!.
+
* '''Database Type'''. The type of databased to be used.  The default setting is '''mysql''', but this can be changed during the initial setup of Joomla!.
; Hostname : The hostname of where the database is located.  This is typically set to '''localhost''' for most servers but still possible to be located on a different server all together.
+
* '''Hostname'''. The hostname where the database is located.  It is typically set to '''localhost''' for most servers.  It is possible for the hostname to be located on a different server all together.
; Username : The username to use to access the database.
+
* '''Username'''. The username to access the database.
; Database : The name of the database to use.
+
* '''Database'''. The name of the database.
; Database Prefix : The prefix to used before the actual table's name when working with the database.  By default, the setting is set to '''jos_''' unless changed during initial setup of Joomla!.
+
* '''Database Prefix'''. The prefix used before the actual table's name.  This allows you to have multiple Joomla! installations in the same database.  The default setting is '''jos_''', but this can be changed during initial setup of Joomla!.
  
 
====Mail Settings====
 
====Mail Settings====
This settings was set during the initial setup of Joomla!.  These settings can be change whenever needed.
+
The mail settings are set during the initial setup of Joomla!.  These settings can be changed whenever needed.
  
; Mailer : This setting sets which mailer to use when delivery emails from the site.  By default, the setting is set to '''PHP Mail Function''' but could of been changed during initial setup of Joomla!.
+
* '''Mailer'''. This setting sets which mailer to use to deliver emails from the site.  The default setting is '''PHP Mail Function'''. This can be changed during the initial setup of Joomla!.
:; PHP Mail Function : This tells Joomla! to use the mail function that's built into PHP.
+
** '''PHP Mail Function'''. This uses the mail function that is built into PHP.
:; Sendmail : This tells Joomla! to use the sendmail function typically used when creating HTML email forms.
+
** '''Sendmail'''. This uses the Sendmail program, which is typically used when creating HTML email forms.
:; SMTP Server : This uses the site's SMTP server.
+
** '''SMTP Server'''. This uses the site's SMTP server.
; Mail from : The email address of which the Joomla! will use to send site email from.
+
* '''Mail from'''. The email address used by Joomla! to send site email.
; From Name : The name Joomla! will use when sending site emails.  By default, Joomla! uses the site name during the initial setup.
+
* '''From Name'''. The name Joomla! will use when sending site emails.  By default, Joomla! uses the site name during the initial setup.
; Sendmail Path : The path where the Sandmail program is located.  This is typically filled in by Joomla! during initial setup.  This is only used if '''Mailer''' is set to '''Sendmail'''.
+
* '''Sendmail Path'''. The path where the Sendmail program is located.  This is typically filled in by Joomla! during the initial setup.  This path is only used if '''Mailer''' is set to '''Sendmail'''.
; SMTP Authentication : If the STMP server requires authentication to send mail, set this to '''Yes''', otherwise leave it at '''No'''.  This is only used if '''Mailer''' is set to '''Sendmail'''.
+
* '''SMTP Authentication'''. If the SMTP server requires authentication to send mail, set this to '''Yes'''. Otherwise leave it at '''No'''.  This is only used if '''Mailer''' is set to '''Sendmail'''.
; SMTP Username : The username to use for access to the SMTP host.  This is only used if '''Mailer''' is set to '''Sendmail'''.
+
* '''SMTP Username'''. The username to use for access to the SMTP host.  This is only used if '''Mailer''' is set to '''Sendmail'''.
; SMTP Password : The password to use for access to the SMTP host.  This is only used if '''Mailer''' is set to '''Sendmail'''.
+
* '''SMTP Password'''. The password to use for access to the SMTP host.  This is only used if '''Mailer''' is set to '''Sendmail'''.
; SMTP Host : The SMTP address to use when sending mail.  This is only used if '''Mailer''' is set to '''Sendmail'''.
+
* '''SMTP Host'''. The SMTP address to use when sending mail.  This is only used if '''Mailer''' is set to '''Sendmail'''.
  
==Typical Usage==
+
==Toolbar==
Global Configuration is to set all the required settings you need in order for the site to function. To access the page, either click on Global Configuration in the main Control Panel or go to '''Site > Global Configuration'''.
+
At the top right you will see the toolbar:
  
==Quick Tips==
+
[[Image:Config.toolbar.jpg]]
Most, if not all, of these settings you'll just set once and leave it alone.
+
  
If you're going to make major modification, consider putting the site offline so you can test the functions and make sure everything is in working order.
+
The functions are:
 +
{{toolbaricon|Save config}}
 +
{{toolbaricon|Apply}}
 +
{{toolbaricon|Close}}
 +
{{toolbaricon|Help}}
  
==Points to Watch==
+
==Quick Tips==
None Known at this Time
+
* 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.
  
==Dependencies==
+
==Related Information==
None
+
* [[screen.cpanel.15|Control panel]]
 +
* [[screen.content.edit.15 | Article Manager - New/Edit]]
 +
* [http://httpd.apache.org/docs/2.2/howto/htaccess.html Info about .htaccess]
  
[[Category:DocCamp]]
+
<noinclude>{{cathelp|1.5|Global Configuration Help Screens}}</noinclude>

Latest revision as of 23:09, 3 September 2012

Contents

How to access

To access the page, either click on Global Configuration in the main Control panel or go to Site > Global Configuration.

Description

The Global Configuration screen allows you to configure the Joomla! site with your personal settings.

Site

Screenshot

Global.Config Site.png

Setting Groups

Site Settings

  • Site Offline. This setting shows when the site is offline. Only Administrators will be able to see the site when Site Offline is set to Yes. The default setting is No.
  • Offline Message. The message that will be displayed on the site when the site is offline.
  • Site Name. The name of the site.
  • Default WYSIWYG Editor. (WYSIWYG stands for What You See Is What You Get) The default editor to use when creating articles.
  • List Length. The length of lists in the Control Panel for all Users. By default, this is set to 20.
  • Feed Length. The number of content items to be shown in the feed(s). By default, this is set to 10.

Metadata Settings

  • Global Site Meta Description. This is the description of the site which is indexed by search engine spiders.
  • Global Site Meta Keywords. These keywords describe the site and are the basis for improving the ability of search engine spiders ability to index the site.
  • Show Title Meta Tag. It shows the Meta information of each article. This Meta information is used by search engine spiders when indexing the site. Each article can have its own Meta Data information (set under the Metadata Information pane when creating or editing an article).
  • Show Author Meta Tag. It shows the Author Meta information for articles and is used by search engine spiders when indexing the site.

SEO Settings

SEO stands for Search Engine Optimization.

  • Search Engine Friendly URLs. When set to Yes, URLs are rewritten to be more friendly for search engine spiders. For example, the URL: www.example.com/index.php?option=com_content&view=etc..., would turn into: www.example.com/alias. Most of the items created in Joomla! have an Alias box where a search engine friendly URL can be inserted. The default setting is No.
  • Use Apache mod_rewrite. When set to Yes, Joomla! will use the mod_rewrite settings of Apache when creating search engine friendly URLs. Please note: it is advised that you do not modify any .htaccess file without an understanding of how it works. You must use the .htaccess file provided with Joomla! in order to use this setting. To use this file, rename the htaccess.txt file (found in the root directory) to .htaccess. By default, this setting is set to No.
  • Add suffix to URLs. When set to Yes, Joomla! will add .html to the end of the URLs. The default setting is No.

System

Screenshot

Global.Config System.png

Setting Groups

System Settings

  • Secret Word. This is generated when Joomla! is first installed and is not changeable. It is used internally by Joomla! for security purposes.
  • Path to Log folder. The path where the logs should be stored. The Joomla! installer should automatically fill in this folder.
  • Enable Web Services. This feature enables Joomla! to make RPC (Remote Procedure Calls) using HTTP as the transport medium and XML as the encoding language. This function should remain on to ensure that many third party extensions works. The default setting Yes.
  • Help Server. The place Joomla! looks for help information when you click the Help button (visible in many screens and options of the administration panel). By default, it uses Joomla!'s main help site.

User Settings

  • Allow User Registration. This determines whether users can register on the site. The default setting is Yes.
  • New User Registration Type. If Allow User Registration is set to Yes, this setting tells Joomla! what level of access should be given to new users who register. The default setting is Registered.
  • New User Account Activation. This setting determines whether a new user will have to activate their account before they can use it. If set to Yes, users will be sent an email containing a link to a web address. The user must follow this link to activate his/her account. By default, this setting is set to Yes.
  • Front-end User Parameters. When set to Show, users will be able to select their language, article editor, and help site preferences from within their Details screen. The default setting is Show.

Media Settings

  • Legal Extensions (File Types). These are the file types users are allowed to upload. By default, when Joomla! is installed, basic image and document files are allowed.
  • Maximum Size (in bytes). The maximum file size users are allowed to upload, in bytes. The default setting is 10000000 (or 10mb).
  • Path to Media Folder. The path where non-image media files are located, including videos and document files. The default is "<Joomla! home>/images". You can create a new folder to use with the Media Manager and enter the path to that folder here. Warning: Do not delete or rename the existing "<Joomla! home>/images" folder on your server. This folder and its subfolders "images/banners", "images/M_images", "images/smiles", and "images/stories" are used by Joomla!. Deleting or renaming these folders may cause errors.
  • Path to Image Folder. The path where images are stored. The default is "<Joomla! home>/images/stories". You can create a new folder to use with the Media Manager and enter the path to that folder here. If you want to access this folder from the Media Manager, either use the default value or make the new folder a sub-folder of the Media Manager folder. Warning: Do not delete or rename the existing "images/stories" folder on your server. This folder is used by Joomla! and deleting or renaming it will cause errors.
  • Restrict Uploads. This feature restricts uploads by user type. The default setting is Yes.
  • Check MIME Types. This uses MIME Magic or Fileinfo to verify files. The default setting is Yes. By checking the MIME information, you help ensure users don't upload malicious files to your site. If invalid MIME type errors are received then change the setting to No.
  • Legal Image Extensions (File Types). This allows you to limit the types of images that can be uploaded. It operates by checking the file image headers. By default, Joomla! only allows bmp,gif,jpg,png.
  • Ignored Extensions. This sets which extensions are ignored for MIME type checking and restricts uploads. By default, no extensions are ignored.
  • Legal MIME Types. This sets the list of legal MIME types for uploads. By default, Joomla! automatically includes some standard file types. It is recommended that you do not touch this setting unless you know what you are doing.
  • Illegal MIME Types. This sets the list of illegal MIME types for uploads. By default, Joomla! automatically blocks HTML MIME types. It is recommended that you do not touch this setting unless you know what you are doing.
  • Enable Flash Uploader. This setting enables the integrated Flash Uploader which is used for example at the Media Management. If enabled it is possible to upload several files at once. Default setting is No. Tip: if enabled and the download does not work, disable the flash uploader (can happen due incompatible flash settings by Adobe)

Debug Settings

  • Debug System. This will turn on the debugging system of Joomla!. When set to Yes, this tool will provide diagnostic information, language translations, and SQL errors. If any such issues or errors occur, they will be displayed at the bottom of each page, in both the front-end and back-end.
  • Debug Language. This will turn on the debugging indicators (*...*) or (?...?) for the Joomla! Language files. Debug Language will work without the Debug System tool set to on. But it will not provide additional detailed references which would help in correcting any errors.

Cache Settings

  • Cache. This setting sets whether site caching is enabled or not. When enabled, it keeps a local copy of the content on the server to speed up accessing and lessen stress on the database. The default setting is No.
  • Cache Time. This setting sets the maximum length of time (in minutes) for a cache file to be stored before it is refreshed. The default setting is 15 minutes.
  • Cache Handler. This setting sets how the cache operates. There is only one caching mechanism which is file-based.

Session Settings

  • Session Lifetime. This setting sets how long a session should last and how long a user can remain signed in for (before logging them off for being inactive). The default setting is 15 minutes.
  • Session Handler. This setting sets how the session should be handled once a user connects and logs into the site. The default setting is set to Database.

Server

Screenshot

Global.Config Server.png

Setting Groups

Server Settings

  • Path to Temp-folder. The path where files are temporarily stored. This is filled in by default when Joomla! is installed.
  • GZIP Page Compression. Compressing pages typically increases your site's speed. The default setting is No.
  • Error Reporting. This sets the appropriate level of reporting. The default setting is System Default.
  • Force SSL. This setting forces the site access for selected areas under SSL (https). Note: you must have set already the server to use SSL. Options are:
    • None. SSL is not activated
    • Administrator Only. SSL is only valid for the backend.
    • Entire Site. SSL is valid for the whole site (front- & backend).

Locale Settings

  • Time Zone. This tool sets the current date and time. The set time should be where the site's server is located. The default setting is (UTC 00:00) Western Europe Time, London, Lisbon, Casablanca.

FTP Settings

FTP stands for File Transfer Protocol. Most of these settings are set during the initial Joomla! installation.

  • Enable FTP. This setting tells Joomla! to use it's built-in FTP function instead of the normal upload process used by PHP.
  • FTP Host. The host server's URL connecting the FTP.
  • FTP Port. The port where the FTP is accessed. The default setting is 21.
  • FTP Username. The username that Joomla! will use when accessing the FTP server. Security recommendation: create another FTP user account to access a folder where files will be uploaded to.
  • FTP Password. The password that Joomla! will use when accessing the FTP server. Security recommendation: create another FTP user account to access the folder where files will be uploaded to.
  • FTP Root. The root directory where files should be uploaded to.

Database Settings

These settings are set during the initial setup of Joomla! It is advised to leave these settings the way they are, unless you have a good understanding of how databases work.

  • Database Type. The type of databased to be used. The default setting is mysql, but this can be changed during the initial setup of Joomla!.
  • Hostname. The hostname where the database is located. It is typically set to localhost for most servers. It is possible for the hostname to be located on a different server all together.
  • Username. The username to access the database.
  • Database. The name of the database.
  • Database Prefix. The prefix used before the actual table's name. This allows you to have multiple Joomla! installations in the same database. The default setting is jos_, but this can be changed during initial setup of Joomla!.

Mail Settings

The mail settings are set during the initial setup of Joomla!. These settings can be changed whenever needed.

  • Mailer. This setting sets which mailer to use to deliver emails from the site. The default setting is PHP Mail Function. This can be changed during the initial setup of Joomla!.
    • PHP Mail Function. This uses the mail function that is built into PHP.
    • Sendmail. This uses the Sendmail program, which is typically used when creating HTML email forms.
    • SMTP Server. This uses the site's SMTP server.
  • Mail from. The email address used by Joomla! to send site email.
  • From Name. The name Joomla! will use when sending site emails. By default, Joomla! uses the site name during the initial setup.
  • Sendmail Path. The path where the Sendmail program is located. This is typically filled in by Joomla! during the initial setup. This path is only used if Mailer is set to Sendmail.
  • SMTP Authentication. If the SMTP server requires authentication to send mail, set this to Yes. Otherwise leave it at No. This is only used if Mailer is set to Sendmail.
  • SMTP Username. The username to use for access to the SMTP host. This is only used if Mailer is set to Sendmail.
  • SMTP Password. The password to use for access to the SMTP host. This is only used if Mailer is set to Sendmail.
  • SMTP Host. The SMTP address to use when sending mail. This is only used if Mailer is set to Sendmail.

Toolbar

At the top right you will see the toolbar:

Config.toolbar.jpg

The functions are:

  • Save. Save the modifications you made to the Global Configuration. You will be redirected to the Control Panel
  • Apply. Save it, but stay in the same screen. If you have been working on a screen for a long time and don't want to risk losing your work, pressing Apply saves your work and lets you continue working. If, for example, you lost your Internet connection, your work will be saved up this point.
  • Close. Return to the previous screen without saving your work. If you press Close while adding a new item, this new item will not be created. If you were modifying an existing item, the modifications will not be saved.
  • Help. Opens this Help Screen.

Quick Tips

  • 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.

Related Information