Galleries

From Lorekeeper Wiki
Revision as of 08:03, 24 July 2021 by Mercury (talk | contribs)
Jump to navigation Jump to search

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 three parts:

  • group_currency site setting
    • The ID of the currency that is used for rewards.
  • 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 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

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.
  • Prompt
    • Optional. If enabled for the gallery, the prompt the gallery submission is for may be selected. This is useful primarily as an organizational tool, as gallery submissions will automatically find and display prompt submissions using the gallery submission.

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 also 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
    • Allows selection of an on-site user.
  • 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
    • Allows selection of an on-site user.
  • Role
    • Allows selection of one of these set roles:
      • Gift for
      • Trade for
      • Commissioned by
      • Commissioned by (for group currency)

Participants are notified that they have been added to a gallery submission once it is approved.

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

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.

Editing

Gallery submissions can be edited after submission by the submitting user as well as users with the Manage Submissions power, though some properties cannot be edited either after submission or after approval. The properties that can always be edited are:

  • Main Content
  • Title
  • Description

The properties that can be edited before approval are:

  • Collaborators
    • Note that any collaborators added after submission will not receive a notification
  • Participants

The properties that cannot be edited after submission are:

  • Currency form information (if enabled)
  • Selected prompt (if enabled)
    • 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.

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

Retrieved from "http://wiki.lorekeeper.me/index.php?title=Galleries&oldid=1374"