https://github.com/eaudeweb/edw_event
https://github.com/eaudeweb/edw_event
Last synced: 4 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/eaudeweb/edw_event
- Owner: eaudeweb
- Created: 2025-06-23T11:40:00.000Z (12 months ago)
- Default Branch: 1.x
- Last Pushed: 2025-06-23T11:53:35.000Z (12 months ago)
- Last Synced: 2025-06-23T12:39:59.328Z (12 months ago)
- Language: PHP
- Size: 0 Bytes
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# EDW Events module
Enable the event module to provide content managers with the ability to manage events within Drupal.
## Installation
1. Add the following snippet to the `repositories` section of your `composer.json` file:
```
{
"type": "git",
"url": "https://github.com/eaudeweb/edw_event.git"
}
```
2. Run
```composer require eaudeweb/edw_event:^1.0```
3. Enable the module:
``drush en edw_event``
## Architecture
Node types:
- `event` - Main node type which represents a single calendar event.
- `event_section` - The main event has a single default section which is the node page. Using this children entity, the
content manager can create additional sections to a meeting (sometimes are called tabs or pages).
### Fields
#### event
| Field label | Field name | Description | Field type | Cardinality | Required | Translatable | Widget |
|----------------|----------------------|------------------------------------------------------------------------------------------------------------------------|------------------|-------------|-------------|--------------|--------------------|
| Title | title | | Text | Single | Yes | Yes | Text field |
| Number | field_number | Meeting number (use it to order events) | Integer | Single | Yes | No | Text field |
| Abbreviation | field_event_abbr | Meeting short title (e.g. MOP 24) | Short text | Single | No | No | Text field |
| Date | field_date_range | | Date range | Single | Yes (start) | No | HTML5 calendar |
| Date notes | field_date_notes | | Text | Single | Yes | No | Text input |
| Hide date | field_hide_date | Every meeting must have a date, but if you don't know the dates, set one and check this box to hide it from the public | Boolean | Single | No | No | Checkbox |
| Event presence | field_event_presence | Event presence (In person/Hybrid/Virtual) | List (text) | Single | Yes | No | Select list |
| Venue | field_event_venue | | Text | Single | No | No | Text |
| City | field_event_city | | Text | Single | No | No | Text |
| Countries | field_countries | Taxonomy term entity reference (Countries) | Entity reference | Single | No | No | Select |
| Content | field_content | Paragraph entity reference | Entity reference | Multiple | No | No | Paragraph preview |
TODO
#### event_section
| Field label | Field name | Description | Field type | Cardinality | Required | Translatable | Widget |
|-------------|---------------|---------------------------------|-------------------------------|-------------|----------|--------------|-------------------|
| Title | title | | Text | Single | Yes | Yes | Text field |
| Published | status | Show the tab | Boolean | Single | No | No | Checkbox |
| Meeting | field_event | Node entity reference (meeting) | Node entity reference (Event) | Single | Yes | No | Entity browser |
| Content | field_content | | Paragraph entity reference | Single | Yes | No | Paragraph preview |
### Taxonomies
None
### Paragraphs
TODO (add links etc.): Use the `edw_paragraphs` module to enable different visual components that can be added to the meeting sections.
## Functionalities
The following functionalities are provided out of the box:
1. Multilingual content
2. **custom block** to show automatically the children tabs. When user is clicking on a tab element the appropriate
tab page is selected, highlighted and its content is presented to the user. There is a button to create new tab page
which appears when the user has the appropriate permission.
3. Extra local tasks and route callbacks for In-session:
```php
edw_event.in_session.tasks:
deriver: 'Drupal\edw_event\Plugin\Derivative\DocumentsInSessionLocalTasks'
route_callbacks:
- '\Drupal\edw_event\Routing\DocumentsInSessionRoutes::routes'
```
4. TODO
5. TODO: (not implemented) Import a calendar entry from ICS file
## Sub-modules
The following submodules can be used to extend the event functionality. They can also be used independently to attach to
other entities.
### edw_event_agenda
Event agenda can be used to structure a general list of topics to be discussed during an event. For further information
check the README located inside the module.
### edw_event_daily_schedule
Daily schedule can be used to break down multi-day events in activities taking place daily on a certain time. Content
managers can assign room numbers where activities take place.
## Other EDW modules:
* [edw_blocks](https://github.com/eaudeweb/edw_blocks)
* [edw_decoupled](https://github.com/eaudeweb/edw_decoupled)
* [edw_demo_data](https://github.com/eaudeweb/edw_demo_data)
* [edw_document](https://github.com/eaudeweb/edw_document)
* [edw_group](https://github.com/eaudeweb/edw_group)
* [edw_media](https://github.com/eaudeweb/edw_media)
* [edw_paragraphs](https://github.com/eaudeweb/edw_paragraphs)
* [edw_person](https://github.com/eaudeweb/edw_person)
* [edw_project](https://github.com/eaudeweb/edw_project)
* [edw_themes](https://github.com/eaudeweb/edw_themes)
* [edw_utilities](https://github.com/eaudeweb/edw_utilities)