⬇️ Install package: OMP 3.5 · OMP 3.4 — or browse all Releases.

Registers monograph and chapter DOIs with Crossref and exports the corresponding Crossref book deposit XML (schema 5.3.1).

OMP 3.4/3.5 ships the core DOI framework but — unlike OJS — does not ship a Crossref registration-agency plugin, so a press can assign DOIs and has no way to deposit them.

This plugin fills that gap. It plugs into the native DOI framework (IDoiRegistrationAgency), so DOIs are assigned and managed from Settings → Distribution → DOIs and deposited from the DOIs management page, exactly like in OJS.

Based on PKP's OJS Crossref plugin by Bozana Bokan, Juan Pablo Alperin and James MacGregor (© Simon Fraser University / John Willinsky, MIT License), adapted to the OMP DOI framework and maintained by OJSBR. See the Credits & authorship section below.

Tested on OMP 3.5.0.5 and 3.4.0.10. The DOI registration-agency framework is shared by pkp-lib and has the same contract in OMP 3.4 and 3.5, so both branches share the same implementation.

Upgrade from 1.0.0.5 (1.0.0.4 on OMP 3.4). A contributor name made only of blanks in the deposit locale produced an empty <surname> and Crossref refused the whole deposit; long names could be cut in the middle of a character; every batch timestamp ended in 000, so two deposits of the same DOI within a second carried the same record version; and five labels and messages borrowed from OJS showed as ##key## in OMP (the password field, the missing-requirements notice and the deposit results). All fixed in 1.0.0.6.

• OMP 3.5.x
• A Crossref member account (DOI prefix) and deposit credentials (username/password)

• Monograph (the publication) → Crossref <book book_type="monograph">; for an edited volume the book is deposited as <book book_type="edited_book"> and only the contributors flagged as volume editor are listed at book level, with contributor_role="editor" (chapter authors stay in their chapters)
• Chapter → Crossref <content_item component_type="chapter">

1. Install via Settings → Website → Plugins → Upload A New Plugin, uploading the crossref.tar.gz package; or extract it into plugins/generic/ so you get plugins/generic/crossref/.
2. Enable Crossref Manager Plugin under the Generic plugins list.

1. Go to Settings → Distribution → DOIs. Enable DOIs, set your DOI prefix and choose which content types get DOIs (Monographs and/or Chapters).
2. Select Crossref as the Registration Agency and fill in depositor name/email and your Crossref username/password. Keep Test mode on to validate against test.crossref.org; turn it off for production deposits to doi.crossref.org.
3. Make sure a Publisher is set under Settings → Press (Crossref requires it).

From the DOIs management page, assign DOIs to published monographs/chapters and use Deposit (or Export to download the XML). Deposit status and the Crossref response are shown per item.

