=== Wisdom Journal Manager - Research Paper/Process Management ===
Contributors: themaazahmad
Tags: academic, journal, publishing, peer-review, citations, orcid, doi, jats
Requires at least: 5.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 2.2.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

World-class modular academic publishing for WordPress — peer review, submissions, DOI, JATS, citations, REST API.

== Description ==

Wisdom Journal Manager (WJM) turns WordPress into a full scholarly publishing platform:

* Journals → Issues → Papers hierarchy
* ORCID-aware author database
* Full editorial workflow (submit → review → accept → publish)
* Double-blind peer review with structured recommendations
* Front-end manuscript submission portal
* Citation tracking (CrossRef, Semantic Scholar, Scopus, Web of Science)
* AES-256-CBC encrypted API credentials + audit log
* JATS XML export + CrossRef DOI registration
* REST API at `/wp-json/wisdjoma/v1/`

Automatic citation updates are opt-in and disabled by default: the plugin makes no calls to external services on its own. Enable a schedule under Journals → Automation only if you want background citation lookups.

== Installation ==

1. Upload the zip via Plugins → Add New → Upload Plugin
2. Activate Wisdom Journal Manager
3. Open Journals → Plugin Verification
4. Configure DOI prefix + API keys under Journals → Settings
5. Authors submit via the auto-created "Submit Manuscript" page

== Shortcodes ==

* `[wisdjoma_journals]` `[wisdjoma_issues]` `[wisdjoma_papers]` `[wisdjoma_author_profile]`
* `[wisdjoma_search]` `[wisdjoma_paper_metrics]`
* `[wisdjoma_submit]` `[wisdjoma_my_submissions]`

== REST API ==

* `GET /wp-json/wisdjoma/v1/journals`
* `GET /wp-json/wisdjoma/v1/papers`
* `GET /wp-json/wisdjoma/v1/papers/{id}`
* `POST /wp-json/wisdjoma/v1/papers/{id}/status`
* `GET /wp-json/wisdjoma/v1/stats`

== External services ==

Wisdom Journal Manager can connect to external scholarly metadata and DOI services when site administrators choose to use those optional integrations.

= Crossref REST API =

Used to look up DOI metadata and citation counts.

Data sent: a DOI in the request URL and, if the site owner configures the optional polite pool identifier, a contact email in the request headers.

When sent: only when an administrator manually requests a citation refresh or DOI metadata lookup, or when the site owner has explicitly opted in to a citation update schedule (disabled by default) under Journals → Automation.

Terms of service: https://www.crossref.org/documentation/retrieve-metadata/rest-api/access-and-authentication/
Privacy policy: https://www.crossref.org/operations-and-sustainability/privacy/

= Semantic Scholar Academic Graph API =

Used to look up citation counts for a DOI.

Data sent: a DOI in the request URL and an API key in the request headers if the site owner configures one.

When sent: only when an administrator manually requests a citation refresh, or when the site owner has explicitly opted in to a citation update schedule (disabled by default) under Journals → Automation.

Terms of service: https://www.semanticscholar.org/product/api/license
Privacy policy: https://allenai.org/privacy-policy.html

= Elsevier / Scopus APIs =

Used to look up citation data for a DOI through Elsevier's Scopus API.

Data sent: a DOI in the request URL and the site owner's Elsevier API key in the request headers.

When sent: only when an administrator or plugin workflow requests a citation refresh from Scopus.

Terms of service: https://dev.elsevier.com/api_service_agreement.html
Privacy policy: https://www.elsevier.com/en-gb/legal/privacy-policy

= Clarivate Web of Science API =

Used to look up citation data for a DOI through the Web of Science API.

Data sent: a DOI in the request URL and the site owner's Clarivate API key in the request headers.

When sent: only when an administrator or plugin workflow requests a citation refresh from Web of Science.

Terms of service: https://developer.clarivate.com/apis/wos
Privacy policy: https://clarivate.com/privacy-center/notices-policies/privacy-policy/

= arXiv API =

Used to look up metadata for arXiv identifiers.

Data sent: an arXiv identifier in the request URL.

When sent: only when an administrator or plugin workflow requests metadata from arXiv.

Terms of service: https://info.arxiv.org/help/api/tou.html
Privacy policy: https://info.arxiv.org/help/policies/privacy_policy.html

= Crossref DOI deposit service =

Used to register or update DOIs with Crossref when the site owner enables DOI registration.

Data sent: journal, issue, paper, author, and DOI metadata prepared for deposit, plus the site owner's Crossref account credentials.

When sent: only when an administrator explicitly triggers a DOI registration, retry, preview, or connection test.

Terms of service: https://www.crossref.org/membership/
Privacy policy: https://www.crossref.org/operations-and-sustainability/privacy/

= DataCite DOI service =

Used to test DOI account access and, when enabled by the site owner, prepare DOI registration workflows with DataCite.

Data sent: the site owner's DataCite account credentials during connection checks and DOI service requests, and DOI metadata when a registration workflow is used.

When sent: only when an administrator explicitly triggers a DOI connection test or DOI registration workflow.

Terms of service: https://datacite.org/wp-content/uploads/2024/04/DataCite_DirectMembershipTerms_20240311.pdf
Privacy policy: https://datacite.org/privacy-policy/

== Screenshots ==

1. Home dashboard view
2. Editor inbox with status filters
3. Getting started / help screen
4. Advanced settings and configuration
5. Author submission portal

== Changelog ==

= 2.2.3 =
* Automatic citation updates are now opt-in and disabled by default; the plugin no longer schedules background calls to external services unless the site owner enables a schedule.
* Namespaced all plugin functions, classes, defines, options, shortcodes, capabilities, hooks, and REST routes under a unique `wisdjoma` / `WISDJOMA_` prefix to avoid conflicts.

= 2.2.2 =
* Update compatibility metadata for WordPress 7.0 and add the languages directory declared by the plugin header.

= 2.2.1 =
* Fix template direct-access guards and tighten JATS REST permissions.
* Update plugin metadata and document optional external services.

= 2.2.0 =
* OJS-style DOI Manager: pattern tokens (%j %v %i %a %x %Y), auto-assign on accept/publish
* CrossRef + DataCite deposit (test/production), batch issue DOIs, per-journal acronym/prefix

= 2.1.0 =
* Editor Inbox with status filters and pending badge
* Getting Started checklist + post-activation guide
* Reviewer access to assigned private manuscripts/files
* Auto-upgrade path for schema/roles/pages on version bump

= 2.0.0 =
* Peer review (assign, invite, blind review, recommendations)
* Editorial workflow state machine + email notifications
* Author submission portal + manuscript uploads
* JATS XML export + CrossRef DOI registration
* REST API + public paper/journal templates

= 1.0.0 =
* Initial modular architecture release
