Skip to content
SharpMUSH

Gallery

Section titled “Gallery”

Every character has a gallery of pictures on their web portal profile. Its owner adds images, puts them in order, gives each a caption, tags and a content warning, and chooses which one is the avatar and which the banner. The profile shows the avatar and two more; View all opens the gallery page at /character/<name>/gallery, which filters by tag.

Whoever may edit the character’s biography may edit the gallery: the account that owns the character, or staff who control it (see roles). The portal takes PNG, JPEG, GIF and WebP files up to 10 MB, and checks the file’s own bytes, not just the type the browser names. A gallery holds at most “max_gallery_images” images (50 unless the game changes it; see @config limits).

The avatar and the banner are copied into IMAGE and IMAGE`BANNER, and the avatar’s caption into IMAGE`ALT, every time the gallery changes, so softcode and clients read the same picture (see IMAGE).

::: seealso

Warnings and tags

Section titled “Warnings and tags”

A content warning is a few words, such as blood or spiders. The portal covers the image with them until a viewer chooses Show image. A warned image is never the avatar or the banner, which show everywhere without a click: a warning moves the avatar to the first image without one.

Tags are single words or short phrases, lower case, up to 10 per image. The gallery page shows one button per tag and keeps only the images carrying it.

Limits: a caption up to 300 characters, a warning up to 100, a tag up to 32.

Section titled “Reading a gallery in softcode”

The gallery is kept as JSON in the character’s PROFILE`GALLERY attribute, one object per image in display order:

  • AssetId, FileName, Url: the stored file and its site-relative address.
  • Caption, Warning: text, or null.
  • Tags: a list of words, or null.
  • Order: the place, from 0.
  • IsIcon, IsBanner: whether it is the avatar or the banner.

Change the gallery from the portal: a value set by hand is replaced by the next change made there.

Example: counting your images and reading the first one’s caption.

> think json_query(get(me/PROFILE`GALLERY),size)
3
> think json_query(get(me/PROFILE`GALLERY),extract,$\[0\].Caption)
At the harbour rail

Reports and new images

Section titled “Reports and new images”

Two events let the game decide what happens to the gallery’s images (see event gallery):

  • GALLERY`ADD runs after an image is added. Use it to tell staff about new pictures.
  • GALLERY`REPORT runs when someone signed in to the portal reports an image. The portal offers Report only while the event handler has GALLERY`REPORT or a package’s attribute under it. The bundled jobs package sets GALLERY`REPORT`JOBS, which files a job in its Staff bucket.

Example: telling connected wizards about every report.

> &GALLERY`REPORT #9=@wizwall/emit [name(%#)] reported an image of [name(%<objid>)]: %<reason> (%<url>)