i

Magento reserves the right to make corrections, modifications, enhancements, improvements, and other changes to its products and services at any time and to discontinue any product or service without notice. Customers should obtain the latest relevant information before placing orders and should verify that such information is current and complete. All products are sold subject to Magento's terms and conditions of sale supplied at the time of order acknowledgment. Magento warrants performance of its products to the specifications applicable at the time of sale in accordance with Magento's standard warranty. Testing and other quality control techniques are used to the extent Magento deems necessary to support this warranty. Except where mandated by government requirements, testing of all parameters of each product is not necessarily performed. Magento assumes no liability for applications assistance or customer product design. Customers are responsible for their products and applications using Magento components. To minimize the risks associated with customer products and applications, customers should provide adequate design and operating safeguards. Magento does not warrant or represent that any license, either express or implied, is granted under any Magento patent right, copyright, mask work right, or other Magento intellectual property rights relating to any combination, machine, or process in which Magento products or services are used. Information published by Magento regarding third-party products or services does not constitute a license from Magento to use such products or services or a warranty or endorsement thereof. Use of such information may require a license from a third party under the patents or other intellectual property of the third party, or a license from Magento under the patents or other intellectual property of Magento. Resale of Magento products or services with statements different from or beyond the parameters stated by Magento for that product or service voids all express and any implied warranties for the associated Magento product or service and is an unfair and deceptive business practice. Magento is not responsible or liable for any such statements. All company and brand products and service names are trademarks or registered trademarks of their respective holders. Magento is a trademark of Magento, Inc. Copyright 2010 Magento, Inc.

ii

CONTENTS
CONTENTS ABOUT THIS MANUAL PART I SITE MANAGEMENT FEATURES 1 CONTROLLING WEBSITE ACCESS 1.1 LIMITING ADMINISTRATOR ACCESS TO THE ADMIN PANEL (BACKEND) 1.2 LIMITING VISITOR/CUSTOMER ACCESS TO THE WEBSITE (FRONTEND) DESIGN & CONTENT ENHANCEMENTS 2.1 CONTENT STAGING 2.2 CHANGING THE FAVICON PERFORMANCE ENHANCEMENTS 3.1 FULL-PAGE CACHING SECURITY ENHANCEMENTS 4.1 ENCRYPTION AND HASHING 4.2 CHANGING THE DATABASE KEY 4.3 LOGGING ADMINISTRATOR ACTIONS 4.4 SETTING ADMINISTRATOR PASSWORD SECURITY LEVELS [EE] III
V

1 1 1 2 7 7 13 14 14 18 18 18 19 20 21 [EE] 21 21 23 24 26 27 29 29 33 36 36 39 [EE] 39 39
iii

[EE] [EEV1.9] [EE]

[PE][EE]

PART II CATALOG AND CONTENT MANAGEMENT FEATURES 5 ENHANCED CONTENT MANAGEMENT SYSTEM (CMS+) 5.1 WIDGETS 5.2 BANNERS 5.3 VERSIONING 5.4 HIERARCHY 5.5 WYSIWYG CATALOG SEARCH ENHANCEMENTS 6.1 CATALOG SEARCH WITH SOLR 6.2 RELATED-TERMS SEARCH RECOMMENDATIONS INVENTORY CONTROL ENHANCEMENTS 7.1 QUANTITY INCREMENTS & ONLY X LEFT

[EEV1.8+] [EEV1.9] [EEV1.8+]

PART III MARKETING AND PROMOTION FEATURES 8 RICH MERCHANDIZING SUITE (RMS) 8.1 TARGETED MARKETING USING CUSTOMER SEGMENTS

Contents

8.2 CREATING DYNAMIC PRODUCT RELATIONSHIPS 8.3 AUTOMATICALLY SENDING REMINDER EMAILS TO CUSTOMERS 9 GIFT CARDS 9.1 CONFIGURING GIFT CARDS 9.2 GIFT CARD ACCOUNTS 9.3 GIFT CARD PRODUCTS

[EE V1.8+] [PE][EE]

41 42 46 46 48 49 52 52 55 57 57 60 62 62 63 64 71 75

10 REWARD POINTS AND LOYALTY PROGRAMS 10.1 CONFIGURING REWARD POINTS 10.2 AWARDING AND REDEEMING REWARD POINTS 11 PRIVATE SALES 11.1 INVITATIONS 11.2 EVENTS 11.3 CATEGORY PERMISSIONS 11.4 WEBSITE RESTRICTIONS 12 GIFT REGISTRIES 12.1 ADMINISTERING GIFT REGISTRIES 12.2 MANAGING GIFT REGISTRIES PART IV CUSTOMER AND ORDER MANAGEMENT FEATURES 13 STORE CREDIT 13.1 CONFIGURATION OF STORE CREDIT 13.2 MANAGING STORE CREDIT 14 ASSISTED SHOPPING 15 ORDER ARCHIVING 16 CUSTOMER & ADDRESS ATTRIBUTES APPENDICES A B SYSTEM REQUIREMENTS INSTALLING AND UPGRADING ENTERPRISE EDITION B-1 INSTALLING ENTERPRISE EDITION B-2 UPGRADING ENTERPRISE

[PE][EE]

[EE]

[EE V1.9]

[PE][EE]

75 75 75 78 79 80 85 85 87 87 88

[EE V1.8+] [EE V1.8+] [EE V1.9+]

iv

About This Manual

About This Manual

This manual is intended as a supplement or follow-on to the Magento User Guide. The Magento User Guide provides a comprehensive view of the basic Magento features and how to get started setting up and managing a store and a catalog in Magento. This documentthe Magento Enterprise & Professional User Guidebuilds on the Magento User Guide and documents the features that are exclusive to the Magento Enterprise and Professional Editions.

Document at a Glance
Both the Magento Enterprise and Professional Editions contain all of the capabilities of the Community Edition. Magento Professional Edition contains a subset of some of the most popular features available in Magento Enterprise Edition. The table below lists the major features and enhancements that are available to Magento Enterprise and Professional customers and where theyre covered in this document. Please see the release notes for the full set of additional improvements, changes and bug fixes for your specific release version. Table 1. Enterprise Edition (EE) and Professional Edition (PE) Features Covered in this User Guide.
Functional Area Site management Key Features Strong data encryption Customer access restriction (by customer group and category) Admin access restriction (to specific stores & data) Administrator action logging Content staging and merging Enhanced caching & full-page caching Favicon management Catalog & content management CMS+ (Enhanced Content Management) Enhanced inventory features Related terms search recommendations Product search using Solr Marketing & promotion Rich Merchandising Suite Automated email reminders Gift Certificates/Cards (Physical & Ch 9 PE Ch 4 EE Ch 4 Ch 1 Ch 1 Ch 4 Ch 2 Ch 3 (v1.7+) Ch 2 (v1.9+) Ch 5 (v1.7+) Ch 7 (v1.8+) Ch 6 (v1.9+) Ch 6 (v1.8+) Ch 8 (v1.7+) Ch 8 (v1.8+) Ch 9

About This Manual

Virtual) Reward Points System Gift Registries Private (club) Sales Customer & order management Customer Store Credits Assisted shopping Order archiving Custom customer & address attribute management Accounting & ERP package integration BridgeConnect Module (separately downloadableSee Bridge Connect User Guide) Ch 12 Ch 10 Ch 10 (v1.7+) Ch 12 (v1.9+) Ch 11 Ch 13 Ch 14 (v1.8+) Ch 15 (v1.8+) Ch 16 (v1.9+)

Conventions Used in this Document

Throughout this document the following notation is used to clarify the edition/version of the software in which a feature is available:

[PE] [EE] [EEV1.8+] [EEV1.9+]

Feature/functionality is available in Magento Professional Edition Feature/functionality is available in Magento Enterprise Edition Feature/functionality is available in Magento Professional Edition v1.8 or later Feature/functionality is available in Magento Professional Edition v1.9 or later

Current Document Scope (published July 2010)

Magento Enterprise Edition v1.9.0.0 Magento Professional Edition v1.8.0.0

vi

PART I SITE MANAGEMENT FEATURES

Controlling Website Access

[EE]

This chapter introduces Magento Enterprise Editions functionality for restricting access to your websitesboth on the backend and the frontend. For your admin users, Enterprise Edition allows you to control what they can see in the Admin Panel. You can restrict which features/functions are available to an admin user as well as which websites or stores products and data they can see. For your customers, Enterprise Edition also allows you to easily control whether your frontend website is temporarily closed (for example, for maintenance) or whether your website is open to all visitors or to only logged in customers or customers in specific customer groups (for example, for private sales or B2B websites).

1.1 Limiting Administrator Access to the Admin Panel (Backend)

As with all versions of Magento you can create individual accounts for each user to whom you want to allow access to the backend Admin Panel. You can even create roles that define which Admin Panel functionality those admin users will have access to. Additionally, Magento Enterprise Edition allows you to further restrict that admin access to only a specific site or set of sites and their associated data. If you have multiple brands or business units with separate stores all on the same Magento installation, this allows you to provide admin access to each of your business units but to still hide and protect their data from one another. To limit which websites or stores admin users can see when they log in to the Admin Panel, youll create a role with a limited scope and resources. Once you have created a restricted role, you can assign that to a specific admin user account. Admin user assigned to a restricted role will only be able to see and change data for websites or stores associated with that role. They will also be unable to change global settings or data. If an admin users access is restricted to a specific set of websites and/or stores, the websites and stores for which they are not authorized will not be shown in the scope dropdowns or they will be displayed as inactive. Only the sales and other data for allowed websites and stores will be shown.

Part ISite Management Features

To limit admin role access to specific websites or stores:

1. Choose SystemPermissionsRoles. 2. Click on the [+Add New Role] button to create a new role. 3. In the Role Info tab, enter the following information:
Role Name(required) Give the role a descriptive name to help you remember its
scope and purpose.

4. Select the Role Resources tab in the left column.

In the Role Scopes panel, set the following values:
o Change the Role Scopes dropdown to Custom. o Check/click the websites and/or stores that you want users with that role to have access to from the resulting list.

In the Role Resources panel, set the following values:

o Change the Resource Access dropdown to Custom. o Check/click the menus and features that you want users with that role to have access to in the resulting list. Important Note: Be sure to disable access to at least the Permissions tool here in the Roles Resources section if you are limiting website/store access for a given role. Otherwise, users with this role will be able to modify their own restrictions. o If desired, select the Role Users tab and assign existing Admin user accounts to this new role.

5. Click the [ Save Role] button to save your new role.

After creating a restricted role, you can create new admin users at any time (SystemPermissions Users) and assign your new restricted role to the admin users whose access you wish to limit.

1.2 Limiting Visitor/Customer Access to the Website (Frontend)

Another Enterprise Edition concept, called website restrictions, provides you with the ability to either shut down access to your site completely (for example, if its closed for maintenance) or to restrict access to only logged in customers (for example, for B2B websites or for private sales).

Chapter 1Controlling Website Access

Restricting customer access from an entire website

If you wish to temporarily close your website, you can do so easily in Enterprise Edition by setting the website restrictions to website closed. This will temporarily redirect site visitors to any URL under Magento control to a single landing page of your choice.

To restrict access to an entire website:

1. Choose SystemConfiguration. Select the General tab on the left. 2. In the Website Restrictions panel, you can set the following values:
Access RestrictionDetermines whether the website restriction features are
enabled. If Yes, frontend website access is restricted in the manner set in the fields below. If No, this feature in disabled and the following settings have no effect.

Restriction ModeThere are three possible modes.

o Website ClosedAll access to the frontend website is restricted and the website is essentially closed. All frontend URLs are temporarily redirected to the page specified as the Landing Page below. This setting can be useful during site maintenance or just prior to launch. o Private Sales: Login OnlyUsers can only access the frontend website if they first log in. All frontend URLs are temporarily redirected to either the specified landing page or to the login form until the user logs in. Users cannot create a new account themselves when the site is in this mode. o Private Sales: Login and RegisterUsers can only access the frontend website if they first log in. All frontend URLs are temporarily redirected to the login form until the user logs in. Users can create a new account themselves when the site is in this mode.

Startup PageDetermines whether the site displays the login form or a landing page
until a user logs in. This setting is only applicable in Private Sales mode (if the previous setting is either Private Sales: Login Only, or Private Sales: Login and Register), because the Website Closed option prohibits users from logging in altogether. o To login formUsers are redirected to the log in form until they log in. o To landing pageUsers are redirected to the static page specified below until they log in. Important note: Be sure to include a link to the login page from the specified landing page so that customers can log in to access the full site.

Landing PageSpecifies the landing page users see either when the website is closed
or when you have chosen to startup from a landing page in Private Sales mode.

HTTP responseSpecify the HTTP response sent out when your website is closed
and a connection is attempted by bots, crawlers, or spiders. o 503 Service unavailable means that the page is not available, and the index will not be updated.

Part ISite Management Features

o 200 OK means the landing page returned is the correct page, and the spider might assume the landing page is the only page on the site.

3. Click the [ Save Config] button to save your settings.

 The Private Sales website restriction settings can be also used for B2B websites.
Customers can be created in the backend and required to log in in order to view the site.

Restricting customer access on a category-by-category basis

In order allow specific customer groups to see only certain categories of your website, you first need to enable this ability in the Admin Panel. You can set default values that apply to all categories in your entire store. You can also override these settings for individual categories.

To configure default access permissions and landing pages

1. Choose SystemConfiguration. Select the Catalog tab on the left. 2. In the Category Permissions panel, you can set the following values:
EnableDetermines whether or not category access can be restricted.
o Yes, frontend website access is restricted in the manner set in the fields below. A new tab (Category Permissions ) will appear at the category level in CatalogManage Categories so that you can override these settings on a category-by-category basis. o No, this feature in disabled and the following settings have no effect.

Allow Browsing CategoryDetermines whether category pages are visible and to

which customers. o Yes, to all in order to give this permission to all customer groups. o Yes, to specified customer groups in order to give this permission only to certain customer groups. o Customer Groups multiple select menu will appear listing all existing customer groups, from which you can select the group or groups to give this permission. o No, redirect to landing page in order to deny this permission to all customer groups. o Landing PageSelect the landing page that customers will be directed to if they do not have permission to browse categories. Customers will be redirected if you have selected either Yes, to specified customer groups or No, redirect to landing page above. They will also be redirected if you deny access to a customer group on the category level, which will be discussed further in the next section. This dropdown lists all landing pages that have been created in CMSManage Pages.

Chapter 1Controlling Website Access

Display Product PricesDetermines whether product prices are displayed on the

product listing pages and product info pages. o Yes, to all in order to give this permission to all customer groups. Select Yes, to specified customer groups in order to give this permission only to certain customer groups. o If this option is selected, a Customer Groups multiple select menu will appear listing all existing customer groups, from which you can select the group or groups to give this permission. Select No in order to deny this permission to all customer groups.

Allow Adding to CartDetermines whether customers are able to add products to

their carts from the product listing pages and product info pages. o Select Yes, to all in order to give this permission to all customer groups. o Select Yes, to specified customer groups in order to give this permission only to certain customer groups. If this option is selected, a Customer Groups multiple select menu will appear listing all existing customer groups, from which you can select the group or groups to give this permission. o Select No in order to deny this permission to all customer groups.

Disallow Catalog Search bySelect the customer group or groups from this multiple
select menu that will not be allowed to use the Quick Search bar in the header or the Advanced Search tool to search for products in your site.

3. Click the [ Save Config] button to save your settings.

To apply category permissions
The default category permissions that you set above can be overwritten on the category level. To do so, navigate to Catalog Manage Categories, select the desired category from the category tree in the left column, and select the Category Permissions tab. This tab will only exist if you have enabled this feature in the configuration settings described above. Here you have the ability to set permissions for each website and each customer group. First, click the New Permission button. Select the desired website and customer group from the corresponding dropdowns. If you want to apply this permission for all websites and/or customer groups, select All Websites or All Customer Groups, respectively. For each type of permission (browsing, product prices, and add to cart) you have the ability to Allow or Deny permission. Additionally, you can choose to use the permission of the parent category, Use parent. This setting is helpful if you have a child category or set of children categories which will always follow the permission settings of the parent. This way, you can change the permission settings of the parent category and have the changes automatically apply to the child or children categories.

Part ISite Management Features

Each permission (browsing, product prices, and add to cart) will apply to the product listing (category) page of the selected category, as well as the product view (product) page of products associated to the selected category. However, if a product is associated to another category, which has no viewing or selling restrictions, then none of the permissions will apply to the product view page. To remove a permission, click the red X button. When you have completed these settings, click the [Save Category] button in the top right of the page.

Chapter 2Design & Content Enhancements

Design & Content Enhancements

[EE]

This chapter introduces some of Enterprise Editions functionality to support working with your design and content. The biggest enhancement over our Community Edition functionality is the ability to create content staging websites that allow you to stage and preview content and design changes in your production environment without making those changes live. Some of primary uses of content staging include data entry, preparing seasonal layout and data changes, and building new CMS content.

Chapter Quick Reference

