https://github.com/pjaudiomv/simple-event-sheets

WordPress Plugin Simple Event Listing feed from Google Sheets
https://github.com/pjaudiomv/simple-event-sheets

event-listing google-sheets sheets wordpress wordpress-plugin

Last synced: about 2 months ago
JSON representation

WordPress Plugin Simple Event Listing feed from Google Sheets

• Host: GitHub
• URL: https://github.com/pjaudiomv/simple-event-sheets
• Owner: pjaudiomv
• License: gpl-2.0
• Created: 2024-06-01T14:27:50.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2025-07-14T18:47:13.000Z (12 months ago)
• Last Synced: 2026-03-31T06:36:10.358Z (3 months ago)
• Topics: event-listing, google-sheets, sheets, wordpress, wordpress-plugin
• Language: JavaScript
• Homepage:
• Size: 482 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: readme.txt
  • License: LICENSE

Awesome Lists containing this project

README

          
=== Simple Event Listing feed from Google Sheets ===

Contributors: pjaudiomv

Tags: event listing, events, google sheets

Requires PHP: 8.0

Tested up to: 6.8

Stable tag: 1.1.0

License: GPLv2 or later

License URI: http://www.gnu.org/licenses/gpl-2.0.html

**Simple Event Listing feed from Google Sheets** is a plugin designed to fetch event data from a Google Spreadsheet and display it on your website.

== Description ==

**Simple Event Listing feed from Google Sheets** is a plugin designed to fetch event data from a Google Spreadsheet and display it on your website.

SHORTCODE

- Basic Usage: `[simple_event_sheets]`

    * Ensure your Google Sheet has the row headers: `date, name, url, event_info, day_info`. The date should be formatted as mm/dd/yyyy. Implement data validation on the date and url rows to prevent errors. Note: This plugin also offers built-in data validation.

    * `event_info`: Additional information about the event, displayed next to the event name.

    * `day_info`: Additional information about the day of the event, displayed next to the date.

    * Regarding the Google API Key: You'll need an API key with Spreadsheet access. The sheet should either be set to "anyone with the link can view" or you should add a service user. If you're utilizing server-side event loading, restrict the key by server IP. For client-side loading, restrict the key by domain.

You can use this Google Sheet as a template if wanted, it includes data and url validation to help ensure good data quality. [https://docs.google.com/spreadsheets/d/18NnmKKU7P6bFOPEHgyUMWeKQWQJnAfYb5gmn0-fne1E/](https://docs.google.com/spreadsheets/d/18NnmKKU7P6bFOPEHgyUMWeKQWQJnAfYb5gmn0-fne1E/)

### Third-Party Service Disclosure

This plugin relies on a third-party service, Google Sheets, to function properly. The plugin fetches data from Google Sheets under the following circumstances:

- When retrieving event data to display within the application.

## Service Information

- **Service:** [Google Sheets API](https://developers.google.com/sheets/api)

- **Terms of Use:** [Google API Terms of Use](https://developers.google.com/terms/)

- **Privacy Policy:** [Google Privacy Policy](https://policies.google.com/privacy)

### Creating a Google API Key with Sheets API Access

1. **Go to the Google Cloud Console:**

   - Open the Google Cloud Console at [console.cloud.google.com](https://console.cloud.google.com/).

2. **Create a New Project:**

   - Click on the project dropdown and select "New Project".

   - Enter a project name and click "Create".

3. **Enable the Sheets API:**

   - With your project selected, go to the [API Library](https://console.cloud.google.com/apis/library).

   - Search for "Google Sheets API" and click on it.

   - Click "Enable" to enable the API for your project.

4. **Create API Credentials:**

   - Go to the [Credentials](https://console.cloud.google.com/apis/credentials) page.

   - Click "Create Credentials" and select "API key".

   - Your API key will be created. Copy it and keep it safe.

5. **Restrict Your API Key:**

   - Click on the edit icon next to your API key.

   - Under "Key restrictions", select either "HTTP referrers (web sites)" or IP (server).

   - Add the referrer(s) for your site, such as `https://yourdomain.com/*` or Server IP.

   - Save your changes.

 6. **Set Spreadsheet Access:**

    - Ensure your Google Sheet is either set to "anyone with the link can view" or you should add a service user with the necessary permissions. This step is crucial for the API key to access the data.

### MORE INFORMATION

https://github.com/pjaudiomv/simple-event-sheets

== Installation ==

This section describes how to install the plugin and get it working.

1. Download and install the plugin via the WordPress dashboard, or upload the entire **Simple Event Listing feed from Google Sheets** folder to `/wp-content/plugins/`.

2. Activate the plugin through the 'Plugins' menu in WordPress.

3. Insert the `[simple_event_sheets]` shortcode into your WordPress page or post.

== Screenshots ==

1. screenshot-1.png

2. screenshot-2.png

3. screenshot-3.png

== Changelog ==

= 1.1.0 =

* Added calendar view.

= 1.0.2 =

* Updated release.

= 1.0.1 =

* Updated event and day info.

= 1.0.0 =

* Initial Release