## 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.
4205 sites
132 fans
Current versions available: 3

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

• Tue, Sep 15, 2015, 6:46 PM

Thanks Eoin for sharing this plugin with the community. While testing the plugin functionality and reviewing the actual implementation, some important issues were detected and reported to your issue tracker. I believe these issues should be fixed first before continue with the approval process. Thanks for your understanding and patience.

• Thu, Sep 17, 2015, 5:27 AM
Hi David, many thanks for your patience and detailed comments and feedback. I have addressed all of the issues you raised and resolved them all, I think, except your issue actually importing a Word file. However, if you can send me your sample, I can try and identify the issue. If the file contained an equation, for example, that would probably break the import process. Nonetheless, and with high hopes, I have released yet another version which I hope you can review for me.
• 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