Galleries - Revision history

Mercury at 16:38, 25 July 2021

2021-07-25T16:38:25Z

Mercury at 16:03, 24 July 2021

2021-07-24T16:03:28Z

Mercury at 15:55, 24 July 2021

2021-07-24T15:55:27Z

Mercury at 15:36, 24 July 2021

2021-07-24T15:36:25Z

Mercury at 15:22, 24 July 2021

2021-07-24T15:22:15Z

Mercury at 15:03, 24 July 2021

2021-07-24T15:03:06Z

Mercury at 14:59, 24 July 2021

2021-07-24T14:59:57Z

Mercury at 14:39, 24 July 2021

2021-07-24T14:39:50Z

Mercury at 14:38, 24 July 2021

2021-07-24T14:38:56Z

Mercury at 14:36, 24 July 2021

2021-07-24T14:36:44Z

@@ Line 36: / Line 36: @@
 Pieces can only be submitted to a gallery between the start and end dates if either or both of those dates are specified. Clicking the Submit button goes to the gallery submission page for that gallery.
 ==Editing==
@@ Line 148: / Line 156: @@
 Additionally, users with the Manage Submissions power can select a different gallery to move an already submitted gallery submission to. This is available regardless of the submission's status. Note that if a submission is moved between galleries that do/do not have currency rewards enabled, the relevant information will not be created/will not be displayed, and the submission will not be added to the rewards queue, depending on the direction of the move.
-===== Archiving Submissions =====
+=====Archiving Submissions=====
 As gallery submissions may hold records important to the logging and recordkeeping of the site-- particularly if currency rewards are enabled-- they cannot be deleted. However, the submitting user, as well as any users with the Manage Submissions power, can "archive" gallery submissions, rendering them non-visible to other users.
-== See Also ==
+=== Submission Log Details ===
-* [[Prompts]]
+==See Also==
 * [[Claims]]
-* [[Currencies]]
+*[[Prompts]]
+*
@@ Line 162: / Line 200: @@
+*

@@ Line 57: / Line 57: @@
 **Note that no users may submit regardless of powers if the '''gallery_submissions_open''' site setting is off.
 *'''Enable Currency Rewards'''
-**Only appears if the '''gallery_submissions_reward_currency''' site setting is enabled. Toggles whether submissions to the gallery are eligible for group currency rewards.
+**Only appears if the '''gallery_submissions_reward_currency''' site setting is enabled. Toggles whether submissions to the gallery are eligible for group [[Currencies|currency]] rewards.
 *'''Prompt Selection'''
 **Whether or not users will be given the option to select a [[Prompts|prompt]] to associate with a gallery submission when submitting to the gallery.
@@ Line 69: / Line 69: @@
 ===Currency Rewards===
-This optional component, enabled using the '''gallery_submissions_reward_currency''' site setting, allows submissions to applicable galleries to receive rewards of a set on-site currency. When submitting to a gallery with currency rewards enabled, users will be shown a short form that is used to calculate an estimated currency total that they should receive for the piece. This estimate will be provided to users managing the associated queue, though they can adjust as appropriate. This component ''will'' work on initial installation but ''will not'' be customized to your site, so it is <u>highly recommended</u> that it be configured as appropriate. This has two parts:
+This optional component, enabled using the '''gallery_submissions_reward_currency''' site setting, allows submissions to applicable galleries to receive rewards of a set on-site currency. When submitting to a gallery with currency rewards enabled, users will be shown a short form that is used to calculate an estimated currency total that they should receive for the piece. This estimate will be provided to users managing the associated queue, though they can adjust as appropriate. This component ''will'' work on initial installation but ''will not'' be customized to your site, so it is <u>highly recommended</u> that it be configured as appropriate. This has three parts:
-*The form
+*'''group_currency''' site setting
 **This part-- displayed to users when creating a gallery submission-- is configured in a [[Config Files|config file]] (specifically config/lorekeeper/group_currency_form.php). This file is commented extensively in an effort to make it easier to customize.
