Skip to content

alfg/mumble-widget

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

72 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Mumble-widget

Mumble-widget is a web-based channel viewer widget to display active users on your Mumble server. This project was built for GuildBit subscribers to easily embed the widget on their guild's website in two lines of code using the snippet on mumble-widget.guildbit.com.

The project's goal is to have a clean and customizable design, simple installation and to support any host utilizing the Channel Viewer Protocol.

JS Fiddle example: http://jsfiddle.net/alfg/3m86purL/

Supported Hosts

The following are a list of compatible hosts implementing the Channel Viewer Protocol. Feel free to add hosts to this list and a JSFiddle example of the script working.

Host Compatible? JSFiddle Demo
GuildBit http://jsfiddle.net/alfg/3m86purL/
CleanVoice http://jsfiddle.net/alfg/8ojLfbzb/
Mumble.com http://jsfiddle.net/alfg/z2qf81d6/
GotMumble http://jsfiddle.net/alfg/3krr8pp1/
MMO-Mumble http://jsfiddle.net/seansummers/47eb1Lvx/
MumbleMe http://jsfiddle.net/seansummers/zfngfr0h/
CommandChannel http://jsfiddle.net/alfg/2ju0678g/
TypeFrag
CheapMumble
MumbleBoxes
MyMumble
GameServers

Usage

There are two methods of installation, depending if you are self-hosting the script or using the hosted version.

Hosted

Hosted is for those who don't necessarily want to bother setting up the script. This method is meant to be simplified and serves the files over a Content Delivery Network (CDN).

To use the hosted version of the script, simply copy and paste the following snippet of code where you want the widget to load on your website:

<script class="mumble-widget" type="text/javascript"
    src="//dqc3ygqu0f1ud.cloudfront.net/dist/mumble-widget/mumble-widget.cdn.min.js"
    data-source="//guildbit.com/server/cvp/a1722c92-368e-4506-9ea2-22be00ca8129"
    data-width="400"></script>
<div id="mumble-widget-container"></div>

Parameters:

  • data-source - The path to the CVP JSONP Source of your Mumble hosting provider.
  • data-width - (optional) The width (pixels) of the widget and data.
  • data-theme - (optional) The theme name. See Themes below.
  • data-key - (optional) The CVP Key if using GuildBit as your Mumble Host (in this case, you do not need to include the data-source attribute.

Self-Hosted

Self-hosted is for those who would like to have control of the source code and/or customize the template or widget itself.

  1. Download contents in /dist folder.
  2. Add the following snippet where you want the widget to load:
<script class="mumble-widget" src="../src/mumble-widget.js" type="text/javascript"
    data-width="400"
    data-source="http://guildbit.com/server/cvp/aec4afa2-d777-43e9-8ca5-41bc70d00877/json/?callback=callback">
</script>
<div id="mumble-widget-container"></div>

Parameters:

  • data-source - The path to the CVP JSONP Source of your Mumble hosting provider.
  • data-width - (optional) The width (pixels) of the widget and data.
  • data-theme - (optional) The theme name. See Themes below.
  • data-key - (optional) The CVP Key if using GuildBit as your Mumble Host (in this case, you do not need to include the data-source attribute.

Themes

You can use the following themes by adding the data-theme attribute to the script tag.

Example: data-theme="obsidian".

Default Grayscale Obsidian
Default Grayscale Obsidian

Development

Mumble-widget is built with jQuery, Knockout.js and uses Grunt for validating, linting, and minifying/uglifying code output. Install using the instructions below:

  1. git clone https://github.com/alfg/mumble-widget.git
  2. cd mumble-widget
  3. npm install
  4. Run a simple http server to serve demo/index.html. Note using the filesystem to serve the demo will not work due to browser security warnings with ajax loading.

https://github.com/indexzero/http-server is a great http server.

Packaging

Running grunt will lint, concat, uglify, cssmin and copy files into dist for distribution. This creates both the CDN and self-hosted copies.

License

MIT License © Alfred Gutierrez