# ometria/magento2

> Dev composer package for Ometria Extension

`composer require ometria/magento2`

Canonical URL: https://packagento.com/ometria/magento2

## At a glance

- **Vendor**: ometria (https://packagento.com/ometria.md)
- **Latest version**: 2.7.0 — released 2026-03-10
- **Pricing**: Free
- **Package type**: Magento 2 module
- **Status**: active, accepting new buyers

## Installation

Packagento is licence-gated, so even free packages need a licence on a project before Composer can resolve them.

1. **Sign in or create an account** at https://packagento.com/customer/account/.

2. **Add the package to your account.** Open https://packagento.com/ometria/magento2 and complete the free checkout. A licence is minted automatically.

3. **Create or pick a project, then activate the licence on it.**
   - Projects represent the Magento installs you deploy to. Manage them at https://packagento.com/projects/.
   - Activate the new licence on the project you'll deploy this package to. Activation is what generates the Composer credentials scoped to that project.

4. **Add the project credentials to your Magento codebase.**

   Grab the project's public + private key from https://packagento.com/projects/ (open the project, then its Credentials tab), and add them to `auth.json`:

   ```json
   {
     "http-basic": {
       "packagento.com": {
         "username": "ppk_live_...",
         "password": "psk_live_..."
       }
     }
   }
   ```

   Add the Packagento Composer repository to `composer.json`:

   ```json
   {
     "repositories": [
       { "type": "composer", "url": "https://packagento.com" }
     ]
   }
   ```

5. **Install and apply.**

   ```bash
   composer require ometria/magento2:*
   bin/magento setup:upgrade
   bin/magento setup:di:compile
   bin/magento cache:flush
   ```

## What it does

Dev composer package for Ometria Extension

## README

Installing the Extension
--------------------------------------------------

While you're free to manually install the Ometria extension (the use of the `app/code` folder structure supports this), we recommend using Magento's [PHP composer](https://getcomposer.org/) integration to install the extension.  All Magento 2 systems have a `composer.json` file, and this file is how developers **and** Magento Marketplace users get new packages in and out of their system.

Installing the extension is a 4 step process

1. Add this GitHub repository to your project's composer.json as a composer repository
2. Add the `ometria/magento2` composer package to your project's composer.json as a required dependency
3. Update your project's composer dependencies
4. Install the downloaded package via Magento's standard command line tool

Support
-------

If you have any concerns or questions, please send an email to support@ometria.com
with all relevant details that are needed to investigate or resolve the issue.

Quick Start
--------------------------------------------------
After backing up your composer.json file

    cp composer.json composer.json.bak

Run

    composer.phar config repositories.ometria vcs https://github.com/Ometria/magento2-extension
    composer require ometria/magento2 --no-update
    composer update ometria/magento2
    php bin/magento module:enable Ometria_AbandonedCarts Ometria_Api Ometria_Core
    php bin/magento setup:upgrade

After running the above, the Ometria extension will be installed, ready for configuration.

Please note, if you are running PHP OPcache on your server and have configured it not to clear automatically then you will need to clear the OPcache in order for the new module to become available after the above steps.

Composer Details
--------------------------------------------------
The first composer command

    composer.phar config repositories.foo vcs https://github.com/Ometria/magento2-extension

add this GitHub repository as a composer repository

    #File: composer.json
    //...
    "repositories": {
        "ometria": {
            "type": "vcs",
            "url": "https://github.com/Ometria/magento2-extension"
        }
    },
    //...

This tells composer it should look for additional packages in this GitHub repository.

The second command

    composer require ometria/magento2 --no-update

add the latest stable version of `ometria/magento2` to your `composer.json` file's `require` section.

    #File: composer.json
    //...
    "require": {
        //...
        "ometria/magento2": "^2.0"
    },
    //...

The third command

    composer update ometria/magento2

Updates any composer packages that match the string `ometria/magento2`.  This is what triggers the download of the Ometria extension source code to `vendor/ometria`.

The final two commands are **Magento** commands.  This command enables the three modules that make up the Ometria extension

    php bin/magento module:enable Ometria_AbandonedCarts Ometria_Api Ometria_Core

Once a module is enabled, the rest of Magento can "see" it. The last command tells Magento to actually install the module.

    php bin/magento setup:upgrade

Upgrading the Extension
--------------------------------------------------

Composer can be used to upgrade an existing install of the module to the latest release using the following commands:

    composer require ometria/magento2 --no-update
    composer update ometria/magento2
    php bin/magento setup:upgrade

This will update your `composer.json` file's `require` section with the latest stable version of `ometria/magento2`. Then the latest code at that version will be pulled in by `composer update`. Finally re-running the Magento `setup:upgrade` command will ensure the module is installed correctly at the new version.

If you installed the module manually in to app/code please ensure you remove all of the existing module files before replacing with the new files from the latest release and re-running the Magento `setup:upgrade` command. 

**Important:** Changing a Magento system running in production is **not** a recommended practice.  Depending on your system software, or other running extensions, running `setup:upgrade` may trigger undesired behaviors.  As with installing **any** new software on your system, don't forget to take appropriate backup steps, and to test your new module in a development or staging environment before deploying to production.

## Recent Versions

| Version | Released |
|---|---|
| 2.7.0 | 2026-03-10 |
| 2.6.13 | 2026-01-30 |
| 2.6.12 | 2025-09-10 |
| 2.6.11 | 2025-07-17 |
| 2.6.10 | 2025-05-13 |
| 2.6.9 | 2024-12-09 |
| 2.6.8 | 2024-11-20 |
| 2.6.7 | 2024-08-12 |
| 2.6.6 | 2024-06-20 |
| 2.6.5 | 2024-03-14 |

Showing 10 of 43 versions. Full release history on https://packagento.com/ometria/magento2.

## Quality

Latest release (2.7.0) fails the Packagento QA pipeline. Verdicts below are per-cell (Magento line × PHP version) for the matrixed tools, and run-once for the static / security tiers.


### Compatibility

Each Magento line is installed on its supported PHP versions, then the module is built (DI compile + static-content deploy). Cells show passed / failed / untested; staircase gaps render as `–`.

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | Pass | Pass | – | – |
| 2.4.8 | – | Pass | Pass | – |
| 2.4.9 | – | – | not tested | 1 |


### Code Quality

Advisory checks against the module's source. Never affect the Compatibility verdict — a phpcs finding can't make a module incompatible.

#### Static Analysis

Coding standards (phpcs), mess detection (phpmd), copy-pasted code (cpd), PHP cross-version compatibility, composer.json validity. Each runs once for the whole module.

| Tool | Status | Findings | Summary |
|---|---|---|---|
| PHPCS | Fail | 1459 | 10 errors, 1449 warnings (ruleset: Magento2) — 1056 auto-fixable with phpcbf |
| PHPMD | Warning | 5 | 5 rule violations (UnusedLocalVariable:2, CyclomaticComplexity:1, NPathComplexity:1, MissingImport:1) |
| Cpd | Pass | 0 |  |
| Composer validate | Fail | 1 | invalid composer.json: 1 error (composer validate --strict) |

#### PHPStan

Type-checks the module against a real Magento install. Re-runs per Magento + PHP version because resolvable symbols differ between releases.

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | 118 | 118 | – | – |
| 2.4.8 | – | 117 | 117 | – |
| 2.4.9 | – | – | Unknown | Unknown |


### Tests

Unit and integration suites run per Magento + PHP cell. Test failures speak to the module's behaviour, not its compatibility with a line, so they're reported here separately.

#### Unit Tests

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | N/A | N/A | – | – |
| 2.4.8 | – | N/A | N/A | – |
| 2.4.9 | – | – | N/A | N/A |

#### Integration Tests

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | Pass | Pass | – | – |
| 2.4.8 | – | Pass | not tested | – |
| 2.4.9 | – | – | Pass | Error |


### Security

Dependency-advisory audit (composer audit) plus a source malware scan. A malware detection fails the version outright.

| Tool | Status | Findings | Summary |
|---|---|---|---|
| Composer audit | Pass | 0 |  |
| Malware scan | Pass | 0 |  |

## Licence and pricing

Free. A licence is still minted on checkout and bound to your project for Composer access — no payment step.

Refundable within 14 days of first purchase via https://packagento.com/account/refunds/.

## Install via Claude Code or any MCP client

The Packagento MCP server can run the licence + project + Composer steps above in one tool call:

```
purchase_and_install_packages(
  composer_names=["ometria/magento2"],
  project_id="proj_xxx"
)
```

This handles cart, checkout, licence minting, project activation, and writes auth.json credentials. Connect a client with `claude mcp add packagento https://mcp.packagento.com`. Full setup at https://packagento.com/docs/mcp-setup.

## Vendor

ometria is a Magento 2 vendor on Packagento. See https://packagento.com/ometria.md for their full catalogue.