Overview
The Links item in the Person Entry list controls the addition of the filtered links in the Person Entry. When a person passes the filter associated with a link, the link is added to the Person Entry.
Properties
Title
Enter the text that you want to appear as the label for the list of links produced by this item. The title will not appear if the subject does not pass the filters for any of the Links.
Singular or Plural Title
The Links item may produce zero, one, or more items in a list. If you want to use a singular title when the list has one item, and a plural title when the list has more than one item, add both titles to the Title property and separate the singular title from the plural title with the || characters. For example, Link||Links.
Enabled
See Enabled in the Common Properties section of the User Items help page.
Links
Add one or more Link Items to the Links list.
For example, if you add three Link Items to the list, GedSite will add up to three links to each person entry. If someone passes the filters for all three Link Items, that person will have three links in their person entry.
List Type
The List Type pull-down menu determines the format of the list of links. The choices are:
| Value | Example Output |
|---|---|
| Comma Separated | Link 1, Link 2 |
| Row Separated | Link 1 Link 2 |
| Semicolon Separated | Link 1; Link 2 |
New Container
Please see New Container in the Details section.
Link Item
Each Link Item describes an HTML link that may be added to the Person Entry if the current subject passes its Person Filter.
Properties
Title
The Title property defines the text of the link. It also identifies the item in the Links list.
Enabled
See Enabled in the Common Properties section of the User Items help page.
URL
The URL property identifies the destination for the link.
The URL may be an absolute URL. If so, include a full link including the HTTP or HTTPS protocol, the domain name, etc.
The URL may also be a relative URL. If so, the URL will usually follow this format:
../folder/filename.htm
Substitute the actual folder name for folder and the name of the file for "filename". For User Item pages, the folder name should be "up" (user pages).
Person Filter
Specify a filter using the Person Filter property. GedSite will only add the Link for people who pass the filter.
Details
New Container
When New Container is checked, the output of this item will be placed in a new container. When New Container is unchecked, which is the default, the output of this item may be added to an existing container if the output of a previous Person Entry Item uses the same container type as this item.
- If you want to merge the output of the Links item with a previous Person Entry Item, leave New Container unchecked.
- If you want the Links item to close the prior container and open a new container, add a checkmark to New Container.
Details
When a Person Entry Item creates content of the same type as the previous content, the new content is added to the same container as the previous content.
For example, when using a grid-type Format, the Person References and Links items both create a row with two columns in a table. The table is the container. If the output of the Links item follows immediately after the output of the Person References item, the output of the Links item will be added to the same table that contains the Person References content.
If you prefer that the Links item starts a new container, add a checkmark to the New Container property. Typically, creating a new container will add vertical space between the prior output and the current output.
See: New Container Item
CSS and User Styles
Person Entry items that produce lists include a CSS class name for each each row in the output of the item. This makes it possible to apply User Styles to the output of those items.
The class name for Links items is "pe-item-links".