/**
- * File for the CiviCRM APIv3 extension functions
+ * This api exposes CiviCRM extension.
*
* @package CiviCRM_APIv3
- * @subpackage API_Extension
- *
- * @copyright CiviCRM LLC (c) 2004-2014
- * @version $Id$
- *
*/
/**
- * Install an extension
+ * Install an extension.
*
* @param array $params
* Input parameters.
- * - key: string, eg "com.example.myextension"
- * - keys: mixed; array of string, eg array("com.example.myextension1", "com.example.myextension2") or string with comma-delimited list
- * using 'keys' should be more performant than making multiple API calls with 'key'
+ * - key: string, eg "com.example.myextension"
+ * - keys: mixed; array of string, eg array("com.example.myextension1", "com.example.myextension2") or string with comma-delimited list
+ * Using 'keys' should be more performant than making multiple API calls with 'key'.
*
* @return array
* API result
- * @static void
- * @access public
- * @example ExtensionInstall.php
- *
*/
function civicrm_api3_extension_install($params) {
$keys = _civicrm_api3_getKeys($params);
}
/**
- * Upgrade an extension - runs upgrade_N hooks and system.flush
+ * Upgrade an extension - runs upgrade_N hooks and system.flush.
*
* @return array
* API result
- * @static void
- * @access public
- *
*/
function civicrm_api3_extension_upgrade() {
CRM_Core_Invoke::rebuildMenuAndCaches(TRUE);
}
/**
- * Enable an extension
+ * Enable an extension.
*
* @param array $params
* Input parameters.
*
* @return array
* API result
- * @static void
- * @access public
- * @example ExtensionEnable.php
- *
*/
function civicrm_api3_extension_enable($params) {
$keys = _civicrm_api3_getKeys($params);
}
/**
- * Disable an extension
+ * Disable an extension.
*
* @param array $params
* Input parameters.
*
* @return array
* API result
- * @static void
- * @access public
- * @example ExtensionDisable.php
- *
*/
function civicrm_api3_extension_disable($params) {
$keys = _civicrm_api3_getKeys($params);
}
/**
- * Uninstall an extension
+ * Uninstall an extension.
*
* @param array $params
* Input parameters.
*
* @return array
* API result
- * @static void
- * @access public
- * @example ExtensionUninstall.php
- *
*/
function civicrm_api3_extension_uninstall($params) {
$keys = _civicrm_api3_getKeys($params);
}
/**
- * Download and install an extension
+ * Download and install an extension.
*
* @param array $params
* Input parameters.
* @throws API_Exception
* @return array
* API result
- * @static void
- * @access public
- * @example ExtensionDownload.php
*/
function civicrm_api3_extension_download($params) {
- if (! array_key_exists('key', $params)) {
+ if (!array_key_exists('key', $params)) {
throw new API_Exception('Missing required parameter: key');
}
- if (! array_key_exists('url', $params)) {
- if (! CRM_Extension_System::singleton()->getBrowser()->isEnabled()) {
+ if (!array_key_exists('url', $params)) {
+ if (!CRM_Extension_System::singleton()->getBrowser()->isEnabled()) {
throw new API_Exception('Automatic downloading is diabled. Try adding parameter "url"');
}
if ($reqs = CRM_Extension_System::singleton()->getBrowser()->checkRequirements()) {
}
}
- if (! array_key_exists('url', $params)) {
+ if (!array_key_exists('url', $params)) {
throw new API_Exception('Cannot resolve download url for extension. Try adding parameter "url"');
}
return civicrm_api3_create_error($requirement['message']);
}
- if (! CRM_Extension_System::singleton()->getDownloader()->download($params['key'], $params['url'])) {
+ if (!CRM_Extension_System::singleton()->getDownloader()->download($params['key'], $params['url'])) {
return civicrm_api3_create_error('Download failed - ZIP file is unavailable or malformed');
}
CRM_Extension_System::singleton()->getCache()->flush();
}
/**
- * Download and install an extension
+ * Download and install an extension.
*
* @param array $params
* Input parameters.
*
* @return array
* API result
- * @static void
- * @access public
- * @example ExtensionRefresh.php
- *
*/
function civicrm_api3_extension_refresh($params) {
$defaults = array('local' => TRUE, 'remote' => TRUE);
}
/**
- * Get a list of available extensions
+ * Get a list of available extensions.
*
* @param array $params
*
* @return array
* API result
- * @static void
- * @access public
- * @example ExtensionGet.php
*/
function civicrm_api3_extension_get($params) {
$statuses = CRM_Extension_System::singleton()->getManager()->getStatuses();
}
/**
- * Determine the list of extension keys
+ * Determine the list of extension keys.
*
* @param array $params
* API request params with 'key' or 'keys'.
+ *
* @return array
- * of extension keys
+ * Array of extension keys
* @throws API_Exception
*/
function _civicrm_api3_getKeys($params) {