-
Ultimate and Enterprise plans (Legacy)
Get in touch with Sales for licensing questions.
Tip
For information about GitHub integration in Phrase Strings, refer to GitHub (Strings).
GitHub connector allows the downloading of source files and uploading of target files directly to/from the GitHub repository.
The connector uses the GitHub API to implement the integration. The connector allows access to all repositories associated with a GitHub account. GitHub account authentication can also be made in the GitHub App.
There are a number of use cases for the connector:
-
Project managers can add files directly to projects from an online repository.
-
Set up the submitter portal to allow Submitters to add files to requests directly from the online repository.
-
Use automated project creation (APC) to have new projects automatically created when a change in file size is detected in monitored files or a folder.
-
All files from the monitored folder and/or subfolders are imported the very first time APC runs. Newly added files are imported with the next triggered monitoring after their creation.
-
This connector supports absolute path setting. Target translation files can be stored only in the same branch as the source file.
-
-
Set up continuous jobs to have selected files monitored for changes.
GitHub Settings
No changes are required.
Important
If accessing from a custom domain (ex. mydomain.phrase.jp), open an incognito browser window and log in via cloud.memsource.com or us.cloud.memsource.com to apply the authentication required for the creation or saving of the connector. After saving, the connector can be accessed via the custom domain.
-
From the Settings
page, scroll down to the section.
-
Click on Connectors.
The page opens.
-
Click New connector.
The page opens.
-
Provide a name for the connection and change the Type to GitHub .
-
Optionally select and provide a .
-
If required, select to display the Phrase GitHub app URL and import/export files using the GitHub app authorization flow:
-
Click the link to open the Phrase App Connector official page in a new tab: https://github.com/apps/phrase-app-connector-eu (EU data center) or https://github.com/apps/phrase-app-connector-us (US data center).
-
Install the Phrase GitHub app to the target GitHub account.
Note
If the GitHub app is not installed to the user’s target GitHub account, only public repositories will be visible to the GitHub connector.
-
Complete the installation procedure by selecting any private repositories that will be visible and accessible for the GitHub connector.
-
Go back to the Phrase page to authorize the GitHub app and connect to GitHub.
-
-
Click Connect to GitHub. If not connected using the GitHub App, a popup window or a new tab will appear requesting authorization.
-
Provide a if required.
-
Click the Authorize Phrase button.
If using the GitHub app, click the Authorize Phrase App Connector button.
If successful, the window/tab will disappear and a small checkmark appears next to the Connect to GitHub button.
-
Click Save.
The connector is added to the list on the page.
Important
If the GitHub connector is created using the GitHub app authorization flow, it is not possible to change the authorization method after saving the connector settings.