Shortcodes

4. Advanced shortcodes

gn:contact

The contact shortcode provides a fancy presentation for a point of contact which is marked up for easy detection and readability by both humans and search engines.

Many properties are automatically broken into several parts in the event that the property value contains a semicolon or comma. As in general english usage, the semicolon functions as a "super comma" and takes precedence over commas if one is present.

Contact parameters are subjected to a language merge before rendering. As such it is possible to define a contact having language-specific property overrides by appending an @ followed by the appropriate IETF language tag. This behavior is generally only useful in the event that a contact is embedded in a snippet, and as such can appear on pages in multiple languages.

The following contact properties and equivalent aliases are supported; note that certain properties only apply to specific contact types:

• cell, cellular, cellphone
• email, e-mail
• fax, facsimile
• hours
• community, city, hamlet, locality, town, municipality
• name
• org, organization, employer
• pmb (private mailbox)
• phone, telephone, tel
• pobox, postofficebox
• postalcode, postal, postcode, zip, zipcode
• region, province, territory, state, as a two-letter region code mapping to a configured region definition
• street, address
• title, position
• type
• url, homepage, website

The type property is required, and determines the schema.org type of the resulting contact which is reported to search engines. This is particularly important with regards to the relationship established between the contact and the organizations identified by the org property. The following contact types are supported:

Note that the *-org contact types are used to represent both organizations, and organizational units. In the case of an organizational unit, parent organizations are specified using the org property as a comma or semicolon-separated list.

gn:elasticsearch

The elasticsearch shortcode generates a search interface backed by requests to an Elasticsearch service. This allows us to create a search interface which greatly simplifies the submission of searches restricted to a specific directory or filetype.

gn:features

The features shortcode is used to present a set of features in boxes as commonly seen on commercial product pages.

The image and link feature properties are templated values with content_url, home_url, site_url, and theme_url provided.

gn:library

The library shortcode displays an interactive, recursive directory listing of a target directory within the library root - /en/files/ for English pages and /fr/fichiers/ in French. This directory is a mapping of folders accessible to you via network share.

The library shortcode's supports extensive and complex configuration options using inident syntax; however in most instances it suffices to point it at a folder using the default settings. If you want to explore advanced configuration options, you will need to consult the wp-justice plugin documentation.