readme.html 3.29 KB
Newer Older
Daniel Henninger's avatar
Daniel Henninger committed
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">

<html>
<head>
	<title>Broadcast Plugin Readme</title>
    <style type="text/css">
        BODY {
            font-size : 100%;
        }
        BODY, TD, TH {
            font-family : tahoma, verdana, arial, helvetica, sans-serif;
            font-size : 0.8em;
        }
        H2 {
             font-size : 10pt;
             font-weight : bold;
        }
        A:hover {
            text-decoration : none;
        }
        H1 {
            font-family : tahoma, arial, helvetica, sans-serif;
            font-size : 1.4em;
            font-weight: bold;
            border-bottom : 1px #ccc solid;
            padding-bottom : 2px;
        }

        TT {
            font-family : courier new;
            font-weight : bold;
            color : #060;
        }
        PRE {
            font-family : courier new;
            font-size : 100%;
        }
    </style>
</head>
<body>

<h1>
Broadcast Plugin Readme
</h1>

<h2>Overview</h2>

<p>
The broadcast plugin broadcasts messages to all users in the system or to specific groups. It's
primarily useful for sending announcements or notifications.
</p>

<h2>Installation</h2>

<p>Copy broadcast.jar into the plugins directory of your Openfire installation. The
plugin will then be automatically deployed. To upgrade to a new version, copy the new
broadcast.jar file over the existing file.</p>

<h2>Configuration</h2>

The broadcast plugin is configured via Openfire system properties. These can
be configured under Server/Server Manager/System Properties:

<ul>
    <li><tt>plugin.broadcast.serviceName</tt> -- the name of the broadcast service. If no value
    is set, the default is "broadcast".</li>
    <li><tt>plugin.broadcast.disableGroupPermissions</tt> -- true to allow any user to
    broadcast a message to a group. When false, only group members or administrators can
    broadcast messages to a group. The default value is false.</li>
    <li><tt>plugin.broadcast.groupMembersAllowed</tt> -- true to also allow group members
    to send broadcast messages to groups they belong to. When false, only administrators can
    send broadcast messages to a group. The default value is true. Note that the property value
    of <tt>plugin.broadcast.disableGroupPermissions</tt> can effectively override this value
    by letting anyone send broadcast messages to groups.</li>
    <li><tt>plugin.broadcast.allowedUsers</tt> -- the comma-delimitted list of users allowed
    to broadcast messages to all connected users at once. When this property isn't set,
    anyone is allowed to broadcast messages to all users. Users should be specified by their
    bare JID (e.g. john@myserver.com)</li>
</ul>

<h2>Using the Plugin</h2>

To send a broadcast message, send a message to all@[serviceName].[serverName] or
[group]@[serviceName].[serverName]. For example, if your server is called foo and the
default service name is being used, a message to all@broadcast.foo would be broadcast to
all users connected to the server. For the group staff, a message to staff@broadcast.foo would
be sent to all users in the group staff that are currently online or offline.

<p>
Note: for maximum compatability between group implementations, it's recommended that you use
lower-case group names in conjunction with the broadcast plugin.
</p>

</body>
</html>