[XenCustomize] Events Manager 2.3.4

What's New​

• Now compatible with XenForo 2.3.0+
• XenForo 2.3.0 is now the minimum requirement for this (1.3.x & 2.3.x) addon version.

New Features and Enhancements​

• Card Grid view is now available for event categories. (Suggested & funded by @Jimmi) (v1.3.0)
• Added a new admin option to choose the display mode for event categories. This allows admins to customize how events are displayed within categories. (Suggested & funded by @Jimmi) (v1.3.0)
  • Category Display Mode
    • List
    • Card Grid
• Extended the following options to display or hide blocks in the side navigation to also apply on event category pages: (Suggested & funded by @Jimmi) (v1.3.0)
  • Display Categories In Side Navigation.
  • Display Filter Events In Side Navigation
  • Display Upcoming Events In Side Navigation.
• Improved Sub-Navigation Link for Upcoming Events: Updated the link to support both user-friendly and non-friendly URLs. (v1.3.1)
• Improved Sub-Navigation Link for Private Events: Updated the link to support both user-friendly and non-friendly URLs. (v1.3.1)
• Event Export to .ics Format (Suggested by @stromb0li) (v1.3.2)
  • Introduced the ability to export both individual events and entire categories to the .ics format, compatible with all major calendar applications, including iCal on iOS.
  • Users can download .ics files directly from event, category pages or index, with smart file naming based on the event or category title for easy identification.
  • The .ics exports include all essential event details: title, start/end date, time, and description, ensuring smooth integration with calendar apps.
• New Widget - Events Happening Now! (v1.3.3)
  • Ongoing Events (Carousel Style)
  • Introduced an "Ongoing" ribbon to highlight events happening now.
  • Displays event end date and time.
  • The installer automatically creates the Ongoing Events widget on a fresh install.
  • The upgrade script automatically creates the Ongoing Events widget during upgrades.
• Enhancements to Featured Event Carousel (v1.3.3)
  • Added a "Featured" ribbon to highlight featured events.
  • Replaced event creator and last update information with event date and time.
• Ongoing Event Indicator on Event View Page (v1.3.3)
  • Ongoing events now display an "Ongoing" label with an animated blinking dot.
• Enhancements on Event View Page (v1.3.3)
  • Header: Removed event creator, create date, and last update information for a cleaner look.
  • Sidebar: Minor adjustments to sidebar and event image styling.
• Added support for webp file extension in the allowed file extensions for event photos. (v1.3.3)
• Refined the Card Grid design for a more polished appearance. (v1.3.3)
• Improved overall code efficiency and reliability. (v1.3.3)
• Added XF 2.3-specific "Image Optimization" support for both "Event Image" and "Event Banner." (v2.3.4)
• Added the ability to rebuild existing "Event Images" using the "Optimize event images" option in Tools > Rebuild caches. (v2.3.4)
• Added the ability to rebuild existing "Event Banners" using the "Optimize event banners" option in Tools > Rebuild caches. (v2.3.4)

New Features​

• Calendar Display Mode (Suggested by @btmgreg @JBS @Dragonsys @smallwheels and others)
  • Added a brand new Calendar display mode
  • Easy switch between the available display modes
    • Calendar
    • List
    • Card Grid
  • Filters support available in List and Card Grid display modes
• Calendar Options
  • Added new options to control and customize the Calendar:
  • Event List Display Mode (Index)
    • Calendar
    • List
    • Card Grid
• Default Calendar View
  • Set the initial view of the Calendar. Select the default view that best suits your needs or the preferences of your users.
    • Basic Month View
    • Basic Week View
    • Basic Day View
    • List Year View
    • List Month View
    • List Week View
    • List Day View
• Enable Agenda Views for Calendar
  • Enabling this option transforms the week and day views of your calendar. Events will be displayed as distinct blocks within the calendar, visually representing their duration and the specific times they occur. This feature is particularly useful for a more detailed and time-specific overview of events.
• Week Start Day
  • This option allows you to set which day your calendar week begins. Adjusting this setting will change the first day of the week across all calendar views. This is particularly useful for matching the calendar's weekly cycle with your regional or personal preference (e.g., starting the week on Sunday or Monday).
