OpenLaszlo Rails Plugin
The OpenLaszlo Rails plugin makes it easy to use OpenLaszlo client-side applications with Rails. It includes a generator and helper for creating OpenLaszlo applications and displaying them within Rails views.
For example, the following shell command will create an OpenLaszlo application named applet, and a view named controller/index. Requesting the view will recompile the applet.
$ ./script/generate applet contact applet
The plugin defines the following generators, that can be used to quickly create an OpenLaszlo stub application and a view that displays it.
This generates an OpenLaszlo source file in app/applets/my-app:
$ ./script/generate applet my-app
This also creates a model and view at /my-controller/index that displays the applet. When the app's source changes, requesting the view recompiles the app.
$ ./script/generate applet my-app my-controller index
The plugin defines the following tasks:
Rails 2.0 or later. (Might work with earlier versions, but is untested with them.)
Installation (using templates; for Rails 2.3 or later)
In Rails 2.3 or later, you can use the Rails template mechanism to install the OpenLaszlo plugin and the gem that it depends on.
The template requires that you give it sudo access, in order to run sudo rake gems:install. If you don't want to or can't do this, you can use the instructions for previous versions of Rails below.
To create a new Rails app:
rails webapp -m http://gist.github.com/83809.txt
To upgrade an existing app:
rake rails:template LOCATION=http://gist.github.com/83809.txt
To create a new Rails app, or upgrade an existing one, and create a starter applet that's served from /home/applet, do one of:
generate=myapp rails webapp -m http://gist.github.com/83809.txt generate=myapp rake rails:template LOCATION=http://gist.github.com/83809.txt
Installation (Rails 2.1 or later)
0: Install OpenLaszlo, Ruby, and Ruby on Rails.
1: In config/environment, place the following code inside the Rails::Initializer.run block:
config.gem 'ropenlaszlo', :lib => 'openlaszlo', :version => '>= 0.6.3'
2: Install the ropenlaszlo gem:
$ sudo rake gems:install
3: Install this plugin:
$ ./script/plugin install git://github.com/osteele/openlaszlo_plugin.git
4: Set the OPENLASZLO_HOME environment variable to the directory that contains the OpenLaszlo SDK. The first line below is an example of this in bash (although you will probably want to put this in your .bashrc or .profile too). If you're not using Windows, the second line of shell script will tell you whether you've set it right.
$ export OPENLASZLO_HOME="/Applications/OpenLaszlo Server 188.8.131.52" $ grep -qs Laszlo "$OPENLASZLO_HOME/README.txt" && echo yes || echo no
In your RAILS application directory:
1: Create an applet, and a view that displays it:
$ ./script/generate applet my-applet controller index
2: Compile the applet (this step is optional):
$ rake openlaszlo:build:applets
Now launch the server (script/server), and you can view your applet at http:127.0.0.1:3000/controller/index.
Using the Compile Server
The steps described above use the OpenLaszlo command-line compiler to compile applications. A faster technique, although one that requires more configuration, is to leave the OpenLaszlo server running as a compile server.
The instructions for setting up an OpenLaszlo compile server are here.