npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

medusa-multilingual-tolgee

v1.0.2

Published

Translate your product information with ease.

Downloads

627

Readme

Medusa Multilingual Tolgee Plugin

About the plugin

This plugin integrates Medusa eCommerce with Tolgee, an open-source localization platform, to provide an easy translation management solution. It's designed to simplify product data translation without the need for complex CMS or PIM systems. By leveraging Tolgee, users access powerful localization features directly within their Medusa admin panel.

Medusa Multilanguage Tolgee GIF

Key Features of Tolgee

  • In-Context Translating: Utilize Tolgee’s development tools to translate content directly on the frontend, providing a real-time, intuitive translating experience.
  • Translation Assistance: Enhance translation accuracy and speed with automatic translation suggestions powered by leading AI services such as DeepL, Google Translate, and AWS Translate.
  • Collaborative Workflows: Streamline the translation process with features that support collaboration, allowing teams to easily review and approve translations, ensuring consistency and quality.

Tolgee is all about making the translation process as simple as possible. For more details on the extensive capabilities of Tolgee, visit their official website: Tolgee.io

Plugin features

| Feature | Status | |------------------------------------------------|------------| | Admin widget to manage product translations | ✅ | | Add product translations | ✅ | | Sync all product with Tolgee | ✅ | | Automatically add translations when product is added | ✅ | | Automatically remove translations when product is removed | ✅ | | Support for collections | Coming soon | | Support for categories | Coming soon | | Support for nested product data eg. variant data | Coming soon | | Support for custom attributes | Coming soon |

How to use

Set up your Tolgee project

Before configuring the Medusa plugin, ensure your Tolgee project is ready. You can either set up an open-source version of Tolgee on your own infrastructure or opt for the managed cloud version offered by Tolgee. Obtain your project ID from the project's dashboard URL (e.g., https://app.tolgee.io/projects/YOUR_PROJECT_ID).

Install the plugin

npm install medusa-multilingual-tolgee

or

yarn add medusa-mulitilingual-tolgee

Add plugin configurations to medusa-config.js

Once your Tolgee project is set up, add the plugin configuration to your Medusa store by modifying the medusa-config.js file. Here's what you need to include:

const plugins = [
  {
    resolve: `medusa-multilingual-tolgee`,
    options: {
      baseURL: process.env.MEDUSA_ADMIN_TOLGEE_API_URL,
      apiKey: process.env.MEDUSA_ADMIN_TOLGEE_API_KEY,
      defaultLanguage: "en",
      availableLanguages: [
        { label: "English", tag: "en" },
        { label: "German", tag: "de" },
        { label: "Polish", tag: "pl" },
      ],
      productsKeys: ["title", "subtitle", "description"],
      projectId: "your_tolgee_project_id",
      enableUI: true,
    },
  },
];

Configuration options:

  • defaultLanguage: This is the default language for your translations. By default, set to "en" for English, but it can be adjusted based on your primary audience.
  • availableLanguages: This array contains objects defining the languages you want to support. Each object should have a label, which is the display name of the language, and a tag, which is the language code (as defined in your Tolgee project). Make sure these tags match the language tags in your Tolgee project.
  • productsKeys: Specify which properties of the Medusa product data should be translatable. Common keys include "title", "subtitle", and "description", but you can specify any other fields you need translated.
  • projectId: Your Tolgee project ID, which you can find in the URL of your project dashboard on the Tolgee platform.
  • enableUI: Set this to true to enable the translation management UI components within the Medusa admin. This will allow users to manage translations directly from the Medusa admin panel.

Set Environment Variables in Medusa

MEDUSA_ADMIN_TOLGEE_API_URL=your_tolgee_app_url
MEDUSA_ADMIN_TOLGEE_API_KEY=your_tolgee_api_key

Explanation of Variables

  • MEDUSA_ADMIN_TOLGEE_API_URL: This is the base URL where your Tolgee instance is hosted. If you are using the Tolgee cloud service, this will be https://app.tolgee.io. If you have a self-hosted instance, replace this URL with the URL of your own deployment.
  • MEDUSA_ADMIN_TOLGEE_API_KEY: You can find or generate a new API key by navigating to /account/apiKeys within your Tolgee dashboard. If you haven't generated an API key yet, create one by following the prompts in the Tolgee interface.

Sync all your products with Tolgee

After configuring your environment variables and setting up the plugin, it's time to synchronize your product data with Tolgee to enable translations across your e-commerce platform. Here's how to complete the synchronization process and start translating your products:

Restart Medusa: First, ensure that all your changes are saved, then restart your Medusa server to apply the new configuration settings. This ensures that all components are loaded correctly, including the newly configured translation management plugin.

Access the Translation Management Section: Navigate to the product edit page within your Medusa admin panel. Here's what you need to do:

Scroll to the Translation Management Section: On the product edit page, scroll down until you find a new section labeled "Translation Management". This section is added by the medusa-multilingual-tolgee plugin and provides the tools necessary for managing product translations.

Medusa Multilingual Tolgee Plugin

Initiate the Sync Process: Click on the "Sync all translations" button within the Translation Management section. This action triggers a batch job that communicates with Tolgee to create translations for existing products.

Wait for Completion: After clicking the sync button, the process may take some time depending on the number of products and the complexity of the translations.

Medusa Multilingual Tolgee Plugin

Congratulations! Your configuration is now complete, and you can start translating all of your products. 🎉

If you want to translate a word, press the ALT button and click on the word in the Value column.

How to use it on the frontend

-Next.js Pages Router: Tolgee Pages Router

-Next.js App Router: Tolgee App Router

-Step-by-step guide of using it with Medusa storefront: Coming soon

Need help?

If you have any questions, need help with installing or configuring the plugin, or require assistance with your Medusa project—we are here to help!

About us

We are battle-tested Medusa.js Experts & JavaScript Masters - Our software house specializes in B2B & Multi-Vendor Marketplace eCommerce development.

How can we help you?

  • Consulting in the field of strategy development
  • Composable eCommerce development in Medusa.js
  • System maintenance and long-term support
  • Support in ongoing Medusa projects
  • Medusa Plugin development
  • Ecommerce & data migration

Check out our project featured on Medusa: https://medusajs.com/blog/patyna/

Contact us

💻 https://rigbyjs.com/en#contact

📧 [email protected]

Useful Links

License

Licensed under the MIT License.