{"id":20028814,"url":"https://github.com/phase2/oa_events","last_synced_at":"2025-08-03T14:38:24.543Z","repository":{"id":12669852,"uuid":"15341813","full_name":"phase2/oa_events","owner":"phase2","description":"Open Atrium release modules live on drupal.org.  This is a dev version to take advantage of github workflow features.","archived":false,"fork":false,"pushed_at":"2015-01-05T22:05:20.000Z","size":498,"stargazers_count":3,"open_issues_count":0,"forks_count":6,"subscribers_count":14,"default_branch":"7.x-2.x","last_synced_at":"2025-04-08T16:05:40.874Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/phase2.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-12-20T15:36:40.000Z","updated_at":"2016-11-13T23:11:04.000Z","dependencies_parsed_at":"2022-08-29T20:41:09.294Z","dependency_job_id":null,"html_url":"https://github.com/phase2/oa_events","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phase2%2Foa_events","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phase2%2Foa_events/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phase2%2Foa_events/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phase2%2Foa_events/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/phase2","download_url":"https://codeload.github.com/phase2/oa_events/tar.gz/refs/heads/7.x-2.x","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252435194,"owners_count":21747362,"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-11-13T09:16:39.592Z","updated_at":"2025-05-05T03:32:18.948Z","avatar_url":"https://github.com/phase2.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"Plugin App to provide Event and Calendar functionality.\n\nThis plugin integrates several Drupal modules, along with a custom content type\nto provide Event and Calendar management with full geo-location support.\n\nCalendars\n=========\n\nThe FullCalendar module is used to provide the main calendar view of the custom\nEvent content type.  The Date module provides the Start and End datetime fields\nfor the event that are linked to the calendar display.  FullCalendar was\nchosen over the typical Calendar module because it provides a more-modern\nGoogle Calendar look and feel, allowing events to be drag/dropped to different\ndays and times, and switching between monthly, daily, weekly views without\nrefreshing the entire page.\n\nThe FullCalendar_Create sandbox project has been copied into Open Atrium as a\nsubmodule of oa_event.  This adds the ability to click on a calendar day to\ndisplay a popup form to create a new event.\n\nTODO: Currently the FullCalendar_Create popup does not use the custom Panelizer\nlayout for the node edit/add form and instead uses the default Drupal edit/add\nform.\n\nColor Coding\n------------\n\nThe Colors module provides color coding for FullCalendar based on a variety\nof conditions, including taxonomy terms and/or Organic Groups.  A Legend widget\nis available to show the colors on the calendar page.\n\nTODO: The Legend widget currently displays the full list of groups or taxonomy\nterms and should be modified to only show the colors currently being used on\nthe calendar.  Options should be added for Sections and for only displaying\nsubspaces of the current space rather than all spaces on the site.\n\nEvent Locations\n===============\n\nEvent Location is provided via the Geofield and GeoCoder modules.  A multiline\ntext field is used for the free-format location text.  This text is geocoded\nand the resulting coordinates are stored in the Geofield.  By default Google\nis used for the Geocoding service, which has limits around the number of\nconversions per day from a given site.  On client sites which use event locations\nextensively, an alternate geocoder is recommended.\n\nTODO: A newer version of the GeoCoder module provides client-site conversion\nand should be investigated.\n\nA BREAK line in the location text field can be used to separate the data being\ngeocoded from other location data to be displayed.  For example, a virtual\nwebinar link can be added after the BREAK to provide a virtual location that\nwill not interfere with the geocoding of the physical location given before the\nBREAK.  The BREAK uses the same button in the WYSIWYG editor as in the normal\nDrupal body field to separate the summary.\n\nRepeating Events\n================\n\nBy default, the normal Date module is used for repeating events.  This creates\na single Drupal node for all of the events in the series.  For some use-cases\nthe client requires a unique node for each occurence of the event to allow\ndistinct meeting agendas or notes to be attached.  The [OA Date Repeat](https://github.com/phase2/oa_date_repeat)\nmodule is available to add that option to each event.\n\nThe date_all_day module is used to add an option for All Day events.\n\nContent Types\n=============\n\noa_event\n--------\n\nUsed for the Event nodes. Additional fields are:\n\n- **field_oa_address** - A multiline text field used to enter the location of\n  an event.\n\n- **field_oa_geo_location** - A hidden field containing the coordinates from\n  geocoding the field_oa_address field.\n\n- **field_oa_date** - The datetime information for the event.\n\nThe full node detail page is panelized to show a Google map of the location\nin the sidebar.  A custom formatter is used to display the start date of the\nevent in a visual box (month/day).\n\nA link to the [AddThisEvent](http://addthisevent.com/) is shown (Add to Calendar).  The\njavascript for AddThisEvent is copied into the js/atemay.js and has been\nmodified to support https connections.\n\nA variant of the node/edit form is used to control the column layout of\nfields, with the field_oa_date in the sidebar.\n\nMessages\n========\n\noa_event_notification\n---------------------\n\nAn event fired from the cron task when an event has a start datetime within the\nnext oa_events_reminder_interval seconds.  Note that cron needs to run often\nenough to provide the desired notification granularity.  The elysia_cron module\ncan be used to run the oa_events_cron more often than other system tasks.\n\nVariables\n=========\n\n- **oa_events_send_reminders** - true/false to send event reminder message notifications\n- **oa_events_reminder_interval** - number of seconds before the event start time\n  to send a notification (via cron)\n\nViews\n=====\n\nOpen Atrium Calendar (oa_fullcalendar)\n--------------------------------------\n\nContains the monthly, weekly, and daily views used to display the FullCalendar.\nEach view is available as a separate widget with filters for space and section.\nAn iCal Feed display is used to place an iCal Export button link at the bottom\nof the main calendar.\n\nOpen Atrium Event List (oa_event_list)\n--------------------------------------\n\nProvides several view display widgets for various event listings:\n\n- Upcoming Events - A list of the next upcoming future events (displayed as a table)\n- Past Events - A list of more recently passed evetns\n- Upcoming Events Small - Similar to Upcoming Events but intended for sidebars\n  with more limited space (displayed as an HTML list)\n- iCal Feed - Attached to Upcoming Events to provide an iCal export feed\n\nOpen Atrium Event Detail (oa_event_detail)\n------------------------------------------\n\nProvides the widget that displays the details about the event, such as the\nlocation and date (using the custom date formatter).  This widget is placed at\nthe top of the node detail panelizer template.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphase2%2Foa_events","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fphase2%2Foa_events","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphase2%2Foa_events/lists"}