Maho-Specific Modules

Maho introduces several native modules that are not part of the original Magento or OpenMage heritage. These modules provide modern e-commerce features like built-in blogging, gift card management, advanced marketing automation tools, and developer intelligence services.

Core Maho Modules

The following table summarizes the primary modules unique to the Maho platform:

Module	Purpose	Key Entities
Blog	Integrated content management system for articles and categories.	Maho_Blog_Model_Post, Maho_Blog_Model_Category
GiftCard	Digital and physical gift certificate product type with balance tracking.	Maho_GiftCard_Model_Giftcard
Feed Manager	Tool for generating product feeds for external marketplaces (Google, Meta).	Maho_FeedManager_Model_Feed
Customer Segmentation	Rule-based customer grouping for targeted marketing and automation.	Maho_CustomerSegmentation_Model_Segment
Catalog Link Rules	Automated management of Related, Up-sell, and Cross-sell products.	Maho_CatalogLinkRule_Model_Rule
Intelligence	LSP and MCP servers providing IDE support and AI context.	Maho_Intelligence_Model_Lsp_Server
Platform Enhancements	System-level improvements for security, performance, and CMS.	Maho_AdminActivityLog, Maho_ShippingBridge, Maho_Paypal

---

Blog Module

The Maho_Blog module provides a fully integrated blogging system. It features a robust admin interface for managing posts and hierarchical categories. The module supports SEO metadata per post and category, including meta titles, keywords, descriptions, and robots tags app/code/core/Maho/Blog/Model/Post.php28-38

Posts are stored using a hybrid EAV approach where core attributes like title, url_key, and publish_date are stored as static columns in the main entity table for performance app/code/core/Maho/Blog/Model/Resource/Post.php52-65 The module includes a dedicated router for clean URLs app/code/core/Maho/Blog/Controller/Router.php and supports frontend rendering with template processors to handle CMS-style directives like {{media}} or {{widget}} app/code/core/Maho/Blog/Model/Post.php118-129 It also integrates with the core sitemap system for SEO app/code/core/Mage/Sitemap/Model/Sitemap.php145-155

For details, see Blog Module.

Sources: app/code/core/Maho/Blog/Model/Post.php19-130 app/code/core/Maho/Blog/controllers/IndexController.php12-81 app/code/core/Maho/Blog/Block/Category/Sidebar.php14-95 app/code/core/Maho/Blog/Model/Resource/Post.php12-26

---

Gift Card Module

The Maho_GiftCard module introduces a new product type to the catalog. It manages the entire lifecycle of a gift card, from purchase and automated code generation to checkout redemption and balance tracking. It integrates directly into the sales totals (quote/order) to allow customers to pay for orders using their gift card balance.

For details, see Gift Card Module.

---

Feed Manager

The Maho_FeedManager is a high-performance tool designed to export catalog data to external platforms like Google, Facebook, Bing, and Pinterest app/code/core/Maho/FeedManager/Model/Platform/Google.php19-22 It supports dynamic attribute mapping via Maho_FeedManager_Model_DynamicRule app/code/core/Maho/FeedManager/Model/DynamicRule.php35-43 category mapping via specialized controllers app/code/core/Maho/FeedManager/controllers/Adminhtml/Feedmanager/CategoryController.php13-14 and automated generation.

The system uses Platform Adapters to implement specific requirements, such as ISO 8601 date formatting for shopping feeds app/code/core/Maho/FeedManager/Helper/Date.php24-31 Rules support multiple conditions with "first-match-wins" evaluation to determine output values app/code/core/Maho/FeedManager/Model/DynamicRule.php16-17

For details, see Feed Manager.

Sources: app/code/core/Maho/FeedManager/Model/DynamicRule.php1-43 app/code/core/Maho/FeedManager/Model/Platform/Google.php19-80 app/code/core/Maho/FeedManager/controllers/Adminhtml/Feedmanager/CategoryController.php82-113 app/code/core/Maho/FeedManager/Helper/Date.php13-49

---

Customer Segmentation and Catalog Link Rules

These modules provide advanced automation for marketing and catalog management:

