Skip to content

Farmer-Eds-Shed/farm_calendar_events

Repository files navigation

farm_calendar_events

This module is a Google Calendar add-on for the farmOS distribution.

It creates Calendar events on creation/update of logs in farmOS

Getting started

Installation

Module is dependant on Drupal Google API PHP Client https://www.drupal.org/project/google_api_client for Google Oath2 Authentication.

Install Google API Client:

  1. $ composer require 'drupal/google_api_client:^4.3'
  2. $ drush en google_api_client

See Also:

https://www.drupal.org/docs/contributed-modules/google-api-php-client/installation-and-configuration

Install Farm Calendar Module:

  1. Download the repo, either by cloning it or by using the "Download as Zip" function from GitHub.
  2. Copy the folder (farm_calendar_events) (!not the zip) into /www/web/sites/all/modules/farm/.
  3. Open your farmOS instance online. Go to Administration -> Extend.
  4. Search for "calendar".
  5. Select it by clicking the checkbox and scroll down to the bottom of the page and hit Install
  6. Finished

Configuration

Calandar details need to be added to farm calendar /farm/settings/farm_calendar_events

Google API Credentials need to be added Google API Client /admin/config/services/google_api_client https://www.drupal.org/docs/contributed-modules/google-api-php-client/google-api-console-configurations

Note: Credentials must be authenticated

image

Features

Module creates Google Calendar events from logs, including:

  1. Log Date
  2. Log Name
  3. Log Notes
  4. Location
  5. Color Coding, green = done, orange = pending
  6. Calendar event ID based on log UUID

Logs

Adds Radio butons to all log types:

  1. On Add/Update - Updates calendar on save regardless of status
  2. If Pending - Updates calendar only if saved with status "Pending"
  3. If Done - Updates calendar only if saved with status "Done"
  4. Remove - Removes any calendar entries on save

Settings Menu

Adds Calendar Settings menu with fields for

  1. Calendar ID
  2. Calendar URL

Menu Toolbar

Adds an iFrame to menu toolbar to display Calendar

Screenshots

Calendar iframe on Toolbar image

Calendar ID field added to settings menu.

image

Radio buttons added to logs to select if logs should be added to calendar based on status.

image

image

FAQ

Maintainers

Current maintainers: