Feed Manager v26.3+

1. Introduction

Welcome to Maho FeedManager - a powerful module for exporting your product catalog to shopping platforms and marketplaces. Whether you're selling on Google Shopping, Facebook, Pinterest, or regional platforms like Idealo and Trovaprezzi, FeedManager makes it easy to create, customize, and automate your product feeds.

Supported Platforms

Key Features

• Visual Mapping Builders - Drag-and-drop interface for XML, CSV, and JSON feeds
• Category Taxonomy Mapping - Map store categories to platform taxonomies (e.g., Google Product Categories)
• Dynamic Rules - Conditional logic for computed values (stock status, sale prices, etc.)
• Configurable Product Handling - Smart parent/child product relationships
• Transformers - Modify data on-the-fly (price adjustments, text formatting)
• Formats & Regional Settings - Per-feed price formatting, currency, and tax configuration
• Automated Scheduling - Hourly, daily, or custom generation schedules
• SFTP/FTP Uploads - Automatically push feeds to destinations
• Failure Notifications - Email and admin inbox alerts when feeds fail

2. Getting Started

Accessing FeedManager

Navigate to Catalog > Feed Manager in your Maho admin panel. You'll see four main sections:

• Feeds - Manage your product feeds
• Dynamic Rules - Create conditional attribute rules
• Category Mapping - Map store categories to platform taxonomies
• Destinations - Configure SFTP/FTP upload targets

Module Configuration

Go to System > Configuration > Catalog > Feed Manager to configure:

3. Creating Your First Feed

Step 1: Basic Settings

Click "Add New Feed" and fill in the General tab:

The General tab also includes Schedule, Upload Settings (destination, auto-upload, gzip compression), and Notification settings.

Step 2: Product Selection

In the Filters tab, configure which products to include:

• Exclude Disabled - Skip disabled products
• Exclude Out of Stock - Skip products with no stock
• Product Types - Select which product types to include (simple, configurable, grouped, bundle, virtual, downloadable)
• Product Conditions - Standard rule conditions for advanced filtering (see Product Filtering)

Step 3: Attribute Mapping

The Mapping tab is where you define your feed structure. See the Mapping Builders section for details.

Step 4: Preview & Generate

Use the Preview tab to test your feed with a sample of products. When satisfied, click "Generate Now" to create the full feed.

4. Mapping Builders

FeedManager provides visual builders for each output format. All builders share the same powerful options for data sources.

Data Source Types

XML Structure Builder

Build nested XML structures with full control over elements, attributes, CDATA, and namespaces.

<item>
  <g:id>SKU123</g:id>
  <g:title><![CDATA[Product Name Here]]></g:title>
  <g:price>29.99 AUD</g:price>
  <g:availability>in stock</g:availability>
  <g:shipping>
    <g:country>AU</g:country>
    <g:price>9.95 AUD</g:price>
  </g:shipping>
</item>

CSV Column Builder

Define columns, their order, and data sources. Configure delimiter (comma, tab, pipe) and text enclosure.

id,title,description,price,availability,link
SKU123,"Product Name","Product description here",29.99,in stock,https://store.com/product

JSON Structure Builder

Create nested JSON objects with arrays and proper data types.

{
  "products": [
    {
      "id": "SKU123",
      "title": "Product Name",
      "price": 29.99,
      "variants": [
        {"size": "S", "color": "Red"},
        {"size": "M", "color": "Blue"}
      ]
    }
  ]
}

5. Using Parent Product Data

When exporting configurable product children, you often need data from the parent product. FeedManager's "Use Parent" feature handles this elegantly.

Use Parent Modes

6. Category Mapping

Most shopping platforms require products to be categorized using their own taxonomy. For example, Google Shopping uses the Google Product Taxonomy with over 6,000 categories. FeedManager lets you map your store categories to platform categories once, and all feeds using that platform will automatically use the correct values.

Accessing Category Mapping

Navigate to Catalog > Feed Manager > Category Mapping. Select a platform from the dropdown at the top to begin mapping.

How It Works

1. Select a platform from the dropdown (e.g., Google, Facebook, Bing)
2. Your store's category tree is displayed on the left
3. For each category, type into the search field to find the matching platform category
4. The search queries the bundled taxonomy file and shows matching results in a dropdown
5. Click a result to apply the mapping

Mappings are global per platform -- once you map a category for Google, all Google Shopping feeds will use that mapping automatically via the "Category Taxonomy" source type.

Taxonomy Search

The search field supports multi-word queries. For example, typing tennis shoes will match any taxonomy entry containing both words. Results show the full category path and ID:

Bulk Mapping

To quickly apply the same platform category to multiple store categories:

1. Map one category first, then click its Copy button
2. The page enters Bulk Mode -- the source row highlights in blue
3. Click any other category row to apply the same mapping
4. Use Shift+Click to apply to a range of categories
5. Press Escape or click "Exit Bulk Mode" to finish

