GithubContributionsBundle

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

Contribution Calendar

Repositories & Contributions

Installation

Add the Bundle with `Composer`

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

For Caching add "liip/doctrine-cache-bundle": "~1.0" as well!

Then update your Dependencies: php composer.phar update

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:

# 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.

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:

TODO

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

Github Contributions Bundle Laravel Package