WordPress defines shortcodes as “macro codes for use in post content“. Shortcodes are at the heart of rootsPersona.
Each rootsPersona shortcode results in the dynamic rendering of the persona pages, as well as many of the utility pages the plugin provides. Read the summary of shortcodes below.
rootsPersona/
This shortcode results in the rendering of a single persona page. The Add Person page inserts a new page with this shortcode for each person selected. You can also use this shortcode to add a persona to a page or post.
This shortcode expects at least one attribute: the personId of the person to be displayed. It also has attributes for up to 7 images, and 6 of those images can have captions. Here is an example of the rootspersona shortcode:
rootsPersona personId=’i407′ picFile1=’http://thompson-hayward-snypes-moore.net/wp-content/uploads/Image1-13.jpg’ picFile2=’http://thompson-hayward-snypes-moore.net/wp-content/uploads/Image1-15.jpg’ picCap2=’Four Generations’/
The rest of the shortcodes allow for display of single panels of the persona page, and can be used in pages or posts. They can also be combined in any order, or used to display multiple persons in a single post or page. When displaying panels based on these shortcodes, no title banner will be displayed for the panel.
rootsPersonaHeader/
Want to display just the Header panel for a person in a post? This shortcode will do it. It accepts the same parameters as the rootspersona shortcode, but all attributes other than personId and picFile1 are ignored.
rootsPersonaFact/
Want to display just the Fact panel for a person in a post? This shortcode will do it. It accepts the same parameters as the rootspersona shortcode, but all attributes other than personId are ignored.
rootsPersonaAncestors/
Want to display just the Ancestor panel for a person in a post? This shortcode will do it. It accepts the same parameters as the rootspersona shortcode, but all attributes other than personId are ignored.
rootsPersonaFamilyC/ and rootsPersonaFamilyS/
Want to display just the Family Group panel for a person in a post? This shortcode will do it. It accepts the same parameters as the rootspersona shortcode, but all attributes other than personId are ignored.
- rootsPersonaFamilyC displays the Family Group in which the person is a child (Child to Family Link)
- rootsPersonaFamilyS displays the Family Group in which the person is a spouse(Spouse to Family Link)
A person may be a spouse (partner) in more than one Family Group, so more than one panel may be displayed.
rootsPersonaPictures/
Want to display just the Pictures panel for a person in a post? This shortcode will do it. It accepts the same parameters as the rootspersona shortcode.
You do NOT have to define the same set of pictures in this panel as are displayed on the person’s persona page. That means it could be used to display any arrangement of 6 pictures you like, with different captions.
rootsPersonaEvidence/
Want to display just the Evidence panel for a person in a post? This shortcode will do it. It accepts the same parameters as the rootspersona shortcode, but all attributes other than personId are ignored.
rootsPersonaDescendancy/
(I know, it’s misspelled) Want to display just the Dependency Chart panel for a person in a post? This shortcode will do it. It accepts the same parameters as the rootspersona shortcode, but all attributes other than personId are ignored.
rootsPersonaIndex/
Display an index of persona pages with a link.
rootsPersonaEvidenceIndex/
Display an index of evidence pages (source documents) with a link.