Magento Manual
Magento Manual
The administration interface is responsible for controlling everything you see on the public interface.
You can view and manage orders, update customer information, and add new products to your
store.
Once logged in, you will be redirected to the dashboard. The dashboard gives a quick overview of all
the recent activity with your web site. You can view overviews of lifetime sales, average order totals,
order transaction totals over a given period, and recent product searches by customers
The dashboard is the gateway to every other section in the administration interface. From the
dashboard, you can navigate to each of these different sections:
By default, orders are listed by the most Purchased On filter which displays orders from the most
recent to the oldest. You can sort orders by clicking on any of the columns headers listed above the
orders. These include: Order #, Purchased from (store), Purchased On, Bill to Name, Ship to Name,
G.T. (Base), G.T. (Purchased), Status, and Action. Below the column headers are additional filtering
options that include specific searching information, like a specific order number, purchase date,
name, total amount, or status. To use the additional search features, enter in the specific
information you are looking for and press search. Clicking the reset filter button to return the view to
its default state.
From the sales order grid, you can also manage orders in bulk using the pulldown labeled Actions.
Here you can modify multiple orders from the settings cancelled, hold, and unhold. You can also
print invoices, packing slips, and credit memos.
From the sales order grid, you can also create customer orders from inside the admin interface. To
create a new order, simply click the Create New Order button on the Orders grid page.
There are several steps involved with creating an order from inside the admin interface. They are the
following:
Select a customer: To begin the process, you must first either select an existing customer or
click the create new customer button. If you choose the create new customer button, you
can create a new customer and a new order at the same time.
Add products to the order: After selecting a customer and which store the order should be
placed from, the next step is to add products to the order. If you selected an existing
customer, a block called Customer’s Current Activities will be displayed on the left-hand side.
Customer’s Current Activities provides an overview of products your customer has viewed,
compared, and ordered. If the order is for a new customer, you will have to click the Add
Products button. This will bring up a list of all available products. Click the checkbox next to
the item and enter in the desired quantity for each product and click the Add Selected
Product(s) to Order button. The page should refresh with all of the selected products. Now,
you can update product quantities and set custom pricing for each item.
Enter customer information: Next, enter in the customer's information including email
address, billing address, and shipping address. If the order is using an existing customer, you
can select previously used addresses from the Add New Address dropdown. If the address
information is new and you’d like to save it for a future purchase, click the Save in address
book checkbox on the bottom of both the billing and shipping address.
Payment method: Select one of the payment options listed. If the payment method uses a
credit card you will need to enter in that information as well.
Shipping method: Select one of the shipping options listed. You must enter in a shipping
address before shipping can be calculated.
Order comments: If you need to add comments to the order, use the order comments field
found within the Order History section. Order History stores comments and changes to order
status and is viewable by customers. This is an optional area.
Order Totals: Before you submit an order there are two additional checkboxes. If you added
a comment to the order, make sure you select the Append Comments checkbox. You also
have the ability to send the customer an email containing all order information by selecting
the Email Order Confirmation checkbox. Once you submit an order, you will be taken to the
order details page. This page allows you to review and manipulate orders on an individual
basis. Alternatively, you can reach this page by clicking on any order on the sales grid page
■ Note If you create a new order or a customer places an order its status will be set to PENDING.
If you click on any of the invoices you may be taken to the invoice detail page. At first glance, this
might look identical to the sales order detail page, and while the information and layout is nearly
identical it is important to understand that invoices cannot exists without a sales order being placed
or created first.
■ Note When you create an invoice for an order, this will change the order status from PENDING to
PROCESSING.
Alternatively, during the invoice creation process, there is a checkbox located under the shipping
method box. If you select this checkbox, you will create a shipment order and can enter in one or
more tracking numbers at the same time. If the notify customer checkbox is selected while the
shipment order is being created, the customer will receive an email containing the tracking number
information. Once added to shipment orders, customers can view tracking numbers by logging into
the public interface and viewing their order history. Use this feature carefully because if you create a
shipment order at the same time you are creating an invoice you will not be able to separate
product quantities into different shipments.
Individual shipment orders display all the necessary order information plus any tracking
information that is associated with this shipment orders. While shipment orders share all of the
same order information, if there are multiple shipping orders that have their own unique tracking
information, each order with have to be updated individually.
■ Note When you create a shipment for an order, this will change the order status from
PROCESSING to COMPLETE. If an invoice for the order has not been created, a PENDING status will
be changed to PROCESSING when you create a shipment order.
Once a credit memo has been created, it will be listed in the credit memo grid page. This grid page
shares the same filtering options as orders, invoices, and shipments.
■ Note Creating a credit memo will change the order status to COMPLETE regardless of what the
previous status is set to.
The Administration Interface: Catalog
The Catalog drop down of the administration interface gives you complete control over products,
categories, tags, product attributes, and product reviews.
Clicking on any of these products will take you to the product details page. While somewhat
overwhelming at first, the product detail page allows you to edit any of the following information
related to your product: Name, sku, price, images, categories, attributes, and which web sites the
product should be listed on.
Jumping back to the product grid overview, you can also create new products by clicking the Add
Product button in the upper right-hand corner. To get started, you will need to select what type of
product you are going to create. The following are the two types of products used on the site:
• Single product: Single products refer to products which can be sold individually or will be
sold together as a grouped product.
• Grouped product: Grouped products allow you to sell groups of single products which have
been grouped together. An example of a group product could be a matching shirt and tie.
Any single products that are grouped together must be created first.
Once you have selected which product you want to create, you will be presented with a blank
version of the product details page. You will need to fill out any information that is required before
you can create the product. Required information is notated with an orange star. Don’t worry if you
miss any information, if you attempt to save the product with missing information, Magento will
provide you with an alert and notification or what information is missing.
Once you have set up your required ratings information and customers begin to complete reviews
on your products, they will appear under Catalog ➤ Reviews and Ratings ➤ Customer Reviews ➤
Pending Reviews. Ratings must be approved before they will appear on the public web site. This
helps to cut down on spam and unwarranted information.
Once ratings have been approved, they will be listed under Catalog ➤ Reviews and Ratings ➤
Customer Reviews ➤ Pending Reviews and appear in a list similar to Figure 4-25. This allows you to
edit or delete reviews as necessary.
The overview page displays customer names, email address, customer group, telephone numbers,
and additional information. You can filter how the overview page displays the list of customers or
search for specific information in any of the provided fields: id number, name, email, group,
telephone number, zip code, state/province, sign up date, and which web site they are assigned to.
The overview page also allows you to apply bulk actions to customers. You can delete customers,
subscribe customers to newsletters, unsubscribe customers to newsletters, and assign customers to
specific customer groups
Clicking on any of the customers listed in the manage customers grid view will bring up the customer
details page. The customer details page includes customer account information, a list of address
they’ve used, their order history, and items they currently have in their shopping cart. The customer
details page also keeps organized totals on how much customers have bought total and how much
their average purchases were for.
Rules are not retroactive, meaning if customer A purchases a product before the catalog price rule is
applied, the rule will not update the previous order. When establishing a catalog price rule it is
important to know that if the today’s date falls within the from date and the to date, the rules are
instantaneous so once you’ve applied a catalog price rule it will immediately affect any products the
rules apply to.
■ Note Customers have the ability to save products to their carts. If these products are modified by
using the Catalog price rules, any saved items that have been modified will be removed from the
customer’s carts. Customers will have to add the same products to their carts again before they can
checkout.
Once you’ve built a newsletter template, it will be listed under the grid view. To send your
newsletter to all current subscribers, you’ll need to select Queue Newsletter from the Actions drop
down on the right. You will have to assign a date for the Newsletter to be sent out and you also have
the ability to modify the Newsletter Template you built before you send it out .
After a newsletter has been sent, the number of processed newsletters should be equal to the
number of recipients. If this number is different you’ll need to visit the Newsletter Problem Reports
page.
■ Note It’s important to know that while you can create as many different types of newsletter as you
want when customers sign up to receive a newsletter they are agreeing to receive all newsletters,
not just one specific newsletter.
By default, there are five different layouts that static pages can use: Empty, 1 column, 2 columns
with left bar, 2 columns with right bar, and 3 columns. Empty pages will be displayed with a blank
white background while each of the four other layouts will display the content between the normal
page header and footer. Empty pages are ideal to provide quick information that can be displayed in
a small external window.
Since Magento allows you to build these static blocks as HTML, the possibilities of how static blocks
can be designed and laid out are endless. Figure 4-38 is a quick look at what the same static block
looks like from the public.
• Sales: Sales offers six different types of reports, which are sales report, tax, shipping, total
invoiced, total refunded, and coupons.
• Shopping cart: The two reports under shopping cart are products in carts and abandoned
carts. Products in carts provide a complete list of items currently in all customer carts. While
abandoned carts are carts in which customers began to checkout, but never completed the
process. Actions of users who are logged in do count towards these report totals.
• Products: Product reports offer four different types of reports, including bestsellers, most
viewed, low stock, and downloads.
• Customers: The three reports offered about customers are new accounts, customers by
orders total, and customers by number of orders.
• Reviews: Review reports are organized into two different areas, customer reviews and
product reviews. Customer reviews provide a review organized by customer while product
reviews are organized by the products themselves.
• Tags: Tags offers three different reports, including customers, products, and popular.
• Search terms: Although search terms only offer one type of view, this report displays a
complete listing of all terms customers have used when searching your site for products.
Magento gives you the ability to view reports by a range of date via a dropdown menu. You can also
choose to view the date by a month, week, or day view. All reports can be exported in both excel
and csv formats.
■ Tip If you are making modifications to Magento and you do not see the new changes take effect, make sure
that the All Cache option is either set to disabled or refresh after you make your changes.
There are two types of Categories, Root Categories and Subcategories. Think of Root Categories as
a big blanket, and while it’s not the best practice to assign products to a root category, you are
allowed to do this. The best thing to do when building your category structure is to assign products
to any of the sub categories listed underneath your Root Category. Magento allows you to have
multiple stores and you can assign different root categories to different stores. This allows you to
design identical root categories and subcategories, which could contain the same products, but be
assigned to different stores.
To change which root categories are assigned to each of your Magento stores, navigate to the
System ➤ Manage Stores and select the store you’d like to edit. Even though you can assign
multiple subcategories to a root category, you can only have one root category per store at a time.
By default, Magento only requires that you provide a name for a category to save it, but there are
specific requirements that categories must meet before they are displayed on the public interface.
• Root category: Subcategories must be under the correct root category for the correct store.
You can only have one root category per store.
• Categories must contain products: Even if you create a category, if you do not have any
products assigned to the new category it will not display.
• Categories must be active: If you create a new category, you must select yes from the Is
Active Drop down; it’s underneath the first section called General Information.
• There must at least one anchor category: You are allowed to create subcategories of
subcategories, but for your categories to be displayed either the category you are working
with or the top-level category must be set as an anchor category.
There are four sections under the category management page: General Settings, Display Settings,
Custom Design, and Category Products.
Next is the Product Information screen where you configure all the necessary information about
your product. It consists of 13 different areas: General, Prices, Meta Information, Images,
Description, Design, Inventory, Web sites, Categories, Related Products, Up-sells, Cross-sells, and
Custom options.
You can also set products to a new status under the Set Product as New From Date and Set Product
as New to Date. This gives you the ability to feature New products as they are added to your store
Product Information: Prices
The Prices section contains all pricing information for products. The only required field is the basic
Price field. The field called cost is for internal use only, dealing with reporting and is not viewable by
customers. Tier Price not only lets you set up quantity base pricing, but quantity-based pricing per
customer group. In Chapter 6, you’ll be taking an in-depth look at customers, customer groups, and
how customer group pricing works.
Products can be given Special Prices in this tab. Special prices are prices which are viable and
available to all customers, regardless of their customer group.
■ Tip Make sure you change the Stock Availability drop down from Out of Stock to In Stock. Although
not required, if you do not make this change your product will not display.
Product Reviews
By now, you should know that customers have the ability to write reviews about your store’s
products. Associated with each review is also a rating, based upon your criteria, which the clients are
required to also submit when they write a review. Reviews must be approved before they will
appear on the public interface. Pending tags will be listed under the menu Catalog ➤ Reviews and
Ratings ➤ Customer Reviews ➤ Pending Reviews.
Product tags
Tags are an easy way to associate products with specific keywords. For example, if you are selling a
cell phone, some example tags that might be associated with this product would be phone, camera,
lcd, sleek, and touchscreen. Tags can be added when the product is first created, but can also be
added by customers from the public.
Tags must be approved before they will appear on the public interface. Pending tags will be listed
under the menu Catalog ➤ Tags ➤ Pending Tags.
■ Note Currently, once a product is created you can only add tags from the public interface.
Hopefully, this is an issue that Magento corrects in the future.
The order details page displays all of the details of the order including order number, customer
information, billing and shipping information, payment method, shipping and handling information,
an itemized list of each product ordered, a comments area, and an order totals area.
There are two different navigation points on the order details page. Up top are action items that
include the following buttons: edit, cancel, hold, invoice, ship, and reorder. You'll be going through
each of these actions in this chapter. On the left there are five tabs. The first is the information tab.
It also includes, invoices, credit memos, shipments, and comment history. While no actions can be
taken in each of these tabs, once orders have been invoiced and shipped, a record of their respective
invoices shipments and credit memos will be listed under each tab.
Since Magento allows you to create multiple stores, it also assigns a unique sequential order
number to each store
It is important to know that while you can create multiple invoices, shipments, and credit memos
each of these items will be contained underneath one order number. The order number in Figure 7-1
is 100000006. Usually, you will only have one invoice, shipment, or credit memo assigned to each
order number, but Magento does allow you to create multiples. It can get rather confusing because
when you create an invoice or shipment each of these items are assigned a unique number. These
numbers are unique to the invoice or shipment that is created. As an example, if I create an invoice
for order number 100000006 it could be assigned a sequential invoice number like 100000002. Do
not worry if these numbers are not the same, Magento just assigns a unique number to every order,
invoice, shipment, and credit memo that is created inside of the system.
■ Note You can create a shipment first, but until you complete both steps 2 and 3 the order status
will only be reflected as processing. You must create an invoice and a shipment before the order
status will be set to complete.
• Pending: Pending orders are brand new orders that have not been processed. Typically,
these orders need to be invoiced and shipped.
• Pending Paypal: Pending PayPal orders are brand new orders that have not been cleared by
PayPal. When using PayPal as a payment method customers are redirected to the PayPal
site. If they have not paid for the order, orders will be marked as Pending PayPal. It is not
recommended to process these orders without referencing PayPal first to see if payment has
been made.
• Processing: Processing means that orders have either been invoiced or shipped, but not
both.
• Complete: Orders marked as complete have been invoiced and have shipped.
• Cancelled: Cancelled orders should be used if orders are cancelled or if the orders have not
been paid for.
• Closed: Closed orders are orders that have had a credit memo assigned to it and the
customer has been refunded for their order.
• On Hold: Orders placed on hold must be taken off hold before continuing any further
actions.
Note the checkboxes labeled: “Append Comments” and “Email Copy of Invoice” next to the submit
invoice button. The append Comments will save any comments made in the left-hand Invoice
Comments to the invoice. Comments are viewable to the client. The Email Copy of Invoice will send
an email copy of the invoice to the customer along with the invoice comments if the Append
Comments button is checked.
Once you’ve created an invoice for this order, the order status will be changed to processing.
Also, once you created an invoice note that on the product details page the itemized product now
has Invoiced 1 below the Qty header. Since Magento gives you the ability to create multiple invoices
and shipments per order, you can also get a breakdown view of all invoices, credit memos, and
shipments associated with a specific order. To view invoices, credit memos, or shipments associated
with your order select one of these three options underneath the information tab on the product
details page.
Lastly, once an invoice has been created it will be listed in the Invoices tab on the left-hand side of
the order details page. You can view the details of an invoice by clicking on the invoice row.
Bringing up, it provides all the basic invoicing information and looks very similar to the order details
page. One important note is that the invoice is marked as paid, but the customer has not been
notified. If it is not required to notify a customer when you create an invoice, your store might not
need this functionality. Magento is just letting you know that they have not received an email yet
Just like when you created an invoice there is a field under Qty to Ship that allows you to select a
specific qty of items to ship inside of this shipment. This is especially helpful if you ship out products
through different carriers or methods.
There is also an area to include shipping information for each shipment that you create. You can
select a carrier from the drop down list that includes: DHL, FedEx, UPS, or USPS. You can also enter a
custom shipment if it is not one of the ones listed. This information is accessible to customers
through the public interface, and if the Email Copy of Shipment button is checked they will also
receive the shipping information inside of the email that their order has shipped.
■ Note If you choose to create multiple shipments for one order until you create a shipment for ALL
of your products contained in the order, the order status will remain as processing.
Cancelling an Order
Cancelling an order halts any further actions that can be taken with that order. Orders that are
cancelled cannot be invoiced, shipped, or credited. You can reorder cancelled orders, but this will
only generate a new order in the system with an unique order number.
An order can be cancelled in one of two ways, the order overview page or the order details page. To
cancel an order from the order overview page, navigate to Sales ➤ Orders. When the order
overview page loads select the order you wish to cancel by clicking the checkbox located on the
same row as the order. Once you have the order selected, select cancel from the actions pulldown
and click submit. The page will reload and the order will be cancelled.
To cancel an order from the order details page, click on any order from the order overview page to
view its details. Once the detail page loads, click the cancel button in the upper right-hand corner.
This will cancel the order.
One problem I’ve noticed is that if you cancel an order that has either been invoiced or shipped, the
order will be cancelled but the status will incorrectly be set to complete instead of cancelled. Only
orders marked as pending can be correctly changed to cancelled.
■ Note It is important to realize that you cannot un-cancel an order. Orders that are cancelled are
permanently cancelled.
To place an order on hold from the order details page, click on any order from the order overview
page to view its details. Once the detail page loads, click the cancel button in the upper-right hand
corner. This will place the order on hold. Once an order is placed on hold to perform any additional
actions with an order you must first “unhold” an order.
Credit Memos
Credit Memos allow you to refund customers for orders they have placed in your store. Once you
create a credit memo for an order, you can take no further action with the order except to reorder
the order. Once you have created a Credit Memo for an order that order status will be changed to
Closed.
Deleting Orders
Currently, there is no way to delete orders once they have been created inside of Magento. Magento
allows you the ability to cancel an order, but deleting or removing an order is an architectural
decision that the Magento team decided to prohibit.
Orders are referenced within multiple tables for optimization of the database. Considering that
Magento is still in version 1.0 it is hopeful that they will include this feature in future versions of
Magento.