Appearance

Events Module ​

The Events module allows you to create and manage events, handle ticket sales, and manage registrations. This comprehensive guide covers all event management features including tickets, registrations, and frontend event display.

Table of Contents ​

  1. Overview
  2. Accessing Events
  3. Creating an Event
  4. Event Categories
  5. Event Tickets
  6. Managing Events
  7. Event Registrations
  8. Frontend Event System
  9. Best Practices

Overview ​

Features ​

  • ✅ Create and manage events
  • ✅ Event categories
  • ✅ Ticket types and pricing
  • ✅ Registration management
  • ✅ Event capacity limits
  • ✅ Event dates and times
  • ✅ Event locations
  • ✅ Featured events
  • ✅ Frontend event pages
  • ✅ Event calendar view

Admin Routes ​

  • Event List: /admin/events
  • Create Event: /admin/events/create
  • Edit Event: /admin/events/{id}/edit
  • Event Categories: /admin/event-categories
  • Event Tickets: /admin/events/{event}/tickets
  • Registrations: /admin/event-registrations

Frontend Routes ​

  • Events Page: /events
  • Event Detail: /events/{slug}
  • Event Registration: /events/register

Accessing Events ​

From Admin Panel ​

  1. Log in to admin panel
  2. Navigate to Support → **Events`
  3. Or go directly to: /admin/events

Permissions Required ​

  • View Events: view events permission
  • Create Events: create events permission
  • Edit Events: edit events permission
  • Delete Events: delete events permission
  • Manage Events: manage events permission

Creating an Event ​

Step 1: Access Create Page ​

  1. Go to Events → Create New Event
  2. Or navigate to: /admin/events/create

Step 2: Basic Information ​

Event Title ​

  • Name of the event
  • Required field
  • Make it clear and descriptive
  • Example: Annual Tech Conference 2024

Slug ​

  • Auto-generated from title
  • Can be edited manually
  • Must be unique
  • Used in event URL
  • Example: annual-tech-conference-2024

Short Description ​

  • Brief event summary
  • Shown in event listings
  • Recommended: 100-200 characters
  • Example: Join us for the biggest tech conference of the year

Step 3: Event Details ​

Full Description ​

Use rich text editor for detailed event information:

Include:

  • Event Overview: What the event is about
  • Agenda: Schedule and sessions
  • Speakers: Featured speakers
  • What to Expect: Benefits of attending
  • Who Should Attend: Target audience
  • Venue Information: Location details
  • Contact Information: How to reach organizers

Step 4: Event Information ​

Event Dates and Times ​

Start Date & Time:

  • Event start date
  • Event start time
  • Required fields

End Date & Time:

  • Event end date
  • Event end time
  • Required fields

Registration Deadline:

  • Last date to register
  • Optional field
  • Auto-closes registration

Event Location ​

Location Type:

  • Physical Venue: In-person event
  • Online/Virtual: Virtual event
  • Hybrid: Both in-person and online

Physical Venue Details:

  • Venue Name: Name of location
  • Address: Full address
  • City: City name
  • State/Province: State or province
  • Country: Country name
  • Postal Code: ZIP/postal code
  • Map Link: Google Maps link (optional)

Virtual Event Details:

  • Platform: Zoom, Teams, etc.
  • Meeting Link: Virtual meeting URL
  • Access Instructions: How to join

Event Capacity ​

Maximum Attendees:

  • Total capacity
  • Optional field
  • Registration stops when reached
  • Example: 500

Waitlist:

  • Enable waitlist
  • Allow registration when full
  • Notify when spots available

Step 5: Event Media ​

  1. Click Set Featured Image
  2. Upload or select image
  3. Recommended size: 1200x675px
  4. Used in:
    • Event listings
    • Event detail page
    • Social sharing
  1. Click Add to Gallery
  2. Upload multiple images
  3. Showcase:
    • Previous events
    • Venue photos
    • Speaker photos
    • Event highlights
  4. Reorder by dragging

Step 6: Event Settings ​

Status ​

  • Published: Visible on website
  • Draft: Saved but not published
  • Cancelled: Event cancelled
  • Completed: Event finished
  • Toggle: Mark as featured
  • Featured events highlighted
  • Shown prominently
  • Use for important events

Registration Settings ​

Enable Registration:

  • Allow online registration
  • Registration form available
  • Payment processing (if tickets)

Require Login:

  • Users must log in to register
  • Or allow guest registration

Auto-Confirm:

  • Automatically confirm registrations
  • Or require manual approval

Step 7: Category Assignment ​

Select Category ​

  1. Choose existing category
  2. Or create new category
  3. Can assign to multiple categories
  4. First category is primary

Common Categories:

  • Conferences
  • Workshops
  • Webinars
  • Networking Events
  • Training Sessions
  • Seminars

Step 8: SEO Settings ​

Meta Information ​

  • Meta Title: Search engine title
  • Meta Description: Search result description
  • Keywords: Relevant keywords

Step 9: Save Event ​

  • Save Draft: Save without publishing
  • Publish: Make event live
  • Toggle Status: Quick status change
  • Toggle Featured: Quick featured toggle

Event Categories ​

Creating Categories ​

  1. Go to Events → Categories
  2. Click Create New Category
  3. Enter:
    • Name: Category name
    • Slug: URL-friendly version
    • Description: Category description (optional)
  4. Click Save

Managing Categories ​

  • Edit: Modify category details
  • Delete: Remove category (events not deleted)
  • View Events: See all events in category

Event Tickets ​

Accessing Ticket Management ​

Route: /admin/events/{event}/tickets

  1. Open event
  2. Click Manage Tickets
  3. Or navigate directly to ticket management

Creating Ticket Types ​

  1. Click Create Ticket Type
  2. Enter ticket details:

Ticket Information ​

Ticket Name:

  • Type name
  • Example: Early Bird, General Admission, VIP

Description:

  • What's included
  • Benefits
  • Restrictions

Price:

  • Ticket price
  • Can be free ($0)
  • Example: $99.00

Quantity Available:

  • Number of tickets
  • Optional (unlimited if not set)
  • Example: 100

Sale Start Date:

  • When sales begin
  • Optional

Sale End Date:

  • When sales end
  • Optional

Minimum Per Order:

  • Minimum tickets per purchase
  • Default: 1

Maximum Per Order:

  • Maximum tickets per purchase
  • Default: 10

Managing Tickets ​

  • Edit: Modify ticket details
  • Delete: Remove ticket type
  • View Sales: See ticket sales statistics

Managing Events ​

Event List View ​

Access at: /admin/events

List Features ​

Search:

  • Search by title
  • Search by description
  • Search by location
  • Real-time results

Filters:

  • Category: Filter by category
  • Status: Published/Draft/Cancelled
  • Featured: Featured/Not Featured
  • Date Range: Filter by date

Sorting:

  • By Title (A-Z, Z-A)
  • By Date (Upcoming/Recent)
  • By Category
  • By Status

Displayed Information ​

  • Event Title: Event name
  • Category: Assigned category
  • Date: Event date
  • Location: Event location
  • Status: Published/Draft
  • Featured: Featured badge
  • Registrations: Registration count

Editing Events ​

  1. Click Edit on event
  2. Make changes
  3. Click Update
  4. Changes saved

Deleting Events ​

  1. Click Delete on event
  2. Confirm deletion
  3. Warning: Cannot be undone
  4. Event removed
  5. Registrations preserved (for records)

Bulk Operations ​

Bulk Delete ​

  1. Select multiple events
  2. Click Bulk Actions → Delete
  3. Confirm deletion
  4. All selected events deleted

Event Registrations ​

Viewing Registrations ​

Route: /admin/event-registrations

Features:

  • All registrations across all events
  • Filter by event, date, status
  • Search functionality
  • Registration statistics

Registration Information ​

Displayed:

  • Registrant: Name and email
  • Event: Event name
  • Ticket Type: Ticket purchased
  • Quantity: Number of tickets
  • Date: Registration date
  • Status: Registration status
  • Payment: Payment status

Registration Details ​

Route: /admin/event-registrations/{registration}

Includes:

  • Registrant information
  • Contact details
  • Event information
  • Ticket details
  • Payment information
  • Status history
  • Notes

Managing Registrations ​

Confirm Registration ​

Route: /admin/event-registrations/{registration}/confirm

  1. Click Confirm button
  2. Registration confirmed
  3. Confirmation email sent (if enabled)

Cancel Registration ​

Route: /admin/event-registrations/{registration}/cancel

  1. Click Cancel button
  2. Enter cancellation reason (optional)
  3. Registration cancelled
  4. Refund processed (if applicable)
  5. Cancellation email sent

Delete Registration ​

Route: /admin/event-registrations/{registration}

  1. Click Delete button
  2. Confirm deletion
  3. Warning: This removes registration record
  4. Does not process refund
  5. Use cancel feature instead

Frontend Event System ​

Events Page ​

URL: /events

Features:

  • All published events
  • Category filtering
  • Date filtering
  • Search functionality
  • Event cards showing:
    • Featured image
    • Event title
    • Date and time
    • Location
    • Short description
    • Register button

Event Detail Page ​

URL: /events/{slug}

Features:

  • Full event information
  • Event gallery
  • Date and time details
  • Location information
  • Ticket types and pricing
  • Registration form
  • Related events
  • Social sharing

Event Registration ​

URL: /events/register

Form Fields:

  • Event Selection: (if multiple events)
  • Ticket Selection: Choose ticket type
  • Quantity: Number of tickets
  • Registrant Information:
    • First Name
    • Last Name
    • Email
    • Phone
  • Payment Information: (if paid tickets)
  • Additional Attendees: (if multiple tickets)

Process:

  1. Select event and tickets
  2. Enter information
  3. Complete payment (if required)
  4. Receive confirmation
  5. Confirmation email sent

Best Practices ​

Event Creation ​

  1. Clear Information:

    • Provide all details
    • Include date, time, location
    • Add agenda/schedule
    • List speakers/features

  2. Early Promotion:

    • Create events early
    • Set up tickets in advance
    • Promote on website
    • Use featured status

  3. Ticket Pricing:

    • Offer early bird pricing
    • Create multiple tiers
    • Include VIP options
    • Set appropriate limits

Registration Management ​

  1. Quick Response:

    • Confirm registrations promptly
    • Send confirmation emails
    • Provide event updates
    • Answer questions quickly

  2. Capacity Management:

    • Monitor registration count
    • Enable waitlist when full
    • Communicate availability
    • Update capacity if needed

  3. Communication:

    • Send reminders before event
    • Provide event updates
    • Share important information
    • Follow up after event

Troubleshooting ​

Event Not Displaying ​

Solutions:

  1. Check status (must be Published)
  2. Verify date is in future (if filtering)
  3. Clear cache
  4. Check frontend settings

Registration Not Working ​

Solutions:

  1. Verify registration enabled
  2. Check ticket availability
  3. Verify payment gateway (if paid)
  4. Check registration deadline

Tickets Not Showing ​

Solutions:

  1. Verify tickets created
  2. Check sale dates
  3. Verify ticket availability
  4. Check ticket limits

Last Updated: [Date will be updated during final review]

Released under the MIT License.

Copyright © 2024 OmniSuite CMS