Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

chore: fix typos on README.MD #13

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open

chore: fix typos on README.MD #13

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
53 changes: 26 additions & 27 deletions README.MD
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -50,85 +50,84 @@ Magento CE > 2.2.5

### Composer
Go to Magento 2 Root Folder and execute following commands as web user (mostly www-data).
```
composer config repositories.aromicon_deepl vcs [email protected]:aromicon/magento2-deepl.git

```bash
composer require aromicon/module-deepl
bin/magento module:enable Aromicon_Deepl
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:enable (only needed, if caches were enabled before)
bin/magento cache:enable # (only needed if caches were enabled before)
```

### Manual (not recommended)
Go to your Magento 2 root directory and create a folder app/code/Aromicon/Deepl. Extract Archive to this folder and
execute following commands as web user (mostly www-data).
Go to your Magento 2 root directory and create a folder `app/code/Aromicon/Deepl`. Extract Archive to this folder and
execute following commands as web user (usually www-data).

```
```bash
bin/magento module:enable Aromicon_Deepl
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:enable (only needed, if caches were enabled before)
bin/magento cache:enable # (only needed, if caches were enabled before)
```

## Magento 2 Configuration

Aromicon Deepl Translation Configuration can be found under ```Stores > Configuration > Aromicon > Deepl Translate```

First, you need to Specifiy your Default Storeview, this is your storeview where you normally add your content ind your default language.

Second, you need to chosse between API Version wih depends on Your Account. You can choose "Free" or "Pro"

Third, you need to enter your API Key provided by [DeepL Pro](https://www.deepl.com/pro.html).
1. Specify your Default Store View – the Store View where you normally add your content in your default language.
2. Choose which API Version corresponds to Your Account. You can choose "Free" or "Pro".
3. Enter your API Key provided by [DeepL Pro](https://www.deepl.com/pro.html).

You can also configure, which fields should be translated by default for CMS Pages, Products and Categories.

## Usage

All translation will be added per storeview. The target language will be recieved from your storeview locale settings.
All translations will be added per Store View. The target language will be recieved from your Store View locale settings.

### Translate Magento 2 CMS Blocks

Goto ```Content > CMS > Blocks``` and open the block, you want to translate. At the edit form on top right corner,
there will be a new Translate Button. Select the Storeview, where the Block should be translated and copied.
By Default the block will be copied to selected storeview and the Title and Content will be translated.
Go to ```Content > CMS > Blocks``` and open the block you want to translate. At the edit form on top right corner,
there will be a new Translate Button. Select the Store View, where the Block should be translated and copied.

By default the block will be copied to selected Store View and the Title and Content will be translated.

### Translate CMS Pages

Goto ```Content > CMS > Pages``` and open the page, you want to translate. At the edit form on top right corner,
there will be a new Translate Button. Select the Storeview, where the Block should be translated and copied.
By Default the page will be copied to selected storeview and the Title, Url Key, Meta Information and Content will be translated.
Go to ```Content > CMS > Pages``` and open the page you want to translate. At the edit form on top right corner,
there will be a new Translate Button. Select the Store View, where the CMS Page should be translated and copied.

By Default the page will be copied to selected Store View and the Title, Url Key, Meta Information and Content will be translated.

### Translate Attributes

All Magento 2 Attributes can be translated, but only the Store Labels will be translated. If the attribute is a dropdown or multiselect
attribute, without a custom source model, the option walues will be translated as well.

Goto ````Stores > Attributes > Product```` and select the needed attribute. Use the translate button on top right corner.
Go to ````Stores > Attributes > Product```` and select the needed attribute. Use the translate button on top right corner.


### Translate Magento 2 Categories

Name, Page Title, Content, Url Key and Meta Information will be translated on Categories. If you open a Category you will see the Translate button on top right corner.
Translated Content will be copied to the selected storeview.
Translated Content will be copied to the selected Store View.

### Translate Products

By Default Name, Short Description, Description, Url Key and Meta Information will be translated. You can also configure
By default, Name, Short Description, Description, Url Key and Meta Information will be translated. You can also configure
all attributes of type text or textarea to be translated as well. Just go to your Product Edit View and hit the Translate
Button for your desired storeview. Translated data will be copied to selected storeview.
Button for your desired Store View. Translated data will be copied to the selected Store View.

### Translate Products Reviews

Product Reviews can be translated too. Just go to ```Marketing > User Content > Reviews``` and open a review,
then select a storeview from the Translate Button.
then select a Store View from the Translate Button.

## Aromicon Deepl Pro
You are looking for Batch Translation from Backend or Console? Try our [Aromicon Translate Pro Magento 2 Module](https://www.aromicon.de/magento-download-extensions-modules/de/magento-2-translate-pro.html)

Are you looking for Batch Translation from Backend or Console? Try our [Aromicon Translate Pro Magento 2 Module](https://www.aromicon.de/magento-download-extensions-modules/de/magento-2-translate-pro.html)

## Support

Pull request, issues and features are always welcome.
Pull requests, issues and features are always welcome.

<p align="center">
<small>We ❤ Magento. by [aromicon](https://www.aromicon.de)</small><br/>
Expand Down