CRM_Contribute_PseudoConstant

class CRM_Contribute_PseudoConstant extends CRM_Core_PseudoConstant

This class holds all the Pseudo constants that are specific to Contributions.

This avoids polluting the core class and isolates the mass mailer class.

Methods

static array|bool
get(string $daoName, string $fieldName, array $params = [], string $context = NULL)

Low-level option getter, rarely accessed directly.

from CRM_Core_PseudoConstant
static bool|null|string
getLabel(string $baoName, string $fieldName, string|int $key)

Fetch the translated label for a field given its key.

from CRM_Core_PseudoConstant
static bool|null|string
getName(string $baoName, string $fieldName, string|int $key)

Fetch the machine name for a field given its key.

from CRM_Core_PseudoConstant
static bool|null|string|int
getKey(string $baoName, string $fieldName, string|int $value)

Fetch the key for a field option given its name.

from CRM_Core_PseudoConstant
static string|null
getOptionEditUrl($fieldSpec)

Lookup the admin page at which a field's option list can be edited

from CRM_Core_PseudoConstant
static array
populate(array $var, string $name, bool $all = FALSE, string $retrieve = 'name', string $filter = 'is_active', string $condition = NULL, bool $orderby = NULL, string $key = 'id', bool $force = NULL) deprecated

No description

from CRM_Core_PseudoConstant
static 
flush(bool|string $name = 'cache')

Flush given pseudoconstant so it can be reread from db nex time it's requested.

static array
activityType() deprecated

No description

from CRM_Core_PseudoConstant
static array
stateProvince(bool|int $id = FALSE, bool $limit = TRUE)

Get all the State/Province from database.

from CRM_Core_PseudoConstant
static array
stateProvinceAbbreviation(bool|int $id = FALSE, bool $limit = TRUE)

Get all the State/Province abbreviations from the database.

from CRM_Core_PseudoConstant
static array
stateProvinceAbbreviationForCountry(int $countryID)

Get all the State/Province abbreviations from the database for the specified country.

from CRM_Core_PseudoConstant
static array
stateProvinceAbbreviationForDefaultCountry()

Get all the State/Province abbreviations from the database for the default country.

from CRM_Core_PseudoConstant
static array|null
country(bool|int $id = FALSE, bool $applyLimit = TRUE)

Get all the countries from database.

from CRM_Core_PseudoConstant
static array
countryIsoCode(bool $id = FALSE)

Get all the country ISO Code abbreviations from the database.

from CRM_Core_PseudoConstant
static array
allGroup(string $groupType = NULL, bool $excludeHidden = TRUE) deprecated

No description

from CRM_Core_PseudoConstant
static array
group(string $groupType = NULL, bool $excludeHidden = TRUE)

Get all permissioned groups from database.

from CRM_Core_PseudoConstant
static array
nestedGroup(bool $checkPermissions = TRUE, string|null $groupType = NULL, bool $excludeHidden = TRUE)

Fetch groups in a nested format suitable for use in select form element.

from CRM_Core_PseudoConstant
static array
staticGroup(bool $onlyPublic = FALSE, null $groupType = NULL, bool $excludeHidden = TRUE)

Get all permissioned groups from database.

from CRM_Core_PseudoConstant
static array
relationshipType(string $valueColumnName = 'label', bool $reset = FALSE, bool $isActive = 1)

Get all Relationship Types from database.

from CRM_Core_PseudoConstant
static array
currencyCode()

Get all the ISO 4217 currency codes

from CRM_Core_PseudoConstant
static array
county(bool|int $id = FALSE)

Get all the County from database.

from CRM_Core_PseudoConstant
static array
paymentProcessor(bool $all = FALSE, bool $test = FALSE, null $additionalCond = NULL) deprecated

No description

from CRM_Core_PseudoConstant
static array
paymentProcessorType(bool $all = FALSE, int $id = NULL, string $return = 'title') deprecated

No description

from CRM_Core_PseudoConstant
static array
worldRegion(bool $id = FALSE)

Get all the World Regions from Database.

from CRM_Core_PseudoConstant
static array
activityStatus(string $column = 'label') deprecated

No description

from CRM_Core_PseudoConstant
static array
visibility(string $column = 'label') deprecated

No description

from CRM_Core_PseudoConstant
static array
stateProvinceForCountry(int $countryID, string $field = 'name')

No description

