Skip to content

Repository files navigation

PKP PN (PLN) — unofficial build for OJS 3.5

OJS Version License

⬇️ Install package: OJS 3.5 — or browse all Releases.

The PKP Preservation Network (PKP PN / PLN) plugin by the Public Knowledge Project (Simon Fraser University), packaged for OJS 3.5 with its vendor/ directory included.

⚠️ Unofficial build — all credit belongs to PKP / Simon Fraser University and the authors of the pkp/pln plugin. OJSBR only packages it while PKP has not published an OJS 3.5 release in the Plugin Gallery. When the official release is available, use it.

✅ The official release is available. PKP published pln 4.0.0.0 for OJS 3.5 in the Plugin Gallery on 2026-08-21. New installations should install it from Settings → Website → Plugins → Plugin Gallery. Installations of this build (4.0.0.3) carry the same merged code; because 4.0.0.3 is numbered above the official 4.0.0.0, the gallery will only offer an update once PKP publishes a higher version, so replacing this build with the official package is recommended. This repository receives no further releases.

Compatibility & branches

OJS version Branch Plugin release
OJS 3.5.x stable-3_5_0 (default) 4.0.0.3

Where the code comes from

  • Source: pkp/pln, branch stable-3_5_0, commit 1235a4d — the merge of pkp/pln#117 (OJS 3.5 compatibility, 2026-08-21).
  • No change to the plugin code. The package adds only what the release tarball needs:
    • vendor/, installed with composer install --no-dev from the upstream composer.lock;
    • translations for the languages the upstream plugin does not ship yet (az el eu fa hu id ja pl ro sr_Latn vi), machine-assisted and marked fuzzy where not reviewed; the upstream translations are kept exactly as published;
    • this README and the release workflow.
  • version.xml says 4.0.0.3 (upstream says 4.0.0.0) so that installations of the earlier OJSBR builds (up to 4.0.0.2) are offered this one as an update.

Upgrade from 4.0.0.2. The earlier builds came from an intermediate commit of the pull request. 4.0.0.3 carries the merged code, which adds CSRF checks, escapes template variables, fixes notification handling and deposit queries, and backfills date_modified of deposit objects. Upgrading is recommended.

Moving to the official release later. Since this build's version number is higher than PKP's 4.0.0.0, OJS will not offer the official package as an update: install it over this one through Upload A New Plugin when it is published.

Requirements

  • OJS 3.5.x, PHP 8.2+, extensions zip and curl, and an ISSN set for the journal.

Installation

  1. Install via Settings → Website → Plugins → Upload A New Plugin with the package above.
  2. Enable PKP PN Plugin and open its Settings to accept the network's terms of use.

After accepting the terms, the journal registers with the network and gets a UUID; the network must accept the journal before deposits are taken ("does not know about this journal yet" until then). Deposits are made by the scheduled task Depositor (daily).

Tests

Verified on OJS 3.5.0.3: every PHP file lints, the plugin classes load against the installed PKP with compatible return types, the install migration creates pln_deposits and pln_deposit_objects, and the settings page loads the terms from the network. No test code is added to the package, which stays identical to upstream.

Credits & authorship

  • Plugin: Public Knowledge Project / Simon Fraser University and the contributors of pkp/pln; OJS 3.5 compatibility by the authors of pkp/pln#117.
  • Packaging: OJSBR.
  • Distributed under the GNU GPL v3 — see LICENSE.

🇧🇷 Português

Plugin PKP Preservation Network (PKP PN / PLN) do Public Knowledge Project (Simon Fraser University), empacotado para o OJS 3.5 já com o diretório vendor/.

⚠️ Build não oficial — todo o crédito é da PKP / Simon Fraser University e dos autores do plugin pkp/pln. A OJSBR apenas empacota enquanto a PKP não publica a versão para OJS 3.5 na Galeria de Plugins. Quando a versão oficial sair, use a oficial.

✅ A versão oficial saiu. A PKP publicou o pln 4.0.0.0 para OJS 3.5 na Galeria de Plugins em 21/08/2026. Instalações novas devem usar a oficial em Configurações → Website → Plugins → Galeria de Plugins. Quem tem este build (4.0.0.3) está com o mesmo código já mesclado; como 4.0.0.3 é numericamente maior que o oficial 4.0.0.0, a galeria só vai oferecer atualização quando a PKP publicar uma versão maior, então o recomendado é trocar este build pelo pacote oficial. Este repositório não recebe novas releases.

Compatibilidade e branches

Versão do OJS Branch Release do plugin
OJS 3.5.x stable-3_5_0 (padrão) 4.0.0.3

Origem do código

Código de pkp/pln, branch stable-3_5_0, commit 1235a4d — o merge do PR #117 (compatibilidade com OJS 3.5, 21/08/2026). Nenhuma alteração no código do plugin. O pacote só acrescenta o vendor/ (composer, sem dependências de desenvolvimento), traduções dos idiomas que o plugin oficial ainda não tem (az el eu fa hu id ja pl ro sr_Latn vi) — as traduções oficiais ficam exatamente como publicadas —, este README e o workflow de release.

Atualização a partir da 4.0.0.2. Os builds anteriores vinham de um commit intermediário do PR. A 4.0.0.3 traz o código incorporado, com verificações de CSRF, escape das variáveis dos templates, correções de notificação e das consultas de depósito, e o preenchimento de date_modified. A atualização é recomendada.

Migrar depois para a versão oficial. Como o número desta versão é maior que o 4.0.0.0 da PKP, o OJS não oferecerá o pacote oficial como atualização: instale-o por cima deste em Enviar um novo plugin quando for publicado.

Instalação

Envie o pacote em Configurações → Website → Plugins → Enviar um novo plugin, ative o PKP PN e aceite os termos de uso nas Configurações. A rede precisa aceitar a revista antes de receber depósitos; os depósitos são feitos pela tarefa agendada Depositor (diária).

Testes

Verificado no OJS 3.5.0.3: todos os arquivos PHP válidos, classes carregando contra o PKP instalado, migração criando pln_deposits e pln_deposit_objects, e a página de configurações trazendo os termos da rede. Nenhum código de teste é acrescentado ao pacote.

Créditos e autoria

  • Plugin: Public Knowledge Project / Simon Fraser University e colaboradores de pkp/pln; compatibilidade com OJS 3.5 pelos autores do PR #117.
  • Empacotamento: OJSBR.
  • Distribuído sob a GNU GPL v3 — veja LICENSE.

About

PKP PN (PLN) plugin — unofficial build for OJS 3.5, based on PR pkp/pln#117. Maintained by OJSBR until the official release. · Plugin PKP PN (PLN) — build não-oficial para OJS 3.5, baseado no PR pkp/pln#117. Mantido pela OJSBR até o release oficial.

Topics

Resources

Code of conduct

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages