Shortcodes

WordLift provides several useful shortcodes to provide enhanced visualizations on your web site.

Widget Shortcodes

WordLift widgets can be inserted in a post or page to give a rich visual presentation of the entities populating the blog. As the blog grows and entities are created and mentioned, the widgets update their content without intervention from the editor.

Chord widget:

[wl_chord width=... height=... main_color=... depth=... global=...]
_images/wordlift-shortcodes-chord.png

The Chord widget visualizes relations between entities, starting from the current post and the entities mentioned in it.

width
(optional) Width of the chord. Can be expressed in pixels or percentages (e.g. 120px or 70%).
height
(optional) Height of the chord. Can be expressed in pixels or percentages (e.g. 120px or 70%).
main_color
(optional) The chord’s base color.
depth
(optional) Maximum distance to travel in the entity graph in order to populate the chord. A small number limits the exploration of the main entity.
global
(optional) When global=true the main entity of the chord is not the current post, but the most mentioned entity in the latest posts.

Timeline widget:

[wl_timeline width=... height=... global=...]
_images/wordlift-shortcodes-timeline.png

The Timeline widget displays a navigable list of chronologically ordered Event entities. The window on top shows details of the selected Events.

width
(optional) Width of the timeline. Can be expressed in pixels or percentages (e.g. 120px or 70%).
height
(optional) Height of the timeline. Can be expressed in pixels or percentages (e.g. 120px or 70%).
global
(optional) By default the timeline displays events (or events related to places) mentioned in the current post. When global=true the timeline displays events mentioned in the latest posts.
display_images_as
(optional) When display_images_as=’background’ the timeline displays for each event the featured image of the entity as background.
excerpt_length
(optional) Allows you to set the number of words that appear in the the excerpts of the timeline.

Note

When you create a timeline with WordLift you can pass in the shortcode optional parameters to set a variety of presentation options. These are derived from the TimelineJS library read more here.

Geomap widget:

[wl_geomap width=... height=... global=...]
_images/wordlift-shortcodes-geomap.png

The Geomap widget displays “Place” entities on a map. Each Place has its own marker with a popup containing a thumbnail and links of the place.

width
(optional) Width of the geomap. Can be expressed in pixels or percentages (e.g. 120px or 70%).
height
(optional) Height of the geomap. Can be expressed in pixels or percentages (e.g. 120px or 70%).
global
(optional) By default the geomap displays places mentioned in the current post. When global=true the geomap displays all places mentioned in the blog.

Navigator widget:

[wl_navigator]

The Navigator widget offers links to semantic-related posts in the blog. The search is made by considering the entities mentioned in the current post (in the order WHO, WHAT, WHERE, WHEN) and finding other blog posts mentioning the same entities. It is useful for content discovery.

_images/wordlift-discover-navigator.png

Faceted search widget:

[wl_faceted_search]

The Faceted Search widget can be used on entity pages to display and filter the posts related to the current and other entities. It is useful for content discovery.

_images/wordlift-edit-entity-faceted-search-widget-frontend.gif

Entity cloud widget:

[wl_cloud]

The WordLift Entities Cloud Widget is also available as a shortcode. The widget displays entities related to the current post/entity in a tag cloud.

_images/wordlift-entities-cloud-widget.png