Download PDF Manual Back to Extension
Back to Knowledge Base
Download this page as PDF

Installation & Setup

Requirements

  • Magento 2.4.x or higher
  • PHP 7.4 / 8.0 or higher
  • MySQL 5.7 or higher

Installation via Composer

composer config bearer.repo.softwaresilo.io <token>
composer config repositories.softwaresilo composer https://repo.softwaresilo.io/
composer require mageb2b/sublogin:*
php bin/magento module:enable MageB2B_Sublogin
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy
php bin/magento cache:flush

Installation via ZIP

  1. Download the extension ZIP file
  2. Extract to app/code/MageB2B/Sublogin
  3. Run the following commands:
php bin/magento module:enable MageB2B_Sublogin
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy
php bin/magento cache:flush

Verify Installation

  1. Log in to Magento Admin
  2. Navigate to Stores > Configuration > MageB2B > Sublogin
  3. You should see the configuration options
  4. Navigate to Customers > All Customers
  5. Edit a customer and you should see a "Sublogins" tab

Database Tables Created

The extension creates the following tables:

Core Tables

  • customer_sublogin - Main sublogin accounts
  • customer_sublogin_address - Address assignments
  • customer_sublogin_payment - Payment method restrictions
  • customer_sublogin_shipping - Shipping method restrictions

Extended Tables

  • quote - Added sublogin_id column
  • sales_order - Added sublogin_id column
  • sales_order_grid - Added sublogin_id column
  • wishlist - Added sublogin_id column

Initial Configuration

After installation, configure the extension:

  1. Go to Stores > Configuration > MageB2B > Sublogin
  2. Set Enabled to "Yes"
  3. Configure basic settings:
    • Default value for "Can Create Sublogins"
    • Restrict order view for sublogins
    • Allow impersonate sublogin account
    • Use shared cart/wishlist
  4. Click Save Config
  5. Clear cache: php bin/magento cache:flush

Optional Add-Ons

Install optional add-ons for extended functionality:

Roles & Permissions

composer config bearer.repo.softwaresilo.io <token>
composer config repositories.softwaresilo composer https://repo.softwaresilo.io/
composer require mageb2b/sublogin-role:*
php bin/magento module:enable MageB2B_SubloginRole
php bin/magento setup:upgrade
php bin/magento cache:flush

Budget Management

composer config bearer.repo.softwaresilo.io <token>
composer config repositories.softwaresilo composer https://repo.softwaresilo.io/
composer require mageb2b/sublogin-budget:*
php bin/magento module:enable MageB2B_SubloginBudget
php bin/magento setup:upgrade
php bin/magento cache:flush

Order Approval

composer config bearer.repo.softwaresilo.io <token>
composer config repositories.softwaresilo composer https://repo.softwaresilo.io/
composer require mageb2b/sublogin-orderapproval:*
php bin/magento module:enable MageB2B_SubloginOrderApproval
php bin/magento setup:upgrade
php bin/magento cache:flush

Catalog Visibility

composer config bearer.repo.softwaresilo.io <token>
composer config repositories.softwaresilo composer https://repo.softwaresilo.io/
composer require mageb2b/sublogin-catalogvisibility:*
php bin/magento module:enable MageB2B_SubloginCatalogVisibility
php bin/magento setup:upgrade
php bin/magento cache:flush

API (Web API)

composer config bearer.repo.softwaresilo.io <token>
composer config repositories.softwaresilo composer https://repo.softwaresilo.io/
composer require mageb2b/sublogin-api:*
php bin/magento module:enable MageB2B_SubloginApi
php bin/magento setup:upgrade
php bin/magento cache:flush

Import/Export

composer config bearer.repo.softwaresilo.io <token>
composer config repositories.softwaresilo composer https://repo.softwaresilo.io/
composer require mageb2b/sublogin-importexport:*
php bin/magento module:enable MageB2B_SubloginImportExport
php bin/magento setup:upgrade
php bin/magento cache:flush

