Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Gem to inherit to create Errbit plugin
Branch: master

ErrbitPlugin Build Status

ErrbitPlugin provides a set of base classes that you can extend to create Errbit plugins.

Creating plugins

ErrbitPlugins are Ruby gems that extend the functionality of Errbit. To get started, create a Ruby gem and add 'errbit_plugin' as a dependency in your gem's gemspec.

Now you can start adding plugins. At the moment, there is only one kind of plugin you can create, and that is the issue tracker.

Issue Trackers

An issue tracker plugin is a Ruby class that enables you to link errors within errbit to an issue in an external issue tracker like Github. An app within errbit can be associated an issue tracker or not. When there is an association, errbit users can choose 'create issue' from an error page which will both create an issue on the external issue tracker out of the given error and link that issue to the errbit error.

Your issue tracker plugin is responsible for providing the interface defined by ErrbitPlugin::IssueTracker. All of the required methods must be implemented and the class must extend ErrbitPlugin::IssueTracker. Here's an example:

class MyIssueTracker < ErrbitPlugin::IssueTracker

  # A unique label for your tracker plugin used internally by errbit
  def self.label

  def self.note
    'a note about this tracker that users will see'

  # Form fields that will be presented to the administrator when setting up
  # or editing the errbit app. The values we collect will be availble for use
  # later when we have an instance of this class.
  def self.fields
      username: {
        placeholder: "Some placeholder text"
      password: {
        placeholder: "Some more placeholder text"

  # Icons to display during user interactions with this issue tracker. This
  # method should return a hash of two-tuples, the key names being 'create',
  # 'goto', and 'inactive'. The two-tuples should contain the icon media type
  # and the binary icon data.
  def self.icons
    @icons ||= {
      create: [ 'image/png','./path/to/create.png') ],
      goto: [ 'image/png','./path/to/goto.png') ],
      inactive: [ 'image/png','./path/to/inactive.png') ],

  # If this tracker can be in a configured or non-configured state, you can let
  # errbit know by returning a Boolean here
  def configured?
    # In this case, we'll say this issue tracker is configured when username
    # is set

  # Called to validate user input. Just return a hash of errors if there are
  # any
  def errors
    if @params['field_one']
      { :field_one, 'Field One must be present' }

  # This is where you actually go create the issue on the external issue
  # tracker. You get access to everything in params, a problem resource and a
  # user resource (reported_by). Once you've created an external issue, save
  # its type and url on the problem resource.
  def create_issue(problem, reported_by = nil)
    # Create an issue! Then update the problem to link it.
      :issue_type => 'bug',
      :issue_link => ''

  # The URL for your remote issue tracker
  def url


Discuss any changes you'd like to make with the authors on the mailing list, or by opening a github issue.

Something went wrong with that request. Please try again.