Adobe® Wave™ is an Adobe AIR® application and Adobe hosted service that work together to enable desktop notifications for web publishers, large and small.

Simply speaking it is an Air application that receive notifications from the Adobe free Publisher Service.
With Wave site owners can use a simple REST api to send notifications, while desktop users can use a single application to receive notifications from multiple sources.

Wave flowchart

With Zend_Application you can not only setup all the components required (Zend_Table, Zend_View, Zend_Navigation, ecc) but you can also setup your own custom plugin, called Resource.

In the Zend lingo a Resource is a plugin loaded by the Zend_Application and configured through the application.ini file or in the Bootstrap.php class.

A Resource can be used to setup a standard Zend component, routes, controller plugins or your custom component.

Lets see how.

Use the Bootstrap class

When you create an empty Zend Framework project with the zf create project command, you'll find a Bootstrap.php file in your application folder.

In this file there is a Bootstrap class that you can use to define your own resources by simply creating a method with the _init prefix.

For example:

This setup a resource called Doctype.
This resource simply set the doctype property in the view (which is a resource too).

With the $this->bootstrap('view'); line, the Doctype resource requires the initialization of another resource: the View. In this way you can define dependencies in your resources.

You can even override the definition of a standard resource with your own, for example:

In this way Zend_Application will use the view resource defined in your _initView method instead of the standard one.

With this method you can customize your Zend Framework with ease, but when you need to configure a standard component, like the db connection, there is a better approach: using the application.ini.

Use the application.ini file

Another gift of the zf create project command is the application/configs/application.ini file.

It contains all the configurations options of your application.
You can for example use it to configure your db:

You could use either the Bootrap or the application.ini method for this task, however I personally prefer this method when configuring parameters that changes across the servers (development, testing, production) like the include paths or the db connection options.

A better approach: Create a custom resource class

To improve reusability, you can create a custom resource class, that can be easily distributed and configured through your application.ini.

Its simple: in your library create a MyResource folder and a Custom class:

In the init method, you can initialize your resource, and return it.
The object returned will go in the resources repository, and it will be accessible with the $bootstrap->getResource('custom') call in the other resources. (hint: is case insensitive)

To use your newly created resource, you can simply put that in your application.ini:

That's all.

A resource can take configuration options too, for example:

Zend_Application will automatically initialize a resource when you set a configuration option in it.
If our resource doesn't expect a parameter, you can simply write resources.*resourcename* = true, like in the previous example.

You can access the options from within the resource through the $this->options variable. You can also define a setter method for the option:

You are now ready to build your distributable plugin for Zend Framework, for other examples see the Zend/Application/Resource folder in the framework distribution or my MadaConsole resource.

Building Facebook applications with Zend Framework, I've needed a debug console that can shows messages even in a Facebook canvas page, through an ajax request or a redirect.

For this purpose I've build a custom plugin for ZF that fits the need: it will sit under your pages and shows all your dumped object, messages and queries.

MadaConsole debug console

Usage is really simple: copy in your library and add the plugin in your Boostrap or application.ini.
For a detailed guide see below.

Features

• Trace custom messages easily: debug("A debug message");
• Dump variables easily in your code with the pass-through function:
  Before: array_count_values($arr); After: array_count_values(debug($arr));
• Shows the queries executed by your Zend_Table
• Shows debug messages even through redirects or ajax requests

Install

Installing the plugin is simple:

1. Download the archive: MadaConsole
2. Unzip the library folder of the archive in the library folder of your Zend Framework application

Then you can configure it with two methods: through your application.ini or in the Bootsrap class.

Method1: application.ini

Add those lines after [development : production]:

pluginPaths.MadaConsole = "MadaConsole"
resources.console = true


Method 2: Bootstrap class

Add this method:

Usage

Now in your code you can do:

With the pass-through functionality you can simply add the debug() function in your existing statements with ease: $var = debug(my_func($foo));

To see the debug output when you do an ajax request, you can open a page of your choice in another browser window: the debug console will show all the messages site-wide.

Downloads

MadaConsole plugin
MadaConsole example Zend Framework project

How the debug console looks like

Who will win the real-time web war?

Some interesting examples:
Clouds rendering
"Dune" like desert generator
Retro avatars generator
Water ripple effect

Wonderfl - Build flash online