• Deposit resource URLs point at the OMP catalog: .../catalog/book/{id} for monographs and .../catalog/book/{id}/chapter/{chapterId} for chapters.
• ISBNs are taken from the monograph's publication formats (ONIX ISBN-13/ISBN-10); a <noisbn reason="monograph"/> is emitted when none are present.
• Metadata is exported in the publication's own locale.
• ORCID iDs: the Crossref schema only accepts https://orcid.org/…. An iD that does not match it is left out of the deposit instead of failing the whole export. ORCID Sandbox iDs (https://sandbox.orcid.org/…, stored when the ORCID integration runs against the sandbox API) are rewritten to the production host while the plugin is in test mode, so the Sandbox → OMP → Crossref workflow can be tested, and are dropped in production, so a sandbox iD is never deposited against a live DOI. The authenticated attribute follows whether the contributor's ORCID was actually verified.
• Names: blanks around a name are removed; a contributor with no name in the deposit locale takes the first locale that has one; a given name alone becomes the surname; names are cut to Crossref's 60 characters without breaking a character.
• Book title: deposited as the press entered it, prefix included ("Le", "The"…), and as plain text (italics and other markup of the title and subtitle are removed, not escaped). Until 1.0.0.7 the prefix was left out, so a re-deposit did not match the title Crossref already had for the ISBN and was refused (#2).

• PHPUnit (tests/*Test.php, on PKP\tests\PKPTestCase): the plugin classes against the installed PKP, the plugin found by PKP's plugin registry, the contributors node (blank names, fallback locale, UTF-8 cut, ORCID in production and test mode), the book title (prefix kept, markup sent as text, title of another locale with its own prefix), chapter pages, the batch timestamp and the 38 translations. From the OMP root:

  lib/pkp/lib/vendor/bin/phpunit --configuration lib/pkp/tests/phpunit.xml --no-coverage "$PWD/plugins/generic/crossref/tests"

• Cypress (cypress/tests/functional/CrossrefSettings.cy.js, run by pkp-github-actions on OMP on every push): enables the plugin and checks Crossref offered as the DOI registration agency, with its fields and no untranslated text; nothing else is saved.

• Verified on OMP 3.5.0.5 and 3.4.0.10: the XML of published books with chapters (DOIs set in memory, nothing deposited) validates against the Crossref schema, also as an edited volume (edited_book with the volume editor at book level) and with a surname made of a blank, which failed validation before 1.0.0.6.

Tests are kept in the repository and are not part of the release package.

• Original work: PKP's OJS Crossref export/registration plugin by Bozana Bokan, Juan Pablo Alperin and James MacGregor (© Simon Fraser University / John Willinsky, https://github.com/pkp/ojs), distributed under the MIT License, whose notice is kept in docs/LICENSE-PKP-MIT.
• Adaptation to the OMP DOI framework: maintained by OJSBR and distributed under the GNU GPL v3.

Generative AI (Claude, by Anthropic) was used to write and run tests, improve the code and bring it in line with PKP standards. Every change is reviewed and tested by OJSBR, which is responsible for the published releases.

Issues and pull requests are welcome. Please target the branch matching the OMP version you are working against. See CONTRIBUTING.md.

Distributed under the GNU GPL v3. See LICENSE and docs/COPYING; the MIT notice of the original PKP plugin is in docs/LICENSE-PKP-MIT.

Plugin Crossref para o Open Monograph Press (OMP): registra DOIs de livros (monografias) e capítulos no Crossref e exporta o XML de depósito de livro (schema 5.3.1).

O OMP 3.4/3.5 traz o framework de DOI, mas — diferente do OJS — não inclui um plugin de agência Crossref: a editora atribui DOIs e não tem como depositá-los. Este plugin preenche essa lacuna, integrando-se ao framework nativo (IDoiRegistrationAgency).

Baseado no plugin Crossref do OJS (PKP) de Bozana Bokan, Juan Pablo Alperin e James MacGregor (© Simon Fraser University / John Willinsky, licença MIT), adaptado ao framework de DOI do OMP e mantido pela OJSBR. Veja a seção Créditos e autoria abaixo.

Atualização a partir da 1.0.0.5 (1.0.0.4 no OMP 3.4). Nome de contribuidor feito só de espaços no idioma do depósito gerava <surname> vazio e o Crossref recusava o depósito inteiro; nomes longos podiam ser cortados no meio de um caractere; o timestamp do lote sempre terminava em 000, e dois depósitos do mesmo DOI no mesmo segundo levavam a mesma versão; e cinco textos emprestados do OJS apareciam como ##chave## no OMP (campo de senha, aviso de requisitos e resultados do depósito). Tudo corrigido na 1.0.0.6.

• Monografia (a publicação) → <book book_type="monograph">; em obra organizada (volume editado) o livro sai como <book book_type="edited_book"> e só os contribuidores marcados como editor de volume entram no nível do livro, com contributor_role="editor" (os autores ficam nos seus capítulos)
• Capítulo → <content_item component_type="chapter">

1. Instale em Configurações → Website → Plugins → Enviar um novo plugin (pacote crossref.tar.gz) ou extraia em plugins/generic/ (ficando plugins/generic/crossref/) e ative o Crossref Manager Plugin.
2. Em Configurações → Distribuição → DOIs, habilite DOIs, defina o prefixo, escolha os tipos de conteúdo, selecione Crossref como agência e preencha depositante e usuário/senha do Crossref. Mantenha o modo de teste para validar em test.crossref.org; desative para produção em doi.crossref.org.
3. Garanta um Editor (Publisher) em Configurações → Editora, exigido pelo Crossref.

• ORCID: o schema do Crossref só aceita https://orcid.org/…. Um iD fora desse padrão é omitido do depósito em vez de derrubar o export inteiro. iDs do Sandbox do ORCID (https://sandbox.orcid.org/…, gravados quando a integração ORCID aponta para a API de sandbox) são reescritos para o host de produção enquanto o plugin está em modo de teste, para permitir testar o fluxo Sandbox → OMP → Crossref, e são omitidos em produção, para que um iD de sandbox nunca seja depositado contra um DOI real. O atributo authenticated acompanha se o ORCID do contribuidor foi de fato autenticado.
• Nomes: espaços em volta do nome são removidos; contribuidor sem nome no idioma do depósito usa o primeiro idioma que tiver; só prenome vira sobrenome; nomes são cortados nos 60 caracteres do Crossref sem quebrar caractere.
• Título do livro: depositado como a editora cadastrou, com o prefixo ("Le", "The", "Os"…), e como texto simples (itálico e outras marcações do título e do subtítulo são removidos, não escapados). Até a 1.0.0.7 o prefixo ficava de fora, e o redepósito não batia com o título que o Crossref já tinha para o ISBN e era recusado (#2).

PHPUnit em tests/: classes do plugin contra o PKP instalado, nó de contribuidores (nomes em branco, idioma de recuo, corte UTF-8, ORCID em produção e em teste), título do livro (prefixo mantido, marcação enviada como texto, título de outro idioma com o próprio prefixo), páginas do capítulo, timestamp do lote e as 38 traduções. Verificado no OMP 3.5.0.5: o XML de três livros publicados com 4 e 5 capítulos (DOIs só em memória, nada depositado) valida contra o schema do Crossref, também como obra organizada e com sobrenome feito de um espaço, que reprovava antes da 1.0.0.6. Spec Cypress em cypress/tests/functional/: Crossref oferecido como agência de registro de DOI, com os campos e nenhum texto sem tradução (nada é salvo); reprova com as traduções da 1.0.0.5. Tudo verificado também no OMP 3.4.0.10.

A suíte roda sobre PKP\tests\PKPTestCase, também confere que o registro de plugins encontra o plugin, e o Cypress roda no pkp-github-actions no OMP a cada push. Os testes ficam no repositório e não fazem parte do pacote da release.

• Trabalho original: plugin Crossref do OJS (PKP) de Bozana Bokan, Juan Pablo Alperin e James MacGregor (© Simon Fraser University / John Willinsky, https://github.com/pkp/ojs), distribuído sob a licença MIT, cujo aviso está em docs/LICENSE-PKP-MIT.
• Adaptação ao framework de DOI do OMP: mantida pela OJSBR e distribuída sob a GNU GPL v3.

Foi usada IA generativa (Claude, da Anthropic) para escrever e rodar testes, melhorar o código e alinhá-lo aos padrões da PKP. Toda mudança é revisada e testada pela OJSBR, que responde pelas releases publicadas.

Distribuído sob a GNU GPL v3. Veja LICENSE e docs/COPYING; o aviso MIT do plugin original da PKP está em docs/LICENSE-PKP-MIT.