{"id":15380762,"url":"https://github.com/bitstarr/grav-plugin-eventlist","last_synced_at":"2026-01-07T03:52:30.314Z","repository":{"id":79321597,"uuid":"541318534","full_name":"bitstarr/grav-plugin-eventlist","owner":"bitstarr","description":"Flex Objects based events plugin","archived":false,"fork":false,"pushed_at":"2024-01-06T16:28:04.000Z","size":39,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-02-02T00:46:13.393Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Twig","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bitstarr.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-09-25T21:48:34.000Z","updated_at":"2024-02-27T01:51:04.000Z","dependencies_parsed_at":"2024-01-06T17:45:09.140Z","dependency_job_id":null,"html_url":"https://github.com/bitstarr/grav-plugin-eventlist","commit_stats":{"total_commits":12,"total_committers":2,"mean_commits":6.0,"dds":"0.16666666666666663","last_synced_commit":"8a5bf38cb5d806bba5a065aa8e68c6475892e7cf"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitstarr%2Fgrav-plugin-eventlist","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitstarr%2Fgrav-plugin-eventlist/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitstarr%2Fgrav-plugin-eventlist/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitstarr%2Fgrav-plugin-eventlist/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bitstarr","download_url":"https://codeload.github.com/bitstarr/grav-plugin-eventlist/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245934929,"owners_count":20696548,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-01T14:24:32.500Z","updated_at":"2026-01-07T03:52:30.282Z","avatar_url":"https://github.com/bitstarr.png","language":"Twig","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Eventlist Plugin\n\nThe **Eventlist** Plugin is an extension for [Grav CMS](http://github.com/getgrav/grav).\n\n\u003e Warning: This plugin targets theme developers. There are no CSS styles included, because it's meant to get custom templates and styles.\n\n## About\n\nThis plugin provides a Flex Directory for events and templates to show a simple list of forthcoming events. Events canf be setup to have a details page with more information, an image gallery, downloads or a registration form.\n\n## Setup\n\nAfter [Installation](#installation) the Flex Directory is automatically active and you will find the category Events in the admin interface.\n\n### Pages\n\nTo show the listing in frontend you need to create a page [`events.md`](examples/02.events/events.md). If you want to use the details page for events, you will need to create an [`event.md`](examples/02.events/event/event.md) child page for the list page. That way you achive URLS like `DOMAIN/theatre/events` and `DOMAIN/theatre/events/event/ce1ece47f59802de4ce0772f8af5a82f`.\n\n```\n.\n├── /01.home\n│   …\n│   ├── /04._events\n│   │   └── events.md\n│   …\n├── /02.theatre\n│   ├── /01.location\n│   └── /02.events\n│       ├── /event\n│       │   └── event.md\n│       └── events.md\n├── /03.catering\n```\n\n\u003e Note that the page folder for the event list could also be on the first hierarchical level. Only important is the correct naming of the page files.\n\nThere are two important lines for the event details page frontmatter:\n\n```\nredirect: /theatre/events   # where to send users, if the URL is invalid\nflex:\n  router: events            # this triggers the processing for the details page\n```\n\nThe redirect will be called, if a details URL is invalid. This happend if an event get unpublished or the details are disabled.\n\nThe included template for the [event list](templates/events.html.twig) is very simple whereas the template for the [details page](templates/event.html.twig) is pretty extensive and opinionated torwards my own [boilerplate/framework theme](https://github.com/bitstarr/grav-theme-chassis). The partial for the gallery is overly specific to my needs, so you will need to customize this for the way your theme can handle this.\n\nTo avoid writing static routes in config files, the path to the event details page will be the first child page of the page the list is rendered inside. To show event lists in other places, take guidance by the [widget template](templates/flex/events/collection/widget.html.twig).\n\n\u003e This plugin provides translations, also for the form that is included in the page examples. Make sure to customize if the fields don't match you requirements.\n\n### Modular\n\nOften times you will need to preview events on a home page. I usually build home pages as modular page. This plugin includes an [events modular](templates/modular/events.html.twig).\n\nIn the [frontmatter of the modular](examples/01.home/04._events/events.md), you will need to note the path to the list page to show a link.\n\n---\n\n## Installation\n\nThis Plugin will not be published via GPM because it's meant to be a building block of your custom theme. It **can not** run out of the box, bbecause you will have to use custom templates, CSS and JS (see above).\n\n### Manual Installation\n\nTo install the plugin manually, download the zip-version of this repository and unzip it under `/your/site/grav/user/plugins`. Then rename the folder to `eventlist`. You can find these files on [GitHub](https://github.com/bitstarr/grav-plugin-eventlist) or via [GetGrav.org](http://getgrav.org/downloads/plugins#extras).\n\nYou should now have all the plugin files under\n\n    /your/site/grav/user/plugins/eventlist\n\n\u003e NOTE: This plugin is a modular component for Grav which may require other plugins to operate, please see its [blueprints.yaml-file on GitHub](https://github.com/bitstarr/grav-plugin-eventlist/blob/master/blueprints.yaml).\n\n\n### Installation as dependency (skeleton)\n\nIf you don't know this method already, check out this [example of a dependecies file](https://github.com/bitstarr/sebastianlaube/blob/main/user/.dependencies). It can hold all (external) plugins and themes you require to run your project. When running `bin/grav install` all these will get downloaded and correctly placed automatically.\n\nAdd the following to your `.dependecies` file:\n\n```\n    eventlist:\n        url: https://github.com/bitstarr/grap-plugin-eventlist\n        path: user/plugins/eventlist\n        branch: main\n```\n\n## Configuration\n\nBefore configuring this plugin, you should copy the `user/plugins/eventlist/eventlist.yaml` to `user/config/plugins/eventlist.yaml` and only edit that copy.\n\nHere's a look at the default settings:\n\n```yaml\nenabled: true\n```\n\nNote that if you use the Admin Plugin, a file with your configuration named eventlist.yaml will be saved in the `user/config/plugins/`-folder once the configuration is saved in the Admin.\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbitstarr%2Fgrav-plugin-eventlist","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbitstarr%2Fgrav-plugin-eventlist","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbitstarr%2Fgrav-plugin-eventlist/lists"}