Journal Archive System

=== Journal Articles === Contributors: noel, deizi Tags: journal, articles, academic, publications, doi Requires at least: 6.5 Tested up to: 7.0 Requires PHP: 7.4 Stable tag: 1.0.0 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html

Publish and browse academic journal articles with volumes, issues, authors, DOIs, keywords, PDF downloads, filtering and APA citations.

== Description ==

Journal Archive System turns WordPress into a lightweight academic journal platform. It adds a dedicated "Journal Articles" content type together with a volume/issue structure, rich article metadata and ready-to-use front-end layouts, so you can publish and organise scholarly articles without touching code.

Each article can store authors, an abstract, a DOI, an ISSN, page numbers, keywords, publication dates (received, accepted, published), volume and issue details, an optional PDF and a secondary image (for example a QR code). The plugin then renders responsive archive pages, single-article pages and shortcode-driven listings, and it can build an APA citation automatically from the data you enter.

Key features

• Custom "Journal Articles" post type with a "Volumes" taxonomy.
• Structured archive browsing by year, volume and issue.
• Per-author archive pages generated automatically from the authors you enter.
• Article metadata: authors, abstract, DOI, ISSN, pages, keywords, dates, open-access label and more.
• PDF download links with a per-article download counter and per-visit view counter.
• Front-end filtering by title, author, DOI, keyword, publication date, volume and issue.
• Automatic APA citation generation.
• Bundled, responsive archive and single-article templates.
• Fully translation-ready (text domain: journal-archive-system).

Shortcodes

• [journal_archive] – Full archive browser with a volume/issue sidebar.
• [journal_archive volume="volume-1" issue="issue-1-mar"] – A single issue listing.
• [jas_grouped_archive] – Collapsible, year-based archive of every issue.
• [journal_list count="12"] – A simple list of the latest articles.
• [journal_filter] – A search/filter form followed by results.
• [journal_filter_horizontal] / [journal_filter_vertical] – The filter form only, in the chosen layout.

This plugin does not collect any data from your visitors and does not contact any third-party service. DOI values are shown as links to https://doi.org only when you choose to enter them.

== Installation ==

1. Upload the journal-archive-system folder to the /wp-content/plugins/ directory, or install the plugin through the Plugins screen in WordPress.
2. Activate the plugin through the "Plugins" screen in WordPress.
3. Go to "Journal Articles" in the admin menu and add your first article, filling in the metadata fields in the "Journal Article Details" box.
4. Add a page and place one of the shortcodes above (for example [journal_archive]) to display your archive on the front end.
5. Visit the "Journal Articles" archive URL (for example /journal-articles/) to see the built-in archive template.

== Frequently Asked Questions ==

= How do I display the archive on a page? =

Create or edit a page and add the [journal_archive] shortcode. You can also use [jas_grouped_archive] for a year-based, collapsible view, or [journal_list] for a simple latest-articles list.

= How do I record multiple authors? =

Enter the authors in the "Authors" field, separated by semicolons (for example Jane Doe; John Smith). Each author automatically gets a linked archive page listing their articles.

= Where do the PDF files come from? =

Upload the PDF to your Media Library (or paste a URL) using the "Article PDF" field. The plugin then shows a download button and counts downloads.

= Does the plugin send any data to external servers? =

No. The plugin stores everything in your own WordPress database and does not contact any external service.

= Will deleting the plugin remove my articles? =

No. By default, deleting the plugin keeps all of your journal articles. If you want a full clean-up on delete, add define( 'JAS_DELETE_DATA_ON_UNINSTALL', true ); to your wp-config.php before deleting the plugin.

== Screenshots ==

1. The front-end journal archive, grouped by volume and issue.
2. A single article page with metadata, abstract, and APA citation.
3. The "Journal Article Details" metabox used to enter article data.

== Changelog ==

= 1.0.0 =

• Initial release.

== Upgrade Notice ==

= 1.0.0 = Initial release.