Differences

This shows you the differences between two versions of the page.

--- services:trac [2011/10/04 18:46]
giunta [Hook Scripts]
+++ — (current)
@@ Line 1: / Line 1: @@
-====== SISSA Trac Server ======
-===== How to manage an SVN repository =====
-  * Go to the web address
-  http://trac.sissa.it/svn/name_of_the_repository
-where //name_of_the_repository// is the name of repository that you manage (in our example, the name of the repository will be //repos// thus the address becomes ''%%http://trac.sissa.it/svn/repos%%'')
-  * Click ''Login'' button on the right
-{{ :services:trac:border-login_button.png?nolink& |}}
-  * Insert ''Username'' and ''Password''
-{{ :services:trac:border-login_form.png?nolink& |}}
-  * You are now logged-in. Since you are the administrator of the repository you can now see the ''Admin'' button on the right
-{{ :services:trac:border-admin_button.png?nolink& |}}
-  * Click on ''Admin'' button to modify users and/or rules of your repository
-{{ :services:trac:border-admin_page.png?direct&1000 |}}
-==== User management ====
-To add/remove a user or modify a user's password:
-Click on ''Users'' button on the right menu
-{{:services:trac:border-admin_menu_users.png?nolink&|}}
-The list of all users will appear (in our case there is only the user //Mario Rossi// who is the owner of the repository)
-{{:services:trac:border-admin_users_list.png?nolink&|}}
-To create a new account, fill in ''Add account'' form, on the right:
-  * ''username''
-  * ''password'' (that **MUST** be different from the SISSA password if you are a SISSA user!)
-  * ''name''
-  * ''email address'' (not necessarily a SISSA address)
-and click ''Add'' button:
-{{:services:trac:border-admin_add_account.png?nolink&|}}
-You can now see the new account and the corresponding details on the list:
-{{:services:trac:border-admin_newusers_list.png?nolink&|}}
-In this page you can also change the password of a user by filling the ''Change Password'' form (on the right). This can be useful e.g. if a user forgets his password.
-{{:services:trac:border-admin_password.png?nolink&|}}
-To remove an account tick the corresponding name and the press the ''Remove selected accounts'' button.
-{{:services:trac:border-admin_remove_users.png?nolink&|}}
-==== Permission ====
-To manage users' permissions click on ''Access Rights'' on the left:
-{{:services:trac:border-admin_menu_access.png?nolink&|}}
-Clicking on the root path:
-{{ :services:trac:border-root_path.png?direct&1000 |}}
-you can now see only the owner of the repository that has permissions to read and write in all the repository, while all the others (*) can't do anything.
-Notice that the permissions on a folder are automatically extended to all the corresponding subfolder (so if a user has permission on the root they are automatically extended to all the repository).
-{{ :services:trac:border-path_owner.png?direct&1000 |}}
-If you want a new user (eg. //Giuseppe//) to be able to read/write in one of the subfolder:
-  * Go to ''Add path'' form, select the desired folder and click ''Add'' button
-{{:services:trac:border-add_path.png?nolink&|}}
-The selected folder is now present in the ''Subversion Paths'' table
-{{ :services:trac:border-new_add_path.png?direct&1000 |}}
-  * Click on the name of the folder, then go to ''Add path members'' form, select the subject you want to modify the permits of  what he is allowed to do and click ''Add''
-{{ :services:trac:border-modify_permits.png?direct&1000 |}}
-The added member will now appear in the ''Path member'' table
-{{ :services:trac:border-modify_permits_new_user.png?nolink& |}}
-If you want further modify only some permits you can tick/untick the corresponding space and then ''Change path members'', to delete all the defined permits of a user select ''Remove'' (on the left of the table) and ''Change path members''.
-If you define a user without adding any permission that user won't have any permission on that folder, even those defined for the root folder.
-==== Hook Scripts ====
-Clicking on ''Hooks Files'' on the left menu you can modify what the system does when something changes.
-{{:services:trac:border-admin_menu_hooks.png?nolink&|}}
-A typical example can be sending an e-mail to a people when the data in a folder are modified.
-In ''Add email modification'' form on the right
-{{ :services:trac:border-add_email.png?direct&800 |}}
-you can choose the prefix of the subject of the email that will be sent, in ''Path filter'' you can select the folder for which you want to send an email in case it is modified.
-You can then select users and click add email, or write directly the email address in the ''Email'' field:
-{{:services:trac:border-insert_email.png?nolink&|}}
-Then click on ''Add''; the defined changes will appear in the central field
-{{:services:trac:border-hook_final.png?nolink&|}}
-clicking on ''Apply changes'' you can save the newly defined email notification, otherwise selecting ''Reset'' you can cancel it.