The table below lists some of the most common tasks using EEs design and content staging enhancements and where to go in the Admin Panel to perform them. The sections that follow provide step-by-step instructions on each. Table 2. Enterprise Edition Design and Content Tasks Quick Reference.
TASK To configure content staging To create a staging website To merge content from a staging website to a live site To rollback a content merge To change the favicon ADMIN MENU SystemConfigurationGeneral tab SystemContent StagingStaging Websites SystemContent StagingStaging Websites SystemContent StagingBackups SystemConfigurationDesign

2.1 Content Staging

In order to effectively use content staging, it is necessary to understand a little bit about how it works in Magento. Content staging websites are created as hidden or beta websites that can be accessed via a special, password-protected URL. They can have the same domain as the live store or on a separate domain, but they run on the same Magento installation and database as your live site. In the Admin Panel, staging websites are accessed and used in the same way as normal websites. You create, edit, and delete content and products in exactly the same way. Setting the Configuration Scope as you work determines which site youre working on a staging site or a live site.

Part ISite Management Features

Once your changes are done and approved you can merge the staging website with the live website and do not have to re-enter data or configuration changes. During merging, all the content assigned to the staging website will become assigned to the live website, and all attributes on the staging website/store view level will be copied to the matching live website/store view. All mapping and content selection details can be controlled by the administrator, so only the content and content types you want will be merged. Additionally, during merging, a rollback (backup) can be created.

Its important to keep in mind that these websites are content staging websites and are not staging websites for code or development work.

Setting up Content Staging Websites

To configure your content staging websites:
There are some configuration settings that must be completed relating to content staging.

1. Choose System Configuration. Select the General tab on the left. 2. In the Staging Websites panel, configure your staging websites:
Automatically create Entry Points for Staging WebsitesDetermines if the
entry points (index files) for beta sites are created automatically. If you plan to host your Staging Websites on a separate domain, select No.

Folder Name for Entry PointsEntry points, if created automatically, will be

created as subdirectories in this path. This folder must be writeable.

Close Website during Merge or RollbackDetermines if access will be

restricted to the live site while the merge or rollback is being performed. o If you select No, the site(s) can be accessed as usual. o Take down entire frontend means access to all sites will be restricted, and is the recommended option. o Take down only relevant websites means access will be restricted only to the site(s) involved in the merge or rollback activity.

Landing PageSelect the CMS page that will be shown if the site is closed
during a merge or rollback activity.

3. Click the [ Save Config] button to save your settings.

To create a new content staging website:
Magento Enterprise Edition allows you to create as many Staging Websites as required.

1. Choose SystemContent StagingStaging Websites.

This page contains a grid listing all existing Staging Websites.

Chapter 2Design & Content Enhancements

2. Click the [+ Add Staging Website] button. 3. Select one of existing websites as the base in the Source Website dropdown and
click the [Continue] button.

4. Configure the staging website with the following options:

Label Unique name assigned to the staging environment so that it is easily
recognizable.

Staging Website CodeUnique website code of the Staging Website. This

field will be pre-populated with and automatically generated code, although you have the ability to modify the value.

Staging Website NameName of the Staging Website. This field will be prepopulated with and automatically generated name, although you have the ability to modify the value.

Base URL and Secure Base URLBase address of the Staging Website. If the
website is to be hosted on a separate domain or in a non-default location, enter a new value.

Frontend RestrictionControls how the frontend of the Staging Website can

be accessed. The following options are available: o Not accessibleDisables access to the entire staging frontend. o AccessibleThe staging site is open and can be accessed by anyone that knows the URL. o Require HTTP AuthThe staging site will show a username and password prompt on access, which can be configured below.

HTTP Login and HTTP PasswordEnter the username and password used for
restricting frontend access when the Frontend Restriction dropdown above is set to Require HTTP Auth.

5. Select Original Website Content to be Copied to Staging WebsiteThis

section determines which items will be copied to the Staging Website from the source Website.

6. Select Original Website Store Views to be Copied to Staging WebsiteThis

Section determines which Store Views will be copied to the Staging Website from the source Website.

7. Click the [Create] button to save your settings. You will be redirected to the Staging
Websites grid. Now you can start editing content, assign it to the Staging Website, and change attributes on the Website or Store View level of the Staging Website.

Part ISite Management Features

You can also edit the staging environment by clicking on the desired Staging Website in the grid. While editing, you can change the Label and Frontend Restriction options. You can also view the Event History tab, listing all events (creation, merge, or rollback) that were done in this site.

 You can also create Staging Websites based on other Staging Websites.
This allows more people to work on different parts of the new content. The content can be merged to the beta Website, fully tested and reviewed, and finally merged to the production (live) Website.

Merging Content
After making all the necessary content changes on the Staging Website you can merge or schedule merging of the Staging Website to another Website.

To merge or schedule merging of a Website:

1. Navigate to SystemContent StagingStaging Websites. 2. Click on the staging website in the grid that you want to merge. 3. Click the [Merge] button to open the mapping configuration page. 4. In the top section, define the mapping of the Websites and Store Views. This
controls which Staging Website is merged to which live Website, and which staging Store View is merged to which live Store View.

Select the To Website, which is the target Website. The To website can be
either the Source Website, or another Website.

Click Add New Store View Map. Select the From and To Store Views. Each From Store View option can only be
selected once.

Repeat adding Store View maps for all Store Views that need to be merged.

5. Select the Create a backup checkbox if you want to create a backup of the live site
before merging.

6. In the Select Items to be merged section, check all items that you want to merge
from the staging to the live website.

7. Click Merge Now or enter a date and time and click Schedule Merge.
Note: In order for a scheduled merge to be applied, the Magento cron job has to be running on the server.

10

Chapter 2Design & Content Enhancements

You can only create one backup for each website per merge. Backups are created in the database and require significant database space. Backups are not updated when Magento is updated. If the table structure is changed during an update, there will be no way to restore the backup.

Rolling Back Merges

If you have selected the Create a backup checkbox during website merging, a backup of the target Website will be created just before the merge. This backup only contains the tables related to the content staging merge and is not a backup of the entire site.

To rollback website content:

1. Navigate to SystemContent StagingBackups. This page contains a grid

listing all existing backups.

2. Click on the backup in the grid that you want to roll back. You will be redirected to
the Website Backup Information page. This page has three tabs available in the left column:

Backup General InfoDisplays the basic backup information. Table Prefix is

the prefix used for backup tables of this website in the database.

Rollback HistoryDisplays events associated with this backup. RollbackContains the list of items which are available for rollback.

3. In the Rollback tab choose the items that you want to restore. You can only select
the items which are available.

4. Click the [Rollback] button. After the website is restored, you will be redirected to
the backup grid.

Items are available for rollback only if the table versions of the backup and original Website match. If they do not match, the rollback is not possible with Magento functionality. It can be carefully performed using manual database administration tools, however this is not recommended. The table version might change when an upgrade of the Magento system also changes the structure of some of the tables.

Rollback can be used either to restore content if an error is noticed after a merge, or to restore to a previous site version when the staging site is used for seasonal or temporary Website changes.

11

Part ISite Management Features

Working with a Content Staging Website

Content staging is a very powerful tool, but requires caution to use it effectively. An important thing to understand is that the Staging Website it is not a separate beta Website with a separate database. It is another Website in the store that is hidden. Thus, creating and deleting content, such as products, requires special attention.

To remove a product from a staging website:

You cannot and should not delete a product from a content staging website. Deletion of the product in staging will result in deletion from the live site as well. To remove a product from a content staging website, you should simply disable it in that website.

1. Navigate to CatalogManage Products and select the desired product from the
grid.

2. In the Websites tab, uncheck the Staging Website that you wish to de-associate
from the product. Alternatively, you can change the Choose Store View scope dropdown to the desired Staging Website, navigate to the General tab, and select Disabled in the Status dropdown.

3. Click the [Save] button when you are finished. This will remove the product from
the Staging Website, but it will still exist in the production site until a merge is performed.

4. Merge the Staging Website into the production Website by following the steps in the
previous section of this chapter. The product will be unassigned to or disabled in the Staging Website as well as the production Website. Now you can safely delete the product, as it is no longer used.

To create a product on a staging website:

1. Navigate to CatalogManage Products and click Add Product. 2. Create the product as usual and assign it only to the Staging Website on the
Websites tab. Save the product.

3. Merge the Staging Website into the production Website by following the steps in the
previous section of this chapter. Now the product will be available in both the staging and production Websites. Similar steps should be taken when working with other types of content. Special care has to be taken when upgrading Magento. Upgrades will modify Staging Websites but will not modify the backups, and in many cases (if the upgrade modifies content tables) this can render the backup unusable. It is advisable to perform upgrades before working on Staging Websites, or after a merge is performed, confirmed and no rollback is expected to be used. 12

Chapter 2Design & Content Enhancements

2.2 Changing the Favicon

[EEV1.9]

Prior to EE v1.9, the favicon for a website could only be changed by editing the skin files for the stores theme. In EE v1.9, store administrators now have the ability to upload a new favicon for a website, store, or store view from the Admin Panel. While some browser support additional file types as favicons, the safest format is a .ico file that is 16x16px or 32x32px. Many free favicon converter tools are available online to convert your .pngs, .gifs, and .jpegs to the .ico format.

To change the favicon:

1. Choose SystemConfiguration.
Be sure to select the desired Configuration Scope.

2. Select the Design tab on the left. In the HTML Head panel, configure your staging
websites:

Favicon iconClick the Browse button. In the File Upload dialog box, browse
for the desired image file on your computer and then click the Open button.

3. Click the [ Save Config] button to save your favicon.

Magento does not convert an image from other file formats to an appropriate one; therefore, the store administration needs to perform the file conversion prior to uploading an image file.

13

Part ISite Management Features

Performance Enhancements

[EE]

Full-page caching is an Enterprise Edition performance enhancement that provides quicker loading time for frontend pages by caching the entire contents of pages. Magento caches category, product and CMS pages. As a general concept, caching improves response time and reduces server load.

Chapter Quick Reference

The table below lists some of the most common tasks for using EEs full-page caching and where to go in the Admin Panel to perform them. The sections that follow provide step-by-step instructions on each. Table 3. Enterprise Edition Full-Page Caching Tasks Quick Reference.
TASK To configure the page cache To manually clear the page cache To configure auto generation of the page cache To schedule the auto-generation process to run ADMIN MENU SystemConfigurationSystem tab Full Page Cache Settings panel SystemCache Management Action: Refresh SystemConfigurationSystem tab Full Page Cache Auto Generation Edit cron job in config.xml

3.1 Full-Page Caching

When page caching is enabled, rather than generating each page each time a page is visitedrunning block code and retrieving page information from the databasethe fully generated page can be stored after the first page visit or even pre-generated and stored. The cached content is then used to process the same requests from other visitors. After a page is cached, it takes less time to open it again in the browser. For the purposes of caching, visitors to your website fall into the following categories: Non-sessioned visitors Visitors who are just browsing a site. Sessioned visitors Visitors who interact with a store by comparing products or adding products to the shopping cart and therefore have a session ID. Customers Logged in visitors who have a relation to a customer group which can affect prices. Most visitors to any website are non-sessioned, so the cache is populated mostly with the content of pages visited by such visitors. When non-sessioned visitors browse a store, the system caches the content of these pages, which can be served again to other non-sessioned visitors. Cached page content generated by a sessioned visitor visiting a category or a product page is only available for the same sessioned visitor.

14

Chapter 4Security Enhancements

In the current version of Magento Enterprise Edition, the whole category, product, or CMS page content is cached including the static and dynamic blocks after a shopper visits a page for the first time. When the content of a dynamic block on a cached page changes, the cached page is retrieved, the dynamic block overwritted, and the changed page is re-cached.

To configure full-page caching:

The Site Administrator has some control over how much site content is cached. These settings control the page cache that is generated after a visitor visits a page for the first time. Pages that are never visited are not cached.

1. Choose SystemConfiguration. Select the System tab on the left. 2. In the Full Page Cache panel, you can set the following values:
Cache Lifetime (minutes)For versions EEv1.8 and older. Determines the
number of minutes after which the page cache will be removed. A new page cache will be created the next time a visitor visits the page after the previous cache has been removed.

Maximum Allowed Page DepthDetermines the number of layered

navigation filters, or parameters, that can be applied in order for a page to be cached. For example, each layered navigation filter applied to a page is another parameter. If the page depth is limited to two, each filter will be cached, as well as any combination of two filters. However, combinations of three or more filters will not be cached. This allows control over the number of cached files that will be stored.

Enable Cache For Not Default CurrenciesDetermines whether pages

containing currencies other than the default currency will be cached. o YesEnables page caching for all currencies in the stores allowed currency list (as set in System> Configuration> Currency Setup). Each allowed currency represents another variant of the same page. When enabled, this option greatly increases the cache storage size. o NoOnly pages for the default currency will be cached.

3. Click the [ Save Config] button to save your settings.

To manually clear the page cache
After making changes to products or CMS pages and blocks, you may want to clear the page cache in order to force the updates to appear. If youve enabled page cache auto generation refreshing the page cache also triggers the auto-generation process.

1. To refresh the page cache, go to SystemCache Management. 2. Check the checkbox for Page Cache in the Cache Storage Management grid.

15

Part ISite Management Features

3. Select Refresh from the Action drop-down in the top right of the grid. Click on the
[Submit] button.

4. Or if youve made changes that also include configs, layouts, and/or web services,
you can click the [x Flush Magento Cache] button. The page cache will be cleared and will begin to be regenerated as shoppers visit pages on the website.

To enable and configure full-page cache auto generation

Magentos page cache is typically visitor generated, meaning that pages are cached after theyre visited the first time. When a site first goes live, or after large numbers of content changes, you may want to force the cache to re-generate itself fully. Magentos Full Page Cache Auto Generation functionality generates the page cache by crawling the website, rather than by waiting for visitors to click to each page. This creates more cached pages than does visitor-generated page caching, as pages are cached even if they are not visited. Auto-generating the page cache ensures that the initial visitor to a page avoids the longer load time. It can be a very resource intensive process, however, and should not be done during high traffic times on your site.

1. Choose SystemConfiguration. Select the System tab on the left. 2. In the Full Page Cache Auto Generation panel, you can set the following values:
Enable Pages Cache Auto Generation
o YesEnables this feature. This does not cause the page cache to be autogenerated, however. To start the auto-generation process, enable it here and then go to the Cache Management screen (System > Cache Management) and flush the Magento cache there. This will trigger the auto-generation process. o NoThe page cache will not be generated by a crawler and will be generated only as visitors visit each page on your site.

Crawler Thread NumberDetermines the number of parallel requests during

this process. The crawler class that emulates the first visit to a page can work in a multi-thread mode. A higher number of threads will reduce the amount of time required to cache all pages, however it will also consume more system resources. Be careful with this option. Depending on your hardware and server configuration, we recommend no more than one to five parallel threads.

Generate Pages Cache For Not Default CurrenciesDetermines whether

pages containing currencies other than the default currency will be cached.

3. Click the [ Save Config] button to save your settings.

16

Chapter 4Security Enhancements

Because this feature can be so resource intensive, we recommend enabling it only when needed after the cache has been regenerated you can disable it until the next time you want to fully regenerate the page cache.

To auto-regenerate the page cache

Because auto-generating the page cache can be so resource intensive, it should be scheduled and run as a cron job . The cron job is set in your config.xml file in app/code/core/Enterprise/PageCache/etc/config.xml. The config.xml file contains the following block, which is responsible for setting up the schedule for cache regeneration:
<crontab> <jobs> <enterprise_page_cache_crawler> <schedule><cron_expr>0 3 * * *</cron_expr></schedule> <run><model>enterprise_pagecache/crawler::crawl</model></run> </enterprise_page_cache_crawler> </jobs> </crontab>

17

Part ISite Management Features

Security Enhancements

[PE][EE]

This chapter introduces Magento Enterprise Edition encoding and security features, matching PCI standard requirements.

4.1 Encryption and Hashing

Magento Enterprise Edition hashes all data that does not require decryption by using a strong SHA-256 hashing algorithm instead of the previously used MD5. Legacy passwords will be hashed using the new algorithm whenever they are entered by customers, and all new passwords will be hashed using the SHA-256 algorithm. Magento Enterprise Edition also encrypts all data that does require decryption by using an industry-standard AES-256 algorithm. This includes credit card data and integration (payment and shipping modules) passwords.

4.2 Changing the Database Key

Magento Enterprise offers a tool to change the database key that is used for data encryption and decryption. This database key was generated when Magento was originally installed in your production environment. The key should be changed if the old key is ever compromised, as well as on a regular basis to improve security. When the key is changed, all legacy data is re-encoded using the new key.

To change the encoding key:

1. Navigate to SystemManage Encryption Key. 2. Select whether or not the new encryption key will generate automatically. If not, a
New Key field will appear in which you can manually enter a new key.

3. Click the [Change Encryption Key] button in the top right of the page.
The encryption key will be changed and all previous data will be encoded with the new key. The new encryption key will be displayed for reference.

Please make a note of the new key and keep it in a safe place. It will be required in order to decrypt data if any problems occur with your files.

18

Chapter 4Security Enhancements

