Admin Panel > System > Configuration > General Settings

Last modified by kara on Thu, July 1, 2010 13:35
Source|Old Revisions  

Description

Most of the basic store configuration settings that effect the entire website and store are here in the General Settings section of System > Configuration. Be sure to review all the tabs here when setting up a store to ensure that the basic configuration matches what you want.


Admin Panel Fields Reference

General Tab

Countries Options Field Descriptions

In many cases, a web store only ships goods to certain countries. Sometimes it even requires that payment is made from a limited number of countries. The Countries options allow you to specify these countries.

  • Default Country - Set the “default country” to the country you will suggest by default for the billing and shipping addresses. Scope: store view.
  • Allow Countries - In the list of allowed countries, click on the name of the default country. Use Ctrl-click or Shift-click to select additional countries that can be selected for the billing and shipping addresses. Scope: store view.
  • Postal Code is Optional for the following countries - Select countries to which you ship that do not require a postal code to be collected during the checkout process. Scope: global.

Locale Options Field Descriptions

  • Timezone - Set the timezone to where the web store will appear to be located. All times in the store will reflect this setting. Scope: website.
  • Locale - Set the locale to the language that is supported by this store view. Scope: store view.
  • First Day of Week - Indicate the starting day of weeks for Magento reporting. Scope: store view.
  • Weekend Days - Indicate which days are considered weekend dates for Magento reporting. Scope: store view.

Read more about Magento localization.

Website Restrictions Field Descriptions (EE only)

Staging Websites Field Descriptions (EE only)

Store Information Field Descriptions

  • Store Name - Name of the store. It will be available as a variable to themes and transactional emails.
  • Store Contact Telephone - Telephone number of the store. It will be available as a variable to themes and transactional emails.
  • Store Contact Address - Address of the store. It will be available as a variable to themes and transactional emails.

Web Tab

URL Options Field Descriptions

  • Add Store Code to Urls - Inserts the current store code (as defined in System > Manage Stores) into each URL. Scope: global.

For a store view with the code “store2en” the URL will have the format:

http://www.domain.com/magento/index.php/store2en/url-identifier

Note: If you use web server rewrites, the “index.php” filename in the above URL will be hidden.

  • Redirect to Base URL if requested URL doesn’t match it - Redirects traffic to your base URL rather than 404 pages. Should be “no” for multi-store set ups. Scope: global.

(read more about multiple websites and stores).

SEO Field Descriptions

  • Use Web Server Rewrites

Each page in a Magento website is generated starting with the same main PHP script. This file is called index.php and normally resides in the root folder of the website. In order to run this script for each page, each Magento URL typically looks like this:

 http://www.domain.com/magento/index.php/storeview/url-identifier

Using a technique called web server rewrites, Magento can hide the file name portion of the URL, making the URL look like this:

 http://www.domain.com/magento/storeview/url-identifier

To hide the “index.php” part of the URL is common practice in most PHP-based content management systems. It has no measureable effect on the usability or performance of your website and will not affect your website’s ranking in the search engines.

Unsecure Field Descriptions

  • Base URL - Full address to the root Magento folder for the website (where the index.php file is located). The URL should include a trailing slash.
 http://www.domain.com/magento/
  • Base Link URL - Typically points to the same folder as Base URL. A simple way to refererence the base URL is
 {{unsecure_base_url}}

for the unencrypted URL in the Unsecure section, and

 {{secure_base_url}}

in the Secure section.

  • Base Skin URL - Points to the folder where the skin for this website is located. By default, this folder is called “skin”. For the Unsecure URL, you can designate this folder using
 {{unsecure_base_url}}skin/

If you are running multiple sites off the same Magento folder structure, you may want to use different skin folders for each site, e.g. to use a different layout for each site. Using a different folder is also useful if you want to store your skins outside the Magento folder.

  • Base Media URL - Points to the folder where the catalog images for this website are located. By default, this folder is called “media”. For the Unsecure URL, you can designate this folder using
 {{unsecure_base_url}}media/

