# firegento/extendedimport

> Extended Import Features (ported from AvS_FastSimpleImport)

`composer require firegento/extendedimport`

Canonical URL: https://packagento.com/firegento/extendedimport

## At a glance

- **Vendor**: firegento (https://packagento.com/firegento.md)
- **Latest version**: 1.0.4 — released 2023-05-12
- **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/firegento/extendedimport 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 firegento/extendedimport:*
   bin/magento setup:upgrade
   bin/magento setup:di:compile
   bin/magento cache:flush
   ```

## What it does

Extended Import Features (ported from AvS_FastSimpleImport)

## README

<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
[![All Contributors](https://img.shields.io/badge/all_contributors-9-orange.svg?style=flat-square)](#contributors-)
<!-- ALL-CONTRIBUTORS-BADGE:END -->

## FireGento ExtendedImport Extension

Extended Import Features (ported from AvS_FastSimpleImport)

### Facts

- version: 0.0.1
- extension key: FireGento_ExtendedImport
- [extension on GitHub](https://github.com/magento-hackathon/FireGento_ExtendedImport2)

### Description

Adds missing features to Magento CSV import, to be used with FastSimpleImport

### Features

1. Add missing product-attribute-options on the fly
2. Allow using category-ids on product import instead of category-path


### Requirements

- None

### Compatibility

- Magento >= 2.0

### Installation Instructions "Manual" Installation

1. create a directory `app/code/FireGento/ExtendedImport`
2. extract all files of the module there
3. enable the module with

        bin/magento module:enable FireGento_ExtendedImport
        bin/magento setup:upgrade
        
### Installation Instructions with Composer


        composer config repositories.firegento_extendedimport2 vcs https://github.com/firegento/FireGento_ExtendedImport2
        composer require firegento/extendedimport dev-master
        bin/magento module:enable FireGento_ExtendedImport
        bin/magento setup:upgrade

### Uninstallation

1. remove the directory `app/code/FireGento/ExtendedImport`

### Support

If you have any issues with this extension, open an issue on [GitHub](https://github.com/magento-hackathon/FireGento_ExtendedImport/issues).

### Contribution

Any contribution is highly appreciated. The best way to contribute code is to open a [pull request on GitHub](https://help.github.com/articles/using-pull-requests).

### Contributors ✨

Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):

<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
<!-- prettier-ignore-start -->
<!-- markdownlint-disable -->
<table>
  <tr>
    <td align="center"><a href="https://frostblog.net/"><img src="https://avatars3.githubusercontent.com/u/19548641?v=4" width="100px;" alt=""/><br /><sub><b>Jens Richter</b></sub></a><br /><a href="https://github.com/firegento/FireGento_ExtendedImport2/commits?author=frostblogNet" title="Code">💻</a></td>
    <td align="center"><a href="https://github.com/EliasKotlyar"><img src="https://avatars0.githubusercontent.com/u/9529505?v=4" width="100px;" alt=""/><br /><sub><b>Elias Kotlyar</b></sub></a><br /><a href="https://github.com/firegento/FireGento_ExtendedImport2/commits?author=EliasKotlyar" title="Code">💻</a></td>
    <td align="center"><a href="https://www.schmengler-se.de/"><img src="https://avatars1.githubusercontent.com/u/367320?v=4" width="100px;" alt=""/><br /><sub><b>Fabian Schmengler /></b></sub></a><br /><a href="https://github.com/firegento/FireGento_ExtendedImport2/commits?author=schmengler" title="Code">💻</a></td>
    <td align="center"><a href="https://blog.timpack.org/"><img src="https://avatars2.githubusercontent.com/u/1165302?v=4" width="100px;" alt=""/><br /><sub><b>Timon de Groot</b></sub></a><br /><a href="https://github.com/firegento/FireGento_ExtendedImport2/commits?author=tdgroot" title="Code">💻</a></td>
    <td align="center"><a href="http://elgentos.nl/"><img src="https://avatars2.githubusercontent.com/u/431360?v=4" width="100px;" alt=""/><br /><sub><b>Peter Jaap Blaakmeer</b></sub></a><br /><a href="https://github.com/firegento/FireGento_ExtendedImport2/commits?author=peterjaap" title="Code">💻</a></td>
    <td align="center"><a href="https://www.webzap.eu/"><img src="https://avatars1.githubusercontent.com/u/563328?v=4" width="100px;" alt=""/><br /><sub><b>Lennart Schreiber</b></sub></a><br /><a href="https://github.com/firegento/FireGento_ExtendedImport2/commits?author=Kipperlenny" title="Code">💻</a></td>
    <td align="center"><a href="https://github.com/ulftietze"><img src="https://avatars2.githubusercontent.com/u/12051528?v=4" width="100px;" alt=""/><br /><sub><b>utietze</b></sub></a><br /><a href="https://github.com/firegento/FireGento_ExtendedImport2/commits?author=ulftietze" title="Code">💻</a></td>
  </tr>
  <tr>
    <td align="center"><a href="https://github.com/Dr-Head"><img src="https://avatars0.githubusercontent.com/u/3766584?v=4" width="100px;" alt=""/><br /><sub><b>Daniel Head</b></sub></a><br /><a href="https://github.com/firegento/FireGento_ExtendedImport2/commits?author=Dr-Head" title="Code">💻</a></td>
    <td align="center"><a href="https://github.com/kkrieger85"><img src="https://avatars2.githubusercontent.com/u/4435523?v=4" width="100px;" alt=""/><br /><sub><b>Kevin Krieger</b></sub></a><br /><a href="https://github.com/firegento/FireGento_ExtendedImport2/commits?author=kkrieger85" title="Documentation">📖</a></td>
  </tr>
</table>

<!-- markdownlint-enable -->
<!-- prettier-ignore-end -->
<!-- ALL-CONTRIBUTORS-LIST:END -->

This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!

### Tests

Unit tests are integrated in the Magento unit test suite. To run them separately, simply call

    phpunit
    
in the module directory (it must be installed in a Magento instance to use the bootstrap file)

### Developer

Fabian Schmengler
[@fschmengler](https://twitter.com/fschmengler)

### Licence

[OSL - Open Software Licence 3.0](http://opensource.org/licenses/osl-3.0.php)

### Copyright

(c) 2016 -2020 FireGento

## Recent Versions

| Version | Released |
|---|---|
| 1.0.4 | 2023-05-12 |
| 1.0.3 | 2022-06-09 |
| 1.0.2 | 2021-04-15 |
| 1.0.1 | 2021-01-07 |
| 1.0.0 | 2020-03-13 |

## Dependencies

### Require

| Package | Constraint |
|---|---|
| php | ^5.5.0\|^7.0.0\|^8.0.0 |

## Quality

Latest release (1.0.4) 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 | – | – | Pass | Pass |


### 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 | 4 | 2 errors, 2 warnings (ruleset: Magento2) |
| PHPMD | Warning | 3 | 3 rule violations (UnusedFormalParameter:3) |
| Cpd | Pass | 0 |  |
| Composer validate | Pass | 0 |  |

#### 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 | Pass | Pass | – | – |
| 2.4.8 | – | Pass | Pass | – |
| 2.4.9 | – | – | Pass | Pass |


### 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 | Error | Error | – | – |
| 2.4.8 | – | Error | Error | – |
| 2.4.9 | – | – | Error | Error |

#### Integration 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 |


### 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=["firegento/extendedimport"],
  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

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