Every event
deserves a
momntly

Installation

1. Download the momntly.php plugin file
2. In WordPress, go to Plugins → Add New → Upload Plugin
3. Upload and activate the plugin
4. The database tables are created automatically on activation
5. Go to Momntly → Events to create your first event

Momntly requires WordPress 6.0+ and PHP 7.4+. No other dependencies needed — everything is self-contained in one file.

Creating Events

Go to Momntly → Events → Add New and fill in the event details:

• Event Name — Displayed to guests (e.g., "Smith Wedding")
• Slug — The URL-friendly name, auto-generated from the event name
• Date, Time, Venue — Shown on the guest page and recap
• Password — Optional access control. Leave blank for open access
• Status — Active events are accessible to guests

Each event gets a unique URL: yoursite.com/event/smith-wedding

Guest Experience

Guests access your event by scanning a QR code or visiting the event URL on their phone. They'll see tabbed sections for:

• Request — Submit song requests with name
• Notes — Leave text messages for the DJ
• Gallery — Browse event photos
• Upload — Take and upload photos
• Audio — Record voice messages (Pro)
• Share — Copy link, text, email the event to friends

Now Playing Sync

Momntly syncs with your DJ software to show guests what's currently playing in real time.

Supported software:

• Algoriddim djay Pro (Mac) — Uses the companion macOS sync app
• OtsAV DJ Pro (Windows) — Uses the Windows sync script

Configure your API secret in Momntly → Settings and enter your site URL in the sync app. Tracks update within 4 seconds.

Audio Guestbook

The browser-based audio guestbook lets guests record voice messages directly from the Audio tab on the event page. Recordings are saved as WebM files and appear in:

• The event recap page with inline playback
• Momntly → Audio Guestbook admin page
• Downloadable ZIP archive per event

Physical Guestbook Phone

The Pro plan includes a Raspberry Pi script that turns a vintage rotary phone into a physical audio guestbook. See the included build guide for:

• Parts list (~$50-100 in electronics)
• Hardware assembly instructions
• Software setup and configuration
• Event day checklist

The phone records locally to the SD card and syncs to Momntly via the REST API when WiFi is available. No recordings are ever lost.

MOMNTLY_URL = "https://yoursite.com/wp-json/momntly/v1/audio"
EVENT_SLUG  = "smith-wedding-2026"

Shortcodes

Embed Momntly features on any WordPress page:

[momntly_event event="slug"]           Full guest experience page
[momntly_now_playing event="slug"]      Now playing widget
[momntly_request_form event="slug"]     Song request form only
[momntly_gallery event="slug"]          Photo gallery only
[momntly_recap event="slug"]            Post-event recap page
[momntly_testimonials]                  Display approved reviews
[momntly_testimonials limit="5"]        Limit number shown

Branding & Customization

Customize your look in Momntly → Settings → Colors. The 7-field color system lets you control:

• Accent color — buttons, highlights, active elements
• Background — page background
• Card background — content cards
• Border color
• Text colors — primary, secondary, muted

Colors are applied via CSS variables so they update instantly across all guest-facing pages.