Microsoft Word File Import (Atto)

Atto ::: atto_wordimport

Maintained by

Eoin Campbell

Part of set Microsoft Word file import/export.

Import entire Microsoft Word 2010 (.docx) files, including tables, embedded images and Microsoft Equation Editor equations, cleanly. It also imports LibreOffice and Google Docs files saved to .docx format, but not nearly as well.

Latest release: 6 months

4698 sites

1k downloads

158 fans

Current versions available: 3

Download

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.

Useful links

Screenshots

Contributors

Eoin Campbell (Lead maintainer)

View other contributions

Please login to view contributors details and/or to contact them

Awards

Comments

Plugins bot
Tue, 15 Sept 2015, 6:14 PM
Prechecker results: 24 errors/24 warnings
http://integration.moodle.org/job/Precheck%20remote%20branch/16276/artifact/work/smurf.html
David Mudrák
Tue, 15 Sept 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.
Eoin Campbell
Thu, 17 Sept 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.
Eoin Campbell
Thu, 24 Sept 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.
David Mudrák
Sat, 3 Oct 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.
David Mudrák
Thu, 15 Oct 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.
Eoin Campbell
Thu, 15 Oct 2015, 10:11 PM
Hi David, many thanks for your assistance, it's been a real education for me.
Manish Kumar
Fri, 16 Oct 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
bekee franklin
Tue, 20 Oct 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
Eoin Campbell
Thu, 22 Oct 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, 12 Nov 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.
Eoin Campbell
Thu, 12 Nov 2015, 8:56 PM
Unfortunately I don't have a fix for this issue at present. I'll take a look next week.
Jeff Parker
Tue, 8 Dec 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