Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »

    generator-leadconduit-integrationpublic

    LeadConduit Integration Generator

    Build Status

    What is this?

    This tool is provided for developers who wish to create a new integration for the LeadConduit platform. After asking a few simple questions, it generates the code and tests necessary to integrate a third party system with LeadConduit. It is intended that the generated code be customized to account for the specifics of integrating with a particular system.

    Getting Started

    LeadConduit integrations are written in JavaScript or CoffeeScript on the Node.JS platform. You must have Node.JS installed in order to develop integrations or use this generator.

    You must also have the Yeoman tool and this generator installed:

    npm install -g yo
    npm install -g generator-leadconduit-integration

    Finally, create a directory for your new integration. Use the leadconduit-integration-* naming convention, where * is the name of the service you are integrating with:

    mkdir leadconduit-integration-foobar

    Once those steps are done, you're ready to generate a new LeadConduit integration.

    Set up GitHub for version control

    We strongly recommend creating a public GitHub repository for your new integration before you run the generator. Doing this step now is optional, but you'll need to do it eventually and it makes the generator a little smarter. Follow the online instructions before you generate your integration.

    How to generate a LeadConduit Integration

    In the directory for your integration, run the generator using yo.

    cd leadconduit-integration-foobar
    yo leadconduit-integration

    After answering a short series of questions, your integration will be generated. The integration code can be found in the src/ directory and the tests for your code can be found in the spec/ directory.

    How to test your integration

    The generator created some tests for you based on the answers you gave. You can run the tests as follows:

    cake test

    When you make changes to the code, you will also need to change the tests. We will not allow integrations on to the platform which have broken or inadequate tests, so make sure you give due attention to the tests.

    How to ask for help

    If you're trying to write an integration but are running into any sort of trouble, we're always here to help. Send an email to our Support Team and we'll reply right away. When asking for help, it's best if the integration is committed to GitHub so that we can look at it, pull it down, and run it as we're helping you work through your questions.

    How to submit an integration

    Once you have finished your integration and are satisfied that you have excellent test coverage, send an email to our Support Team to let use know that you'd like to include your integration on the LeadConduit platform.

    Generally speaking there are three steps that must be taken to take your integration live:

    1. Publish your integration as an NPM package using npm publish
    2. Open a GitHub pull request against the leadconduit-integrations repository to add your integration to the package.json file.
    3. Wait for our team to approve your integration. Once it is approved, we will merge your pull request and your integration will go live in our next release.

    About integration versioning

    We use Semantic Versioning and you should too. But if you don't know how, don't worry. We'll help ensure that your package version makes sense before we include it on the platform or before we allow updates to your integration.

    install

    npm i generator-leadconduit-integration

    Downloadsweekly downloads

    10

    version

    0.0.5

    license

    MIT

    repository

    githubgithub

    last publish

    collaborators

    • avatar