trac-11.6-wiki-install-plugins
http://trac-hacks.org/wiki/PrivateTicketsPlugin http://trac-hacks.org/wiki/TicketDeletePlugin http://trac.edgewall.org/wiki/TracPlugins
-
-
-
-
-
-
-
-
-
-
- DOWNLOAD - - - - - - - - - - - download the source (usually in .zip files) if necessary upload the zip to your server using ftp/sftp (ssh!)
-
-
-
-
-
-
-
-
-
unzip filename (without the .zip, use unzip --help for examples)
unzip pluginname.zip cd pluginname/0.11 cat README
Then enter the plugin directory with the "setup.py" file (requires Python installed)...
python setup.py bdist_egg
Your new "egg" is now in the directory: dist/pluginname.egg
permissions?
cp pluginname/dist/pluginname.egg /trac-root/projects/trac/projectname/plugins
chmod 640 /trac-root/projects/trac/projectname/plugins/ chown root:apache /trac-root/projects/trac/projectname/plugins/
-
-
-
-
-
-
-
-
-
-
- INSTALL - - - - - - - - - - -
-
-
-
-
-
-
-
-
-
easy_install pluginname.egg
Then restart your web server /etc/init.d/httpd reload (... or apache2 reload ) /etc/init.d/httpd restart
-
-
-
-
-
-
-
-
-
- ENABLE - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
-
-
-
-
-
-
Log onto your trac installation as the TRAC_ADMIN , go to the ADMIN section -> Plugins
Choose the Plugin and choose the Enable checkbox
-
-
-
-
-
-
-
-
-
-
- CONFIGURE - - - - - - - - - - - - - - - -
-
-
-
-
-
-
-
-
-
Verify the configuration LOGGING ON and checking Admin -> Permissions Action drowpdown should now contain TICKET_VIEW_SELF
There are three main permissions for this plugin: TICKET_VIEW_REPORTER, TICKET_VIEW_CC, and TICKET_VIEW_OWNER.
TICKET_VIEW_SELF is an alias for all three of these, assign it to a Group or User.
Be sure to not grant TICKET_VIEW to anonymous, or unauthenticated users will be able to see all tickets.
An example configuration for a user to be able to Create, Append, and see their own tickets (in a nice Report View called "View Tickets")
REPORT_VIEW TICKET_APPEND TICKET_CREATE TICKET_VIEW_OWNER TICKET_VIEW_REPORTER TICKET_VIEW_SELF WIKI_VIEW
-
-
-
-
-
-
-
-
-
- VERIFY PRIVATEWIKI & TICKETDELETE & PRIVATEWIKI- - - - - - - - - - - - - - - - - - (edit the text configuration file which has sections sorted alphabetically) nano /trac-root/projects/trac/projectname/conf/trac.ini
-
-
-
-
-
-
-
-
[components]
privatetickets.* = enabled
privatewiki.api.privatewikisystem = enabled
ticketdelete.* = enabled
[privatetickets] group_blacklist = anonymous, authenticated, labusers
[privatewikis] private_wikis=CUSTOMERS_ONLY,FOOBAR_INFO
[trac] -- old settings
permission_policies = DefaultPermissionPolicy, LegacyAttachmentPolicy
[trac] permission_policies = PrivateWikiSystem, PrivateTicketsPolicy, DefaultPermissionPolicy, LegacyAttachmentPolicy
-
-
-
-
-
-
-
-
-
- VERIFY TICKETDELETE - - - - - - - - - - - - - - - - - -
-
-
-
-
-
-
-
-
trac-admin ticket remove #
(yup, just find the ticket number and remove it from the command line)
This may not always work: Ticket System -> Delete Changes allows you to Submit a Ticket ID
-
-
-
-
-
-
-
-
-
- VERIFY PRIVATEWIKIS - - - - - - - - - - - - - - - - - -
-
-
-
-
-
-
-
-
Log in to your Administration section (Admin on the right) and choose Permissions You can now "Grant Permissions" to a Subject (e.g. user@email.com) with the Action PRIVATE_VIEW_FOOBAR
Users/Groups without that permission will not be able to see pages
create any new private & protected Wiki pages (case insensitive) [wiki:foobar] [wiki:FOOBAR]
-
-
-
-
-
-
-
-
-
- VERIFY ACCOUNTMANAGER - - - - - - - - - - - - - - - - - -
-
-
-
-
-
-
-
-
Log in to your Administration section (Admin button on the right) On the left in GENERAL you should see PLUGINs
click on TracAccountManager 0.2.1dev to expand it The checkboxes allow you to enable different features (which modifies trac.ini for you)
BEGIN WITH:
AccountManagerAdminPage acct_mgr.admin
AccountManagerAdminPage acct_mgr.admin
HtPasswdStore acct_mgr.htfile
Once you've enabled these checkboxes click on the APPLY CHANGES button (auto refreshes your browser) On the left in ACCOUNTS you should see CONFIGURATION
Set the number to be 1 set the filename, e.g. /trac-root/projects/trac/projectname/projects.password click SAVE
AT THE SSH CONSOLE...
this assumes that you've been using HTTP htpasswd authentication with apache copy your current projects.password file and ensure that it's in the CONFIGURATION location above
if you're creating it from scratch use htpasswd --help
Also ensure apache/www-data user has permissions chown apache /trac-root/projects/trac/projectname/projects.password chmod 660 /trac-root/projects/trac/projectname/projects.password
LIST all of the current users and passwords cat /trac-root/projects/trac/projectname/projects.password
BACK AT THE TRAC WEB ADMIN
Log in to your Administration section (Admin button on the right) On the left in GENERAL you should see ACCOUNTS -> USERS
the users listed should mirror what you already saw with the "cat" command earlier create a user with the webform and then compare it by running the console command again:
cat /trac-root/projects/trac/projectname/projects.password
NEXT you must update your http.conf (or default file in debian/ubuntu) nano /etc/httpd/conf/httpd.conf
It's probably a good idea to restart your web server /etc/init.d/httpd reload (... or apache2 reload ) /etc/init.d/httpd restart
-
-
-
-
-
-
-
-
-
-
- ACCOUNT MANAGER CHANGE PASSWORD - - - - - - - - - - - - - - - - Enable the following to allow users to change their own passwords (necessary for the RESET PASSWORD feature below)
-
-
-
-
-
-
-
-
-
AccountModule acct_mgr.web_ui
VERIFY by logging in as a user and clicking on PREFERENCES (upper right) Then click on the Account tab
-
-
-
-
-
-
-
-
-
-
- LOGIN PAGE INSTEAD OF HTTP POPUP - - - - - - - - - - - - - -
-
-
-
-
-
-
-
-
-
To use the AccountManager's form-based login system instead, modify nano trac.ini
[components]
trac.web.auth.LoginModule = disabled
If you have previously enabled authentication for Trac on Apache, you will need to disable it or Apache will popup the username/password dialog and you will be unable to use the HTML form.
To disable it delete or comment out the "require valid user" part...
Wiki Context Navigation
Error: Not Found No handler matched request to /trac/projectname
-
-
-
-
-
-
-
-
-
-
- ACCOUNT MANAGER RESET PASSWORD - - - - - - - - - - - - - - - -
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- VERIFY TRAC.INI - - - - - - - - - - - - - - - -
-
-
-
-
-
-
-
-
-
trac.ini is (mostly) modified automatically by the web admin but you might want to ensure:
[account manager] password_file = /trac-root/projects.passwd password_store = HtPasswdStore
[account-manager] force_passwd_change = true password_file = /trac-root/projects/trac/projectname/projects.password password_store = HtPasswdStore persistent_sessions = true
[components] acct_mgr.admin.accountmanageradminpage = enabled acct_mgr.api.accountmanager = enabled acct_mgr.htfile.htpasswdstore = enabled acct_mgr.web_ui.accountmodule = enabled acct_mgr.web_ui.loginmodule = enabled privatetickets. = enabled privatewiki.api.privatewikisystem = enabled ticketdelete. = enabled
-
-
-
-
-
-
-
-
-
-
- UNINSTALL - - - - - - - - - - - - - - - -
-
-
-
-
-
-
-
-
-
easy_install -m TracPrivateTickets.egg
delete the .egg
-
-
-
-
-
-
-
-
-
-
- TROUBLESHOOTING - - - - - - - - - - -
-
-
-
-
-
-
-
-
-
At least one WIKI_ADMIN user!
trac-admin /trac-root/projects/trac/projectname/ permission list trac-admin /trac-root/projects/trac/projectname/ permission add testuser TRAC_ADMIN
does your apache/www-data user have permission to modify the trac.ini file? does your apache/www-data user have permission to read/execute the /plugins directory?
(update permissions to ensure apache/httpd can access files, note ubuntu user = www-data) chown -R apache /trac-root/projects/trac/projectname/plugins
chmod 640 /trac-root/projects/trac/projectname/plugins/*
Trac detected an internal error: AttributeError: TracError instance has no attribute 'acctmgr'
SOLVED: When I tried to delete a user it told me that trac needed read/write permissions on not only the user-auth file, but also the parent directory of this file.
Giving read/write to the parent (containing) directory of the htdigest.user-auth file (in my case /trac-root/user-auth.htaccess), eliminated this error!
Wiki
Context Navigation
--------------------------------------------------------------------------------
Error: Not Found
No handler matched request to /trac/projectname
Your trac.ini file needs to be updated with the correct base_url (i.e. the full absolute path)
[project] admin = descr = Please reply to this email via TRAC. footer = icon = common/trac.ico name = PROJECT NAME url = http://download.domain.co.uk/trac/projectname
[trac] authz_file = authz_module_name = auto_reload = False base_url = http://download.domain.co.uk/trac/projectname check_auth_ip = true database = sqlite:db/trac.db default_charset = iso-8859-15 htdocs_location = ignore_auth_case = false mainnav = wiki,timeline,roadmap,browser,tickets,newticket,search metanav = login,logout,prefs,help,about permission_policies = PrivateWikiSystem, PrivateTicketsPolicy, DefaultPermissionPolicy, LegacyAttachmentPolicy permission_store = DefaultPermissionStore repository_dir = repository_type = show_email_addresses = false timeout = 20 use_base_url_for_redirect = True
ALSO, update max size to 125 MB (for larger downloads) max_size = 125829120