The Sharing module allows you to add buttons to site pages which visitors can use to share and embed content from your site on social media or via email. Sharing also includes Open Graph and oEmbed meta elements in the
<head> of each item page on your site, so that preview cards will display when shared on social media.
Currently, Sharing supports the following options:
- Embed codes.
Once Sharing has been installed and activated for an Omeka S install, it is available for all sites on the installation.
Sharing settings are configured on a site-by-site basis. Go to a site and click through to the Site Settings. There should be a section labelled "Sharing" with two options:
Enable Sharing module for these methods: gives a series of checkboxes, one for each service or option (Facebook, Twitter, etc.).
Sharing buttons placement on the page: sets the placement of the sharing buttons either at the top of the content (below the navigation and page header) or at the bottom (just above the footer).
Ensure that the correct boxes are checked for your site. You can uncheck all of the boxes to turn off sharing for your site. Be sure to save your changes.
The module will send Open Graph and oEmbed meta tags regardless of your site settings.
For Open Graph, this will look something like:
<meta property="og:site_name" content="My Omeka S Site">
Tags may include:
og:description, reflecting the
dcterms:descriptioncontent of any resource if applicable, or the field used for the resource description
dcterms:titleor the field used for the resource title
og:image, either the primary media or the default thumbnail based on the media type
content="website"at this time
og:url, the current page's URL.
These fields are not sent on item set or media pages. Multimedia (audio and video) will not be sent, only a thumbnail image.
oEmbed will appear as a single tag in the
<head> of every Omeka S public page, including items, media, and search and browse pages:
<link rel="alternate" type="application/json+oembed" title="[Your page's title here]">
This element will contain an
href value that reflects the oEmbed API for your site, found at
yourInstallationURLhere/oembed, and the URL of the specific page of your site, something like
Sharing icons for enabled services and options will display on pages you build, as well as individual item/show pages on your site.
By default, the module will share the page title, the name of the site, and the name of the installation.