Skip to content

Latest commit

 

History

History
54 lines (42 loc) · 3.83 KB

README.md

File metadata and controls

54 lines (42 loc) · 3.83 KB

Concerto Frontend

This gem contains the client-side code that runs on Concerto display machines. The latest version of the gem can be found on RubyGems.

Installation

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.

  1. Concerto server administrators can visit the "Plugins" page in the "Admin" section of the navigation bar
  2. Click on the "New Plugin" button
  3. With "RubyGems" selected as the source, type "concerto_frontend" into the Gem Name text field.
  4. Click install plugin, then restart your web server as needed to install the new dependencies.
  5. You may need to recompile the assets by running RAILS_ENV=production bundle exec rake assets:precompile in your usr/share/concerto directory and then restart your webserver.

Development

The concerto-frontend uses web components and the latest Polymer 1.0 library. External javascripts should be placed in the vendor/assets/javascripts directory and required in the application.js.

Dependencies

  1. node js
  2. bower to install Polymer and web component libraries.
  3. grunt to run JavaScript tasks

Installation

  1. git clone https://github.com/concerto/concerto-frontend
  2. change the current directory to the concerto-frontend project
  3. run npm install and bower install to install the necessary tools and libraries

Standalone development

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:

  1. run npm install polyserve to install a simple web server to run our web component frontend
  2. start the web server by simply running polyserve while in the project's root directory
  3. polyserve will indicate which port and path the frontend can be reached at (this should be localhost:8080/components/concerto_frontend/demo.html)
  4. whatever html import changes you make to demo.html should also be included in the vulcanize_this.html

Development through Concerto

This method allows developers to run live changes through core Concerto. Follow these steps to begin developing:

  1. visit the "Plugins" page under your Concerto instance
  2. add or edit the frontend plugin for installation by local system path
  3. when specifying the path, the gem's root directory and gemspec are located in the concerto-frontend-gem folder within this project
  4. 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 HOWEVER you will need to change the vulcanized output see building, step 1 below.
  5. whatever html import changes you make to demo.html should also be included in the vulcanize_this.html

The grunt tasks will update the concatenated Polymer web components file and the changes should be reflected when previewing a screen under core Concerto.

Building the concerto_frontend gem

The following notes are kept for any developers on the Concerto team that need to push updates to RubyGems:

  1. Run grunt so it performs the default actions of vulcanizing the vulcanize_this.html file, strips the extra html from the vulcanized output file, and copies external js files to the vendor/assets/javascripts directory.
  2. change direcetories to the concerto-frontend-gem and then run gem build concerto_frontend.gemspec
  3. 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