Akeeba Ticket System

#33796 Akeeba Ticket System and DocImport3

Posted in ‘Akeeba Ticket System’
This is a public ticket

Everybody will be able to see its contents. Do not include usernames, passwords or any other sensitive information.

Environment Information

Joomla! version
PHP version
Akeeba Ticket System version


I know that you provide support, but I would appreciate your advice. The component DocImport3 does not see xml files. I created a test file, the /media/com_doc import/books folder, and uploaded it to the server. But the admin panel displays a message about the absence of xml files.

You have a component that has no analogues. And it could save money on user support. Are you considering converting the DocImport3 component to paid extensions?

Akeeba Staff

I guess the documentation for DocImport is not very clear about how to set up the directory of XML files.

First go to DocImport and click on Options. Set the Books Folder to com_docimport/books if it's not set to that already.

Using FTP/SFTP or your hosting file manager go into your site's media/com_docimport/books folder. Create a new directory, let's call it my_category. Move your DocBook XML files and related assets into the my_category folder.

Go to DocImport, Categories and click on the category you have created. In the Slug / Directory field enter my_category (the name of the subfolder you created inside media/com_docimport/books). Click on Save & Close.

Now DocImport will see your DocBook XML files.

A couple of important points:

  • Your XML files must be in DocBook XML format. That's the only format DocImport understands.
  • I see that you're trying to have multiple XML files. While this works, kinda, it's not a very pleasant experience. The index page is just a dump HTML list of article titles. It's best to have one big DocBook XML Book document instead of multiple DocBook XML Article documents. You can of course use imports to keep your sections organised as individual files. However, if you do that, you need to put the included XML documents in a subdirectory.

Regarding making DocImport into a paid component, it doesn't really make sense to me. There are a handful of us using it. I'd rather give the occasional advice through our ticket system than trying to create yet another paid product with all the administrative trouble that entails.

Nicholas K. Dionysopoulos

Lead Developer and Director

🇬🇷Greek: native 🇬🇧English: excellent 🇫🇷French: basic • 🕐 My time zone is Europe / Athens
Please keep in mind my timezone and cultural differences when reading my replies. Thank you!

System Task
This ticket has been automatically closed. All tickets which have been inactive for a long time are automatically closed. If you believe that this ticket was closed in error, please contact us.

Support Information

Working hours: Typically we work Monday to Friday, 9am to 7pm Cyprus timezone (EEST). Support is provided by the same developers writing the software, all of which live in Europe. You can still file tickets, but we cannot respond to them, outside of our working hours.

Support policy: We would like to kindly inform you that when using our support you have already agreed to the Support Policy which is part of our Terms of Service. Thank you for your understanding and for helping us help you!