OJS 3.1 HTML galley not working in iOS

Hi all

I have made a HTML article in our journal and I can’t get it working via iOS devices (iPods, iPads and iPhones). The page doesn’t download.

I tested the demo journals, and there is the same issue. Check e.g. https://demo.publicknowledgeproject.org/ojs3/demo/index.php/demojournal.

How to fix this? I see from my Google Analytics that iPads and iPhones are very popular devices that our readers use?

All help is much appreciate.

Best regards


I can not reproduce this in my iPad. I tried opening the Willinsky article and the HTML opened without a problem. But maybe I misunderstood your problem?

ps. jos olette Journal.fi-palvelussa, niin voidaan selvitellä myös käyttäjätuen kautta…

Hi ajnyga

Thanks for the quick reply.

I can open the page, but downloading stops at the first screen size (https://www.dropbox.com/s/u0yuyqgz392cgtf/File%2012-02-2018%2C%2018.54.13.jpeg?dl=0).

So you can actually scroll down the full article. I have tested this via multiple iOS devices in all possible browsers and none them allows scrolling down the article. Really strange.

Can you read this pages HMTL article via iOS device: https://lumat.fi/index.php/lumat/article/view/220

PS. LUMAT valitettavasti ole Jounal.fi-palvelussa, jotta asiakastuen puoleen ei voida kääntyä :slight_smile:

Thanks, I see it now. I just opened the Willinsky article and did not try to scroll down.

I bet it has something to do with the fact that the HTML is inside an iframe. Maybe: Scroll IFRAMEs on iPhone and iPad scroll - Iframe scrolling iOS 8 - Stack Overflow

I will tag @NateWr here so that he can take a look.

edit: @johannespernaa you could try fixing this in your installation by editing the HTML galley plugin according to this: Scrollable iframe on mobile Safari (Example)
see: https://github.com/pkp/ojs/blob/master/plugins/generic/htmlArticleGalley/display.tpl#L30-L32

Hey @ajnyga

Autoflow worked. Articles are now readable.
Internal links work poorly in iOS devices, but this is much more better situation.

Thanks @johannespernaa, can you layout the code changes you made to fix this?

Hep @NateWr

I added the


in line 30 in Html Galleys display.tlp file.


It is not 100% responsive in iOS and internal links doesn’t work, but it can be opened and read.

1 Like

Adding also overflow-y: scroll; is suggested here:Scroll IFRAMEs on iPhone and iPad. Not sure if that helps improve the result.The link issue seems to be connected to link anchors.

@johannespernaa later this year I will be working on a htmlGalley plugin that:

  1. opens the html file and takes the content between <body> and </body>
  2. embeds the result under the abstract
    It will be available in Github when ready, but probably not until next fall. It is not that much work, but I do not have the required time right now.
1 Like

Thanks @johannespernaa, I’ve filed the issue for us to look into:


Hi @johannespernaa, I like how you view HTML on your demo site, how did you do it? I have the plugin enabled but my HTMLs download instead of being displayed.
Thanks for your help.


Hello @Tiziano

Sorry for the delay. I have completely missed out your message.

About the solution, I think it should work just like that. Is everything right with the HTML file?
Can you share the link to article.

BR Johannes

Hi @johannespernaa!
in truth I would have a different XML file, with the plugin “htmlArticleGalley” displays full screen automatically. Very nice, but I wanted to ask if it was possible to display it inside the site with headers, menus and columns on the right and be able to customize it. I saw your HTML file that looked like PDF galley. Then with the plugin enabled but my HTMLs download instead of being displayed.Can you help me?

Thanks a lot for support.


Can you send a link to test page?

Hi @johannespernaa!

i send you the link to site page for example, this is one of many articles that have html to view that instead you download:


Thanks for any help.


Hi @Tiziano
Actually, you have there not an HTML, but a good formatted JATS XML. You can use Lens Viewer or my own JATS Parser in order to transform JATS XML into HTML.
For example, JATS Parser is built in Old Gregg theme, you can see the rendered sample here: http://ojsdemo.e-medjournal.com/index.php/oldGregg/article/view/5
The source code is here: GitHub - Vitaliy-1/oldGregg: Theme for OJS 3 with Bootstrap 4
You can also integrate JATS Parser into your own theme but this will require some experience with PHP and Smarty templates.

Hi @Tiziano

Have you installed the eLife Lens Article Viewer?
I think it is needed for XML files.


Thanks to @johannespernaa and @Vitaliy for your support! I have enabled eLife Lens Article Viewer plugin and it now works.

Another problem I have encountered is that it does not display me the images and tables.


Hello @Tiziano

If you look this test xml file, all image are uploaded to just some location and referred from the actual file via href=""

Test: https://dev.lumat.fi/index.php/lumat/article/view/1/6#figures

Location of the image: https://e-medjournal.com/suppl/v2_1/tsira/fig1.png

Hi @johannespernaa,
currently load images from here:


but does not display them. I don’t like to upload images to other places and recall them, I prefer to manage them in the system.

I saw that you made an HTML page displayed as a PDF, very nice! Would you help me understand how you did it?


Thanks for help!


Well I just did a regular web page. See the source code: view-source: https://dev.lumat.fi/index.php/lumat/article/download/1/2?inline=1

I download all the css and image files to sub domain (https://articles.lumat.fi/). It is much easier to manage than downloading stuff into OJS.

At leat, that is how I feel it.

I you wan’t your article to look like LUMAT paper. Just copy my CSS and iterate it as you feel like. Change colors fonts etc…