View source for Atto Word import

{{Infobox plugin
|type = Atto, Microsoft Word import plugin
|entry = https://moodle.org/plugins/view.php?plugin=atto_wordimport
|tracker = https://github.com/ecampbell/moodle-atto_wordimport/issues
|discussion = https://moodle.org/mod/forum/view.php?id=1035
|maintainer = [[User:Eoin Campbell|Eoin Campbell]]
|float = right
}}

The Atto Word import plugin is available from the [https://moodle.org/plugins/browse.php?list=category&id=53 Atto plugins directory].
It can be used to import the complete contents of a Microsoft Word 2010 (.docx) file, including tables, equations, headings and other structural markup,
and any embedded images.  You can select a file to import, or just drag and drop a Word file in the text area.

At present, this plugin is in beta, so it may not always work. It may be better not to use it on production servers. 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.

All language editions of the above versions should also work, including Chinese, Arabic, etc.

==Installation and configuration==
This plugin has been released on the Moodle plugins directory, and can be installed in the standard way.
During the installation, you will be asked to map the "Heading 1" style in Word to a corresponding heading element in HTML. By default, h3 is used.
After installation is complete, edit any page, and a new Word icon should appear in the main Atto toolbar in the files group.
If the toolbar has been extensively customised, you may need to expand the toolbar to see it.
[[Image:atto wordimport toolbar.png]]

If your toolbar doesn't look like this, click on your username in the top right of the screen, select "Preferences", and choose "Atto HTML Editor" 
as your preferred text editor in your "Editor preferences" settings. 
Note that you must be running Moodle 2.7 or higher.

==See also==
This plugin is derived from work on a question import format ([[https://docs.moodle.org/400/en/Word_table_format Word table format]])
that supports importing Word files to populate multiple entire questions, including all the text fields associated with them. 
If you are editing quiz questions, using this import format is probably more efficient.

[[Category:Editing text]]
[[Category:Plugin]]
[[Category:Contributed code]]

[[es:Atto Importar Word]]