from CRM_Core_PseudoConstant
static array
countyForState(int $stateID)

No description

from CRM_Core_PseudoConstant
static int|null
countryIDForStateID(int $stateID)

Given a state ID return the country ID, this allows us to populate forms and values for downstream code

from CRM_Core_PseudoConstant
static array
greeting($filter, string $columnName = 'label')

Get all types of Greetings.

from CRM_Core_PseudoConstant
static array
getExtensions()

Get all extensions.

from CRM_Core_PseudoConstant
static array
accountOptionValues(bool $optionGroupName, int $id = NULL, null $condition = NULL)

Get all options values.

from CRM_Core_PseudoConstant
static array
getModuleExtensions(bool $fresh = FALSE)

Fetch the list of active extensions of type 'module'

from CRM_Core_PseudoConstant
static array
getTaxRates()

Get all tax rates.

from CRM_Core_PseudoConstant
static array
emailOnHoldOptions()

Get participant status class options.

from CRM_Core_PseudoConstant
static array
financialType(int $id = NULL, bool $includeDisabled = FALSE) deprecated

No description

static array
financialAccount(int $id = NULL, int $financialAccountTypeId = NULL, string $retrieveColumn = 'name', string $key = 'id') deprecated

No description

static array
contributionPage(int $id = NULL, bool $all = FALSE) deprecated

No description

static array
paymentInstrument(string $columnName = 'label') deprecated

No description

static array
creditCard()

Get all the valid accepted credit cards.

static array
products(int $pageID = NULL)

Get all premiums.

static array
contributionStatus(int $id = NULL, string $columnName = 'label')

Get all the contribution statuses.

static array
pcPage(null $pageType = NULL, int $id = NULL)

Get all the Personal campaign pages.

static array
pcpStatus(string $column = 'label')

Get all PCP Statuses.

static int
getRelationalFinancialAccount(int $entityId, string $accountRelationType, string $entityTable = 'civicrm_financial_type', string $returnField = 'financial_account_id') deprecated

Get financial account for a Financial type.

static array
batch(int $id = NULL)

Get all batches.

Details

in CRM_Core_PseudoConstant at line 198
static array|bool get(string $daoName, string $fieldName, array $params = [], string $context = NULL)

Low-level option getter, rarely accessed directly.

NOTE: Rather than calling this function directly use CRM__BAO_::buildOptions()

Parameters

string $daoName
string $fieldName
array $params
  • name string name of the option group
  • flip boolean results are return in id => label format if false if true, the results are reversed
  • grouping boolean if true, return the value in 'grouping' column (currently unsupported for tables other than option_value)
  • localize boolean if true, localize the results before returning
  • condition string|array add condition(s) to the sql query - will be concatenated using 'AND'
  • keyColumn string the column to use for 'id'
  • labelColumn string the column to use for 'label'
  • orderColumn string the column to use for sorting, defaults to 'weight' column if one exists, else defaults to labelColumn
  • onlyActive boolean return only the action option values
  • fresh boolean ignore cache entries and go back to DB
string $context : Context string

Return Value

array|bool array on success, FALSE on error.

See also

https://docs.civicrm.org/dev/en/latest/framework/pseudoconstant/ NOTE: If someone undertakes a refactoring of this, please consider the use-case of the Setting.getoptions API. There is no DAO/field, but it would be nice to use the same 'pseudoconstant' struct in *.settings.php. This means loosening the coupling between $field lookup and the $pseudoconstant evaluation.
CRM_Core_DAO::buildOptionsContext

in CRM_Core_PseudoConstant at line 411
static bool|null|string getLabel(string $baoName, string $fieldName, string|int $key)

Fetch the translated label for a field given its key.

Parameters

string $baoName
string $fieldName
string|int $key TODO: Accept multivalued input?

Return Value

bool|null|string FALSE if the given field has no associated option list NULL if the given key has no corresponding option String if label is found

in CRM_Core_PseudoConstant at line 431
static bool|null|string getName(string $baoName, string $fieldName, string|int $key)

Fetch the machine name for a field given its key.

Parameters

string $baoName
string $fieldName
string|int $key

Return Value

bool|null|string FALSE if the given field has no associated option list NULL if the given key has no corresponding option String if label is found

in CRM_Core_PseudoConstant at line 451
static bool|null|string|int getKey(string $baoName, string $fieldName, string|int $value)