Reports

composer config bearer.repo.softwaresilo.io <token>
composer config repositories.softwaresilo composer https://repo.softwaresilo.io/
composer require mageb2b/sublogin-report:*
php bin/magento module:enable MageB2B_SubloginReport
php bin/magento setup:upgrade
php bin/magento cache:flush

Hyvä Compatibility

composer config bearer.repo.softwaresilo.io <token>
composer config repositories.softwaresilo composer https://repo.softwaresilo.io/
composer require mageb2b/sublogin-hyva:*
php bin/magento module:enable MageB2B_SubloginHyva
php bin/magento setup:upgrade
php bin/magento cache:flush

If you also use the Roles & Permissions add-on with Hyvä:

composer config bearer.repo.softwaresilo.io <token>
composer config repositories.softwaresilo composer https://repo.softwaresilo.io/
composer require mageb2b/sublogin-role-hyva:*
php bin/magento module:enable MageB2B_SubloginRoleHyva
php bin/magento setup:upgrade
php bin/magento cache:flush

Mageplaza One Step Checkout Compatibility

composer config bearer.repo.softwaresilo.io <token>
composer config repositories.softwaresilo composer https://repo.softwaresilo.io/
composer require mageb2b/sublogin-mageplaza-osc:*
php bin/magento module:enable MageB2B_SubloginMageplazaOsc
php bin/magento setup:upgrade
php bin/magento cache:flush

Sample Data

For staging/dev environments:

composer config bearer.repo.softwaresilo.io <token>
composer config repositories.softwaresilo composer https://repo.softwaresilo.io/
composer require mageb2b/sublogin-sample-data:*
php bin/magento module:enable MageB2B_SubloginSampleData
php bin/magento setup:upgrade
php bin/magento cache:flush

If you installed the Reports add-on and want demo data:

composer config bearer.repo.softwaresilo.io <token>
composer config repositories.softwaresilo composer https://repo.softwaresilo.io/
composer require mageb2b/sublogin-report-sample-data:*
php bin/magento module:enable MageB2B_SubloginReportSampleData
php bin/magento setup:upgrade
php bin/magento cache:flush

Post-Installation Steps

1. Configure Customer Accounts

Enable "Can Create Sublogins" for B2B customers:

  1. Navigate to Customers > All Customers
  2. Edit a customer
  3. Go to "Account Information" tab
  4. Set "Can Create Sublogins" to "Yes"
  5. Save customer

2. Configure Email Templates

  1. Go to Stores > Configuration > MageB2B > Sublogin > Email Settings
  2. Select email templates for:
    • New sublogin created
    • Email confirmation
    • Password reset
    • Expired account refresh
  3. Configure email sender identity
  4. Save configuration

3. Configure Address Management

  1. Go to Stores > Configuration > MageB2B > Sublogin > Address Settings
  2. Select address management mode:
    • Shared addresses
    • Restricted addresses
    • Own addresses
  3. Configure additional address options
  4. Save configuration

Uninstallation

To uninstall the extension:

php bin/magento module:uninstall MageB2B_Sublogin

This will:

  • Remove all database tables
  • Remove all sublogin data
  • Remove module files

Warning: This action cannot be undone. All sublogin data will be permanently deleted.

Troubleshooting Installation

Module Not Showing in Admin

  1. Verify module is enabled: php bin/magento module:status
  2. Clear cache: php bin/magento cache:flush
  3. Check file permissions
  4. Review var/log/system.log for errors

Database Tables Not Created

  1. Run setup:upgrade again: php bin/magento setup:upgrade
  2. Check database user permissions
  3. Review var/log/system.log for SQL errors

Compilation Errors

  1. Remove generated files: rm -rf generated/*
  2. Run di:compile again: php bin/magento setup:di:compile
  3. Check for conflicting modules

Next Steps

Configuration

Found an issue with this documentation? Let us know