[[PageOutline(2-5,Contents,pullout)]] = Publish notices {{{#!box info '''Note''': This plugin requires the [wiki:TestManagerForTracPluginGenericClass Trac Generic Class plugin] v. 1.1.1+, which is part of TestManagerForTracPlugin. Download it [https://sourceforge.net/projects/testman4trac/ here], then [build and] install the !TracGenericClass.egg file into Trac before installing the Notice Publisher plugin. }}} == Description This is a plugin to display notices to a user visiting any page in Trac. This is useful to bring all users' attention on news that may affect them, like the system going down, a solution to a common problem, and so on. Notices can contain Wiki-formatted syntax, thus allowing for rich content. Notices can have an expiration, expressed in hours, after which they automatically disappear. In addition to the automatic expiration, each notice has a '''Close''' icon, allowing each User to close it. The plugin remembers each User closing a Notice and will not show it again to that User. A Notice Administration panel allows for showing which notices are active and their expiration time, and for deleting them. === Publishing a new Notice To publish a new Notice, click the '''Publish Notice''' tab in the upper-right Trac navigation bar, then fill the required information, as shown in the following figure. Notices have a severity, Informational, Success, Warning and Error, which determine the Notice icons. Notices have a title and a Text. You can use WikiFormatting in the Notice text. Note that you have a limited space for your contents, about 4 lines of text. You can also specify an expiration, expressed in hours, after which the Notice will automatically disappear for every User. Do not specify an expiration for a permanent Notice. Note that you can always remove Notices from the '''Notices Admin''' panel. In addition to the automatic expiration, each notice has a '''Close''' icon, allowing each User to close it. The plugin remembers each User closing a Notice and will not show it again to that User. Clicking '''Publish''' will publish the new Notice, as shown in the next figure. The new Notice will be shown on every Trac page of every User, as soon as they refresh or navigate to a different Trac page. '''Publishing a new Notice:''' [[Image(notice_01.png, border=2)]] '''How the Notice appears:''' [[Image(notice_02.png, border=2)]] === Notices Administration To manage Notices, click on the '''Admin Notices''' tab in the upper-right Trac navigation bar. The Notice Administration panel, shown in the following figure, lists the active notices and displays the expiration time of each. To permanently remove a Notice for all Users, click the '''X''' icon. '''The Notices Administration panel:''' [[Image(notice_05.png, border=2)]] === Plugin permissions The Notice management capabilities are protected by a set of new Trac permissions: * `NOTICE_PUBLISH`: Allows for creating Notices. * `NOTICE_VIEW`: Allows for viewing Notices. * `NOTICE_ADMIN`: Allows access to the Notices administration panel, to list Notices and delete them. == Bugs/Feature Requests Existing bugs and feature requests for NoticePublisherPlugin are [report:9?COMPONENT=NoticePublisherPlugin here]. If you have any issues, create a [/newticket?component=NoticePublisherPlugin new ticket]. [[TicketQuery(component=NoticePublisherPlugin&group=type,format=progress)]] == Download Download Egg files and the zipped source from [https://sourceforge.net/p/notices4trac/files/ the project on SourceForge]. == Source You can check out NoticePublisherPlugin from [https://sourceforge.net/p/notices4trac/code/ the repository on SourceForge] using Git. == Installation For installation guidance, see the [https://sourceforge.net/p/notices4trac/files/ project page on SourceForge]. == Recent Changes [[ChangeLog(noticepublisherplugin, 3)]] == Author/Contributors '''Author:''' [wiki:seccanj] [[BR]] '''Maintainer:''' [[Maintainer]] [[BR]] '''Contributors:'''