• Customer Segmentation: Uses a rule engine to group customers based on behavior, attributes, or order history.
• Catalog Link Rules: Automates the linking of products (Related, Cross-sell, Up-sell) based on predefined conditions. Managed via the Maho_CatalogLinkRule_Adminhtml_Cataloglinkrule_RuleController app/code/core/Maho/CatalogLinkRule/controllers/Adminhtml/Cataloglinkrule/RuleController.php14-16
• Dynamic Categories: Maho extends the catalog system to support dynamic category rules, allowing products to be automatically assigned to categories based on conditions app/code/core/Mage/Catalog/sql/maho_setup/maho-25.6.0.php17-61

For details, see Customer Segmentation and Catalog Link Rules.

Sources: app/code/core/Maho/CatalogLinkRule/controllers/Adminhtml/Cataloglinkrule/RuleController.php14-63 app/code/core/Mage/Catalog/sql/maho_setup/maho-25.6.0.php17-79 app/code/core/Mage/Catalog/Model/Resource/Category/Dynamic/Rule.php11-34

---

Platform Enhancements

Maho includes several targeted enhancements to improve the base platform experience:

• AdminActivityLog: An encrypted audit trail that records administrative actions.
• ShippingBridge: A standardized interface for integrating with external shipping APIs.
• SpeculationRules: Implements modern browser "Speculation Rules" to provide prefetch and prerender hints.
• ContentVersion: Provides versioning and snapshots for CMS Pages and Blocks.
• Directory Data Import: A CLI command sys:directory:regions:import to fetch and update regional data from ISO 3166-2 standards lib/MahoCLI/Commands/SysDirectoryRegionsImport.php26-30
• Maho_Paypal: A modern PayPal integration supporting Advanced Checkout (Card Fields) app/code/core/Maho/Paypal/controllers/CheckoutController.php90 Vaulting app/code/core/Maho/Paypal/Model/Api/OrderBuilder.php80-99 and a robust Webhook Processor app/code/core/Maho/Paypal/Model/Webhook/Processor.php32-70
• Payment Restrictions: Advanced rule-based system to deny specific payment methods based on quote or customer conditions app/code/core/Mage/Payment/Model/Restriction.php39-79

For details, see Platform Enhancements.

Sources: lib/MahoCLI/Commands/SysDirectoryRegionsImport.php26-114 app/code/core/Mage/Payment/Model/Restriction.php11-79 app/code/core/Maho/Paypal/Model/Webhook/Processor.php15-30

---

Maho Intelligence (LSP and MCP)

The Maho_Intelligence module provides deep integration between the Maho codebase and external tools like IDEs and AI assistants.

• LSP Server: Implements the Language Server Protocol to provide features like completion, definition, and hover.
• XML Indexing: It maintains an index of Maho's XML structure to provide context-aware autocompletion for configuration files.
• MCP Server: Provides a Model Context Protocol server to give AI agents a structured understanding of the Maho environment.

For details, see Maho Intelligence (LSP and MCP Servers).

---

System Architecture: Native Module Integration

Feed Manager Data Flow

This diagram illustrates how product data is transformed through the Feed Manager system using platform-specific adapters and dynamic rules.

Sources: app/code/core/Maho/FeedManager/Model/Platform/Google.php19-33 app/code/core/Maho/FeedManager/Model/DynamicRule.php35-52 app/code/core/Maho/FeedManager/controllers/Adminhtml/Feedmanager/CategoryController.php82-108 app/code/core/Maho/FeedManager/Helper/Date.php24-31

Directory Region Import Logic

This diagram shows the flow of the sys:directory:regions:import command which modernizes region management.

Sources: lib/MahoCLI/Commands/SysDirectoryRegionsImport.php26-32 lib/MahoCLI/Commands/SysDirectoryRegionsImport.php116-140 app/locale/en_US/Mage_Directory.csv69-88

Blog Data Persistence Architecture

This diagram illustrates the hybrid EAV/Static approach used by the Blog module for optimized performance.

Sources: app/code/core/Maho/Blog/Model/Resource/Post.php12-26 app/code/core/Maho/Blog/Model/Resource/Post.php52-65 app/code/core/Maho/Blog/Model/Resource/Post.php81-110