• Include Weekends in Calendar Views
  • Use this option to control the display of weekends (Saturday and Sunday) in your calendar. If disabled, the calendar views will not show columns for Saturday and Sunday. This setting is useful for focusing the calendar on typical business days or customizing it to fit non-standard work weeks.
• Default List View Timescale
  • This setting determines the default timescale used in list views when displaying upcoming events. Choose from year, month, week, or day to set the preferred duration and scope for event lists. Adjusting this setting allows you to tailor the event list view to best fit the needs of your users or the nature of your events.
    • Yearly View - Displays events for the entire year.
    • Monthly View - Displays events for the current month.
    • Weekly View - Displays events for the current week.
    • Daily View - Displays events for the current day.
• Calendar Style Properties
  • Added new color style properties to customize the styling of Calendar Events:
    • Calendar Event Background Color
    • Calendar Event Text Color
    • Calendar Event Border Color
• RSVP Registration Method (Suggested by @smallwheels)
  • Choose the method for event RSVP registration. Select 'One-Click Quick RSVP Register' for a streamlined registration process, or 'RSVP Status Window' to allow users to select their RSVP status during registration:
    • Quick RSVP Registration
    • Choose RSVP Status during Registration
• Full Day Event
  • Added "Full Day Event" Feature (Suggested by @smallwheels)
  • Event creators can now utilize a new checkbox option to mark an event as a full day. This enhancement eliminates the need to manually enter start and end times for such events, streamlining the creation process and saving clicks. Note that it remains essential for event creators to accurately specify the start and end dates for these full day events.
• Repeating Events
  • Introduced "Repeating Events" Functionality (Suggested by @smallwheels)
  • A significant update for event creators is the addition of the "Repeating Events" feature.
  • This new functionality allows event creators to designate an event as a repeating one via a checkbox.
  • Upon selection, creators have the flexibility to set the event to repeat at regular intervals - daily, weekly, monthly, or yearly.
  • Furthermore, the duration of the repeating event can be customized to either continue indefinitely ("Forever"), conclude on a specific date, or repeat for a predefined total number of times.
• Category Choices for Upcoming Events Widget
  • Implemented the ability to select applicable categories when creating/editing Upcoming Events Widget. (Suggested by @Gemma)
• Event Time Zone
  • Implemented a feature for selecting a time zone for each event during its creation and editing.
• Cron entry
  • Added a cron entry to auto rebuild next event dates.
• Implemented new filter that let users sort events list by event start date (Suggested by @smallwheels). (v1.2.2)
  • Added a new default sorting option 'Event Start Date' in the Admin CP under 'Default Event List Order'. When selected, (upcoming) events are displayed by their start dates.
    • Note: Applied to the list and card grid display modes only.
• Enhanced the "Upcoming Events" link in the public navigation to include only active events with future dates or repeating schedules. (v1.2.2)
• Added more space between event detail and custom fields (Suggested by @smallwheels). (v1.2.2)
• Filter Events by RSVP Status:
  • Users can now filter events in List and Card Grid display modes based on their RSVP registration status. (Suggested and funded by @requo) (v1.2.3)
  • Events I'm attending (Filter RSVP Status "Attending")
  • Events I might attend (Filter RSVP Status "Maybe")
  • Events I'm not attending (Filter RSVP Status "Not Attending")
• Max Events Per User Permission:
  • Added a new user group permission "Max events per user" to limit the maximum number of events per user. (Suggested and funded by @requo) (v1.2.3)
  • When the max limit is reached, it displays a friendly error message: "Your max event count is X, and you have reached the limit."
• Delete RSVP Registration Status:
  • Users now have the ability to delete their RSVP registration status. (Suggested and funded by @requo) (v1.2.3)
  • Added a new permission "Delete RSVP status" to allow users to delete their RSVP registration status.
• Can Add Repeating Event Permission:
  • Added a new user group permission "Can add repeating event" to enable inserting repeating events. (Suggested and funded by @requo) (v1.2.3)
  • Users with permission can see "Repeating options" on event create and edit forms.
  • Users without this permission cannot set "Repeating options" on event create and edit forms.
• Hide Custom Fields Section:
  • In create/edit event forms, the "Custom fields" section is now hidden if no custom fields exist. (Suggested and funded by @requo) (v1.2.3)
