Connect your POEditor account with a GitLab account to more easily manage the localization of language files hosted on this code hosting service.
Note that the localization project needs to be hosted on your POEditor account in order for you to be able to links the files on GitLab to the project languages. However, after these links are made, you can also allow the localization project admins to import/export strings using the integration.
1. Connect POEditor to the hosted version of GitLab
Go to Account Settings in POEditor and access the Integrations tab.
Click on GitLab and then click the Connect button. Log in to your GitLab account (if you aren't) and authorize the POEditor app.
In the GitLab Integration page, select a localization project from your POEditor account and a language in this project. Link the language to the desired file in your GitLab repo.
2. Connect POEditor to an installed version of GitLab
If you have GitLab Community Edition or Enterprise Edition installed on your server, you'll need to manually enter the server URL and token. Fill in the form in the GitLab Integration page with the Git Server URL (the URL of the API endpoint of your installed GitLab version) and the Access Token (you can generate one in the Profile Settings > Personal Access Tokens) and press Connect.
Managing translations and syncing the language files
Each linked language file has several non-automated options in the GitLab Integration page:
Get terms - Imports your terms from the GitLab file to the selected POEditor language
Import translations from GitLab - Imports translations from your GitLab repository to the language in your POEditor project. If project doesn't have any terms, you'll need to get the terms from GitLab first, and then import the translations. Export to GitLab - Exports your terms and translations in the linked language to the file selected by you in the linking stage. Add import rule - Adds a rule by which to tag strings on import. Add export filter - Adds a rule by which to export strings. Remove Link - Deletes the link between the POEditor language and your GitLab repository
You can automatically sync the terms whenever you make changes in your repos with GitLab webhooks. Here's some info about using webhooks with POEditor.
How to give access to the GitLab integration to localization project admins
After you, as the project owner, set up the links between the files on GitLab and the languages in the l10n project, you can give admins access to the integration from the projects's settings, by enabling the option Admins Can Access Integrations.