Location: PHPKode > projects > Mambo CMS > help/454.screen.config.html
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
<html xmlns="http://www.w3.org/1999/xhtml" lang="en_US" xml:lang="en_US">
<title>Global Configurations</title>
<link href="css/help.css" rel="stylesheet" type="text/css" />
<meta name="copyright" content="(C) 2000 - 2005 Miro International Pty Ltd" />
<meta name="license" content="http://www.gnu.org/copyleft/gpl.html GNU/GPL" />
<p><span style="FONT-WEIGHT: bold">Global Configuration</span> controls Mambo's operational settings. Changes made on this screen will update the <strong>configuration.php</strong> file. This file must be normally unwritable. Change it to writable in order for you to be able to edit your configuration. Then remember to change it back to unwritable.<br /><br />
To the right of the write status of configuration.php is a check box labeled &quot;Make unwritable after saving.&quot; Checking this box will change the file permissions of configuration.php to unwritable once you have applied your changes. When your site is configured, it is a good idea to make configuration.php unwritable for security reasons. </p>
<h3>Site Tab</h3>
<p><strong>Site <span>Offline</span></strong> - With this you can effectively switch on and off your web site 'Front-end'. Use this option if you are updating modules or data, and do not wish to have your visitors view the site until you are finished. Remember to reset the &quot;Site offline&quot; option to &quot;No&quot; once you're done.</p>

<p><strong><span>Offline</span> Message</strong> - When the Site <span>Offline</span> switch is in the �Yes� position, this default message will display on the 'Front-end' for your visitors to see.&nbsp; &quot;This site is down for maintenance. Please check back again soon.&quot;<br />You can change this text to whatever message you would like.</p>

<p><strong>System Error Message</strong> - This message will display if the initial database connection fails.&nbsp; You can type anything you like in this box. We suggest something friendly and apologetic, stating that your site will be available again as soon as possible. You can use standard HTML code in this box also, for instance, &lt;<span>br</span> /&gt; to return a line. You might also consider adding an email address, so that your visitors can contact your System Administrator or the Webmaster.</p><p><strong>Site Name</strong> - This option allows you to set the content of the title bar for your site. It can also be displayed in your template by inserting the following code statement into your template file [Mambo_root/templates/template name/index.php] where you wish your Site Name to appear:</p><p>&lt;?php echo $_CONFIG-&gt;<span>SITENAME</span>; ?&gt;</p><p><strong>Show <span>Unauthorised</span> Links</strong> -&nbsp;With this option turned on, all visitors&nbsp;will see content to which they would not otherwise have access, (that is,<span></span> content given an Access Level of 'Registered' or 'Special'). With this option off, they will only see content with an Access Level of 'Public'.&nbsp; The access level for Content is selected under the Publishing tab in the Edit Content screen.</p>

<p><strong>Allow User Registration</strong> - This option allows you to globally set whether visitors to your site can register for a user account. If the &quot;Yes&quot; radio button is chosen, the Login Form will include the prompt �No account yet? Create one�. If the &quot;No&quot; radio button is chosen, they will not be presented with an option to register.</p>

<p><strong>Use New Account Activation</strong> - If the &quot;Yes&quot; radio button is chosen, an activation link will be sent to user's e-mail address. Users can not login until he has clicked on the activation link.&nbsp; If the &quot;No&quot; radio button is chosen, Users will be able to login right away without activation.</p><p><strong>Email New User Password</strong> - With this option set to 'Yes', the new user will receive an email with a password generated by Mambo. If it is set to 'No', new Users will select their own password.<br /></p>

<p><strong>Require Unique Email</strong> - Select whether you want to prevent registration with duplicate e-mail addresses. In combination with user activation this option prevents users to sign up several times using the same e-mail address.</p>

<p><strong>Debug Site</strong> - This option allows you to view the error messages that are  created by your site's php installation. It can be a handy tool for debugging if you are having problems and for reporting errors to your System Administrator or Web host. The levels of error reporting can be set under the Global Configuration-&gt;Server tab, and are as follows:<br />System Default, None, Simple and Maximum.</p>

