= Screenshots Plugin = == Description == Provides components and versions related screenshots storage and viewing system for Trac. With SCREENSHOTS_ADMIN permission you can append or delete screenshots to appropriate component and version defined with trac-admin command-line tool or via WebAdminPlugin. With SCREENSHOTS_VIEW premission main navigation bar button for ScreenshotsPlugin is displayed and provides link to screenshots gallery view. == Bugs/Feature Requests == Existing bugs and feature requests for ScreenshotsPlugin are [report:9?COMPONENT=ScreenshotsPlugin here]. If you have any issues, create a [http://trac-hacks.org/newticket?component=ScreenshotsPlugin&owner=Blackhex new ticket] but read BugReporting page first, please. == Download == Download the zipped source from [download:screenshotsplugin here]. == Source == You can check out ScreenshotsPlugin from [http://trac-hacks.org/svn/screenshotsplugin here] using Subversion, or [source:screenshotsplugin browse the source] with Trac. == Installation == Install plugin's egg and set path and title variable in trac.ini configuration file. component and version config variables can set default component and version viewed when Screenshots main navigation menu button clicked. show_name config variable could be used to disable or enable display of screenshot name and author at the top. Default value is true. {{{ [screenshots] title = Screenshots path = component = version = show_name = true/false }}} If you run Trac in environment which needs to enable plugins explicitly put in trac.ini these lines: {{{ [components] tracscreenshots.init.screenshotsinit = enabled tracscreenshots.core.screenshotscore = enabled tracscreenshots.api.screenshotsapi = enabled tracscreenshots.wiki.screenshotswiki = enabled tracscreenshots.tags.screenshotstags = enabled }}} If you don't have TagsPlugin installed replace last line with {{{ tracscreenshots.tags.screenshotstags = disabled }}} The next step is to upgrade your environment: {{{ # trac-admin upgrade }}} == Important == For running this plugin you have to have [http://www.imagemagick.org ImageMagick] tools and Python Image Language (PIL) installed on your system. == Macros == There are macro ![screenshot:] for screenshots referencing. Expample of usage is here: {{{ [screenshot:1] [screenshot:1 screenshot] }}} == Note == There is wrong display of plugin's content in Internet Explorer because of missing implementation of "display: table-cell" CSS style so please use standard browsers or tell me how to fix it :-). == Screenshot == If you properly install ScreenshotsPlugin you could see something like this: [[Image(tracscreenshots-0.1.jpg)]] == Feedback == [[Poll(Are you using this plugin?; Yes, it's usefull.; No, it's useless.; No, I don't need it.)]] == Change Log == [[ChangeLog(/screenshotsplugin, 5)]] == Author/Contributors == '''Author:''' [wiki:Blackhex] [[BR]] '''Contributors:'''