Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Islandora-Labs/islandora_social_metatags
Adds HTML meta tags to Islandora objects via MODS XPaths to enable Twitter and Facebook image previews.
https://github.com/Islandora-Labs/islandora_social_metatags
Last synced: 3 months ago
JSON representation
Adds HTML meta tags to Islandora objects via MODS XPaths to enable Twitter and Facebook image previews.
- Host: GitHub
- URL: https://github.com/Islandora-Labs/islandora_social_metatags
- Owner: Islandora-Labs
- Created: 2016-08-29T22:18:43.000Z (about 8 years ago)
- Default Branch: main
- Last Pushed: 2021-03-01T15:59:07.000Z (over 3 years ago)
- Last Synced: 2024-04-10T01:40:51.800Z (7 months ago)
- Language: PHP
- Homepage:
- Size: 40 KB
- Stars: 4
- Watchers: 4
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- islandora_awesome - Islandora Social Metatags - Adds HTML meta tags to Islandora objects via MODS XPaths to enable Twitter and Facebook image previews. No theme hacking required. (The Islandora 7.x-1.x List / Utility Modules)
README
# Islandora Social Metatags
Add social media sharing meta tags without hacking the theme. Enables Twitter Cards and Facebook previews, generating attractive images with descriptions when someone links to your objects.
## Introduction
Islandora Social Metatags adds Twitter- and Facebook-recognized meta tags to the HTML headers on Islandora objects based on MODS metadata. This makes your objects more attractive when they're linked to on social media.
**Before:**
**After:**
## Requirements
This module requires the following modules/libraries:
* [Islandora](https://github.com/islandora/islandora)
* [Tuque](https://github.com/islandora/tuque)
* Objects must have a MODS datastream
## Installation
Install as usual, see [this](https://drupal.org/documentation/install/modules-themes/modules-7) for further information.
## Configuration
Configuration path is admin/islandora/tools/twitter_cards (Administration > Islandora > Islandora Utility Modules > Islandora Twitter Cards Configuration).
There are ten fields to configure. Defaults should work for most sites, except for Site Twitter User.
* Title XPath
* The XPath to your MODS Title field. Feeds the twitter:title meta tag.
* Default should work for most sites.
* Abstract XPath
* The XPath to the MODS Abstract field. Feeds the twitter:description meta tag.
* Default should work for most sites.
* Site Twitter User
* Your site's Twitter handle, or your site administrator's twitter handle.
* Required.
## Activation and Testing
Once the module is installed, enabled, and configure, test your objects at the [Twitter Cards Validator](https://cards-dev.twitter.com/validator). Successfully testing a tweet gets your site whitelisted for the cards.
## Limitations
Currently configured to work on five content models: Basic Image, Large Image, Citation, Thesis, and Video.
The twitter:image tag is populated with a datastream view URL which depends on the content model.
## Troubleshooting/Issues
Having problems or solved a problem? Check out the Islandora google groups for a solution.
* [Islandora Group](https://groups.google.com/forum/?hl=en&fromgroups#!forum/islandora)
* [Islandora Dev Group](https://groups.google.com/forum/?hl=en&fromgroups#!forum/islandora-dev)
## Maintainers
Current maintainers:
* [Brandon Weigel](https://github.com/bondjimbond)
## Development
If you would like to contribute to this module, please check out [CONTRIBUTING.md](CONTRIBUTING.md). In addition, we have helpful [Documentation for Developers](https://github.com/Islandora/islandora/wiki#wiki-documentation-for-developers) info, as well as our [Developers](http://islandora.ca/developers) section on the [Islandora.ca](http://islandora.ca) site.
## License
[GPLv3](http://www.gnu.org/licenses/gpl-3.0.txt)