<p><strong>WYSIWYG Editor</strong> - Choose which of the installed Text Editors you want to use to edit Content Items. Remember that editors are installed as Mambots.<br /><br /><strong>List Length</strong> - Choose a default length for lists in the Administrator (Back-end).&nbsp;<br /><strong>NOTE</strong> that if you have previously visited a page with a list, changing this setting in Global Configuration will not be immediately visible. However, the setting you specify will be <span>honoured</span> as a default upon your next login.<br /><br /><strong><span>Favorites</span> Site Icon</strong> - This sets the icon that appears in some browsers next to the name and/or address of your site.&nbsp; By default this is the Mambo flower.&nbsp; If you want another icon to show up, you must upload another icon to replace the Mambo flower.&nbsp; Then type in the address of the image in this field.</p>

<h3>Locale Tab</h3>

<p><strong>Language</strong>:&nbsp; Choose the default language used on your site.&nbsp; If it is another language other than English, you must install the language files first using the Installer menu in the Back-end.<br /></p>

<p><strong>Time Offset</strong>: This option sets the time offset in hours between your server location and GMT (Greenwich Mean Time - UK). Select the offset time from the dropdown menu.&nbsp; <br /></p>

<p><strong>Country Locale</strong>: Type the location of your Web site.&nbsp; For instance en_GB would be the setting for the UK, el_GR for Greece.</p>

<h3>Content Tab</h3><p />

<p><strong>Linked Titles</strong>: Select 'Yes', if you want the title of a content item to be hyper-linked.&nbsp; Select 'No', and a 'Read On...' link will appear below the introduction text.<br /><br /><strong>Read More Link</strong>: Select &quot;Show&quot; to display the text &quot;Read more&quot; at the end of your &quot;Intro Text&quot; of your content items.<br /><br /><strong>Item Rating / Voting</strong>:&nbsp;This option allows the rating of content items.&nbsp; Choose 'Yes', and a 'Star Bar' will be shown on each content item, as well as a form for submitting your rating. <span style="FONT-WEIGHT: bold">NOTE:</span> The rating form is not shown for articles in 'Blog' lists, and the Star Bar is only shown for those items with Intro text.</p><p><strong>Author Names</strong>: Choose the radio button &quot;Show&quot;, to allow the Author's name to be shown when a Content Item is displayed. </p>

<p><strong>Created Date and Time</strong>:&nbsp;Choose the radio button &quot;Show&quot;, to allow the creation date and time to be shown when a content item is displayed.</p>

<p><strong>Modified Date and Time</strong>: Choose the radio button &quot;Show&quot;, to allow the last modified date and time to be shown&nbsp; when a content item is displayed.<br /><br /><strong>Hits</strong>: Choose the radio button &quot;Show&quot;, to display the number of hits an article/content has had. <br /><br /><strong>PDF Icon</strong>: Choose the radio button &quot;Show&quot;, to show the PDF maker icon on Content Items while viewing in the Front-end. <span style="FONT-WEIGHT: bold">NOTE: &nbsp;</span>This will not display at all if your media directory is not writable.</p>

<p><strong>Print Icon</strong>:&nbsp; Choose the radio button &quot;Show&quot;, to show the Printer Friendly Version icon on Content Items while viewing in the Front-end.</p><p><strong>Email Icon</strong>:&nbsp; Choose the radio button &quot;Show&quot;, to show the Email Page to Friend icon on Content Items while viewing in the Front-end.<br /><br /><strong>Icons</strong>: Choose the radio button &quot;Show&quot;, when you want the hidden links to Email/Print/PDF to be icons rather than text.</p>

<p><strong>Table of Contents on multi-page items</strong>: Choose the radio button &quot;Show&quot;, to show the Table of Content navigation index boxes&nbsp; for multi-page Content Items. To create page breaks in your Content Item, you must insert a page break Mambot, {<span>mospagebreak</span>} using the editor where ever you want the page breakes to occur. </p>

<p><strong>Back Button</strong>:&nbsp; Choose the radio button &quot;Show&quot;,&nbsp; to allow you to show navigational back buttons on each page to make it easier for users to navigate your site.</p>

<p><strong>Content Item Navigation</strong>: Choose the radio button &quot;Show&quot;, to publish&nbsp; 'Next' and 'Previous' links when viewing Content Items in a category or&nbsp; to change pages within the same article.</p>

<h3>Database Tab</h3>

<p><font color="#cc0000"><strong>Warning</strong></font>&nbsp;&nbsp;These are very important settings. If your Mambo web site has been installed on your behalf do not alter these settings.</p>

<p><span><strong>Hostname</strong>:</span> Type '<span>localhost</span>', as this is the typical Host name</p>

