help

Get a list of all supported commands.

help [command]

Get help to an specific command.

get

Reads out the current setting of an option. To change a setting, use the 'set'-command.

latex

Complies given LaTeX Code to an GIF image, uploaded on the server. Helga provides two links:

• permanent link to the image

• always the same link which points always onto your last image.

See README for more details.

message

Send a remind message to someone. This command can be used to send an message to yourself or someone else. You can manage your messages with 'show' and 'remove' commands. The number of messages per user is limited to 10.

ping

Simple command which just answers "pong". Helpful to check if your internet connection is still available.

presence

Gives the time when an user was last seen or his presence if the user is only at the moment. For security reasons is is only possible to query users who are registered with Helga and have set public setting to 'true'.

Serveradmins get extended information about users operating system and client.

remove

Active events can be removed. The 'remove'-Command removes an specific or all messages. You can only remove your own messages. You can get the MessageID by the 'show'-Command.

set

Set an option to an new value. To read out the current setting use the 'get'-command.

show

Prints a list of all your active messages.

time

Sends current servertime

welcome

Sends welcome-message again.

group add

This command is only for serveradmins. You can add one ore more users directly to a group. (without user demand)

group ban

This command is only for moderators. The user will deleted from the group and append to a ban list, which prevents the user from rejoin to the group. The ban can be revoked with the 'revoke' command. This ban list of a group can be shown using the 'info' command.

group create

Serveradmins can create new groups with this command. To change group settings later, use 'update'. Both commands are identically, except that 'create' can only create new groups and 'update' can only change existing groups. (security against typos)

group decline

This command has two functions:

1. You can decline an invitation explicitly. Moderators will noticed about this with a message.

2. Moderators can decline a join request.

group delete

Serveradmins can delete existing groups.

group find

This command lists all available groups of type OPEN and MODERATED. Groups of type CLOSED are only showed to serveradmins.

An optional filter can be used to restrict the search. All groups are listed who have the given filter in their name. The wildcards * and ? are interpreted as usual. The filter is case sensitive.

group info

A list of groups you are member of or information to an specific group.

group invite

Inside of OPEN groups every member can send invitations. Inside of MODERATED or CLOSED group only moderators are allowed to do this. Make an user an join request, then all moderators will receive a message. By inviting this user a moderator can accept the request. In this case the user will not receive an invite message, but will added to the group directly.

group join

With this command you can join a group. If the group is MODERATED, only a join request is made. This request can be accepted by an moderator with an 'invite' or decline with 'decline'. In CLOSED groups you can only join if you have been invited.

Only serveradmins can 'join' other users.

group kick

Groupmembers can leave the group with this command. Moderators can kick other users out of the group.

group message

Send a message to all members of a group. Only for group members in case of the group is in ONLYGROUP mode. In all other cases this can only done by group moderators.

group revoke

This command is only for moderators. It revokes a ban that was declared using the 'ban' command.

group update

see 'create'

roster import

With this command you can add multiple contacts at once to your roster (contactlist). This only makes sence if you want to import many contacts, for example a complete contact list if you are doing a server relocation.

roster export

This command does export your roster (contactlist) using the format described under 'import'. Contacts form shared groups where exported, too. Contacts that have a jabberID without a username (e.g. Transports as icq.jabber.rwth-aachen.de) where not exported.

roster names

This command iterates through your complete roster and sets nicknames automatically. This could take some seconds, especially if vCard are not locally available and have to be requested from remote.

admin email

Serveradmins can send an email to all users of your server.

admin message

Serveradmins can send a message to all registered users of your server. (really all users, not only available)

• Fixed bugs in database scripts for hsqldb. Using HSQLDB (embedded-db) with Helga should work now. (thx @ dfaure)
• Changed time format for locale EN to 24h clock for usability reasons.
• Fixed time format bug in 'message' command manpage.
• Fixed minor leap year bug in 'message' command.
• New compile script: No longer hardcoded absolute paths. JavaDoc creation should no longer flood with warnings.

• Applied API changes for Openfire 3.5.0. Set minServerVersion to 3.5.0

• Fixed some bad quoting bugs in i18n files.

• Fixed NullPointerException for commands 'group create' and 'group update' if parameter '-g' is not given.

• Fixed NullPointerException when revoking moderator rights with command 'group update'.

• command 'presence' does now show also group memberships, if an admin is querying.

• new command: 'latex' - compiles LaTeX code to images, using an external application.

• Fixed serveral problems with SQL-server database. SQL-server should work now, but helga's group features are still untested with SQL-server. thx@deafsquad

• Other databases than MySQL and SQL-server are still Beta. Would be nice if someone could test it and report results to me.

• Added some linebreaks to in-band-registration-instructions.

• 'message' command does now check if a local resource is available before sending to it. If the resource is unavailable it redirects to bare JID. For external resources can't checked if they are available, so message were lost, if the external server does not redirect the message.

• fixed small bug while loading message events from database

• 'admin message' sends to all connected resources now, not only to the most available resource of each user. Added option not to send to unavailable users, too. This should be equivalent to send a message through the admin console.

• new command: 'ping' - It just answers "pong". Helpful to check you Internet connection.

• new alias: (date -> time)

• removed experimental transport settings, because they didn't work and are not needed anymore. Removed HelgaTransportManager class and related code.

• Helga should now be able to import nicknames from everything that supports vCards (XEP-0054 vcard-temp). In particular this should work with pyICQt and pyMSNt.

• command: 'roster names', added an option to restrict work on an specific domain or subdomain.

• massive changes on database tables. Helga should now support all databases that openfire supports, but everything else than MySQL is still Beta.

• Helga is now integrated into Openfires database update system. In future database changes can be done automatically. If you are updating from Helga 2.1x execute the following SQL statement before updating to a newer version of Helga:

INSERT INTO jiveVersion (name, version) VALUES ('helga', 0);

• If you are updating from 1.xx (before offical release), you have to update manually.

• compiled with Openfire 3.4.1 and JDK 6u3

• minor changes

• nicer presence images, images taken from Psi's "Crystal (Roster)" Icons (Author: Everaldo Coelho, http://www.everaldo.com)

• changed the way how Helga loads the presence images

• now an local username is accepted in a HTTP-Request. You can use something like: ...helga/user?jid=user1 instead of ...helga/user?jid=user1@yourserver.com