{"id":19648141,"url":"https://github.com/bestpractical/rt-extension-announce","last_synced_at":"2025-07-06T20:32:45.916Z","repository":{"id":6718660,"uuid":"7964416","full_name":"bestpractical/rt-extension-announce","owner":"bestpractical","description":null,"archived":false,"fork":false,"pushed_at":"2024-12-06T18:20:29.000Z","size":192,"stargazers_count":5,"open_issues_count":0,"forks_count":1,"subscribers_count":26,"default_branch":"master","last_synced_at":"2025-04-05T09:25:04.255Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://metacpan.org/release/rt-extension-announce","language":"Perl","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bestpractical.png","metadata":{"files":{"readme":"README","changelog":"Changes","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2013-02-01T19:10:09.000Z","updated_at":"2024-10-31T17:53:37.000Z","dependencies_parsed_at":"2024-11-11T14:47:32.112Z","dependency_job_id":"20feed09-a934-4862-a434-e596d2e823a3","html_url":"https://github.com/bestpractical/rt-extension-announce","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bestpractical%2Frt-extension-announce","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bestpractical%2Frt-extension-announce/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bestpractical%2Frt-extension-announce/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bestpractical%2Frt-extension-announce/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bestpractical","download_url":"https://codeload.github.com/bestpractical/rt-extension-announce/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251338821,"owners_count":21573614,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-11T14:47:14.797Z","updated_at":"2025-07-06T20:32:45.898Z","avatar_url":"https://github.com/bestpractical.png","language":"Perl","funding_links":[],"categories":[],"sub_categories":[],"readme":"NAME\n    RT-Extension-Announce - Display announcements as a banner on RT pages.\n\nRT VERSION\n    Works with RT 4.4, 5.0 and 6.0.\n\nINSTALLATION\n    perl Makefile.PL\n    make\n    make install\n        May need root permissions\n\n    Edit your /opt/rt6/etc/RT_SiteConfig.pm\n        If you are using RT 4.4 or greater, add this line:\n\n            Plugin('RT::Extension::Announce');\n\n        And add the following:\n\n            Set(@CustomFieldValuesSources, (qw(RT::CustomFieldValues::AnnounceGroups)));\n\n        See \"CONFIGURATION\" for more options.\n\n    make initdb\n        Only run this the first time you install this module.\n\n        If you run this twice, you may end up with duplicate data in your\n        database.\n\n        If you are upgrading this module, check for upgrading instructions\n        in case changes need to be made to your database.\n\n    Clear your mason cache\n            rm -rf /opt/rt6/var/mason_data/obj\n\n    Restart your webserver\n\nDESCRIPTION\n    The Announce extension gives you an easy way to insert announcements on\n    the RT homepage so all users can see the message. You may want to\n    display a banner during maintenance or an unscheduled outage to make\n    sure the people fielding customer tickets know that something is going\n    on.\n\nDETAILS\n    When you install the extension, a new queue is created called\n    RTAnnounce. To post an announcement, create a ticket in that queue. The\n    extension displays on the RT homepage the subject and most recent\n    correspondence on active tickets in the RTAnnounce queue. As the\n    incident or maintenance progresses, just reply to the ticket and the\n    announcement will be updated with the latest information.\n\n    When multiple announcements are active, they are ordered by the last\n    update time with the announcement with the most recent update coming\n    first.\n\n    When the incident is over, resolve the ticket and the announcement will\n    be removed.\n\n    Comments on announce tickets are not shown in the announcement. However,\n    comments are visible on the ticket for users who have permission to view\n    the full ticket. If you have multiple announcements, a new comment\n    updates the last updated time and will move the announcement to the top\n    of the list.\n\nANNOUNCEMENT GROUPS\n    The RTAnnounce queue has a custom field called 'Announcement Groups'\n    which you can use to manage who will see an announcement. If you set no\n    value, all users will see the announcement. If you set one or more RT\n    groups, only members of those groups will see it.\n\nPERMISSIONS\n    By default, the announcements are static text. If you give users the\n    ShowTicket right on the RTAnnounce queue, the announcements will have\n    links to the source tickets. This will allow users to see the history of\n    an announcement or see longer messages that might be truncated on the\n    homepage.\n\n    The RTAnnounce queue is a regular queue, so you can control access to\n    creating announcements the same way you manage permissions on other\n    queues.\n\n    In addition to setting permissions, you may not want to send the typical\n    'ticket create' email messages, so you could change or customize the\n    scrips that run or create new templates. If you send announcement\n    messages to an email list, you could create a list user in RT and add it\n    as a CC to the announcement queue. Then messages posted for announcement\n    in RT will also be sent to the notification list.\n\nRT-Extension-FormTools\n    If you would like to show announcements on FormTools form pages look at\n    the configuration option $ShowAnnouncementsInFormTools in the\n    CONFIGURATION section below.\n\nCONFIGURATION\n  $RTAnnounceQueue\n    Use this to change the name of the queue used for announcements. First\n    edit the RTAnnounce queue in RT and change its name to your new name.\n    Then a line to your RT_SiteConfig.pm to set that new value:\n\n        Set($RTAnnounceQueue, 'Custom Announce Name');\n\n  @AnnounceGroups\n    By default, all user defined groups will be listed in \"Announcement\n    Groups\". If you have a large number of groups in your RT, this can make\n    for a long list, so you can customize the group list by setting\n    @AnnounceGroups in your RT_SiteConfig.pm:\n\n        Set(@AnnounceGroups, 'foo', 'bar', 'baz');\n\n  $ShowAnnouncementsInSelfService\n    Set this to true to show announcements on the self service page as well\n    as the regular privileged RT page.\n\n  $RTAnnounceAllowHTML\n    If set to true, the banner content will be set to 'text/html' and allow\n    HTML rendering.\n\n    If the content of the message is large there is an option to wrap the\n    content in overflow divs. In the source HTML of the message, wrap the\n    bottom part of the message in the following: \u003cdiv\n    class=\"RTAnnounceBannerOverflow\"\u003e\u003c/div\u003e. The top part of the message\n    will be shown with a scrollbar and the part contained in the div will be\n    hidden. Users can view the bottom section by scrolling without taking up\n    too much room at the top of the page.\n\n  $ShowAnnouncementsInFormTools\n    Set this to true to show announcements on FormTools pages.\n\n    You will need to add a custom field to the queue used for announcements.\n\n    First update the @CustomFieldValuesSources config setting to the\n    following:\n\n        Set(@CustomFieldValuesSources, (qw(RT::CustomFieldValues::AnnounceGroups RT::CustomFieldValues::FormToolsGroups)));\n\n    Then add create a new custom field and apply it to the queue used for\n    announcements:\n\n        Name:                Announcement FormTools Groups\n        Type:                Select multiple values\n        Field values source: RT user defined FormTools groups for the RT Announce plugin\n        Applies to:          Tickets\n\n    When creating a new announcement ticket select values in the new custom\n    field to control where the announcement will be displayed.\n\n    If the custom field is left empty the announcement will only display on\n    the homepage. If one or more values are selected the announcement will\n    only display for the values selected.\n\nAUTHOR\n    Best Practical Solutions, LLC \u003cmodules@bestpractical.com\u003e\n\nBUGS\n    All bugs should be reported via email to\n\n        L\u003cbug-RT-Extension-Announce@rt.cpan.org|mailto:bug-RT-Extension-Announce@rt.cpan.org\u003e\n\n    or via the web at\n\n        L\u003crt.cpan.org|http://rt.cpan.org/Public/Dist/Display.html?Name=RT-Extension-Announce\u003e.\n\nLICENSE AND COPYRIGHT\n    This software is Copyright (c) 2012-2024 by Best Practical Solutions,\n    LLC\n\n    This is free software, licensed under:\n\n      The GNU General Public License, Version 2, June 1991\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbestpractical%2Frt-extension-announce","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbestpractical%2Frt-extension-announce","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbestpractical%2Frt-extension-announce/lists"}