Auto-Map Unmapped

Click the "Auto-Map Unmapped" button to automatically match unmapped store categories to platform taxonomy entries by name. This uses a simple name-based search and takes the first result, so it's best used as a starting point that you then review and correct manually.

Using Category Mappings in Feeds

In your feed's attribute mapping, set the source type to "Category Taxonomy" and the source value to the platform code (e.g., google). FeedManager will automatically find the deepest (most specific) mapped category for each product and output the platform's category path.

Supported Taxonomies

7. Dynamic Rules

Dynamic Rules let you create conditional, computed values based on product attributes. Think of them as "IF-THEN-ELSE" logic for your feed data.

How Dynamic Rules Work

A Dynamic Rule consists of multiple output rows, evaluated top-to-bottom. The first row whose conditions match determines the output. If no conditions match, the last row (usually a default) is used.

Pre-Built Rules

Conditions

Dynamic Rules use the standard Maho rule conditions widget -- the same interface used by Catalog Price Rules and Cart Price Rules. Each rule's Conditions tab lets you build conditions using a visual, point-and-click interface.

Available condition operators include:

Creating Custom Rules

8. Transformers

Transformers modify attribute values before they're added to your feed. You can chain multiple transformers together.

Available Transformers

Transformers are grouped by category in the UI.

Text Formatting:

Values & Defaults:

Numbers & Prices:

Dates & URLs:

Advanced:

Transformer Syntax

Chain transformers using the pipe character: transformer1|transformer2:option=value

strip_tags|truncate:max_length=5000,suffix=...

format_price:decimals=2,currency=AUD

map_values:1=in stock,0=out of stock

combine_fields:template={{brand}} - {{name}} ({{color}})

combine_fields:template={{brand}} {{name}}|truncate:max_length=150

round:precision=2,mode=ceil|format_price:currency=EUR,decimal_separator=','

format_date:output_format=Y-m-d

prepend_append:prepend=https://store.com/,append=?utm_source=feed

9. Formats & Regional Settings

Each feed has its own formatting and regional settings, configured in the Mapping tab under Formats & Regional Settings. These control how prices, numbers, and URLs are formatted in the output.

Number Format Presets

Select a preset to quickly configure decimal and thousands separators, or choose "Custom" to set them manually.

Price Settings

Other Output Settings

10. Product Filtering

Use the Product Conditions widget in the Filters tab to precisely control which products appear in your feed. This uses the same rule conditions interface as Catalog Price Rules and Cart Price Rules.

How Conditions Work

The conditions widget uses a visual, point-and-click interface:

1. Click the green + button to add a new condition
2. Select a product attribute (e.g., price, category, SKU)
3. Choose an operator (is, is not, greater than, contains, etc.)
4. Set the comparison value

Conditions can be nested with ALL (AND) or ANY (OR) logic using the "If ALL/ANY of these conditions are TRUE" selector.

Common Filter Patterns

11. Upload Destinations

Automatically upload generated feeds to SFTP/FTP servers.

Creating a Destination

Navigate to Catalog > Feed Manager > Destinations and click "Add New Destination".

Linking Feeds to Destinations

In your feed's General tab, select the destination and enable "Auto Upload" to automatically push the feed after each generation.

12. Notifications

FeedManager can alert you when feed generation or upload fails. Notifications are configured per-feed in the feed edit form.

Notification Settings

Notification Methods

Notification Frequency

What Triggers Notifications

• Generation failure -- Feed generation encounters errors (validation, product processing, etc.)
• Upload failure -- Feed file fails to upload to a configured destination
• Timeout -- Feed generation is stuck for more than 30 minutes

13. Scheduling & Automation

Schedule Options

Cron Jobs

FeedManager registers these cron jobs:

• feedmanager_generate_scheduled - Runs hourly, generates feeds based on their schedules
• feedmanager_cleanup_logs - Runs daily at 3:30 AM, removes old logs

./maho cron:run

14. CLI Commands

FeedManager provides command-line tools for automation and debugging.

Available Commands

# List all feeds with status
./maho feed:list

# Generate a specific feed
./maho feed:generate 4

# Generate all enabled feeds
./maho feed:generate:all

# Generate all feeds (including disabled)
./maho feed:generate:all --include-disabled

# Validate a feed without regenerating
./maho feed:validate 4

# Generate Google feed at 2 AM and 2 PM daily
0 2,14 * * * cd /var/www/html && ./maho feed:generate 4

# Generate all feeds every 4 hours
0 */4 * * * cd /var/www/html && ./maho feed:generate:all

15. Troubleshooting

Common Issues

Checking Logs

Generation logs are stored in the database and viewable in the feed's Logs tab. System errors are logged to:

var/log/system.log
var/log/exception.log

Getting Help

For issues or feature requests, visit: github.com/MahoCommerce/maho