Fetch the key for a field option given its name.

Parameters

string $baoName
string $fieldName
string|int $value

Return Value

bool|null|string|int FALSE if the given field has no associated option list NULL if the given key has no corresponding option String|Number if key is found

in CRM_Core_PseudoConstant at line 464
static string|null getOptionEditUrl($fieldSpec)

Lookup the admin page at which a field's option list can be edited

Parameters

$fieldSpec

Return Value

string|null

in CRM_Core_PseudoConstant at line 514
static array populate(array $var, string $name, bool $all = FALSE, string $retrieve = 'name', string $filter = 'is_active', string $condition = NULL, bool $orderby = NULL, string $key = 'id', bool $force = NULL) deprecated

deprecated generic populate method. All pseudoconstant functions that use this method are also @deprecated The static array $var is populated from the db using the $name DAO. Note: any database errors will be trapped by the DAO.

Parameters

array $var The associative array we will fill.
string $name The name of the DAO.
bool $all Get all objects. default is to get only active ones.
string $retrieve The field that we are interested in (normally name, differs in some objects).
string $filter The field that we want to filter the result set with.
string $condition The condition that gets passed to the final query as the WHERE clause.
bool $orderby
string $key
bool $force

Return Value

array

at line 181
static flush(bool|string $name = 'cache')

Flush given pseudoconstant so it can be reread from db nex time it's requested.

Parameters

bool|string $name pseudoconstant to be flushed

in CRM_Core_PseudoConstant at line 594
static array activityType() deprecated

deprecated Please use the buildOptions() method in the appropriate BAO object. Get all Activty types. The static array activityType is returned

Return Value

array array reference of all activity types.

in CRM_Core_PseudoConstant at line 672
static array stateProvince(bool|int $id = FALSE, bool $limit = TRUE)

Get all the State/Province from database.

The static array stateProvince is returned, and if it's called the first time, the State Province DAO is used to get all the States.

Note: any database errors will be trapped by the DAO.

Parameters

bool|int $id
  • Optional id to return
bool $limit

Return Value

array array reference of all State/Provinces.

in CRM_Core_PseudoConstant at line 726
static array stateProvinceAbbreviation(bool|int $id = FALSE, bool $limit = TRUE)

Get all the State/Province abbreviations from the database.

Same as above, except gets the abbreviations instead of the names.

Parameters

bool|int $id
  • Optional id to return
bool $limit

Return Value

array array reference of all State/Province abbreviations.

in CRM_Core_PseudoConstant at line 774
static array stateProvinceAbbreviationForCountry(int $countryID)

Get all the State/Province abbreviations from the database for the specified country.

Parameters

int $countryID

Return Value

array array of all State/Province abbreviations for the given country.

in CRM_Core_PseudoConstant at line 788
static array stateProvinceAbbreviationForDefaultCountry()

Get all the State/Province abbreviations from the database for the default country.

Return Value

array array of all State/Province abbreviations for the given country.

in CRM_Core_PseudoConstant at line 809
static array|null country(bool|int $id = FALSE, bool $applyLimit = TRUE)

Get all the countries from database.

The static array country is returned, and if it's called the first time, the Country DAO is used to get all the countries.

Note: any database errors will be trapped by the DAO.

Parameters

bool|int $id
  • Optional id to return
bool $applyLimit

Return Value

array|null array reference of all countries.

in CRM_Core_PseudoConstant at line 884
static array countryIsoCode(bool $id = FALSE)

Get all the country ISO Code abbreviations from the database.

The static array countryIsoCode is returned, and if it's called the first time, the Country DAO is used to get all the countries' ISO codes.

Note: any database errors will be trapped by the DAO.

Parameters

bool $id

Return Value

array array reference of all country ISO codes.

in CRM_Core_PseudoConstant at line 919
static array allGroup(string $groupType = NULL, bool $excludeHidden = TRUE) deprecated

deprecated Please use the buildOptions() method in the appropriate BAO object. Get all groups from database The static array group is returned, and if it's called the first time, the Group DAO is used to get all the groups. Note: any database errors will be trapped by the DAO.

Parameters

string $groupType Type of group(Access/Mailing).
bool $excludeHidden Exclude hidden groups.

Return Value

array array reference of all groups.

in CRM_Core_PseudoConstant at line 952
static array group(string $groupType = NULL, bool $excludeHidden = TRUE)