-*The function
+*'''The Function'''
-**This part takes input from the form and uses it to calculate an estimated reward that should be given for a gallery submission. It is configured in app/Helpers/AssetHelpers and similarly commented extensively. Note that the fields used in this function must correspond to the form, or it will break and/or fail to calculate the total properly.
+**This part takes input from the form and uses it to calculate an estimated reward that should be given for a gallery submission. It is at the beginning of and configured in app/Helpers/AssetHelpers and similarly commented extensively. Note that the fields used in this function must correspond to the form, or it will break and/or fail to calculate the total properly.
 ==Submission==
@@ Line 119: / Line 121: @@
 Participants are notified that they have been added to a gallery submission once it is approved.
-==== Currency Rewards Information ====
+====Currency Rewards Information====
 If currency rewards are enabled for the site and gallery being submitted to, the user will be asked to fill out the currency reward form as configured. Once the gallery submission has been submitted, the site will use this information to calculate an estimated amount of currency that the user and/or any collaborators should receive.
-=== Submission ===
+===Submission===
 Gallery submissions submitted to the approval queue or gallery (depending on settings) will have their own page containing submitted information. Submissions are visible to the submitting user and/or all collaborators as well as to users with the Manage Submissions power before approval, and to all users once the submission is accepted into the gallery.
@@ Line 134: / Line 136: @@
 The properties that can be edited before approval are:
-* '''Collaborators'''
+*'''Collaborators'''
-** Note that any collaborators added after submission will not receive a notification
+**Note that any collaborators added after submission will not receive a notification
-* '''Participants'''
+*'''Participants'''
 The properties that cannot be edited after submission are:
-* '''Currency form information''' (if enabled)
+*'''Currency form information''' (if enabled)
-* '''Selected prompt''' (if enabled)
+*'''Selected prompt''' (if enabled)
-** Users with the Manage Submissions power can always edit this, however.
+**Users with the Manage Submissions power can always edit this, however.
 Additionally, users with the Manage Submissions power can select a different gallery to move an already submitted gallery submission to. This is available regardless of the submission's status. Note that if a submission is moved between galleries that do/do not have currency rewards enabled, the relevant information will not be created/will not be displayed, and the submission will not be added to the rewards queue, depending on the direction of the move.
+*

@@ Line 59: / Line 59: @@
 **Only appears if the '''gallery_submissions_reward_currency''' site setting is enabled. Toggles whether submissions to the gallery are eligible for group currency rewards.
 *'''Prompt Selection'''
-**Whether or not users will be given the option to select a prompt to associate with a gallery submission when submitting to the gallery.
+**Whether or not users will be given the option to select a [[Prompts|prompt]] to associate with a gallery submission when submitting to the gallery.
 **This is primarily useful for galleries which may see submissions intended for multiple different prompts, as it helps keep them organized from the outset.
 *'''Votes Required'''
@@ Line 89: / Line 89: @@
 *'''Content Warning''' (no HTML)
 **Optional. A short content warning may be provided; if this is done, the submission's thumbnail will be displayed as a generic image (see [[Site Images]]) and the warning displayed below the thumbnail. The piece will still be visible in full when visiting the gallery submission's page.