If you are running multiple sites off the same Magento folder structure, you may want to use different media folders for each site, e.g. if you want the ability to backup and restore them separately. Using a different folder is also useful if you want to store your images outside the Magento folder.

  • Base JavaScript URL - Points to the folder where the JavaScript scripts for this website are located. By default, this folder is called “js”. For the Unsecure URL, you can designate this folder using
 {{unsecure_base_url}}js/

If you are running multiple sites off the same Magento folder structure, you may want to use different JavaScript folders for each site, e.g. if you want the ability to update them separately. Using a different folder is also useful if you want to store your scripts outside the Magento folder.

Secure Field Descriptions

Magento can force the browser to use SSL encryption both in its frontend and backend. If you install an SSL certificate for your domain name, you can request that Magento uses encrypted “https” URLs instead of unencrypted “http” URLs in the frontend (the store itself) and/or in the backend Admin system. These settings are located at the bottom of the “Secure” section of this page.

  • Base URL - Make sure that base URL ends with ‘/’ (slash), e.g. http://yourdomain/magento/
  • Base Link URL - Make sure that base URL ends with ‘/’ (slash), e.g. http://yourdomain/magento/
  • Base Skin URL
  • Base Media URL
  • Base JavaScript URL
  • Use Secure URLs in Frontend
  • Use Secure URLs in Admin

Default Pages Field Descriptions

This section is used to specify the pages in Magento’s own content management system (CMS) that are used for the starting page of the website, and for “page not found” errors (read more about the Magento CMS).

  • Default Web URL - Designates the page that is loaded for the base URL, i.e. when the URL does not contain a URL identifier. Scope: store view.

The default value is “cms”. If you want the website to start by showing a blog, and you have installed this blog in a folder called “magento/blog/”, you can set the Default web url to “blog”.

  • CMS Home Page - After a home page has been created in Magento’s CMS (via CMS > Pages > Manage Content), select it from the drop down here to assign it as the home page of your website. Scope: store view.
  • Default No-route URL - contains the URL of the page you want loaded into the browser if an http 404 “not found” error occurs. The default value is “cms/index/noRoute”. Scope: store view.
  • CMS No Route Page - After a page-not-found page has been created in Magento’s CMS (via CMS > Pages > Manage Content), select it from the drop down here to assign it as the 404 page of your website. Scope: store view.
  • CMS No Cookies Page
  • Show Breadcrumbs for CMS Pages - Scope: store view. “Breadcrumbs” (also called “you-are-here” lines) appear by default on each catalog page in Magento:
 Home / Electronics / Cameras / Accessories

If you want similar breadcrumbs to appear in the pages that you have made yourself using the Magento CMS, select Yes for the Show breadcrumbs for CMS pages setting. The breadcrumb for a CMS page contains its Title, e.g.

 Home / About us

Polls Field Descriptions

  • Disallow Voting in a Poll Multiple Times from Same IP-address -

Magento can ensure that each IP address only has one vote in each of your polls (read more about polls). Setting the Disallow voting in a poll multiple times from same IP-address option to Yes will limit each IP address to only one vote in each poll.

Note that multiple users may have legitimate reasons to share the same IP address, e.g. by using the same computer to access your site or by using an IP sharing setup such as a home router.

Session Cookie Management Field Descriptions

  • Cookie Lifetime
  • Cookie Path
  • Cookie Domain
  • Use HTTP Only

Magento uses cookies to keep track of each visitor and to link them to their shopping cart. The “Session cookie management” settings correspond to the parameters of the PHP Setcookie function.

The Cookie path allows you to make Magento cookies available in other directories (folder paths) than the current. If you want to make cookies available anywhere in a site you should set this value to a single forward slash:

 /