4.3 Logging Administrator Actions

Logging of administrator actions allows tracking of backend activities. For most events, the available information includes the action, the name of the user who performed it, whether it was a success or failure, and the ID of the object on which the action was performed. Additionally the IP and date are always logged.

To configure logging:
By default, all available modules are logged.

1. To configure which modules are logged, navigate to System Configuration,

click the Admin tab in the left column

2. In the Events Logging panel, locate the module you wish to edit and select Yes to
enable it or No to disable it. Additionally, you can control how long the log entries are stored and how often they are archived.

1. To edit these settings, click on the System tab in the left column. 2. In the Event Log Archiving panel, modify these settings:
Save Log, daysDetermines how long the log entries are stored in the
database before being removed. If there are many administrators working on the site, you can change this value from the default (60 days) to a lower value to avoid filling the capacity of the database.

Log Archiving FrequencyDetermines how often old events are saved to the
archive. Possible values are Daily, Weekly or Monthly.

For log cleaning to work, the Magento cron job has to be set up. More information is available here: http://www.magentocommerce.com/wiki/how_to/ how_to_setup_a_cron_job

Logs Report
To view the actual log of admin actions, navigate to System > Admin Actions Log > Report. This page is in a grid format, allowing you to sort and filter by values such as timestamp, IP address, user name, and module. If applicable, the Item_id will display the ID of an affected item, such as customer ID, order ID, or product ID. The log report can be exported to CSV or XML using the Export to dropdown and Export button.

19

Part ISite Management Features

Logs Archive
To access the log archive files, navigate to SystemAdmin LoggingArchive. This page lists the CSV log files stored in var/admin_logs. By default, the filename will contain the current date in the format (iso) yyyyMMddHH.csv. Filenames are linked to download the appropriate file.

4.4 Setting Administrator Password Security Levels

There is a set of options controlling administrator password security. The following settings are available by navigating to SystemConfiguration, clicking the Admin tab in the left column, and selecting the Security section:

Maximum Login Failures to Lockout AccountDetermines the number of

consecutive failed login attempts that will cause that account to become locked. If you do not want to enable the lockout feature, leave this field blank.

Lockout Time (minutes) Determines the duration, in minutes, for which the
account will be locked after the failed logins.

Password Lifetime (days) Determines the duration, in days, until Magento

will request an administrator to change their password. If you do not want to enable the password lifetime feature, leave this field blank.

Password ChangeDetermines if the administrator is required to change their

password after the password expires (option Forced), or if the password change is optional and a notification message is displayed (option Recommended).

During an account lockout, other administrators can unlock the account by navigating to SystemPermissionsLocked Users.

20

PART II CATALOG AND CONTENT MANAGEMENT FEATURES

Enhanced Content Management System (CMS+)

[EE]

This chapter introduces the enhanced content management system, CMS+.

5.1 Widgets
Widgets are configurable and reusable page blocks that allow you to display dynamic (or static) content in the frontend. For example if you wanted to display all best sellers for a specific category on the top part of the category page you can use a widget rather than custom coding that capability.

To create a new Widget:

1. Navigate to CMSWidgets and click Add New Widget Instance. 2. You will need to select the type and theme to use to for this Widget, which cannot
be changed after it has been created. The Widget type will determine which configuration options display in the Widget Options tab in the next step.

3. After clicking Continue, configure the Widget with the following options:
Frontend PropertiesFor the most part, all Widgets types have the same
options in the Frontend Properties tab. You can set the name, Store View(s), and sort order. The sort order is only relevant when two or more widgets both display in the same section of the same page. This placement is determined in the Layout Updates section. Click Add Layout Update to create a rule defining where this Widget will display. You can add multiple Layout Updates. In the Display On dropdown, select on which type of page this Widget will display. You can choose from category pages, product pages, or other specific pages. If you choose a type of category or product, you can then choose specific categories or products, respectively. If you choose a specified page, you must then choose the page (or select a format of page to use, i.e. all pages with a left column). Then, in the Block Reference dropdown, select the location on this page where the Widget will be placed. All Widget types can be placed in the left, center, or right column, but some can also be placed in the header or footer. Lastly, choose the Template. Some Widget types only have one template, and therefore there is no ability to select. Link Widget types and product listing Widget types will have multiple template options to choose from.

21

Part IICatalog & Content Management Features

Widget OptionsThe options in this tab depend on which type you initially
selected. o Banner RotatorThis Widget allows you to display one or more previously created Banners. Banners are a new Magento feature which will be discussed in more depth below. From the Banners to Display dropdown, you can select if the Banners are all related to a Shopping Cart or Catalog Price Rule, in which case they will only display if the rule is active and applied. You will be able to associate a Banner with a price rule when creating the Banner. Depending on your selection from that dropdown, you will be able to choose which specific Banners to use. If you selected Specified Banners, then you will be able to choose each Banner individually from the grid below. If you chose Banners associated to a Shopping Cart or Catalog Price Rule, then you will need to select the Banner Type from a dropdown. Banner Type is set on the Banner level, and will help you ensure that the Banners will fit the Block Reference that you chose in the previous tab. From the Rotation Mode dropdown, you can select how to display the Banners if you have chosen more than one for this Widget. You can display them all at once or rotate them. If you rotate them, you can also choose if they will rotate randomly, in a series (they will rotate in order based on position), or shuffled (they will all display once in a random order, and then start over). o CMS Hierarchy Node LinkThis Widget allows you to link to a CMS Node or page. Choose the Node or page by selecting it from the Hierarchy tree. Only pages which are part of the Hierarchy can be linked to using this Widget type. CMS Hierarchy is a new Magento feature, and will be discussed in more depth below. In addition to choosing the Node or page to link to, you can also customize the text of the link. o CMS Page LinkThis Widget allows you to link to any existing CMS page. Choose the page by selecting it from the grid. You can also customize the text of the link. o CMS Static BlockThis Widget allows you to insert an existing Static Block. Choose the Static Block by selected it from the grid. o Catalog Category LinkThis Widget allows you to link to a category. Choose the category by selecting it from the category tree. You can also customize the text of the link.

22

Chapter 5Enhanced Content Management System (CMS+)

o Catalog Events CarouselThis Widget allows you to insert the Events Carousel. Catalog Events are a feature of the Enterprise Edition, and were introduced in the previous Version 1.3 release. They are discussed in more depth in Chapter 8 above. You can customize the number of Events to display at once in the Carousel, the number of Events to scroll each time the scroll arrows are clicked, and the width of the Carousel, so that it will fit into the Block Reference that you chose in the previous tab.

Catalog New Products ListThis Widget allows you to insert the new
products block. Products will display in this block if the Set Product as New From/To Date range, configured on a per product level, includes the current date. You can customize the number of products to display at once, as well as the cache lifetime.

Catalog Product LinkThis Widget allows you to link to a product. Choose

the product by selected in from the grid. The category tree allows you to filter the product results in the grid. You can also customize the text of the link.

Recently Compared ProductsThis Widget allows you to insert the recently

compared block. You can customize the number of products to display at once.

Recently Viewed ProductsThis Widget allows you to insert the recently

viewed block. You can customize the number of products to display at once.

5.2 Banners
Banners are another feature in Magento which allow you to display blocks of information on the frontend. These blocks can contain static content and Widgets. They can also be configured to display only to certain types of customers, or when certain price rules are applied.

1. To create a new Banner, navigate to CMSBanners. After clicking Add Banner,

configure the Banner with the following options:

Banner Properties
o Banner NameThis is for internal purposes. o ActiveOnly active Banners will be able to be displayed in the frontend. o Applies ToSelect the Banner Type(s) from this dropdown. A Banner can be associated to multiple Banner Types. As previously discussed in the Widgets section, Banner Types are an internal tool to help you keep track of the page area for which a Banners is intended. This is due to the fact that you may design the Banner dimensions to fit a specific space. When creating a Banner Rotator Widget, you can select the Banners to use based on Banner Type. Possible Banner Types include the header, footer, left column, right column, and main content area.

23

Part IICatalog & Content Management Features

o Customer SegmentsCustomer Segments are a new Magento feature which will be discussed in more depth in Chapter 11. Essentially, they are a rule-based tool for dynamically segmenting customers by attributes such as purchase history, items in shopping cart and much more. You can associate a Banner to a Customer Segment to personalize your marketing and merchandizing of products. To do so, select Specified from the dropdown, and highlight the desired Customer Segment(s).

ContentEnter your static HTML content in the text area. You can also insert
Widgets and images into the content area. When you click Insert Widget, a pop-up window will allow you to create the Widget to insert. You will be able to choose from any of the previously mentioned Widget Types, except for Banner Rotator. The options in the pop-up window include all of the options you would see in the Widget Options tab when creating a Widget through CMSWidgets, as well as the Template dropdown from the Frontend Properties tab. When you click Insert Image, a pop-up window will allow you select the image to insert from your media directory. You can also upload images from your computer to the directory in this window, and then select them to use in the Banner. If you are using multiple Store Views, you can create different content for each.

Related PromotionsThis tab includes one grid containing all your existing
Shopping Cart Price Rules, and one grid containing all your existing Catalog Price Rules. Select the checkbox next to a Price Rule to associate it. You can associate this Banner to multiple Shopping Cart and Catalog Price Rules simultaneously. If the Banner is associated to any price rules, it will only display when that rule is applied (the price rule is active and the conditions in the rule have been met). You can also associate a Banner to a Price Rule via the Price Rule page. For both Shopping Cart and Catalog Price Rules, there is now a Related Banners tab in the Price Rule page. This tab includes a grid containing all existing Banners, which can be associated by selecting the checkbox next to the Banner.

5.3 Versioning
Magentos new Versioning system for CMS pages allows you to create multiple Versions of a page, track the Revision history of each Version and restore, and separate the ability to create and publish based on permissions.

Enabling VersionsWhen creating a new CMS page in Magento, you will be

presented with the option to enable Versioning for that particular CMS page. To enable it, select Yes from the Under Version Control dropdown. If No is selected, only one Version will be saved, and there will be no ability to restore Revisions (this is how CMS pages functioned prior to the Versioning feature).

24

Chapter 5Enhanced Content Management System (CMS+)

Editing VersionsAfter saving the page initially, the options presented will
change. In the Page Information tab, the Currently Published Revision will display a link to the Version that was just created. Even if the CMS page itself is not published yet (the Status is Disabled), the Currently Published Revision will display, and this will represent the Version and Revision that will display as soon as the page becomes published. To access the content section and make further edits, select the Versions tab. Initially, there will only be one Version listed here. When you select that Version, you will be redirected to a new page displaying the Version options and the list of Revisions for that Version. o Version LabelThis is the name of your Version. It is for internal purposes, to help you differentiate between the content of the various Versions. When you want to create multiple Versions of the same page (for example, a seasonal Version and a regular Version), make sure to label your Versions appropriately. o Access LevelThis sets the permissions for accessing this Version. Private means that only the creator of this Version will be able to access it. Protected means that only users with Publish Revision permissions (in SystemPermissionsRoles) will be able to access it. Public means all users with CMS Pages permissions will be able to access it. o OwnerBy default, this will be the user who created the page. The owner can be changed, which will affect access to the page if the access level is set to Private.

Underneath these options is a grid listing all Revisions to this Version. Clicking
on a Revision here will allow you to edit the content, design, and meta data. Each time an edit is made to any Revision and saved, a new Revision will be created. Alternatively, you can Save in New Version, which will create a new Version (in which this will be the first Revision) instead of saving this as a new Revision to the current Version.

Publishing VersionsIn order to publish a page, you must select the desired
Revision of the desired Version, and click Publish. If you are currently making edits to this Revision, the Publish button will instead read Save and Publish, which will simultaneously create a new Revision and publish the page. This published Version and Revision will now display under the Currently Published Revision link in the Page Information tab (you may need to click Back once or twice to arrive here). Make sure that the Status is set to Published for the page to be visible on the frontend.

25

Part IICatalog & Content Management Features

5.4 Hierarchy
The CMS Hierarchy feature is a categorization tool for CMS pages, allowing users with no technical knowledge to create complex content pages and sections of content such as Articles, Knowledge Base, and more. The advantage to categorizing your CMS pages is that you will then be able to display automatically generated menus and/or pagination, to allow your customers to browse through the pages easily.

1. To access the CMS Hierarchy, navigate to CMSPagesManage Hierarchy. The

Hierarchy can be managed per Store View.

Adding Nodes and pagesOn the left side of the page will be the Hierarchy
tree. You can add Nodes and pages to this tree. A Node is used solely as folders to group child Nodes and/or pages. Nodes cannot be viewed on the frontend. If a customer visits a Node on the frontend, they will automatically be redirected to the first page under that Node. Pages can be viewed on the frontend, but they can also be used as folders to group child Nodes or pages. To add a Node to the tree, click Add Node on the right of the tree. The Node will be added to whatever folder (whether Node or page) is currently highlighted. To add a page or pages to the tree, select them from the grid below, and click Add Selected Page(s) to Tree. The page(s) will be added to whatever folder is currently highlighted. A page can only be added to a folder once, so it will become inactive in the grid below when that folder is highlighted. However, pages can be added to multiple folders.

Node and page optionsWhen a Node or page is highlighted, you will be

able to edit the option on the right of the tree. o PropertiesHere you can edit the title and url key. They can only be edited for Nodes, because the title and url key for pages are set in CMS > Pages > Manage Content. You can also preview the frontend. When previewing Nodes, you will be redirected to the first page under that Node. o Render Metadata in HTML HeadThis section will only appear for top level Nodes and pages. It is used for SEO purposes to define the structure of the Hierarchy o Pagination Options for Nested PagesThis section will only appear if child Nodes or pages have been created under the currently highlighted Node or page. They will only control the pagination for the immediate child Nodes or pages (i.e. pagination options for a top level Node or page will control 1st level child Nodes and pages, pagination options for a 1st level child Node or page will control 2nd level child Nodes and pages, etc.). If pagination is enabled, then links to the previous and upcoming pages will appear above and below the page content on the frontend. They will link to the other sibling pages. You can also control the number of page links to display at once. 26

Chapter 5Enhanced Content Management System (CMS+)

o Navigation Menu OptionsIf the navigation menu is enabled, then a menu similar to the category tree will appear on the frontend, above the page content. For each Node, you can control the number of parent and child levels to display in the menu, as well as the list options for the menu (i.e. numbered list, bulleted list, etc.). Hierarchy can also be managed on the CMS pages themselves. To do so, select a page and click the Hierarchy tab in the left column. The Hierarchy tree will display, with a checkbox next to each Node and page. You can associate this CMS page to multiple Nodes or pages.

5.5 WYSIWYG
A WYSIWYG (What You See is What You Get) editor for CMS pages now gives you two ways to style your content. This editor has been embedded from TinyMCE. More information can be found about this editor at http://tinymce.moxiecode.com/. With the Show/Hide Editor button, you can toggle between the WYSIWIG mode, where the style and page elements are controlled using the toolbar of buttons, and the standard HTML mode, where these elements are controlled using HTML tags. Content already in the page will also convert automatically to match the mode. Styled content in WYSIWYG mode will reveal the tags in HTML mode, and visa versa.

WYSIWYG modeThere are some TinyMCE WYSIWYG features which should

be pointed out, as well as some additional Magento features which have been incorporated into the editor. o Insert WidgetThis button allows you to insert a Widget into the CMS page. A pop-up window will allow you to create the Widget to insert. You will be able to choose from any of the previously mentioned Widget Types. The options in the pop-up window include the all of the options you would see in the Widget Options tab when creating a Widget through CMSWidgets, as well as the Template dropdown from the Frontend Properties tab. o Insert/edit ImageThis button allows you to insert an image into the CMS page. A pop-up window will allow you to configure the image. Enter the image path, or (in a second pop-up window) browse and select the image to insert from your server directory. If browsing, you can upload images from your computer to the directory in this window, and then select them to use in the CMS page. In the original pop-up, you can also set other information regarding the image, including description, title, styling, and mouse over effects.

27

Part IICatalog & Content Management Features

o Insert/edit embedded mediaThis button allows you to insert various types of media into the CMS page. A pop-up window will allow you to configure the media. Select the media type (Flash, QuickTime, Shockwave, Windows Media, or Real Media), and enter the media path, or (in a second pop-up window) browse and select the media to insert from your server directory. If browsing, you can upload media from your computer to the directory in this window, and then select them to use in the CMS page. In the original pop-up, you can also set other information regarding the media, including dimensions and styling.

HTML modeIn HTML mode, you still have the ability to insert Widgets and
images. The only difference is that for inserting images, you will immediately be taken to the server directory pop-up, and will not be able to set the description, styling, etc. These must be set using HTML tags.

28

Chapter 6Enhanced Catalog Search

Catalog Search Enhancements

[EEV1.8+]

The success of any web store greatly depends getting customers to the right products quickly. Magento Enterprise Edition provides several new search features which can significantly improve search results and relevancy for your visitors and customers. Primary among these features is the ability to use Apaches Solr search engine and enhanced search recommendations and related terms.

Chapter Quick Reference

