Download the PHP package mesh-research/orcid-data-block-2 without Composer

Linked Open Profiles

This is a WordPress plugin for displaying public data from multiple ORCID records on pages, posts, and sites. It's a successor to ORCID Data Block.

This plugin is developed and maintained by Mesh Research Lab.

This work is funded by the ORCID Global Participation Fund.

Features

• Provides a Gutenberg block in the WordPress block editor that allows users to
  • specify which sections are shown from specified ORCID records
  • specify which items are shown within sections
• Allows different ORCID records to be used in multiple blocks on the same post/page/site
• Info will remain automatically up-to-date with ORCID
• All languages currently supported by ORCID will be supported (in progress)
• Accessible to those with disabilities

Information Supported

The following details information that’s available within the plugin according to each section’s item type. Each detail is listed in the order as it appears under each item. If any of this information is not supplied for an item in ORCID, it will not appear for that item in the plugin.

Biography

• Name
  • Given Names
  • Family Name
  • Credit Name
  • Other Names
• Biographical Information
• Websites & social links

Distinction

• Role Title
• Organization Name
• Department Name
• Organization Address
  • City
  • Region
  • Country
• Dates
  • Start Date
  • End Date

Education

• School or Organization Name
• Degree
• School or Organization Address
  • City
  • Region
  • Country
• Dates
  • Start Date
  • End Date

Employment

• Role Title
• Organization Name
• Department Name
• Organization Address
  • City
  • Region
  • Country
• Dates
  • Start Date
  • End Date

Funding

• Title
• Organization Name
• Type
• Dates
  • Start Date
  • End Date
• Digital Object Identifier (DOI)

Invited Positions

• Role Title
• Organization Name
• Department Name
• Organization Address
  • City
  • Region
  • Country
• Dates
  • Start Date
  • End Date

Memberships

• Role Title
• Organization Name
• Department Name
• Organization Address
  • City
  • Region
  • Country
• Dates
  • Start Date
  • End Date

Peer Reviews

• Organization Name
• Role Title
• Department Name
• Review Location Address
  • City
  • Region
  • Country
• Digital Object Identifier (DOI)
• Uniform Resource Locator (URL)
• International Standard Serial Number (ISSN)
• Review Source
• Completion Date

Qualifications

• Role Title
• Organization Name
• Department Name
• Organization Address
  • City
  • Region
  • Country
• Digital Object Identifier (DOI)
• Dates
  • Start Date
  • End Date

Service

• Organization Name
• Role Title
• Digital Object Identifier (DOI)
• Organization Address
  • City
  • Region
  • Country
• Dates
  • Start Date
  • End Date

Work

• Work Title
• Work Subtitle
• Journal Title
• Work Type
• Publication Date
• Digital Object Identifier (DOI)

Installation

1. Visit this plugin's Releases page on GitHub:
2. Download the zip file of the latest stable release.
3. Visit the admin area of your WordPress installation.
4. On the Plugins screen, click the "Add New Plugin" button.
5. Click the "Upload Plugin" button.
6. Choose the zip file that was previously downloaded.
7. Click the "Install Now" button.

Usage

1. Make sure the plugin is activated on your WordPress installation.
   • This can be done on the Plugins screen.
2. In a Gutenberg block editor, add a new block.
   • There are multiple ways to add blocks.
3. Search "Linked Open Profiles" in the block browser and select it.
4. With the new block selected, provide an ORCID iD in the ORCID iD text input.
   • This text input can be found in the sidebar (also known as the inspector controls).
   • An ORCID iD can be found on a user's ORCID record page.
5. Click the "Apply" button.
6. Make customizations as you see fit.
   • Customize which sections are shown.
   • Customize which items within sections are shown.
7. Save as a draft or publish.

Functionality

This WordPress plugin uses the third party public REST API on https://orcid.org to query publicly available information for any ORCID record hosted on https://orcid.org and display this on a WordPress page, post, or site. Only publicly available data is retrieved from ORCID. You may provide multiple, different ORCID iDs for use with multiple, different blocks of this plugin within a Gutenberg editor. Registration and authentication with ORCID are not necessary to do this. The only necessity is to provide a valid 16-digit ORCID iD.

Disclosure of Data Sent

• What: ORCID iDs users provide
• Where: https://orcid.org
• Why: to query the public data of an ORCID record users wish to use with this plugin
• Under What Circumstances:
  • whenever a user provides an ORCID iD to a block instance of this plugin
  • whenever a post, page, or site that includes a block instance of this plugin is loaded

User-provided ORCID iDs are sent to the public third party REST API on https://orcid.org. This plugin uses the REST API located at https://orcid.org/####-####-####-####. It is necessary to provide an ORCID iD to identify an ORCID record you wish to use when displaying ORCID record information on a WordPress post, page, or site.

• ORCID Privacy Policy
• ORCID Terms of Use

Guide to Contributions

Prerequisites

• Node Package Manager (npm)
• A WordPress installation
  • A Docker-managed installation is recommended

Running Locally

1. Clone this repository into the plugins directory of your WordPress installation.
2. In a command-line, navigate to the directory of this plugin.
3. Install dependencies with npm i.
4. Create the build directory and files with npm run build.

Contributing

1. Fork a new branch from the main branch.
2. Make changes to your forked branch.
3. Submit changes by opening a pull request on the Pull requests page:
   • https://github.com/MESH-Research/linked-open-profiles/pulls
4. Include a description of your changes in the pull request comment.

Code of Conduct

Our Pledge

In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation.

Our Standards

Examples of behavior that contributes to creating a positive environment include:

• Using welcoming and inclusive language Being respectful of differing
• viewpoints and experiences Gracefully accepting constructive criticism
• Focusing on what is best for the community Showing empathy towards other
• community members

Examples of unacceptable behavior by participants include:

• The use of sexualized language or imagery and unwelcome sexual attention or advances
• Trolling, insulting/derogatory comments, and personal or political attacks
• Public or private harassment Publishing others' private information, such as
• a physical or electronic address, without explicit permission
• Other conduct which could reasonably be considered inappropriate in a professional setting

Our Responsibilities

Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior.

Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful.

Scope

This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers.

Enforcement

Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at [email protected]. All complaints will be reviewed and investigated and will result in a response that is deemed necessary and appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.

Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership.

Attribution

This Code of Conduct is adapted from the Contributor Covenant, version 1.4, available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html

For answers to common questions about this code of conduct, see https://www.contributor-covenant.org/faq