. */ declare(strict_types=1); namespace Fisharebest\Webtrees\Elements; use Fisharebest\Webtrees\I18N; use function strtoupper; /** * NAME_TYPE := {Size=5:30} * [ aka | birth | immigrant | maiden | married | ] * Indicates the name type, for example the name issued or assumed as an immigrant. * aka = also known as, alias, etc. * birth = name given on birth certificate. * immigrant = name assumed at the time of immigration. * maiden = maiden name, name before first marriage. * married =name was persons previous married name. * user_defined = other text name that defines the name type. */ class NameType extends AbstractElement { public const VALUE_ADOPTED = 'ADOPTED'; public const VALUE_AKA = 'AKA'; public const VALUE_BIRTH = 'BIRTH'; public const VALUE_CHANGE = 'CHANGE'; public const VALUE_ESTATE = 'ESTATE'; public const VALUE_IMMIGRANT = 'IMMIGRANT'; public const VALUE_MAIDEN = 'MAIDEN'; public const VALUE_MARRIED = 'MARRIED'; public const VALUE_RELIGIOUS = 'RELIGIOUS'; /** * Convert a value to a canonical form. * * @param string $value * * @return string */ public function canonical(string $value): string { return strtoupper(parent::canonical($value)); } /** * A list of controlled values for this element * * @return array */ public function values(): array { return [ '' => '', /* I18N: The name given to a child by its adoptive parents */ self::VALUE_ADOPTED => I18N::translate('adopted name'), /* I18N: The name by which an individual is also known. e.g. a professional name or a stage name */ self::VALUE_AKA => I18N::translate('also known as'), /* I18N: The name given to an individual at their birth */ self::VALUE_BIRTH => I18N::translate('birth name'), /* I18N: A name chosen by an individual, to replace their existing name (whether legal or otherwise) */ self::VALUE_CHANGE => I18N::translate('change of name'), /* I18N: A name given to an individual, from the farm or estate on which they lived or worked */ self::VALUE_ESTATE => I18N::translate('estate name'), /* I18N: A name taken on immigration - e.g. migrants to the USA frequently anglicized their names */ self::VALUE_IMMIGRANT => I18N::translate('immigration name'), /* I18N: A woman’s name, before she marries (in cultures where women take their new husband’s name on marriage) */ self::VALUE_MAIDEN => I18N::translate('maiden name'), /* I18N: A name taken on marriage - usually the wife takes the husband’s surname */ self::VALUE_MARRIED => I18N::translate('married name'), /* I18N: A name taken when entering a religion or a religious order */ self::VALUE_RELIGIOUS => I18N::translate('religious name'), ]; } }