Forums   Email   Rulebook   Members   Stats   Gallery   Tactics   Tips   Fun

Allicorn's Outfit Reporter

Creating your own custom report template

Please note that using this feature will require a little knowledge of HTML and CSS and I'm not about to answer requests for help with that. Visit the W3C and read the specifications for the standards.

Starting out

A good way to start is to make a copy of the file Default.html that resides in the program's home directory. This is the default HTML template that generates the normal orange-backdrop report. Make a copy, keep it in the same directory and call it MyOutfit.html or somesuch. Outfit Reporter will list all HTML files that appear in that directory as possible report template choices when you run the program.

Template Tags

The individual peices of stat data are inserted into your HTML via special tags. The tags all start with two dollar signs ($$) and end with a semicolon (;). Open up your new HTML file in a decent text editor (notepad will do if you've got nothing else) and take a look. You should see a block that looks something like this:

<table>
	<tr>
		<td class=struct colspan=2><div>$$title;</div></td>
	</tr>
	<tr>
		<td class=struct colspan=2><div>$$stats;</div></td>
	</tr>
	<tr>
		<td class=struct colspan=2><div class=scroll>$$roles;</div></td>
	</tr>
	<tr>
		<td class=struct colspan=2><div class=scroll>$$certs;</div></td>
	</tr>
	<tr>
		<td class=struct><div class=scroll>$$op;</div></td>
		<td class=struct><div class=scroll>$$accumulatedop;</div></td>
	</tr>
	<tr>
		<td class=struct><div class=scroll>$$kbrcr;</div></td>
		<td class=struct><div class=scroll>$$kh;</div></td>
	</tr>
	<tr>
		<td class=struct><div class=scroll>$$br;</div></td>
		<td class=struct><div class=scroll>$$cr;</div></td>
	</tr>
	<tr>
		<td class=struct><div class=scroll>$$kills;</div></td>
		<td class=struct><div class=scroll>$$killsthisweek;</div></td>
	</tr>
	<tr>
		<td class=struct><div class=scroll>$$hacks;</div></td>
		<td class=struct><div class=scroll>$$hacksthisweek;</div></td>
	</tr>
	<tr>
		<td class=struct><div class=scroll>$$accumulatedkills;</div></td>
		<td class=struct><div class=scroll>$$accumulatedhacks;</div></td>
	</tr>
	<tr>
		<td class=struct><div class=scroll>$$e1kills;</div></td>
		<td class=struct><div class=scroll>$$e2kills;</div></td>
	</tr>
	<tr>
		<td class=struct colspan=2><div class=scroll>$$e1e2;</div></td>
	</tr>
	<tr>
		<td class=struct colspan=2><div class=scroll>$$outfitawards;</div></td>
	</tr>
	<tr>
		<td class=struct colspan=2><div class=scroll>$$awards;</div></td>
	</tr>
	<tr>
		<td class=struct colspan=2><div>$$promotions;</div></td>
	</tr>
</table>
		

The green highlighted bits are the Outfit Reporter Template Tags. Wherever, in your HTML, you place those tags, Outfit Reporter will replace them with an HTML table containing the indicated part of the report. They are as follows:

  • $$title;
    The outfit name, number of active members and the name of the outfit leader.
  • $$stats;
    The Outfit Stats section
  • $$op;
    The Outfit Points leaderboard
  • $$accumlatedop;
    The Outfit Points (Accumulated across Alt-Characters) leaderboard
  • $$kbrcr;
    The Kills/BR+CR leaderboard
  • $$kh;
    The Kills/Hack leaderboard
  • $$accumulatedkh;
    The Kills/Hack (Accumulated across Alt-Characters) leaderboard
  • $$certs;
    The Cert Distribution table
  • $$roles;
    The Key Roles tables
  • $$br;
    The Battle Rank leaderboard
  • $$cr;
    The Command Rank leaderboard
  • $$kills;
    The Kills leaderboard
  • $$accumulatedkills;
    The Kills (Accumulated across Alt-Characters) leaderboard
  • $$killsthisweek;
    The Last-7-Days-Kills leaderboard
  • $$hacks;
    The Hacked Facilities leaderboard
  • $$accumulatedhacks;
    The Hacked Facilities (Accumulated across Alt-Characters) leaderboard
  • $$hacksthisweek;
    The Last-7-Days-Hacked Facilities leaderboard
  • $$e1kills;
    The Enemy Faction #1 Kills leaderboard
  • $$e2kills;
    The Enemy Faction #2 Kills leaderboard
  • $$e1e2;
    The Faction #1 to #2 Kill Ratio table
  • $$awards;
    The Awards section
  • $$promotions;
    The Promotions section

While editting your template, if you decide you don't want to show any of the individual parts, just don't bother including it. Outfit Reporter will work just fine even if you only include one $$tag; in your template. Please make VERY sure that you don't ever leave one of the semi-colons off of the end of any tags you use, as this'll really screw things up horribly.

Doing it with Style

Although most of the HTML created by the Outfit Reporter uses tags with no explicit style (and therefore things will render in the default style you've associated with your page), there are a few elements that have a class attribute associated with them so that you can set up specific styles if necessary.

The named styles are:

TD.shade which is associated with the table cells containing the captions of the Key Roles section.

.smallprint which is associated with the small captions under the main headings in the Key Roles section.

.smalllink which is associated with the player names appearing in the Key Roles section. Since there may be a lot of names, it can be useful to have them appear in the smallest print possible.

Other style changes within the report are mainly just relative font size changes and are placed inline and can't be changed.

All Done

So, now you can edit up your own uniquely individual report template. Just load up Outfit Reporter and select your new template from the Output Template box and generate as usual.

Gah! It didn't work!

The most likely thing is that you've missed off a trailing semicolon from one of the template tags. Doing this will mangle the output completely. Also make sure your new template file is called something.html (it must have .HTML for its extension) and that its in the Outfit Reporter home directory, the same place you'll find Default.html, the default template. Other than that, there may be something wrong with your HTML and I'm sorry but I can't help you with that.