• Display Attendees Count:
  • Attendees count is now displayed in both list and grid display modes. (Suggested and funded by @requo) (v1.2.3)
  • The count of attendees is calculated based on those who have registered with an RSVP status of "Attending".
  • Events with zero attendees are ignored and do not display an attendee count.
• Display Repeating Status:
  • Repeating status is now displayed in both list and grid display modes. (Suggestion) (v1.2.3)
• Display Event Active Status:
  • Event active status is also displayed in grid display mode. (Suggestion) (v1.2.3)
• Added support for private event permission View private event at the category level. (Suggested by @Michael) (v1.2.6)
• Users will now see a permission error if trying to access a private event without the View private event permission. (Suggestion) (v1.2.6)
• Private events are now clearly indicated on event listing (list & grid display mode). (Suggestion) (v1.2.6)
• Added labels on the Event view page to indicate event status: (Suggestion) (v1.2.6)
  • Active Event: Displayed with a Active label.
  • Repeating Event: Indicated by a Repeating label.
  • Private Event: Shown with a Privatelabel.
    • Added a new phrase xcu_em_private
• Enhanced event photos tab to show the photo count beside the tab label for quick visibility of associated photos. (Suggested by @Morrus) (v1.2.6)
• Enhanced discussion tab to display reply count alongside the label, showing only when replies exist for increased engagement awareness. (Suggested by @Morrus) (v1.2.6)
• Added options to display or hide blocks in the side navigation. (Suggested by @Jimmi) (v1.2.6)
  • Display Categories In Side Navigation.
  • Display Filter Events In Side Navigation.
  • Display Upcoming Events In Side Navigation.

Changes:​

• Event start and end date fields are now required fields when creating and editing events.
• When it's a full-day event or the start and end dates are the same and only the times differ, then on the event view page, the end date section will show only the end time. For example: Start Jan 16, 2024 at 12:00 AM, End 2:00 AM
• On the event index page, in the list display mode, we now display only the start day, month, and year. The end date has been removed from this area to better accommodate repeat events, as well as to reduce clutter and maintain consistency with the other display mode, Card Grid. This area will undergo further changes once we implement Event Reviews, as there will be space allocated for star ratings.
• The 'Manage Your Active Events' page, along with many other sections where dates are displayed, has been updated to accurately reflect the dates in line with our newly implemented time zone and repeating event features.
• Changed the Card Grid display mode icon from fa-th-large to fa-table for better compatibility with custom themes. (v1.2.1)
• Changed the Start date icon from fa-calendar-day to fa-calendar for better compatibility with custom themes. (v1.2.1)
• Changed the fa-calendar-star to fa-calendar and fa-image-polaroid throughout the add-on for better compatibility with custom themes. (v1.2.1)
• Updated the 'Upcoming Events' and 'Private Events' links in public navigation, as well as the Events count link in member stats, to use the Card Grid display mode by default for event lists. (v1.2.2)
• Updated the 'Upcoming Events' widget title link to use the Card Grid display mode by default for event lists. (Suggested by @requo) (v1.2.3)
• Added post upgrade script to auto apply the following new user group permissions (v1.2.3)
  • Add Repeating Event
  • Delete RSVP Status
  • Max Events Per User (This permission needs to be adjusted manually)
• Added a maximum length constraint of 150 characters to the 'title' attribute in the event entity. Previously, although the 'title' column in the database was limited to 150 characters, this restriction was not reflected in the entity. (Suggested by @JustinHawk) (v1.2.5)
• Increased the maximum length of the 'last_event_title' column in the 'xf_xcu_event_category' table from 100 to 150 characters. This change was also applied to the category entity. (Suggested by @JustinHawk) (v1.2.5)
• Changed the event 'Description' label to 'Tag line' for clarity and added a new phrase 'xcu_em_tagline'. (Suggested by @JustinHawk) (v1.2.5)
• Modified the event location display logic to show a standardized message when the event location is not specified. (v1.2.6)
  • Added a new phrase xcu_em_event_location_is_not_provided.

Screenshots​

