Introduction

This package is to be used with the ASP.NET open source CMS Umbraco, which extends the umbraco admin user interface to allow you to translate a dictionary item into different languages with a simple click of a button using the Microsoft Translation WebService.

Requirements

Before installing the package you will need to ensure that your Umbraco installation meets the following minimum requirements:

Installation

To install the package follow these simple steps:
  • Login to Umbraco
  • Browse to the Developer Section
  • Expand Packages folder
  • Click on Install local package
  • Browse to the Dictionary Translator zip/package
  • Check the box for I understand the security risks
  • Press Load package
  • Read the read me and accpet the license and press the install package
  • Enter your AppID key from Microsoft in the textbox and press Save (You can obtain an AppID from Microsoft here - http://www.bing.com/developers/appids.aspx)
  • You have now sucessfully installed the Dictionary Translator for Umbraco package

The web.config gets modified to add the Microsoft Translation webservice automatically when you install the package.

What files are installed/added

The following files are added to your Umbraco installation:
  • /bin/DictionaryTranslate.dll
  • /bin/DictionaryTranslate.dll.config
  • /bin/DictionaryTranslate.pdb
  • /bin/DictionaryTranslate.Installer.dll
  • /bin/DictionaryTranslate.Installer.pdb
  • /umbraco/images/editor/translate.gif
  • /config/cws_dictionaryTranslate.config
  • /usercontrols/DictionaryTranslator/Installer.ascx
  • /usercontrols/DictionaryTranslator/Installer.ascx

How to use

To use the Dictionary Translator follow these steps:
  • Open an existing dictionary item up in Umbraco, you will see a new button to the right of the save button this is the new translate button
  • Fill in one of the language boxes and press the translate button and this will automatically fill in the other languages with their translations
  • Review the translations and if you are happy with them press Save

Uninstallation

To uninstall this package follow these steps:
  • Login to Umbraco
  • Browse to the Developer Section
  • Expand Packages folder
  • Expand Installed Packages
  • Click on Dictionary Translator
  • Click on Uninstall package
  • Make sure all checkboxes are ticked for all the files
  • Then press Confirm Uninstall
  • You have now sucessfully uninstalled the Dictionary Translator for Umbraco package

The web.config that was modified with the <system.serviceModel> changes will be removed automatically

Last edited Mar 2, 2010 at 10:38 AM by warrenbuckley, version 7

Comments

No comments yet.