WP Manifestindependent plugin directory
manifest / content / wp_curatescape

Curatescape for WordPress

Curatescape for WordPress. Publish location-based, media-rich, structured narratives compatible with Curatescape mobile apps. Designed for public historians, urbanists, and other humanities researchers. Adds Tour and Story post types, as well as custom taxonomies and metadata fields. Developed with NEH support for Curating Kisumu (macleki.org).

by CSU Center for Public History + Digital Humanities · github.com/cphdh/wp_curatescape · website

2stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/cphdh/wp_curatescape/archive/refs/heads/master.zip

Curatescape

Publish location-based, media-rich, structured narratives compatible with Curatescape mobile apps. Designed for public historians, urbanists, and other humanities researchers. Adds Tour and Story post types, as well as custom taxonomies and metadata fields.

Story Shortcodes

Curatescape automatically adds custom content to each Story post. If you would like to change the order in which these components appear in a Story post or custom template, you may use the following shortcodes. Each of these accepts a no-heading attribute.

  • [curatescape_images] : custom placement of image gallery within a story
  • [curatescape_audio] : custom placement of audio playlist within a story
  • [curatescape_video] : custom placement of video playlist within a story
  • [curatescape_map] : custom placement of map within a story

Global Shortcodes

The following shortcodes may be used to place Curatescpae components in any non-Story post or page.

  • [curatescape_global_map] : adds the global map to a standalone page

Helper Functions

Curatescape attempts to add custom fields and other components to your theme automatically using WordPress plugin filters. If you have compatibility issues with your theme or would like to customize where/how content appears, you can use the helper functions below. NOTE: Be sure to turn off content filters in Curatescape plugin settings if you are customizing your theme.

General

  • curatescape_setting($option)
  • curatescape_parse_markdown($string,$singleline=true)

Stories

  • curatescape_display_media_section($post, $includeImages=true, $includeAudio=true, $includeVideo=true)
  • curatescape_get_story_media($post)
  • curatescape_story_map($post,$includeHeading=true)
  • curatescape_street_address($post)
  • curatescape_access_information($post)
  • curatescape_official_website($post)
  • curatescape_subtitle($post)
  • curatescape_lede($post)
  • curatescape_related_sources($post)

The following functions require an array of files, which can be obtained using the curatescape_get_story_media() function:

$media = curatescape_get_story_media($post);
$images = $media['images'];
$audio = $media['audio'];
$video = $media['video'];
  • curatescape_image_gallery($images,$containerTag='section',$includeHeading=true)
  • curatescape_audio_playlist($audio,$containerTag='section',$includeHeading=true)
  • curatescape_video_playlist($video,$containerTag='section',$includeHeading=true)

Alternately, you may use curatescape_display_media_section() to display all media components at once. See above.

Tours

  • curatescape_tour_map($post)
  • curatescape_stories_for_tour($post)

Global

  • curatescape_global_map()