protected $keyword;
/**
- * @param string $name name of the component
- * @param string $namespace namespace prefix for component's files
+ * @param string $name
+ * Name of the component.
+ * @param string $namespace
+ * Namespace prefix for component's files.
* @param int $componentID
*/
public function __construct($name, $namespace, $componentID) {
* class.
*
* @return array collection of required component settings
- * @access public
*
*/
abstract public function getInfo();
* @param bool $getAllUnconditionally
*
* @return array|null collection of permissions, null if none
- * @access public
*/
abstract public function getPermissions($getAllUnconditionally = FALSE);
/**
* Determine how many other records refer to a given record
*
- * @param CRM_Core_DAO $dao the item for which we want a reference count
+ * @param CRM_Core_DAO $dao
+ * The item for which we want a reference count.
* @return array each item in the array is an array with keys:
* - name: string, eg "sql:civicrm_email:contact_id"
* - type: string, eg "sql"
*
* @return array|null collection of required dashboard settings,
* null if no element offered
- * @access public
*
*/
abstract public function getUserDashboardElement();
*
* @return array|null collection of required dashboard settings,
* null if no element offered
- * @access public
*
*/
abstract public function registerTab();
*
* @return array|null collection of required pane settings,
* null if no element offered
- * @access public
*
*/
abstract public function registerAdvancedSearchPane();
* class.
*
* @return array|null collection of activity types
- * @access public
*
*/
abstract public function getActivityTypes();
* marked as enabled in configuration.
*
* @return boolean true if component is enabled, false if not
- * @access public
*
*/
public function isEnabled() {
* Provides component's configuration object.
*
* @return mixed component's configuration object
- * @access public
*
*/
public function getConfigObject() {
* Provides component's menu definition object.
*
* @return mixed component's menu definition object
- * @access public
*
*/
public function getMenuObject() {
* Provides component's invocation object.
*
* @return mixed component's invocation object
- * @access public
*
*/
public function getInvokeObject() {
* Provides component's BAO Query object.
*
* @return mixed component's BAO Query object
- * @access public
*
*/
public function getBAOQueryObject() {
/**
* Builds advanced search form's component specific pane.
*
- * @access public
*
*/
public function buildAdvancedSearchPaneForm(&$form) {
* Provides component's user dashboard page object.
*
* @return mixed component's User Dashboard applet object
- * @access public
*
*/
public function getUserDashboardObject() {
* Provides component's contact record tab object.
*
* @return mixed component's contact record tab object
- * @access public
*
*/
public function getTabObject() {
* Provides component's advanced search pane's template path.
*
* @return string component's advanced search pane's template path
- * @access public
*
*/
public function getAdvancedSearchPaneTemplatePath() {
* Provides information whether given component uses system wide search.
*
* @return boolean true if component needs search integration
- * @access public
*
*/
public function usesSearch() {
* Provides the xml menu files
*
* @return array array of menu files
- * @access public
*
*/
public function menuFiles() {
* FIXME: accessed from beyond component infrastructure.
*
* @return string component keyword
- * @access public
*
*/
public function getKeyword() {
* Helper for figuring out menu XML file location.
*
* @return mixed component's element as class instance
- * @access private
*
*/
private function _getMenuXMLPath() {
* @param $cl
*
* @return mixed component's element as class instance
- * @access private
*/
private function _instantiate($cl) {
$className = $this->namespace . '_' . $cl;
- require_once (str_replace('_', DIRECTORY_SEPARATOR, $className) . '.php');
+ require_once str_replace('_', DIRECTORY_SEPARATOR, $className) . '.php';
return new $className();
}
}
-