Note: You are currently viewing documentation for Moodle 3.8. Up-to-date documentation for the latest stable version of Moodle may be available here: Atto Word import.

Atto Word import: Difference between revisions

From MoodleDocs
mNo edit summary
 
(4 intermediate revisions by 2 users not shown)
Line 10: Line 10:
The Atto Word import plugin is available from the [https://moodle.org/plugins/browse.php?list=category&id=53 Atto plugins directory].
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,
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.
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 supports ''.docx'' files only, not the older ''.doc'' format.  
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).
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.
Note that files in ''.docm'' format (i.e. including macros) are not supported.
Line 19: Line 19:


==Installation and configuration==
==Installation and configuration==
This plugin is not yet available on the official Moodle plugins website, as it is still undergoing the formal approval process,
This plugin has been released on the Moodle plugins directory, and can be installed in the standard way.
which is unfortunately stalled while Moodle HQ staff focus on getting Moodle 3.0 released.  
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.
Hopefully it should be approved sometime in November 2015.
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]]


In the meantime, you can download and install it manually, as follows.
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"  
# Start a browser, and download the installation Zip file from my [http://www.moodle2word.net/mod/resource/view.php?id=33 Moodle2Word test webserver], and save it to a local folder.
as your preferred text editor in your "Editor preferences" settings.  
# Log in to your Moodle server as the administrator.
Note that you must be running Moodle 2.7 or higher.
# In Moodle, go to the Site administration > Plugins > Install plugins page, and expand the "Install plugin from ZIP file" group.
# In the "Plugin type" dropdown field, select "Atto HTML editor / Atto plugin (atto)".
# Click on the "Choose a file" button next to the "Zip package" field, and select the Zip file you downloaded (moodle-atto_wordimport-0.9.3.zip).
# You may need to check the Acknowledgement box (Moodle 2.7/8).
# Click the button "Install plugin from the Zip file", and follow the prompts.
After installation is complete, edit any page, and a new Word icon should appear in the main Atto toolbar. If the toolbar has been customised,
may need to expand the toolbar before you see it.


==See also==
==See also==

Latest revision as of 15:55, 17 November 2015

The Atto Word import plugin is available from the 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. 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 ([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.