Promogogo Events
Fetches upcoming events from a Promogogo (https://promogogo.com) partner feed and displays them in a configurable, filterable block. The block works on any supported Drupal site and any theme out of the box, with no theme changes, build step or external assets required.
Features
The module reads a Promogogo partner feed and renders the upcoming events as a responsive grid of cards. Nothing is imported into nodes; the events come straight from the API and are rendered live, so your site stays in sync with the
feed without any content to maintain. Clicking a card (or pressing Enter or Space) opens an in-page detail popup with the event's image, date range, venue and address, a map link, the full description, the performers, and buttons to buy
tickets or open the event and venue pages, all without navigating away from the page.
A single block covers two quite different needs. In overview mode it shows a fixed number of events as a static teaser, which works well in a sidebar or on a landing page. In paginated mode it shows one page of events with a "Read more" button that fetches and appends the next page in place, giving you a full "what's on" listing. Because it is one block, you can place it more than once with different settings on different pages.
Editors can restrict a block by date window (all upcoming, today, this weekend, the next 7 days or the next 30 days), by category and by venue, with the available categories and venues drawn from the live feed and shown with counts. You
can also expose those controls to visitors as category chips, a venue dropdown and date-window chips, so they can refine the list themselves within the bounds you set. Under the hood the whole feed is fetched once into a shared cache and all filtering and pagination happen in memory; if the API is briefly unreachable the last good copy is served instead, so the block never goes blank. The markup ships as a self-contained Single Directory Component with neutral styling that inherits your theme's font and can be restyled with a handful of CSS custom properties.
Reach for this module when you syndicate events from Promogogo and want them shown natively on your Drupal site, whether as a small teaser, a landing-page highlight or a full listing page, without writing custom code. It fits tourism and city sites, venues, festivals and event aggregators.
Post-Installation
Start at Administration » Configuration » Web services » Promogogo Events (/admin/config/services/promogogo-events) and enter your Partner ID, which is required and ships empty. On the same form you can change the API base URL, the number of events to fetch and the cache lifetime if you need to. With the feed configured, place the block at Administration » Structure » Block layout by adding the Promogogo events block (in the Events category) to a region; the block form is where you pick the display mode, the number of events or page size, an optional heading, any category, venue or date restrictions, and whether to show the visitor filter controls.
There is nothing else to set up. The module adds no content type, no entities and no text formats, since events are fetched and rendered live. Saving the settings form clears the cached feed, so any change you make takes effect right away.
Additional Requirements
Beyond Drupal core you need the core Block module to place the block, a Promogogo partner account (specifically its partner ID) for the feed, and outbound HTTP access from your server to the Promogogo API. No other contributed modules or third-party PHP libraries are needed, as the module relies on Drupal core's HTTP client and Single Directory Components.
Recommended modules/libraries
None are required. If you would rather position the block inside a managed layout, it works with Layout Builder (https://www.drupal.org/docs/8/core/modules/layout-builder) as well as the core Block layout.
Similar projects
Importer modules such as Feeds (https://www.drupal.org/project/feeds) and core Migrate pull remote data into local nodes, which is the right choice when you want to own and edit the content, at the cost of field mapping and storage.
This module takes the opposite approach and renders the Promogogo feed live with nothing stored locally. Event and calendar tools like Smart Date (https://www.drupal.org/project/smart_date) are built for events authored on your own site, whereas this module is specifically a read-only display of a Promogogo partner feed.
Supporting this Module
The module is maintained on a volunteer basis. The most helpful way to support it is to file clear issues and merge requests in the issue queue.
Community Documentation
The module's README.md covers configuration and theming in full. Walkthroughs and a demo will be linked here as they become available.