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

= Edit files from within Trac

== Description

This is a plugin that allows Trac administrators (`TRAC_ADMIN`) to edit files on the Trac server. The editable files can be specified in the configuration file. Paths may be absolute, or relative to the Trac environment. The user running the server must have appropriate permissions for the files in order to view or save them.  

Sample `trac.ini` file with the editable files listed in the custom `[edit_file]` section:
{{{#!ini
[edit_file]
files = conf/trac.ini, /home/matt/public_html/notebook/TRACI/auth.db
}}}

'''Note''': Relative paths will be computed relative to the location of `trac.ini`. Most Trac instances are laid out with folders like `conf/`, `db/`, `htdocs/` and so on. If your `trac.ini` file is in an odd place, this may not work the way you expect and you might want to use absolute paths instead. 

== Bugs/Feature Requests

Existing bugs and feature requests for EditFilesPlugin are 
[report:9?COMPONENT=EditFilesPlugin here].

If you have any issues, create a 
[/newticket?component=EditFilesPlugin new ticket].

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

== Download

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

== Source

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

== Installation

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

== Recent Changes

[[ChangeLog(editfilesplugin, 3)]]

== Author/Contributors

'''Author:''' [wiki:mvr] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:''' dnedelchev (patches)