<p><strong>My<span>SQL</span> Username</strong>: Edit, if needed, the <span>username</span> to access your Mambo database.</p>

<p><strong>My<span>SQL</span> Password</strong>:&nbsp; Edit, if needed, the password to access your Mambo database.</p><p><strong>My<span>SQL</span> Database</strong>: Edit, if needed, the name of the database your Mambo installation uses.</p>

<p><strong>My<span>SQL</span> Database Prefix</strong>: Edit, if needed, the prefix used for records in your Mambo database. Typically �mos_&quot; by default. <strong>Very Important!</strong> DO NOT CHANGE UNLESS YOU HAVE A DATABASE BUILT USING TABLES WITH THE PREFIX YOU ARE SETTING!!</p>

<h3>Server Tab</h3>

<p>The following three items are predefined during the installation and are not configurable through this tab. The only way to change them is by manually editing the configuration.php file.</p>

<p><strong>Absolute Path</strong>:&nbsp;This is the directory information used by Mambo on the server that orientates it to it's surrounding system.</p>

<p><strong>Live Site</strong>:&nbsp;This is the absolute URL (web address) for your installation of Mambo. Typical value is http://www.mysite.com. <strong>Please note</strong> that the 'www.', should be there, otherwise&nbsp;you may face problems with editors. Typical Mambos, installed using cPanel, miss the 'www.', so you have to add it, by manually editing the configuration.php file.</p><p><strong>Secret Word</strong>: This is the unique word for every Mambo installation. It is used for security functions.</p>

<p><strong><span>GZIP</span> Page Compression</strong>: Choose the radio button &quot;Yes&quot;, to allow your web server to send compressed data, if supported by the server, to the client web browser. This could significantly decrease the load time of your site for your visitors.</p>

<p><strong>Login Session Lifetime</strong>: Type the number of seconds the Administration session should be allowed to stay live before automatic logout occurs. After automatic logout, the Administrator will be required to login again using the correct <span>username</span> and password.&nbsp; <br /><br /><span style="FONT-WEIGHT: bold">Warning: </span>If you are editing a Content Item, but have not saved your work, within the number of seconds choosen,&nbsp; you will be logged out automatically .&nbsp; <br /></p>

<p><strong>Error Reporting</strong>:&nbsp;If this option is enabled under the Site tab, then using the drop down box, select the level or reporting required. Options are System Default, None, Simple and Maximum.</p>

<ul><li>System Default - &nbsp;This turns Error reporting to the system default according to php.<span>ini</span> on the server.</li><li>None -&nbsp;This turns off error reporting.</li><li>Simple - &nbsp;This turns error reporting to simple options using the following options: error_reporting (E_ERROR|E_WARNING|E_PARSE)</li><li>&nbsp;Maximum - &nbsp;This turns error reporting to the Maximum level using the <span>following options</span>: error_reporting (E_ALL) <br /></li></ul>

<p><strong>Register Globals</strong>: This option allows you to turn register_globals emulation on or off. The tooltip indicates the current php.ini register_globals setting for your domain. Please be advised that the recommended setting is <b>Off</b> but this may cause some 3rd party components to stop working correctly. 
If you are experiencing problems with undefined variables within some components or modules, try setting this option to <b>On</b>.

<p><strong>File Creation</strong>: By default, files created by the installation of components, modules and <span>mambots</span> inherit the server default permissions. By choosing &quot;CHMOD new files&quot;, you can over-ride the server <span>permissions</span>.
<br /><br /><strong>Directory Creation</strong>: As with files, new directories will by default inherit the server default permissions. Choose &quot;CHMOD new directories&quot; to over- ride the server permissions.</p>

<h3><span>Metadata</span> Tab</h3>

<p>These settings, affect the way search engines view your site.</p>

<p><strong>Global Site Meta Description</strong>:&nbsp;Type a description of your web site used to assist Search Engines. You may want to limit your description to maybe twenty words or so, depending on the Search Engine you are targeting. Make it concise and pertinent to your site's contents. You can include some of your keywords and key phrases here too. As some search engines read more than 20 words you can add one or two sentences. Make sure that the most important part of your description is in the first 20 words. </p>

