magento community edition user guide latest

732

Upload: carlos-urrutia

Post on 03-Oct-2015

40 views

Category:

Documents


14 download

DESCRIPTION

magento

TRANSCRIPT

  • Magento Community Edition, Version 1.9 Copyright 2014 Magento, Inc. All rights reserved.

  • iiiMagento Community Edition:User Guide

    Contents

    Getting Started 1Chapter 1: Welcome to Magento! 3

    Resources 4

    Join the Conversation! 6

    Chapter 2: Installing Magento 9

    System Requirements 9

    Part I: Magento Installation 10

    Part II: Magento Installation 19

    Reinstalling Magento CE 23

    Staging Environment 23

    Chapter 3: Your Magento Account 25

    Sharing Your Account 26

    Chapter 4: Quick Tour 29

    Your Storefront 29

    Customer Journey 31

    Attract New Customers 33

    Engage Your Customers 34

    Increase Average Order Value (AOV) 35

    Moment of Purchase 37

    Customer Retention 38

    Loyalty & Advocacy 39

    Success! 40

    Basic Configuration 43Chapter 5: Store Admin 45

    Admin Login 46

  • Contents

    iv Magento Community Edition:User Guide

    Message InBox 46

    Dashboard 50

    Admin Menu 51

    Admin Tools 54

    Global Record Search 55

    List Controls 56

    Actions Control 58

    Selecting Records 58

    Checkbox States 58

    Chapter 6: Multiple Sites, Stores & Views 61

    Setting Up Store Hierarchy 61

    Configuration Scope 64

    Chapter 7: Store Information 67

    Locale Options 68

    States Options 69

    Countries Options 70

    Currency Setup 71

    Shipping Settings 73

    Store Email Addresses 75

    Contact Us 77

    Chapter 8: Industry Compliance 79

    PCI Compliance Guidelines 80

    Privacy Policy 81

    Cookie Law Compliance 82

    Cookie Restriction Mode 82

    Google Analytics Cookies 85

    Product Catalog 87Chapter 9: Navigation by Category 89

    Top Navigation 90

    Breadcrumb Trail 91

    Layered Navigation 92

    Filterable Attributes 93

  • Contents

    vMagento Community Edition:User Guide

    Price Navigation 94

    Iterative Splitting 95

    Creating Categories 97

    Modifying Categories 100

    Root Categories 100

    Hidden Categories 102

    General Information 104

    Display Settings 105

    Custom Design 107

    Category Products 108

    Chapter 10: Managing Attributes 111

    Attribute Input Types 112

    Creating Attributes 113

    Deleting Attributes 116

    Creating an Attribute Set 116

    Attribute Quick Reference 118

    Attribute Properties 120

    Attribute Frontend Properties 123

    Chapter 11: Flat Catalog 125

    Flat Catalog Configuration 126

    Chapter 12: Creating Products 129

    Product Types 130

    Simple Product 132

    Grouped Product 137

    Configurable Product 140

    Virtual Product 147

    Bundle Product 150

    Downloadable Product 155

    Downloadable Product Configuration 161

    Chapter 13: Product Information 163

    General 164

    Meta Information 167

    Recurring Profile 168

  • Contents

    vi Magento Community Edition:User Guide

    Design 173

    Gift Options 174

    Websites 175

    Categories 176

    Related Products 177

    Up-sells 178

    Cross-sells 179

    Custom Options 180

    Chapter 14: Inventory 183

    Inventory Configuration 183

    Managing Stock 185

    Stock Availability 188

    Stock Availability Message Scenarios 190

    Product Page Messages 190

    Catalog Page Messages 191

    Out of Stock Threshold 192

    Product Alert Configuration 193

    Product Alerts Run Settings 193

    Managing Stock for Configurable Products 194

    Chapter 15: Product Images 197

    Thumbnail Gallery 197

    Light Boxes and Sliders 198

    Image Zoom 198

    Image Size and Type 199

    Adding Product Images 200

    Placeholders 202

    Watermarks 203

    Shopping Cart Thumbnails 204

    Chapter 16: Product Pricing 205

    Prices 205

    Special Price 207

    Tier Price 208

    Minimum Advertised Price (MAP) 210

  • Contents

    viiMagento Community Edition:User Guide

    Global Configuration 211

    Product Group Price 215

    Group Price Examples 216

    Group Price Attribute 217

    Search & SEO 219Chapter 17: Storefront Search Tools 221

    Quick Search 222

    Advanced Search 223

    Search Results 225

    Popular Search Terms 228

    Catalog Search Configuration 229

    Chapter 18: Managing Search Terms 231

    Adding Search Terms 231

    Chapter 19: SEO Best Practices 235

    Meta Information 236

    Sitemap 237

    Catalog URL Options 238

    Dynamic URL 238

    Static URL 238

    URL Key 239

    Store Code 239

    HTML Suffix 240

    Category Path 240

    Dynamic Media URLs 242

    Canonical Meta Tag 244

    Chapter 20: Managing URL Rewrites 247

    Automatic Product Redirects 247

    Creating URLRewrites 249

    Creating a Product Rewrite 251

    Creating a Category Rewrite 253

    Creating a Custom Rewrite 255

  • Contents

    viii Magento Community Edition:User Guide

    Marketing 259Chapter 21: Promotions 261

    Product Relationships 262

    Catalog Price Rules 263

    Price Rule with Multiple SKUs 267

    Shopping Cart Price Rules 269

    Coupon Codes 280

    Auto-Generating Coupon Codes 282

    Exporting Auto-Generated Coupon Codes 283

    Tracking Coupon Usage 284

    Free Shipping Promotion 285

    Buy X Get Y Free 288

    Discount with Minimum Purchase 289

    Chapter 22: Shopping Tools 295

    Customer Engagement 295

    Wishlists 296

    Wishlist Configuration 297

    Compare Products 298

    Recently Viewed/Compared Products 301

    Product Reviews 302

    Writing Product Reviews 302

    Moderating Reviews 303

    Custom Ratings 304

    Tags 305

    Products Tagged by Administrators 306

    Moderating Tags 307

    Tag Activity 308

    Polls 308

    Editing a Poll 310

    Email a Friend 311

    Gift Options 312

    Gift Options Configuration 312

  • Contents

    ixMagento Community Edition:User Guide

    Chapter 23: Newsletters 315

    Newsletter Configuration 316

    Newsletter Templates 317

    Newsletter Queue 318

    Chapter 24: Sales Channels 319

    Social Marketing 319

    Facebook Open Graph 319

    Setting Up RSS Feeds 323

    Chapter 25: Google Tools 325

    Google Merchant Center 325

    Google Sitemap 330

    Google Analytics 334

    Google Shopping 337

    Content Elements 339Chapter 26: Mastering Magento CMS 341

    CMS Menu 341

    Chapter 27: Content Pages 343

    Core Content 343

    Creating a Page 345

    Using the Editor 348

    Inserting a Link 349

    Inserting Images 350

    Adding a Widget 351

    Chapter 28: Static Blocks 355

    Creating a Static Block 356

    Positioning Blocks 357

    Block References 357

    Chapter 29: Widgets 361

    Widget Types 361

    Creating a Widget 362

    CMS Static Block Widget 365

  • Contents

    x Magento Community Edition:User Guide

    New Products List 366

    Mini Shopping Cart Widget 370

    Chapter 30: Variables 373

    Predefined Variables 373

    Custom Variables 375

    Chapter 31: Layout Updates 377

    Placing a Block with a Layout Update 378

    Controlling Block Order 379

    Standard Block Layout 380

    Layout Update Syntax 382

    Layout Update Examples 385

    XML Load Sequence 387

    Default Layout 387

    Changes to Specific Pages 388

    Chapter 32: Markup Tags 389

    Using Markup Tags in Links 391

    Design & Theme 393Chapter 33: Your Store Design 395

    Your Store Logo 395

    Changing the Welcome Message 396

    Store Demo Notice 397

    Chapter 34: Page Layout 399

    Page Layout Variations 399

    Page Layout Examples 401

    1 Column Layout 401

    2 Columns with Left Bar 402

    2 Columns with Right Bar 402

    3 Columns 403

    Uploading a Favicon 404

    Chapter 35: Page Configuration 407

    HTML Head 407

  • Contents

    xiMagento Community Edition:User Guide

    Header 409

    Page Footer 410

    Chapter 36: Your Stores Theme 411

    Responsive Web Design 411

    Using the Default Theme 412

    Exceptions 413

    Technical Information 413

    Code Location 414

    Installing a New Theme 415

    Customers 419Chapter 37: Customer Accounts 421

    Account Dashboard 421

    Chapter 38: Customer Groups 425

    Sales & Orders 427Chapter 39: Managing Orders 429

    Order Process Overview 430

    Chapter 40: Assisted Shopping 431

    Online Customers 432

    Create an Order 433

    Update an Order 437

    Create a Customer Account 439

    Update a Customer Account 442

    Persistent Shopping Cart 443

    Types of Cookies 443

    Cookie Scenarios 444

    Cookie Workflow 445

    Terms and Conditions 448

    Chapter 41: Order Fulfillment 451

    Order Workflow 452

    Order Status 453

  • Contents

    xii Magento Community Edition:User Guide

    Custom Order Status 454

    Invoice an Order 456

    Print Invoices 459

    Ship an Order 460

    View Shipment Detail 461

    Packing Slips 461

    Shipping Labels 463

    PDF Printouts 470

    Customer Address Formats 470

    Examples 472

    Chapter 42: Store Credit and Refunds 473

    Product Return Workflow 474

    Create a Credit Memo 475

    Print a Credit Memo 479

    Payments 481Chapter 43: Basic Payment Methods 483

    Merchant Location 484

    Bank Transfer Payment 484

    Cash On Delivery 486

    Check / Money Order 487

    Purchase Order 489

    Zero Subtotal Checkout 490

    Saved Credit Cards 492

    Chapter 44: PayPal Payment Solutions 495

    PayPal Express Checkout 495

    All-In-One Solutions 495

    Payment Gateways 496

    PayPal Business Accounts 496

    PayPal Payments Advanced 497

    Merchant Requirements 497

    Configuration 497

    Checkout Workflow 497

  • Contents

    xiiiMagento Community Edition:User Guide

    Order Processing Workflow 498

    PayPal Payments Pro 498

    Requirements 498

    Configuration 498

    Checkout Workflow 498

    Order Processing Workflow 499

    PayPal Payments Standard 499

    Merchant Requirements 500

    Configuration 500

    Checkout Workflow 500

    PayPal Express Checkout 500

    Requirements 501

    Configuration 501

    Checkout Workflow 501

    Save Customer Billing Address 502

    Manage Order Transactions 503

    Payment Action Set to Order 503

    Bill Me Later 504

    Billing Agreements 507

    Workflow 508

    Create Billing Agreement from Customer Account 508

    Create Billing Agreement with Order 509

    Managing Billing Agreements 510

    Create Sales Order with Billing Agreement 510

    Settlement Reports 510

    View a Settlement Report 512

    PayPal Payflow Pro 513

    Customer Workflow 513

    Order Processing Workflow 514

    PayPal Payflow Link 514

    Customer Workflow 514

    Order Workflow 515

    PayPal Payment Solutions by Country 516

    Chapter 45: Payment Solutions & Gateways 519

  • Contents

    xiv Magento Community Edition:User Guide

    Worldwide 519

    Europe 520

    Oceania 521

    Authorize.Net 521

    Direct Post Method 522

    Admin Workflow 526

    Customer Workflow 526

    Partial Authorization with Authorize.Net 527

    Customer Workflow 527

    Admin Workflow 529

    Partial Authorization Refunds 529

    Chapter 46: Payment Services 531

    3D Secure Credit Card Validation 531

    3D Secure Customer Workflow 534

    Shipping 535Chapter 47: Basic Shipping Methods 537

    Shipping Settings 538

    Flat Rate 539

    Free Shipping 540

    Table Rates 542

    Price v. Destination Example 547

    Online Rates 548

    Chapter 48: Shipping Carriers 549

    Package Type by Carrier 550

    FedEx 550

    UPS 551

    USPS 552

    DHL 553

    Chapter 49: Shipping Labels 555

    Workflow 555

    Shipping Label Configuration 556

    Generate Shipping Labels 558

  • Contents

    xvMagento Community Edition:User Guide

    Create Packages 560

    Change Product Quantities in Package 563

    Print Labels for Multiple Orders 563

    Tracking Numbers 563

    Taxes 565Chapter 50: Managing Taxes 567

    Tax Resource Permissions 567

    General Tax Configuration 567

    Tax Classes 572

    Product Tax Classes 572

    Customer Tax Classes 573

    Tax Zones & Rates 573

    Tax Rules 575

    Cross-Border Price Consistency 577

    Fixed Product Tax 578

    Fixed Product Tax Calculations 578

    Fixed Product Tax Setup 579

    Disclosing FPT Prices in Email 583

    Compound Taxes 583

    Setting Up Compound Taxes 584

    Chapter 51: Value Added Tax (VAT) 587

    VATID Validation 589

    Setting Up VAT ID Validation 590

    VAT Validation Customer Workflow 597

    During Registration 597

    During Checkout 597

    Managing VAT Validation 598

    VAT Number Customer Address Attribute 598

    Disable Automatic Customer Group Change 599

    VAT ID Validation in Customer Accounts 600

    VAT ID Validation When Creating an Order 600

  • Contents

    xvi Magento Community Edition:User Guide

    Store Operations 603Chapter 52: Managing Email Templates 605

    Uploading Your Email Logo 605

    Customizing Email Templates 606

    Email Template Configuration 609

    Chapter 53: Managing Data Transfer 611

    Working with CSV Files 611

    Product CSV Structure 611

    Customer CSV Structure 613

    Importing Data 614

    File Validation 615

    Importing Product Images 615

    Import Guidelines 616

    Exporting Data 617

    Chapter 54: Reports 619

    Dashboard 619

    Snapshot Reports 620

    Dashboard Configuration 621

    Running Reports 622

    Orders Report 622

    Refreshing Sales Report Statistics 625

    Available Reports 626

    Chapter 55: Admin Permissions 629

    Creating New Users 629

    Creating Custom Roles 631

    Chapter 56: Security 635

    Security Configuration 635

    CAPTCHA 636

    Admin CAPTCHA Configuration 637

    Customer CAPTCHA Configuration 639

  • Contents

    xviiMagento Community Edition:User Guide

    System Operations 643Chapter 57: Index Management 645

    Manual Reindexing 647

    Index Modes 647

    Chapter 58: Cache Storage Management 651

    Clearing Caches 651

    External Full-Page Cache 654

    Chapter 59: Alternate Media Storage 655

    Using a Database for Media Storage 655

    Accessing Media from a Database 656

    Using a Content Delivery Network 656

    Accessing Media from a CDN 658

    Chapter 60: Server Backups & Rollback 659

    Creating a Backup 659

    Roll Back Changes 660

    Restricting Access to Backup and Rollback 660

    Create a Backup from Magento Connect Manager 661

    Chapter 61: Magento Connect 663

    Updating Magento 663

    Installing Extensions 665

    Chapter 62: Web Services 667

    Magento Core API Settings 667

    WS-I Endpoint URL 667

    General Settings 667

    Activating Web Services 668

    REST Roles 669

    Appendix A: Glossary 671

    Appendix B: Editor Toolbar 681

    Index 691

  • Getting Started

  • 3Magento Community Edition: User Guide

    Chapter 1:

    Welcome to Magento!Magento Community Edition is a feature-rich eCommerce platform, built on open-source technology that provides online merchants with unprecedented flexibility andcontrol over the look, content, and functionality of their eCommerce store. MagentoCEs intuitive administration interface features powerful marketing, search engineoptimization, and catalog management tools to give merchants the power to createsites that are tailored to their unique business needs. Designed to be completelyscalable, Magento CE offers companies a stable, secure, customizable eCommercesolution.

    Magento Community Edition

  • Resources Chapter 1: Welcome to Magento!

    4 Magento Community Edition: User Guide

    ResourcesMagento provides a wealth of business and technical resources, self-help tools, andservices to help you succeed.

    Knowledge Base

    Got a question? The Magento KnowledgeBase has an answer. Our KnowledgeBase is your one-stop shop for helpfularticles and how-to instructions, as wellas technical product documentation.

    Guides and Tips

    Our user guides, eBooks, and articlesprovide a wealth of information that is

    ready for download.

    Wiki

    The Magento Wiki is where you canlearn from others, and share what youknow! To help you get started, wevegathered a list of articles that will helpyou on your way.

    http://www.magentocommerce.com/knowledge-basehttp://www.magentocommerce.com/resources/magento-user-guidehttp://www.magentocommerce.com/wiki/

  • Chapter 1: Welcome to Magento! Resources

    5Magento Community Edition: User Guide

    Forums

    The Magento forums provide access to anetwork of dedicated Magento

    enthusiasts who share tips, tricks andsupport.

    Blog

    Check out the Magento blog for thelatest information about new features,trends, best practices, upcoming events,and more!

    Webinars

    Expand your horizons! Register toattend the upcoming Magento webinar,

    or catch up on previous, archivedwebinars.

    Training & Certification

    Magento has training courses for everyrole, including marketers, productmanagers, designers and developers.Magento U courses provide practical,hands-on exercises that help studentslearn quickly.

    http://www.magentocommerce.com/boardshttp://magento.com/bloghttp://www.magentocommerce.com/media/webinarshttp://magento.com/help/overview

  • Join the Conversation! Chapter 1: Welcome to Magento!

    6 Magento Community Edition: User Guide

    Partners

    Need help to set up or fine-tune yourstore? Magentos certified developers and

    consultants are experts in store setup,design, integration and marketing. Find

    a certified expert and jumpstart yourbusiness today!

    Expert Consulting Services

    Magentos Expert Consulting Group(ECG) helps Magento merchants andSolution Partners maximize theirsuccess. Our experts offer comprehensiveanalysis and best practicerecommendations, from architectureplanning through post-deployment.

    Join the Conversation!

    Facebook

    Find out whats happening and join thediscussion on our Facebook page!

    http://magento.com/training/overviewhttp://www.magentocommerce.com/consulting/https://www.facebook.com/magento

  • Chapter 1: Welcome to Magento! Join the Conversation!

    7Magento Community Edition: User Guide

    Twitter

    Follow us on Twitter!

    YouTube

    Learn while you watch videoson our YouTube channel!

    LinkedIn

    Join the users group andconnect with others on LinkedIn!

    https://twitter.com/magentohttp://www.youtube.com/user/magentocommerce/featuredhttp://www.linkedin.com/groups?home=&gid=146360&trk=anet_ug_hm

  • 8 Magento Community Edition: User Guide

    Join the Conversation! Chapter 1: Welcome to Magento!

    Notes________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

  • 9Magento Community Edition: User Guide

    Chapter 2:

    Installing MagentoMagento Community Edition is open source software and can be downloaded forfree. Developers can modify the core code and add features and functionality byinstalling extensions from the Magento Connect marketplace.

    Because Magento does not provide technical support for this software, businessesusing Magento Community Edition to run their stores might need access to theirown Magento experts to help with the installation and configuration. Answers tomany technical questions can be found on our user forum.

    Magento Community Edition is licensed under the Open Software License (OSL)v3.0, an open source certified license. To learn more, see the License / TrademarkFAQ on our site.

    After you have verified that your hosting environment meets Magentos systemrequirements, you can download Magento CE free of charge from the Magentocommunity site. Although optional, we recommend that you register on our site soyou have access to the forums, wiki, groups, screencasts, and other resources thecommunity has to offer.

    System RequirementsSee our website for a complete list of system requirements.

    Base System Requirements

    Operating Environment LAMP (Linux, Apache, MySQL, and PHP)

    Operating Systems(Unix only)

    Linux x86Linux x86-64

    Web Servers Apache 1.3.xApache 2.0.xApache 2.2.x

    PHP Version 5.2.13

    http://www.magentocommerce.com/magento-connect/http://www.magentocommerce.com/boards/http://www.magentocommerce.com/license#What open source license do we use for Magento Community Edition?http://www.magentocommerce.com/license#What open source license do we use for Magento Community Edition?http://magento.com/resources/system-requirementshttp://magento.com/resources/system-requirementshttp://magento.com/resources/system-requirements

  • Part I: Magento Installation Chapter 2: Installing Magento

    Base System Requirements

    PHP Configuration safe_mode off

    memory_limit 512 MB recommended256 MB minimum

    MySQL 4.1.20InnoDB storage engine

    SSL A valid security certificate is required to work over a securechannel (HTTPS) from the Magento Admin, or when sub-mitting form data from the storefront. Self-signed SSL cer-tificates are not supported.

    Part I: Magento InstallationDuring the first part of the installation, you will download the scripts and sample datafiles needed to install Magento. You will also set up permissions on the server, andcreate a new database.

    Downloader

    10 Magento Community Edition: User Guide

  • Chapter 2: Installing Magento Part I: Magento Installation

    11Magento Community Edition: User Guide

    Process Overview:Step 1: Download the Magento CE Downloader ScriptStep 2: Download the Sample DataStep 3: Upload the Downloader Script to Your ServerStep 4: Grant File Access PermissionsStep 5: Set Up the Store DatabaseStep 6: Upload the Sample Data to Your ServerStep 7: Run the Magento CE Downloader

    Step 1: Download the Magento CE Downloader Script

    1. Navigate to the Magento Community Edition download page.

    2. In the Downloader section, select one of the following formats for the archiveddownloader. The archive file name is: magento-downloader-x.x.x.zip (or .tar.gz, or.tar.bz2). The size of the archive is approximately 46K.

    3. Navigate to the Magento Community Edition download page.

    4. In the Downloader section, select one of the following formats for the archiveddownloader. The archive file name is: magento-downloader-x.x.x.zip (or .tar.gz, or.tar.bz2). The size of the archive is approximately 46K.

    l .zip

    l .tar.gz

    l .tar.bz2

    5. Click the Download button. While the file is downloading, take a moment to look overthe resources on the Magento Community page.

    6. Extract the archive to a directory of your choice on your local computer. The name of theextracted file is: downloader.php

    Step 2: Download the Sample DataMagento provides sample data with examples of products and basic content pages tohelp you get started. When you are ready to build your own catalog, you can reinstallMagento without the sample data. This step is recommended, but is not required.

    1. In the Sample Data section, Select your format for the archived sample data.

    2. Click the Download button, and Save the file anywhere on your local computer. The filename is: magento-sample-data-x.x.x.zip (or .tar.gz, or .tar.bz2). The size of the archive isapproximately 10MB.

    http://www.magentocommerce.com/downloadhttp://www.magentocommerce.com/downloadhttp://www.magentocommerce.com/download/get-started

  • Part I: Magento Installation Chapter 2: Installing Magento

    Magento provides sample data with examples of products and basic content pages tohelp you get started. When you are ready to build your own catalog, you can reinstallMagento without the sample data. This step is recommended, but is not required.

    3. In the Sample Data section, Select your format for the archived sample data.

    4. Click the Download button, and Save the file anywhere on your local computer. The filename is: magento-sample-data-x.x.x.zip (or .tar.gz, or .tar.bz2). The size of the archive isapproximately 10MB.

    Sample Data Download

    Step 3: Upload the Downloader Script to Your ServerUse an FTP or SFTP tool to copy the extracted downloader script to the root wwwdirectory of the server. (The root www directory is usually named public_html.) As analternative, you can copy the file to another subdirectory, such as /store.

    Step 4: Grant File Access PermissionsFor the Magento Installer to work correctly, the top-level Magento directory on theserver, and all directories beneath it must have correct permissions. To learn more, seethe Knowledge Base article: Recommended File System Ownership and Privileges.

    Step 5: Set Up the Store Database

    1. Create a new, empty database using one of the following methods:

    l Use phpMyAdmin or a similar tool provided by your hosting company. Forinstructions, see the documentation for the specific tool.

    l MySQL command line

    2. Create a new user with full permissions to the database. Then, write down the followinginformation:

    dbname The database name.

    dbuser The name of the database user.

    dbpassword The password for the database user.

    12 Magento Community Edition: User Guide

    http://www.magentocommerce.com/knowledge-base/entry/install-privs-before

  • Chapter 2: Installing Magento Part I: Magento Installation

    13Magento Community Edition: User Guide

    Step 6: Upload the Sample Data to Your ServerIf you want to use the sample data, it must be installed now. If you are ready to addyour own products, skip this step. You can use either of the following methods to installthe sample data:

    Method 1: FTP or SFTP

    1. Extract the sample data archive that you downloaded in Step 2, to a directory of yourchoice on your local computer. The file name is similar to: magento_sample_data_for_x.x.x.sql.

    The archive contains an SQL script with a dump of the sample data, and amedia/catalog folder with category and product images.

    Sample Data Archive

    2. Use an FTP or SFTP tool to copy the media folder and its subdirectories from your localcomputer to the magento installation directory on the server. Depending on your server,the path will look something like this:

    /var/www.magento/media

    /var/www/html/magento/media

    3. Use an FTP or SFTP tool to copy the magento sample data script to the server. A goodplace to put it is in the media/catalog folder.

    /var/www/magento/media/catalog

    /var/www/html/magento/media/catalog

    4. Do one of the following:

    l Use phpMyAdmin, or a similar tool to run the sample data script and import thedata into the new database.

    l On the command line, enter the following:

    mysql -u -p <

  • Part I: Magento Installation Chapter 2: Installing Magento

    You are now ready to install Magento!

    Method 2: Command Line

    If you prefer to install the sample data from the command line, see this Knowledge Basearticle, under the heading: Installing Optional Sample Data.

    Step 7: Run the Magento CEDownloader

    1. From your browser, navigate to the location of the Magento downloader on your server.The Magento Downloader welcome page appears.

    Welcome

    2. To validate your server environment, click the Continue button. If error warnings appear,correct the errors and click the Check Again button.

    Validation

    3. When you pass the validation test, do the following:

    14 Magento Community Edition: User Guide

    http://www.magentocommerce.com/knowledge-base/entry/ce18-and-ee113-installing

  • Chapter 2: Installing Magento Part I: Magento Installation

    15Magento Community Edition: User Guide

    a. Enter the following Database Connection information:

    l Host

    l User Name

    l User Password

    Database Connection

    b. Click the Check InnoDB button to confirm the connection.

    c. When you receive confirmation that the credentials are valid, click the Continuebutton.

    4. On the Magento Connect Manager Deployment page, do the following:

    Magento Connect Manager Deployment

  • Part I: Magento Installation Chapter 2: Installing Magento

    a. In the Loader Protocol section, set Magento Connect Channel Protocol to one ofthe following:

    HTTP (Recommended) HTTP is faster than FTP.

    FTP Choose FTP if outgoing connections are not allowed in your hostingenvironment.

    Loader Protocol

    b. In the Stability section, set Magento Connect Manager Version Stability toStable.

    Stability

    c. In the Deployment Type section, select one of the following:

    Deployment Type

    FTPConnection (Recommended) FTP allows you to upload files to theserver without changing read/write/execute permissions.After choosing FTP connection, complete the followingwith information provided by your FTP serveradministrator:

    Host Name Enter the host name of the FTPserver.

    Credentials Enter the FTP credentials provided byyour FTP server administrator

    InstallationPath

    Enter the path where Magento CEwill be installed. The installationpath points to the same directorythat contains the downloader.phpfile.

    Local Filesystem Deploying through the local file system requires the

    16 Magento Community Edition: User Guide

  • Chapter 2: Installing Magento Part I: Magento Installation

    17Magento Community Edition: User Guide

    Apache account permissions to be changed. When theinstallation is complete, contact your serveradministrator to update the file permissions.

    If the web server user can't write to the magentodirectory, do not proceed. Its most likely an ownershipissue, rather than a permissions issue.

    d. To verify the connection, click the Check FTP button. You will not be able tocontinue if any of the deployment parameters are invalid. After the FTP connectionis verified, click the Continue button.

    5. When the Magento Installation Wizard appears, do the following:

    Magento Installation Wizard

    a. Set Magento Connect Channel Protocol to the same protocol you selected in theprevious step. (Options include: HTTP/FTP)

    b. Custom permissions determine how read, write, and execute permissions areapplied to the downloaded folders and files. Set Use Custom Permissions to one ofthe following:

    Yes The Magento CE administrator can execute, write, and read files inthe downloaded folders. In the Folders and Files fields that appear,specify values in the octal number system to denote the permissionsthat the Magento administrator has for folders and files on the server.

    No Custom permissions are not specified for downloaded folders andfiles. In this case the system default values are used:

    0777 Folder permissions to read, write, and execute.

    0666 File permissions to read and write.

  • Part I: Magento Installation Chapter 2: Installing Magento

    c. Set Deployment Type to the type specified in the previous step. (Options include:Local Filesystem/FTP)

    d. When you are ready to start the download, click the Start the Download Processbutton to begin.

    Starting to Download

    e. When the "Download completed" message appears, click the Continue to MagentoInstallation button.

    If you were unable to complete the download process due to a connection error,try to upload the Full Magento Package from the Community download page.

    18 Magento Community Edition: User Guide

    http://www.magentocommerce.com/download

  • Chapter 2: Installing Magento Part II: Magento Installation

    19Magento Community Edition: User Guide

    Part II: Magento InstallationDuring the second part of the Magento installation, you will complete the initialconfiguration, and create an admin account. The initial installation creates a singlewebsite, one store, and three store views, which can be used for different languages.

    Process Overview:Step 1: License AgreementStep 2: LocalizationStep 3: ConfigurationStep 4: Create an Admin Account

    Step 1: License AgreementRead the terms of the Magento Community Edition End User License Agreement. If youagree to the terms, click the Continue button.

    License

    Step 2: LocalizationSelect the default localization settings for your Magento CE installation. The values canbe changed later for specific stores, store views, and websites.

    l Locale

    l Time Zone

    l Default Currency

  • Part II: Magento Installation Chapter 2: Installing Magento

    20 Magento Community Edition: User Guide

    Locale Settings

    Step 3: Configuration

    1. In the Database Connection section, do the following:

    a. Set Database Type to MySQL.

    b. In the Host field, enter the server's fully qualified host name or IP address. If yourdatabase server is on the same host as your web server, enter localhost.

    c. Refer to the database credentials from Part 1: Step 5, and enter the following:

    l Database Name

    l User Name

    l User Password

    d. (Optional) The Table prefix is used when there are multiple instances of Magnetothat share a single database. To learn more, see the Knowledge Base article:Installing and Verifying Magento Community Edition.

    Database Connection

    2. In the Web Access Options section, do the following:

    a. Enter the Base URL for the Magento store.

    b. In the Admin Path filed, enter the base URL for the stores Admin Panel. (Thedefault value is admin.)

    c. To display charts in the Dashboard, select the Enable Charts checkbox.

    http://www.magentocommerce.com/knowledge-base/entry/ce18-and-ee113-installing

  • Chapter 2: Installing Magento Part II: Magento Installation

    21Magento Community Edition: User Guide

    d. If you are installing Magento to a development or test environment, and the Webserver is not verifiable, select the Skip Base URL Validation Before the Next Stepcheckbox. Otherwise, leave the checkbox unselected.

    e. (Recommended) To enable the Apache mod_rewrite module, select the Use WebServer (Apache) Rewrites checkbox. To learn more, see the Knowledge Base article:Installing and Configuring Required Prerequisite Software.

    f. (Recommended) If your server has a valid security certificate, select the Use SecureURLs (SSL) checkbox. Then, complete the following:

    Secure Base URL Enter the complete base URL for the SSL connection.

    Run the AdminInterface with SSL

    Select the checkbox to run the store admin on the securechannel.

    These initial SSL settings can be modified later.

    Web Access Options

    3. In the Session Storage Options section, set Save Session Data In to one of the following:

    Session Storage Options

    File System Stores user session data on the file system in the magento-install-dir/var/session directory. File-based session storageis the most common configuration.

    Database Stores user session data in the database. Choose database

    http://www.magentocommerce.com/knowledge-base/entry/ce18-and-ee113-installing#install-prereq-software

  • Part II: Magento Installation Chapter 2: Installing Magento

    22 Magento Community Edition: User Guide

    storage if you have a clustered database, or if system accessis slow.

    4. When the Configuration settings are complete, click the Continue button.

    Step 4: Create an Admin Account

    1. In the Personal Information section, enter the following:

    l First Name

    l Last Name

    l Email

    Personal Information

    2. In the Login Information section, do the following:

    a. Enter the Username you of the owner of the Magento store.

    b. Enter the Password associated with the Admin account. To confirm, enter it againin the Confirm Password field.

    Login Information

    3. (Optional) If you already have one, enter the Encryption Key. Otherwise, Magento willgenerate one for you.

    The encryption key protects sensitive data such as passwords and personally identifiablecustomer information. The encryption key is stored on the server at: /app/etc/local.xml

    Important! When Magento generates your encryption key, write it down and keep it ina safe place. If you ever move your data to another Magento CE site, you will need theencryption key to recover the data.

  • Chapter 2: Installing Magento Reinstalling Magento CE

    23Magento Community Edition: User Guide

    Encryption Key

    4. Click the Continue button, and youre all set!

    l To explore your new store, click the Go to Frontend button.

    l To explore your stores admin, click the Go to Backend button.

    Reinstalling Magento CEIf you want to repeat the installation on the same server, it is not necessary to downloadthe files again.

    1. On the server, delete the file: app/etc/local.xml

    2. Delete any files and directories found in: var/

    3. With your browser, navigate to your Magento directory. For example:

    http://www.yourDomain.com/magento-directory

    The Magento Installation Wizard launches automatically.

    Staging EnvironmentIf you plan to develop your store over a period of time, we recommend that you set up astaging environment where you can test changes before applying them to the live store.

    A staging environment is just like any other Magento CE installation, but is notaccessible to the public. You can use a version control tool to keep files synchronizedbetween the staging environment and the live store. We highly recommend that you usea staging environment to test extensions and before updating your live store to a newversion of Magento CE.

  • 24 Magento Community Edition: User Guide

    Staging Environment Chapter 2: Installing Magento

    Notes________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

  • 25Magento Community Edition: User Guide

    Chapter 3:

    Your Magento AccountYou can find the information related to the products and services you have signedup to receive, as well as your contact and billing information in the dashboard ofyour Magento account. Your Magento account has a separate login from your store,and can be accessed from either the Magento website or from your stores Admin.

    Your Magento Account

    To log in to your Magento account:

    1. Navigate to the Magento site: http://www.magento.com

    2. In the upper-right corner, click theMy Account link.

    3. Enter your First Name, Last Name, Email Address, and select the functions MyCompany Primarily performs and My Role.

    4. Enter your User Name or Email , and Password. Then, click the Submit button.Your account dashboard appears.

    http://go.magento.com/

  • Sharing Your Account Chapter 3: Your Magento Account

    Log In to Your Account

    Sharing Your AccountYour Magento account contains information that can be useful to trusted employees andservice providers who help to manage your site. As the primary account holder, you haveauthority to grant limited access to your account to other Magento account holders.

    Shared Access

    26 Magento Community Edition: User Guide

  • Chapter 3: Your Magento Account Sharing Your Account

    27Magento Community Edition: User Guide

    When your account is shared, all sensitive informationsuch as your billing history orcredit card informationremains protected. It is not shared at any time with otherusers.

    All actions taken by users with shared access to your account are your soleresponsibility. Magento Inc. is not responsible for any actions taken by users to whomyou grant shared account access.

    To set up a shared account:

    1. Before you begin, get the following information from the new users Magento account:

    l Account ID

    l Email address

    2. Log in to yourMagento account.

    3. In the My Account panel on the left, under Shared Access, click Add New User.

    4. In the New User Information section, do the following:

    l Enter the Account ID of the new users Magento account.

    l Enter the Email address that is associated with the new users Magento account.

    5. In the Shared Information section, do the following:

    a. Enter a Sharename to identify your shared account. Because the Sharenamebecomes an option in the Switch Accounts list, it should be something that theother person will recognize as your account.

    b. To share your personal contact information, select the checkbox of each item thatyou want to make available to the other person:

    l Your Email

    l Your Phone

    6. In the Grant Account Permissions section, select the checkbox of each item that youwant to share.

    7. When complete, click the Create Shared Access button.

    You are notified when the new role is saved, and the new user record appears in theManage Users & Permissions section of the Shared Access page. Magento also sends anemail invitation with instructions for accessing the shared account to the new user.

  • Sharing Your Account Chapter 3: Your Magento Account

    Add a New User

    To access a shared account:

    1. When you receive the invitation to a shared account, the first thing you must do is tolog in to your own Magento account.

    Your account dashboard has a new Switch Accounts listbox in the upper-right corner,with options for My Account and the name of the shared account.

    2. To gain access to the shared account, set the Switch Accounts listbox to the name of theshared account.

    The shared account displays a welcome message and contact information. The left panelincludes only the items that you have been given permission to use.

    Switch Accounts

    3. When you are ready to return to your own account, simply set Switch Accounts to MyAccount.

    28 Magento Community Edition: User Guide

  • 29Magento Community Edition: User Guide

    Chapter 4:

    Quick TourThis quick tour follows the customer-decision journey that leads to a purchase on aneCommerce site powered by Magento Community Edition. Each item is linked to atopic in this guide, where you can learn more about the subject. You can also followalong on your computer with the sample data. The journey begins with yourstorefront.

    Your StorefrontOur storefront example is Madison Island, a fictional fashion website that we createdto highlight some of Magentos key features and functionality.

    To access your storefront:

    Using your browser, navigate to your store. The URL is something like this:

    http://www.yourdomain.com

  • Your Storefront Chapter 4: Quick Tour

    Home Page

    30 Magento Community Edition: User Guide

  • Chapter 4: Quick Tour Customer Journey

    31Magento Community Edition: User Guide

    Customer Journey

    Attract New Customers

    Magento Community Edition includesSEO functionality out of the box.Improve your search ranking and attractthe most visitors to your site.

    Engage Your Customers

    Design your site with pre-designedtemplates, or create a custom design

    with features that invite people tointeract with your store.

    Increase AOV

    Increase average order value withpromotions and content that encourageyour customers to shop more.

  • Customer Journey Chapter 4: Quick Tour

    32 Magento Community Edition: User Guide

    Moment of Purchase

    Give your customers a faster and easierway to check out. Calculate shipping

    and taxes automatically, and integratemultiple payment methods on a single

    page.

    Customer Retention

    Create and manage newsletters andpromotions to keep your customerscoming back for more.

    Loyalty & Advocacy

    Encourage customers to write productreviews, create wishlists, and send emailabout products to their friends. This willstrengthen your relationship with yourcustomers, who in return, will speakpositively of your business to friends

    andfamily.

  • Chapter 4: Quick Tour Customer Journey

    33Magento Community Edition: User Guide

    Attract New CustomersMagento Community Edition is packed with features that make it easy to create asearch engine friendly websites and increase the likelihood of bringing the rightcustomers to your site.

    Search Engine Optimization

    Magento offers powerful, native capabilities to streamline Search Engine Optimization(SEO) practices for content and site exposure that are integrated with the Admin, andtied directly into the user experience.

    Custom URLs

    Custom URLs are short, clean, and easy to remember. You can also autogenerate search-friendly URLs to streamline your purchase path.

    Meta Data

    Improve your search engine rankings by choosing specific criteria that helps searchengines to find and index your products more easily. Meta data can be entered forproduct, category, and content pages.

    Sitemap

    Link to a sitemap from the footer of your store to give customers an overview of thecatalog structure, with links to all categories and products in the store. You can alsoeasily integrate your store with Google Sitemap.

    Analytics

    In addition to monitoring your site from the Admin dashboard, you can integrate third-party analytics tools such as Google Analytics, for detailed statistics on traffic and sales.

  • Customer Journey Chapter 4: Quick Tour

    34 Magento Community Edition: User Guide

    Engage Your CustomersMagento Community Edition makes it easy to create a customized, engaging siteexperience. Encourage your customers to spend more time exploring your site, and givethem the tools to make it easy to find what they want faster.

    Content Management System

    Magentos CMS makes it easy to storepages, orparts of pages, that you canuse in your store. Its so intuitive thatsomeone without a technologybackground can create and manage sitecontent.

    Design & Theme

    Control the visual elements of your storewith a collection of templates and skin

    files. You can apply these visualelements to all pages in your store,

    giving your store a cohesive look andfeel.

    Multiple Stores, Sites & Views

    Control the look and feel of multiplesites, introduce new market andlanguages, and track analytics from asingle Admin.

    Multiple Devices

    Magentos powerful features make iteasy to create storefronts optimized for

    iPhone, Android, and Mobile Operabrowsers to help you engage consumerswith mobile eCommerce now and into

    the future.

  • Chapter 4: Quick Tour Customer Journey

    35Magento Community Edition: User Guide

    Shopping Tools

    Your store includes a set of shoppingtools that create opportunities for yourcustomers to interact with your store,connect on social media, and share withfriends.

    Sophisticated Search

    Filter product by price, manufacturer, orany other criteria to reduce the time to

    purchase.

    Increase Average Order Value (AOV)Magento Community Edition provides a range of tools to help you tailor the shoppingexperience, and encourage your customers to put more items in their shopping carts andspend more money.

    Promotions

    Magento's catalog and shopping cartprice rules let you create promotions

    that kick into gear when a set ofconditions is met.

  • Customer Journey Chapter 4: Quick Tour

    36 Magento Community Edition: User Guide

    Coupons

    Create limited-time offers and couponsthat customers can scan with theirphone and apply to a purchase.

    Product Suggestions

    Another way to increase AOV is to offersuggestions for related products and

    opportunities to up-sell and cross-sell atstrategic points along the path to

    conversion.

    User Permissions &Roles

    Restrict access to data in the Admin ona need to know basis. Create multipleadmin roles for read-only or and editingprivileges. Track and review all activityat a granular level to specific stores andwebsites.

  • Chapter 4: Quick Tour Customer Journey

    37Magento Community Edition: User Guide

    Moment of PurchaseNow that youve given your customer an engaging shopping experience, make it easy forthem to complete their purchases. Magento is designed to help you streamline yourcheckout process experience while boosting conversion rates.

    Order Processing

    Magento supports a complete order processing workflow. It's easy to customize orderstatuses and track communications between sales reps and customers.

    Shipping Labels

    Merchants have complete control over package characteristics such as weight and size.Shipping labels, rate, and barcode information originates directly from the carrier. Labelscan be generated for single or multiple orders.

    Multiple Shipping Options

    Magento supports a variety of shipping methods so you can give your customers achoice at checkout. Customers can see a real-time estimate of shipping charges rightfrom the shopping cart.

    Multiple Payment Options

    Magento Community Edition supports the payment methods and currencies needed forglobal commerce. You can choose the ones you want to offer, and at checkout, yourcustomers can choose the ones they prefer.

    PayPal Merchant Solutions

    It's easy to integrate a PayPal Payments account to provide your customers faster, moresecure checkout options.

    Assisted Shopping

    Assisted shopping makes it easy for customer service reps to create orders for customers.Customer service reps have access to shopping cart contents, and can move items from awishlist to a shopping cart, apply coupon codes, and more.

    Security

    Whether an order is fulfilled online or over the phone, Magento provides sophisticatedsecurity, including CAPTCHA and SSL encryption, with best-in-breed encryption andhashing algorithms to protect the security of the system.

  • Customer Journey Chapter 4: Quick Tour

    38 Magento Community Edition: User Guide

    Customer RetentionMagento makes it easy for you to get repeat business and build brand loyalty. Magentogives you total control and flexibility over creating and revising goodies like rewardsprograms, custom coupons and automated emails to keep your customers coming backagain and again.

    Custom Coupons

    Create coupons codes for social media,email, or print campaigns. You canincorporate coupon codes into any

    design you like.

    Newsletters

    Stay in touch with current customerswhove opted to receive newsletters. Youcan create as many newsletter templatesas you want.

  • Chapter 4: Quick Tour Customer Journey

    39Magento Community Edition: User Guide

    Loyalty & AdvocacyGive customers a direct connection to your brand by allowing them to create customeraccounts where they can see their purchase history, wishlist, and newslettersubscriptions. Use product ratings and reviews to give new customers objective productopinions and promote a sense of community. These features turn customer satisfactioninto one of the most powerful and cost-efficient marketing tools at your disposal.

    Dashboard Snapshots

    Knowing whats of interest on your site is crucial to maximize your marketing budget.Use this information to determine what you should cross- and up-sell to loyalcustomers, or which products to put on sale.

    Customer Accounts

    Opening as account provides customers with a personalized shopping experience thatthey can share with their friends. Customers can save their shopping preferences, andmanage their own store billing and shipping information.

    Advocacy Tools

    Customers who share their wishlists with family and friends make a powerfulendorsement of your brand. Customers create these personalized lists from products theychoose. When shared by email or RSS feed, these simple lists become powerful advocacytools.

    Reviews & Ratings

    Product reviews give your customers a way to engage with your brand while fostering asense of community. You can curate your reviews with tools to help you edit andapprove comments for inappropriate content before they go live.

  • Customer Journey Chapter 4: Quick Tour

    40 Magento Community Edition: User Guide

    Success!Opening your Magento store for business requires the following areas of consideration.While there are virtually any number of customizations you can make to the storefrontand Admin, you can use each link in this is list as a place to start.

    Implementation

    If you need help setting up your store,you can choose from our vast networkof Magento Solutions Partners.

    Design

    You can design your own home page orwork with an experienced Magento

    designer or Solutions Partner to customizeyour site.

    Product Catalog

    Configure products, create categories,import existing product catalogs, andleverage APIs or third-party datamanagement solutions.

    http://magento.com/partners/overview

  • Chapter 4: Quick Tour Customer Journey

    41Magento Community Edition: User Guide

    Payment Methods

    Magento supports a wide variety ofpayment methods, services, and gateways

    that you can offer for your customersconvenience.

    Shipping Methods

    Magento shipping methods are easy toset up and give you the ability toconnect with carriers who can shipyour products all over the world.

    Taxes

    Manage your taxes with our native tools,or add third-party extensions from

    Magento Connect.

    Thanks for your order!

    Magento can help you buildrelationships with your customers, tobring them back to your store, againand again.

  • 42 Magento Community Edition: User Guide

    Customer Journey Chapter 4: Quick Tour

    Notes________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

    ________________________________________________________________

  • Basic Configuration

  • 45Magento Community Edition: User Guide

    Chapter 5:

    Store AdminYour store Admin is the password-protected back office where you can set upproducts, promotions, manage orders, and perform other administrative tasks. Thischapter provides a high-level overview of the management tasks that you canperform while running your store on a day-to-day basis.

    Store Admin

  • Admin Login Chapter 5: Store Admin

    46 Magento Community Edition: User Guide

    Admin LoginAll of the basic configuration tasks are performed in the Magento Admin Panel, which isreferred to in this guide as your store Admin.

    Admin Login

    To log in to your store Admin:

    1. For a new Magento installation, do the following:

    a. On the last page of the Magento Installation Wizard, click the Go to Backendbutton.

    b. In the address bar of your browser, enter the URL that you specified in the MagentoInstallation Wizard, followed by the base URLof your stores Admin. Most AdminURLs looks like this:

    http://www.mystore.com/admin

    You can bookmark the Admin Login page for easy access.

    2. Enter the User Name and Password that was specified during the Magento installation.

    3. Click the Login button.

    Message InBoxYour store has an inbox for the messages received from Magento. The messages are ratedby importance, and might refer to updates, patches, new releases, scheduledmaintenance, upcoming events, and more. Any message that is considered to be ofmajor importance appears in a pop-up window when you log into your store. You canmanage your message inbox much as you would manage your email. Check it often tostay up-to-date on the latest information from Magento!

  • Chapter 5: Store Admin Message InBox

    47Magento Community Edition: User Guide

    Incoming Message

    To manage incoming messages:

    1. When the Incoming Messages box appears, do one of the following:

    l Click the Read Details link for more information.

    l Click the Close box to remove the popup and continue.

    A Latest Message notice also appears to the left, just below the header of your store. Aswith the popup box, you can click the Read Details link for more information.

    Message Notifications Below Header

    2. To read your messages, click Go to messages inbox.

    The messages in your inbox are marked by severity listed with the most recent at thetop.

  • Message InBox Chapter 5: Store Admin

    48 Magento Community Edition: User Guide

    3. After reading a message, you can apply any of the following actions to the message:

    l For more information, click the Read Details link.

    l To keep the message, click theMark As Read link.

    l To delete the message from your inbox, click the Remove link.

    Messages Inbox

    To apply an action to multiple messages:

    1. On the Admin menu, select System > Notifications.

    2. In your message inbox, do one of the following:

    l Select the checkbox at the beginning of each message you want to manage.

    l Click one of the group selection options above the list to select multiple messages.

    3. When the messages that you want to manage are selected, set Actions to one of thefollowing:

    l Mark as Read

    l Remove

    4. Click the Submit button to complete the process.

  • Chapter 5: Store Admin Message InBox

    49Magento Community Edition: User Guide

    Messages Inbox

    Message ImportanceSeverity Color Description

    Critical Red Indicates an important, time-sensitive message.

    Major Orange The default message severity level.

    Notice Green Indicates that a routine operation has taken place.

  • Dashboard Chapter 5: Store Admin

    50 Magento Community Edition: User Guide

    DashboardThe Dashboard is the first page that appears when you log in to the Admin. Its a hub ofimportant information about the health of your eCommerce site, and includes snapshotreports of Lifetime Sales, Average Orders, Top Search Terms, Bestsellers, Most ViewedItems, and more.

    Dashboard

  • Chapter 5: Store Admin Admin Menu

    51Magento Community Edition: User Guide

    Admin MenuAll of the tools you need to manage the operation and maintenance of your store areavailable in the Admin menu.

    Dashboard

    The Dashboard gives you a quick overviewof the sales and customer activity in yourstore. It is usually the first page thatappears when you log in to the Admin.

    Sales

    The Sales menu is where you can findeverything related to processing anorder, including current and pastorders, invoices, shipments, credit

    memos, terms and conditions,andtaxes.

    Catalog

    The Catalog menu controls everythingrelated to your product catalog, includingproducts, categories, attributes, URLrewrites, search terms and indexing,product reviews, tags, and GoogleSitemap.

  • Admin Menu Chapter 5: Store Admin

    52 Magento Community Edition: User Guide

    Mobile

    The Mobile menu is where you canconfigure the templates, content, andapps for various mobile devices and

    store views.

    Customers

    The Customers menu is where you canmanage customer accounts, and customergroups. You can even see which customersare online at the moment.

    Promotions

    The Promotions menu is where you setup catalog and shopping cart price

    rules and coupons. Price rules triggeractions when a set of specific

    conditions is met.

    Newsletter

    The Newsletter menu contains the toolsyou need to publish newsletters andmanage your list of subscribers.

  • Chapter 5: Store Admin Admin Menu

    53Magento Community Edition: User Guide

    CMS

    The CMS menu is where you createand manage content for your store. In

    addition to content pages, you cancreate static blocks, widgets, and

    polls.

    Reports

    The Reports menu provides a broadselection of reports that give you insightinto every aspect of your store, includingsales, shopping cart, products, customers,tags, reviews, and search terms.

    System

    The System menu includes tools toconfigure and maintain every aspect ofyour store. In addition, you can installextensions and manage Web Services

    for integration with other applications.

  • Admin Tools Chapter 5: Store Admin

    54 Magento Community Edition: User Guide

    Admin ToolsThe Admin includes many lists of data for products, orders, customers, search terms,pages, blocks, and so on. Each list has the same set of tools for finding records,pagination, sorting, filtering, selecting, and applying actions to records.

    Global Search

    The Global Search box can be used to find any value in the database, including product,customer, and order records.

    Sorting

    The header of each column can be used to sort the list in ascending or descending order.

    Filters

    The filters in the header of each column can be used to limit the list to specific values.Some filters have additional options that can be selected from a list box, and for others,you can simply type the value you want to find.

    Pagination

    The pagination controls are used to view the additional pages of results.

    Selection

    The Selection controls above the column headers have links to Select All, Unselect All,Select Visible, and Unselect Visible

    Actions

    The Action control applies an operation to any record with a checkmark in the firstcolumn.

  • Chapter 5: Store Admin Admin Tools

    55Magento Community Edition: User Guide

    Global Record SearchThe global search box is located in the Admin header, and can be used to find any recordin the database. The results can include customers, products, orders, or any relatedattribute.

    Global Record Search

    To do a global search:

    1. Type the first few letters of what you are looking for into the global search box.

    2. In the list of closely matching items, click the one that you want to find.

  • Admin Tools Chapter 5: Store Admin

    56 Magento Community Edition: User Guide

    List ControlsMany pages in the Admin include a list of records displayed in a grid, with controls atthe top of each column. The controls can be used to sort the list in ascending, ordescending order based on the values in the column. In addition, you can filter the listbased on a value in each column.

    Sort Controls

    To sort the list:

    1. In the upper-left corner, set Choose the Store View to the define the scope of the data tobe retrieved.

    2. Click the column name of any header. The arrow indicates the current order as eitherascending or descending.

    3. Use the pagination controls to view additional pages in the collection.

    To set the pagination controls:

    1. Set View to the number of records that you want to view per page.

    2. In the Page box, enter the page number you want to view, or click the arrow button toadvance to the next or previous, page.

  • Chapter 5: Store Admin Admin Tools

    57Magento Community Edition: User Guide

    Pagination Controls

    To filter the list:

    1. In the box below the column header, either enter or select the value you want to find.

    2. Click the Search button.

    Filter Controls

  • Admin Tools Chapter 5: Store Admin

    58 Magento Community Edition: User Guide

    Actions ControlWhen working with lists of data, you can use the Actions control to apply an operationto a single record, or to multiple records. The Actions control lists the operations thatcan be applied to the selected records. When working with the Manage Products list, youcan use the Actions control to update the attributes of the group of selected products,change their status from Disabled to Enabled, or delete them from the database.

    The selection of available actions varies by list, and additional options may appear,depending on the action selected. For example, when changing the status of a group ofrecords, a Status box appears next to the Actions control with additional options.

    Applying an Action to Selected Records

    Selecting Records

    The checkbox in the first column identifies each record that is a target for the action. Thesearch filters can be used to narrow the list to the records you want to target for theaction. The selection links above the list to the left can be used to apply a checkbox stateto groups of records. Options include:

    l Select All / Unselect All

    l Select Visible / Unselect Visible

    Checkbox States

    You can also use the search filter at the top of the column to list any (or all) records, oronly those with a selected or unselected checkbox.. The checkbox search filter settingsinclude:

    Any Lists all records, regardless of checkbox status.

    Yes Lists only records with the checkbox selected.

    No Lists only records without the checkbox selected.

  • Chapter 5: Store Admin Admin Tools

    59Magento Community Edition: User Guide

    When using the Actions control to update attribute settings, you can make as manychanges as necessary, and then update the records in a single step. Its much moreefficient than changing settings individually for each product record.

    To apply an action to selected records:

    1. In the list, select the checkbox of each record that is targeted for the action.

    2. Set the Actions control to the operation you want to apply.

    3. Click the Submit button.

    To update attributes:

    1. In the list, select the checkbox of each record to be updated.

    2. Set the Actions control to Update Attributes, and click the Submit button.

    The Update Attributes page lists all the available attributes, which are organized bygroup in the Product Information panel on the left.

    Update Attributes

    3. Select the Change checkbox next to each attribute, and make the necessary changes.

    4. Click the Save button to update the attributes for the group of selected records.

    Actions by ListList Actions

    Sales

  • Admin Tools Chapter 5: Store Admin

    60 Magento Community Edition: User Guide

    List Actions

    Orders Cancel

    Hold

    UnholdPrint InvoicesPrint PackingslipsPrint Credit MemosPrint AllPrint Shipping Labels

    Invoices PDF Invoices

    Shipments PDF Packing SlipsPrint Shipping Labels

    Credit Memos PDF Credit Memos

    Search Terms Delete

    Catalog

    Manage Products DeleteChange StatusUpdate Attributes

    Search Terms Delete

    Manage Tags DeleteChange Status

    Reviews (All / Pending) DeleteUpdate Status

    Tags (All / Pending) DeleteChange Status

    Mobile

    Message Queue DeleteCancel

    Customers

    Manage Customers DeleteSubscribe to NewsletterUnsubscribe from NewsletterAssign a Customer Group

    Newsletter

    Newsletter Subscribers UnsubscribeDelete

  • 61Magento Community Edition: User Guide

    Chapter 6:

    Multiple Sites, Stores & ViewsWhen Magento Community Edition is installed, a main website, a store, and threestore views are created. You can create additional websites, stores, and store views,according to your needs. For example, in addition to your main website, you mighthave a additional websites with separate domains. Within each website, you canhave multiple stores, and within each store, separate views.

    Websites

    Suppose you want to sell machine shop equipment online, and your spouse wants tosell handmade baskets. It is unlikely that you would sell both of these product linesin a single store. However, in a single Magento installation, you can do both bysetting up separate websites. Each website can have its own domain name. Thewebsites can be set up to share customer data, or to have entirely separate sets ofcustomer data.

    Stores

    For your handmade baskets website, you might want to set up two stores, onespecializing in wicker and one for other materials. You can set up two root categories(one for wicker items and one for other items) and assign one to each store. Severalstores of one website can have different independent domain names as well, but itshould be configured on the store view level of each store.

    Store Views

    Your market research indicates that about half of your potential customer basespeaks English, and the other half speaks Spanish. Within each store, you can createa separate store view for each language. The store views share the same catalog, buteach is presented in its respective language. Customers can switch from one storeview to another using the language chooser in the header of the store.

    Setting Up Store HierarchyBefore you begin, carefully plan your store hierarchy in advance because it is referredto throughout the configuration. Each store can have a separate root category, whichmakes it possible to have an entirely different set of navigation for each store.

  • Setting Up Store Hierarchy Chapter 6: Multiple Sites, Stores & Views

    To have a separate domain for each website, you must modify the configuration files onthe server. To learn more, see: Tutorial: Multi-Site, Multi-Domain Setup.

    Manage Stores

    To set up a new website:

    1. On the Admin menu, select System > Manage Stores.

    2. From Manage Stores, click the Create Website button. Then, do the following:

    Website Information

    a. Enter the Name of the website. The name is for internal reference, and can refer tothe domain of the site or anything else distinguish it from other sites in thehierarchy.

    b. Enter a Code that will be used on the server to point to the domain. The code mustbegin with a lower-case letter, and can include any combination of letters (a-z),numbers (0-9), and the hyphen (-) character.

    c. (Optional) Enter a Sort Order number to determine the sequence in which this siteis listed with other sites. Enter a zero to make this site appear at the top of the list.

    3. When complete, click the Save Website button.

    To set up a new store:

    1. Before you begin, set up the root category that will be used for this store.

    2. On the Admin menu, select System > Manage Stores.

    3. From Manage Stores, click the Create Store button. Then, do the following:

    62 Magento Community Edition: User Guide

    http://www.magentocommerce.com/knowledge-base/entry/tutorial-multi-site-multi-domain-setup

  • Chapter 6: Multiple Sites, Stores & Views Setting Up Store Hierarchy

    63Magento Community Edition: User Guide

    New Store

    a. Set Website to the site that is the parent of this store.

    b. Enter a Name for the store. The name is for internal reference to distinguish it fromother stores in the hierarchy. For example: Private Sales Store.

    c. Set Root Category to the root category that will be used for the main navigation ofthe store. The root category can be the same as used for other stores, or unique tothis store. For example: Private Sales Root.

    4. When complete, click Save Store.

    To set up a new store view:

    1. On the Admin menu, select System > Manage Stores.

    2. From Manage Stores, click the Create Store View button. Then, do the following:

    Store View Information

    a. Set Store to the parent store of this view.

    b. Enter a Name for this store view. The name appears in the language chooser in theheader of the store. For example: French.

    c. Enter a Code in lowercase characters to identify the view. For example:privatesales.fr.

    d. To activate the view, set Status to Enabled.

    e. (Optional) Enter a Sort Order number to determine the sequence in which this viewis listed with other views.

    3. When complete, click the Save Store View button.

  • Configuration Scope Chapter 6: Multiple Sites, Stores & Views

    Configuration ScopeIf your Magento installation has multiple websites, stores, or views, you can set thescope of a configuration parameter to apply to a specific part of your installation. TheCurrent Configuration Scope box in the upper-left corner of the Admin workspacedetermines the scope of the current settings. By default, the configuration scope is set toDefault Config. For Admin users with restricted access, the list includes only the areaswhere the user is granted permission to access.

    The configuration scope applies to products categories, attributes, customermanagement setting, and so on. The scope of each item appears in brackets after thefield to indicate the range of the setting.

    Current Configuration Scope

    If your installation includes multiple websites, stores or views, you should always setthe scope to identify where you want the settings to apply. The possible settings are:[STORE], [WEBSITE], and [GLOBAL].

    Any item with the scope of [STORE] can be set differently for each view. For example,because the scope of a product name and description is [STORE], the fields can have adifferent value for each language. However, some configuration settingssuch as postalcodeare [GLOBAL] because the same setting applies throughout the system. The[WEBSITE] scope also applies to the entire site, including all views.

    To set the configuration scope:

    Before making a configuration setting that applies only to a specific website, store, orview, do the following:

    1. On the Admin menu, select System > Configuration.

    2. In the panel on the left, select the page with the configuration settings you want tochange. If necessary, click to expand the section to be configured. Then, do the following:

    64 Magento Community Edition: User Guide

  • Chapter 6: Multiple Sites, Stores & Views Configuration Scope

    65Magento Community Edition: User Guide

    a. In the upper-left corner of a configuration page, set Current Configuration Scope tothe website, store, or view where the configuration applies.

    A checkbox appears after each field, and sometimes additional fields becomeavailable.

    b. Clear the Use Default checkbox that is after the field that you want to edit. Then,enter the new value.

    c. Repeat this process for every field that needs to be updated on the page.

    3. When complete, click the Save Config button.

  • Configuration Scope Chapter 6: Multiple Sites, Stores & Views

    Scope SettingsScope Description

    Store The setting is limited to the store view, which is often used todisplay a store in multiple languages.

    Website The setting is limited to the website.

    Global The setting applies to the entire installation.

    66 Magento Community Edition: User Guide

  • 67Magento Community Edition: User Guide

    Chapter 7:

    Store InformationThe basic information for your store includes the store name and address, telephonenumber and email address, that appear on email messages, invoices, and othercommunications sent to your customers. In this chapter, you will configure thefollowing information:

    l Store Locale

    l Countries Options

    l State Options

    l Shipping Settings

    l Store Email Addresses

    l Contact Us

  • Locale Options Chapter 7: Store Information

    68 Magento Community Edition: User Guide

    Locale OptionsThe locale determines the language, country, tax rate, and other settings usedthroughout a store. The Locale Options configure the time zone and language of eachstore, and identify the days of your work week in the area.

    Locale Options

    To set the store locale:

    1. On the Admin menu, select System > Configuration.

    2. Click to expand the Locale Options section.

    3. Select your Timezone from the list. Then, do the following:

    a. Set Locale to the store language.

    b. Set First Day of the Week to the day that is considered to be the first day of theweek in your area.

    c. In theWeekend Days list, select the days which fall on a weekend in your area. (Toselect multiple options, hold down the Ctrl (PC) or Command (Mac) key.)

    4. When complete, click the Save Config button.

    Field DescriptionsField Scope Description

    Timezone Website Identifies the time zone of the primary marketserved by the store. Usually the timezone is thesame as that used in the physical location ofyour business.

    Locale Store View Identifies the language, currency, and system ofmeasurement used in the market served.

    First Day of Week Store View Identifies the day that is considered to be thefirst day of the week in the market served.

    Weekend Days Store View Identifies the days that fall on the weekend inthe market served.

  • Chapter 7: Store Information States Options

    69Magento Community Edition: User Guide

    States OptionsIn many countries, the state, province, or region is a required part of a postal address.The information is used for shipping and billing information, to calculate tax rates, andso on. For countries where it is not required, the field can be omitted entirely from theaddress, or included as an optional field.

    Because standard address formats vary from one country to another, you can also editthe address template that determines how the information appears on invoices, packingslips, and shipping labels.

    States Options

    To set up the state options:

    1. On the Admin menu, select System > Configuration.

    2. Click to expand the States Options section, and do the following:

    3. In the State is required for list, select each country where you want State / Province tobe a required entry. To select multiple options, hold down the Ctrl (PC) or Command(Mac) key.

    4. Set Display not required State to one of the following:

    Yes In countries where the state field is not required, the field is included inthe form as an optional entry.

    No In countries where the state field is not required, the field is omitted fromthe form.

    5. When complete, click the Save Config button.

    Field DescriptionsField Scope Description

    State is required for Global Identifies the countries where you conduct busi-ness that do not require a state or province tobe included in a postal address.

  • Countries Options Chapter 7: Store Information

    70 Magento Community Edition: User Guide

    Field Scope Description

    Display not requiredState

    Global For countries where it is not required, determ-ines if the State/Province field is included in thepostal address of the customer. Optionsinclude:

    Yes Includes the State/Province field in thecustomer address, even if not requiredby the country.

    No Omits the State/Province field from thecustomer address if not required bythe country.

    Countries OptionsThe Countries Options establish the country where your business is located, and thecountries from which you accept payment.

    Countries Options

    To set the country options for your store:

    1. From the Admin menu, select System > Configuration.

    2. Click to expand the Countries Options section. Then, do the following:

    a. Set Default Country to the country where your business is located.

    b. In the Allow Countries list, select each country from which you accept orders. Bydefault, all countries in the list are selected. To select multiple countries, hold downthe Ctrl (PC) or Command (Mac) key.

  • Chapter 7: Store Information Currency Setup

    71Magento Community Edition: User Guide

    c. In the Postal Code is Optional list, select each country where you conduct businessthat does not require a ZIP or postal code to be included as part of the streetaddress.

    d. In the European Union Countries list, select each country in the EU where youconduct business. By default, all EU countries are selected.

    3. When complete, click the Save Config button.

    Field DescriptionsField Scope Description

    Default Country Store View Identifies the country where your store islocated.

    Allow Countries Store View Identifies each country from which you acceptorders.

    Postal Code is Optionalfor the following coun-tries

    Global Identifies the countries that do not require a ZIPor postal code in the shipping address.

    European Union Coun-tries

    Global Identifies the countries that are members of theEuropean Union.

    Currency SetupMagento Community Edition gives you the ability to accept currencies that are used inmore than two hundred countries around the world. In addition to choosing thecurrencies that you accept, you can also manage currency rates for the store. If youaccept payment in multiple currencies, make sure to monitor the currency rate settings,because any fluctuation can affect your profit margin. Currency rates can be setmanually, or imported into the store. Currency symbols are used throughout the store,and appear in product prices and sales documents such as orders and invoices.

    Before you can set currency rates, you must first specify the currencies that you accept,and which currency is used to display prices in your store. You can customize thecurrency symbols as needed, and also set the price display separately for each store orview.

    Currency Options

  • Currency Setup Chapter 7: Store Information

    72 Magento Community Edition: User Guide

    To set up currency for your store:

    1. On the Admin menu, select System > Configuration.

    2. In the Configuration panel on the left, under General, select Currency Setup.

    3. Click to expand the Currency Options section, and do the following:

    a. Set Base Currency to the primary currency that you use for online transactions.

    b. Set Default Display Currency to the currency that you use to display pricing in yourstore.

    c. In the Allowed Currencies list, select all currencies that you accept as payment inyour store. (To select multiple currencies, hold down the Ctrl key and click eachoption.)

    4. When complete, click the Save Config button.

    Field DescriptionsField Scope Description

    Base Currency Website The primary currency used in store transactions.

    Default Display Currency Store View The primary currency used to display prices.

    Allowed Currencies Store View The currencies accepted by your store forpayment.

  • Chapter 7: Store Information Shipping Settings

    73Magento Community Edition: User Guide

    Shipping SettingsThe Shipping Settings establish the point of origin for all shipments made from yourstore or warehouse, and also your preference for managing orders that are shipped tomu