Difference between revisions of "Extensions:Challenges"

From Lorekeeper Wiki
Jump to navigation Jump to search
Tag: 2017 source edit
(Fixing github url)
Tag: 2017 source edit
 
(7 intermediate revisions by one other user not shown)
Line 1: Line 1:
{{Extensioninfobox|title=Challenges|desc=Adds flexible, admin-defined "Challenges" for users to complete.|auth=Mercury|status=Testing|github={{Github|user=itinerare|branch=extensions/challenges}}|LKVer=2.0.0|migration=yes|package=no}}
+
{{Extensioninfobox|title=Challenges|desc=Adds flexible, admin-defined "Challenges" for users to complete.|auth=Mercury|status=Testing|github={{Github|user=itinerare|branch=extension/challenges}}|LKVer=2.0.0|migration=yes|package=no}}
 
<!-- Put a short summary of your extension here! -->
 
<!-- Put a short summary of your extension here! -->
Allows for creation of "challenges", which are composed of a series of prompts (not to be confused with uppercase-P [[Prompts]]) for users to complete. Challenges themselves have the following properties:
+
Allows for creation of "challenges", which are composed of a series of admin-defined prompts (not to be confused with uppercase-P [[Prompts]]) for users to complete. Challenges themselves have the following properties:
 
* Name
 
* Name
 
* Description (Optional)
 
* Description (Optional)
Line 9: Line 9:
 
* Name
 
* Name
 
* Description (Optional)
 
* Description (Optional)
 +
Users can register for currently-active challenges; this is done fully automatically. A site setting is included for the number of concurrent registrations a user can have. The user must then provide a URL and/or text to satisfy each prompt associated with the challenge. All prompts are available immediately and may be completed in any order, with no deadline. On completion of all prompts, the option is provided to submit the log via the standard submissions flow (a Prompt is created for this purpose as part of the setup process). Note that while user registrations are automatically processed, user logs are not automatically marked 'Old' on processing of any submissions related to them, and this must be done manually by processing staff (by reviewing and "Accepting" the log, entering staff comments if appropriate).
 
== Installation ==
 
== Installation ==
 
<!-- Describe installation. Include any requirements (such as packages), necessary commands, etc. -->
 
<!-- Describe installation. Include any requirements (such as packages), necessary commands, etc. -->
 +
Pull the branch; run <code>php artisan migrate</code>, <code>php artisan setup-challenges</code>, and <code>php artisan update-extension-tracker</code>.
 
== Configuration ==
 
== Configuration ==
 
<!-- Is any configuration necessary? Describe it here! -->
 
<!-- Is any configuration necessary? Describe it here! -->
 +
* Adjust the <u>challenges_concurrent</u> setting in site settings if desired (default is 1 registration per user at a time)
 +
* Create challenges as appropriate in the admin panel
 +
* Customize the prompt created as part of the setup process
 
== Usage ==
 
== Usage ==
 
<!-- Is there anything users should know about using your extension? -->
 
<!-- Is there anything users should know about using your extension? -->
 +
Users can register for challenges via /challenges on the site.
 
== Troubleshooting ==
 
== Troubleshooting ==
 
<!-- Are there known issues or errors that require user action? Who should they contact, and where, for support? -->
 
<!-- Are there known issues or errors that require user action? Who should they contact, and where, for support? -->
 +
Find me in the Lorekeeper server!
 
== Images ==
 
== Images ==
 
<!-- Do you have any images to show what it looks like in action? -->
 
<!-- Do you have any images to show what it looks like in action? -->
 
== See Also ==
 
== See Also ==
 
<!-- Any relevant other pages. You may consider linking to related extensions, for instance. -->
 
<!-- Any relevant other pages. You may consider linking to related extensions, for instance. -->

Latest revision as of 14:56, 19 May 2023

Challenges
Description Adds flexible, admin-defined "Challenges" for users to complete.
Author(s) Mercury
Status Testing
Github extension/challenges
LK Version 2.0.0
Contains a Migration






Allows for creation of "challenges", which are composed of a series of admin-defined prompts (not to be confused with uppercase-P Prompts) for users to complete. Challenges themselves have the following properties:

  • Name
  • Description (Optional)
  • Additional Rules (Optional)
  • Is Active

And can have a variable number of prompts. Each prompt has the following properties:

  • Name
  • Description (Optional)

Users can register for currently-active challenges; this is done fully automatically. A site setting is included for the number of concurrent registrations a user can have. The user must then provide a URL and/or text to satisfy each prompt associated with the challenge. All prompts are available immediately and may be completed in any order, with no deadline. On completion of all prompts, the option is provided to submit the log via the standard submissions flow (a Prompt is created for this purpose as part of the setup process). Note that while user registrations are automatically processed, user logs are not automatically marked 'Old' on processing of any submissions related to them, and this must be done manually by processing staff (by reviewing and "Accepting" the log, entering staff comments if appropriate).

Installation

Pull the branch; run php artisan migrate, php artisan setup-challenges, and php artisan update-extension-tracker.

Configuration

  • Adjust the challenges_concurrent setting in site settings if desired (default is 1 registration per user at a time)
  • Create challenges as appropriate in the admin panel
  • Customize the prompt created as part of the setup process

Usage

Users can register for challenges via /challenges on the site.

Troubleshooting

Find me in the Lorekeeper server!

Images

See Also