HK2 Core

Overview

The HK2 Core module is the foundational base module for all Magento 2 HK2 extensions. It establishes standard administrative configurations, reusable backend blocks, and standardized headers for module configuration screens.

🎯 Use Cases

• Module Base: Required by all other HK2 extensions (AddBootstrap5, CSP, ScrollTop, etc.) to function correctly.
• Admin Consolidation: Consolidates HK2 module configurations into a single, organized tab in the Magento Admin Panel.

🚀 Features

• ⚙️ Registers a centralized "HK2 Extensions" configuration tab.
• 📂 Sets up a main admin menu item under System for HK2.
• 🔒 Implements a root ACL resource for all HK2 modules.
• 🎨 Provides a reusable ModuleHeader block for consistent branding.

🏗 Architecture

• Core Module Components: Base adminhtml system configurations.
• Design Patterns: Standard Magento UI configuration implementations.

🧩 Magento Components

Blocks

• HK2\Core\Block\Adminhtml\System\Config\ModuleHeader

Layout XML

• HK2_Core::system/config/module_header.phtml

📦 Requirements

• Magento version: 2.4.4 - 2.4.9
• PHP requirements: 8.1 || 8.2 || 8.3 || 8.4
• Composer requirements: magento/framework: ^103.0.0

⚙️ Installation

1. composer require hk2/core
2. bin/magento module:enable HK2_Core
3. bin/magento setup:upgrade
4. bin/magento setup:di:compile
5. bin/magento cache:flush

🔧 Configuration

This module primarily provides configuration tabs for other modules. No specific configuration is required for the Core module itself.

Usage

This module works silently in the background. Once installed, navigating to Stores > Configuration will display a new "HK2" tab where dependent modules will render their settings.

🗄 Database Changes

Not Applicable

📂 Module Structure

Block/
├── Adminhtml/
│   └── System/
│       └── Config/
│           └── ModuleHeader.php
etc/
├── adminhtml/
│   ├── menu.xml
│   └── system.xml
├── acl.xml
└── module.xml
view/
└── adminhtml/
    └── templates/
        └── system/
            └── config/
                └── module_header.phtml

🧪 Testing

Not Applicable

📈 Performance Considerations

Not Applicable

🔐 Security Considerations

• ACL usage: Defines HK2_Core::root base ACL for administrative access to HK2 configurations.

Compatibility

Reference: docs/compatibility.md

🔄 Upgrade Notes

Not Applicable

🛠 Troubleshooting

If HK2 tabs do not appear in the admin panel, ensure that the cache has been flushed and HK2_Core is enabled using bin/magento module:status.

🤝 Contributing

Contributions are welcome! If you'd like to improve the installer:

• ⭐ Star this repository (Helps others find it!)
• 🍴 Fork the project
• 🐛 Report bugs
• 💡 Suggest new features
• 🤝 Contribute improvements

Every ⭐ helps increase the visibility of the project and motivates further development.

⚖️ Disclaimer

The author provides this installation script "as is" without any warranties. Users are responsible for ensuring that running this script complies with their internal security and software requirements.

🤝 Support

For bug reports, feature requests, and general support:

• Author: Basant Mandal
• Email: [email protected]
• Website: https://www.basantmandal.in

License

This project is licensed under the OSL 3.0 License. See the LICENSE.txt file for details.

1.0.0 (2026-07-16)

⚠ BREAKING CHANGES

• add HK2 Core module with initial files and configurations

✨ Features

• add HK2 Core module with initial files and configurations (0a349e4)