Tutorial
This step-by-step tutorial will show you how to create a gadget and the steps to go through in order to have it translated.

In order to host your gadget or translate other gadgets, you must first register an account. Only the username and password are required. The other fields are optional, but will automatically be added to any new gadget you create, saving you time.



After registering, sign in and go to your gadgets page. It is initially empty, so create a new gadget by clicking "create one".


The name field will be used for the URL of your gadget. Spaces and a few other characters are not allowed. This will also be inserted as the title of your gadget, but you can easily change that after it is created. If you'll be having your gadget translated or localized, it is very important you correctly set the Language and Locale. Also, specify your Module Type. This is used to automatically create skeleton code for your gadget (although, you can easily change your gadget type after it has been created). If you select something besides HTML, be sure to fill in the extra fields.


After creating the gadget, you'll be taken back to your gadget page. From there, click on the name of your gadget to edit it. The URL link takes you to the published version of your gadget (once it has been published) while the Test URL takes you to the current version. Use the Test URL for testing, but give the normal URL to users.


This is the editing console for your gadget. "Save" saves the gadget, and should be done after making changes.

"Validate" runs an XML parser on the gadget to make sure it is valid XML, but doesn't guarantee that it is a proper Google Gadget. In order to have your Gadget translated, you'll need to insert message placeholders into the code:

Once you have done this, click "Edit Messages" and give values to all of your messages (in whatever language you specified while creating the gadget).




Be sure to click "Save Messages" at the very bottom of the screen, so that your work isn't lost.


When you are happy with your gadget, click "Save and Publish". This saves a copy of the current version and publishes it. This allows you to edit gadget behind the scenes while your users enjoy the stable version. Also, only published gadgets can be translated.

Note: Don't add any <Locale /> tags to your Gadget. They'll be automatically inserted for you, and specifying your own might break something.

Clicking the "Add to Google" button makes it easy to add the test version to your personalized homepage. I also recommend adding the Developer Gadget to make sure your test Gadget isn't cached. Anyway, click the "Save and Publish" button.


In order to translate a gadget, you must register and then click on Translate on the left. This takes you to the Translation console. To begin, select the languages you would like to translate to and from. If you are just doing a translation, I recommend leaving the localization as "Default". If, however, you would like to localize from say, American English to British English, then set the language to the same value and specify the destination locale. Click "Get Gadgets".

A list of Gadgets will appear. To translate one, click on the table row.

Translate all messages that you can. However, you only need to translate messages that are different in the new language. Google automatically falls back to the default language if any value is left empty. Once you are satisfied, click "Submit Translations" at the bottom of the list. The new translations won't go live (either on the web or in the translation list) until the Gadget author approves them.

As a Gadget author, if someone translates your gadget, you'll be notified the next time you visit your Gadget page.


The pending translation pages shows messages that have been submitted to you for approval. Click the checkbox next to each message you approve and click "Accept". If something is wrong, click the checkbox and press "Delete". Only click once, and give it a second for a response. Messages that were successfully modified will be removed from the list.


After approving translated messages, you'll see them in the Translate console and they'll also automatically go live on the internet.


Now you've created and translated your own Gadget. Encourage your foreign language speaking friends to create their own account and translate your Gadget. Also, submit your Gadget to the Gadget Directory for fame and fortune.