Roster Master for Dragonfly

EverQuest II Guild Roster Manager for Dragonfly CMS

About RM4DF

Roster Master for Dragonfly (RM4DF) provides a method to integrate the EverQuest II Guild Roster into your Dragonfly CMS site. Fully integrated into the site, you can manage and view your guild's data right from your portal. A block is also provided that displays guild statistical data.

Roster Master for Dragonfly is part of the Roster Master Project, which is composed of a family of ports of the original Roster Master module originally written by Rex "SaintPeter" Schrader. Significant enhancements and exclusive features have been made for the Dragonfly CMS version, as well as to accomodate changes in Everquest II and the everquest2.com site.

The Roster Master development thread [archive of pre-2013 forum] [archive of 2013-2014 forum] on forums.daybreakgames.com is a highly active and community supported discussion focusing on debugging and introducing new features and ideas into the Roster Master project. Other Roster Master ports and related resources can be found on the www.rostermaster.org site.

General Features

Roster Master: Guild Roster Manager

Allow your CMS users to "claim" his or her characters to their CMS username

Character "Type" Tracking

Compliments and expands upon the "Guild Rank" feature

Users may specify if their character is Primary, Secondary, or Utility

Option to list Primary characters only

Guild Roster Single and Double Column Sorting

Sort by clicking on a column header, or select two columns from a drop-down (i.e. Class, then Level)

Reversible Sorting for both sort modes

Optional column sort indicators displayed in table headings

Optional Grouped Listing

Collection Master: Collection Quest Tracker and Query (Dragonfly Port Exclusive!)

Track Collection Quest progress for your characters

Quests automatically updated from Census, no need to manually set quest status

Links quests and rewards to online walkthroughs and data

Quest Master: Quest Tracker and Query (Dragonfly Port Exclusive!)

Track Heritage, Access, and Timeline Quest progress for your characters

Quests automatically updated from Census, no need to manually set quest status

Links quests and rewards to online walkthroughs and data

Query quests to list characters at each quest step

Features an exclusive scrolling/resizable JavaScript Table

The table can be resized by dragging the horizontal rule between the bottom of the table and the table footer up and down

Signature Master: Dynamic Signature Generator (Dragonfly Port Exclusive!)

Dynamically create graphical signature blocks automatically from information stored in the roster database

Features a unique caching system to reduce wasted server resources and poor client performance issues

Automatic Instantiation (Dragonfly Port Exclusive!)

Multiple instances of this module can be created by making a copy of the module directory and adding an underscore followed by an integer to the name of the directory (e.g. "Roster_Master_2"). The module will detect this and automagically configure itself

Blocks follow the same pattern

Guild Wall of Fame Block (Dragonfly Port Exclusive!)

Display guild statistics and information in your Dragonfly CMS blocks

Many display configuration options

Guild Summary Information (Dragonfly Port Exclusive!)

Guild Level displayed in Roster

Statistics and other information available in block

SQL Backend Cache

Fast display since you don't have to hit EQ2's site every time

Configurable cache refresh time

Update Logging

Have a record of changes in all fields, every user add, and every user deletion

Log data update failures and retries

Configurable, log as much or as little as you wish

Error Messages

Explanatory error messages for common failures

Clean exits

Fully Documented, Clean Code

All functions completely commented

Advanced users have access to more advanced options and configuration within the code source

Open-source, released under the GNU General Public License

Completely Dragonfly Compliant:

Roster Master has been ported to Dragonfly with an expanded feature set
Easy to Setup and Install
- FTP, configure, set permissions and go
- No .sql file to import, just run the installer
- Install, backup, uninstall, and upgrade right from the Dragonfly control panel
CMS username to character name mapping
Includes Dragonfly's localization support (English language file included)
Leverages the CMS' features and security

Download

Roster Master for Dragonfly is available free of charge from the Roster-Master-for-Dragonfly-CMS repository on GitHub, this is the best location for the latest code and to submit issues.

Point releases of Roster Master for Dragonfly are available free of charge from the Clenched Fist Guild download site, as well as from the Dragonfly CMS community site:

Download from Clenched Fist
Download from Dragonfly CMS community site

Current released version is: Roster Master for Dragonfly 9.1.0 (2017-11-29)

