## Atto: Microsoft Word File Import (Atto)

atto_wordimport
Maintained by Eoin Campbell
Import entire Microsoft Word 2010 (.docx) files, including tables, embedded images and Microsoft Equation Editor equations, cleanly. Also imports LibreOffice and Google Docs files saved to .docx format.
2981 sites
115 fans
Current versions available: 2

This plugin allows users import the entire contents of a Word 2010 (or later) file as clean HTML, retaining formatting such as headings, lists, bold and italic. The heading styles in Word such as "Heading 1" are mapped to corresponding tags in HTML such as h3, h4 (the "Heading 1" style is mapped to h3, etc.). For best results, the imported Word files should be well-styled, i.e. use standard Word named styles (e.g. "Heading 1", "List Bullet") as much as possible.

It supports .docx files only, not the older .doc format. The following Word versions support this format: Word 2007, Word 2010 and Word 2013 (on Windows); Word 2011 and Word 2016 (on MacOS). Note that files in.docm format (i.e. including macros) are not supported.

LibreOffice 5.x can also save files in .docx format, and they will import too, but generally the quality is not as good as native Word files, even if the document uses styles well.

Note also that the PHP XSL extension must be enabled on your webserver, and the plugin requires Moodle 2.7 or higher.

After installation, the Atto editing toolbar should have a new Word icon added to the files group, similar to the screenshot below.

You can click on the link to open the file selection dialog, or alternatively, just drag a file over the text area and it will be imported and converted.

### Sets

This plugin is part of set Microsoft Word file import/export.

### Contributors

• Thu, Sep 24, 2015, 9:53 PM
Hi David, thanks for your patience. I believe I have addressed the security issue, as I now ensure that only files from the current users context are deleted. I have released yet another version which I hope you can review for me.
• Sat, Oct 3, 2015, 10:33 PM

Hi again. The plugins team is currently busy with other development tasks for the upcoming Moodle 3.0 release, so please expect delays in the review and approval process. Thanks for your understanding and patience, we will do our best to get to reviewing your plugin soon.

• Thu, Oct 15, 2015, 7:51 PM

Hi Eoin. I believe this is good to go now. I noticed direct usage of XMLHttpRequest instead of the Y.io wrapper but I can understand this choice today. I left some more comments in the tracker but I can't see any approval blocker now. You are cleared to land, welcome to the Plugins directory.

• Thu, Oct 15, 2015, 10:11 PM
Hi David, many thanks for your assistance, it's been a real education for me.
• Fri, Oct 16, 2015, 3:09 PM
Hi Eoin, Thanks for the plugin , Can you please mentione here that you need to have XSL installed before using this Tool
• Tue, Oct 20, 2015, 6:25 PM
I have XSL properly installed on my Unix Server, it import .docx file quite fine into the atto_editor but on display, the equations varnishes with error being unable to equations
• Thu, Oct 22, 2015, 5:43 PM
This sounds like a MathJax configuration issue, but it could also be that the equation has not been converted into the correct MathML for MathJax to display. The equation could be too complex, or else the conversion process has mangled it. Send me the Word document and I can take a look.
• Thu, Nov 12, 2015, 8:19 PM
Hi Eoin Campbell,
I had installed the module "word import" of atto editor in moodle 2.9.2+.
I found image can't be dragged and dropped to atto editor in chrome brower,but work well in firfox.
At first I suspected it's a bug of moodle ,and reported a bug at
https://tracker.moodle.org/browse/MDL-52027?filter=-2
,but I found this problem resulted from the module "word import".
Could you fix your module? Thank you very much.
• Thu, Nov 12, 2015, 8:56 PM
Unfortunately I don't have a fix for this issue at present. I'll take a look next week.
• Tue, Dec 8, 2015, 7:13 PM
Hi Eoin
I've installed your plugin version Release 1.0.0 (Build 2015101501) into my Moodle 3.0 site.
On dragging a word docx document into a page or using the plugin dialogue box I'm getting the following alert servererror,moodle. I've tried with very simple documents - just headings, no tables and no images, still the same.
I can confirm that XSL is enabled.
Any idea where I can look for a solution?
Thanks

Jeff
• Thu, Dec 10, 2015, 6:34 PM
Hi Jeff,
You might have a problem if you are using the Google Chrome browser.
Can you try a different browser and see if that works?

I also released a new version of the plugin (v1.1.0) which may fix your problem.
Let me know. If you send me the Word file you are trying to import, that would help too.
• Tue, Jan 19, 2016, 9:53 PM
Hi Eoin,

I'm in dire need to copy paste a large content from word into moodle. The "paste from Word" button seemed to be the saviour but when I try it it does not work. It keeps some of the formatting but the formatting of the titles and rubriks aren't kept but are rendered without formatting. Do you know how I can get around this problem?

Kalle
• Sat, Feb 6, 2016, 3:17 AM
Good afternoon Eoin. My name is Charles and I'm from Brazil . Congratulations on your effort. I believe that soon you will succeed in this task. I hope it's soon. lol . Thank you. I'll be expecting !
• Fri, Apr 1, 2016, 10:58 PM
Hi Eoin,
I am facing the same problem reported on 12 Nov 2015 i.e. once I have installed his plugin, I am facing a problem in Chrome browser alone. I am not able to drag and drop image files into the Atto text editor area. I get prompted to open the file in a separate browser tab. This works fine in Firefox. If I uninstall this plugin, the drag and drop works fine in Chrome. Can you please guide on this?
Thanks.
Regards.
Narayan
• Tue, Apr 5, 2016, 5:05 AM
Unfortunately I still don't have a solution for this problem due to other work commitments, and also my limited knowledge of JavaScript in Moodle. The only workaround that allows you use Chrome while keeping the plugin installed is to use the image icon to insert images, rather than dragging and dropping them into an Atto editor.