Extensions:Event Tools
Revision as of 06:15, 8 April 2021 by Honeybee Fanfare (talk | contribs)
| Description | Adds some small tools for running events. |
|---|---|
| Author(s) | Mercury |
| Status | Testing |
| Github | extension\event-tools |
| LK Version | Unspecified |
This extension is built on develop.
Adds some relatively lightweight tools for doing some fun stuff with extensions. As-is, it's built with the philosophy of doing as much as possible while not adding too much (for instance, it doesn't include migrations).
Features
Additional site settings for:
- Event currency (id)
- Whether or not to track event currency earnings globally (in addition to tracking per user as usual)
- A global goal for event "score", which can be disabled by setting it to 0
Admin-side:
- An event point tracking page displaying current event currency, and information about the current global total and progress toward the goal
- This includes a progress bar-- code for an inverted progress bar (drains instead of fills, in the vein of an HP bar) is stored in the view, commented out
- It also includes a an option to clear/zero-out all users' current event currency amount, in lieu of deleting + remaking the event currency. (In the vein of deleting an item, currency, etc. this is tucked within a confirmation modal, so no worries about clicking it accidentally to disastrous results.) Deleting currencies currently owned by users is consequently disabled, since it offers an alternate solution to the problem allowing that was endeavoring to solve.
- Global tracking of event points. This is done by, when global tracking is enabled and a user would receive event currency through any means, also crediting it to the admin user specified via the admin_user site setting-- since the admin user should not be any given user's personal account/not a participant in any event. (This does not apply if the admin user acquires event currency directly, however, so that they are not double-credited.) Note that no automation is attached to reaching the set goal/any thresholds. Any rewards, etc. will need to be distributed through different means.
- A text page for substitution into the user-facing event tracking page, for detailing an event with global point tracking.
User-facing:
- An event tracking page, viewable when global point tracking is enabled, which displays the contents of the above page as well as listing the current event currency, global point total, and progress toward the goal if any (including progress bar; similarly, there is a commented-out inverse progress bar in the view).
Installation
After pulling the extension, run php artisan add-site-settings, php artisan add-text-pages, and php artisan update-extension-tracker.
Configuration
Adjust settings in the site settings admin panel as necessary.
Usage
When running an event using a global point total, make sure to link your users to the event point tracking page!
Troubleshooting
Find me in the Lorekeeper discord if you have issues.
