name: Events
version: 1.1.8
description: "The **Events** plugin provides events for a Grav site using event frontmatter."
icon: calendar
author:
  name: Michael
  email: pikim@web.de
  url:
homepage: https://github.com/pikim/grav-plugin-events
demo:
keywords: events, calendar, ics, plugin
bugs: https://github.com/pikim/grav-plugin-events/issues
license: MIT

dependencies:
  - datetools

form:
  validation: loose
  fields:
    tabs:
      type: tabs
      active: 1

      fields:
        setup:
          type: tab
          title: Processing
          fields:

#            processing_section:
#              type: section
#              title: Processing
#              underline: true
#            event_template_types:
#              type: text
#              label: Event Template Types
#              help: What templates should be checked for event related content?
#              default: event
#            display_months_out:
#              type: text
#              label: Months Out to Display Events
#              help: In integer form, how many months out should repeating dates display?
#              default: 3
#              placeholder: 3
#            enable_single_event_filter:
#              type: toggle
#              label: Enable Single Event Filter
#              highlight: 1
#              default: 1
#              options:
#                1: Enabled
#                0: Disabled
#              validate:
#                type: bool
#
#            collections_section:
#              type: section
#              title: Collections
#              underline: true
#            filter_combinator:
#              type: text
#              label: Filter Combinator
#              default: and
#            events_collection:
#              type: text
#              label: Events Collection
#              default: "'@page': '/events'"
#
            events_section:
              type: section
              title: Events
              underline: true
            events_subpage:
              type: text
              label: Events subpage
              help: Subpage under which the events listing is available.
              default: "/events"

            icalendar_section:
              type: section
              title: iCalendars
              underline: true
            icalendar_folder:
              type: text
              label: Virtual folder for iCalendar events (DO NOT USE FOR OWN CONTENT!)
              help: Folder where the events are being stored. Will be (partially) deleted and recreated when events shall be updated.
              default: "/ical"
            icalendar_update:
              type: toggle
              label: "Update virtual folder. Will be automatically reset after saving."
              help: "'All' updates all events. 'New' creates events that don't exist, yet. 'None' saves the admin settings only."
              highlight: 1
              default: 0
              options:
                2: All
                1: New
                0: None
              validate:
                type: int
            icalendars:
              type: editor
              label: iCalendar files
              help: The files that will be parsed for event creation. Must only be one file per line.
              codemirror:
                mode: "text/plain"
                indentUnit: 0
                lineNumbers: true
                styleActiveLine: true
              default: ""

            misc_section:
              type: section
              title: Miscellaneous
              underline: true
            enable_geocoding:
              type: toggle
              label: Enable address geocoding
              highlight: 1
              default: 0
              options:
                1: Enabled
                0: Disabled
              validate:
                type: bool
            api_key:
              type: text
              label: Google Maps API key
              help: API key for address translation. Google for 'maps api key' to learn how to get one.
              default: "none"

        formatting:
          type: tab
          title: Date Formatting
          fields:

            calendar:
              type: section
              title: Calendar
              underline: true
            calendar.first_dow:
              type: radio
              label: First day of the week
              default: 0
              options:
                5: Saturday
                6: Sunday
                0: Monday
            calendar.day_char:
              type: number
              label: Day name length
              help: Show only the first n characters of the day name (0 to show full name).
              default: 0
              validate:
                min: 0
                max: 20
            calendar.month_char:
              type: number
              label: Month name length
              help: Show only the first n characters of the month name (0 to show full name).
              default: 0
              validate:
                min: 0
                max: 20
            calendar.header:
              type: text
              label: Header
              default: F Y
            calendar.anchor_title:
              type: text
              label: Anchor Title
              default: l, F j, Y
            calendar.details.title:
              type: text
              label: Details Day Title
              default: l, F j
            calendar.details.time:
              type: text
              label: Details Time of Day
              default: g:ia

            event_item:
              type: section
              title: Event Item
              underline: true
            event_item.date:
              type: text
              label: Event Date
              default: l, F j, Y
            event_item.day:
              type: text
              label: Events Date Box Day
              default: d
            event_item.month:
              type: text
              label: Events Date Box Month
              default: M
            event_item.time:
              type: text
              label: Events Date Box Time
              default: g:ia

            event_meta:
              type: section
              title: Event Meta
              underline: true
            event_meta.until:
              type: text
              label: Until
              default: F j, Y
            event_meta.display_location:
              type: toggle
              label: Display Event Location
              highlight: 1
              default: 0
              options:
                1: Enabled
                0: Disabled
              validate:
                type: bool

            event_sidebar:
              type: section
              title: Event Sidebar
              underline: true
            event_sidebar.enable_categories:
              type: toggle
              label: Enable Event Categories
              highlight: 1
              default: 0
              options:
                1: Enabled
                0: Disabled
              validate:
                type: bool
            event_sidebar.header:
              type: text
              label: Header
              default: l, F j
            event_sidebar.time:
              type: text
              label: Time
              default: g:ia