PID Manager Plugin

PID Manager for OJS

• PID Manager Manager Plugin
• Features
  • IGSN
• Screenshot(s) / screen recording(s)
• Install and configure the plugin
  • Requirements
  • Install with Git
  • Install via direct download
  • Configuration of the plugin
• Development
  • Structure
  • Notes
  • Debugging
  • Tests
• Data Models
  • Metadata of OJS models
• Contribute
  • How to contribute
• License

Features

IGSN

• Manual adding sample PIDs and labels
• Allows suggesting PIDs and Labels from DataCite
• Marks samples already added with text strike through

Screenshot(s) / screen recording(s)

Install and configure the plugin

Requirements

• PHP 8.0+

Install with Git

Get the correct version for your OJS version:

• branch main: development version, don't use for production
• branch stable-3_4_0: use this version for OJS version 3.4.0.x
• branch stable-3_5_0: use this version for OJS version 3.5.0.x

Install via direct download

• Download release for your OJS version from here. Note the correct version for you OJS version.
• Alternatively, download the code with the option 'Download ZIP'. Note the correct branch for your OJS version.
• Extract the downloaded file to /plugins/generic/pidManager.

Configuration of the plugin

• Login in your OJS instance as an Administrator or Manager
• Navigate to Website > Plugins > Installed Plugins > Generic Plugins > PID Manager Plugin
• Activate the plugin by clicking the checkbox

Development

Structure

.
├─ assets                        # Styles, images, javascript files
├─ Classes                       # Main folder with models / logic
│  ├─ Helpers                    # Helper classes
│  └─ Igsn                       # Classes for IGSN
├─ docs                          # Documentation, examples
├─ locale                        # Language files
├─ templates                     # Templates folder
├─ tests                         # Tests folder
│  ├─ Classes                    # Classes for tests
│  ├─ composer.json              # Composer configuration file for tests
│  └─ vendor                     # Composer autoload and dependencies
├─ vendor                        # Composer autoload and dependencies
├─ .gitignore                    # Git ignore file
├─ composer.json                 # Composer configuration file
├─ LICENSE                       # License file
├─ PidManagerPlugin.php          # Main class of plugin
├─ README.md                     # This file
└─ version.xml                   # Version information of the plugin

Notes

• Autoload of the classes in the folder classes/ is done with composer according to the PSR-4 specification.
• All classes have namespaces and are structured according to PSR-4 standard.
• If you add or remove classes in the classes folder, run the following command to update autoload files: composer dump-autoload -o.
• Running composer install -o or composer update -o will also generate the autoload files.
• The -o option generates the optimised files ready for production.

Debugging

There is a debug mode possibility in this plugin. This constant puts the plugin in debugging mode. Extra debug information will be written to the log file (see LogHelper class) such as API calls. Debug information is written to the log file in the files_dir directory of your OJS instance. You can find the files_dir constant in your config.inc.php file.

Please put the following in the file config.inc.php to enable this:

[PidManagerPlugin]
isDebugMode=true

Careful with sensitive information, (passwords, tokens) will be written in plain text.

Tests

Test classes

If you are developing, you might use the classes in tests/classes/. The classes in this folder have the same folder and namespace structure as in classes folder. The purpose of these classes is to override the main classes. You can accomplish this by running the composer command composer dump-autoload -o -d tests. If this is done, then test or sandbox versions of API's will be used. For example test.wikidata.org instead of www.wikidata.org. Autoload of the classes is done with composer classmap. First the classes in tests/classes/ are loaded, after which the classes in classes/ are loaded. By doing this in this order, all classes present in tests/classes/ will override the classes in classes/.

Please put the following in the file config.inc.php to enable this:

[PidManagerPlugin]
isTestMode=true

Data models

IGSN

De IGSNs are saved in the publication_settings as an array of IGSN data models.

name	description
doi	Persistent identifier of the sample
label	Label of the sample

[
  { 'doi': '10.58031/kiel0188gczz101', 'label': 'Sediment core SO257_1-5' },
  { 'doi': '10.58031/kiel0188gczi201', 'label': 'Sediment core SO257_6-2' },
]

Contribute

All help is welcome: asking questions, providing documentation, testing, or even development.

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

How to contribute

• Fork the repository
• Create a feature branch in your fork
• Make your changes
• Open a PR with your changes

License

This project is published under GNU General Public License, Version 3.