Galleries

Galleries are a submission type added in 2.0.0 that accepts user images (typically art) and writing into a queue for inclusion in one of a site's galleries/folders. Galleries can be edited in the admin panel by users with the Edit World Data power.

Usage

This section pertains to the general purpose and usage of the gallery index. See the Submission section below for more information on submitting to a gallery.

The overall gallery can be accessed from the navigation bar. The gallery index lists all visible top-level galleries. These are displayed in the order specified by staff when creating/editing galleries.

Each gallery in the index lists the following:

• Name (with link to the full gallery)
• A list of the gallery's sub-galleries, if present
• The four most recent submissions to the gallery, each including:
  • Thumbnail
  • Title
  • Artist(s)/Author(s)
  • Number of favourites
  • Number of comments

Galleries

Each gallery has a page that displays the following:

• Name
• Open and/or close date, as applicable
• Description
• All submissions to the gallery, paginated, as outlined above
• The submit to gallery button, if a user is logged in

Submissions in a gallery can be searched by title, associated prompt ID (as applicable), and sorted by:

• Newest First (creation date)
• Oldest First
• Title (alphabetical order)
• Title (reverse alphabetical order)
• By prompt (newest to oldest)
• By prompt (oldest to newest)

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

This section pertains to the editing of galleries. See the Queues section below for more information on the submission queues.

Gallery editing requires the Edit World Data power. Note that this power alone does not allow the user to view and process the submission queues.

Galleries have the following properties:

• Name
  • The gallery name which is displayed on the gallery index and gallery itself.
• Sort
  • 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.
• Parent Gallery
  • Optional. The gallery that the gallery being created/edited falls under, used for organization.
• Description (no HTML)
  • Optional. A short description of the gallery.
• 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.
  • 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.
• 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.
  • 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
  • Only appears if the gallery_submissions_require_approval site setting is enabled. The number of votes required to approve a submission to this gallery in the approval queue.
• Hide Before Start Time
  • If the gallery should be hidden before its start time (if one is set). Note that galleries can only be hidden before starting, not after their end.
• 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.

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 highly recommended that it be configured as appropriate. This has two parts:

• The form
  • This part-- displayed to users when creating a gallery submission-- is configured in a 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
  • 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

Submissions to a gallery can be submitted from the gallery index (via the + button on the gallery's listing) or via the "submit" button on the gallery's page.

A gallery submission requires:

• Main Content (An image and/or text (accepts HTML))
  • The primary content of the gallery submission.
• Title
  • The title of the gallery submission.
• Description (accepts HTML)
  • Optional. Any comments the submitting user would like to make about the piece can be added here.
• 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

The characters section allows the user to add characters to their submission. The only input is character code (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.

Collaborators

If a piece is a collaboration between multiple users, the submitting user can specify each user that participated, including themself. Inputs are:

• User
  • The username of the collaborator on-site.
• Role (no HTML)
  • 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.

Participants

Participants are similar to collaborators, though not directly involved in the creation of the submission. Inputs are:

• User