PHPackages                             nativemind/module-translation - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Localization &amp; i18n](/categories/localization)
4. /
5. nativemind/module-translation

ActiveMagento2-module[Localization &amp; i18n](/categories/localization)

nativemind/module-translation
=============================

Advanced translation module for Magento 2 with Google Translate and OpenAI integration. v2.0 includes comprehensive Admin API, queue management system, and React microservice for translation administration.

v1.1.0(7mo ago)101NativeMindNONCPHPPHP ^7.4.0|^8.0|^8.1|^8.2

Since Sep 21Pushed 7mo ago1 watchersCompare

[ Source](https://github.com/libsPHP/magento-translation)[ Packagist](https://packagist.org/packages/nativemind/module-translation)[ RSS](/packages/nativemind-module-translation/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (6)Versions (3)Used By (0)

NativeMind Translation Module for Magento 2
===========================================

[](#nativemind-translation-module-for-magento-2)

[![Latest Stable Version](https://camo.githubusercontent.com/bf4b3c905afe4fdeaa25c3c3cb4f79ec0c965f371066fb32f4e339f6b0b4efa6/68747470733a2f2f706f7365722e707567782e6f72672f6e61746976656d696e642f6d6f64756c652d7472616e736c6174696f6e2f762f737461626c65)](https://packagist.org/packages/nativemind/module-translation)[![License](https://camo.githubusercontent.com/1ac0b67ef01a7c9fe018dc3d855f22dc768ed6fb317dc9243317acb09768ba69/68747470733a2f2f706f7365722e707567782e6f72672f6e61746976656d696e642f6d6f64756c652d7472616e736c6174696f6e2f6c6963656e7365)](https://packagist.org/packages/nativemind/module-translation)[![Total Downloads](https://camo.githubusercontent.com/eeed50e8c7529e44d2ce12e73453a54c8770841ebece3ae40b932e95e483255b/68747470733a2f2f706f7365722e707567782e6f72672f6e61746976656d696e642f6d6f64756c652d7472616e736c6174696f6e2f646f776e6c6f616473)](https://packagist.org/packages/nativemind/module-translation)

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

[](#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
------------

[](#installation)

### Via Composer (Recommended)

[](#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

[](#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
-------------

[](#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

[](#google-translate-setup)

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

### OpenAI Setup

[](#openai-setup)

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

Usage
-----

[](#usage)

### Console Commands

[](#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

[](#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

[](#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
------------

[](#requirements)

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

Compatibility
-------------

[](#compatibility)

Magento VersionModule Version2.4.x1.0.x2.3.x1.0.xSupport
-------

[](#support)

- 📧 **Email**:
- 🌐 **Website**:
- 📱 **Telegram**: @nativemind
- 🐛 **Issues**: [GitHub Issues](https://github.com/nativemind/module-translation/issues)

Contributing
------------

[](#contributing)

We welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md) for details.

License
-------

[](#license)

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

Changelog
---------

[](#changelog)

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

[](#v200--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](UPGRADE_TO_2.0.md) | [📊 Production Ready Report](PRODUCTION_READY_v2.0.md) | [🧪 Testing Report](TESTING_REPORT.md)

### v1.0.2

[](#v102)

- Translation status and date tracking
- Product attribute enhancements

### v1.0.1

[](#v101)

- Translation status attribute

### v1.0.0

[](#v100)

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

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance64

Regular maintenance activity

Popularity3

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~19 days

Total

2

Last Release

220d ago

PHP version history (2 changes)1.0.0PHP &gt;=7.4.0

v1.1.0PHP ^7.4.0|^8.0|^8.1|^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/a4cdaf11bda32d8493fd30cb229f9bb971778e4a5f377529828299f4f10a745b?d=identicon)[dodonov](/maintainers/dodonov)

---

Top Contributors

[![Anton-Dodonov](https://avatars.githubusercontent.com/u/7759385?v=4)](https://github.com/Anton-Dodonov "Anton-Dodonov (12 commits)")

---

Tags

magentoplugintranslationlocalizationi18ntranslationmultilingualopenaimagento2google-translate

### Embed Badge

![Health badge](/badges/nativemind-module-translation/health.svg)

```
[![Health](https://phpackages.com/badges/nativemind-module-translation/health.svg)](https://phpackages.com/packages/nativemind-module-translation)
```

###  Alternatives

[mollie/magento2

Mollie Payment Module for Magento 2

1121.6M10](/packages/mollie-magento2)[smile/elasticsuite

Magento 2 merchandising and search engine built on ElasticSearch

8044.5M33](/packages/smile-elasticsuite)[dotdigital/dotdigital-magento2-extension

Dotdigital for Magento 2

50374.2k18](/packages/dotdigital-dotdigital-magento2-extension)[tractorcow/silverstripe-fluent

Simple localisation for Silverstripe

92421.6k26](/packages/tractorcow-silverstripe-fluent)[inpsyde/multilingual-press

Simply THE multisite-based free open source plugin for your multilingual websites.

2414.0k1](/packages/inpsyde-multilingual-press)[smousss/laravel-globalize

Make Laravel projects translatable in a matter of seconds!

2266.3k](/packages/smousss-laravel-globalize)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
