Package contents

  • Archive: the .zip file you received
  • Folder after unzipping: theme-one_all-plugins-bundle/ (top-level)
  • Includes:
    • All Theme One plugins
    • License Manager
    • Slider Home plugin
    • Social sharing / Shariff
    • Docs & Seeds: /docs/ (incl. database-code.txt, optional images)

Requirements (Supported setup)

  • OJS 3.3.0-20 or any 3.3.x
  • PHP 7.4–8.1 (match your OJS version)
  • Write permissions: plugins/themes/, plugins/generic/, public/ (uploads), cache/
  • Your license key
  • MySQL/MariaDB access (CLI or phpMyAdmin) for optional seed
  • Reference: System Requirements & Security & Permissions

Standard install

  1. Unzip the .zip file you received on your computer.
  2. Upload the contained theme/plugin folders to your OJS server.
    • Themes → plugins/themes/themeOne/
    • Generic plugins → plugins/generic/<pluginName>/
    Ensure there’s no extra nesting like themeOne/themeOne/.
  3. In OJS: Settings → Website → Plugins, enable the installed items.
  4. Appearance → Theme: select “Theme One” and Save.
  5. Clear caches (recommended): Administration → Site Settings → Clear Data Caches & Clear Template Cache.

License activation

Option A — from the theme row (recommended):
Settings → Website → Plugins → Installed Plugins → Theme Plugins → Journal Theme → License Settings
Click License Settings, paste your key, and Save.

Option B — from the License Manager (if enabled):
Settings → Website → Plugins → Theme One — License Manager (Generic) → Settings
Paste your key, Save.

What activation checks

  • Key format & validity on licensing server
  • Domain binding (first public activation binds the key)
  • Uniqueness (one key cannot be active on two different public domains)

Changing your domain

  • On the old site: open License Settings, click Deactivate, then activate on the new domain.
  • If the old domain is unreachable, contact support to reset the binding.

Common reasons for “Inactive”

  • Extra spaces when pasting the key
  • HTTP vs HTTPS mismatch (use your canonical URL in OJS)
  • DNS not propagated yet
  • Server blocks outbound requests (firewall / cURL / SSL)

Database seed — database-code.txt (optional)

If your bundle includes /docs/database-code.txt (demo/seed content):

  1. Open the file and review the comments at the top (journal path, locale, IDs).
  2. Backup your DB (recommended).
  3. Run the statements using one of the options below:
    • CLI (recommended): mysql -u <user> -p <dbname> < /path/to/database-code.txt
    • phpMyAdmin: Import → choose database-code.txt → format: SQL → Go.
  4. Clear caches (Administration → Site Settings → Clear Data/Template Caches).
  5. Verify demo content in OJS (menus, slider items, pages).

Notes

  • Themes do not alter core schema; some bundled plugins may create tables on first enable.
  • If your host blocks auto schema creation, run from OJS root:
    php tools/upgrade.php upgrade

Troubleshooting

  • Theme not listed: check folder name (themeOne), permissions, PHP error log.
  • Blank/500 after enabling: temporarily rename plugins/themes/themeOne/, clear caches, confirm PHP version/extensions.
  • CSS/JS not updating: clear caches, hard refresh, purge CDN if any.
  • Seed not visible: confirm SQL import success and correct journal/context.

Support & updates

  • Includes 1 year of updates & support per your package tier.
  • When contacting support, include domain, purchase email, and license key.

Uninstall

  1. Switch back to a default theme (Appearance → Theme).
  2. Disable Theme One and bundled plugins in Plugins.
  3. (Optional) delete the uploaded folders from plugins/.
  4. Clear caches.
  5. If you imported seed data and want a clean revert, restore your DB backup.
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "What are the supported OJS and PHP versions?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "OJS 3.3.0-20 or any 3.3.x with PHP 7.4–8.1. See System Requirements and Security & Permissions in the PKP docs."
      }
    },
    {
      "@type": "Question",
      "name": "How do I activate my license?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Go to Settings → Website → Plugins, open the Theme row → License Settings, paste your key and Save. Alternatively, use Theme One — License Manager (Generic) → Settings."
      }
    },
    {
      "@type": "Question",
      "name": "What does activation check?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Key format and validity on the licensing server, domain binding on first public activation, and uniqueness (a key cannot be active on two different public domains)."
      }
    },
    {
      "@type": "Question",
      "name": "How can I change my domain?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Deactivate the key on the old site under License Settings, then activate on the new domain. If the old site is unreachable, contact support to reset the binding."
      }
    },
    {
      "@type": "Question",
      "name": "Why does it show 'Inactive'?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Common causes: extra spaces when pasting the key, HTTP/HTTPS mismatch, DNS propagation pending, or server blocking outbound requests (firewall/cURL/SSL)."
      }
    }
  ]
}
</script>