However, this P2P feature needs an initial handshake between the clients to start the connection, and it is done through a "rendezvous service".
Since I didn't know that Adobe publicly released a rendezvous service or specification, have the folks at FilesOverMiles reverse engineered the protocol?

Useful links:
Stratus: a rendezvous service from Adobe (beta)
Flash Collaboration Serivice: Adobe hosting service for RTMP/RTMFP
Real-Time Media Flow Protocol FAQ

RTMFP

Its main features are: show results as you type, contextual help, save and share your regexps.
It also runs as an Air application or directly from the website.

RegExr

Other than from the command line, its possible to use Zend_Tool directly from Eclipse, lets see how.

Use Zend_Tool from Eclipse

First, download the framework and extract it.

I've had trouble with the full package of the 1.8.1 version, its seems to have a corrupted file in the tar.gz archive:
library\Zend\Tool\Framework\Loader\IncludePathLoader\RecursiveFilterIterator.php0000664
you can resolve the problem simply by renaming it to RecursiveFilterIterator.php

Now in Eclipse or Zend Studio for Eclipse, create and empty php project in a place accessible from your local webserver.

Now go to the "External tool" => "External Tools Configurations" panel to create a quick link to Zend_Tool.

NB: If you are using Zend Studio, you'll have to remove the filter that hide "Program" item first:

In Zend Studio remove the filters that hide the Program item

Now you can create a new "external tool":

1. Click the new item button
2. Give it a name
3. Point it to the location of the bin\zf.bat file in your zend framework folder (where you have extracted it) using the Browse File System button
4. Set the working directory to the location of your newly created php project with the Browse Workspace button
5. In the arguments box insert ${string_prompt}. In this way Eclipse will prompt for input when you'll start the tool.

Create an External Tool in Eclipse

Now in the "Enviroment" tab, configure two enviroment variable:

• Path: to your php.exe folder
• ZEND_TOOL_INCLUDE_PATH_PREPEND: to your Zend Framework library folder

In the Common tab check Display in favorites menu and in the "Refresh" tab check Refresh resources upon completion => The project containing the selected resource

Now you can run it, and in the dialog write show version. In the Eclipse console you'll see the zend framework version.

Now you can experiment all the Zend_Tool commands of your choice:

create project [absolute path of your project]
create controller [name of the controller]

And don't forget that you can create your own Zend_Tool command too.

Haxe is powerful language similar to ActionScript 2, that can compile itself to Flash6/7/8/9/10 and translated to other languages like JavaScript, Php, NekoVM, C++.
This allows it to run virtually in every environment and client.

And now the good news: from today its possible to run Haxe programs on the iPhone!

Beware that this is only an early beta, but it's already promising: thanks to the NME library, you'll be able to use the Flash 9 drawing api on the iPhone, leveraging your Flash skills to make great iPhone games.

Haxe on the iPhone simulator

Facebook basics

You can integrate your application with facebook in two way: with an IFRAME (using XFBML) or with FBML.
(If you are already familiar with how a Facebook application work you can skip this step)

You can embed your content in a Facebook page through FBML or use an IFRAME

Build your website using FBML tags

Facebook will be a proxy between your server and the user's browser: it will load a page form your own server like a normal browser, parse it, "enhance" it with his components and then embed it in a Facebook page. You will use standard HTML tags plus FBML tags.

Pros:

• You can use almost standard HTML, but with some other tags like: <fb:comments ... />, <fb:wall ... />
• Feature rich: with a simple tag integrate wall, comments, tabs, dashboard and many others components (Complete list of facebook tags)
• The url in the browser follow the navigation
• Faster when you need data from facebook database (groups, friends, etc.)

Cons:

• Slower page load times: restart the facebook chat at every request
• Can't use standard JavaScript, only FBJS that's almost equals but your existing scripts and libraries won't work
• Its losing ground: Facebook is trying to take IFRAME/XFBML on par

Embed using an IFRAME

Use an iframe: just build a standard web site and let FB embeds it in an iframe

Pros:

• Better ajax support: you can use standard javascript, html and css
• Easy to debug, its just a standard web site
• Faster page load times

Cons:

