Skip to content

OJS plugin for adding Schema.org structured data to article pages

License

Notifications You must be signed in to change notification settings

ojs-services/schemaOrg

Repository files navigation

Scholarly Article Schema Plugin

Version: 1.0.2.0
Developer: OJS Services
Compatibility: OJS 3.3+
License: GPL v3

Overview

The Scholarly Article Schema Plugin enhances article discoverability by adding Schema.org structured data to article landing pages. Using JSON-LD format, the plugin provides search engines and academic indexing systems with rich, semantic metadata while maintaining full compatibility with existing Google Scholar integration.

Key Features

  • Automatic Schema.org structured data generation for published articles
  • Support for ScholarlyArticle and MedicalScholarlyArticle types
  • Comprehensive metadata extraction: authors, affiliations, ORCID, DOI, keywords, and more
  • Zero additional database queries or performance impact
  • Cross-theme compatible with all standard OJS themes
  • Bilingual interface (English/Turkish)

Installation

Via Plugin Gallery (Recommended)

  1. Navigate to Settings → Website → Plugins → Plugin Gallery
  2. Search for "Scholarly Article Schema"
  3. Click Install

Manual Upload

  1. Download schemaOrg-1.0.2.0.tar.gz
  2. Navigate to Settings → Website → Plugins → Upload a New Plugin
  3. Upload the archive and activate

Server Installation

cd plugins/generic
tar -xzf schemaOrg-1.0.2.0.tar.gz
chown -R www-data:www-data schemaOrg
chmod -R 755 schemaOrg

Configuration

  1. Enable the plugin in Settings → Website → Plugins
  2. Click the Settings icon
  3. Select schema type:
    • ScholarlyArticle (default): General academic journals
    • MedicalScholarlyArticle: Medical and health science journals
  4. Save settings

What Gets Included

The plugin automatically extracts and formats the following metadata when available:

  • Article title and abstract
  • Author information (names, affiliations, ORCID)
  • Publication and issue details
  • DOI and article URL
  • Keywords and language
  • License information
  • Journal ISSN, volume, and issue numbers

Example Output

{
  "@context": "https://schema.org",
  "@type": "ScholarlyArticle",
  "headline": "Article Title",
  "description": "Article abstract...",
  "author": [
    {
      "@type": "Person",
      "name": "Author Name",
      "affiliation": {"@type": "Organization", "name": "University"},
      "sameAs": "https://orcid.org/0000-0001-2345-6789"
    }
  ],
  "datePublished": "2025-01-15",
  "identifier": {"@type": "PropertyValue", "propertyID": "DOI", "value": "10.1234/..."},
  "publisher": {"@type": "Organization", "name": "Journal Name"},
  "license": "https://creativecommons.org/licenses/by/4.0/"
}

Benefits

  • Enhanced Discoverability: Improved indexing by major search engines
  • Semantic Web Integration: Better content understanding and classification
  • Rich Search Results: Potential for enhanced search engine displays
  • Standards Compliance: Follows Schema.org and Google Scholar best practices

Technical Details

  • Hook Used: TemplateManager::display
  • Output Format: JSON-LD in article page <head> section
  • Performance: Zero additional database queries
  • Compatibility: OJS 3.3, 3.4, 3.5

Validation

Test your implementation using:

Support

Developer: OJS Services
Website: https://ojsservices.com
Email: info@ojsservices.com

For professional OJS development, consulting, and technical support.

License

GPL v3 - See LICENSE file for details

Changelog

1.0.2.0 (2026-02-07)

  • Updated plugin name and description
  • Enhanced documentation
  • Production release

1.0.1.0 (2026-02-06)

  • Initial release
  • Support for OJS 3.3+
  • ScholarlyArticle and MedicalScholarlyArticle types