Get all permissioned groups from database.

The static array group is returned, and if it's called the first time, the Group DAO is used to get all the groups.

Note: any database errors will be trapped by the DAO.

Parameters

string $groupType Type of group(Access/Mailing).
bool $excludeHidden Exclude hidden groups.

Return Value

array array reference of all groups.

in CRM_Core_PseudoConstant at line 963
static array nestedGroup(bool $checkPermissions = TRUE, string|null $groupType = NULL, bool $excludeHidden = TRUE)

Fetch groups in a nested format suitable for use in select form element.

Parameters

bool $checkPermissions
string|null $groupType
bool $excludeHidden

Return Value

array

in CRM_Core_PseudoConstant at line 985
static array staticGroup(bool $onlyPublic = FALSE, null $groupType = NULL, bool $excludeHidden = TRUE)

Get all permissioned groups from database.

The static array group is returned, and if it's called the first time, the Group DAO is used to get all the groups.

Note: any database errors will be trapped by the DAO.

Parameters

bool $onlyPublic
null $groupType
bool $excludeHidden

Return Value

array array reference of all groups.

in CRM_Core_PseudoConstant at line 1025
static array relationshipType(string $valueColumnName = 'label', bool $reset = FALSE, bool $isActive = 1)

Get all Relationship Types from database.

The static array group is returned, and if it's called the first time, the RelationshipType DAO is used to get all the relationship types.

Note: any database errors will be trapped by the DAO.

Parameters

string $valueColumnName Db column name/label.
bool $reset Reset relationship types if true.
bool $isActive Filter by is_active. NULL to disable.

Return Value

array array reference of all relationship types.

in CRM_Core_PseudoConstant at line 1067
static array currencyCode()

Get all the ISO 4217 currency codes

so far, we use this for validation only, so there's no point of putting this into the database

Return Value

array array reference of all currency codes

in CRM_Core_PseudoConstant at line 1095
static array county(bool|int $id = FALSE)

Get all the County from database.

The static array county is returned, and if it's called the first time, the County DAO is used to get all the Counties.

Note: any database errors will be trapped by the DAO.

Parameters

bool|int $id
  • Optional id to return

Return Value

array array reference of all Counties

in CRM_Core_PseudoConstant at line 1130
static array paymentProcessor(bool $all = FALSE, bool $test = FALSE, null $additionalCond = NULL) deprecated

deprecated Please use the buildOptions() method in the appropriate BAO object. Get all active payment processors The static array paymentProcessor is returned

Parameters

bool $all Get payment processors - default is to get only active ones.
bool $test Get test payment processors.
null $additionalCond

Return Value

array array of all payment processors

in CRM_Core_PseudoConstant at line 1165
static array paymentProcessorType(bool $all = FALSE, int $id = NULL, string $return = 'title') deprecated

deprecated Please use the buildOptions() method in the appropriate BAO object. The static array paymentProcessorType is returned

Parameters

bool $all Get payment processors - default is to get only active ones.
int $id
string $return

Return Value

array array of all payment processor types

in CRM_Core_PseudoConstant at line 1185
static array worldRegion(bool $id = FALSE)

Get all the World Regions from Database.

Parameters

bool $id

Return Value

array array reference of all World Regions

in CRM_Core_PseudoConstant at line 1215
static array activityStatus(string $column = 'label') deprecated

deprecated Please use the buildOptions() method in the appropriate BAO object. Get all Activity Statuses. The static array activityStatus is returned

Parameters

string $column

Return Value

array array reference of all activity statuses

in CRM_Core_PseudoConstant at line 1241
static array visibility(string $column = 'label') deprecated

deprecated Please use the buildOptions() method in the appropriate BAO object. Get all Visibility levels. The static array visibility is returned

Parameters

string $column

Return Value

array array reference of all Visibility levels.

in CRM_Core_PseudoConstant at line 1259
static array stateProvinceForCountry(int $countryID, string $field = 'name')

Parameters

int $countryID
string $field

Return Value

array

in CRM_Core_PseudoConstant at line 1313
static array countyForState(int $stateID)

Parameters

int $stateID

Return Value

array

in CRM_Core_PseudoConstant at line 1375
static int|null countryIDForStateID(int $stateID)

Given a state ID return the country ID, this allows us to populate forms and values for downstream code

Parameters

int $stateID