• Less features than with FBML (but XFBML is rapidly improving)
• Slower when you need data from facebook database (eg: user's friends, groups, etc.)
• The url in the browser doesn't follow the navigation
• A bit more complex

We'll start with FBML since its easier to use and to find help about on the forums.
However take a look at XFBML in the future, since the Facebook team has really improved it recently and they are trying to push them on par.

See facebook wiki for further details on the differences between FMBL and IFRAME.

Integration

First of all, setup your FBML app and write down your api key and secret key.

Just follow the onscreen instructions or the wiki, but care attention to the Canvas Page URL:
it is something like: http://apps.facebook.com/*APPLICATION_NAME* and it is the url through the user can reach your app.

While the Canvas Callback URL (for example: http://www.yourserver.com/fbapp) its the address of your own web server, where you'll deploy your application.
With a dynamic dns service like dyndns you can create a domain name that map to the public address of your development machine, so that you can host your app on your dev machine while allowing Facebook to reach it.

Facebook will map every canvas url: http://apps.facebook.com/*APPLICATION_NAME*/foo to your callback url: http://www.yourserver.com/fbapp/foo

After you have done with the setup, you can use the official PHP client to interact with Facebook.

First, set up an empty Zend Framework project: you can use the Zend Studio for Eclipse wizard or the new Zend_Tool command line.

Use Zend Studio wizard to create an empty Zend Framewrok project

Then, download the client and copy the files in the php folder of the archive to the library/facebook folder of you Zend Framework project.

Now you can start using the client.

The Controller

To start, write in your controllers/IndexController.php:

The line: $err = error_reporting(E_ERROR); is needed to hide some strange php notices from the facebook.php file.
In the line 12 we instantiate our client with the api key and secret taken during the application set up.
With the require_login method you can require the user to "add" your application.
Notice that many api features are available only if the user has added the application.

Then in your Zend actions you can call every standard method of the api with the
$facebook->api_client variable, for example:

See the complete list of methods on the wiki and try them with the API console tool.

The View

Now that you know how to interact with Facebook, you can show a simple page containing the "Comments box" component.

In your layouts/main.phtml file write:

As you can see we don't have to put the standard html opening tags in your layout (<html><head>...) since Facebook will load the page from your server and embed it in his own HTML canvas page.
We had also used our first FBML tag: <fb:title> to set the page title in the browser titlebar (we can't use the ZF headTitle() method here).

Now create a view script for your index action of the index controller views/scripts/index/index.phtml:

This will place a comment box in your page. Notice that the returnurl property need to point to your canvas url and not your callback url. (substitute *APPLICATION_NAME* with your canvas url)

To experiment with the various <fb:* > tags use the FBML console.

Now you can go to your canvas url to see the result:

Your first Facebook app with Zend Framework

In the HTML source of the canvas page you can see the original FBML used to generate the page and sometimes some errors/warnings.

Javascript and CSS

You can embed JavaScript in your FBML like in HTML, but only a special flavour of JavaScript: FBJS.
It is almost like the standard one, but there are some differences and your existing scripts and libraries won't work.

If you want to embed an external .js file, you'll have to specify the absolute path. Not only: Facebook will keep a copy of your script, even if you modify it, so you'll have to put a timestamp in the url to force a cache refresh.

For example, if you want to embed a script in your index.phtml:

In this way Facebook will load the script from the url: http://www.yourserver.com/fbapp/scripts/js.js?v=1231707071.
When you'll edit the file, the number will change and FB will reload it.

The same apply to CSS:

CSS in FB is almost standard, but use absolute urls.
Also be sure to write clean CSS, otherwise the Facebook parser will sometimes hang without and explanation.

Make things easier

We can use a base controller class.
In library/FacebookController.php write:

In this way, our IndexController can be rewritten in this simplier way:

We had made IndexController inherit from FacebookController, and used its method requireLogin, without requiring to set up the Facebook client.

Not only:
with the $simulateFb variable set to true you can preview your site outside the Facebook canvas page without requiring the login (but you'll not see the FBML components).

With $useTestApplication you can use a different pair of api key and secret for the development, while keeping your main application safe. (you need to set up another app to obtain the keys)

Also the FacebookController will allow the standard Zend Framework _redirect method to work and will bind Zend session to the one of Facebook.

Finally in the last line we set up the charset encoding to be sure it will be the same of the Facebook canvas page.

Thats all:
now download the tutorial sources and start building your own Facebook app.