digitalkaoz/github-contributions-bundle

Symfony2 Bundle to show Github Contributions

GithubContributionsBundle

This Bundle lets you display some Github Statistics in your Symfony2 Application. See https://help.github.com/articles/viewing-contributions for more Information., _(*1)

, _(*2)

Contribution Calendar, _(*3)

, _(*4)

Repositories & Contributions, _(*5)

, _(*6)

Installation

Add the Bundle with Composer

{
    "require" : {
        "digitalkaoz/GithubContributionsBundle" : "~1.0"
    }
}

For Caching add "liip/doctrine-cache-bundle": "~1.0" as well!, _(*7)

Then update your Dependencies: php composer.phar update, _(*8)

Activate the Bundle in your AppKernel

public function registerBundles()
{
    $bundles = array(
        // ...
        new digitalkaoz\GithubContributionsBundle\digitalkaozGithubContributionsBundle()
    );

    return $bundles;
}

Include the Routing File in your routing.yml

digitalkaoz_github_contributions:
    resource: "@digitalkaozGithubContributionsBundle/Resources/config/routing.xml"
    prefix:   /github

Configuration

the full configuration looks like this:, _(*9)

# only needed if you want to cache the github reponses (recommend)
liip_doctrine_cache:
    namespaces:
        github:
            type: file_system

#nothing is required, but its recommended to use an api token and cache the results
digitalkaoz_github_contributions:
    api_token:     your_github_api_token
    cache_service: liip_doctrine_cache.ns.github
    username:      your_github_username
    templates:
        contributions:   digitalkaozGithubContributionsBundle:Contributions:contributions.html.twig
        activity_stream: digitalkaozGithubContributionsBundle:Contributions:activity.html.twig
        user_repos:      digitalkaozGithubContributionsBundle:Contributions:user_repos.html.twig

Usage

View the Statistics

• visit /github/contributions to view a list of repositories you have contributed to
• visit /github/repos to view a list of your own repositories
• visit /github/activity to view your contribution calendar (like the github one)

Generate the Caches

the calculation of your contributions may take a while, so i build some commands to generate the caches eagerly from your console/cronjobs., _(*10)

• run app/console github:contribution-update contribution digitalkaoz to update the contributions cache for digitalkaoz
• run app/console github:contribution-update repos digitalkaoz to update the repos cache for digitalkaoz
• run app/console github:contribution-update activity digitalkaoz to update the activity cache for digitalkaoz

Tests

everything is well tested and under CI:, _(*11)

• https://travis-ci.org/digitalkaoz/GithubContributionsBundle
• https://scrutinizer-ci.com/g/digitalkaoz/GithubContributionsBundle/
• https://insight.sensiolabs.com/projects/a74d75ea-6aa5-4cf9-95dd-db4afbb5b2dc

TODO

• other useful stats?
• more generic approach for hooking own stats collectors?