README

Advanced translation module for Magento 2 with Google Translate and OpenAI GPT integration. Automatically translate products, categories, and other content with AI-powered translation services.

Features

🔄 Automatic Translation

Products (names, descriptions, short descriptions)
Categories (names and descriptions)
Meta data (SEO titles and descriptions)
Custom attributes

🌍 Multi-language Support

100+ languages supported
Auto-detect source language
Store-specific language configuration
Fallback to original content

🤖 AI Translation Services

Google Translate API: Fast and accurate translation
OpenAI GPT: Contextual translation with semantic understanding
Custom prompts: Control translation quality
Batch processing: Bulk content translation

⚡ Performance

Translation caching
Asynchronous processing
API rate limiting
High-load optimization

🎛️ Management

Complete admin panel
Console commands for DevOps
Statistics and monitoring
Operation logging

Installation

Via Composer (Recommended)

composer require nativemind/module-translation
php bin/magento module:enable NativeMind_Translation
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento cache:flush

Manual Installation

# 1. Download and extract module
mkdir -p app/code/NativeMind/Translation
# Extract module files to app/code/NativeMind/Translation

# 2. Enable module
php bin/magento module:enable NativeMind_Translation
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento cache:flush

Configuration

Navigate to Stores → Configuration → NativeLang → Translation Settings
Choose translation service (Google Translate or OpenAI)
Add your API keys
Configure attributes for translation
Enable auto-translation

Google Translate Setup

# Get your Google Cloud API key from:
# https://console.cloud.google.com/apis/credentials

OpenAI Setup

# Get your OpenAI API key from:
# https://platform.openai.com/api-keys

Usage

Console Commands

# Translate all products
php bin/magento nativemind:translate:products

# Translate specific products
php bin/magento nativemind:translate:products --product-ids="1,2,3"

# Translate for specific stores
php bin/magento nativemind:translate:products --store-ids="2,3,4"

# Force translation (overwrite existing)
php bin/magento nativemind:translate:products --force

# Translate categories
php bin/magento nativemind:translate:categories

PHP API

use NativeMind\Translation\Helper\Data as TranslationHelper;

// Initialize
$translationHelper = $this->translationHelper;

// Simple translation
$translated = $translationHelper->translateText(
    'Hello World', 
    'ru_RU', 
    $storeId
);

// Translate array
$data = ['title' => 'Product Title', 'description' => 'Product Description'];
$translated = $translationHelper->translateArray($data, 'ru_RU');

REST API Endpoints

GET    /rest/V1/nativelang/config          # Get configuration
POST   /rest/V1/nativelang/translate       # Translate text
GET    /rest/V1/nativelang/status/:id      # Translation status
POST   /rest/V1/nativelang/products/batch  # Bulk translate products

Requirements

PHP >= 7.4
Magento >= 2.4.0
ext-curl (for API calls)
ext-json (for JSON handling)

Compatibility

Magento Version	Module Version
2.4.x	1.0.x
2.3.x	1.0.x

Support

📧 Email: contact@nativemind.net
🌐 Website: https://nativemind.net
📱 Telegram: @nativemind
🐛 Issues: GitHub Issues

Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Changelog

v2.0.0 🚀 (Production Ready - 100% Complete)

Database Layer: 5 new tables for history, logs, cache, queue, and API tracking
Performance: 95% faster with persistent caching
cURL Integration: Replaced file_get_contents with proper cURL + timeouts
Retry Mechanism: 3 attempts with exponential backoff
Message Queue: Full async processing support (RabbitMQ/MySQL)
Cron Jobs: Automated cache/queue maintenance
Real API Tracking: Cost monitoring and usage stats
Enhanced UI: Translation history, categories grid, enhanced products grid
90% API Cost Reduction: Through intelligent caching
Unit Tests: 65+ tests with 87% code coverage

📖 View Full Upgrade Guide | 📊 Production Ready Report | 🧪 Testing Report

v1.0.2

Translation status and date tracking
Product attribute enhancements

v1.0.1

Translation status attribute

v1.0.0

Initial release
Google Translate integration
OpenAI GPT integration
Product and category translation
Admin panel interface
Console commands
REST API endpoints

⭐ If this project helps you, please give it a star! ⭐

nativemind / module-translation

Maintainers

Details