• RSVP Functionality:
  • RSVP Section: Now located right under the event dates and notes for easy access.
  • Quick RSVP: One-click RSVP registration for a smoother user experience.
  • RSVP Status: Users can now indicate their participation as:
    • Attending
    • Maybe
    • Not Attending
  • RSVP Participants List: You can choose where to display it:
    • Option to show it under the RSVP section for quick visibility.
    • Option to display it in the event page’s sidebar for a compact view.
  • Maximum Attendees: Control the number of event attendees by setting a maximum limit. RSVPs close automatically once the limit is reached. You can also set it to 0 for unlimited attendees.
• Advertising Positions Added: Boost your ad revenue with new ad spots. [1.1.1]
  • [XenCustomize] Events Manager: Event view above content
  • [XenCustomize] Events Manager: Event view below content
• Styling Improvements: [1.1.1]
  • More use of classes and color properties for better dark style support.
  • Templates changed:
    • xcu_event.less
    • xcu_event_view
    • xcu_event_view_macros
    • xcu_event_view_rsvp.less
• Event Start and End Time: Now you can set exact start and end times for your events! It's all about making planning easier and keeping everyone in sync. [1.1.2]
• Enable RSVP System: Want more control over your event attendance? You got it! Turn the RSVP system on or off for each event, depending on what suits your plan best. [1.1.2]
• Events Tab View Permission: Keep things streamlined and relevant with permission-based visibility of the Events tab, ensuring users only see what they need to. [1.1.2]
• Event Creator Counted in Attendees (Suggested by @smallwheels) [1.1.3]
  • Starting with version 1.1.3, the event organizer (the user who owns the event) will be included in the total attendee count upon registration, and the maximum attendee limit will be adjusted accordingly.
• Streamlined Event Time Fields. [1.1.3]
  • Event Time Fields are now narrower on desktop screens, enhancing user-friendliness. (Suggested by @smallwheels)
• Repositioned Date and Time Fields. [1.1.3]
  • Event date and time fields are now more prominently placed on the add/edit event page for easier access.
• Event Banners (Suggested and funded by @JBS) [1.1.4]
  • Creators can now add a large banner (850x478) to their events. It shows up when someone views the event.
  • Existing event banner images can be replaced or removed anytime.
• Allow Event Banners [1.1.4]
  • Admins can turn the event banner feature on or off for the entire add-on.
  • This feature is off by default.
• Style Properties (Suggested by @Azure Ace @Paul) [1.1.5]
  • Added style properties to Event view sections, making it easier to customize styles, especially for dark themes.
    • Event view section
      • Start background
      • Start title (Text, Background, and Freeform CSS/LESS code)
      • End background
      • End title (Text, Background, and Freeform CSS/LESS code)
      • Notes background
      • Notes title (Text, Background, and Freeform CSS/LESS code)
      • RSVP background
      • RSVP title (Text, Background, and Freeform CSS/LESS code)
• Allow Event Notes (Suggested by @Azure Ace) [1.1.5]
  • Admins can turn the event notes feature on or off for the entire add-on.
  • If enabled, event creators will have the option of setting multiple event notes.
• Display Location Below Content[1.1.5]
  • If disabled, the 'Location' link, map icon, and button will not appear in the content below.
• Display Purpose Below Content (Suggested by @smallwheels) [1.1.5]
  • Admins can turn the event purpose feature on or off for the entire add-on.
  • If disabled, creators won't have the option to enter a 'Purpose' when adding or editing an event. Also, any existing 'Purpose' data will not be displayed.

1. Categories system with Permissions and:
   • Title
   • Description
   • Parent category
   • Display order
   • Automatically create thread in forum
   • Automatically created thread prefix
   • Available fields
   • Available prefixes
   • Require users to select a prefix
2. Event Prefixes with prefix groups support.
   • All the XenForo standard functionality for prefixes available.
3. Event Custom Fields:
   • Title
   • Description
   • Display location:
     • Before message
     • After message
     • Extra information tab
     • Own tab
   • Display order
   • Applicable categories
   • Field type
     • Single-line text box
     • Multi-line text box
     • Rich text box
     • Drop down selection
     • Radio buttons
     • Check boxes
     • Multiple-choice drop down
     • Star rating
   • XenForo standard functionality for custom fields available.
