9TH REALM CORE v1.1.45 · SALEM, MA · ACTIVE RUNTIME
Codebase Architectural Manual 172 Lafayette Street, Salem, Massachusetts · Gabe Londis & Matt Driscoll · 9threalmgallery.com ↗
9th Realm Gallery Emblem

9TH REALM GALLERY

A strictly grounded technical manual and runtime showcase for the 9th Realm Gallery platform. Elevating custom tattooing into classical fine art with automated resident artist provisioning, standalone mobile PWA client pipelines, visiting guest residencies, global convention scheduling, and deep Forminator booking routing.

8
System Modules
11
Registered Shortcodes
3
Custom Post Types
5
Custom REST Endpoints
1
Resident Artist Role
100%
Client-Side HEIC Engine

✦ Interactive Feature Simulators

Real-time working testbenches demonstrating the custom PHP/JS engines built into the 9th Realm codebase.

3 BENCHES ACTIVE

1. Resident Studio & Forminator

Forminator Bridge

Tests the [artist_cards] roster and the forminator_field_hidden_field_value injection hook. Switching artists updates individual brand colors, bio metadata, and live Forminator hidden field payloads.

GL
Gabe Londis
Co-Owner · Dark Arts & Surrealism
Esoteric Archetypes & Large Black/Grey
Forminator Hidden: {hidden-1: "Gabe Londis"} | CSS Token: var(--nr-primary-color, #e65c00)
Switch Resident Artist:

2. Artist PWA & HEIC Pipeline

Client heic2any

Simulates the mobile /artist-portal/ app. Intercepts iPhone .heic camera uploads client-side with heic2any conversion before transmitting via POST /artist/gallery with SortableJS reordering.

● 9th Realm Artist PWA Service Worker: Active
Upload & Conversion Complete!
PWA Portal Actions:

3. 3D Skull & Branded CSS

VanillaTilt & Classes

Simulates the [ninth_realm_3d_skull] with cursor and mobile touch drag 3D perspective and the authentic @keyframes authenticRattle physics using assets/images/skull_cutout.png. Allows live toggling between the custom utility classes (.nr-polaroid, .nr-ornate-frame, .nr-glass-dark).

3D Interactive Skull
Interactive FX & Utilities:
MOD 01

Resident Artist Ecosystem & Automated Provisioning

Core Post Type • Nav Synchronization • Capability Mapping
👑

Resident Artist CPT & Role

CORE

Registers the custom resident_artist post type along with a dedicated WordPress user role. Authors can upload media and manage their profile while restricting Media Library visibility exclusively to their own uploads via ajax_query_attachments_args.

CPT User Roles Media Filter
register_post_type('resident_artist')
⚡

Automated Page Cloner & Nav Hook

CORE

When an artist is published, maybe_create_artist_page searches for an "Artist Template" draft, duplicates all post meta (Colibri page builder layouts), injects the page into the primary nav under "Artists", and safely preserves "Guest Artists" as the last menu node.

save_post_resident_artist Nav Menu API Auto-Provision
wp_update_nav_menu_item()
🎴

Artist Roster Cards [artist_cards]

CORE

Generates responsive multi-column artist profile cards automatically ordered by their actual WordPress navigation menu position. Embeds dynamic CSS custom properties for custom hover glows based on each artist's individual brand color.

Shortcode Nav Order Sort Dynamic CSS Glow
[artist_cards columns="3" align="center"]
🏷️

Dynamic Artist Data [artist_data]

CORE

Context-aware multi-module shortcode that auto-detects the viewed artist by current page title or manual name="" attribute. Renders biographies, responsive lightbox galleries, social icons, or dedicated booking forms.

Shortcode Auto-Detect Multi-Field Module
[artist_data field="gallery" columns="3"]
MOD 02

Progressive Web App (PWA) & HEIC Media Engine

Service Worker • Client Conversion • REST API
📱

Artist PWA Portal (/artist-portal/)

CORE

Standalone mobile web app served on /artist-portal/ backed by nr-sw.js. Features an offline network-first caching strategy, 1-year persistent authentication cookie, and tailored mobile-only management view.

Service Worker Standalone PWA Rewrite Rule
add_rewrite_rule('^artist-portal/?$')
🔄

Client-Side iPhone HEIC Converter

CORE

Solves WordPress's lack of native iPhone HEIC image support by bundling heic2any. Transparently converts high-efficiency mobile camera photos into standard JPEG files right in the user's browser before transmission to the server.

heic2any Client Conversion Zero Server Bloat
heic2any({ blob, toType: "image/jpeg" })
🖐️

SortableJS Gallery & Dynamic Manifest

Touch-friendly drag-and-drop portfolio rearranging powered by SortableJS. Saves reordered attachment IDs instantly over REST endpoint /ninth-realm/v1/artist/gallery with dynamic homescreen app icons generated via nr-manifest.json.

SortableJS REST API Dynamic Manifest
POST /wp-json/ninth-realm/v1/artist/gallery
MOD 03

Guest Tattooer Residency & Exhibition Engine

Guest CPT • Date Automation • Modal Portfolio
✈️

Visiting Artist Residency [guest_artists]

CORE

Dedicated residency management system for traveling international tattooers. Evaluates residency date ranges dynamically against server time to partition artists into "Current & Upcoming" and "Past" views without manual intervention.

CPT guest_artist Time Automation Shortcode
[guest_artists status="all" show_past_button="false"]
🪟

Interactive Guest Bio & Social Modal

Clicking any guest card activates a full-screen blurred modal populated with the artist's full biography, scheduled dates in Salem, direct Instagram/TikTok/email channels, and a high-resolution gallery grid with lightbox integration.

Dynamic Modal Esc/Backdrop Dismiss JSON Dataset
data-modal="{...}" & lightboxHtml
📐

Crop Position & Force-Current Override

Provides admin controls for _guest_artist_image_position (Top, Center, Bottom) to prevent head cutoffs in portrait cards, and a manual _guest_artist_force_current boolean switch for unannounced or extended residencies.

Post Meta Object-Position Admin Meta Box
update_post_meta($id, '_guest_artist_image_position')
MOD 04

Convention Circuit Tracker & Single Event Engine

nr_event CPT • UTC Normalization • Multi-Tier Filter
🏛️

Global Tour & Convention Hub [nr_events]

CORE

Tracks the studio's global appearances at Hell City, New York Tattoo Convention, London, and beyond. Normalizes start/end dates across all global timezones into indexed UTC timestamps for lightning-fast server-side SQL ordering.

CPT nr_event UTC Timestamping DateTimeZone API
[nr_events type="upcoming" limit="-1"]
🌍

Cascading Geographic Filter & Live Beacon

CORE

Client-side dropdown filters automatically generate when multiple countries, states, or cities are present. Computes real-time status: if an event is currently underway, displays an animated pulsing HAPPENING NOW alert badge.

Happening Now Pulse Geo Cascading Client Filtering
Ninth_Realm_Events::get_event_status()
📰

Post-Event Recaps & Single Event Template

Ships with a dedicated standalone templates/single-nr_event.php template. Supports post-event updates through _nr_event_is_update, rich text recap commentary, and awards gallery showcases.

template_include Event Updates Masonry Gallery
[nr_events type="updates"]
MOD 05

Dynamic Portfolio & View-Transitions Gallery

Dual-Source Ingestion • View Transitions • Vanilla Lightbox
🎨

Unified Global Gallery Engine

CORE

Merges artist uploads from the PWA portal with admin-curated photos into a randomized masonry feed. Features custom portal dropdown filtering leveraging the browser's native document.startViewTransition API for buttery animated layout changes.

View Transitions API Dual Ingestion Shortcode
[ninth_realm_global_gallery]
🔍

Zero-Dependency Gothic Lightbox

CORE

Injected native Vanilla JS lightbox with deep inset shadow borders, arrow navigation, keyboard controls (ESC, Left, Right), backdrop blur, and automatic DOM relocation to document.body to break out of page builder CSS stacking contexts.

Vanilla Lightbox Keyboard Nav Stacking Escape
document.body.appendChild(modal)
⭐

Piece of the Week & Bleed Hero

Renders a weekly featured artwork spotlight with artist branding and a custom consultation CTA button. Injects dynamic CSS globally into wp_head to create a full-bleed 100vw Ken-Burns-ready background behind page builder sections.

Piece of the Week Full-Bleed CSS wp_head Hook
[ninth_realm_featured_piece]
MOD 06

Occult Micro-Interactions & Branded CSS Utilities

3D Gyroscope • Sacred Draw Portal • Pendulum Skull
💀

3D Interactive Skull [ninth_realm_3d_skull]

CORE

Physics-driven 3D skull element powered by assets/images/skull_cutout.png and cta-skull.png. Leverages VanillaTilt on desktop and deviceorientation gyroscope tracking + touch-drag on mobile. Reacts to scroll position by scaling up and shifting from black-and-white to full color as it centers on screen.

skull_cutout.png VanillaTilt iOS DeviceOrientation Scroll-Linked CSS
[ninth_realm_3d_skull]
🔯

Sacred Draw Hexagon Portal Menu

CORE

Hijacks Colibri's standard mobile hamburger and replaces it with an animated occult hexagram icon. Opening expands a mystical circular clip-path layer from the button's exact coordinates with staggered animated menu links.

Clip-Path Circle Colibri Hijack Sacred Geometry
clip-path: circle(150% at var(--btn-x) var(--btn-y))
⏳

Swinging Skull & Branded Utilities

Renders the eerie swinging pendulum skull beneath navigation utilizing assets/images/skull_cutout.png (873x1024 RGBA) with scroll-linked opacity fade (handleSkullFade) and menu dropdown hover suppression (.hide-skull). Powers [ninth_realm_back_to_top] in the lower-right stone monolith box and branded CSS classes: .nr-polaroid, .nr-ornate-frame, .nr-glass-dark, and .nr-flash-grid.

skull_cutout.png Pendulum Swing Branded CSS Classes Stone Skull Top
[ninth_realm_back_to_top]
MOD 07

Forminator Smart Routing & Booking Matrix

Hidden Field Injection • Dynamic Select • Validation Bypass
🎯

Contextual Artist Injection Hook

CORE

Hooks forminator_field_hidden_field_value to detect booking forms rendered on artist pages. Automatically captures the viewed artist's name and forcefully injects it into Forminator hidden fields for targeted studio routing.

Hidden Field Hook Auto-Capture Colibri Safe
[artist_data field="booking_form" form_id="1"]
📋

Dynamic Artist Select & Validation Bypass

CORE

Populates any Forminator dropdown possessing the CSS class dynamic-artist-select with permanent residents and currently active guest artists. Pairs with bypass_dynamic_artist_select_validation to eliminate "option does not exist" server errors.

forminator_cform_render_fields Validation Bypass Dynamic Options
add_filter('forminator_cform_render_fields', ...)
✉️

Admin Email Scrubbing & Minimal Select2

Filters admin notification emails with forminator_custom_form_mail_admin_message to purge unneeded photo labels if none were submitted. Applies clean minimalist CSS overrides to remove default blue Forminator Select2 borders.

Email Cleanup Select2 Styling RegEx Scrubbing
forminator_custom_form_mail_admin_message
MOD 08

SaaS Admin Suite & Atmospheric Branding

Single Page App • AJAX Onboarding • Astronomical Math
⚡

Custom SaaS Admin Dashboard

CORE

Replaces standard WordPress admin clutter with a custom dark-mode dashboard (templates/admin-dashboard.php). Houses an AJAX artist onboarding wizard, guest roster manager, global photo organizer, and one-click cascading cleanup endpoints.

AJAX Endpoints Cascading Trash SaaS Dashboard
wp_ajax_ninth_realm_onboard_artist
🗺️

Underworld Map & Astronomical Lunar Math

CORE

Shortcode [ninth_realm_map] creates an inverted dark Leaflet map of Salem with a glowing skull marker. Shortcode [wcw_copyright] executes mathematical lunar epoch calculations to output the real-time moon phase emoji directly in PHP.

[ninth_realm_map] [wcw_copyright] Lunar Epoch Math
[ninth_realm_map lat="42.515328" lng="-70.893028"]

✦ Shortcode Directory & Technical Cheatsheet

Comprehensive reference detailing every shortcode, accepted attributes, defaults, and exact codebase behaviors.

11 SHORTCODES VERIFIED
← Swipe horizontally to view all parameters →
Shortcode / Hook Supported Attributes Default Values Technical Description & Codebase Output
[artist_name] format format="full" Extracts current page title inline. Use format="first" for conversational copy (e.g. "Book with Gabe"). Bypasses execution during REST/AJAX saves to protect builder layouts.
[artist_data] field, id, name, limit, columns, form_id, align field="bio", id="0", columns="3", form_id="1", align="center" Primary multi-module component. Fields: bio, gallery, socials, booking_form, title, profile_image, featured_piece. Auto-detects artist by page title.
[artist_cards] columns, align columns="3", align="center" Renders resident artist portfolio grid. Deduplicates titles, queries nav menu position to preserve exact menu ordering, and applies dynamic primary brand color hover glow.
[ninth_realm_global_gallery] None N/A Aggregates personal PWA uploads and admin gallery attachments. Shuffles order and injects View Transitions API filter dropdown with native vanilla lightbox.
[guest_artists] status, show_past_button status="all", show_past_button="false" Displays traveling guest tattooer grid with filter pills. Calculates active vs past residency using start/end date metadata and renders full-screen bio/gallery modal.
[nr_events] type, limit type="upcoming", limit="-1" Convention circuit display. Queries normalized UTC timestamps with multi-timezone support, cascading country/state/city dropdown filters, and live HAPPENING NOW alert badge.
[ninth_realm_featured_piece] None N/A Highlights weekly featured artwork with artist branding and custom CTA. Pairs with ninth_realm_featured_piece_dynamic_css to generate full-bleed background in wp_head.
[ninth_realm_map] lat, lng, zoom lat="42.515328", lng="-70.893028", zoom="17" Renders interactive dark Leaflet map centered on 172 Lafayette Street in Salem with custom glowing skull pin, CSS tile inversion, and Google Maps directions link.
[ninth_realm_3d_skull] None N/A Interactive 3D call-to-action skull powered by assets/images/skull_cutout.png and cta-skull.png. Leverages VanillaTilt on desktop and deviceorientation + touch drag on mobile with scroll-linked grayscale and scaling dynamics.
[ninth_realm_back_to_top] None N/A Dark stone monolith back-to-top box in lower right corner utilizing assets/images/skull_cutout.png, cracked stone texture overlay, violent rattle shake on hover/tap, and smooth window scrolling.
[wcw_copyright] business_name business_name=bloginfo('name') Dynamic copyright footer. Employs lunar epoch math based on Jan 6, 2000 to dynamically render current astronomical moon phase emoji (🌑🌒🌓🌔🌕🌖🌗🌘).
forminator_field_hidden_field_value $value, $saved_value, $field, $form_id Hook Filter Intercepts Forminator hidden fields matching artist or artist_name and injects the resident artist currently rendered on screen.
forminator_cform_render_fields $wrappers, $model_id Hook Filter Locates select fields styled with dynamic-artist-select and dynamically populates options with all resident and active guest artists.
save_post_resident_artist $post_id Hook Action Auto-generates Page from "Artist Template", copies builder post meta, and appends the new page into the primary nav menu before "Guest Artists".