Announcing a new OJS 3 theme and expanded theming documentation

February 14th, 2017 by  | 11 Comments

OJS 3.0┬ásupports a powerful templating engine that allows well-resourced organisations┬áto produce┬áprofessional, highly-tailored┬ápublishing platforms, like this example from┬áThe Finnish Scholarly Journals Online. But we’re always working to make it easier for journals of all sizes to publish an online site that fits their needs.

Today we’re announcing┬átwo more additions to our theme ecosystem: expanded┬átechnical documentation on theming OJS and OMP, and a new OJS 3 theme that can be used out-of-the-box by┬áanyone regardless of their technical skills.

A technical guide for creating OJS 3 themes

We’ve released the first version of our technical guide describing how you can code your own themes for OJS 3+ and OMP 1.2+┬á. The guide is intended for technically proficient programmers┬áwho wish to customize the look and feel of their journal or press using PHP, HTML and CSS code.

The documentation provides an overview of our theme architecture, how to quickly override templates, and how to introduce simple CSS changes. For those who want to go further, it describes how to create your own themes, take advantage of the new APIs for child themes and theme options, and even deliver custom data to your templates.

We hope you’ll find it useful. Please let us know in the forums if there is anything missing that you think should be included.


Introducing a new OJS 3 theme

Manuscript is a new child theme for OJS 3.0.2+. This theme provides a clean, simple style with a boxed layout that mimics a paper document.

The theme really shines when you configure your journal without a sidebar, benefiting from generous spacing that brings focus to the main content. But it looks great regardless of whether or not you use the sidebar.

Just like the default theme, you can tailor the colours to match your journal’s branding.

If you are using OJS 3.0.2, you can install the theme by going to the┬áSettings > Website > Plugins page in your admin area. Click on the┬áPlugin Gallery, find the┬áManuscript theme in the plugin list, open the plugin details and click on the┬áInstall link you will find there. You’ll then find the plugin in your plugins list and be able to select it under the┬áSettings > Website > Appearance options.

Be sure to let us know about your themeing work in our Community Showcase!

11 Comments on "Announcing a new OJS 3 theme and expanded theming documentation"

  1. Vedran Vucic says:

    Hello, I installed your theme on one OJS installation that we are going to publish soon.
    I will translate it soon on Serbian language.


  2. Srivats Shankar says:

    This looks really good! Kudos for the great work! ­čÖé

    Also, thank you so much for providing documentation on how to create your own formatting and modify the front end templates. It is so useful and clarifies a lot of confusion on how the files are called. Would you be releasing documentation on how to create plug-ins in general for OJS 3? That would be really useful as well.

    Looking forward to see what new features will be added to OJS in the future.

    • Nate Wright says:

      Thanks Srivats. I think we’d be open to writing documentation on how to build plugins. But that’s a big subject, and each plugin type is a little bit different. What kind of plugins are you interested in writing?

      • Srivats Shankar says:

        There are so many I had in mind! I was thinking about plug-ins that could expand the search functionality (by using third-party search engines like Solr or ElasticSearch), which could allow for searching all of the journals on your website. Oauth access was another area I was thinking about, which would be really useful. Maybe having a plug-in that could add static pages to the home/index page if you have multiple journals would be great! Any documentation that explains the basic structure of how OJS 3 works at a developer level would help tremendously. I absolutely love the work you guys are doing! ­čÖé

        Some really creative stuff is coming out and the features that you have added and are proposing to add seemed an amazing. It’s really great to know that this entire project is designed to work towards open access of information.

        • Nate Wright says:

          Sounds good Srivats! We’ll keep that in mind. I’m not too involved in those areas, but I know the team has plans to roll out lots of plugins from the OJS 2 era for OJS 3 as well. They’re getting to them on an priority basis, and maybe they’ll roll out some docs or examples along with those.

  3. Thanks Nate. Just wonderful ! Looks really professional !

  4. Marc Bria says:

    As always, impressive work Nate.

    Your arrival to PKP was a revolution in the theming side, but I feel this is just the begining. Your were the missing pice to make possible the great proposals made by the UI/UX team. Thanks.

    • Nate Wright says:

      Thanks Marc!

      • Marc Bria says:

        Installed and testing. Looks great!

        BTW, is this the first of a serial. ­čÖé
        ┬┐Are you planning to deliver more themes?

        • Nate Wright says:

          PKP has commissioned design work on another theme that we’ll be working to bring out as soon as possibe.

          But we hope these are just the seeds of a broader ecosystem that will emerge with great contributions from our community as well.

Comments are now closed.