[[PageOutline(2-5,Contents,pullout)]]

= Prevent loss of unsaved form data

== Description

This plugin prevents unsaved form data loss by providing a restore button to context-navigation.

Suppose you write a lengthy wiki page, but accidentally hit refresh or the back button. With this plugin, a link called "Restore Form" will allow you to retrieve your data from your last save. Any time you navigate away from a form page, the contents will be saved in a cookie and when you return to it, you can simply click "Restore Form" to retrieve it.

Screenshot of the "Restore Form" link with German localization ("Wiederherstellen") provided by DataSaverPlugin within Trac 0.12:

[[Image(ticket:7518:datasaver_screenshot_2-0-0_ctxtnav-patched.png, border=2)]]

It could previously be found among the meta-navigation bar, but was moved since changeset [8702], see #7518 for details.

== Bugs/Feature Requests

If you have any issues, check existing bugs and feature requests 
[report:9?COMPONENT=DataSaverPlugin here].

In case this is a new issue, you're welcome to create a 
[/newticket?component=DataSaverPlugin new ticket].

Patches welcome in favor of complete files, in case you have already developed some better code.
Include version, if patch is ''not'' against current stable release or `trunk` development version.

[[TicketQuery(component=DataSaverPlugin&group=type,format=progress)]]

== Download

Download the zipped source from [export:datasaverplugin here].

== Source

You can check out DataSaverPlugin from [/svn/datasaverplugin here] using Subversion,
or [source:datasaverplugin browse the source] with Trac.

== Installation

General instructions on installing Trac plugins can be found on the [TracPlugins#InstallingaTracplugin TracPlugins] page.

If you are taking the install-into-Python route, add the following to your `trac.ini` file:
{{{#!ini
[components]
datasaver.* = enabled
}}}

== About i18n/l10n support

The development version of this plugin is prepared for localization.[[BR]]
But English message texts are still the (POSIX) default. If this isn't your preferred language, you can
 1. check if it is already available from the [TracPluginTranslation Trac plugin l10n project] at [http://www.transifex.net/projects/p/Trac_Plugin-L10N/resource/datasaver Transifex] or
 2. do it yourself, see the [http://trac.edgewall.org/wiki/CookBook/PluginL10N#Dotranslatorswork l10n cookbook page for Trac plugins] for more details.

Contributing your translation is highly appreciated.[[BR]]
You could send it to the plugin's maintainer or contribute to [TracPluginTranslation Trac plugin l10n project]
via [http://www.transifex.net/projects/p/Trac_Plugin-L10N/ Transifex]:

Top translations: Trac_Plugin-L10N » [http://www.transifex.net/projects/p/Trac_Plugin-L10N/resource/datasaver/ datasaver][[BR]]
 [[Image(http://www.transifex.net/projects/p/Trac_Plugin-L10N/resource/datasaver/chart/image_png, title=Go to Trac_Plugin-L10N project page on Transifex.net, link=http://www.transifex.net/projects/p/Trac_Plugin-L10N/resource/datasaver/)]]
Top translations: Trac_Plugin-L10N » [http://www.transifex.net/projects/p/Trac_Plugin-L10N/resource/datasaver-js/ datasaver-js][[BR]]
 [[Image(http://www.transifex.net/projects/p/Trac_Plugin-L10N/resource/datasaver-js/chart/image_png, title=Go to Trac_Plugin-L10N project page on Transifex.net, link=http://www.transifex.net/projects/p/Trac_Plugin-L10N/resource/datasaver-js/)]]
Kindly provided by [[Image(https://ds0k0en9abmn1.cloudfront.net/static/charts/images/tx-logo-micro.png, link=http://www.transifex.net/, title=the open translation platform, valign=bottom)]]

Preparing the plugin from source requires the additional step of compiling message catalog files. This will be done automatically by invoking a suitable Babel install. Walk through:
{{{
#!sh
cd datasaver
python ./setup.py compile_catalog -f
python ./setup.py bdist_egg
}}} 

Step 2 is almost obsolete, and only needed to include translations marked as `# fuzzy` by the translator, since
the compilation before packaging will do message catalog compilation compile only without the extra `-f` argument.
Again, for more details see the [t:wiki:CookBook/PluginL10N#Compileanduseit l10n cookbook page for Trac plugins].

== Recent Changes

[[ChangeLog(datasaverplugin, 3)]]

== Author/Contributors

'''Author:''' [wiki:rharkins][[BR]]
'''Maintainer:''' [[Maintainer]][[BR]]
'''Contributors:''' [wiki:jun66j5]