Difference between revisions of "Extensions:Awards"

From Lorekeeper Wiki
Jump to navigation Jump to search
m (→‎Vanilla Awards: Changing branch url)
Tag: 2017 source edit
(Update to Develop branch and revise text.)
Tag: 2017 source edit
Line 1: Line 1:
 +
'''This extension is on Develop and therefore requires Laravel 8 and PHP 7.4.'''
 +
 
This extension creates a separate '''"Awards"''' system for Lorekeeper based off the existing items/inventory system. Awards are stored in the '''"Award Case"''' and also displayed on user profiles.
 
This extension creates a separate '''"Awards"''' system for Lorekeeper based off the existing items/inventory system. Awards are stored in the '''"Award Case"''' and also displayed on user profiles.
  
This extension builds off of the existing code from [[Extensions:Stacked Inventories]], [[Extensions:Submission Addons]], and [[Extensions:Item Entry Expansion]]. (Though these extensions are not required for the awards extension to run.)
+
{{Extensioninfobox|title=Awards|desc=Adds a user "Awards" System to Lorekeeper|auth=[[user:Tgi]] and [[user:Preimpression]]|status=Stable|github={{Github|user=preimpression|branch=extension/awards}}|migration=yes|package=no}}<br />
 +
 
 +
===History of the Extension===
  
{{Extensioninfobox|title=Awards|desc=Adds an "Awards" System to base LK|auth=[[user:Tgi]]|status=Testing (Character Awards WIP)|github={{Github|user=tjgallaha|branch=Awards_System}}|migration=yes|package=no}}<br />
+
Before the development of Lorekeeper Version 2.0.0 began, the Awards extension was built by [[User:Tgi]]. It had been built and separated from an existing LK site which had numerous extensions, such as stacked inventories and item entry expansion. The separation wasn't complete, and led to plentiful bugs for those users who weren't using the extensions.
==Installation==
 
Pull the branch and run <code>php artisan migrate</code>!
 
  
'''Please be aware that this extension builds off of several existing extensions. If you pull and have errors, it's probably because you don't have one of the extensions listed!
+
[[User:Preimpression]] took it upon themself to complete the separation and rebase the extension back onto Vanilla Lorekeeper (that is, Lorekeeper V.1.0.0) to allow users who didn't have the remnant extensions to have Awards. It used the original code, which was in fact mostly a clone of extant Items code, and separated out most references to other extensions.  
I'll update this page when the vanilla version is finished. In the meanwhile, it is recommended that you read [[Tutorial: Installing Extensions]] for MERGING and TROUBLESHOOTING before proceeding.'''
 
  
'''Note''' that this extension needs [[Extensions:Character Items]] and [[Extensions:Bootstrap_Tables]] (an extension by [[User:Preimpression]]) implemented to work properly.
+
Upon the development of V.2.0.0, extensions began moving over onto the Develop branch on the official lorekeeper github in preparation for the switch to V.2.0.0. At this time, [[User:Newt]] took initiative and converted the extension to the in-development version of 2.0.0.
  
