-
Notifications
You must be signed in to change notification settings - Fork 5
Home
Help Pages
This gem contains the client-side code that runs on Concerto display machines. The latest version of the gem can be found on RubyGems.
The concerto-frontend gem should be installed by default with the latest Concerto releases. If there seems to be anything wrong, follow these steps to install the gem.
- Concerto server administrators can visit the "Plugins" page in the "Admin" section of the navigation bar
- Click on the "New Plugin" button
- With "RubyGems" selected as the source, type "concerto_frontend" into the Gem Name text field.
- Click install plugin, then restart your web server as needed to install the new dependencies.
The concerto-frontend uses web components and the latest Polymer 1.0 library.
- git clone https://github.com/concerto/concerto-frontend
- change the current directory to the concerto-frotend project
- run
npm install
andbower install
to install the necessary tools and libraries
The quickest method of development is to run the frontend without core Concerto. The frontend uses data in the "test" directory as a substitute for any screen and content data. Follow these steps to begin developing:
- run
npm install polyserve
to install a simple web server to run our web component frontend - start the web server by simply running
polyserve
while in the project's root directory - polyserve will indicate which port and path the frontend can be reached at (this should be localhost:8080/components/concerto_frontend/demo.html)
This method allows developers to run live changes through core Concerto. Follow these steps to begin developing:
- visit the "Plugins" page under your Concerto instance
- add or edit the frontend plugin for installation by local system path
- when specifying the path, the gem's root directory and gemspec are located in the concerto-frontend-gem folder within this project
- run the
grunt watch
(add --verbose for extra debugging details) task within this project's root directory. This will automatically run the vulcanize task whenever changes are made to the frontend
The grunt tasks will update the concatenated Polymer web components file and the changes should be reflected when previewing a screen under core Concerto.
The following notes are kept for any developers on the Concerto team that need to push updates to RubyGems:
- change direcetories to the concerto-frontend-gem and then run
gem build concerto_frontend.gemspec
- push the final gem to RubyGems using
gem push concerto_frontend-X.X.X.gem
and add to core Concerto as concerto_frontend with the latest version number