Manage your components

Component Management options

To choose whether to upgrade or uninstall components:

  1. After you run the Component Manager, a page similar to the following displays:

    The Component Manager page enables you to synchronize with Magento Marketplace to see if updates are available
  2. You have the following options: </tbody> </table>
    Item Meaning

    Magento Marketplace Account section

    Shows when you last synchronized with your Magento Marketplace account. To get the latest information about available component versions, you must synchronize with Connect.

    Last Sync shows the last time you synchronized and Sync Status shows whether or not you're currently synchronized.

    New Updates and New Purchases displays the number of each to install; click Install to select updates or purchases to install and see Install new purchases.

    Click Reset to log in with a different set of Marketplace credentials.

    Sync button

    Click Sync to compare the component versions you're currently using with those available on Magento Marketplace.

    List of components

    For each component, one of the following status indicators displays in the left column:

    • A green icon means that the component is enabled and is current as of the last syncGreen, which means the component is enabled and its status was current the last time you synchronized with Magento Marketplace.
    • An info icon means there is an update availableAn update is available.
    • A red icon means the component is disabledThe component is disabled.

    Middle columns display information about the component we obtained from its Composer package.

    The right column displays available actions for each component.

    Actions

    Displays a list of actions available for that component type. Details about available actions.

    The following figure shows an example.

    You can enable, disable, or update components

    Pagination

    Enables you to:

    Specify number of items to display on pageSpecify the number of items to display on a page.

    Move back and forward or specify a page numberFrom left to right, move back one page, go to a specific page, or move forward one page.

Install new purchases

A new purchase can be any of the following:

  • Magento CE or EE sample data if it hasn’t been installed yet.

    You don’t need to go to Magento Marketplace and request sample data; you can install it at any time.

  • A free component you selected on Magento Marketplace
  • A component you paid for on Magento Marketplace

To install a new purchase:

  1. Click Install under the number of new purchases as the following figure shows.

  2. On the next page, select the components to install.

    To install all of them, click Select all from the list.

    To install components individually, either select the check box next to the component or click Install in the Action column.

    The following figure shows an example of selecting all components.

  3. Click Install.
  4. Continue with Readiness check.

Update a component

To see if any of your components can be updated, click Sync.

An info icon means there is an update available displays in the left column of each component that you can update.

The following figure shows an example.

Example showing components that need updating

To update the component, click Update from the Actions list. A sample follows.

Click Update from the Actions menu

Continue with Readiness check.

Enable or disable a component

To enable or disable a component, click the appropriate choice from the Actions list.

The following figure shows an example of disabling a component.

Click Disable from the Actions menu

Continue with Readiness check.

Uninstall a component

To uninstall a component, click Uninstall from the Actions list as the following figure shows.

Uninstall a component

Continue with Readiness check.

Supported actions for each component type

We define the following components:

  • module for a module or extension (that is, PHP code that modifies Magento behavior)
  • language for a language package used to translate the Magento storefront and Admin
  • theme for a collection of styles that affect the look of the storefront or Admin
  • library for a library—such as a shared third-party library
  • component for any type of component that must be installed in the Magento root directory (this is a relatively uncommon type)

We also use metapackage to group components; Magento Community Edition (CE) and Magento Enterprise Edition (EE) are examples of metapackages.

You can perform actions on components differently, depending on whether the component is part of a metapackage or not.

The following sections provide details:

Actions available for metapackage components

Magento requires any component that has more than one type to be a metapackage. For example, we require a component that contains a module and a theme to be packaged as a metapackage.

We currently do not support uninstalling a metapackage.

The following table shows which actions are available for components that are part of a metapackage.

Type Enable Disable Update Uninstall
module Yes Yes No No
language and theme No No Yes Yes
library No No Yes Yes
component No No Yes Yes

Update displays as an action only if an update is available for that component.

Actions available for non-metapackage components

Typically, a component that you download from Magento Marketplace is not part of a metapackage; in other words, a single module is probably not part of a metapackage.

The following table shows which actions are supported for each non-metapackage component.

Type Enable Disable Update Uninstall
module Yes Yes Yes Yes
language and theme No No Yes Yes
library No No Yes Yes
component No No Yes Yes

Next

Step 1: Readiness check