appboard 1.0.8 → 1.0.9
Sign up to get free protection for your applications and to get access to all the features.
- data/README.md +42 -6
- data/examples/singlenumber.rb +1 -1
- data/lib/appboard/version.rb +1 -1
- metadata +4 -4
data/README.md
CHANGED
@@ -18,7 +18,7 @@ NOTE: We are currently in private beta. Please let me know (dev@appboard.me) if
|
|
18
18
|
Gem Installation
|
19
19
|
----------------
|
20
20
|
|
21
|
-
Install the
|
21
|
+
Install the appboard gem if you haven't already:
|
22
22
|
|
23
23
|
$ gem install appboard
|
24
24
|
|
@@ -69,6 +69,37 @@ You can also do this from the Resources section of your application's configurat
|
|
69
69
|
This will automatically create you an appboard.me account and create an default dashboard, and fill will set the Heroku configuration variables variables ENV['APPBOARD_API_URL'] and ENV['APPBOARD_API_KEY'].
|
70
70
|
|
71
71
|
|
72
|
+
### Access your dashboard ###
|
73
|
+
|
74
|
+
Now you could access your dashboard (with default configuration) by following url: http://appboard.me/a/{appName}
|
75
|
+
|
76
|
+
Where,
|
77
|
+
|
78
|
+
* {appName} - is name of application in Heroku.
|
79
|
+
|
80
|
+
_e.g. for application quiet-sky-73 url will be http://appboard.me/a/quiet-sky-73_
|
81
|
+
|
82
|
+
or, throw Heroku dashboard:
|
83
|
+
|
84
|
+
* open Heroku dashboard
|
85
|
+
* go to Resources of your application
|
86
|
+
* on bottom of the page in _Installed Add-ons_ section you will find Appboard Test, click on it. And you will redirected on your appboard dashboard.
|
87
|
+
|
88
|
+
### Getting apiKey ###
|
89
|
+
|
90
|
+
You will need **apiKey** to setup or push data from local environment, application deployed on Heroku will get it from configuration variables.
|
91
|
+
|
92
|
+
|
93
|
+
Steps are following:
|
94
|
+
|
95
|
+
* open Heroku dashboard
|
96
|
+
* go to Resources of your application
|
97
|
+
* on bottom of the page in _Installed Add-ons_ section you will find Appboard Test, click on it. And you will redirected on your appboard dashboard.
|
98
|
+
* on top of the page you will see _gear_, clock on it. Dasboard control pannel will appear, and on it you will find *apiKey*.
|
99
|
+
|
100
|
+
|
101
|
+
|
102
|
+
|
72
103
|
Usage
|
73
104
|
-----
|
74
105
|
|
@@ -79,8 +110,13 @@ After creating account (or deploying addon on Heroku) simple dashboard will be c
|
|
79
110
|
|
80
111
|
In order to update or create new dashboard you will need to setup it, and the moment this supported only via Ruby GEM.
|
81
112
|
|
82
|
-
|
83
|
-
|
113
|
+
You will need to define dashboard and place widgets in it. And there is supported widget parameters:
|
114
|
+
|
115
|
+
* size: 1x1, 1x2, 1x3, 2x1, 2x2, 2x3, 3x1, 3x2 and 3x3.
|
116
|
+
* type: Clock, Single Number, Alert, Bubble Chart, Funnel Chart, Line Chart, Bar Chart, Column Chart, Pie Chart, Radial Gauge, Filler Gauge.
|
117
|
+
Check out [list of available widgets](http://appboard.me/docs/widgets).
|
118
|
+
|
119
|
+
We are continue working over new nice widgets!
|
84
120
|
|
85
121
|
There is simple example that updates default dashboard with new configuration:
|
86
122
|
|
@@ -118,11 +154,11 @@ You can access this data easily:
|
|
118
154
|
|
119
155
|
uidMyIndicator1 = Appboard.widget('my indicator1').uid
|
120
156
|
|
121
|
-
|
157
|
+
_Note:_ If you are running this on local environment you will need to define _*apiKey*_ before calling Appboard.setup, on Heroku apiKey will be injected during deploying appboard addon.
|
122
158
|
|
123
159
|
Appboard.settings = { :apiKey => '...', :debug => true }
|
124
160
|
|
125
|
-
You can find more examples in our Git repository: [one](https://github.com/appboard/appboard/blob/master/examples/setupdashboard1.rb), [two](https://github.com/appboard/appboard/blob/master/examples/setupdashboard2.rb) and [three](https://github.com/appboard/appboard/blob/master/examples/setupdashboard3.rb)
|
161
|
+
You can find more examples for dashboard setup in our Git repository: [one](https://github.com/appboard/appboard/blob/master/examples/setupdashboard1.rb), [two](https://github.com/appboard/appboard/blob/master/examples/setupdashboard2.rb) and [three](https://github.com/appboard/appboard/blob/master/examples/setupdashboard3.rb)
|
126
162
|
|
127
163
|
**Pushing your data to Widget**
|
128
164
|
|
@@ -175,7 +211,7 @@ _by widget uid (unique identifier)_ - other way to push data to widget is define
|
|
175
211
|
|
176
212
|
Each widget has its own page on this site. That page contains all the information you need in order to start working with the widget, including descriptions of data model (a piece that represents some kind of data).
|
177
213
|
|
178
|
-
More examples for different widgets you could find in
|
214
|
+
More examples for different widgets you could find in [our repository](https://github.com/appboard/appboard/tree/master/examples) on GitHub.
|
179
215
|
|
180
216
|
|
181
217
|
NOTE: Don't forget to specify your apiKey and widget identifier.
|
data/examples/singlenumber.rb
CHANGED
@@ -5,7 +5,7 @@ require 'appboard'
|
|
5
5
|
# Updates Singge Number on Dashboard (see http://appboard.me/docs/singlenumber)
|
6
6
|
# Don't forget to specify your apiKey and widget identifier.
|
7
7
|
#
|
8
|
-
Appboard.settings = { :apiKey => 'wOUpOJeOozcgPdZa', :
|
8
|
+
Appboard.settings = { :apiKey => 'wOUpOJeOozcgPdZa', :debug => true }
|
9
9
|
|
10
10
|
Appboard.push {
|
11
11
|
widget() {
|
data/lib/appboard/version.rb
CHANGED
metadata
CHANGED
@@ -1,13 +1,13 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: appboard
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
hash:
|
4
|
+
hash: 5
|
5
5
|
prerelease: false
|
6
6
|
segments:
|
7
7
|
- 1
|
8
8
|
- 0
|
9
|
-
-
|
10
|
-
version: 1.0.
|
9
|
+
- 9
|
10
|
+
version: 1.0.9
|
11
11
|
platform: ruby
|
12
12
|
authors:
|
13
13
|
- appboard.me
|
@@ -15,7 +15,7 @@ autorequire:
|
|
15
15
|
bindir: bin
|
16
16
|
cert_chain: []
|
17
17
|
|
18
|
-
date: 2011-07-
|
18
|
+
date: 2011-07-21 00:00:00 -04:00
|
19
19
|
default_executable:
|
20
20
|
dependencies:
|
21
21
|
- !ruby/object:Gem::Dependency
|