Difference between revisions of "Extensions:Galleries"
Tag: 2017 source edit |
Tag: 2017 source edit |
||
| Line 17: | Line 17: | ||
=== Currency Form Configuration === | === Currency Form Configuration === | ||
'''Only necessary if gallery_submissions_reward_currency is ENABLED.''' | '''Only necessary if gallery_submissions_reward_currency is ENABLED.''' | ||
| + | |||
| + | If necessary, set the group_currency site setting (in the site settings admin panel) to the ID of the currency you wish to award to users for gallery submissions. By default, it is set to 1. | ||
This module ''will'' work out of the box but ''will not'' be customized to your game, so you should configure it as appropriate. | This module ''will'' work out of the box but ''will not'' be customized to your game, so you should configure it as appropriate. | ||
| Line 25: | Line 27: | ||
== Usage == | == Usage == | ||
<!-- Is there anything users should know about using your extension? --> | <!-- Is there anything users should know about using your extension? --> | ||
| + | Submit art and/or writing to galleries by clicking the "submit" button in the index or on the gallery's page. | ||
== 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? --> | ||
| + | There is a known issue when viewing a page with currency-related information with no currencies created. | ||
| + | |||
== 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. --> | ||
Revision as of 08:53, 20 October 2020
| Description | Provides a space for users to upload art and writing. |
|---|---|
| Author(s) | Mercury |
| Status | Testing |
| Github | galleries |
| LK Version | Unspecified |
| Contains a Migration | |
| Uses a Package | |
WIP WIP WIP WIP
Contents
Installation
Configuration
Basic Configuration
Adjust the added settings in the site settings admin panel. These are as follows:
- gallery_submissions_open
- gallery_submissions_require_approval
- gallery_submissions_reward_currency
You may want to close gallery submissions globally while you are performing basic set up of galleries.
Create galleries in the data/galleries admin panel, adjusting settings per gallery as desired.
Currency Form Configuration
Only necessary if gallery_submissions_reward_currency is ENABLED.
If necessary, set the group_currency site setting (in the site settings admin panel) to the ID of the currency you wish to award to users for gallery submissions. By default, it is set to 1.
This module will work out of the box but will not be customized to your game, so you should configure it as appropriate.
The form itself is configured in config/lorekeeper/group_currency_form.php. This config file is commented extensively in an endeavor to make it easy to customize.
The function responsible for calculating a total based on users' form input is at the top of app/Helpers/AssetHelpers. This is unfortunately more or less hard-coded; however, it is also commented extensively. Note that the fields used in this formula must be the same as the ones within the form, or it will break and/or not calculate the total properly.
Usage
Submit art and/or writing to galleries by clicking the "submit" button in the index or on the gallery's page.
Troubleshooting
There is a known issue when viewing a page with currency-related information with no currencies created.
