Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/apostrophecms/apostrophe-events
https://github.com/apostrophecms/apostrophe-events
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/apostrophecms/apostrophe-events
- Owner: apostrophecms
- Created: 2013-03-26T18:06:53.000Z (almost 12 years ago)
- Default Branch: master
- Last Pushed: 2024-03-20T18:51:05.000Z (10 months ago)
- Last Synced: 2024-10-04T06:38:34.261Z (3 months ago)
- Language: JavaScript
- Size: 241 KB
- Stars: 10
- Watchers: 16
- Forks: 5
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
[](https://circleci.com/gh/apostrophecms/apostrophe-events/tree/master)
# apostrophe-events
This bundle provides a complete foundation for displaying upcoming events with the [Apostrophe CMS](http://apostrophenow.org).
The bundle consists of three Apostrophe modules (in a single npm module):
* `apostrophe-events`
* `apostrophe-events-pages`
* `apostrophe-events-widgets`
The `apostrophe-events` module provides the ability to create and edit events and manage their start and end dates and times. There is support for repeating events.
The `apostrophe-events-pages` module displays events on a page. It extends the `apostrophe-pieces-pages` module. The default view displays only upcoming events.
The `apostrophe-events-widgets` module provides an `apostrophe-events` widget, which you can use to select events to appear anywhere on your site. Events that have ended do not appear in widgets.
These three modules extend `apostrophe-pieces`, `apostrophe-pieces-pages` and `apostrophe-pieces-widgets`, and you can extend them further as well.
## Example configuration
For a single collection of events:
```javascript
// in app.js
// We must declare the bundle!
bundles: [ 'apostrophe-events' ],
modules: {
'apostrophe-events': {},
'apostrophe-events-pages': {},
'apostrophe-events-widgets': {},
'apostrophe-pages': {
// We must list `apostrophe-events-page` as one of the available page types
types: [
{
name: 'apostrophe-events-page',
label: 'events'
},
{
name: 'default',
label: 'Default'
},
{
name: 'home',
label: 'Home'
}
]
}
}
```
## Multiple collections of events
One way to create two or more distinct collections of events is to create separate events pages on the site, and use the "with these tags" feature to display only events with certain tags.
Another approach is to `extend` the modules, creating new modules and a completely separate admin bar item for managing the content. If you take this approach, you must set a distinct `name` property when configuring your subclass of `apostrophe-events`, such as `meeting`. This will be value of `type` in the database for each event of this subclass.
The latter approach is often best as it requires less user training to avoid confusion. The former approach has its own advantages, notably that it is easier to aggregate content and have it appear in multiple places intentionally.
## Filtering by year, month and day
The `apostrophe-events` module provides cursor filters named `year`, `month`, and `day`. For `year` the value should be a 4-digit year. For `month` the value should be in `YYYY-MM` format. For `day` the value should be in `YYYY-MM-DD` format.
All events which are in progress at any point during the specified year, month or day will be included in the results.
These filters are marked `safeFor: public` and can be used with the `piecesFilters` option in `apostrophe-events-pages`.
For example:
```javascript
// in lib/modules/apostrophe-events-pages/index.js
piecesFilters: [
{
name: 'year'
}
]
```
```markup
{% for year in data.piecesFilters.year %}
{% endfor %}
```