Difference between revisions of "Extensions:Scavenger Hunts"
Tag: 2017 source edit |
(Editing link to Bootstrap Tables) Tag: 2017 source edit |
||
| Line 3: | Line 3: | ||
This builds upon [[Extensions:Stacked Inventories]]! Not only is much credit due there, it also bears mention that the changes made there are necessarily included in this extension. | This builds upon [[Extensions:Stacked Inventories]]! Not only is much credit due there, it also bears mention that the changes made there are necessarily included in this extension. | ||
| − | It also integrates elements from the wonderful | + | It also integrates elements from the wonderful [[Extensions:Bootstrap_Tables]], such as the prettyDate helper, and the tables within it are built with bootstrap in the style of that extension. |
Adds a system for creating/handling mostly automated scavenger hunts. | Adds a system for creating/handling mostly automated scavenger hunts. | ||
Revision as of 15:34, 31 August 2020
| Description | A mostly automated system for handling scavenger hunts. |
|---|---|
| Author(s) | Mercury |
| Status | Testing |
| Github | scavenger-hunts |
| LK Version | Unspecified |
| Contains a Migration | |
This builds upon Extensions:Stacked Inventories! Not only is much credit due there, it also bears mention that the changes made there are necessarily included in this extension.
It also integrates elements from the wonderful Extensions:Bootstrap_Tables, such as the prettyDate helper, and the tables within it are built with bootstrap in the style of that extension.
Adds a system for creating/handling mostly automated scavenger hunts.
Hunts have space for an internal and display name, short summary, an initial clue if desired, and start and end times. Once hunts are created they also gain a field for storing a plaintext list of target locations. It's hidden under a collapse by default, however. Hunts also display in the admin panel the url and formatted link to their user-facing page, for convenience.
Once a hunt is created you can then create up to 10 targets, which are items with a given quantity. These in turn can have a description, such as a clue. Users can claim an item once, at which point the timestamp at which they did so is logged and the item/quantity is awarded to them automatically. Targets can only be claimed inside the time a hunt is active, of course. Targets are linked to via randomized strings generated on target creation rather than via their internal ID to make it wildly impractical for users to guess the links to them. Again, for convenience, pre-formatted links are generated. HTML and wiki formatting are provided, but note that the latter requires for your wiki to have linking to external images enabled; it is disabled by default. These links endeavor to display the item's image, but failing that, they display the item's name.
Hunt pages are always visible, regardless of whether they are active (can be interacted with) or not. This is partly for the sake of ready archival, and because awarded items' logs point to this page. They display the hunt's display name and summary, start and end times, and its starting clue. It also displays the targets the user has found and claimed and the number claimed out of the total. If any of the claimed targets had clues attached, they are also listed for convenience.
Targets' pages display the item image if present, as well as name and quantity of the item, and the target's clue if present. They also have a button to claim the item and log that the user has found it. This button is of course unavailable outside of the hunt's start and end times, and if the user has already claimed the target.
Installation
Pull, run
php artisan migrate
Configuration
None necessary.
Usage
Scavenger hunts are created and edited via an admin panel in the [Data] section.
Troubleshooting
Find me in the Lorekeeper discord if you have issues!
