Events Management

The Events Management page provides comprehensive tools for viewing, searching, filtering, and managing calendar events across your organization. This interface allows administrators and authorized users to oversee all event activities, from creation and editing to deletion and restoration.

Quick Start

To get started: Use the search box to find specific events, adjust the date range to view events from different time periods, or click the "Add" button to create new events. The table displays all events with sortable columns and bulk action capabilities.

Toolbar Functions

Primary Actions

Button Function Permission Required
+ Add Creates a new calendar event with the current date pre-selected Calendars_Events_Add permission
â?쳌 Back Returns to the previous page in browser history None
â?? Close Closes the current page or returns to Control Panel None
ð??쳌 Executes search using the text entered in the search box None

Secondary Actions

Button Function When Available
Show All Resets date filters and shows all active events Normal view mode
UnDelete Switches to deleted events view for restoration Normal view mode
â?쳌 Back to Events Returns from deleted events view to normal events view Deleted events view mode

Filtering Controls

Control Purpose Behavior
Search Box Find events by name, description, organization, username, or Event ID Searches across multiple fields simultaneously
User Dropdown Filter events by specific user or workgroup member Admins see all users; regular users see workgroup only
Start Date Set beginning of date range for event filtering Defaults to first day of current month
End Date Set end of date range for event filtering Defaults to last day of current month
All Dates Checkbox Show events from all time periods, ignoring date range Disables date inputs when checked

Events Data Table

Column Descriptions

Column Content Sorting
Checkbox Select individual events for bulk operations Not sortable
Start Event start date in MMM-DD-YYYY format Sortable by date
End Event end date in MMM-DD-YYYY format Sortable by date
Event Event name/title (clickable link to edit) Sortable alphabetically
Organization Filter Dropdown to filter by organization/category Not sortable
User Event creator's alias or username Sortable alphabetically
Actions Edit, Delete, View, Widget, Copy buttons Not sortable
ID Unique Event ID number Sortable numerically

Row Color Coding

Color Meaning Condition
Light Blue Today's events Event start date equals current date
Light Green Past events Event start date is before current date
Teal Completed events Organization is "Done" or end date has passed
White/Gray Future events Event start date is after current date

Individual Event Actions

Action Function Permission Required
Edit Opens event editing form in calendar interface Calendars_Events_Edit permission
Delete Soft-deletes the event (can be restored) Calendars_Events_Delete permission
View Opens event details in popup window None
Widget Creates a widget for this event None
Copy Creates a duplicate of this event None

Bulk Operations

Selecting Multiple Events

  1. Use individual checkboxes in the first column to select specific events
  2. Click the header checkbox to select/deselect all visible events
  3. Selections persist across DataTable pages when using bulk operations
  4. The "Check All" function only affects currently visible rows

Bulk Delete Workflow

  1. Select events using checkboxes
  2. Click the ð??? Delete Selected button
  3. Confirm the deletion in the popup dialog
  4. Events are soft-deleted (active=2) and can be restored
  5. Page refreshes showing remaining active events

Bulk Restore Workflow

  1. Click the UnDelete button to view deleted events
  2. Select deleted events using checkboxes
  3. Click the â?¶ Un-Delete Selected button
  4. Confirm the restoration in the popup dialog
  5. Events are restored (active=1) and return to normal view

Permanent Deletion

Warning: Permanent deletion removes events completely from the database and cannot be undone. This action is only available in the deleted events view and requires additional confirmation.
  1. Navigate to deleted events view
  2. Select deleted events for permanent removal
  3. Click the â?? Permanently Delete button
  4. Confirm the permanent deletion (this cannot be undone)
  5. Events are completely removed from the database

Search and Filtering

Search Capabilities

The search function performs a comprehensive search across multiple event fields:

  • Event Name: Searches event titles and names
  • Event Description: Searches detailed event descriptions
  • Organization: Searches organization/category assignments
  • Username: Searches event creator usernames
  • Event ID: Searches numeric Event IDs

Date Range Filtering

Feature Behavior Persistence
Default Range Current month (1st to last day) Saved in client session
Custom Range User-defined start and end dates Remembered across sessions
All Dates Ignores date range, shows all events Checkbox state saved
Reset Dates Returns to current month default Clears saved preferences

Organization Filtering

The organization dropdown in the table header provides quick filtering:

  • All: Shows events from all organizations
  • Specific Organizations: Filters to show only events from selected organization
  • Filter Options: Populated from the Filters table in the database
  • Immediate Effect: Filtering applies immediately when selection changes

Permissions and Access Control

Required Permissions

Action Permission Fallback Access
View Events Page Events permission Admin1 or Client.ID = 1
Add New Events Calendars_Events_Add Admin1 or Client.ID = 1
Edit Events Calendars_Events_Edit Admin1 or Client.ID = 1
Delete Events Calendars_Events_Delete Admin1 or Client.ID = 1

Data Visibility Rules

Administrator Access (Admin1 or Client.ID = 1):

  • Can view all events from all users and organizations
  • Can filter by any user from the complete user list
  • Can access deleted events view for restoration
  • Can perform permanent deletions

Regular User Access:

  • Can view own events (where Ref_ID matches Client.ID)
  • Can view workgroup events (based on workgroup membership)
  • User filter shows only workgroup members
  • Cannot access deleted events view

DataTable Features

Interactive Controls

Feature Location Function
Pagination Bottom of table Navigate through multiple pages of results
Page Size Top left of table Choose 25, 50, 100, or All records per page
Search Box Top right of table Real-time filtering of visible results
Column Sorting Column headers Click to sort ascending/descending
State Saving Automatic Remembers sort order, page size, and position

Default Configuration

  • Page Size: 25 events per page
  • Default Sort: Event ID descending (newest first)
  • State Persistence: Settings saved in browser localStorage
  • Responsive Design: Table adapts to different screen sizes

Calendar Integration

Search Results Calendar

When a search query is active, an embedded calendar view appears below the events table:

  • Shows visual calendar with search results highlighted
  • Provides alternative view of filtered events
  • Embedded in iframe for seamless integration
  • Automatically filters based on current search terms

Event Creation Workflow

  1. Click the + Add button
  2. System opens calendar interface with current date pre-selected
  3. Complete event details in the calendar form
  4. Save event to return to events management page
  5. New event appears in the events table

Troubleshooting

Common Issues and Solutions

Issue Possible Cause Solution
No events showing Date range too restrictive Check "All Dates" or expand date range
Add button disabled Insufficient permissions Contact administrator for Calendars_Events_Add permission
Search not working Conflicting filters active Clear organization filter and date restrictions
Bulk operations failing No events selected Use checkboxes to select events before bulk actions

Performance Optimization

  • Use date ranges to limit large result sets
  • Apply organization filters before searching
  • Limit page size for faster loading with large datasets
  • Use specific search terms rather than broad queries

Summary

The Events Management page provides comprehensive tools for managing calendar events with advanced filtering, bulk operations, and permission-based access control. Users can efficiently search, sort, and organize events while maintaining proper data security through workgroup restrictions. The integrated DataTable interface offers powerful sorting and pagination capabilities, making it easy to work with large event datasets. Regular users see only their own and workgroup events, while administrators have full system access including deleted event recovery capabilities.