3 +--------------------------------------------------------------------+
4 | CiviCRM version 4.7 |
5 +--------------------------------------------------------------------+
6 | Copyright CiviCRM LLC (c) 2004-2015 |
7 +--------------------------------------------------------------------+
8 | This file is a part of CiviCRM. |
10 | CiviCRM is free software; you can copy, modify, and distribute it |
11 | under the terms of the GNU Affero General Public License |
12 | Version 3, 19 November 2007 and the CiviCRM Licensing Exception. |
14 | CiviCRM is distributed in the hope that it will be useful, but |
15 | WITHOUT ANY WARRANTY; without even the implied warranty of |
16 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. |
17 | See the GNU Affero General Public License for more details. |
19 | You should have received a copy of the GNU Affero General Public |
20 | License and the CiviCRM Licensing Exception along |
21 | with this program; if not, contact CiviCRM LLC |
22 | at info[AT]civicrm[DOT]org. If you have questions about the |
23 | GNU Affero General Public License or the licensing of CiviCRM, |
24 | see the CiviCRM license FAQ at http://civicrm.org/licensing |
25 +--------------------------------------------------------------------+
29 * Component stores all the static and dynamic information of the various
33 * @copyright CiviCRM LLC (c) 2004-2015
37 class CRM_Core_Component
{
40 * End part (filename) of the component information class'es name
41 * that needs to be present in components main directory.
43 const COMPONENT_INFO_CLASS
= 'Info';
45 private static $_info = NULL;
47 static $_contactSubTypes = NULL;
54 private static function &_info($force = FALSE) {
55 if (self
::$_info == NULL ||
$force) {
56 self
::$_info = array();
59 $config = CRM_Core_Config
::singleton();
60 $c = self
::getComponents();
62 foreach ($c as $name => $comp) {
63 if (in_array($name, $config->enableComponents
)) {
64 self
::$_info[$name] = $comp;
74 * @param null $attribute
78 public static function get($name, $attribute = NULL) {
79 $comp = CRM_Utils_Array
::value($name, self
::_info());
81 return CRM_Utils_Array
::value($attribute, $comp->info
);
92 public static function &getComponents($force = FALSE) {
93 static $_cache = NULL;
95 if (!$_cache ||
$force) {
98 $cr = new CRM_Core_DAO_Component();
100 while ($cr->fetch()) {
101 $infoClass = $cr->namespace . '_' . self
::COMPONENT_INFO_CLASS
;
102 require_once str_replace('_', DIRECTORY_SEPARATOR
, $infoClass) . '.php';
103 $infoObject = new $infoClass($cr->name
, $cr->namespace, $cr->id
);
104 if ($infoObject->info
['name'] !== $cr->name
) {
105 CRM_Core_Error
::fatal("There is a discrepancy between name in component registry and in info file ({$cr->name}).");
107 $_cache[$cr->name
] = $infoObject;
117 * Array(string $name => int $id).
119 public static function &getComponentIDs() {
120 $componentIDs = array();
122 $cr = new CRM_Core_DAO_Component();
124 while ($cr->fetch()) {
125 $componentIDs[$cr->name
] = $cr->id
;
128 return $componentIDs;
137 static public function &getEnabledComponents($force = FALSE) {
138 return self
::_info($force);
141 static public function flushEnabledComponents() {
142 self
::getEnabledComponents(TRUE);
146 * @param bool $translated
150 public static function &getNames($translated = FALSE) {
151 $allComponents = self
::getComponents();
154 foreach ($allComponents as $name => $comp) {
156 $names[$comp->componentID
] = $comp->info
['translatedName'];
159 $names[$comp->componentID
] = $name;
171 public static function invoke(&$args, $type) {
172 $info = self
::_info();
173 $config = CRM_Core_Config
::singleton();
175 $firstArg = CRM_Utils_Array
::value(1, $args, '');
176 $secondArg = CRM_Utils_Array
::value(2, $args, '');
177 foreach ($info as $name => $comp) {
178 if (in_array($name, $config->enableComponents
) &&
179 (($comp->info
['url'] === $firstArg && $type == 'main') ||
180 ($comp->info
['url'] === $secondArg && $type == 'admin')
183 if ($type == 'main') {
184 // also set the smarty variables to the current component
185 $template = CRM_Core_Smarty
::singleton();
186 $template->assign('activeComponent', $name);
187 if (!empty($comp->info
[$name]['formTpl'])) {
188 $template->assign('formTpl', $comp->info
[$name]['formTpl']);
190 if (!empty($comp->info
[$name]['css'])) {
191 $styleSheets = '<style type="text/css">@import url(' . "{$config->resourceBase}css/{$comp->info[$name]['css']});</style>";
192 CRM_Utils_System
::addHTMLHead($styleSheet);
195 $inv = $comp->getInvokeObject();
206 public static function xmlMenu() {
208 // lets build the menu for all components
209 $info = self
::getComponents(TRUE);
212 foreach ($info as $name => $comp) {
213 $files = array_merge($files,
224 public static function &menu() {
225 $info = self
::_info();
227 foreach ($info as $name => $comp) {
228 $mnu = $comp->getMenuObject();
230 $ret = $mnu->permissioned();
231 $items = array_merge($items, $ret);
233 $ret = $mnu->main($task);
234 $items = array_merge($items, $ret);
241 * @param bool $oldMode
245 public static function addConfig(&$config, $oldMode = FALSE) {
246 $info = self
::_info();
248 foreach ($info as $name => $comp) {
249 $cfg = $comp->getConfigObject();
250 $cfg->add($config, $oldMode);
256 * @param string $componentName
260 public static function getComponentID($componentName) {
261 $info = self
::_info();
262 if (!empty($info[$componentName])) {
263 return $info[$componentName]->componentID
;
271 * @param int $componentID
273 * @return int|null|string
275 public static function getComponentName($componentID) {
276 $info = self
::_info();
278 $componentName = NULL;
279 foreach ($info as $compName => $component) {
280 if ($component->componentID
== $componentID) {
281 $componentName = $compName;
286 return $componentName;
292 public static function &getQueryFields() {
293 $info = self
::_info();
295 foreach ($info as $name => $comp) {
296 if ($comp->usesSearch()) {
297 $bqr = $comp->getBAOQueryObject();
298 $flds = $bqr->getFields();
299 $fields = array_merge($fields, $flds);
307 * @param string $fnName
309 public static function alterQuery(&$query, $fnName) {
310 $info = self
::_info();
312 foreach ($info as $name => $comp) {
313 if ($comp->usesSearch()) {
314 $bqr = $comp->getBAOQueryObject();
315 $bqr->$fnName($query);
321 * @param string $fieldName
327 public static function from($fieldName, $mode, $side) {
328 $info = self
::_info();
331 foreach ($info as $name => $comp) {
332 if ($comp->usesSearch()) {
333 $bqr = $comp->getBAOQueryObject();
334 $from = $bqr->from($fieldName, $mode, $side);
345 * @param bool $includeCustomFields
349 public static function &defaultReturnProperties(
351 $includeCustomFields = TRUE
353 $info = self
::_info();
356 foreach ($info as $name => $comp) {
357 if ($comp->usesSearch()) {
358 $bqr = $comp->getBAOQueryObject();
359 $properties = $bqr->defaultReturnProperties($mode, $includeCustomFields);
369 * @param CRM_Core_Form $form
371 public static function &buildSearchForm(&$form) {
372 $info = self
::_info();
374 foreach ($info as $name => $comp) {
375 if ($comp->usesSearch()) {
376 $bqr = $comp->getBAOQueryObject();
377 $bqr->buildSearchForm($form);
386 public static function searchAction(&$row, $id) {
387 $info = self
::_info();
389 foreach ($info as $name => $comp) {
390 if ($comp->usesSearch()) {
391 $bqr = $comp->getBAOQueryObject();
392 $bqr->searchAction($row, $id);
400 public static function &contactSubTypes() {
401 if (self
::$_contactSubTypes == NULL) {
402 self
::$_contactSubTypes = array();
404 return self
::$_contactSubTypes;
414 public static function &contactSubTypeProperties($subType, $op) {
415 $properties = self
::contactSubTypes();
416 if (array_key_exists($subType, $properties) &&
417 array_key_exists($op, $properties[$subType])
419 return $properties[$subType][$op];
421 return CRM_Core_DAO
::$_nullObject;
425 * FIXME: This function does not appear to do anything. The is_array() check runs on a bunch of objects and (always?) returns false
427 public static function &taskList() {
428 $info = self
::_info();
431 foreach ($info as $name => $value) {
432 if (is_array($info[$name]) && isset($info[$name]['task'])) {
433 $tasks +
= $info[$name]['task'];
440 * Handle table dependencies of components.
442 * @param array $tables
446 public static function tableNames(&$tables) {
447 $info = self
::_info();
449 foreach ($info as $name => $comp) {
450 if ($comp->usesSearch()) {
451 $bqr = $comp->getBAOQueryObject();
452 $bqr->tableNames($tables);
458 * Get components info from info file.
460 public static function getComponentsFromFile($crmFolderDir) {
461 $components = array();
462 //traverse CRM folder and check for Info file
463 if (is_dir($crmFolderDir) && $dir = opendir($crmFolderDir)) {
464 while ($subDir = readdir($dir)) {
465 // skip the extensions diretory since it has an Info.php file also
466 if ($subDir == 'Extension') {
470 $infoFile = $crmFolderDir . "/{$subDir}/" . self
::COMPONENT_INFO_CLASS
. '.php';
471 if (file_exists($infoFile)) {
472 $infoClass = 'CRM_' . $subDir . '_' . self
::COMPONENT_INFO_CLASS
;
473 require_once str_replace('_', DIRECTORY_SEPARATOR
, $infoClass) . '.php';
474 $infoObject = new $infoClass(NULL, NULL, NULL);
475 $components[$infoObject->info
['name']] = $infoObject;