This package has been deprecated

Author message:

This package is deprecated.

generator-crowdin-app

Crowdin Apps Generator

Crowdin Apps Generator will help you to get started with building your Crowdin App. It contains common templates and will walk you through the steps required to create your App prompting for the required information.

About Crowdin Apps

Status

Installation

Install Yeoman and generator-crowdin-app using npm (we assume you have pre-installed node.js).

npm install -g yo

npm install -g generator-crowdin-app

Generating an App

Creating an OAuth App

First, you need to create an OAuth App to be able to make authorized requests from your app to Crowdin. After creating an OAuth App you will receive Client ID and Client Secret values which will be used later for deployment.

For more about Creating an OAuth App see the documentation:

• Crowdin
• Crowdin Enterprise

Once you have Client ID and Client Secret you also need to have a URL where your app will be publicly accessible from the internet.

For development purposes you can use ngrok:

ngrok http 3000

Henceforth, the ngrok forwarding URL should be used as App Base URL.

Running the generator

The Yeoman generator will walk you through the steps required to create your app prompting for the required information.

To launch the generator simply type:

yo crowdin-app

Generator Output

These templates will:

• Create a base folder structure
• Template out a rough package.json and app configuration
• Import any assets required for your app

Crowdin App Installation

Start your app:

cd <your_app_directory>

node index.js

To connect the app with your project in Crowdin Enterprise, please follow these steps:

• Open Organization Settings > Apps tab and click Manual install button.
• Paste the URL to your app manifest (e.g. https://123-456.ngrok.io/manifest.json) and click Install.
• Select the users that will be able to use the app and the projects where users will be able to use the app.
• Open any project where this app is supposed to be, Applications > Custom.

To connect the app with your project in Crowdin, please follow these steps:

• Open Account Settings > Crowdin Applications tab and click Manual install button.
• Paste the URL to your app manifest (e.g. https://123-456.ngrok.io/manifest.json) and click Install.
• Select the users that will be able to use the app and the projects where users will be able to use the app.
• Open any project where this app is supposed to be, Applications > Custom.

Now you can play with your Crowdin App and add more features to it 🎉

Command line

Usage:
  yo crowdin-app [<destination>] [options]

Argument (optional):
  The destination to create the app in, absolute or relative to the current working
  directory. Use '.' for the current folder.
  If not provided, defaults to a folder in the current working directory with the app
  display name.

Options:
  -h,   --help                  # Print the generator's options and usage
  -q,   --quick                 # Quick mode, skip all optional prompts and use defaults
  -t,   --appType               # integration, mt, file, editor, project-menu, project-reports, resources, project-tools, organization-menu
  -n,   --appDisplayName        # App display name
  -i,   --appIdentifier         # Identifier of the app
        --appDescription        # Description of the app
        --pkgManager            # 'npm' or 'yarn'
        --gitInit               # Initialize a git repo
        --appBaseUrl            # App Base URL
        --clientId              # OAuth app Client ID
        --clientSecret          # OAuth app Client Secret
        --port                  # App network port
        --fileType              # Custom file format type (only for the 'file' app type)
        --multilingual          # Define if your file type multilingual (only for the 'file' app type)

Example usages:
  yo crowdin-app                          # Create an app in a folder with the app's name.
  yo crowdin-app Hello -t=integration -q  # Create an integration module app in './Hello', skip prompts, use defaults.

Getting To Know Yeoman

• Yeoman has a heart of gold.
• Yeoman is a person with feelings and opinions, but is very easy to work with.
• Yeoman can be too opinionated at times but is easily convinced not to be.
• Feel free to learn more about Yeoman.

Contributing

If you want to contribute please read the Contributing guidelines.

Seeking Assistance

If you find any problems or would like to suggest a feature, please feel free to file an issue on GitHub at Issues Page.

If you've found an error in these samples, please Contact Customer Success Service.

License

The Crowdin Apps Generator is licensed under the MIT License.
See the LICENSE file distributed with this work for additional
information regarding copyright ownership.

Except as contained in the LICENSE file, the name(s) of the above copyright
holders shall not be used in advertising or otherwise to promote the sale,
use or other dealings in this Software without prior written authorization.