|
1 |
| -# gitbucket-notifications-plugin |
| 1 | +# gitbucket-notifications-plugin |
| 2 | + |
| 3 | +**This plug-in is still experimental.** |
| 4 | + |
| 5 | +This plug-in provides notifications feature on GitBucket. |
| 6 | + |
| 7 | +Plugin version | GitBucket version |
| 8 | +:--------------|:-------------------- |
| 9 | +1.0.x | 4.15.x |
| 10 | + |
| 11 | +## Features |
| 12 | + |
| 13 | +The current version of plug-in provides features such as: |
| 14 | + |
| 15 | +- Pre-included notifications (see below) |
| 16 | +- Watching repositories |
| 17 | +- Subscribing to issues |
| 18 | + |
| 19 | +### Pre-included notifications |
| 20 | + |
| 21 | +GitBucket can send email notifications to users if this feature is enabled by an administrator. |
| 22 | + |
| 23 | +You'll automatically receive these notifications when: |
| 24 | + |
| 25 | +- Opened issues (new issues, new pull requests) |
| 26 | + - When a record is inserted into the ```ISSUE``` table |
| 27 | +- Comments |
| 28 | + - Among the records in the ```ISSUE_COMMENT``` table, them to be counted as a comment (i.e. the record ```ACTION``` column value is "comment" or "close_comment" or "reopen_comment") are inserted |
| 29 | +- Updated state (close, reopen, merge) |
| 30 | + - When the ```CLOSED``` column value is updated |
| 31 | + |
| 32 | +Notified users are as follows: |
| 33 | + |
| 34 | +- individual repository's owner |
| 35 | +- group members of group repository |
| 36 | +- collaborators |
| 37 | +- participants |
| 38 | + |
| 39 | +However, the person performing the operation is excluded from the notification. |
| 40 | + |
| 41 | +### Watching repositories |
| 42 | + |
| 43 | +When you watch a repository, you get notifications. |
| 44 | +You can unwatch a repository to receive notifications when participating. |
| 45 | +If you won't receive any notifications, you select Ignoring. |
| 46 | + |
| 47 | +### Subscribing to issues |
| 48 | + |
| 49 | +You can subscribe or unsubscribe to individual issues. |
0 commit comments