https://github.com/pitaj/nodebb-plugin-calendar

Fully-featured calendar plugin for NodeBB
https://github.com/pitaj/nodebb-plugin-calendar

Last synced: 3 months ago
JSON representation

Fully-featured calendar plugin for NodeBB

• Host: GitHub
• URL: https://github.com/pitaj/nodebb-plugin-calendar
• Owner: pitaj
• Created: 2014-10-07T16:49:40.000Z (over 10 years ago)
• Default Branch: main
• Last Pushed: 2023-01-28T05:30:24.000Z (about 2 years ago)
• Last Synced: 2024-10-12T03:28:16.333Z (4 months ago)
• Language: TypeScript
• Homepage:
• Size: 1020 KB
• Stars: 42
• Watchers: 11
• Forks: 34
• Open Issues: 20
• Metadata Files:
  • Readme: readme.md
  • Contributing: contributing.md

Awesome Lists containing this project

• awesome-nodebb - calendar - Fully-featured calendar plugin for NodeBB. (Plugins)

README

        
# nodebb-plugin-calendar

This plugin adds a site-wide calendar to NodeBB, letting you create and customize events.

![Event](https://i.imgur.com/klcV8kh.png)

![Calendar](https://i.imgur.com/HCAvVqT.png)

## Installation

 1. Install and activate this plugin on the ACP "Plugins" page

 2. Restart and rebuild your NodeBB

#### Manual Installation

Current alpha/beta version can be installed by doing the following:

 1. Open a terminal in the NodeBB root directory

 2. Install the latest *nodebb-plugin-calendar*:

    `npm install nodebb-plugin-calendar@latest`

 3. Restart nodebb and activate the plugin

## Configuration

Before do anything with the Calendar, make sure you have the correct settings set up in the ACP plugin settings page. Also, configure permissions for who can post events in the category management section of the ACP.

## Features

 * Events created, edited, and deleted as part of a post

 * Native NodeBB category permissions are used to determine who can post and view events

 * Public events as part of the same permissions system

 * Response system for easy user responses (yes, maybe, no)

 * Configurable automated reminders for upcoming events using NodeBB's notifications system

 * Centralized calendar interface to view all upcoming events

## How event creation works

 - Open the composer for creating a new topic or replying to a post. If you have permissions to post an event, you'll see a calendar icon in the toolbar. Click it to add an event to the post or edit an existing event.

 - Enter an **Event name**, this will show up on the calendar and on the previews.

 - **All day** defines if the event has a particular time or if you only want to be specific to the day.

 - Enter the start and end **Dates**. The end date must be after the start date.

 - The **Location** is parsed like a post, but can only be one line.

 - Put details in the **Description** field, which is also parsed like a post.

 - Add **Reminders** determine when subscribers get notifications about the event.

 - **Mandatory** events disable responses and send all reminders to any user that can view the event.

#### In The Works

 * iCal export

 * Simplistic, graceful calendar UI (infinite scroll) with mobile support

## Suggestions? Encountered a Bug?

Please submit all feature requests and bugs with the [Issue tracker at Github.](https://github.com/pitaj/nodebb-plugin-calendar/issues) Thanks!