-===Characters===
+====Characters====
 The characters section allows the user to add [[characters]] to their submission. The only input is <u>character code</u> (the character's unique identification code). Characters added to a submission are displayed on the submission's page; if currency rewards are enabled for the site and gallery being submitted to, the number of characters attached to the submission is also used to help calculate the estimated reward.
-===Collaborators===
+====Collaborators====
 If a piece is a collaboration between multiple users, the submitting user can specify each user that participated, <u>including themself</u>. Inputs are:
@@ Line 103: / Line 105: @@
 When submitting a gallery submission with collaborators associated, the collaborators will be [[Notifications|notified]] and must approve or edit the record of their contribution before the submission appears in the gallery (if submissions do not require approval) or before it appears in the submission queue for staff approval. Contributors can also remove themself from the submission at this time if they have been added erroneously. Once all collaborators have approved, the submission is processed further.
-====Participants====
+=====Participants=====
 Participants are similar to collaborators, though not directly involved in the creation of the submission. Inputs are:
@@ Line 117: / Line 119: @@
 Participants are notified that they have been added to a gallery submission once it is approved.
-=== Editing ===
+==== Currency Rewards Information ====
-Gallery submissions can be edited after submission, though some properties cannot be edited either after submission or after approval. The properties that can always be edited are:
+If currency rewards are enabled for the site and gallery being submitted to, the user will be asked to fill out the currency reward form as configured. Once the gallery submission has been submitted, the site will use this information to calculate an estimated amount of currency that the user and/or any collaborators should receive.
-* '''Main Content'''
+=== Submission ===
-* '''Title'''
+Gallery submissions submitted to the approval queue or gallery (depending on settings) will have their own page containing submitted information. Submissions are visible to the submitting user and/or all collaborators as well as to users with the Manage Submissions power before approval, and to all users once the submission is accepted into the gallery.
 * '''Description'''
+*

@@ Line 90: / Line 90: @@
 **Optional. A short content warning may be provided; if this is done, the submission's thumbnail will be displayed as a generic image (see [[Site Images]]) and the warning displayed below the thumbnail. The piece will still be visible in full when visiting the gallery submission's page.
-=== Characters ===
+===Characters===
-The characters section allows the user to add [[characters]] to their submission. The only input is <u>character code</u> (the character's unique identification code). Characters added to a submission are displayed on the submission's page; if currency rewards are enabled for the site and gallery being submitted to, the number of characters attached to the submission is used to help calculate the estimated reward.
+The characters section allows the user to add [[characters]] to their submission. The only input is <u>character code</u> (the character's unique identification code). Characters added to a submission are displayed on the submission's page; if currency rewards are enabled for the site and gallery being submitted to, the number of characters attached to the submission is also used to help calculate the estimated reward.
-=== Collaborators ===
+===Collaborators===
 If a piece is a collaboration between multiple users, the submitting user can specify each user that participated, <u>including themself</u>. Inputs are:
-* '''User'''
+*'''User'''
-** The username of the collaborator on-site.
+**Allows selection of an on-site user.
-* '''Role''' (no HTML)
+*'''Role''' (no HTML)
-** What part(s) of the piece the user contributed.
+**What part(s) of the piece the user contributed.
-When submitting a gallery submission with collaborators associated, the collaborators will be notified and must approve or edit the record of their contribution before the submission appears in the gallery (if submissions do not require approval) or before it appears in the submission queue for staff approval. Contributors can also remove themself from the submission at this time if they have been added erroneously. Once all collaborators have approved, the submission is processed further.
+When submitting a gallery submission with collaborators associated, the collaborators will be [[Notifications|notified]] and must approve or edit the record of their contribution before the submission appears in the gallery (if submissions do not require approval) or before it appears in the submission queue for staff approval. Contributors can also remove themself from the submission at this time if they have been added erroneously. Once all collaborators have approved, the submission is processed further.
-==== Participants ====
+====Participants====
 Participants are similar to collaborators, though not directly involved in the creation of the submission. Inputs are:
-* '''User'''
+*'''User'''
-**
+**Allows selection of an on-site user.
+*
+*

@@ Line 87: / Line 87: @@
 *'''Description''' (accepts HTML)
 **Optional. Any comments the submitting user would like to make about the piece can be added here.
-*'''Content Warning'''
+*'''Content Warning''' (no HTML)
-**<br />
+**Optional. A short content warning may be provided; if this is done, the submission's thumbnail will be displayed as a generic image (see [[Site Images]]) and the warning displayed below the thumbnail. The piece will still be visible in full when visiting the gallery submission's page.
 ***
+*

@@ Line 68: / Line 68: @@
 **The period during which submissions to the gallery can be made. Both are optional, and you can also specify only one of them.
-=== Currency Rewards ===
+===Currency Rewards===
 This optional component, enabled using the '''gallery_submissions_reward_currency''' site setting, allows submissions to applicable galleries to receive rewards of a set on-site currency. When submitting to a gallery with currency rewards enabled, users will be shown a short form that is used to calculate an estimated currency total that they should receive for the piece. This estimate will be provided to users managing the associated queue, though they can adjust as appropriate. This component ''will'' work on initial installation but ''will not'' be customized to your site, so it is <u>highly recommended</u> that it be configured as appropriate. This has two parts:
-* The form
+*The form
-** This part-- displayed to users when creating a gallery submission-- is configured in a [[Config Files|config file]] (specifically config/lorekeeper/group_currency_form.php). This file is commented extensively in an effort to make it easier to customize.
+**This part-- displayed to users when creating a gallery submission-- is configured in a [[Config Files|config file]] (specifically config/lorekeeper/group_currency_form.php). This file is commented extensively in an effort to make it easier to customize.
-* The function
+*The function
-** This part takes input from the form and uses it to calculate an estimated reward that should be given for a gallery submission. It is configured in app/Helpers/AssetHelpers and similarly commented extensively. Note that the fields used in this function must correspond to the form, or it will break and/or fail to calculate the total properly.
+**This part takes input from the form and uses it to calculate an estimated reward that should be given for a gallery submission. It is configured in app/Helpers/AssetHelpers and similarly commented extensively. Note that the fields used in this function must correspond to the form, or it will break and/or fail to calculate the total properly.
 ==Submission==
@@ Line 81: / Line 81: @@
 A gallery submission requires:
-*'''Media''' (An image and/or text)
+*'''Main Content''' (An image and/or text (accepts HTML))
 **The primary content of the gallery submission.
 ***
+*

@@ Line 67: / Line 67: @@
 *'''Start Time & End Time'''
 **The period during which submissions to the gallery can be made. Both are optional, and you can also specify only one of them.
-***

@@ Line 37: / Line 37: @@
 Pieces can only be submitted to a gallery between the start and end dates if either or both of those dates are specified. Clicking the Submit button goes to the gallery submission page for that gallery.
-== Editing ==
+==Editing==
 This section pertains to the editing of galleries. See the Queues section below for more information on the submission queues.
@@ Line 44: / Line 44: @@
 Galleries have the following properties:
-* '''Name'''
+*'''Name'''
-** The gallery name which is displayed on the gallery index and gallery itself.
+**The gallery name which is displayed on the gallery index and gallery itself.
-* '''Sort'''
+*'''Sort'''
-** Optional. A number; does not need to be unique. Galleries are sorted first by their sort number, then by name.
+**Optional. A number; does not need to be unique. Galleries are sorted first by their sort number, then by name.
-** Sub-galleries are also sorted this way, but only displayed within the context of their parent gallery, so a sub-gallery with a sort number of 1 will only ever display at the top of its' parent gallery's list of sub-galleries.
+**Sub-galleries are also sorted this way, but only displayed within the context of their parent gallery, so a sub-gallery with a sort number of 1 will only ever display at the top of its' parent gallery's list of sub-galleries.
-* '''Parent Gallery'''
+*'''Parent Gallery'''
-** Optional. The gallery that the gallery being created/edited falls under, used for organization.
+**Optional. The gallery that the gallery being created/edited falls under, used for organization.
-* '''Description''' (no HTML)
+*'''Description''' (no HTML)
-** Optional. A short description of the gallery.
+**Optional. A short description of the gallery.
-* '''Submissions Open'''
+*'''Submissions Open'''
-**
+**Whether or not users can submit to the gallery. Users with the '''Manage Submissions''' power can submit to any gallery regardless of this setting.