Switch branches/tags
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
117 lines (77 sloc) 5.7 KB

Nitrogen 2.x

Nitrogen 2.0.1

  • Removed mnesia-based process registry, create new distributed process registry. (./apps/nprocreg)

Nitrogen 2.0.0 - Big Release/New Features

New Elements, Actions, and API functions

  • wf:wire can now act upon CSS classes or full JQuery Paths, not just Nitrogen elements. For example, wf:wire(".people > .address", Actions) will wire actions to any HTML elements with an "address" class underneath a "people" class. Anything on is supported
  • Added wf:replace(ID, Elements), remove an element from the page, put new elements in their place.
  • Added wf:remove(ID), remove an element from the page.
  • New #api{} action allows you to define a javascript method that takes parameters and will trigger a postback. Javascript parameters are automatically translated to Erlang, allowing for pattern matching.
  • New #grid{} element provides a Nitrogen interface to the 960 Grid System ( for page layouts.
  • The #upload{} event callbacks have changed. Event fires both on start of upload and when upload finishes.
  • Upload callbacks take a Node parameter so that file uploads work even when a postback hits a different node.
  • Many methods that used to be in 'nitrogen.erl' are now in 'wf.erl'. Also, some method signatures in wf.erl have changed.
  • wf:get_page_module changed to wf:page_module
  • wf:q(ID) no longer returns a list, just the value.
  • wf:qs(ID) returns a list.
  • wf:depickle(Data, TTL) returns undefined if expired.

Comet Pools

  • Behind the scenes, combined logic for comet and continue events. This now all goes through the same channel. You can switch async mode between comet and intervalled polling by calling wf:switch_to_comet() or wf:switch_to_polling(IntervalMS), respectively.
  • Comet processes can now register in a local pool (for a specific session) or a global pool (across the entire Nitrogen cluster). All other processes in the pool are alerted when a process joins or leaves. The first process in a pool gets a special init message.
  • Use wf:send(Pool, Message) or wf:send_global(Pool, Message) to broadcast a message to the entire pool.
  • wf:comet_flush() is now wf:flush()

Architectural Changes

  • Nitrogen now runs under other web frameworks (inets, mochiweb, yaws, misultin) using simple_bridge. In other words, you hook into the other frameworks like normal (mochiweb loop, yaws appmod, etc.) and then call nitrogen:run() from within that process.
  • Handlers are the new mechanism to extend the inner parts of Nitrogen, such as session storage, authentication, etc.
  • New route handler code means that pages can exist in any namespace, don't have to start with /web/... (see dynamic_route_handler and named_route_handler)
  • Changed interface to elements and actions, any custom elements and actions will need tweaks.
  • sync:go() recompiles any changed files more intelligently by scanning for Emakefiles.
  • New ability to package Nitrogen projects as self-contained directories using rebar.

Nitrogen 1.x Changelog


  • Added changes and bugfixes by Tom McNulty.


  • Added a templateroot setting in .app file, courtesy of Ville Koivula.


  • Added file upload support.


  • Added alt text support to #image elements by Robert Schonberger.
  • Fixed bug, 'nitrogen create (PROJECT)' now does a recursive copy of the Nitrogen support files, by Jay Doane.
  • Added radio button support courtesy of Benjamin Nortier and Tom McNulty.


  • Added .app configuration setting to bind Nitrogen to a specific IP address, by Tom McNulty.


  • Added DatePicker element by Torbjorn Tornkvist.
  • Upgrade to JQuery 1.3.2 and JQuery UI 1.7.
  • Created initial VERSIONS file.
  • Added code from Tom McNulty to expose Mochiweb loop.
  • Added coverage code from Michael Mullis, including lib/coverize submodule.
  • Added wf_platform:get_peername/0 code from Marius A. Eriksen.


  • Added code by Torbjorn Tornkvist: Basic Authentication, Hostname settings, access to HTTP Headers, and a Max Length validator.


  • Added Gravatar support by Dan Bravender.


  • Add code-level documentation around comet.
  • Fix bug where comet functions would continue running after a user left the page.
  • Apply patch by Tom McNulty to allow request object access within the route/1 function.
  • Apply patch by Tom McNulty to correctly bind binaries.
  • Apply patch by Tom McNulty for wf_tags library to correctly handle binaries.


  • Clean up code around timeout events. (Events that will start running after X seconds on the browser.)


  • Apply changes by Jon Gretar to support 'nitrogen create PROJECT' and 'nitrogen page /web/page' scripts.
  • Finish putting all properties into .app file. Put request/1 into application module file.
  • Add ability to route through route/1 in application module file.
  • Remove need for wf_global.erl
  • Start Yaws process underneath the main Nitrogen supervisor. (Used to be separate.)


  • Make Nitrogen a supervised OTP application, startable and stoppable via nitrogen:start() and nitrogen:stop().
  • Apply changes by Dave Peticolas to fix session bugs and turn sessions into supervised processes.


  • Update sync module, add mirror module. These tools allow you to deploy and start applications on a bare remote node.


  • Allow Nitrogen to be run as an OTP application. See Quickstart project for example.
  • Apply Tom McNulty's patch to create and implement wf_tags library. Emit html tags more cleanly.
  • Change templates to allow multiple callbacks, and use first one that is defined. Basic idea and starter code by Tom McNulty.
  • Apply Martin Scholl's patch to optimize copy_to_baserecord in wf_utils.