4. Add/edit Event:
   • Title with Prefix support
   • Description
     • Provide a very brief description of your event post.
   • Event detail (Full rich editor with attachment support)
   • Custom fields
   • Event information:
     • Event type
     • Event notes
     • Location (auto complete, requires Google API key)
     • Purpose
     • Organizer
     • Event start date
     • Event end date
   • Notification preferences:
     • Enabled
       • Enable with Caution: Only activate this option if you wish for this event to be displayed in the “Upcoming Events” widget. Furthermore, a “User is on Event” banner will appear on your profile and thread messages throughout the event dates. Proceed with enabling this option thoughtfully.
   • Upload event image
5. User Group Promotion:
   • Automatically group users on event.
   • Cron entry
6. Event View with tabs:
   • Overview
   • Location Map
   • Photos
   • Discussion
   • Extra Info (Custom fields)
7. Event Index with:
   • Events content listing
   • Categories
   • Pagination
   • Filters
     • Title
     • Location
     • Prefix
     • Posted by
     • Sort by Title, Last update and Submission date
   • Widgets Default widgets pre-installed (Featured Events and Upcoming Events)
   • Widget Positions
   • Inline moderation support
     • Delete events
     • Undelete events
     • Approve events
     • Unapprove events
     • Feature events
     • Unfeature events
     • Reassign events
     • Move events
     • Apply prefixes
8. Widgets:
   1. Events Manager: Featured Events
   2. Events Manager: Upcoming Events
9. Widget Positions:
   1. Events Manager: Category view above events
   2. Events Manager: Category view sidenav
   3. Events Manager: Index Above Events
   4. Events Manager: Index Sidenav
   5. Events Manager: Event view above event
   6. Events Manager: Event view below event
   7. Events Manager: Event view sidebar
10. Events Manager options:
    • Event List Layout (Index):
      • Choose the layout type you want to use to display events on the index pages. Note that category pages will continue to display events in a list layout.
        • List layout
        • Card grid layout
    • Default Event Icon (Font Awesome)
    • Default Event List Order
      • When viewing the event index or category overview pages, this will be the default order for events.
        • Last update
        • Submission date
        • Title
    • Events Per Page:
      • The number of Events displayed per page on the user account page.
    • Limit viewing of event posts without “View full event” permissions
      • If selected, users that do not have permission “View full event” will only see this number of characters from the event posts.
    • Event Deletion Thread Action:
      • No change
      • Delete thread
      • Close thread
      • When a event is deleted, take this action with any automatically created thread.
        • Update thread title on event deletion:
        • Automatically post in the event thread on event deletion
    • Allowed Event Attachment File Extensions
      • List the file extensions that are allowed to be uploaded to events. Use spaces or line break between extensions.
    • Maximum Event Attachment File Size (KB):
      • Provide the maximum event post attachment file size in kilobytes (KB). Attachments over this size will be rejected.
    • Event Photos Display:
      • Decides where the collection of uploaded images will be displayed.
        • Own tab
        • Above content
        • Below content
        • No photos
    • Google Maps Embed API Key
    • Location Map Display:
      • Controls how the location data will be displayed when viewing a Event post.
        • Display map in sidebar block
        • Display map below content
        • Display map in own tab
    • Google Maps Localization
      • When turned on, this feature will adjust different Google Maps (created with both the Embed API and the JS API) in Events Manager. It uses the XF language settings of the user viewing the maps.
11. Style Properties
    • Default event image
    • Location map image
    • Date container
      • Styles the block that contains the day, month, and year.
    • Day and month container
      • Styles the block that contains the day and month.
    • Year container
      • Styles the block that contains the year.
12. User Permissions:
    • View event
    • View full event
    • View event map
    • View event attachments
    • View private event
    • View future event
    • Add event
    • Upload attachments to events
    • Edit own event
    • Delete own event
    Moderator Permissions:
    • Use inline moderation on events
    • View deleted
    • Undelete event
    • Delete any event
    • Edit any event
    • Reassign event
    • View unapproved events
    • Approve / unapprove events
    • Feature / unfeature events
    • Give warnings on events
    Admin Permission:
    • Manage Events Manager
