Ember-messenger

Messenger is a simple way to display stylish transactional messages in your app.

Ember-messenger is an ember-cli addon for Hubspot Messenger that allows you to easily add Hubspot Messenger to your Ember App.

Demo

http://ember-messenger.divshot.io/

Source code for this app is located in the demo-app directory of this repository.

Installation

If you are running ember-cli >= 0.2.3, From within your application you can run:

ember install ember-messenger

ember-cli 0.1.5 - 0.2.2 Installation

If you are running ember-cli 0.1.5 - 0.2.2 , From within your application you can run:

ember install:addon ember-messenger

Installation without ember-cli

• git clone this repository
• npm install
• bower install

Usage

The ember-messenger addon adds hubspot messenger via bower, then injects a service into all of your routes and controllers.

ember-messenger exposes several methods on the Messenger() object inside this.Messenger. You can mostly use the same syntax as you see in the Hubspot documentation, however you do not need the set of parenthesis after this.Messenger.

After installing, you can access any of the following methods from inside your application's routes and controllers:

this.Messenger.setup()

Changes or initializes Messenger settings. Optional.

Example:

this.Messenger.setup({
    extraClasses: 'messenger-fixed messenger-on-top messenger-on-right',
    theme: 'flat'
});

See http://github.hubspot.com/messenger/#messenger-object

this.Messenger.post([object or string])

Creates a new Messenger message.

Example:

this.Messenger.post("I am a happy little duckling.");

Advanced Example:

this.Messenger.post({
    message: 'ERROR: There was an explosion while processing your quack.',
    type: 'error',
    showCloseButton: true
});

See http://github.hubspot.com/messenger/#messenger-object

this.Messenger.hideAll()

Hides all Messenger messages currently being displayed.

Example:

this.Messenger.hideAll();

Development

• ember server
• Visit your app at http://localhost:4200.

Running Tests

• ember test
• ember test --server

Building

• ember build

For more information on using ember-cli, visit http://www.ember-cli.com/.

More Information

Hubspot Messenger: http://github.hubspot.com/messenger/