EcomHouse Base module

Foundation module for the EcomHouse Magento 2 extension family. It has no customer-facing functionality of its own — it registers the shared admin scaffolding (config tab + menu) that every other ecomhouse/* module hangs off, plus a couple of small helper classes reused across the fleet.

Polska wersja dokumentacji: docs/jak-uzywac.md

What it provides

• Admin configuration tab EcomHouse Extensions under Stores → Configuration — other ecomhouse modules attach their own config sections to it via <tab>ecomhouse</tab>.
• Admin top-level menu ecomhouse (resource EcomHouseExtensions_Base::menu) — other ecomhouse modules attach their admin pages under parent="EcomHouseExtensions_Base::menu".
• Model\AddStoreToCollection — helper for attaching Store View data/filters to a collection.
• Model\ImageProcessor — helper for handling image upload/select/keep-unchanged in admin forms (used by modules with an image-upload admin field).

Why other modules need it

Most ecomhouse/* modules declare "ecomhouse/base": "^1.0" in composer.json and <sequence><module name="EcomHouse_Base"/></sequence> in etc/module.xml. Without Base:

• those modules won't install via Composer (ecomhouse/base requirement unmet), and
• even if force-installed, their admin menu entries and config sections have nothing to attach to and won't appear.

Requirements

Requirement	Version
Magento Open Source	2.4.4 – 2.4.8+
PHP	>= 7.4 (>= 8.1 recommended)

Installation

composer require ecomhouse/base
bin/magento module:enable EcomHouse_Base
bin/magento setup:upgrade
bin/magento cache:flush

Manual installation

cd app/code
mkdir -p EcomHouse
git clone <repo-url> EcomHouse/Base
bin/magento module:enable EcomHouse_Base
bin/magento setup:upgrade
bin/magento cache:flush

Verify

bin/magento module:status EcomHouse_Base

Expected: Module is enabled. In the admin panel you should now see the ecomhouse top-level menu and the EcomHouse Extensions tab under Stores → Configuration.

Configuration

None — Base registers only the shared tab/menu; it has no settings of its own.

How to use

See docs/how-to-use.md for verifying the install and troubleshooting a missing menu/tab.

Uninstalling

Only uninstall if no other ecomhouse/* module is installed — Base is a hard dependency of the rest of the fleet. Removing it breaks their admin menu, config sections and ACL.

bin/magento module:disable EcomHouse_Base
composer remove ecomhouse/base
bin/magento setup:upgrade
bin/magento cache:flush

Support

• Email: opensource@ecom.house
• Website: https://ecom.house/
• Changelog: CHANGELOG.md
• License: OSL-3.0