The Cookie Domain is mainly used to control whether cookies will be visible in subdomains (e.g. http://subdomain.domain.com/ or not. To ensure that cookies are available in all your subdomains, enter your domain name prefixed with a period:

 .domain.com

The Cookie Lifetime setting controls when the browser deletes the Magento cookies automatically. The default value is 3600 which means that the cookies remain in the browser for one hour (60 minutes * 60 seconds) unless the browser deletes the cookies for some other reason.

Note: Magento requires the user’s browser to accept its cookies. Using cookies may conflict with the browser’s privacy settings. You may be forced to provide a compact privacy policy to the browser, or to set the Cookie Lifetime to 0 to ensure that your cookies disappear with the browser session.

Session Validation Settings Field Descriptions

  • Validate REMOTE_ADDR
  • Validate HTTP_VIA
  • Validate HTTP_X_FORWARDED_FOR
  • Validate HTTP_USER_AGENT
  • Use SID on Frontend

Browser Capabilities Detection Field Descriptions

  • Redirect to CMS-page if Cookies are Disabled
  • Show Notice if JavaScript is Disabled

Design Tab

This is the key page to set your design template. Please note that the approach to theme design has altered slightly with version 1.4. A quick summary of the new approach can be found on the forums here. While the new approach appeared to be planned from the outset it was only fully implemented in 1.4, hence the confusing references to multiple interfaces in the older designers guide documentation and other resources.

Package Field Descriptions

  • Current Package Name - Design package (prior to CE v1.3 called “interface”) to use for this website. For any theme, the design package file paths are of the form:
app/design/frontend/<package>/<theme>
skin/frontend/<package>/<theme>

Where <package> is the value you put in this field.

Prior to version 1.4 For most simple websites this could be set to “default”, incorrectly changing this option to your theme name is a common source of errors!

From version 1.4 The terminology has changed slightly, but the basic idea is the same. Where before the term <interface> was used, now the term <package> is used. In addition there is now a base folder provided by Magento that holds the underlying basic theme files - if ever the store looks for a file and you haven’t provided it in your custom theme it will fall back to the base folder.

The preferred approach now when creating any custom theme is to make a new package folder named after your theme. Then make a subdirectory called “default” where you put the majority of your files. You can then create additional subdirectories for any theme variants you need within your design package, e.g. you may want different color schemes for some areas, multiple stores or other languages. As a minimum you should always create a “default” folder inside of your package folder, so the directory structure for a custom theme for 1.4 with a default theme and a green theme variant would look like:

app/design/frontend/<package>/default
app/design/frontend/<package>/green
skin/frontend/<package>/default
skin/frontend/<package>/green

Most of your custom files will live in default, only the changes required to make it ‘green’ would live in green.

Themes Field Descriptions

  • Translations
  • Templates
  • Skin (Images / CSS)
  • Layout
  • Default

In most cases, if the <package> is set in the Current Package field above, all these fields can remain blank. Magento will go to the default directory in the <package> directory to find the customized files.

If you want a theme variant of your <package> to be the default theme, the easiest way to change your theme is to enter your theme variant name in the “Default” field in this section, leaving all other options in this section blank. For example, if you want your “green” theme to be the default theme for the website, enter “green” in the default field here.

Magento looks for files like this: Current package’s green theme > Current package’s default theme > Magento Base folder.

You can also mix and match components from various themes using the other fields in this section. For example, if you want to use the CSS from the “blue” theme with your custom theme, enter “blue” in the “Skin (images/css)” option box and leave the default box set to “green”.

Common Problems

1. Entering the wrong thing in the Current Package Name field. For most people this can remain “default”. If you do really need to change this you probably know all this anyway.

2. Forgetting to turn off the caching. Remember to go to System > Cache Management and turn off caching before doing any theme work.

HTML Head Field Descriptions

  • Default Title
  • Title Prefix
  • Title Suffix
  • Default Description
  • Default Keywords
  • Default Robots
  • Miscellaneous Scripts - This will be included before head closing tag in page HTML.
  • Display Demo Store Notice

Header Field Descriptions

  • Logo Image Src
  • Logo Image Alt
  • Welcome Text

Footer Field Descriptions

  • Copyright
  • Miscellaneous HTML

Product Image Watermarks Field Descriptions

  • Base Image Watermark Default Size - Example format: 200×300.
  • Base Image Watermark Opacity, Percent
  • Base Image Watermark - Allowed file types: jpeg, gif, png.
  • Base Image Watermark Position
  • Small Image Watermark Default Size - Example format: 200×300.
  • Small Image Watermark Opacity, Percent
  • Small Image Watermark - Allowed file types: jpeg, gif, png.
  • Small Image Watermark Position
  • Thumbnail Watermark Default Size - Example format: 200×300.
  • Thumbnail Watermark Opacity, Percent
  • Thumbnail Watermark - Allowed file types: jpeg, gif, png.
  • Thumbnail Watermark Position

Pagination Field Descriptions

  • Pagination Frame - How many links to display at once.
  • Pagination Frame Skip - If the current frame position does not cover utmost pages, will render link to current position plus/minus this value.
  • Anchor Text for Previous - Alternative text for previous link in pagination menu. If empty, default arrow image will used.
  • Anchor Text for Next - Alternative text for next link in pagination menu. If empty, default arrow image will used.

Currency Setup Tab

Currency Options Field Descriptions

  • Base Currency - Base currency is used for all online payment transactions. Scope is defined by the catalog price scope (”Catalog” > “Price” > “Catalog Price Scope”).
  • Default Display Currency
  • Allowed Currencies

Webservicex Field Descriptions

  • Connection Timeout in Seconds

Scheduled Import Settings Field Descriptions

  • Enabled
  • Service
  • Start Time
  • Frequency
  • Error Email Recipient
  • Error Email Sender
  • Error Email Template

Store Email Addresses Tab

Use this section of system configuration to specify email addresses used in your store.

By default, there are three predefined addresses each used in appropriate situations:

  • General contact
  • Sales representative
  • Customer support

Also, there are two extra email addresses left if you need them:

  • Custom email 1
  • Custom email 2

Each predefined address has the default sender name and sender email entered. Do not forget to change these values when you set up your own store.

Note that the settings that you define are applied to the whole Website. If you run multiple stores on a Website, you may set different Email addresses for each store.

To enter email addresses for an individual store that differ from those specified for entire Website:

  1. Select the desired store in the Current Configuration Scope dropdown menu in the upper-left portion of the system configuration screen.
  2. Click the Store Email Addresses section.
  3. Clear the Use website check box next to the field you want to change and replace the value in the field with the desired one.

Contacts Tab

In this section you specify parameters related to the Contact Us form. Each field in the Email Options section has the predefined value. Do not forget to change these values when you set up your own store.

Contact Us Field Descriptions

  • Enable Contact Us - Defines whether the Contact Us form is available in your store. If yes the contact us link will automatically show up in footer of your website.

Email Options Field Descriptions

  • Send Emails To - Defines the email address that the messages will be sent to when customers use the Contact Us option.
  • Email Sender - Indicates the name on the from: line of comments sent using the Contact Us option.
  • Email Template - Template used when customers’ comments are sent to the email address specified in the Send emails To field. If you want to use your own template instead of the default template, refer to the Transactional Emails page.

Note that the settings that you define are applied to the whole Website. If you run multiple stores on a Website, you may want to set different Email address, Email Sender and template used for each store. To enter contact information used by the Contact Us option for an individual store that differs from the information specified for entire Website:

  1. Select the desired store in the Current Configuration Scope dropdown menu in the upper-left portion of the system configuration screen.
  2. Click the Contacts section.
  3. Clear the Use website check box next to the field you want to change and replace the value in the field with the desired one.

Reports Tab

Dashboard Field Descriptions

  • Year-To-Date Starts
  • Current Month Starts

Content Management Tab

WYSIWYG Field Descriptions

  • Enable WYSIWYG Editor

CMS Page Hierarchy Field Descriptions

  • Enable Hierarchy Functionality
  • Enable Hierarchy Metadata
  • Default Layout for Hierarchy Menu
  • Hierarchy Page Lock Timeout (seconds) - Empty value disables page locking. Non-empty values less than 120 are ignored.

CMS Versioning Field Descriptions

  • CMS Page Default Versioning

Further Reading




 

Magento 2 GitHub Repository

Magento Job Board - Some sort of tag line goes here

Latest Posts| View all Jobs