wiki:AddStaticResourcesPlugin

Version 3 (modified by Russ Tyndall, 14 years ago) (diff)

Added trac 12 version stuff

AddStaticResourcesPlugin

Description

A plugin that maps static resources into urls of your choice. Thus if you wish to add a stylesheet or a javascript to an existing trac page, you can specify in the trac ini a regex that matches the urls of the pages and insert the resources. Just add your static resources to the plugins htdocs folder and install then fill out the trac.ini configuration values to enable your static resources on each page you wish.

[static_resources]
url-regex = list_of_files.js, and_style.css

Installation Help

  1. Insert your static files into the 'addstaticresourcesplugin/htdocs' folder of the plugin before install
  2. Install the plugin (either for a single project, or globally). See the details on how to install a trac plugin at: TracPlugins
  3. Be sure that the plugin is enabled. Add "addstaticresourcesplugin.* = enabled" to trac.ini (in the [components] subheading).
    • Alternatively, this can be enabled in the Web Admin section of the website as well
  4. Reload/restart your HTTPD / other webserver / Tracd. That's it.

Related Plugins

TracTweakUiPlugin

This plugin is trying to accomplish much of what TracTweakUiPlugin is, however I had some goals that were not being met by TracTweakUiPlugin.

  • Simple, I want to simply map a url to a javascript/stylesheet that should be included.
  • Affect all tracs at once
    • I have many tracs so specifying this once in the shared conf file is much nicer than once in each database
    • Deployment of files should be simple and preferably in the egg we are already installing, rather than in a static location I need to keep track of and separately manage for each trac.

Bugs/Feature Requests

Existing bugs and feature requests for AddStaticResourcesPlugin are here.

If you have any issues, create a new ticket.

Download & Source

The trac 11 branch seems to work fine in trac 12, if you experience any issues please report them Download the zipped source:

  • [download:addstaticresourcesplugin ZIP].

SVN:

or browse the source with Trac.

Example

This will cause the helloworld alert message to appear on the ticket and newticket pages.

[static_resources]
/(new)?ticket = helloworld.js

Recent Changes

14167 by bobbysmith007 on 2014-09-12 20:24:12
Allow using absolute refrences to static-resources
13436 by bobbysmith007 on 2013-11-08 16:52:52
New version of addstaticresourcesplugin that interacts better with trac 1.0 and is a bit simpler
13435 by bobbysmith007 on 2013-11-08 16:38:12
initing 1.0 branch
(more)

Author/Contributors

Author: bobbysmith007
Maintainer: bobbysmith007
Contributors: