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

1. Navigate to Stores → Configuration → NativeLang → Translation Settings
2. Choose translation service (Google Translate or OpenAI)
3. Add your API keys
4. Configure attributes for translation
5. 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

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! ⭐