STM B2B Register - Magento 2 Extension

B2B customer registration with admin approval workflow for Magento 2 / Adobe Commerce.

Features

• B2B Registration Form - Dedicated registration page with company details, contact person, address, and optional fields (VAT ID, customer number, salutation)
• Admin Approval Workflow - New B2B customers are set to "Pending" status and must be approved or rejected by an admin before they can log in
• Customer Grid Integration - B2B Status and Company columns in the customer grid with filter and sort support
• Mass Actions - Bulk approve/reject B2B customers directly from the customer grid
• Email Notifications - Configurable approval, rejection, and admin notification emails
• Google reCAPTCHA v2 - Optional spam protection for the registration form
• Registration Modes - Hybrid (B2B + B2C), B2B Only, or B2C Only with automatic redirects and link banners
• Customizable Form Design - Primary and secondary color picker in admin configuration
• Field Visibility Control - Configure which fields are shown (hidden, optional, or required) per store view
• Fully Translatable - English as primary language with German translation included (de_DE.csv)

Requirements

• Magento Open Source 2.4.x or Adobe Commerce 2.4.x
• PHP 8.1, 8.2, 8.3 or 8.4

Installation

Via Composer (recommended)

composer require storetown-media/module-b2b-register
bin/magento module:enable STM_B2bRegister
bin/magento setup:upgrade
bin/magento cache:flush

Manual Installation

1. Create the directory app/code/STM/B2bRegister/
2. Copy all module files into this directory
3. Run:

bin/magento module:enable STM_B2bRegister
bin/magento setup:upgrade
bin/magento cache:flush

Configuration

Navigate to Stores > Configuration > STM > B2B Register in the Magento Admin.

General Settings

Form Settings

Email Settings

Form Design

Google reCAPTCHA

Approval Workflow

1. Customer fills out the B2B registration form
2. Account is created with Pending status
3. Admin receives email notification (if enabled)
4. Customer cannot log in while status is Pending
5. Admin approves or rejects via:
   • Customer Edit Page - Approve/Reject buttons
   • Customer Grid - Mass actions for bulk operations
6. Customer receives approval/rejection email (if enabled)
7. On approval, customer group is updated automatically (if configured)

Events

The extension dispatches the following events for third-party integrations:

Translation

The extension uses English as the primary language. A German translation is included in i18n/de_DE.csv.

To add additional translations, create the corresponding CSV file in i18n/ (e.g., i18n/fr_FR.csv).

Running Tests

cd /path/to/magento
vendor/bin/phpunit -c app/code/STM/B2bRegister/phpunit.xml.dist

Code Quality

vendor/bin/phpcs --standard=Magento2 app/code/STM/B2bRegister/

The extension passes PHPCS Magento2 standard with 0 errors and 0 warnings (using the included phpcs.xml).

File Structure

STM/B2bRegister/
├── Api/                          # Service contracts
├── Block/                        # Frontend and admin blocks
├── Controller/                   # Frontend and admin controllers
├── Model/                        # Business logic, config, email
├── Plugin/                       # Login blocking, redirect, welcome email
├── Setup/Patch/Data/             # Data patches for customer attributes
├── Test/Unit/                    # PHPUnit test suite (97 tests)
├── Ui/Component/                 # Admin grid columns and form modifier
├── etc/                          # Module config, DI, routes, system.xml
├── i18n/                         # Translation files
├── view/frontend/                # Frontend templates, layouts, emails
├── view/adminhtml/               # Admin templates, UI components
├── composer.json
├── phpcs.xml
├── phpunit.xml.dist
└── registration.php

Support

For issues and feature requests, please contact Storetown Media.

License

Proprietary - All rights reserved.

Changelog

All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog.

[1.0.0] - 2026-04-24

Initial public release on the Adobe Commerce Marketplace.

Added

• Dedicated B2B registration page (/b2bregister/account/create) capturing
  company name, VAT ID / tax number, customer number, salutation, contact
  person, delivery address and phone number.
• Admin approval workflow: new accounts are placed in a configurable pending
  customer group and blocked from login until an admin approves or rejects
  them via the customer edit page or the customer grid mass actions.
• Customer grid integration with filterable and sortable B2B Status and
  Company columns, and the B2B Approve / B2B Reject mass actions.
• Four transactional email templates (registration confirmation, admin
  notification, approval, rejection), all editable under
  Marketing > Email Templates.
• Six configuration groups under Stores > Configuration > STM > B2B Register,
  scope-aware down to the store view: General, Form, Form Design, Email,
  Notice Texts and Google reCAPTCHA v2.
• Three registration modes: Hybrid (B2B + B2C with cross-links),
  B2B Only (standard registration redirected to B2B) and B2C Only
  (module installed but hybrid banner suppressed).
• Field visibility control (hidden / optional / required) for VAT ID,
  customer number and salutation, per store view.
• STM\B2bRegister\Api\B2bRegistrationInterface service contract with
  approve(), reject() and getStatus() methods.
• Dispatched events for CRM and marketing-automation integrations:
  stm_b2b_registration_before, stm_b2b_registration_after,
  stm_b2b_customer_approved, stm_b2b_customer_rejected,
  stm_b2b_newsletter_subscribe. The standard Magento
  customer_register_success event is dispatched for compatibility.
• English source language with German translation (i18n/de_DE.csv).
• Hyvä Theme and Luma-based theme compatibility (no JavaScript framework
  dependency on the frontend).

Compatibility

• Magento Open Source 2.4.x and Adobe Commerce 2.4.x
• PHP 8.1, 8.2, 8.3 and 8.4