helpSavannah Administration - Support: sr #110333, Add instructions for setting...


sr #110333: Add instructions for setting notifications

Submitter:  Tristan Miller <psychonaut>
Submitted:  Mon 19 Oct 2020 07:34:54 AM UTC
Category:  None Priority:  5 - Normal
Severity:  3 - Normal Status:  Done
Assigned to:  ineiev Operating System:  None
Open/Closed:  Closed
* Mandatory Fields

Add a New Comment (Rich Markup)

Comment Type & Canned Response:


Thu 17 Mar 2022 11:36:56 AM UTC, comment #2: 

Thank you, I've made the intro messages show up for the first tracker on the page.

Ineiev <ineiev>
Site Administrator
Mon 19 Oct 2020 07:47:34 AM UTC, comment #1: 

From reading the Savane source code in frontend/php/include/trackers/data.php, I can see that explanatory texts are indeed available for each field, though these are printed only when the variable $show_intro_msg is nonzero.  From glancing at the rest of the code and the online interface I can't tell what UI feature sets this variable so that the messages become visible.

Tristan Miller <psychonaut>
Mon 19 Oct 2020 07:34:54 AM UTC, original submission:  

The "Set Notifications" page of a given project contains various fields but no indication as to what they are for or what values they expect.  I couldn't find this information in the documentation either.  Even if I have overlooked the documentation (in which case, please point it out to me), I suggest that the actual notification page be improved as follows:

1. The page has several <h2> headings of the form "XXX Email Notification Settings", each followed by a text field and a checkbox.  By default the field seems to be populated with a username.  I assume that this is a list of usernames that receive notifications for the particular feature, though I shouldn't have to make this assumption.  Perhaps the headings should be changed so that they explicitly state the purpose of the field (e.g., "Users Receiving XXX Notifications").

2. For these same "Notification Settings" fields, there is no indication of the field format.  Is it even possible to have more than one username there? If so, what is the delimiter?  This should be documented near the field itself (e.g., "Separate multiple usernames with commas.")  If it's not possible to add or change a username (other than one's own), then why use an input field at all?

3. For these same "Notification Settings" fields, what is the checkbox for?  Does this turn notifications on and off for all the users? If so, this should be documented on this page by adding a label next to the checkbox (e.g., "Notifications enabled") and/or by adding a tooltip to it.

4. The page contains several <h2> headings titled "Private items exclude list".  Why do all these headings have exactly the same name?  If each of them is specific to a feature, then this should be part of the title: "Task Tracker Private Items Exclude List", etc.  Alternatively, there could be a single <h2> heading naming each feature (e.g., "Task Tracker Settings"), and then generic <h3> below it (e.g., "Users Receiving Notifications", "Private Items Exclude List").

5. These "Private items exclude list" all contain an input field.  What is it for?  Also usernames?  If so, the same UI/documentation improvements described above should be applied to it.

6. The page contains a "Reminders" heading with the text, "You can configure the project so that reminder emails get sent to project members who have opened items with priority higher than 5 assigned to them."  But the text never explains how or where the user can configure the project this way.  Is the "Frequency of reminders" setting meant to be this configuration setting?  If so, then the text should be changed to "Here you can configure the project..."

Tristan Miller <psychonaut>


(Note: upload size limit is set to 16384 kB, after insertion of the required escape characters.)

Attach Files:

No files currently attached


Depends on the following items: None found

Items that depend on this one: None found


Carbon-Copy List
  • -email is unavailable- added by ineiev (Posted a comment)
  • -email is unavailable- added by psychonaut (Submitted the item)

    There are 0 votes so far. Votes easily highlight which items people would like to see resolved in priority, independently of the priority of the item set by tracker managers.

    Only logged-in users can vote.





    Follow 3 latest changes.

    Date Changed by Updated Field Previous Value => Replaced by
    2022-03-17 ineiev StatusNone Done
        Assigned toNone ineiev
        Open/ClosedOpen Closed

    Back to the top

    Powered by Savane 3.9