Guide
WordPress integration guide
How a journal published with WordPress and Oxton Journals registers its articles in ORI automatically through the ORI Connector plugin. ORI is the institutional identifier of Oxton; it is not a DOI and not a Crossref registration.
Updated outubro 16, 2026
How it works
- The article is published on the journal website, alone or with its issue.
- The connector sends the metadata to ORI as a registration request. Identifiers are generated only by the ORI registry, never on the journal website.
- ORI checks and issues: credential, required metadata, duplicates (same DOI, same article address, or same title in the same journal and year) and that the article page is online.
- The identifier comes back and is shown on the article page; the PDF is deposited in the ORI repository with its SHA-256 checksum.
Every hour the connector sends the articles edited since the last synchronisation, registers older articles, follows requests awaiting approval and reads back the status of each record in ORI. An update never changes the identifier, and requests are idempotent: a request sent twice does not create two records.
Requirements
- Your organization and journal are approved in ORI (see Request membership).
- The connector, downloaded free of charge in the ORI dashboard (Downloads), together with the key of the organization. Issuing ORI identifiers is free for every approved journal.
- WordPress 6.4 or later, PHP 8.1 or later, and the Oxton Journals plugin.
- A journal credential issued by an institutional administrator in the ORI dashboard (Credentials), with the scopes
registrations:writeandregistrations:read. The secret is shown only once — copy it right away.
Installation
- Download the connector in the ORI dashboard, Downloads (available once the plan is paid), and copy the subscription key shown there.
- Install and activate the Oxton ORI Connector plugin on the journal website (Plugins › Add New › Upload Plugin); WordPress opens Settings › ORI Connector.
- Enter the subscription key (ORIK-XXXXX-XXXXX-XXXXX-XXXXX) and activate it. Without a valid key the connector does not send articles.
- Connect the journal: mark it as connected, paste its credential, choose whether to deposit the PDF, and save.
- Test the connection with Test connection: the page shows the journal name in ORI and whether registrations are reviewed before the identifier is issued.
- Register the back catalogue with Register all published articles. From then on, new articles are registered automatically when they are published.
Settings
| Setting | What it does |
|---|---|
| ORI address | The registry the connector talks to. Keep https://oriregistry.org. |
| Connected | Turns registration on or off for each journal of the website. |
| Credential | The journal credential from the ORI dashboard. It is stored encrypted and never shown again. |
| Deposits the article PDF in the ORI repository after the identifier is issued (on by default). |
What readers see
- On the article page:
ORI: ORI-XXXXXXXXXXXX, with the ORI icon, and the permanent addresshttps://oriregistry.org/10001/2026.0001. - The ORI record page shows the metadata, citations in several styles, the deposited PDF, the history of changes and a link back to the article.
- Journals without a DOI show the ORI as their persistent identifier.
Article states
| State | Meaning |
|---|---|
| Queued | Waiting to be sent in the next pass. |
| Awaiting approval | The journal reviews registrations; the request waits in the ORI dashboard. |
| Registered | The identifier was issued and is shown on the article page. |
| Failed | ORI could not process it; the last message explains why. Temporary failures are retried automatically. |
| Rejected | The request was rejected in ORI. Correct the article and send it again. |
| Unpublished | The article was unpublished on the website; the ORI record is not deleted. |
Journals with approval
When ORI reviews the registrations of a journal, the article stays awaiting approval until the request is approved in the ORI dashboard; the identifier then appears on the article page automatically, in the next hourly pass.
Errors and retries
- Settings › ORI Connector lists every article with its state and the last message from ORI.
- Temporary failures (network, timeouts) are retried automatically.
- Validation errors, duplicates and credential problems are shown to the editor, who can correct the article and use Send again.
- A duplicate means the article is already registered in ORI: the message gives its identifier.
Security
- The credential is stored encrypted on the server of the journal website and is never exposed in public pages or JavaScript.
- It is limited to its journal and scopes, and can be revoked at any time in the ORI dashboard; issue a new one and paste it in the settings.
- All calls use HTTPS, and every operation is recorded in the ORI audit log.
- Updates: when a new version of the connector is published, WordPress shows it on the Plugins page and in Dashboard › Updates; Update now installs it, with nothing to download by hand (from version 1.5.0 on).
- The subscription key is stored encrypted too, and checked with ORI every 12 hours. If the plan lapses, new articles wait until it is renewed; identifiers already issued keep working and stay on the article pages. If ORI cannot be reached, the last answer is kept.
Questions
- Does editing an article change its ORI? No. Updates create a new version of the record; the identifier never changes.
- What if we move the journal to another website? Keep the connector on the new site with the same credential; only the article addresses change in ORI.
- Can we use ORI and DOI together? Yes. The DOI stays the journal’s choice; ORI records it when it is sent and uses it in citations.