The table below lists some of the most common tasks for using EEs full-page caching and where to go in the Admin Panel to perform them. The sections that follow provide step-by-step instructions on each. Table 4. Enterprise Edition Search Enhancements Tasks Quick Reference.
TASK To enable Solr To configure quick search with Solr to use attribute weights To enable search suggestions using Solr To enable catalog navigation using Solr To enable and configure search recommendations To set up related search terms ADMIN MENU SystemConfigurationCatalog tab Catalog Search panel CatalogAttributesManage Attributes tab Frontend Properties tab SystemConfigurationCatalog tab Catalog Search panel SystemConfigurationCatalog tab Catalog Search panel SystemConfigurationCatalog tab Catalog Search panel CatalogSearch Terms

6.1 Catalog Search with Solr

Solr is a powerful search engine that supports stemming, plurals, replacements, layered navigation and more. Solr is not bundled with Magento and must be installed separately by your hosting firm or sys admin, but it is fast and enterprise ready and available for all Unix systems. The Solr search feature in Magento Enterprise Edition allows you to choose between using the default Magento MySQL-based search or using an external Solr server for product searches on the frontend. When you enable and configure Solr, both the quick search and advanced search will be redirected to the Solr server and Magento will present results in exactly the same way as it would with the default MySQL-based search. Solr search engine module provides Magento users with the following advantages: Improved search performance 29

Part IICatalog & Content Management Features

Improved search results relevancy Support for spelling/synonyms/stop words Improved layered navigation performance Solr is especially recommended for sites with heavy traffic and search loads. Products are added to search engine index as each product is saved in the Admin Panel so the index is kept up to date without any need for manual intervention.

Installing Solr
The Solr search engine must be installed separately from Magento. Please consult with your system administrator or hosting firm to get it installed. While Magento is unable to provide support for configuring Solr server we can provide Solr configuration and schema files to help your hosting firm or sys admin with initial server configuration. Please contact the support team for assistance.

During the installation process, you specify the host name, port, and the password to connect to the server where Solr search engine is installed. Keep track of this information, which you will have to input into Magento. Note that Solr provides a number of base files which need to be filled in for every language that will be used in the system. The files are as follows: protwords.txt protected words. Use a protected word file to protect against the stemmer reducing two unrelated words to the same base word. spellings.txt definitions of misspelled words stopwords.txt words that stop the search (have no meaning for search) synonym.txt synonyms for every language Out-of-the-box Solr supports search functionality for twenty languages. Depending on the language of the store opened in the frontend, Solr will call the fields of that specific language.

Configuring Your Magento Store to Use Solr

Magento quick search performed by Solr search engine provides the following new options: Search results according to the specified weight of an attribute Search terms suggestions based on the corrected customers misspelling Search results including Layered Navigation block

30

Chapter 6Enhanced Catalog Search

To enable Solr:
A number of parameters must be set up in Magento Admin Panel in order to establish the connection to Solr search engine, which can be installed either on the same or on a different server from Magento.

1. Choose SystemConfiguration. Select the Catalog tab on the left. 2. In the Catalog Search panel, enable Solr by setting the following values:
Search EngineDetermines whether the default MySqlFulltext search engine
or Solr is used for product search on your websites. The search engine used and its configuration settings are global for all websites on the Magento installation. You can set the following values: o MySqlFulltext The default Magento-native search o SolrEnables Magneto to use the Solr search engine (installed separately). Select MySql Fulltext to use the Magento-native search.

If Solr is selected the following fields will appear: Solr Server HostnameSpecify the host name of the Solr Enterprise Search
server to connect to

Solr Server PortSpecify the port number of the Solr server to connect to Solr Server Passwordthe Solr server password you set when you installed
Solr.

Solr Server TimeoutThe connection to Solr search engine should be

established within the number of seconds specified in the Solr Server Timeout field. If it is not, the MySQL search engine is used instead of Solr

Solr Server pathSpecify the path to Solr located on the server specified in
the Solr Server Hostname field. The Solr server path should be specified with no starting and ending slashes.

3. Click the [ Save Config] button to save your settings

To configure quick search for Solr:

[EEV1.9]

With Solr search engine enabled, all of the product attributes allowed for quick search now have an additional Search Weight parameter. This parameter denotes the priority a specific attribute has in the Solr search. If Solr is enabled, it is also used for Advanced Search, but the search weight is not used there in generating search results. When a customer enters a term in the search field on your web store, one of the parameters that Solr search engine takes into account in generating results is the attribute search weight. Attributes whose search weight is greater will be searched and returned first by Solr.

31

Part IICatalog & Content Management Features

For example, if there are two attributes in the system, color with a search weight of 1 and description with a search weight of 3. When a customer searches for the word red, Solr will return a list of products whose color attribute is red and will not include in the list the products whose description contains the word red. This happens because the search weight of the color attribute is higher than that of the description attribute.

1. To set your attribute weights, choose CatalogAttributeManage Attributes. 2. In the Frontend Properties panel, you can set the following values:
Search EngineSolr must have previously been enabled. See instructions
above To enable Solr

Use in Quick SearchDetermines if an attributes values will be used when

returning search results o YesThis attribute can be used in generating quick search results. If set to yes and if Solr is enabled, the search weight field below appears. o NoAttribute cannot be used in generating quick search results.

Search WeightThe search weight of product attributes can range from 1 to 5.

1=greatest weight; 5=least weight. Greater search weights have higher priority in returning results. If no value is specified, all attributes have a search weight of 1.

3. Click the [ Save Attribute] button to save your settings.

To enable search suggestion for Solr:

[EEV1.9]

In Magento Enterprise Edition v1.9+, customers misspellings in the search query text is corrected and customers are provided with Solr-recommended search suggestions. When a customer makes a spelling mistake in the search term, the system displays the Did you mean: suggestion_link message on the search results page and, depending on the search suggestion configuration, more than one suggestion can be displayed to the customer.

1. Choose SystemConfiguration. Select the Catalog tab on the left. 2. In the Catalog Search panel, enable Solr by setting the following values:
Search EngineSolr must have previously been enabled. See instructions
above To enable Solr

Enable Search SuggestionsDetermines if search suggestions will be

provided by Solr in response to common misspellings o Yesmakes the search suggestions functionality available to customers. Enabling search suggestions can slow down search performance (depending on your hardware, configuration and search volume). If search performance becomes slow, disable this option. 32

Chapter 6Enhanced Catalog Search

o NoSearch suggestions will not be provided with search results.

Search Suggestions CountSpecify the number of suggestions that will be

provided to the customer on running search in the frontend. The suggested terms are those that most closely correspond to the term being searched. By default, this field is set to display two suggestions.

Show Results Count for Each SuggestionSet to Yes to display the

number of search results for each search suggestion. (Depending on theme, usually shown in brackets next to the suggestion.)

3. Click the [ Save Config] button to save your settings.

To enable catalog navigation using Solr:

[EEV1.9]

All of the attributes set to be used in layered navigation are added to Solr index. Because of this Solr can also be used to generate the layered navigation. In order to add these attributes to Solr search results, the store administrator needs enable Solr for catalog navigation.

1. Choose SystemConfiguration. Select the Catalog tab on the left. 2. In the Catalog Search panel, enable Solr by setting the following values:
Search EngineSolr must have previously been enabled. See instructions
above To enable Solr

Enable Solr Engine for Catalog NavigationDetermines if Solr will be used

for generating the layered navigation o YesUses Solr instead of the MySQL Fulltext search to generate the layered navigation o NoMagento-native catalog and layered navigation is used.

3. Click the [ Save Config] button to save your settings.

6.2 Related-Terms Search Recommendations [EEV1.9]

With search recommendations enabled and set up, the store administrator is able to more easily specify search synonyms for customers search terms. This greatly expands the search results available to customers. Search recommendations functionality is independent of the search engine selected and is available for both MySql Fulltext and Solr search. The store administrator can specify the search recommendations list for a specific search term and the search engine provides the standard search results and also proposes the list of related terms with the search results.

33

Part IICatalog & Content Management Features

For better performance, Magento also splits the searched word combination into separate words and automatically provides search recommendations for each of them, if these are available in the system. For example, if a visitor searches for the phrase hp laptop, the search system splits the phrase into two words, hp and laptop, and provides five search recommendations for the first term and twelve for the second one.

To enable related terms search recommendations:

When search recommendation are enabled, when a visitor searches for a term that has search recommendations set up for it, the visitors search results are provided as well as related search terms (the search recommendations) with a count of the number of results for each. Clicking any of the recommended terms takes the visitor to the search results page for the selected search term. Search recommendations functionality is independent of the search engine selected and is available for both MySql Fulltext and Solr search.

1. Choose SystemConfiguration. Select the Catalog tab on the left. 2. In the Catalog Search panel, enable search recommendations by setting the
following values:

Enable Search RecommendationsDetermines if search recommendations

are provided on the frontend for synonyms and other related searches o YesUses Solr instead of the MySQL Fulltext search to generate the layered navigation o NoMagento-native catalog and layered navigation is used.

Search Recommendations CountSpecify the number of words that will be

provided to the customer as recommended terms related to customers search. By default, no more than five recommended terms are shown to customers.

Show Results Count for Each RecommendationIf Yes, the number of

products found for the proposed search recommendation is shown in the brackets next to it.

3. Click the [ Save Config] button to save your settings.

To relate search terms:

1. To add related search variants to a search term, choose SystemConfiguration.

The resulting Searches grid, provides the list of all terms that have been searched by customers on the web site. These include the misspelled and incorrectly entered words. Magento also counts the number of each term being searched by customers which helps identify the most frequently searched terms and add synonyms or search recommendations for them.

2. Click on any of the search terms in the list

34

Chapter 6Enhanced Catalog Search

3. On the resulting Edit Search page, to see all previously searched terms click the
[Reset Filter] button located in the upper right of the Related searches gird. Filter the list as desired to find specific related searches.

4. Click on the checkboxes for all search queries to be added as search

recommendations for this search term.

5. Click the [ Save Search] button to save your settings.

Tip: Any search queries created through the Admin Panel will not have a count of search results associated with them. In order to generate the count, the query must be run from the frontend.

35

Part IICatalog & Content Management Features

Inventory Control Enhancements

[EEV1.8+]

All editions of Magento have robust inventory control capabilities that allow you to set and manage inventory levels and thresholds and auto-decrement inventory as its sold from the website. In addition, Magento Enterprise Edition has additional capabilities that provide you with even more control.

7.1 Quantity Increments & Only X Left

One of the new inventory control features that are available with Magento Enterprise Edition v1.8 is the ability to set the allowed quantity increments when customers add an item to their carts. This is especially relevant for B2C sites that sell items in multi-packs or B2B sites that sell in cases or cartons. Another new inventory feature is the ability to message on the frontend when an item is nearly out of stock with an Only 5 left type message. This helps add urgency and improve conversion, which can be especially helpful for moving those last couple of items. EEv1.8 also offers some support for setting order minimums on a customer-group basis, but this can only be set globally for that customer group at this time.

To enable and configure additional inventory control options:

In order to take advantage of these new inventory control features, you first need to enable them in the Admin Panel. In addition, you have the option of setting some of the default values for your entire store, if that makes sense for your merchandise. If not, you can set specific thresholds and increments on a product-by-product basis.

1. Choose SystemConfiguration. Select the Inventory tab on the left. 2. To enable the Only X left feature for a website, in the Stock Options panel set
the Only X left Threshold value to your desired threshold. If the value is 0, the feature will not be enabled. This value can be set differently for each Magento website in your installation but it cannot be set on a per-product basis. Whatever you set here will apply to the entire website you have selected in the Configuration Scope selector.

3. To globally enable the Quantity Increments feature, in the Product Stock Options
panel set Enable Qty Increments to Yes. Enter the desired default increment in the Qty Increments field that appears when you change this field to Yes. You can override these values for each product, if desired.

36

Chapter 7Inventory Control Enhancements

4. To globally enable the minimum purchase quantities for specific customer groups,
in the Product Stock Options panel click the [+ Add Minimum Qty] button. Select the customer group from the drop-down list and enter the quantity minimum desired. This is a global setting and cannot be overridden on a per-product basis.

5. Click the [ Save Config] button to save your settings.

To set quantity increments on a per-product basis:

1. Choose CatalogManage Products. 2. Select a product to edit and then select the Inventory tab on the left. 3. In the Inventory panel, enable the Only X left feature by setting the Only X left
Threshold value to your desired threshold. If the value is 0, the feature will not be enabled. This value can be set for each Magento website.

4. In the Inventory panel, enable the Quantity Increments feature for this product by
setting Enable Qty Increments to Yes. Enter the desired increment in the Qty Increments field that appears when you change this field to Yes.

5. Click the [ Save] button to save your settings.

37

PART III MARKETING AND PROMOTION FEATURES

Rich Merchandizing Suite (RMS)

[EE]

This chapter introduces Magento Enterprise Editions Rich Merchandizing Suite (RMS) of features.

8.1 Targeted Marketing Using Customer Segments

Customer Segments allow you to dynamically identify customer groups based on specific characteristics, from address information, order history, shopping cart contents, and more and to dynamically target different content and promotions to those groups. You can then generate reports and export the customers, as well as optimize marketing initiatives based on those segments including Shopping Cart Price Rules and Banners. Customer Segment information constantly refreshes, so that customers can become associated and de-associated to a Segment as their information changes.

To create a new Customer Segment

1. Navigate to CustomersCustomer Segments. 2. After clicking Add Segment configure the segment with the following options:
General Properties panel
o Segment NameThis is for internal purposes. o DescriptionThis is also for internal purposes, and provides an optional space to enter more detailed information than can be contained in the Segment Name. o Assigned to WebsiteA Customer Segment can only be assigned to one Website, because the conditions can use information that is specific to each Website. To use the same conditions on multiple Websites, you must create multiple Segments. o StatusSelect Active to enable this Segment. Price Rules and Banners associated to this Segment can be unassociated by selecting Inactive, without having to edit the Price Rule or Banners.

39

Part IIIMarketing & Promotion Features

ConditionsIn the Conditions tab you can define the rules by which
customers will be associated to this Segment. These rules are defined in a similar manner to those of Shopping Cart and Catalog Price Rules, with different options. There are 5 main characteristics upon which these rules can be based. o Customer AddressYou can define any of the address fields, such as city or country. Any address in a customers address book can match these conditions for the customer to match. Or, you can specify that only the default billing or shipping addresses can be used to match a customer. o CustomerMiscellaneous customer information can be defined, including Customer Group, name, email, newsletter subscription status, and Store Credit balance. o Shopping CartShopping Cart characteristics can be based on either quantity (line items or total quantity) or monetary amount (grand total, tax, gift card, etc.) currently in the shopping cart. o ProductsYou can define products that are in the shopping cart or wishlist, or that have previously been viewed or ordered. You can also set a date range for when this occurred. The products are defined using product attributes. There is a new setting in the attribute management page called Use for Customer Segment Conditions, which must be set to Yes for the attribute to appear in this section. o SalesOrder characteristics for past orders can be defined based on the billing/shipping address in the order, the total or average amount or quantity of the orders, or the total number of orders. You can also set a date range for when this occurred, and the order status of the orders that match these conditions.

Matched CustomersThis tab will only appear for previously created

Segments. It will be discussed in the Reports section below.

Reporting Based on Customer Segments

Reports for Customer Segments can be generated in two locations. You can navigate to CustomersCustomer Segments, and select an existing Customer Segment from the grid. Then, click on the Matched Customers tab. This tab will only exist for previously created Customer Segments, so it will not display when creating a new Segment. The number of customers that currently match the conditions of this Segment will display in the tab in parentheses. To refresh the Segment data, and get the most up-to-date list of matched customers, click Match Customers at the top of the page. The list of customers can be exported to CSV or Excel using the Export to dropdown, and clicking Export. The second location where a report can be generated is ReportsCustomersCustomer Segments. Select an existing Customer Segment. The report can be generated using the same Export options. In future releases, this report will also allow you to quickly cross-reference Customer Segments.

40

Chapter 8Rich Merchandising Suite

Promotions Based on Customer Segments

In order to utilize these Customer Segments for marketing purposes, you can associate them to Shopping Cart Price Rules or Banners.

Shopping Cart Price RulesTo associate a Segment to a Shopping Cart Price

Rule, navigate to Promotions > Shopping Cart Price Rules, click Add New Rule or select an existing Shopping Cart Price Rule from the grid, click the Conditions tab, and select Customer Segment as a condition in the dropdown. You can specify the Segment to use from a grid listing all of the existing Segments.

BannersTo associate a Segment to a Banner, navigate to CMS > Banners,

click Add Banner or select an existing Banner from the grid, and select Specified from the Customer Segments dropdown. This will open a multi-select menu including all existing Segments. You can associate multiple Segments to a Banner.

8.2 Creating Dynamic Product Relationships

Rule-Based Product Relations offer further targeted merchandizing to your customers. You will be able to suggest products for customers through automated rule-based selection of products to be used for related items, up-sells, and cross-sells.

To create a new Rule-Based Product Relation:

1. Choose CatalogRule-Based Product Relations. 2. After clicking Add Rule, configure the Rule-Based Product Relation using the
following options:

