Trac Tweak UI

SEE:ZoomQuiet ~ Collection KSPEG Trac hacking

Description

• Its purpose is to implement a javascript deployment platform, which enable trac administrators to easy tweak trac pages by simply using javascript.
• It can apply different javascripts to different pages by matching regular expression.
• Support trac web admin

Bugs/Feature Requests

Existing bugs and feature requests for TracTweakUiPlugin are here.

If you have any issues, create a new ticket.

Download

Download the zipped source from here.

Source

You can check out TracTweakUiPlugin from here using Subversion, or browse the source with Trac.

Configuration

1. Uninstall Trac Tweak UI if you have installed before.

2. Change to the directory containning setup.py.

3. If you want to install this plugin globally, that will install this plugin to the python path:
   • python setup.py install

4. If you want to install this plugin to trac instance only:
   • python setup.py bdist_egg
   • copy the generated egg file to the trac instance's plugin directory

     cp dist/*.egg /srv/trac/env/plugins
     

5. Config trac.ini:

   [components]
   tractweakui.* = enabled
   

6. Add following directory structure to trac environment's htdocs directory(using editcc as example):

   htdocs/tractweakui/
   

Or you can simply copy the htdocs/tractweakui/ in source to trac environment's htdocs directory.

Example

Admin Trac Tweak UI with addon javascript plugins

1. Enter trac's Web Admin, select TracTweakUI Admin
2. Add url path(regular expression): /newticket
3. Select /newticket, then select filter editcc
4. Click Load Default, and edit filter javascript, then Save
5. Now click New Ticket to test the editcc javascript plugin.
   • Screenshot of Admin
     • 
   • Screenshot of editcc
     • 

Admin Trac Tweak UI with any other javascript plugins

1. take autocomplete for instance

1. Prepare autocomplete directory in trac environment

   mkdir /path/to/trac/environment/htdocs/tractweakui/autocomplete
   cp main.css /path/to/trac/environment/htdocs/tractweakui/autocomplete/
   cp jquery.autocomplete.css /path/to/trac/environment/htdocs/tractweakui/autocomplete/
   cp jquery.autocomplete.js /path/to/trac/environment/htdocs/tractweakui/autocomplete/
   cp jquery.bgiframe.min.js /path/to/trac/environment/htdocs/tractweakui/autocomplete/
   cp indicator.gif /path/to/trac/environment/htdocs/tractweakui/autocomplete/
   touch /path/to/trac/environment/htdocs/tractweakui/autocomplete/__template__.js
   

1. Edit template.js (optional)

   $(function() {
   	var months = ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December'];
   	$("#field-cc").autocomplete(months);
   });
   

1. Now, you can admin and test autocomplete javascript plugins as described above.

Related Plugins

• AddStaticResourcesPlugin - Attempting to accomplish many of the same goals in a different way. Very simple deployment and .ini configuration (no webadmin screens). Doesn't require and upgrade.

Recent Changes

[7413] by richard on 01/18/10 10:27:14

fixed #4912, output the javascript directly into the script tag rather than in a script tag.

[6335] by richard on 08/07/09 05:09:52

remove license.txt

[5514] by richard on 04/13/09 03:00:22

#4912

• unquote path_pattern, thanks for jason trahan.

[5180] by richard on 02/02/09 22:17:44

#4495 Try to fix setup.py package_data

Author/Contributors

Author: richard
Contributors: