Person
Module to generate people's personal information such as names and job titles.Overview
To generate a full name, use {{$person.fullName}}
. Note that this is not the same as simply concatenating {{$person.firstName}}
and {{$person.lastName}}
, as the full name may contain a prefix, suffix, or both. Additionally, different supported locales will have differing name patterns. For example, the last name may appear before the first name, or there may be a double or hyphenated first or last name.You can also generate the parts of a name separately, using {{$person.prefix}}
, {{$person.firstName}}
, {{$person.middleName}}
, {{$person.lastName}}
, and {{$person.suffix}}
. Not all locales support all of these parts.Many of the methods in this module can optionally choose either female, male or mixed names.Job-related data is also available. To generate a job title, use {{$person.jobTitle}}
.This module can also generate other personal information which might appear in user profiles, such as {{$person.gender}}
, {{$person.zodiacSign}}
, and {{$person.bio}}
.Related modules
For personal contact information like phone numbers and email addresses, see the Phone and Internet modules.
bio#
Returns a random short biography
firstName#
Returns a random first name.Name | Type | Default | Description |
---|
sex | 'female' | 'male' | | The optional sex to use. Can be either 'female' or 'male' . |
fullName#
Generates a random full name.Name | Type | Default | Description |
---|
firstName | string | {{$person.firstName}} | The optional first name to use. If not specified a random one will be chosen. |
lastName | string | {{$person.lastName}} | The optional last name to use. If not specified a random one will be chosen. |
sex | 'female' | 'male' | {{$helpers.arrayElement(['female','male'])}} | The optional sex to use. Can be either 'female' or 'male' . |
gender#
jobArea#
Generates a random job area.
jobDescriptor#
Generates a random job descriptor.
jobTitle#
Generates a random job title.
lastName#
Returns a random last name.Name | Type | Default | Description |
---|
sex | 'female' | 'male' | | The optional sex to use. Can be either 'female' or 'male' . |
middleName#
Returns a random middle name.Name | Type | Default | Description |
---|
sex | 'female' | 'male' | | The optional sex to use. Can be either 'female' or 'male' . |
prefix#
Returns a random person prefix.Name | Type | Default | Description |
---|
sex | 'female' | 'male' | | The optional sex to use. Can be either 'female' or 'male' . |
sex#
Output of this method is localised, so it should not be used to fill the parameter sex
available in some other modules for example {{$person.firstName}}
.
sexType#
Returns a random sex type. The SexType
is intended to be used in parameters and conditions.Returns: 'female' | 'male'
suffix#
Returns a random person suffix.
zodiacSign#
Returns a random zodiac sign.
Modified atΒ 2024-09-02 05:16:37