Version User Scope of changes
Oct 29 2008, 4:25 PM EDT (current) superwomyn 1 word added, 1 word deleted
May 21 2008, 5:20 PM EDT DevinCanterberry 2 words added, 2 words deleted

Changes

Key:  Additions   Deletions

String generateCellURL()
This method is overloadableoverridable and should not be called directly.

This method generates a URL to be associated with a cell. By default, this method returns the current page URL with the cellId querystring parameter set to the new cell ID.

Parameters
StringparentIDThe identifier for the parent cell.Required
StringtitleThe title of the cell.Required
String []tagsThe keyword tags for the cell.Defaults to []
StringcellIDThe identifier for the cell.Required
Returns the URL to be associated with the cell.

Usage

Synchronous
if( window.WPCAPI ) {
WPCAPI.generateCellURL = function( parentID, title, tags, cellID ) {
return "/path/to/template/engine?cellId=" + cellID;
};
}

Asynchronous
if( window.WPCAPI ) {
WPCAPI.generateCellURL = function( parentID, title, tags, cellID ) {

var params = '?'
+ "parentID=" + encodeURIComponent(parentID)
+ "&title=" + encodeURIComponent(title)
+ "&tags=" + encodeURIComponent(tags)
+ "&cellID=" + encodeURIComponent(cellID);

var request = new XMLHttpRequest();
request.open( "GET", "/path/to/generateURL/action" + params,true );
request.onreadystatechange = function() {

if( request.readyState == 4 ) {
var response = request.responseXML; // Format: <cell url="..."/>
var url = response ? response.getAttribute("url") : null;
WPCAPI.generateCellURL_Callback(url);
}

};
request.send(null);

return null;

};
}