In order to build and run Shindig for PHP, you must have the following:
- A Subversion client installed in order to checkout the code.
- Apache with mod_rewrite enabled.
- PHP 5.2.x with the json, simplexml, mcrypt and curl extentions enabled.
Create a subdirectory in your web document root, e.g. /var/www/html and checkout the Shindig code from its Subversion repository
svn co http://svn.apache.org/repos/asf/incubator/shindig/trunk/ .
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... </VirtualHost>
Restart apache, and point your browser to:
you should see something like this.
b. Run with an existing host
If you cannot/don't want to create a virtual host, you can edit the file php/config.php and change the web_prefix setting to '/shindig/php'.
Then you can run the gadget by pointing your browser to:
Read php/README for original instructions on how to start up the php shindig server.
How to contribute to Shindig
Shindig is strengthened by accepting quality contributions from a wide variety of sources. These steps serve as an in-progress guide to contributing code into the source code repository for Shindig.
For new people to the project, creating patches is the way to get started and build your reputation.
- Start editing the code, since Subversion is being used no checkout is needed
- Move to top level folder, e.g.
- Generate diffs using
svn di > fix-xxx-bug.patch
- If needed, remove from the patch file any changes you do not want to submit until later
- If you're new, create an account on https://issues.apache.org/jira/browse/SHINDIG
- Create a new issue with the patch:
- Follow the "New" link: https://issues.apache.org/jira/secure/CreateIssue!default.jspa
- For the "Issue Type", select "Bug", "Improvement" or "New Feature"
- Click "Next>>"
- Enter summary / description and select the component
- Click "Create"
- Click "Attach file" and select the
- Check the "Grant license to ASF for inclusion in ASF works" option
- Click on "Watching" and then click on "Start" watching to get updates
The newly created issue will automatically be sent to firstname.lastname@example.org. You should also subscribe using email@example.com to see all the feedback, in which case you'll get the updates on the issue without needing to "Watch" them individually.
If you have commit permission, then you can submit directly from subversion and should also look at patches provided by others.
- Move to top level folder, e.g.
cd ~/src/shindig(you might find it helpful to create a separate tree from your working tree)
- Apply patch:
patch p0 < mychanges.patch
- For the log message put
Applied patch for JIRA issue SHINDIG-XXX, where XXX is the JIRA issue number you are applying the patch for. This will automatically update the JIRA issue with a link to the subversion commit. You don't need additional comments as the JIRA issue should contain enough information already.
- JIRA Issue with patch: http://issues.apache.org/jira/browse/SHINDIG-13
- Code Change: http://svn.apache.org/viewvc?view=rev&revision=612299
- To subscribe to the Shindig mailing list, send a blank email to firstname.lastname@example.org
- The email archives are located at:
To file bugs or feature requests, please use Shindig's issue tracker (JIRA):
- Login to the issue tracker (top right corner) or follow the instructions to make a new account (anyone can make an account).
- Once logged in you should be able to see all of Shindig's open issues.
- If the issue has not been filed, use the "Create a new issue" link (this will not be shown if you are not logged in).