Difference between revisions of "CC PHP-AJAX Chooser"
(One intermediate revision by the same user not shown) | |||
Line 3: | Line 3: | ||
* PHP Web Services client code | * PHP Web Services client code | ||
* PHP Web Service proxy (to accommodate browser security) | * PHP Web Service proxy (to accommodate browser security) | ||
− | * Javascript and PHP for running the chooser itself | + | * Javascript and PHP for running the chooser itself |
− | + | The Javascript bundles the [http://jquery.org jQuery] library for event handling and communication with the web service proxy. | |
+ | |||
+ | The PHP-AJAX Chooser is licensed under the [http://opensource.org/licenses/mit-license.php MIT License] and is used in the [[WpLicense]] [http://wordpress.org WordPress] extension. | ||
== Getting the Code == | == Getting the Code == | ||
Line 13: | Line 15: | ||
$ svn co https://svn.sourceforge.net/svnroot/cctools/api_client/php/cc_ajax_chooser | $ svn co https://svn.sourceforge.net/svnroot/cctools/api_client/php/cc_ajax_chooser | ||
− | Additional information: [http://subversion.tigris.org/ Subversion] | + | ''Additional information:'' [http://subversion.tigris.org/ Subversion] |
== Configuring == | == Configuring == | ||
Line 30: | Line 32: | ||
== Creating the Chooser == | == Creating the Chooser == | ||
− | + | The <code>index.php</code> provided with the chooser demonstrates how to create the chooser. There are two functions provided by <code>html_ui.php</code> which are used in conjunction to create the chooser. | |
+ | |||
+ | # <code>scriptHeader($base)</code><br/>Call this in the header to insert <code><script></code> tags for AJAX support. The $base parameter specifies the relative path from the calling page to the <code>cc_ajax_chooser</code> installation. | ||
+ | # <code>licenseChooser($base, $defaults)</code><br/>This function inserts the HTML necessary for the chooser and connects the event handlers. <code>$base</code> has the same meaning as for scriptHeader; <code>$defaults</code> is an optional hash of the default license name and URI. | ||
[[Category:Developer]] | [[Category:Developer]] | ||
[[Category:Developer:WebServices]] | [[Category:Developer:WebServices]] | ||
[[Category:Technology]] | [[Category:Technology]] |
Latest revision as of 19:10, 7 November 2006
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
The Javascript bundles the jQuery library for event handling and communication with the web service proxy.
The PHP-AJAX Chooser is licensed under the MIT License and is 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
The index.php
provided with the chooser demonstrates how to create the chooser. There are two functions provided by html_ui.php
which are used in conjunction to create the chooser.
scriptHeader($base)
Call this in the header to insert<script>
tags for AJAX support. The $base parameter specifies the relative path from the calling page to thecc_ajax_chooser
installation.licenseChooser($base, $defaults)
This function inserts the HTML necessary for the chooser and connects the event handlers.$base
has the same meaning as for scriptHeader;$defaults
is an optional hash of the default license name and URI.