13. Rebuild caches:
    • Events Manager: Rebuild events
    • Events Manager: Rebuild event location data
    • Events Manager: Rebuild user event counts
    • Events Manager: Rebuild event embed metadata (Attachments)
    • Rebuild search index (Event posts)
14. Cron entries:
    • Events Manager: Update view counters
15. Add Event Post count to the member states.
16. Added a Watched Events Page
    • This page displays all the Events you’ve watched in a new list view layout.
    • It allows you to efficiently manage your watched event posts, including:
      • Disabling email notifications
      • Stop watching events.
    • You can select all or multiple event posts and, with your selection, you can:
      • Enable email notification
      • Disable email notification
      • Stop watching.
    • Included a new navigation link for easy access to your watched event posts.
17. Added a Watched Categories Page
    • This page displays all the categories you’ve watched along with the watch information.
    • It allows you to efficiently manage your watched categories.
    • You can select all or multiple categories and, with your selection, you can:
      • Enable email notification
      • Disable email notification
      • Enable alerts
      • Disable alerts
      • Enable sub-category notifications
      • Disable sub-category notifications
      • Stop watching.
    • Included a new navigation link for easy access to your watched categories.
18. “LOCATION” and “PURPOSE” blocks on small screens.
    • The blocks now stack in a single column for a better mobile viewing experience.

​

Events Index (Card grid layout)​

Category (List layout)​

Inline moderation​

Event View (v1.1.0)​

Event notes:​

Event add/edit:​

Event tools​

Move event​

Change discussion thread​

Reassign event​

Delete event​

Event image upload​

Moderator actions​

Featured events​

Filter events (Menu)​

Filter events (Block)​

Upcoming events (Widget)​

Watch categories​

Manage watched categories​

Manage watched events​

Manage your active events​

Admin CP: Options​

Admin CP: Style properties​

Admin CP: Event categories​

Admin CP: Category add/edit​

Admin CP: Event prefixes​

Admin CP: Event fields add/edit​

Admin CP: Rebuild caches​

Admin CP: Cron entry​

1. Events Manager: Refined Card Grid Design
2. Events Manager: Support for WebP File Extension
3. Events Manager: Enhancements on Event View
4. Events Manager: Ongoing Event Indicator on Event View
5. Events Manager: Enhancements to Widget - Featured Events (Carousel style)
6. Events Manager: Widget - Ongoing Events (Carousel Style)
7. Events Manager: Export events to calendar ics format
8. Events Manager: Remove Event Categories, Filters, Widgets from Events Listing Page
9. Events Manager: Card view in categories
10. Events Manager: Show number of discussion replies
11. Events Manager: Show number of photos
12. Events Manager: Clear Indication of Private Events
13. Events Manager: Permission Error Message for Private Event Viewing
14. Events Manager: Creating Private Events Exclusive to Specific User Groups
15. Events Manager: Title Length Limitations and Description Renaming Needed
16. Events Manager: Single Day Events should be the standard
17. Events Manager: Filter Events by My RSVP Status
18. Events Manager: Hide Custom Fields Section if No Custom Fields Exist
19. Events Manager: Delete RSVP Registration Status
20. Events Manager: Can Add Repeating Event Permission
21. Events Manager: Maximum Events Per User Permission
22. Events Manager: Display Attendees Count in both List and Grid Display Modes
23. Events Manager: Event Active Status also Display in Grid Display Mode
24. Events Manager: Display Repeating Status in both List and Grid Display Modes
25. Events Manager: Events list sorted by date
26. Events Manager: More Space between Event detail and Custom Fields
27. Events Manager: Calendar View
28. Events Manager: Recurring events
29. Events Manager: More intuitive RSVP Registration options
30. Events Manager: Category Choices for Upcoming Events Widget
31. Events Manager: Event start and end time
32. Events Manager: Style properties for Event view sections
33. Events Manager: Make "Purpose" optional, get rid of the avatar
34. Events Manager: Event notes feature enable/disable option
35. Events Manager: RSVP Functionality
36. Events Manager: Ability to move "Event Details" to the top (or top Cover Image)
37. Events Manager: Time for creating an event should be less wide
38. Events Manager: Event creator does not count against RSVP
39. Events Manager: Option to disable RSVP
40. Events Manager: Event Tab View Permission
41. Events Manager: Link Events to already created thread