<p><strong>Global Site Meta Keywords</strong>: The optimal number of characters for a keyword description is said to be between 300 and 500. Do not repeat words too often and either separate your keywords with a comma or a space, or group two or three words together. 'Mambo Open Source' would be an example of this. <br /><br /><strong>Show Title Meta Tag</strong>: Shows the Title meta tag in the source code when viewing content.<br /><br /><strong>Show Author Meta Tag</strong>: Shows the Authors meta tag in the source code when viewing content.</p>

<p><span style="FONT-WEIGHT: bold">NOTE: </span>The Description and Keyword Meta tags will have a bearing on how Search Engines will index your site. Some Search Engines completely ignore <span>Metadata</span> altogether. You should do some research on Search Engine Optimization if high rankings and Search Engine traffic are important to you.</p>

<h3>Mail Tab</h3><p><strong>Mailer</strong>: Choose which mailer you wish to use: PHP mail function, <span>Sendmail</span> or SMTP Server.</p>

<p><strong>Mail From</strong>: Choose which email address will show as the sender.</p>

<p><strong>From Name</strong>: Choose what name will show as the sender.</p>

<p><strong>Sendmail Path</strong>: This is the directory of the Mail server. Under Linux installations is normally /usr/sbin/sendmail. Not applicable on Windows installations.</p>

<p>If you have chosen the SMTP Server as the Mailer, then you have to set the following settings. Ignore otherwise.&nbsp;</p>

<p><strong>SMTP </strong><span><strong>Auth</strong>:</span> Choose &quot;Yes&quot; if SMTP Authentication is required by your host.</p><p><strong>SMTP User</strong>: If authentication is required and set above, type your <span>username</span>.</p>

<p><strong>SMTP Pass</strong>:&nbsp;If authentication is required and set above, type your password.</p>

<p><strong>SMTP Host</strong>: This is usually set as <span>localhost</span>, but you may need to check this with your host.</p>

<h3>Cache Tab</h3>

<p><strong>Caching</strong>: Choose &quot;Yes&quot; to allow for caching of certain elements within Mambo. This will generally improve the performance of your site.</p>

<p><strong>Cache Folder</strong>:&nbsp;This is the folder or directory to store the cache files. This must be writable for this caching to be successfully implemented. Contact your Web Master if you have any difficulties.</p>

<p><strong>Cache Time</strong>: Edit the maximum length of time, in seconds, for a cache file to be stored before it is refreshed.</p>

<h3>Statistics Tab</h3>

<p><strong>Statistics</strong>: Choose 'Yes', to allow the browser and visitor domain statistics to be collected on the basis of settings in&nbsp; the Content Tab. You can then access the statistics, from&nbsp;Site -&gt; Statistics.&nbsp;If this is set to 'No', the browser and visitor statistics will not be collected. If your site experiences a slight 'delay' the first time a user visits the site you should set this to 'No'.</p>

<p><strong>Log Content Hits by Date</strong>: Choose &quot;Yes&quot; to enable logging of the hits on Content Items, on a daily basis. There are currently no in-built analysis routines, to complement this logging feature. <br /><span style="FONT-WEIGHT: bold">Warning: T</span>his will tend to collect masses of data over time. Be sure that your server space has the space to to store this information.&nbsp; </p>

<p><strong>Log Search Strings</strong>: Choose &quot;Yes&quot; to enable logging of the search text, entered by a user. Such logging facilitates the 'tuning' of your web site, giving you an insight into how your visitors are trying to find the information they seek. Analysis reporting is provided under Site-&gt;Statistics-&gt;Search Text.</p>

<h3><span>SEO</span> Tab</h3>

<p><strong>Search Engine Friendly <span>URLs</span></strong>:&nbsp; This changes the way site links are presented and <span>optimises</span> them so that search engines can access more of your site. This option is ONLY available to sites hosted on Apache servers.&nbsp; Choose 'Yes' to enable Mambo to output friendly <span>URLs</span> rather than normal database generated <span>URLs</span>. If you use this option you must rename your <span>htaccess</span>.<span>txt</span> <span>file</span> to .<span>htaccess</span>.</p>

<p><strong>Dynamic Page Titles</strong>: Choose &quot;Yes&quot; to set the page titles (that appear at the top of a viewers browser) to be the same as the page title they are viewing. Again this helps search engines.</p>

<p><span style="FONT-WEIGHT: bold">NOTE: &nbsp;</span><strong>You must 'Save' your changes once you have finished, using the 'Save' icon in the tool bar.</strong></p>
Return current item: Mambo CMS