discoverygarden/islandora_google_scholar

v1.2.0 2024-04-19 15:56 UTC

Requires

• drupal/metatag: ^2.0
• drupal/metatag_google_scholar: ^1.1
• islandora/islandora: ^2

Requires (Dev)

• drupal/test_support: ^1

GPL-3.0-or-later

README

Introduction

Metatag additions and modifications for Institutional Repository content to provide Google Scholar metatags, as well as a 'first attached PDF' metatag as the PDF URL.

Table of Contents

• Features
• Requirements
• Installation
• Configuration
• Usage
• Troubleshooting/Issues
• Maintainers and Sponsors
• Development/Contribution
• License

Features

• Add the url of the first attached PDF as citation_pdf_url metatag.
• Alter metatags based on the value of a referenced taxonomy term.
• Provides an altmetrics block (Experimental feature. Still under active development.)

Requirements

This module requires the following modules/libraries:

• Islandora
• Metatag
• Metatag Google Scholar

Installation

Install as usual, see this for further information.

Configuration

• Instructions on configuring google scholar metatags can be found here

Usage

Islandora Google Scholar provides two capabilities to display metatags for research output nodes based on the node's type:

Metatag Alterer

A configuration piece designed to allow metatags to be altered in or out, or changed, based on the name of the referenced taxonomy term in a configured reference field. A configuration is attached to a node bundle, and expects the following:

• entity_bundle: The bundle targeted by the configuration
• reference_field: The field on the bundle that references the 'type' to search for when making alterations
• reference_target: Where to find the value in the reference field (e.g., the 'name' of a taxonomy term)
• alterations: A list of target types to perform alterations for. Each of these target types contains a mapping of metatags to alter, and the new value to use for that metatag.

Configuration can also accept a purge_if_absent as true or false; if true, and the node's 'type' is not found in the alterations list, citation_-prefixed metatags will be removed from the resultant metatag list.

An example configuration is included in this module's config/install folder to get you started.

Islandora Google Scholar Metatag Group

The Islandora Google Scholar metatag group includes, at present, a checkbox allowing you to use the 'first attached PDF' to a node as the citation_pdf_url metatag.

Troubleshooting/Issues

Having problems or solved a problem? Contact discoverygarden.

Maintainers/Sponsors

This project has been sponsored by:

• Atlanta University Center
• Boston College
• discoverygarden

Development

If you would like to contribute to this module, please check out our helpful Documentation for Developers info, Developers section on Islandora.ca and contact discoverygarden.

License

GPLv3