Rule Information
o Rule NameThis is for internal purposes. o PriorityWhen multiple rules overlap on a product page or the shopping cart, the priority will determine the sort order of each group of displayed products. For example, if Rule 1 (with priority 1) displays three products, and Rule 2 (with priority 2) displays five products, and both rules apply to the same products up-sells list, then the three Rule 1 products will always display before the five Rule 2 products. However, the sort order of the Rule 1 products relative to one another is random. Additionally, if there is a mix of rules and manually added products, the manually added products will always display before the rule-based products. Products can be manually added by navigating to CatalogManage Products, clicking Add Product or selecting an existing product from the grid, and selecting the Related Products, Up-sells, or Cross-sells tab. From these tabs, you can manually select which specific products will display. 41

Part IIIMarketing & Promotion Features

o StatusSelect Active for this rule to apply. o Apply ToSelect whether this rule will apply to a products Related Products, Up-sells, or Cross-sells. o From/To DateYou can select a date range in which the rule will automatically become enabled and/or disabled. o Result LimitYou can set a limit for the number of products that will be displayed. The maximum number is 20, but you can set a smaller limit. For example, if you are creating an Up-sell rule, and there are 40 products which match the conditions in the Products to Display tab, you can set the limit to 10. This will automatically choose 10 of those 40 products, which will then rotate through the Up-sells block. The advantage to setting a lower limit is that it reduces the processing time.

Products to MatchIn this tab, set the product conditions to determine which
products will have this rule applied to it. These conditions are defined in the same manner as Catalog Price Rules, whereby the products are defined using product attributes. There is a new setting in the attribute management page called Use for Target Rule Conditions, which must be set to Yes for the attribute to appear in this section.

Products to DisplayIn this tab, set the product conditions to determine

which products will be displayed in the Related Products, Up-sells, or Crosssells blocks. The conditions are almost identical to those of the Products to Match tab, with one additional option available. You can determine which products to display based on a price relationship with the Matched Product. For example, if you want to display Up-sell products which are at least twice the price of the Matched Product, you can show only products which are 200% or more of the Matched Product price.

8.3 Automatically Sending Reminder Emails to Customers [EE V1.8+]

The automated reminder email feature allows you to set your store to automatically send reminder emails at time interval you determine to customers whove added something to their shopping cart or wishlist but have not yet purchased. Emails can be triggered when its X days after the shopping cart or wishlist was abandoned or you can also add other conditions like total cart value, quantity, items in cart, whether the wishlist was shared with anyone or several other conditions. Emails can go out simply as reminders to revisit the site or can have a coupon code associated with them. One of the most powerful features is that unique coupon codes can automatically be generated for each email so that you have complete control over the offers you associate with reminder emails.

42

Chapter 8Rich Merchandising Suite

To enable and configure automated email reminders:

1. Choose SystemConfiguration. Select the Promotions tab on the left. 2. In the Automated Email Reminder Rules panel, you can set the following values:
Enable Reminder EmailsEnables automated email reminders. If this is set to No all of the following values will be ignored. FrequencyIndicates with what frequency Magento should check for new customers who qualify for the automated email reminders. Choices are Minute Intervals (every X minutes), Hourly (every hour), or Daily. o Interval or Minute of the Hour should be set if Minute Intervals or Hourly are chosen Start TimeTime of day of the first check. Specified in 24-hour time based on the system time on your server. Maximum Emails per One RunAllows to you limit the number of emails sent at the same time in any scheduled block. Email Send Failure ThresholdThe number of times the reminder attempts to send out notifications to specific email address and fails. When the value is set to 0, there is no threshold, notifications will keep being sent despite any failures. Reminder Email SenderSets which store contact (as previously set in SystemConfigurationStore Email Addresses tab) will be associated with the email on the From line.

3. Click the [ Save Config] button to save your settings

To create an email template for your automated email reminders:

1. Choose SystemTransactional Emails. 2. Click the [+ Add New Template] button 3. The default email template for reminder emails is called Rule Reminder. Just to
get started, select this email template from the Template dropdown and click the [ Load Template] button. The contents of that template will appear in the Template Information panel below it.

4. Unique to the Rules Reminder email template you will see that you have the
following variables available to you in email reminders. The promotion information in these variables is determined by the automated email reminder rule you set up and the coupon information in these variables is determined by the shopping cart price rule you associate with the automated email reminder rule. promotion_name promotion_description coupon.getCode()

43

Part IIIMarketing & Promotion Features

coupon.getUsageLimit() coupon.getUsagePerCustomer()

5. See the Magento User Guide for more information on the basics of editing
transactional emails. When youre done editing the reminder email template to fit your brand and needs, give it a name and click the [ Save Template] button.

To create a rule for your automated email reminders:

Before setting up an automated email reminder rule, make sure you have a shopping cart price rule set up that defines the promotion being offered

1. Choose PromotionsAutomated Email Reminder Rules. 2. Click the [+Add New Rule] button 3. In the Rule Information tab, you can set the following values:
Rule NameName of automated reminder rule, used internally Description Description of automated reminder rule, used internally Shopping Cart Price RuleThis is the promotion rule (created in
PromotionsShopping Cart Price Rules) that this reminder will advertise. Reminder emails may promote a shopping cart price rule with or without coupon. If a shopping cart price rule defines an auto-generated coupon, this reminder rule will generate a random, unique coupon code for each customer.

Assign to WebsitesSelect which websites should receive automated

reminder emails based on this rule

StatusActive or inactive. If status is inactive all other settings will be ignore

and the rule will not be triggered.

Active FromStarting date for this automated reminder rule. If no date is

specified the rule will be active immediately.

Active ToEnding date for this automated reminder rule. If no date is specified
the rule will remain active indefinitely.

Repeat ScheduleNumber of days before the rule is triggered again and the
reminder email sent again if the conditions are still met. To trigger the rule more than once, enter the number of days of each check separated by commas. For example, enter 7 to have the rule re-triggered again 7 days later; enter 7,14 to have the rule re-triggered 7 days and then again 14 days later.

4. In the Conditions tab, using the standard Magneto interface for promotions, you
can set the following values: Rules can be based either on Shopping Carts, Wishlists or both. For Wishlists, available trigger conditions include: number of days abandoned, sharing, number of items, specific items in wishlist

44

Chapter 8Rich Merchandising Suite

For Shopping Carts, available trigger conditions include: number of days abandoned, if a specific coupon code has been applied, total line items, total items, subtotal, if items are virtual, and specific items in the shopping cart.

5. In the Emails and Labels tab, you can set the following values:
Assign email templates to each storeEach store in your Magento
installation that you have access to will be listed here. Select the email reminder template you would like to go out to each. Leave the value here as Not Selected if you dont want to send this rules reminder email to the customers of that store.

Rule Title (default for all stores)Rule title is accessible in email templates
as a variable.

Rule Description (default for all stores)Rule description is accessible in

email templates as a variable.

Rule Title (per store view)Per store view override of the default title value
supplied above.

Rule Description (per store view)Per store view override of the default
description value supplied above.

6. Click the [Save] button to save your rule.

45

Part IIIMarketing & Promotion Features

Gift Cards

[PE][EE]

This chapter introduces physical and virtual Gift Card products that can be purchased in the site, and Gift Card Accounts which hold balance that can be redeemed during checkout. A Gift Card Account will be created for each Gift Card product purchased.

9.1 Configuring Gift Cards

There are some configuration settings that must be completed relating to Gift Card Accounts.

To configure gift cards:

1. Choose System Configuration and select the Gift Cards tab in the left
column.

2. These will be the default settings for all Gift Card products, and most can be edited
on a per product level. The following settings are available:

Gift Card Notification Email SenderSelect the sender of the email that will
be sent when a Gift Card Account is created. This only applies to accounts created automatically from the purchase of a Gift Card product, and does not apply to accounts created manually by an administrator. The configuration of emails sent for accounts created by an administrator will be described later in this chapter.

Gift Card Notification Email TemplateSelect the template of the email that
will be sent when a Gift Card Account is created.

RedeemableDetermines whether or not the accounts that will be created for

Gift Cards will be redeemable (able to be transferred to Store Credit) upon creation.

Lifetime (days) Determines the expiration date for all accounts. The
accounts will expire X number of days after the Gift Card is purchased. If you do not wish to set a default lifetime, leave this field blank.

Allow Gift MessageDetermines whether the customer purchasing the Gift

Card can add a message that will be sent to the recipient of the card (via email and/or with the shipment of the physical Gift Card).

Gift Message Maximum LengthDetermines the maximum allowed length

of gift messages.

Generate Gift Card Account when Order Item isDetermine the point at
which an account is created for Gift Card products. If you select Ordered, the account will be created when the order containing the Gift Card is completed. If you select Invoiced, the account will be created when the order containing the Gift Card has been invoiced.

46

Chapter 9Gift Cards

Gift Card Code Pool

The Code Pool is a pre-generated set of unique Gift Card codes in a specific format. Codes from the Code Pool are used each time a Gift Card Account is created. It is the administrator's responsibility to assure there are enough free codes in the code pool for the Gift Cards. Make sure to generate a Code Pool before starting to offer Gift Card products.

To generate a new Code Pool:

1. Navigate to SystemConfiguration and select the Gift Card tab in the left
column.

2. In the Gift Card Account General Setting panel, set the following settings:
Code LengthDetermines the number of characters that will be used in all
Gift Card codes, not including the prefix, suffix or separators.

Code FormatChoose whether the code will be Alphanumeric (a mix of

letters and numbers), Alphabetical (letters only), or Numeric (numbers only).

Code PrefixAllows you to add a value that will be appended to the

beginning of all codes, and is optional.

Code SuffixAllows you to add a value that will be appended to the end of
all codes, and is also optional.

Dash Every X CharactersAllows you to determine the interval at which a

dash (-) will be inserted in all codes. If you do not want to use a dash, leave this field blank.

New Pool SizeDetermines the number of unique codes to be generated.

3. Click Save Config in the top right of the page to save the settings used for code
generation.

4. Click the Generate button to generate the Code Pool.

If the Code Length is not long enough to allow for generating the requested number of codes, an error message will be shown.

Depending on the settings and number of codes already used, Magento may generate fewer codes than requested.

47

Part IIIMarketing & Promotion Features

9.2 Gift Card Accounts

Gift Card Accounts are entities which hold the balance of Gift Cards, and they can be used for paying in the store.

To create a new account:

1. Gift Card Accounts can be managed by navigating to CustomersGift Card

Accounts. This page contains a grid listing all existing accounts and gives you the ability to create a new account, or edit existing accounts.

2. Click the Add Gift Card Account button in the top right of the page. 3. When creating or editing a Gift Card Account, there are multiple tabs. In the
Information tab, the following options are available:

ActiveDetermines whether or not the balance of the account can be

redeemed during checkout. Also determines whether or not the balance of the account can be transferred to a customer's Store Credit.

RedeemableDetermines whether or not the balance of the account can be

transferred to a customer's Store Credit.

WebsiteDetermines the website in which the account can be redeemed. BalanceDetermines the balance of the account. Expiration DateDetermines the date on which the account expires and
becomes inactive. This is optional, and leaving it blank will mean that the account is not set to expire.

In the Send Gift Card tab, the following options are available: Recipient EmailEnter the email address to which an email notification of
this Gift Card Account will be sent. This field is optional, and no email will be sent if it is left blank.

Recipient NameEnter the name of the email recipient.

4. When you have completed these settings, click the Save button in the top right of
the page. If you have entered a Recipient Email, click the Save & Send Email button. The Sender and Template of the email that will be sent is different from that of the email sent for a Gift Card product. To edit the Sender and Template of this email, navigate to System Configuration, click the Gift Card Accounts tab, and select the Email sent from Gift Card Account management section.

48

Chapter 9Gift Cards

After the Gift Card Account is saved, you will be redirected to the Gift Card Account grid page, and the newly created account will be listed. To edit any of these settings, click on the row of the account you wish you edit. You will be able to edit all of the same settings that you entered when creating the account. In addition to this, you will see the account Gift Card Code and Status in the Information tab (both of which are not editable), as well as a History tab which displays the balance history of the Gift Card Account.

9.3 Gift Card Products

Gift Card Products are the actual products that can be purchased in the store. There are three types of Gift Card Products: Virtual, Physical and Combined.

To create a new Gift Card:

1. Choose CatalogManage Products. 2. Click Add Product in the top right of the page. 3. Select your desired Attribute Set, select Gift Card from Product Type dropdown,
and click Continue.

4. Set the Gift Card pricing in the Prices tab. Rather than having a price field like that
of a Simple Product, Gift Cards have a price configuration feature similar to that of the tier price feature. You can add additional prices by clicking the Add Amount button. Each amount added will display in a dropdown on the frontend. Instead of using set prices, you also have the option of allowing the customer to enter their own gift card amount into an open field. To allow this, set the Allow Open Amount dropdown to Yes. If using this feature, you have the ability to set a maximum and/or minimum amount (Open Amount Min Value and Open Amount Max Value options) that the customer can enter into the amount field. Additionally, you can use set prices and open amounts concurrently. This will add an Other Amount option to the dropdown on the product page, which will generate an open field when selected.

5. Set the Gift Card options in the Gift Card Information tab. The following options
are available:

Card Type - Determines the type of the Gift Card. The possible values are:
o VirtualThe Gift Card information will be sent by email (the order will require the email address of the recipient). No shipping information will be necessary. o PhysicalThe Gift Card will be shipped (the order will require the shipping address of the recipient). No email will be sent to the recipient. 49

Part IIIMarketing & Promotion Features

o CombinedThe Gift Card will be shipped and sent by email (the order will require both the shipping address and email address of the recipient)

RedeemableDetermines whether or not the account that will be created for

this Gift Card will be redeemable (able to be transferred to Store Credit) upon creation.

Lifetime (days)Determines the expiration date for Gift Card Account

created for this Gift Card. The accounts will expire X number of days after the Gift Card is purchased. If you do not wish to set a default lifetime, leave this field blank.

Allow Gift MessageDetermines whether the customer purchasing the Gift

Card can add a message that will be sent to the recipient of the card (via email and/or with the shipment of the physical Gift Card).

Email TemplateSelect the template of the email that will be sent when the
Gift Card Account is created.

6. Fill in the remaining product information (name, SKU, categories, related products,
etc.) as you would for a Simple Product.

7. Click Save in the top right of the page.

Purchasing gift cards

Gift Card products have several features in addition to a typical Simple or Virtual Product. Most notably is the price, which is configurable. Depending on the price settings you entered in the Prices tab, there will either be a dropdown containing set prices, an open field, or a combination (in this case, the dropdown will contain an Other Amount option, which will create an open field when selected). All amounts are in the display currency currently used in that store, but the actual amount of the Gift Card is converted to the base currency once added to the cart. In addition to this is the Sender Name (and Sender Email if the Gift Card is Virtual or Combined) and Recipient Name (and Recipient Email if the Gift Card is Virtual or Combined). If the customer is logged in when viewing this page, the Sender Name (and Sender Email, if applicable) will be pre-populated. If you have selected to allow messages, there will also be a Message text area. If multiple Gift Cards are purchased in one order, and the Gift Card is Virtual or Combined, then all the corresponding Gift Card codes will be sent to the recipient in one email. For all Gift Card types, the generated account codes will be shown in the order information page in the admin. This will allow you to retrieve the code to place it on the physical gift card, if necessary.

50

Chapter 9Gift Cards

If an order containing a Gift Card product is canceled or refunded, you will need to manually cancel the Gift Card account. You can either delete the account entirely, or simply deactivate it.

Paying with gift cards

Gift Card accounts can be redeemed in the shopping cart, similar to the manner in which a coupon is applied to an order. There is a block that contains a field for entering the Gift Card code, and a button used to apply that account to the items in the cart. Additionally, this block contains a Check Gift Card status and balance link. This navigates the customer to a page where they can enter their Gift Card code(s) and view the remaining balance. Multiple Gift Cards accounts can be applied to a shopping cart. Each time a Gift Card is applied, the amount is displayed in the order totals block, subtracting from the grand total. The full balance of each Gift Card will be subtracted from the shopping cart total. Multiple Gift Cards will be applied in ascending order, meaning the accounts with the smallest remaining balances will be applied first, until the customer runs out of cards, or until the grand total becomes zero. If the grand total becomes zero, the last account that actually applies to the cart will receive a partial deduction, and any cards that have not applied to the cart will not receive a deduction. The actual deductions occur only once the order is placed. Orders paid with Gift Cards cannot be refunded. Credit Memos will not be available. To refund such an order, cancel it and manually increase the balance of the Gift Card, or the customers Store Credit account, appropriately. If an order is partially paid with Gift Cards, the amount paid with Gift Cards cannot be refunded. Again, this amount should manually be added to the Gift Card or customers account.

Redeeming gift cards

In addition to using a Gift Card balance during checkout, the balance can be transferred to a customers Store Credit (if you have enabled this feature). More information about this is available in the Store Credit in My Account section in the next chapter.

51

Part IIIMarketing & Promotion Features

10 Reward Points and Loyalty Programs

