This wiki is archived and useful information is being migrated to the main bzflag.org website

Webadmin

From BZFlagWiki
Revision as of 05:34, 11 July 2009 by Mets (Talk | contribs) (Usage: clearing up path to plugin)

Jump to: navigation, search

webadmin is a standard plug-in that is shipped with the source code. It allows for server management via a standard web browser interface (HTTP). Webadmin is included in v3.0 and later releases. Webadmin is currently under development.

Usage

When the Webadmin is loaded it must have take a parameter that tells the system where the html templates are. The default templates dir is ./ (current working dir). Since webadmin is an HTTPD plug-in the HTTPServer plugin must be in the same directory as webadmin, or have been previously loaded.

The usage is:

-loadplugin the/path/to/the/plugin/webadmin,the/path/to/the/templates

or in an already running game:

/loadplugin the/path/to/the/plugin/webadmin,the/path/to/the/templates

Examples:

-loadplugin "/plugins/webadmin/webadmin.so,/plugins/webadmin/templates"

Templates

Webadmin uses templates to define the various pages that are returned. 2 types of templates are used, include templates, and page templates. Both types use the same BZFS_HTTP_Template system. These templates can be customized if needed.

Navigation

The standard header provides links to all the standard pages.

Pages

Page templates always end in .page and are automatically scanned by the plug-in and shown in the default navigation header.

A number of default pages are provided with the distribution;

Main

This page provides a basic overview of the current server, it shows

  • A player list
  • Current Scoring
  • Current Map
  • Bandwith?
  • Number of reports
  • Current Polls

Logs

This page shows a list of server events with time stamps, including;

  • Player Join/Part
  • Player Spawn/Die
  • Team Flag Captures
  • Flag Pickups
  • Kick/Ban events
  • Report events

Players

This page provides more detailed info about the players, it contains the following info per player;

  • Name
  • Lag
  • IP/Host
  • Game stats
  • Groups and Permissions
  • Login/out history
  • Flag history
  • Chat text

Vars

This page provides a list of server vars with values, and allows them to be set.

Bans

This page provides a list server bans, allowing them to be reviewed, added, or removed.

Chat

This page shows the chat on the server with an automatic update. It allows the admin to send out chat text as a server message.

Help Messages

This pages shows the current help files, and allows them to be edited. (Is this useful?)

Groups

This pages shows the current groups, and allows them to be edited.

Reports

This pages shows the current reports, and allows them to be cleared.

Includes

Include templates are generaly used by the page templates or the plug-in for various common tasks. They are not scanned and listed in the default navigation header.

These templates are most commonly used for consistent page headers and footers as well as error pages.

History

Webadmin was initially started as part of the 2008 Google summer of code, it's design documents can be found at Webadmin_SOC2008. The plug-in has been rewritten significantly since the end of the Summer of Code.