Return Value

int|null the country id that the state belongs to

in CRM_Core_PseudoConstant at line 1404
static array greeting($filter, string $columnName = 'label')

Get all types of Greetings.

The static array of greeting is returned

Parameters

$filter Get All Email Greetings - default is to get only active ones.
string $columnName

Return Value

array array reference of all greetings.

in CRM_Core_PseudoConstant at line 1455
static array getExtensions()

Get all extensions.

The static array extensions

FIXME: This is called by civix but not by any core code. We should provide an API call which civix can use instead.

Return Value

array array($fullyQualifiedName => $label) list of extensions

in CRM_Core_PseudoConstant at line 1491
static array accountOptionValues(bool $optionGroupName, int $id = NULL, null $condition = NULL)

Get all options values.

The static array option values is returned

Parameters

bool $optionGroupName Get All Option Group values- default is to get only active ones.
int $id
null $condition

Return Value

array array reference of all Option Group Name

in CRM_Core_PseudoConstant at line 1512
static array getModuleExtensions(bool $fresh = FALSE)

Fetch the list of active extensions of type 'module'

Parameters

bool $fresh Whether to forcibly reload extensions list from canonical store.

Return Value

array array(array('prefix' => $, 'file' => $))

in CRM_Core_PseudoConstant at line 1524
static array getTaxRates()

Get all tax rates.

The static array tax rates is returned

Return Value

array array list of tax rates with the financial type

in CRM_Core_PseudoConstant at line 1568
static array emailOnHoldOptions()

Get participant status class options.

Return Value

array

at line 110
static array financialType(int $id = NULL, bool $includeDisabled = FALSE) deprecated

deprecated . Please use the buildOptions() method in the appropriate BAO object. Get all the financial types

Parameters

int $id
bool $includeDisabled

Return Value

array array reference of all financial types if any

at line 148
static array financialAccount(int $id = NULL, int $financialAccountTypeId = NULL, string $retrieveColumn = 'name', string $key = 'id') deprecated

deprecated . Please use the buildOptions() method in the appropriate BAO object. TODO: buildOptions() doesn't replace this as it doesn't support filtering, which is used with this function. Get all/filtered array of the financial Accounts

Parameters

int $id
int $financialAccountTypeId Optional filer to return only financial accounts of type
string $retrieveColumn
string $key

Return Value

array array reference of all financial accounts if any

at line 201
static array contributionPage(int $id = NULL, bool $all = FALSE) deprecated

deprecated . Please use the buildOptions() method in the appropriate BAO object. Get all the contribution pages

Parameters

int $id Id of the contribution page.
bool $all Do we want all pages or only active pages.

Return Value

array array reference of all contribution pages if any

at line 233
static array paymentInstrument(string $columnName = 'label') deprecated

deprecated . Please use the buildOptions() method in the appropriate BAO object. Get all the payment instruments

Parameters

string $columnName

Return Value

array array reference of all payment instruments if any

at line 250
static array creditCard()

Get all the valid accepted credit cards.

Return Value

array array reference of all payment instruments if any

at line 262
static array products(int $pageID = NULL)

Get all premiums.

Parameters

int $pageID

Return Value

array array of all Premiums if any

at line 310
static array contributionStatus(int $id = NULL, string $columnName = 'label')

Get all the contribution statuses.

Parameters

int $id
string $columnName

Return Value

array array reference of all contribution statuses

at line 335
static array pcPage(null $pageType = NULL, int $id = NULL)

Get all the Personal campaign pages.

Parameters

null $pageType
int $id

Return Value

array array reference of all pcp if any

at line 366
static array pcpStatus(string $column = 'label')

Get all PCP Statuses.

The static array pcpStatus is returned

Parameters

string $column

Return Value

array array reference of all PCP activity statuses

at line 392
static int getRelationalFinancialAccount(int $entityId, string $accountRelationType, string $entityTable = 'civicrm_financial_type', string $returnField = 'financial_account_id') deprecated

deprecated use the alternative with caching CRM_Financial_BAO_FinancialAccount::getFinancialAccountForFinancialTypeByRelationship

Get financial account for a Financial type.

Parameters

int $entityId
string $accountRelationType
string $entityTable
string $returnField

Return Value

int

at line 416
static array batch(int $id = NULL)

Get all batches.

Parameters

int $id

Return Value

array array reference of all batches if any