CC PHP-AJAX Chooser

From Creative Commons
Revision as of 19:04, 7 November 2006 by Nathan Yergler (talk | contribs)
Jump to: navigation, search

The CC PHP-AJAX Chooser is a simple way to add a license chooser to your PHP-based web application. It contains the following components:

  • PHP Web Services client code
  • PHP Web Service proxy (to accommodate browser security)
  • Javascript and PHP for running the chooser itself.

It is licensed under the MIT License and is the same code used in the WpLicense WordPress extension.

Getting the Code

The code is available from Subversion as part of the cctools project at SourceForge. You can retrieve the code using the Subversion command-line client using the following command:

$ svn co https://svn.sourceforge.net/svnroot/cctools/api_client/php/cc_ajax_chooser

Additional information: Subversion

Configuring

Before deployment you must configure the Javascript portion of the chooser to point to the web services proxy. The WS_ROOT_URL variable in js/chooser.js must point to the URL ws_proxy.php is served from on your server.

The PHP Chooser code can optionally be configured in two ways:

  • to use a particular version of the web services
  • to use a proxy for web service calls

For information on available versions of the web services, see the API documentation. The code in Subversion defaults to the 1.5 version of the web services. To change the version, update the $WS_ROOT variable in ws_client.php.

To configure a proxy for web service calls, edit the the $PROXY and $USE_PROXY variables in ws_client.php The proxy server, $PROXY, should be specified without the http:// prefix.

Creating the Chooser