GatherPress

Stable tag: 0.30.0-alpha Tested up to: 6.5.2 License: GPL v2 or later Tags: events, event, meetup, community Contributors: mauteri, hrmervin, patricia70, jmarx, pbrocks, prayagm, linusx007, stephenerdelyi, carstenbach, calebthedev

GatherPress, powering our community's event management needs.

Description

GatherPress, a plugin created by and for the WordPress community, is a response to the community's desire for novel event management tools that meet the diverse needs of event organizers and members. Its agenda and roadmap align with that of the WordPress community, ensuring that it evolves in tandem with our collective wants and needs.

We propose a pilot program to test GatherPress, a community-developed plugin, within interested and active WordPress meetup groups. This initiative stems from our community’s need for an innovative event management tool tailored to the unique demands of WordPress event organizers and participants. @Patricia BT in January 2024 on make.wordpress.org

This project is for the collaborative effort to build a compelling event management application using open source tools such as WordPress and BuddyPress and the grit sweat and love of the community, for the community.

We're creating the very network features we need to host events and gather well.

https://www.youtube.com/watch?v=BnYS36C5d38&t=2s

Features

• Event Scheduling: set dates, times, and provide event information details.
• Attendee registration.
• Allow attendees to add guests.
• Ability for attendees to be listed anonymously (only administrators will see their names).
• Emailing system: to send emails to all the group members, or a specific event attendees, non-attendees, and those on the waiting list.
• In person events: add the venue, with an optional map (refer to point 4)
• Online event management: add the video meeting URL.
• Multi-event management: capability to handle multiple events simultaneously.
• Multisite environment: This setup allows for centralized management while providing flexibility for each site to host its own unique events with its settings (language, timezone, date time format) and set of users.
• Works with blocks.
• Fully internationalized.
• Freedom to add content besides the default event/venue blocks, to remove default blocks, and add synced patterns (useful for adding consistent information across all events).

Upcoming features

• Import events from meetup.com with an add-on plugin. (#)
• Recurring events. (#)
• Calendar block. (#)
• Email notification when event starts. (#)
• Event federation using ActivityPub (#)

Contribute

If you wish to share in the collaborative of work to build GatherPress, please drop us a line either via WordPress Slack or on GatherPress.org. The development location of the GatherPress project can be found at https://github.com/gatherpress/gatherpress. All contributions are welcome: code, design, user interface, documentation, translation and more.

Third-Party Libraries

This plugin leverages the following third-party libraries for various functionalities:

• React-Modal: Facilitates the creation of modal dialogs in React components.
• React-Tooltip: Provides customizable tooltips for React applications.

Screenshots

Installation

1. Download the plugin: you'll find the latest release on the GatherPress GitHub repository, under Releases > Assets and download gatherpress.zip.
2. Install it in your WordPress instance: go to WP Admin Plugins > Add new plugin. Choose the gatherpress.zip file you just downloaded.
3. Activate the plugin.

Requirements

To run GatherPress, we recommend your host supports:

• PHP version 7.4 or greater.
• MySQL version 5.6 or greater, or, MariaDB version 10.0 or greather.
• HTTPS support.

Frequently Asked Questions

What external services are used in GatherPress?

• Mapping Services: We use OpenStreetMap (coming soon) and Google Maps to display meeting locations on a map. To achieve this, we send the address to OpenStreetMap or Google Maps for rendering.
• Calendar Integration: GatherPress also supports "Add to Calendar" functionality using Google Calendar and Yahoo! Calendar.

Configure GatherPress

In WP Admin, go to Events > Settings.

You can change different settings such as:

• Show publish date as event date for events.
• The default maximum limit of attendees to an event.
• Anonymous RSVP.
• Date Format.
• Time Format.
• Display the timezone for scheduled events.
• Upcoming Events page.
• Past Events page.

Create an Event

In WP Admin, go to Events > Add New.

By default, a few blocks are populated, you can keep them or delete them and you can add more blocks.

• The Event date block allows you to define the start and end dates and times of your event, as well as the timezone.
• The Add to Calendar block enables your users to add the event to their preferred calendar directly from the published event on the frontend.
• The Venue block lets you choose whether your event is online or in a venue. You can select the venue (refer to point 4) and the map settings: display, zoom level, type of map and map height.
• The RSVP block enables members to confirm they attend or do not attend an event.
• The description of the event is a normal paragraph block. You can add anything with any block here.
• The RSVP Response block displays a list of members who have confirmed they attend or do not attend an event.
• The event settings allow you to modify all the above mentioned settings, enable or disable anonymous RSVP, choose Topics, notify members or attendees, as well as standard WordPress settings such as the featured image, the excerpt, allow or disallow comments, etc.

Create a Venue

In WP Admin, go to Events > Venues.

In the Venue block, you can define:

• The full address, telephone, and website of the venue.
• The map settings.

Create an Event Topic

In WP Admin, go to Events > Topics.

Topics are like post categories, but for events.

Get Collaborator Access

To get write access to the GitHub repo, please reach out to our GitHub Administrators: Mervin Hernandez and Mike Auteri.

To get access to GatherPress.org via SSH or WP Admin login, please reach out to our GatherPress.org Administrator: Mervin Hernandez.

Read Developer Documentation

Find the developer documentation inside the plugins' docs folder.

Is GatherPress WordPress Multisite compatible?

Yes, GatherPress can be run on a network of sites. The additional database tables it needs, will be created automatically for each new site if the plugin is network-activated.

GatherPress can also be activated per site.

What’s about the PRO version?

As a Community powered plugin, GatherPress is already the PRO-version.

Because we strive for close-to-core development, love decisions - not options and follow a lot of well known best-practices within the WordPress space, we can and do focus on what matters most - powering our community's event management needs.

GatherPress‘ best-practices:

• Tested & validated against WordPress Coding Standards
• Not only once, but consequently tested & validated against the WordPress plugin review guidelines.
• JavaScript & PHP Unit tests are covering almost 80% of the whole codebase.

Reminder that GatherPress is still in Alpha

As we continue to refine and develop the plugin, please use the GatherPress Alpha plugin alongside the core GatherPress plugin. The Alpha plugin manages breaking changes easily: just make sure it is up-to-date, activate it, go to the Alpha section under GatherPress Settings, and click "Fix GatherPress!" after updating GatherPress. This process helps us avoid technical debt as we work towards launching version 1.0.0 of the plugin.

Changelog

See complete changelog at https://github.com/GatherPress/gatherpress/releases.

Upgrade Notice

1.0.0

See: https://gatherpress.org/releases/version-1-0-0