==Vanilla Awards==
+
==Installation==
[[User:Preimpression]] made a [https://github.com/preimpression/lorekeeper/tree/extension/vanilla-awards Vanilla Lorekeeper] version of Awards, for those users who awards without having Character Items, Bootstrap Tables, or Item Stacks. It is using the original code but separating out most references to the other extensions. Questions or bug reports should still go through [[User:Tgi]].
+
Pull the branch and run the following commands in your console:
 +
<code>php artisan migrate</code> - This adds the applicable database tables and columns.
 +
<code>php artisan update-extension-tracker</code> - This adds the extension to your Credits page.
 +
 
 +
'''It is recommended that you read [[Tutorial: Installing Extensions]] for MERGING and TROUBLESHOOTING before proceeding.'''
  
 
==Configuration==
 
==Configuration==
Line 19: Line 24:
 
None required.
 
None required.
  
Optional: if you'd like to change the names of your awards to something else (i.e. trophies, medals, etc) you can change the way it's listed in the following blades:
+
Optional: if you'd like to change the names of your awards to something else (i.e. trophies, medals, stickers, etc) you can change the way it's listed in the following blades:
 
<code>resources/views/world/--> award_categories.blade.php, award_page.blade.php, awards.blade.php, index.blade.php</code>
 
<code>resources/views/world/--> award_categories.blade.php, award_page.blade.php, awards.blade.php, index.blade.php</code>
  
Line 27: Line 32:
 
==Usage==
 
==Usage==
 
<!-- Is there anything users should know about using your extension? -->
 
<!-- Is there anything users should know about using your extension? -->
Currently Awards are only user-specific. Awards are like items: you can make award categories, grant awards, and earn them through prompts and claims, but all awards are account-bound and nontransferable. (If an admin accidentally grants an award to wrong user, it has to be deleted)
+
Currently Awards are only user-specific. Awards are like items: you can make award categories, grant awards, and earn them through prompts and claims, but all awards are account-bound and nontransferable.  
 +
If an admin accidentally grants an award to wrong user, it has to be deleted.
 +
 
 +
Character Awards are currently not in development by either [[User:Tgi]] nor [[User:Preimpression]]. However, [[User:Newt]] is developing a Character Badges which may be applicable.
  
Character-specific awards are currently a work in progress!
 
 
==Troubleshooting==
 
==Troubleshooting==
After pulling, you may run into a bunch of conflicts. If anything seems broken, go into your files and check for <code><<<<<< HEAD</code>. Git adds these in when there's conflicts or additions to existing files, and they can cause stuff to break. Remove them, save, and push, and everything should work great.
+
After pulling, you may run into a bunch of conflicts. If anything seems broken, go into your files and check for <code><<<<<< HEAD</code>. Git adds these in when there's conflicts or additions to existing files, and they can cause stuff to break. Edit them manually, save, and push, and everything should work great.  
 
(To avoid this in the future, in '''Sourcetree''', review your staged files + click on the weird code + press "unstage lines". Saves you a lot of headache.)
 
(To avoid this in the future, in '''Sourcetree''', review your staged files + click on the weird code + press "unstage lines". Saves you a lot of headache.)
  
There may be some stray code from [[Extensions:Submission Addons]] as well. Let TGI know on discord if you run into any issues!
+
For any other issues, please create a ticket on the Lorekeeper discord and ping TGI#5092 or Uri#2154.
 +
 
 
==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. -->
 +
Built using code from [[Extensions:Stacked Inventories]], [[Extensions:Submission Addons]], and [[Extensions:Item Entry Expansion]].

Revision as of 08:52, 22 February 2021

This extension is on Develop and therefore requires Laravel 8 and PHP 7.4.

This extension creates a separate "Awards" system for Lorekeeper based off the existing items/inventory system. Awards are stored in the "Award Case" and also displayed on user profiles.

Awards
Description Adds a user "Awards" System to Lorekeeper
Author(s) user:Tgi and user:Preimpression
Status Stable
Github extension/awards
LK Version Unspecified
Contains a Migration



History of the Extension

Before the development of Lorekeeper Version 2.0.0 began, the Awards extension was built by User:Tgi. It had been built and separated from an existing LK site which had numerous extensions, such as stacked inventories and item entry expansion. The separation wasn't complete, and led to plentiful bugs for those users who weren't using the extensions.

User:Preimpression took it upon themself to complete the separation and rebase the extension back onto Vanilla Lorekeeper (that is, Lorekeeper V.1.0.0) to allow users who didn't have the remnant extensions to have Awards. It used the original code, which was in fact mostly a clone of extant Items code, and separated out most references to other extensions.

Upon the development of V.2.0.0, extensions began moving over onto the Develop branch on the official lorekeeper github in preparation for the switch to V.2.0.0. At this time, User:Newt took initiative and converted the extension to the in-development version of 2.0.0.

Installation

Pull the branch and run the following commands in your console: php artisan migrate - This adds the applicable database tables and columns. php artisan update-extension-tracker - This adds the extension to your Credits page.

It is recommended that you read Tutorial: Installing Extensions for MERGING and TROUBLESHOOTING before proceeding.

Configuration

None required.

Optional: if you'd like to change the names of your awards to something else (i.e. trophies, medals, stickers, etc) you can change the way it's listed in the following blades: resources/views/world/--> award_categories.blade.php, award_page.blade.php, awards.blade.php, index.blade.php

resources/views/user --> _sidebar.blade.php, awardcase.blade.php, profile.blade.php, award_logs.blade.php

resources/views/home --> _sidebar.blade.php, awardcase.blade.php

Usage

Currently Awards are only user-specific. Awards are like items: you can make award categories, grant awards, and earn them through prompts and claims, but all awards are account-bound and nontransferable. If an admin accidentally grants an award to wrong user, it has to be deleted.

Character Awards are currently not in development by either User:Tgi nor User:Preimpression. However, User:Newt is developing a Character Badges which may be applicable.

Troubleshooting

After pulling, you may run into a bunch of conflicts. If anything seems broken, go into your files and check for <<<<<< HEAD. Git adds these in when there's conflicts or additions to existing files, and they can cause stuff to break. Edit them manually, save, and push, and everything should work great. (To avoid this in the future, in Sourcetree, review your staged files + click on the weird code + press "unstage lines". Saves you a lot of headache.)

For any other issues, please create a ticket on the Lorekeeper discord and ping TGI#5092 or Uri#2154.

See Also

Built using code from Extensions:Stacked Inventories, Extensions:Submission Addons, and Extensions:Item Entry Expansion.