// addWidget Template
// *******************
// parameters:
// table = table object (DOM)
// config = config object (from table.config)
// widgetOptions = all widget options (from table.config.widgetOptions)
$.tablesorter.addWidget({
  id: 'myWidget',
  // set the priority of the widget (optional)
  priority: 10,
  // widget options (added v2.8) - added to table.config.widgetOptions
  options: {
    myWidget_option1 : 'setting1',
    myWidget_option2 : 'setting2'
  },
  // The init function (added v2.0.28) is called only after tablesorter has
  // initialized, but before initial sort & before any of the widgets are applied.
  init: function(table, thisWidget, config, widgetOptions){
    // widget initialization code - this is only *RUN ONCE*
    // but in this example, only the format function is called to from here
    // to keep the widget backwards compatible with the original tablesorter
    thisWidget.format(table, config, widgetOptions, true);
  },
  format: function(table, config, widgetOptions, initFlag) {
    // widget code to apply to the table *AFTER EACH SORT*
    // set the initFlag to true when this format is called from the init
    // function above otherwise initFlag is undefined
    // * see the saveSort widget for a full example *
  },
  remove: function(table, config, widgetOptions, refreshing){
    // do what ever needs to be done to remove stuff added by your widget
    // unbind events, restore hidden content, etc.
    // refreshing flag is true when the refreshWidgets method is triggered, meaning
    // the widget will be removed, then immediately reapplied
  }
});