Installing and Running The PHP Shindig Gadget Server
============================================

Prequisites before building Shindig for PHP
============================================
In order to build and run Shindig for PHP, you must have the following:

- A Subversion client installed in order to checkout the code.
  Instructions for downloading and installing Subversion can be found here:
  http://subversion.tigris.org/
- Apache with mod_rewrite enabled.
- PHP 5.2.x with the json, simplexml, mcrypt and curl extentions enabled.


Getting the code
============================================
Create a subdirectory in your web document root, e.g. /var/www/html and
checkout the Shindig code from its Subversion repository

mkdir /var/www/html/shindig
cd /var/www/html/shindig
svn co http://svn.apache.org/repos/asf/incubator/shindig/trunk/ .


Running Shindig
============================================
With PHP There is no need to build anything - the source code
is already built.

To run the code, you have several options:

a. Create a new virtual host

Point your apache to the php dir with a virtual host like:

	<VirtualHost your_ip:your_port>
	       ServerName your.host
	       DocumentRoot /var/www/html/shindig/php
	       ... other normal settings in vhosts...
		<Directory />
			AllowOverride All
		</Directory>
	</VirtualHost>

Restart apache, and point your browser to:

http://<your.host>/gadgets/ifr?url=http://www.labpixies.com/campaigns/todo/todo.xml

you should see something like this:
http://shindig.chabotc.com/gadgets/ifr?url=http://www.labpixies.com/campaigns/todo/todo.xml

b. Run with an existing host

If you cannot/don't want to create a virtual host, you can edit the file php/config/container.php
or php/config/local.php (see the comments php/config/container.php for documentation of the
configuration system) and change the web_prefix setting to '/shindig/php'.

In this case, you should also change all paths in shindig/config/container.js
(see the comments there for documentation of the JSON configuration system).

Then you can run the gadget by pointing your browser to:

http://<your.host>/shindig/php/gadgets/ifr?url=http://www.labpixies.com/campaigns/todo/todo.xml