The Magento Reward Points System allows an online merchant to implement unique programs designed to enhance user experience and increase customer loyalty. Points are awarded based on a wide range of transaction and customer activities, with the ability for the merchant to control point allotment, balance, and expiration. Customers can redeem points toward purchases, based on a conversion rate between points and currency that is set up by the merchant.

[PE][EE]

10.1 Configuring Reward Points

There are some configuration settings that must be completed relating to Reward Points.

To configure reward points:

1. Choose SystemConfiguration and select the Reward Points tab in the left
column.

2. In the Reward Points section, the following options are available:

Enable Reward Points FunctionalitySelect Yes in order to activate this
feature.

Enable Reward Points Functionality on FrontIf this functionality is

enabled, customers will be able to earn points through their activities, and redeem them during the checkout process. If disabled, only admin users will be able to assign and redeem points on behalf of customers.

Customers may see Reward Points HistoryIf enabled, customers will be

able to see a detailed history of each accrual, redemption, and expiration of Reward Points in the My Account interface.

Min Reward Points Balance to be able to RedeemRequires customers to

achieve a minimum point balance before they are able to redeem them on orders. If left blank, there will be no minimum limit.

Cap Reward Points Balance toPrevents customers from accruing more than
this maximum points balance. If left blank, there will be no maximum limit.

Reward Points Expire (in days) Sets a limit in which customers must
redeem Reward Points before they expire. Each batch of points which are earned during separate activities will have a separate expiration, and the expiration limit will display for each batch in the Reward Points history in the frontend (if enabled) and admin. If left blank, there will be no expiration limit.

52

Chapter 10Reward Points & Loyalty Programs

Reward Points Expiry CalculationSelecting Static defines the date of

expiration at the time when the points are earned based on the expiration limit defined above. If the expiration limit is changed, the expiration date for existing points will not change. Selecting Dynamic does not define a date of expiration. Instead, points will periodically be checked for expiration. This allows for the editing of the expiration limit to affect existing points.

Landing PageDefines the CMS page which will be used to display more
information to customers about Reward Points. A default template for this CMS page is included, and links to this CMS page appear at various frontend locations where points can be earned. In the Acquiring Reward Points by Customers section, the amount of Reward Points earned for various customer activities is defined. If points are assigned for any of these activities, a message will be displayed on the frontend in the corresponding section informing customers about the amount of points available for completing the action. Points earned for placing orders or qualifying for Shopping Cart Price Rules are not defined in this section, and will be discussed in more detail later in this chapter. The following options are available:

RegistrationDefines the amount of points earned when a customer registers. Newsletter SignupDefines the amount of points earned when a customer
signs up for the newsletter. This is not available for guests who sign up for the newsletter. Additionally, if a customer unsubscribes, and subscribes again, they will not receive points a second time.

Converting Invitation to CustomerDefines the amount of points earned for

the inviter when an invitation has been accepted by the invitee, resulting in the creation of a new customer account.

Invitation to Customer Conversion Qty LimitLimits the number of

invitation conversions that can be used to earn points per inviter. If left blank, there will be no maximum limit.

Converting Invitation to OrderDefines the amount of points earned for the

inviter when an invitee has accepted the invitation and placed an initial order.

Invitation to Order Conversions Qty LimitLimits the number of order

conversions that can be used to earn points per inviter. If left blank, there will be no maximum limit.

Review SubmissionDefines the amount of points earned when a review has

been submitted and approved by an admin user.

Rewarded Reviews Submission Qty LimitLimits the number of reviews

that can be used to earn points per customer. If left blank, there will be no maximum limit.

New Tag SubmissionDefines the amount of points earned when a tag has
been submitted and approved by an admin user.

Rewarded Tag Submission Qty LimitLimits the number of tags that can be
used to earn points per customer. If left blank, there will be no maximum limit. 53

Part IIIMarketing & Promotion Features

In the Email Notification Settings section, there are two email notifications related to Reward Points which can be managed: balance updates and expiration notifications. The following options are available:

Email SenderDetermines the sender of both the balance update and

expiration notification emails.

Subscribe Customers by defaultDetermines the default subscription status

of customers for both balance update and expiration notifications emails.

Balance Update EmailDetermines the template of the email that customers

receive when there is an update to their points balance.

Reward Points Expiry Warning EmailDetermines the template of the email

that customers receive when the expiration warning limit has been reached for a batch of points.

Expiry Warning before (days)Defines the number of days prior to the

expiration of point at which the expiration notification will be sent. If left blank, or if the warning limit is greater than the expiration limit (defined in the section above), no expiration notifications will be sent.

Reward exchange rates

Reward Exchange Rates determine the amount of points that are earned for orders placed based on the order amount, as well as the amount of monetary credit available when points are redeemed in an order. Different exchange rates can be applied to different websites and different customer groups.

To manage exchange rates,

1. Choose CustomersReward Exchange Rates. This page contains a grid listing

all existing exchange rates.

2. To create a new exchange rate, click Add New Rate in the top right of the page. If
multiple exchange rates apply to the same customer due to an overlap of websites and/or customer groups, exchange rates will use the following priority: Specific website and specific customer group All Websites and specific customer group Specific website and All Customer Groups All Websites and All Customer Groups

The Direction determines which type of transaction the exchange rate will
define.

Points to Currency defines the amount of points that can be redeemed for an
amount of monetary credit towards an order.

54

Chapter 10Reward Points & Loyalty Programs

Enter the amount of points in the first Rate field, and the amount of monetary
credit in the second Rate field. When converting points to currency, the amount of points cannot be divided. For example, if 10 points converts to $2.00, points must be redeemed in groups of ten. Therefore, 25 points would redeem for $4.00, with 5 points remaining in the customers balance.

Currency to Points defines the monetary amount of an order that will earn the
customer an amount of points. Enter the monetary amount in the first Rate field, and the amount of credit in the second Rate field. When converting currency to points, the amount of points again cannot be divided, and any currency remainder will be rounded down. For example, if $2.00 converts to 10 points, points will be earned in groups of $2.00. Therefore, a $7.00 order would earn 30 points, and the remaining $1.00 would be rounded down. The monetary amount of the order is defined as the amount which the merchant receives, or the grand total minus shipping, tax, discounts, store credit, and gift cards. The points will be earned the moment when there are no non-invoiced items in the order (all items are either paid or canceled). If an admin user does not want to allow customers to earn Reward Points for canceled orders, those points can be manually deducted via the Manage Customers page. This will be discussed in more detail later in the chapter. For either Direction, the monetary amount will equal the base currency of the website.

10.2 Awarding and Redeeming Reward Points

Shopping cart price rules
Points can be rewarded to customers who apply for Shopping Cart Price Rules. They can be rewarded as the only action of the price rule, or in conjunction with a discount. In order to add Reward Points to a price rule, navigate to PromotionsShopping Cart Price Rules and select an existing price rule or click Add New Rule. Select the Actions tab in the left column, and enter the amount of points in the Add Reward Points field. When the price rule is activated, a message in the shopping cart will alert customers about the amount of points they can earn by placing the order.

Customer balances
Reward Points balances can be managed by admin users per customer. To do so, navigate to CustomersManage Customers, select a customer from the grid, and select the Reward Points tab in the left column. From this view, the admin user can view and edit (add to or subtract from) the customers points balance per website, and edit the customers email notification status. Additionally, this view includes a detailed history of each accrual, redemption, and expiration of points, including timestamp, exchange rate, and reason for balance change.

55

Part IIIMarketing & Promotion Features

If enabled on the frontend, customers can also view the details of their points balance. In the My Account interface, there is a Reward Points tab. This tab contains information including the balance, current exchange rate, maximum and minimum limits, subscription status (with ability to edit), and (if enabled) balance history. There is also a link to the Rewards Points landing page.

Redeeming points
Points can be redeemed by admin users and (if enabled) customers during the checkout process. In the Payment Method section, a Use my Reward Points checkbox will appear above the enabled payment methods. The available points and monetary exchange rate will be included. If the available balance is greater than the order grand total, no additional payment methods will be required. The amount of Reward Points applied to the order will display among the order totals, subtracting from the grand total, similar to Store Credit and Gift Cards. If Reward Points are used in conjunction with Store Credit and Gift Cards, Reward Points will be deducted first, and Store Credit or Gift Cards will only be deducted if the order total is greater than the redeemable amount of Reward Points.

Refunding to reward points

Orders placed with Reward Points can be refunded to the Reward Points balance up to the amount redeemed in the order. On the New Credit Memo page, there is a field in which the amount of points that will be applied to the customers balance can be entered. By default, the value will be pre-populated with the full amount of points used in the order.

56

Chapter 11Private Sales

11 Private Sales
This chapter concludes the discussion of Private Sales functionality, which consists of the following: Invitations Email messages sent out with a link to create an account in the store. If desired, the ability to create an account can be restricted to those who receive an invitation. Category Permissions - Feature allowing the administrator to disable browsing, price displays, or adding to cart for different categories based on customers groups. Discussed in chapter 1. Website Restrictions - Feature allowing the administrator to disable access to the website by redirecting to a landing page, login page or registration page. Discussed in chapter 1. Events - Sale restrictions based on a start and end date. Adding to cart will only be possible between these dates.

[EE]

11.1 Invitations
There are some configuration settings that must be completed relating to Invitations.

To enable and configure invitations:

1. Choose System Configuration and select the Invitations tab in the left column.
Enable Invitations Functionality - Determines whether the Invitations module
is enabled.

Referred Customer GroupDetermines the customer group of the invitee.

Same as Inviter means invitees will automatically have the same customer group as the customers who invited them. System Configuration Default means invitees will automatically have the customer group that is selected as the default. This setting can be changed by clicking on the Customer Configuration tab in the left column, selecting the Create New Account Options section, and editing the Default Group dropdown.

New Accounts RegistrationDetermines whether the ability to create a new

account is By Invitation Only, or Available to All. If you select the former, the new account registration section will not appear on the login page, and invitees must follow the link in the Invitation email in order to create an account.

Allow Customers to Add Custom Message to Invitation Email

Determines whether there will be a field in the Invitation form in which the inviter can add a custom message which will be sent to the invitee via email. This does not affect the administrator's ability to add a message to an Invitation.

57

Part IIIMarketing & Promotion Features

Max Invitations Allowed to be Sent at One TimeDetermines the maximum

number of invitations that the inviter can send at once. A different invitation is sent out to each email address that the inviter includes in the form. This limit will help prevent inviters from bottlenecking your server by sending out large numbers of Invitations at once, and reduces the ability to use Invitations for spamming.

Customer Invitation Email SenderDetermines the sender of the email that

invitees receive when an Invitation email is sent.

Customer Invitation Email TemplateDetermines the template of the email

that invitees receive when an Invitation email is sent.

2. When you have completed these settings, click Save Config in the top right of the
page.

Invitations frontend
If enabled, customers can send and view Invitations from My Account. There will be a My Invitations tab in the left column. The page shows a list of all past Invitations sent, including the email address of the recipient, and the current status (Sent, Accepted, or Canceled). It also includes a Send Invitations button, which redirects to the Invitation form. This form contains a field for the email address of each recipient (the number of these fields is determined in the configuration above) and (if enabled) a message text area. When the Send Invitations button is clicked in the form page, the invitation email will be sent to the recipients. If a recipient email belongs to an existing customer in the system, the invitation email will not get sent to that email, and no record will be created in the admin. Customers can also send invitations using the Send Invitations link in the store header. The invitation email includes a link to the customer account registration form on the Magento frontend. The customer email field will be auto-populated.

Invitations backend
The admin has the ability to send and view Invitations as well. To do so, navigate to Customers Manage Invitations. This page contains a grid listing all Invitations which have been sent. If one Invitation was sent to multiple recipients, a separate record will be created for each recipient.

58

Chapter 11Private Sales

To create a new Invitation, click Add Invitations in the top right of the page. Similar to the customer Invitation feature, there will be an email and message field. However, there is an unlimited number of recipient email addresses that can be entered into the email text area, and there will always be a message text area regardless of the configuration setting. In addition to these fields, you can select from which Store View the Customer Invitation email will be sent (and where the link in the email will redirect), and to which customer group the invitee will belong if they create an account (this supersedes the configuration setting). When you have completed the Invitation form, click Save in the top right of the page. The Customer Invitation email will be sent and you will be redirected to the Invitation grid. To view past Invitations, click on a record in the grid. This page will show some basic information about the Invitation, such as the timestamp it was sent, the email address of the recipient, the current status (Sent, Accepted, or Canceled), the customer group of the invitee, and the link which was sent to the invitee. The message, if one was included, will be displayed in a text area, allowing you to edit the message, save it by clicking the Save Invitation Message button, and resend the Invitation by clicking the Resend button. To cancel the invitation, click the Cancel button. This will change the status to Canceled and the link in the email will no longer redirect to the customer account registration form. If the invitee has created a customer account, the account details will be listed in this page (including a link to the customer account in the admin). If the inviter was a customer (the invitation was not sent by an administrator), the account details will be listed in this page as well (including a link to the customer account in the admin). Lastly, the status history can be viewed by clicking the Status History tab in the left column. This will show the timestamp of each status change (Sent, Accepted, or Canceled).

Invitations reports
You can view several reports about Invitations.

To view invitation reports:

1. Choose ReportsInvitations. 2. The following reports are available:

59

Part IIIMarketing & Promotion Features

GeneralThis report summarizes Invitation information for the designated

scope and period of time. The scope can be defined in the Show Report for drop-down at the top of the page. There will be one line for each Period. A Period can be a Day, Month, or Year, and is defined in the Show by dropdown at the top of the page. The number of Periods in the report depends on the date range designated at the top of the page. For each Period, you can see the total number of Invitations sent, accepted, and canceled, as well as the percentage of sent Invitations which have been accepted, and the percentage of sent Invitations which have been canceled.

CustomersThis report summarizes Invitation information by customer for the

designated scope and period of time. The scope can be defined in the Show Report for drop-down at the top of the page. There will be one line for each Period. A Period can be a Day, Month, or Year, and is defined in the Show by drop-down at the top of the page. The number of Periods in the report depends on the date range designated at the top of the page. For each Period, you can see a list of all customers who have sent Invitations, including their ID, name, email, and customer group. Additionally, you can see the number of Invitations they have sent in that period, and the number of those Invitations which have been accepted.

Order Conversion RateThis report summarizes Invitation and sales

information for the designated scope and period of time. The scope can be defined in the Show Report for drop-down at the top of the page. There will be one line for each Period. A Period can be a Day, Month, or Year, and is defined in the Show by drop-down at the top of the page. The number of Periods in the report depends on the date range designated at the top of the page. For each Period, you can see the number of Invitations which have been sent, the number of the those Invitations which have been accepted, the number customers who have completed an order after accepting an Invitation, and the percentage of Invitations sent which have led to a completed order.

11.2 Events
There are some configuration settings that must be completed relating to Events.

To enable and configure events:

1. Choose System Configuration, click the Catalog tab in the left column. 2. In the Catalog Events panel, configure events by setting the following values:
Enable Catalog Events FunctionalityDetermines whether the Events
module is enabled.

60

Chapter 11Private Sales

Enable Catalog Event WidgetDetermines if the Event Widget is displayed

in the frontend. This is a static block containing information about Events in your site. Sometimes this feature is referred to as Lister Block. There is more information about the Event Widget below.

Number of Events to be Displayed on CategoryDetermines the number of

Events that will display in the Event Widget on the category pages.

Number of Events to be Displayed on CMS PagesDetermines the number

of Events that will display in the Event Widget on CMS pages, such as the home page.

3. When you have completed these settings, click Save Config in the top right of the
page.

Events backend
Events can be created and viewed by navigating to CatalogCategoriesCatalog Events. This page contains a grid listing all Events that you have created. To create a new Event, click Add Catalog Event in the top right of the page. You will need to first select the category for which the Event will be created. Click on the desired category from the category tree. Only one event can exist for a given category at one time, so any categories that already have an associated Event will be disabled in the category tree. When you click on a valid category, you will be redirected to the next page. This page contains fields for the start and end date of the event, the image which will be displayed in the Event Widget, the sort order in the Event Widget, and checkboxes for displaying a countdown ticker block on the category page and/or product page (of products associated to the given category). This page also displays the category for which you are creating the Event, which will link back to the previous step if clicked (so you can select a different category). When you have completed the Event settings, click Save in the top right of the page. You will be redirected to the Event grid. To edit an existing Event, select it from the Event grid. This page is similar to creating a new Event. One difference is that the category link will no longer link back to the category tree to allow you to select a different category. Instead, it will link to the CatalogManage Categories page for that category. Another difference is that the Status of the Event will display. This status is solely dependent upon the start and end date of the Event. Future Events are Upcoming, current Events are Open, and past Events are Closed. In CatalogManage Categories, there will be a link to the Events page. This link is a button which will only display for existing categories, so it will not display when creating a new category. If the category already has an associated Event, the button will say Edit Catalog Event and will link to the edit page of the given event. If the category does not yet have an associated Event, the button will say Add Catalog Event and will link to the second step of the create new event process (with the given category prepopulated).

61

Part IIIMarketing & Promotion Features

