Tags:
create new tag
, view all tags

TracOnTWikiContrib

Integrate the best of Trac into TWiki

Introduction

TWiki has been a long standing wiki champion in the industry, whilst Trac has proven to be a widely adopted software project management tool. Both has its strengths and weaknesses to which this Contrib integrates the best of both worlds!

This Contrib adds to Trac's database (and keeps up to date) the username and email address of TWiki users, and enables Trac to use the login functionality of TWiki. Thus a user that is logged into TWiki is automatically logged into Trac. TWiki users in %USERWEB%.TWikiAdminGroup will automatically have administration privileges (TRAC_ADMIN) in Trac.

TWiki:Plugins.PatternSkin, TWiki:Plugins.NatSkin, and TWiki:Plugins.MoveableTypeSkin, are also ported to Trac for seamless UI integration.

A search feature is planned for the future to integrate both applications.

Installation Instructions

Pre-requisites

  1. On your TWiki, have an existing user in TWikiAdminGroup.
  2. A working Trac installation.
  3. A working installation of Web Admin UI from SVN
  4. A working installation of Theme Engine Plugin from SVN
  5. If you are using TWiki:Plugins.BugsContrib, then disable Trac's wiki and ticketing system.
            [components]
            #disable the wiki part
            trac.wiki.* = disabled
            #disable the ticketing & milestones
            trac.ticket.* = disabled
          

Installation of TracOnTWikiContrib

This Contrib requires CPAN modules - DBI and DBD::SQLite

  • Debian - apt-get install libdbd-sqlite3-perl libdbi-perl libnet-daemon-perl libplrpc-perl

You do not need to install anything in the browser to use this extension. The following instructions are for the administrator who installs the extension on the server where TWiki is running.

Automatic installation

Like many other TWiki extensions, this module is shipped with a fully automatic installer script written using the BuildContrib.

  • Automatic installation from the configure interface (Plugins -> Find More Extensions)
    • See the installation supplement on TWiki.org for more information.
    • In configure, modify the settings accordingly,
      • under User Managers,
        • {Plugins}{TracOnTWikiContrib}{Domain}
        • {Plugins}{TracOnTWikiContrib}{DBI_dsn}
        • {Plugins}{TracOnTWikiContrib}{DBI_username}
        • {Plugins}{TracOnTWikiContrib}{DBI_password}
      • under Security setup -> Authentication,
        • modify {LoginManager} to TWiki::LoginManager::TracOnTWikiLogin

Manual installation

  • Manual installation from the command-line:
    1. Download one of the .zip or .tgz archives
    2. Unpack the archive in the root directory of your TWiki installation.
    3. Run the installer script ( perl <module>_installer )
    4. In configure, modify the settings accordingly,
      • under User Managers,
        • {Plugins}{TracOnTWikiContrib}{Domain}
        • {Plugins}{TracOnTWikiContrib}{DBI_dsn}
        • {Plugins}{TracOnTWikiContrib}{DBI_username}
        • {Plugins}{TracOnTWikiContrib}{DBI_password}
      • under Security setup -> Authentication,
        • modify {LoginManager} to TWiki::LoginManager::TracOnTWikiLogin

Setting up TWiki skins

  1. To install TracOnTWikiContrib themes (MoveableTypeSkin, NatSkin, PatternSkin) into Trac,
            cd /path/to/TracOnTWikiContrib/trac/MoveableTypeSkin/
            EDIT moveabletypeskintheme/templates/css.cs to add your TWiki's css
            EDIT moveabletypeskintheme/templates/header.cs to customise, header, body and sidebar
            EDIT moveabletypeskintheme/templates/footer.cs to customise your footer
            python setup.py bdist_egg 
            easy_install -Z dist/*.egg
          
  2. Enable the theme in Trac's Admin -> Plugins
  3. Select the theme in Trac's Admin -> Themes

Troubleshooting

  1. Reboot Apache if the plugins and themes are not visible or working in Trac.
  2. Make sure that the file permissions allow the webserver user (www-data or httpd) to access all files. See TWiki:TWiki.SettingFileAccessRightsLinuxUnix
  3. Check in any installed files for existing ,v files in your installation.
  4. Manually edit LocalSite.cfg to set any configuration variables.

Additional integrations

Trac Hacks has many plugins and customisations that can be applied to Trac. Some of them can be used to better integrate TWiki and Trac.

TWiki - InterwikiPlugin

Trac - DelegatedWikiPlugin

DelegatedWikiPlugin allows you to redirect all Trac links to a specific TWiki url

Trac - AutoWikifyPlugin

AutoWikifyPlugin allows you to link a large set of non-CamelCase words (e.g. TWiki's bug tracking system with the style of Bugs.Item1234) to TWiki. You'd need to modify autowikify.py to remove the escaping of regex strings:

Replace pattern = r'\b(?P' + '|'.join([re.escape(page) for page in pages]) + r')\b'
with pattern = r'\b(?P' + '|'.join([page for page in pages]) + r')\b'

Contrib Info

Many thanks to the following sponsors for supporting this work:

Contrib Author(s): TWiki:Main.SvenDowideit - SvenDowideit@distributedINFORMATIONPLEASENOSPAM.com a WikiRing founding partner
Copyright: © SvenDowideit@distributedINFORMATIONPLEASENOSPAM.com
License: GPL (Gnu General Public License)
Contrib Version: 100 (03 Dec 2007)
Change History:  
Initial release: November 2007
Dependencies:
NameVersionDescription
DBI>=1.35Required
DBD::SQLite>=1.14Required
Contrib Home: http://twiki.org/cgi-bin/view/Plugins/TracOnTWikiContrib
Feedback: http://twiki.org/cgi-bin/view/Plugins/TracOnTWikiContribDev
Appraisal: http://twiki.org/cgi-bin/view/Plugins/TracOnTWikiContribAppraisal

Related Topics: TWikiContribs, DeveloperDocumentationCategory, AdminDocumentationCategory, TWikiPreferences

Topic attachments
I Attachment History Action Size Date Who Comment
Unknown file formatmd5 TracOnTWikiContrib.md5 r1 manage 0.2 K 2008-03-18 - 04:45 SvenDowideit  
Compressed Zip archivetgz TracOnTWikiContrib.tgz r1 manage 406.8 K 2008-03-18 - 04:44 SvenDowideit  
Compressed Zip archivezip TracOnTWikiContrib.zip r1 manage 414.3 K 2008-03-18 - 04:44 SvenDowideit  
Unknown file formatEXT TracOnTWikiContrib_installer r1 manage 4.8 K 2008-03-18 - 04:45 SvenDowideit  
Edit | Attach | Watch | Print version | History: r5 < r4 < r3 < r2 < r1 | Backlinks | Raw View | Raw edit | More topic actions
Topic revision: r5 - 2012-12-03 - PeterThoeny
 
  • Learn about TWiki  
  • Download TWiki
This site is powered by the TWiki collaboration platform Powered by Perl Hosted by OICcam.com Ideas, requests, problems regarding TWiki? Send feedback. Ask community in the support forum.
Copyright © 1999-2015 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.