Improved Alt logic.
Added the ability to show only claimed characters in Quest Master. Thanks to Tulvarus, for the feature suggestion.
Fixed bug in Quest Master where resort links weren't preserving Expansion selections.
Query Quest Status now honors the current show_alts and show claimed characters search options.
Added vertical centering to sort checkboxes and radio button labels.
Replaced references to http://forums.station.sony.com/eq2/ with http://forums.daybreakgames.com/eq2/ link.
Fixed database errors with references to "rm.id".
Fixed problem with multiple crc entries for the same characterID being present in the roster_master_quest_status table.
Fixed old RM4DF version number in sigblock templates.
Fixed Signature Master not pulling signature block avatars from the correct subdirectories and defaulting to the eq2 logos.
Some template cleanup.
Moved administration display strings into language file.
Additional diagnostics messages.
Cleaned up installer's database upgrade strategy.
Remove obsolete statistics from block.
Updated documentation.
Updated contib/history.sql file to reflect new events.
New feature: addition of Collection Master!
- Reports on a character's collection quests.
- Like Quest Master, automatically updated from Census.
- Note: Collection Master can only know about collection quests that exist in Census, quests have been known to be held back for new expansions.
Reworked parser to increase efficiency:
- Reduced use of globals and reworked data structures to be more efficient for write operations, rather than replicate the structures used to build the roster pages.
- SQL query optimizations.
- Massive speed improvements during roster update; NOTE: this comes at the cost of detailed logging of roster changes (eliminating the loops to do comparisons solely for logging purposes had a significant performance cost).
- Removed XML parsers in favor of JSON, for a 25% data savings advantage.
Thanks to Feldon with generously helping with the Census query syntax and suggestions on efficiency improvements.

Previous version is: Roster Master for Dragonfly 9.0.0 (2017-11-03)

Fixed sitewide "Accessed Denied" error when module is uninstalled.
Added missing Aerakyn race icons.
Added missing Channeler class icon and fixed missing display logic.
Getting ready for 2038, changed DB time representations to BIGINT.
Added tooltips to sort options to clarify interface.
Minor cleanup to SQL query syntax.
Deprecated use of id field for character data (characterId is now canonical).
New feature: major update to Questmaster!
- Quests automatically updated from Census, no need to manually set quest status!!!!
- Adding new quests doesn't require DB schema changes.
- Updated sort dialogs with tooltips for abbreviated items.
- Note that extensive internal changes have been made, files have been added and removed.
- Better handling of sort options.
Rework to XML parsers.
Removed $config['qm_exclude_inactive'] option.
Fixed table resize JavaScript functionality that was preventing the feature from working.
Sort direction indicators are now clickable to change sort direction for that column.
Removed obsolete access quests (tSS, NekC_tR, CoK, tSC).
Added Census service ID for the Roster Master application. Please refer to http://census.daybreakgames.com for documentation of this api.
A number of latent bugs removed incidentally. Several added for good measure.

Requirements

An operational Dragonfly CMS 9.3 (or later) installation.
Don't use Dragonfly? (Why not?) You may wish to investigate RM4DF's sister ports in the Roster Master Project.
The server on which Dragonfly is installed must have outbound Web (TCP Port 80) access to the game's Census API server.
Your Guild ID number. A search tool is provided in the Roster Master administration panel.
The Signature Master feature requires GD 2.0.1 or later and the FreeType library. It is highly recommended that Dragonfly be configured with the LEO (Link Engine Optimization) feature turned on in order for proper cache performance to be realized.

In addition, it is useful to have a working knowledge of a good FTP program as well as a basic understanding on how to edit a PHP file in order to change the configuration options.

The Diagnostics page in the Roster Master Administration menu can be extremely helpful in making sure that all module prerequisites are met.

Installation

The most up-to-date installation instructions are always included in the distribution release in the README file. Be sure to read the README file before proceeding with installation or before requesting support! Additional notes and comments on new features and changes also appear in the CHANGELOG file.

Angela "Seagoat" Taylor has developed an excellent and detailed guide to using Signature Master and its advanced features.

Support

If you have problems with Roster Master for Dragonfly, please first read the article "How to Ask Questions the Smart Way" by Rick Moen and Eric Steven Raymond. Once you have identifies the issue and framed your question, then choose your best path of support.

If you believe that your problem lies with Roster Master for Dragonfly, you best method of support is to open an issue for the Roster-Master-for-Dragonfly-CMS repository. As an alternative, you may refer to the Development Thread. This is also the best place to inquire about ports of Roster Master that are not for Dragonfly CMS, as the author of Roster Master for Dragonfly cannot assist with ports for other content management systems.

If you have a general Dragonfly CMS question, or believe you have discovered a problem with Dragonfly, your best support option is the official Dragonfly CMS site

Copyright and Distribution Permissions

This software is licensed under the CC-GNU GPL.

Roster Master for Dragonfly logo created by Ronja.
EverQuest is a trademark of Daybreak Game Company LLC.
The names of actual companies and products mentioned herein may be the trademarks of their respective owners.