Events frontend
If the Event Widget is enabled, it will display on the home page and on category pages. It will display Open Events first, sorted by end date. If two or more Events share the same end date, sorting will be based upon the sort order entered in the steps above. Open Events include a countdown ticker. After all Open Events, the widget will display Upcoming Events, sorted by start date, then sort order. Upcoming Events include the start and end date. If the Category Page ticker has been enabled for a given Event, the ticker block will display at the top of the product listing page. If the Product Page ticker has been enabled, the ticker block will display at the top of the product view page (of products associated to the given category). Like the Event Widget, the ticker block displays a countdown ticker for Open Events and the start and end date for Upcoming Events. If an Event is Closed, the ticker block will indicate this (and includes the start and end date, similar to Upcoming Events). By default, products in Upcoming or Closed Events are not sellable. The Add to Cart button will not display in the product listing page or the product view page. To restore the Add to Cart button for a Closed Event, the Event must be deleted. However, if a product is associated to another category, which has no selling restrictions, then the Add to Cart button will display in the product view page. Similarly, the ticker block will not display in the product view page if that product is associated to another category which has no selling restrictions.

11.3 Category permissions

Category Permissions can be used in conjunction with Invitations and Events to create private sales. To learn more about Category Permissions, refer back to chapter 1.

11.4 Website restrictions

Website Restrictions can be used in conjunction with Invitations and Events to create Private Sales. To learn more about Website Restrictions, refer back to chapter 1.

62

12 Gift Registries

[EE V1.9]

This chapter introduces Magento Enterprise Editions Gift Registry functionality. Enterprise Editions gift registries enable your registered customers to create a gift registry for a special occasion and to notify friends and family of the registry. Friends and family can purchase items from the gift registry and Magento keeps track of the items bought and quantities remaining. The store administrator can also perform basic operations like viewing or sharing customers gift registries, adding items from the customers shopping cart to one of the registries created by the customer, updating gift registry item quantity, or deleting a customers gift registry. In the frontend, after a customer creates a gift registry, items can be added to it either from the customers shopping cart or from the wishlist, and then the gift registry list can be shared with others. A gift registry recipient can in turn open a gift registry by either following the emailed link or searching for it by the gift registry owners name, email, or gift registry ID. Gift registry recipients who want to purchase a product from the gift registry can add an item from the gift registry list directly to their shopping cart. When an order is placed for gift registry items and the gift registry is updated to reflect the quantity of items fulfilled.

Store Admin

Enables gift registry functionality Creates registry types and attributes

Creates gift registry for an upcoming occasion Adds items to their gift registry Customer/Gift Shares gift registry with friends and family
registry owner

Gift registry recipient

Receives email notification Goes to gift registry (by link from email or registry search on site) Places an order for an item on the registry

Magento

Updates gift registry item counts Notifies gift registry owner

Figure. General Gift Registry Work Flow.

63

Part IVCustomer & Order Management Features

Chapter Quick Reference

The table below lists some of the most common tasks for using EEs gift registry functionality and where to go in the Admin Panel to perform them. The sections that follow provide step-by-step instructions on each. Table 5. Enterprise Edition Gift Registry Administration Tasks Quick Reference.
TASK To enable gift registries To configure gift registry notification emails To customize gift registry notification emails To customize gift registry types available To add a gift registry search widget to the website To view a customers gift registry To manage items in a customers gift registry To share a customers gift registry To delete a customers gift registry ADMIN MENU SystemConfigurationGift Registry tab General Options panel SystemConfigurationGift Registry tab SystemTransactional Email CustomersGift Registry CMSWidgets CustomersManage CustomersGift Registry tab CustomersManage CustomersGift Registry tab CustomersManage CustomersGift Registry tab CustomersManage CustomersGift Registry tab

12.1 Administering Gift Registries

Before customers can start using the Gift Registry module, the store administrator needs to complete some general setup. This section describes the setup to be done in the Magento backend. This includes enabling the module itself, setting the gift registry notification process, and creating gift registry types and attributes.

Enabling and Configuring Gift Registries

To enable gift registries:

1. Choose SystemConfiguration. Select the Gift Registry tab on the left. 2. In the General Options panel, enable gift registries by setting the following values:
Enable Gift RegistryDetermines if gift registries are available on your
Magento stores. o YesEnables the gift registry functionality for the selected store view and customers registered for the selected store view are provided with a Gift Registry tab on their account page after the gift registry configuration settings are saved in the backend. o NoGift registries are not available on the frontend website.

64

Chapter 12Store Credit

Max Recipients LimitSet the number of recipients that a customer creating a

gift registry can add to her or his gift registry. A recipient is the person who the gift registry owner shares his or her gift registry list with. In the frontend, when a customer creates a gift registry, the Add Recipient button is available as long as the number of recipients added does not exceed the value specified in the Max Recipients Limit field.

3. Click the [ Save Config] button to save your settings.

After the store administrator enables the module in the backend configuration, a warning message appears stating that one or more cache types are invalidated. The store administrator needs to follow the link from the message or click SystemCache Management on the Magento top menu, select the check box for the invalidated cache type, and click the Submit button. After the cache is refreshed, the Gift Registry submenu appears under the Customers menu in the backend. Once the Gift Registry functionality is enabled, the Gift Registry tab becomes available for customers in the My Account menu on the customers page in the frontend. When it is required, the Gift Registry functionality can be disabled by setting the Enable Gift Registry field to No (SystemConfigurationGift RegistryGeneral Options). However, note that the Gift Registry submenu will disappear from the Customers menu in the backend only after the cache is again refreshed.

To configure gift registry email notifications:

As part of the gift registry functionality, Magento will send email notifications in response to several events in the gift registry work flow. Magento sends the following gift registry-related emails: To the gift registry owner upon successful creation of the gift registry. Email contains a link to the newly created gift registry that can be shared with friends and family Optionally, if the gift registry owner wishes to send notifications from the store, to the friends and family (gift registry recipients) of the gift registry owner. Email contains a link to the gift registry. To the gift registry owner when updates are made to the gift registry. Email indicates that items have been purchased but does not specify by whom. Magneto has pre-defined templates for each of these emails that can be modified and customized by the store administrator in the same way all other email templates can be in Magento in SystemTransactional Emails.

1. Choose SystemConfiguration. Select the Gift Registry tab on the left. 2. In the Owner Notification panel, configure the emails that will sent to gift registry
owners notifying them that their gift registry has been created by setting the following values:

65

Part IVCustomer & Order Management Features

Email TemplateSelect the Gift Registry Owner Notification template to use

to notify the gift registry owner that the gift registry has been successfully created. Below is an example of the default template:

Email SenderSpecify an email sender from whom a gift registry owner will
be sent an email notifying him/her that their new gift registry was created.

3. In the Gift Registry Sharing panel, configure the emails that will sent to notify gift
registry recipients that a gift registry has been shared with them by setting the following values:

Email TemplateSelect the Gift Registry Sharing template to use to notify

recipients specified by the gift registry owner that their gift registry has been shared. After a gift registry owner adds gift registry recipients and clicks the Share Gift Registry button on his or her Share Gift Registry page, each recipient from the list receives an email. Below is an example of the default template:

Email SenderSpecify an email sender from whom a gift registry recipient will
be sent an email notifying him/her that a gift registry has been shared with them.

66

Chapter 12Store Credit

Max Emails Allowed to be Sent at One TimeSet the maximum number of

email notification letters to be sent to recipients with whom a gift registry owner can share his or her gift registry.

4. In the Gift Registry Update panel, configure the emails that will sent to notify the
gift registry owner of changes to the gift registry by setting the following values: (Note: this capability cannot currently be turned off)

Email TemplateSelect the Gift Registry Update template to use to notify the
gift registry owner that their gift registry has been updated (when items are purchased). When any of the gift registry recipients places an order for an item from the gift registry, the gift registry owner receives an update email letter containing the information about the gift registry item and its quantity ordered. In this case, the gift registry owner does not know the name of the person who has placed an order. Below is an example of the default template:

Email SenderSpecify an email sender from whom a gift registry recipient will
be sent an email notifying him/her that a gift registry has been shared with them.

5. Click the [ Save Config] button to save your settings.

Customizing Gift Registry Types

After the Gift Registry configuration is complete, the administrator needs to create gift registry types and attributes in the backend. Gift registry types denote special events that the gift registry can be created for. These can be a wedding, a birthday, an anniversary, a child birth, or any other special occasion. By default, Magento provides gift registry types for the following special events: Baby Registry Birthday Wedding

67

Part IVCustomer & Order Management Features

With the pre-defined gift registry types, Magento provides a number of pre-defined attributes/fields. The store administrator can choose to modify or delete some of them or to add a number of new attributes and attribute options. A gift registry attribute provides additional information about the gift registry owner, the event, its time and place, or any other gift registry-specific information. When the customer is creating a new gift registry on the frontend, these attribute fields will be presented to him/her to fill in while creating the registry.

To create or modify gift registry types:

1. Choose CustomersGift Registry. A list of available gift registry types is

displayed.

2. Click the [+ Add Gift Registry Type] button to create a new gift registry type, or
click on one of the currently available gift registry types to edit it.

3. In the General Information panel, configure the gift registry type by setting the
following values:

CodeSpecify the name for the gift registry type that will be used in the system.
This must be unique and can contain only letters, numbers and underscores.

LabelSpecify the name for the gift registry type that will be displayed on the
frontend.

Sort OrderAssigns to a gift registry type the order in which it will appear on
the Create Gift Registry page on the frontend.

Is ListedDetermines if a gift registry type is available (is listed) on the

frontend.

4. Click the Attributes tab 5. Click the [+ Add Attibute] button to create a new attribute, or click on one of the
currently available attributes to edit it.

6. In the Attributes tab, create or modify attributes by setting the following values:
CodeSpecify the name for the attribute that will be used in the system. This
must be unique and can contain only letters, numbers and underscores.

Input TypeDefines the type of input allowed for a gift registry attribute. A gift
registry attribute can have a number of options. For example, for a gift registry type Wedding, the administrator can create a gift registry attribute Role and add two attribute options Bride and Groom. When creating a gift registry of a specific gift registry type, in the frontend the customer will make her or his choice on the attribute options depending on the value that the store administrator has specified in the Input Type field for a specific gift registry attribute option. The store administrator can choose between the following predefined custom and static input types in this field: o Text

68

Chapter 12Store Credit

o Select For Select input types, use the [+Add Option] button to create the dropdown list of options o Date o Country o Event Date For Event Date input types, the Is Searchable, Is Listed and Date Format fields appear. The Is Listed field specifies whether there will be a column of values of this attribute in the grid of gift registries in the frontend. The Is Searchable field, specifies whether the gift registry attribute is available in the gift registry advanced search. In the frontend, such attribute is displayed under the Type Specific Options group. o Event Country For Country or Event Country input types, the Show Region field appears. Indicate whether the list of countries or regions related to the country selected by the customer will be available for selection in the frontend. o Event Location o Role

Attribute GroupSelect the information group that the attribute will appear in
on the frontend. On the frontend, when a customer creates a gift registry, related gift registry attributes appear under any of the following attribute groups selected by the store administrator: o Event Informationgroups all gift registry attributes that add the information about the gift registry event, its time, place, etc. o Gift Registry Propertiescombines all attributes that add information directly about the gift registry. o Privacy Settinglists the attributes that add information about the gift registry event privacy.

69

Part IVCustomer & Order Management Features

o Recipients Informationgroups the attributes that provide information about the person who creates a gift registry.

LabelSpecify the attribute name that will be displayed to the customer on the
Create Gift Registry page in the frontend.

Is RequiredChoose whether the attribute with custom options, if there are

any, is required to be specified by the customer in the frontend. The customer will not be able to save a gift registry if the attribute set to be a required one is not specified on the Create Gift Registry page.

Sort OrderDefine the order of the gift registry attribute to be displayed to the
customer on the Create Gift Registry page in the frontend. This parameter is relevant when there is more than one attribute created for a gift registry type.

7. Click the [ Save] button to save your attribute.

Adding a Gift Registry Search Widget to the Frontend

Magento users can search for an existing gift registry in a web store. This functionality becomes available if the store administrator creates a widget, which adds a Gift Registry Search section in the specified place of the web store page. In the frontend, the customer searching for a gift registry can select the search type in the Search By field. Depending on her or his choice, a number of fields to be filled out appear. These are gift registry owner first and last names, email, the type of gift registry, or the gift registry ID. After clicking the Search button, the customer is provided with the search results on the Gift Registry Search page. If the search returns no results, the customer can try searching again by using the search options on the page.

70

Chapter 12Store Credit

To add a gift registry search widget to your store:

1. To create the widget instance, choose CMSWidgets. 2. Click the [+ Add New Widget Instance] button. 3. In the Settings panel, create the widget by setting the following values:
TypeSelect Gift Registry Search from the drop down. Design Package/ThemeSelect the theme being used by the store you wish
this widget to show up on.

4. Click the [ Continue] button. 5. In the Frontend Properties panel, enter the remainder of the basic widget info:
Widget Instance TitleName for this widget Sort OrderOrder in which widget should appear, relative to other elements
in the block in which it appears.

6. In the Layout Updates panel, specify the pages and block in which the gift registry
search widget should appear by setting the following values:

Display OnIndicate the specific pages or the types of pages on which the gift
registry search widget should appear.

Block ReferenceIndicate the blocks in your template in which the widget

should appear. Depending on the template, options my vary, but are typically Left Column and Right Column.

7. Click the Widget Options tab. 8. In the Widget Options panel, specify the ways in which visitors to your website
can search for gift registries.

Quick Search Form Types include:

o Recipient Name Search o Recipient Email Search o Gift Registry ID Search

9. Click the [ Save] button to save your widget. 10. Refresh the Magento page cache if necessary to see the widget appear on the
frontend.

12.2 Managing Gift Registries

After the Gift Registry module is enabled and set up and all required gift registry types and attributes are created, the store administrator can manage gift registry records by monitoring them, making some changes to them, sharing gift registries, or delete them on gift registry owners request. 71

Part IVCustomer & Order Management Features

To view a customers gift registry:

1. Choose CustomersManage Customers. 2. Click on the customer whose gift registry youd like to view. 3. Click on the Gift Registry tab. You will see all of the gift registries created by that
customer.

4. Click on the desired gift registry.

To manage items in a customers gift registry:
If desired, you can add items in the customers shopping cart to a customers gift registry from the Admin Panel. You can also change quantities and delete items.

1. Choose CustomersManage Customers. 2. Click on the customer whose gift registry youd like to view. 3. Click on the Gift Registry tab. You will see all of the gift registries created by that
customer.

4. Click on the desired gift registry. 5. To add items from the customers shopping cart to their gift registry: 6. In the Shopping Cart Items section, locate the item to add to the gift registry and
check the checkbox.

7. From the Actions dropdown, select Add to Gift Registry and click the [Submit]
button.

8. To change quantities in the gift registry: 9. Enter the new quantity in the Gift Registry Items section and click the [Update
Items and Qtys] button

10. To delete an item, set its quantity to 0 or select Remove Item from the Actions
dropdown for that item.

To share a customers gift registry:

If desired, you can add items in the customers shopping cart to a customers gift registry from the Admin Panel. You can also change quantities and delete items.

1. Choose CustomersManage Customers. 2. Click on the customer whose gift registry youd like to view. 3. Click on the Gift Registry tab. You will see all of the gift registries created by that
customer.

4. Click on the desired gift registry.

72

Chapter 12Store Credit

5. In the Sharing Information area provide the following information:

o EmailsEnter the email addresses provided by the gift registry owner. Multiple email addresses must be separated with a comma. o Send FromSelect the store view from which the gift registry recipients will receive an email letter with a URL link to the customers gift registry. o MessageIf desired, type a message that a gift registry recipient will see in the received email letter

6. Click the [Share Gift Registry] button.

Upon sharing a gift registry list, gift registry recipients whose email addresses are specified in the Emails field will receive an email notification with a link to customers gift registry item list and to the store where the recipients can purchase the items from the gift registry list.

To delete a customers gift registry:

1. Choose CustomersManage Customers. 2. Click on the customer whose gift registry youd like to view. 3. Click on the Gift Registry tab. You will see all of the gift registries created by that
customer.

4. Click on the desired gift registry. 5. Click the [x Delete Registry] button to permanently delete the gift registry. Note
that this operation cannot be reversed.

73

PART IV CUSTOMER AND ORDER MANAGEMENT FEATURES

13 Store Credit
This chapter introduces Store Credit functionality, which essentially is a balance associated to a customer account. Store Credit can be used by customers for paying in the store, and can be used by administrators for refunding money to customers. Additionally, Gift Card balances can

[PE][EE]

be transferred to Store Credit, saving customers from having to manually enter the Gift Card code on subsequent purchases.

13.1 Configuration of store credit

There are some configuration settings that must be completed relating to Store Credit. In order to do so, navigate to SystemConfiguration, click the Customer Configuration tab in the left column, and select the Store Credit Options section. The following settings are available:

Enable Store Credit Functionality Determines if the Store Credit module is

enabled. Disabling it will remove the Store Credit tab from the My Account section in the frontend, as well as in the Manage Customers page in the admin.

Show Store Credit History to Customers - Determines if the balance history

of a customer's Store Credit is visible to the customer in their My Account page.

Store Credit Update Email Sender - Determines the sender of the email that
customers receive when their Store Credit balance is updated.

Store Credit Update Email Template - Determines the template of the email
that customers receive when their Store Credit balance is updated. When you have completed these settings, click Save Config in the top right of the page.

13.2 Managing store credit

The admin has the ability to view and edit a customer's Store Credit balance at any time. To do so, navigate to CustomersManage Customers, select a customer from the customer grid, and click the Store Credit tab in the left column. The first section on this page shows the current balance. If customer accounts are shared on the Global level, this section will be a grid listing the customer's balance in each Website.

75

Part IVCustomer & Order Management Features

The second section allows you to update the balance of the customer. The Update Balance field is where the change in balance should be entered. The amount here can be positive or negative, and will add to or subtract from the existing balance, respectively. If customer accounts are shared on the Global level, there will be a dropdown in which you choose the Website for which the balance will be updated. Additionally, there is a checkbox that allows you to send the Store Credit Update email to the customer, notifying them of the balance change. Checking this unlocks the Store View dropdown, which determines from which Store View the email will be sent. The third section displays the balance history, including a timestamp, a description of the action, and the balance change. Additionally, for some actions there is additional information available, like the order number on which Store Credit was applied. This section is in the form of a grid, allowing you to filter the records.

Refunding to store credit

While creating a Credit Memo, you have the ability to refund the amount to a customer's Store Credit. On the New Credit Memo page, there is a field in which you can enter the amount of the refund that will be applied to the customers Store Credit. This enables you to apply either the full or a partial amount of the refund to Store Credit.

Paying with store credit

In order to pay with Store Credit, a customer must be logged in during checkout. In the Payment Information step of the checkout process, a Use Store Credit checkbox will appear above the enabled payment methods. The available balance will be displayed in parentheses. If the available balance is greater than the order grand total, the enabled payment methods will disappear upon checking the box. In the Order Review step of the checkout process, the amount of Store Credit applied to the order will display among the order totals, subtracting from the grand total, similar to Gift Cards. The customers Store Credit balance will be deducted only once the order is placed. Orders paid with Store Credit cannot be refunded. Credit Memos will not be available. To refund such an order, cancel it and manually increase the balance of the customers account appropriately. If an order is partially paid with Store Credit, the amount paid with Store Credit cannot be refunded. Again, this amount should manually be added to the customers account.

76

Chapter 12Store Credit

Store credit in my account

A customer's My Account section includes a Store Credit tab. This page displays the current balance, as well as (if enabled in the Configuration page) the balance history. In addition to this, customers can apply a Gift Card account balance toward their Store Credit. There is a link in the Store Credit tab which redirects to the Gift Card tab (if the Gift Card is Virtual or Combined, the email sent to the recipient will also contain a link to the Gift Card tab). The customer can enter the Gift Card Code in the field, and click Redeem Gift Card to transfer the balance. In order for the balance to be transferrable, the Gift Card Account must be set to Redeemable.

77

Part IVCustomer & Order Management Features

14 Assisted Shopping

[EE V1.8+]

Magento Enterprise Editions assisted shopping feature allows merchants and their customer service representatives to better manage a customers shopping cart from the Admin Panel. Customer Service reps can see the contents of a customers shopping cart while they are on the phone with that customer and they can easily move items from the wishlist or recently viewed items list to the shopping cartall without having to create an order. They can also apply a coupon code to a cart from the backend.

To use the assisted shopping feature:

In order to use the assisted shopping feature on the backend, the customer must login or create an account so that their cart, wishlist and browsing history will be visible on the backend. To see and manage that customers cart:

1. Choose CustomersManage Customers. 2. Select a customer to edit from the list and then select the Shopping Cart tab on the
left.

3. Click the [Manage Shopping Cart] to go into the Assisted Shopping mode. 4. You will be able to see the customers shopping cart, apply a coupon code, as well
as be able to see: all products, customers wishlist, customers comparison list, recently compared products, recently viewed products, and customers last ordered products. Any of these products can be easily seen and added to the customers shopping cart using the [+ Add Selected Products to the Shopping Cart] button. As soon as they are added to the cart this way, the customer should also be able to see those items in his/her cart on the frontend simply by refreshing the page.

5. The customer can then continue browsing, checkout unassisted, or the customer
service representative can create the order by clicking the [ Create Order] button and proceeding to place the order for the customer.

The customer service rep can remove items from the cart by setting the quantity to 0 and updating the cart. But the customer service rep cannot move items from the cart to the wishlist or comparison list, the customer must do that themselves.

78

Chapter 14Order Archiving

15 Order Archiving

[EE V1.8+]

In order to speed up the performance on the backend when admin users are using the Admin panel to service customers and look up orders, Enterprise v1.8 also introduces the addition of order archiving functionality. Order archiving allows the merchant to set a time period after which orders and their related sales documents (invoices, credit memos, etc) are moved to an archive table. Archived orders are NOT deleted and are still available in the backend via the Admin Panel, but having the older, less frequently accessed orders moved out of the main order tables allows admin users to access the newest orders more quickly.

To enable order archiving:

1. Choose SystemConfiguration. Select the Sales tab on the left. 2. In the Orders, Invoices, Shipments, Credit Memos Archiving panel, you can
set the following values: Enable ArchivingYes enables archiving using the values below. No disables archiving and any values below are ignored. Archive Orders PurchasedAge (in days) of orders to be archived. Orders and their related documents older than this number of days will be moved to the archive table. Order Statuses to be ArchivedStatus of orders that can be archived. By default, orders flagged as complete and closed are set to be archive-able. You can expand this list to include more order statuses or reduce it to fewer.

3. Click the [ Save Config] button to save your settings

79

Part IVCustomer & Order Management Features

16 Customer & Address Attributes

[EE V1.9+]

Magento has many built-in customer data fields to support the order, fulfillment and customer management processes. But every business is different and many times additional fields are necessary. In previous versions of Magento, adding fields to the key customer forms on the website required getting your developers to extend the Magento code and/or change the theme files. In Enterprise Edition v1.9, weve added the ability to create and manage custom customer attributes and custom address attributes from the Admin Panel. With the Customer/Address Attribute functionality, the store administrator can create custom attributes to be displayed in the following areas of the backend and frontend: Create an Account page where a guest is registering for a customer account Account Information section of the customers account in the frontend Address Book section of the customers account in the frontend Billing Information section of the Checkout page for the registered customer Billing Information section of the Checkout page available when the guest is registering for a store Account Information section in an order being created for a customer in the backend Billing Address section in an order being created for a customer in the backend

Chapter Quick Reference

The table below lists some of the most common tasks for using EEs gift registry functionality and where to go in the Admin Panel to perform them. The sections that follow provide step-by-step instructions on each. Table 6. Enterprise Edition Customer Attribute Administration Tasks Quick Reference.
TASK Creating custom customer attributes Creating custom address attributes Changing the order of address fields on the frontend ADMIN MENU CustomersAttributesManage Customer Attributes CustomersAttributesManage Customer Address Attributes SystemConfigurationCustomer Configuration Address Template panel

To create custom customer attributes:

When creating a customer attribute, the store administrator needs to specify a number of properties for it including those for displaying the attribute in the frontend.

1. Choose CustomersAttributesManage Customer Attributes.

On the resulting Customer Attributes grid you can see all of the system and custom attributes. You cannot edit or delete System Attributes. 80

Chapter 14Order Archiving

2. Click the [+ Add New Attribute] button.

The resulting page is very similar to the Product Attribute editor, which you are probably already familiar with.

3. On the Properties tab, in the Attribute Properties panel, enter the appropriate
information for the following fields to create your attribute:

Attribute CodeSpecify the customer attribute name that will be used by the
system. The name must be unique and must not contain any special characters, except an underscore, or any spaces.

Input TypeSpecify the way the attribute being created will be presented to
the customer in the frontend. The following options are available: o Text FieldSingle line text field. Max and min size can be specified later. o Text AreaMulti-line text input area. Max and min size can be specified later. o Multiple LineThe number of input lines to be available for the customer in the frontend (cannot exceed 20 lines). o DateThe system validates the customers date attribute input. o DropdownDropdown list of options. When selected, the store administrator needs to create a number of attribute options on the Manage Label / Options tab. o Multiple SelectMulti-selectable list of options. When selected, the store administrator needs to create a number of attribute options on the Manage Label / Options tab. o Yes/NoBinary/yes-no input field. o File (attachment) Allows files to be uploaded by the customer. o Image FileAllows images to be uploaded by the customer.

Default ValueSpecify a value that will be displayed in the attribute field in

the frontend as a default one.

Input ValidationSpecify how the customers input will be validated by the

system when the customer enters a value in the attribute field in the frontend. The system verifies that the value entered in the attribute field corresponds to the type of attribute created. Input validation options available to the store administrator may vary depending on the attribute input type selected.

Minimum Text Length and Maximum Text LengthSpecify the values for
the minimum and maximum allowed length of text that can be entered by a customer in the attribute field in the frontend. These fields appear if the attribute is of Text Field, Text Area, or Multiple Line input type.

Maximum File Size (bytes) Specify the maximum allowed size of a file to be
attached. This field appears if the attribute is of File type.

81

Part IVCustomer & Order Management Features

File ExtensionsList allowed extensions of files to be attached in the field.

Separate multiple file extensions with a comma. This field appears if the attribute is of File type.

Values RequiredSpecify whether the attribute field should be mandatory on

frontend forms. The customer will not be able to save his or her account information if the mandatory attribute is not filled out.

Input/Output FilterChoose which filter will be applied to the attribute during

the input and output operations. Filters can only be applied if the attribute is of Text Field, Text Area, or Multiple Line input type. The following options are available: o None o Strip HTML Tags o Escape HTML Entities

Use in Customer SegmentIf Yes, the custom attribute being created can be
used in customer segmentation. (Customer segments are used as targets for advertizing, promotions, and suggestive selling. Customers can match any of created segments based on their personal data and purchase history. In Magento, customer segments are created and set up under Customers > Customer Segments.)

4. On the Properties tab, in the Frontend Properties panel, enter the appropriate
information for the following fields to create your attribute:

Show on FrontendSpecify whether the attribute will be available in the

frontend.

Sort OrderSpecify the position at which the attribute will be displayed. All
custom attributes are displayed after the system attributes, so they are shown at the end of the existing form fields.

Forms to Use InChoose the forms on which the custom attribute will be
displayed in the frontend. Choose among the following options: o Customer Checkout Register o Customer Registration o Customer Account Edit o Admin Checkout

82

Chapter 14Order Archiving

5. On the Manage Label/Options tab, set label to be displayed to the customer in the
frontend. Specify the value either for a specific store view or a default one for all store views. If the attribute input type selected on the Properties tab is either Dropdown or Multiple Select, a number of options can be added to the attribute on the Manage Label / Options tab. The store administrator can perform this by clicking the Add Option button located in the Manage Options (values of your attribute) area and specifying a label for each attribute option. This also can be done for either all store views or for specific ones. When all required options are added, the store administrator can specify which of them will be displayed in the attribute field as a default option by selecting the Is Default check box. The order of customer attribute options is set in the Position field.

6. Click the [ Save Attribute] button to save your attribute.

To create custom customer address attributes:
Customer address attributes created by the store administrator are used when the store needs to find out any additional address information from the customer. This can be an optional email address, Skype account, alternate phone number, county, etc. The process for creating a customer attribute and a customer address attribute are almost the same except that customer address attributes can be displayed in the frontend only in the following two forms: Customer Registration Address Customer Account Address For detailed information about how to create an address attribute, refer to the instruction above to create custom customer attributes.

To change the order of address fields on the frontend:

Currently, the store administrator can modify address templates which define the look of address fields in the customers billing or shipping addresses in the frontend. This can be done for the following addresses in the system: Customers billing and shipping addresses in the customers address Shipping and billing addresses from customers address book (available during the shopping cart checkout) Addresses in invoices, shipments, and refunds (printed in PDF files)

1. Choose SystemConfiguration. Select the Customer Configuration tab on the

left.

2. In the Address Template panel, you can edit the following address templates:

83

Part IVCustomer & Order Management Features

Text the template is used for all addresses that are printed. Text One Line this template defines the order of address entities in the
customers shopping cart address book list. Progress during checkout.

HTML this template defines the order of address fields located under the
Customer Addresses area in the Admin panel (Customers > Manage Customers) and those located on the Add New Address page when a customer creates a new billing or shipping address on his or her account page.

PDF the template defines the display of billing and shipping addresses in the
printed invoices, shipments, and credit memos.

JavaScript Template In the templates, you will see the following code blocks:
o depend codefor processing of inner elements, o if codean attribute is defined o var codethe code attribute is printed. Use the following examples in your address templates: o For Text, Text One Line, HTML, and PDF address templates o {{depend address attribute code}} a space, a character, or a User Interface label {{/depend}}; {{if address attribute code}}{{var address attribute code}} a space, a character, or a User Interface label {{/if}} o For JavaScript address template o #{address attribute code} or User Interface label #{address attribute code}

3. Click the [ Save Config] button to save your template modifications.

84

APPENDICES

A System Requirements
Magento must be installed on a web server in a LAMP environment: Linux, Apache, MySQL, and PHP. At the base level, Magento will require the following software:

Operating Environment (LAMP)

Supported Operating Systems (Unix only) Linux x86, x86-64 Supported Web Servers: Apache 1.3.x Apache 2.0.x Apache 2.2.x MySQL: 4.1.20 or newer InnoDB storage engine PHP Compatibility: PHP v5.2 Required extensions: o PDO_MySQL o simplexml o mcrypt o hash o GD o DOM o iconv o curl o SOAP (if Webservices API is to be used) Configuration requirements: o Safe_mode off o Memory_limit recommended 512Mb (minimum 256Mb)

85

Appendices

Basic Configuration Requirements

SSL: If HTTPS is used to work in the admin, SSL certificate should be valid. Selfsigned SSL certificates are not supported Mail server: SMTP server or Sendmail-compatible Mail Transfer Agent (MTA) Server privileges: Ability to run scheduled jobs (crontab) with PHP 5 Ability to override options in .htaccess files We also recommend the use of APC as a bytecode cache for performance improvements. You can find it in the PECL archives here: http://pecl.php.net/package/APC. Other bytecode cache systems are not supported at this time. Other Requirements (Enterprise v1.8 and newer only) ionCube loader v3.1.23 or above

Supported Browsers for Backend Admin:

Adobe Flash browser plug-in must be installed Mozilla Firefox 2.0 and above Apple Safari 2.x and above MS IE 6 and above Google Chrome

86

Appendix BInstalling and Upgrading

Installing and Upgrading Enterprise Edition

Installations and upgrades of Enterprise Edition require special attention. In some regards, these processes are similar to those of the Community Edition. In some cases, however, the processes must be done manually in order to avoid conflicts or downgrading.

B-1 Installing Enterprise Edition

New Installation
Installing the Enterprise Edition can be achieved by following the same steps required to install the Community Edition. The Enterprise Edition comes as a tar.gz package, similar to the full package for the Community Edition. However, the Enterprise Edition cannot be installed using the PEAR downloader. Sample data is also installed in the same manner as with the Community Edition. Please see the following instructions on the Knowledge Base for step-by-step instructions for installing Magento:

Magento Installation Cheat Sheet (www.magentoCommerce.com/knowledgebase/entry/magento-installation-cheat-sheet)

Installing the Sample Data for Magento

(www.magentoCommerce.com/knowledge-base/entry/installing-the-sampledata-for-magento)

Installing over the Community Edition

If installing over an existing Community Edition installation, follow these steps:

1. Upgrade the Community Edition installation to the latest available version, and
change your custom templates to match it.

2. Create a copy of the database and save it as a new database. 3. Install the Enterprise Edition in a separate directory using the database copy. 4. Upgrade your custom templates to match the Enterprise Edition functionality. 5. Test the Enterprise Edition installation, and change the configuration of your web
server to use the new directory.

87

Appendices

B-2 Upgrading Enterprise

When a new version of the Enterprise Edition is released, an existing version can be upgraded by manually replacing the previous files with the files contained in the new tar.gz package.

Warning:
Magento Connect cannot be used for upgrades or extensions. The Enterprise Edition contains modules and code patches not available in the Community Edition. Currently, Magento Connect can only be used to upgrade the Community Edition, and using it to upgrade the Enterprise Edition can cause downgrading of your installation. Additionally, because community and other modules/extensions on Magento Connect can reference the core package, installing any module from Magento Connect can lead to the same downgrading problem. Until this issue is resolved for Enterprise customers, upgrades must be performed manually as described above. Community modules cannot be directly accessed using Magento Connect because they are downloaded as an extension key rather than as a tar.gz package. The Magento support team, however, does have access to the extensions directly, and can provide these to you following your request. This service is included in the Magento support that comes with your license fees. Assistance on Community Edition extensions usage and any impact these may cause to the core application are not included through our support services.

88