Описание

If you update to version 20230111, please note that:

The theming has slightly been changed. Now there is distinction between bundled and custom themes.
The previously bundled dark and light themes have been renamed. So if you used these themes, you now have to manually update these themes to the new pgc-dark and pgc-light themes.
The popup theme has been removed. This can now be set in your custom theme.

See for details about this release: https://blog.michielvaneerd.nl/wordpress-plugins/private-google-calendars/version-20230111-details/

Этот плагин может отображать несколько частных (и публичных) календарей Google с помощью шорткода, блока Гутенберга или в виде виджета.

See the webpage for more information.

Особенности

Доступ к приветным (и открытым) календарям осуществляется с помощью OAuth2 или ключа API.
Регулируемое кэширование — может значительно повысить производительность.
Плагин использует библиотеку FullCalendar, чтобы отображать календарь и может быть кастомизирован с помощью редактора Gutenberg, шорткода с атрибутами или настроек виджета.
Фильтрация календаря.

Скриншоты

Dark themed calendar.
Calendar with event detail popup.
Blue themed calendar.

Блоки

Этот плагин предоставляет 1 блок.

Private Google Calendars

Установка

Загрузите файлы плагина в папку /wp-content/plugins/private-google-calendars или установите плагин через меню Плагины → Добавить новый
Активируйте плагин на странице Плагины → Установленные
Чтобы изменить настройки плагина зайди в меню Настройки → Private Google Calendars
Смотри вкладку Справка в настройках для получения информации о настройке доступа OAuth2 и использовании шорткода и/или виджета.

Часто задаваемые вопросы

I get de-authorised every 1 or 2 weeks

This is because your Google Cloud project is still in the «Testing» publishing status. Make sure to set it to «Production».

Important notes for users who upgraded to 20200902 and experience differences

The 20200902 update makes it possible to display private and public Google calendars at the same time in the same widget, shortcode or Gutenberg block.
This update makes the plugin also more secure. Though tested thoroughly it can be possible you experience a difference. Here are some possible differences and ways to solve them.

Public calendar isn’t showing anymore: this can happen when you display a calendar that you also have added to your Google account but didn’t select in the plugin settings page.
The solution is either remove the calendar from your Google account or select it in the settings.

Как я могу переопределить внешний вид календаря?

Создайте дочернюю тему и enqueue css-файл с зависимостью от pgc, например:

wp_enqueue_style('fullcalendar-override', get_stylesheet_directory_uri() . '/fullcalendar-override.css', ['pgc']);

Я получаю ошибку ‘Token has been expired or revoked’

Обычно это означает, что у вас больше нет доступа для обновления токена. Это можно решить только путем ручного отзыва доступа на странице Google Permissions и удалением всех данных плагина.

Я получаю ошибку ‘Error: redirect_uri_mismatch’, когда хочу авторизоваться

Это означает, что вы не добавили текущий URL-адрес [YOURWEBSITE]/wp-admin/options-general.php?page=pgc в авторизованные URI переадресации. Больше информации по адресу: веб сайт

W3 Total Cache

Если вы используете W3 Total Cache и включили minify JS, убедитесь, что вы выполнили одно из следующих действий:
Выберите «Combine only» (только комбинировать) в настройках «Minify» (минификации JS).
Или
Введите в поле «Never minify the following JS files» (никогда не уменьшать следующие JS файлы) адреса следующих файлов: fullcalendar.min.js и locale-all.js. Убедитесь, что вы добавили полный путь к этим файлам относительно корня директории, в которую у вас установлен WordPress. Если ваш сайт находится в каталоге WordPress, это будет:

wordpress/wp-content/plugins/private-google-calendars/lib/dist/main.js

And for FullCalendar 4:

wordpress/wp-content/plugins/private-google-calendars/lib/fullcalendar4/core/main.min.js
wordpress/wp-content/plugins/private-google-calendars/lib/fullcalendar4/core/locales-all.min.js
wordpress/wp-content/plugins/private-google-calendars/lib/fullcalendar4/list/main.min.js
wordpress/wp-content/plugins/private-google-calendars/lib/fullcalendar4/timegrid/main.min.js

Отзывы

rleegarrison 07.11.2022

I love it when I'm looking for a plugin that is lightweight and does what I need it to do. I needed a plugin to display multiple private Google calendars and I got exactly that! It loads quickly on the page, is easy to filter, and simple to navigate and set up. Thank you for a great plugin!!

aezzell2020 28.12.2021

This plugin has been fantastic for a website I'm working on for a nonprofit organization that uses Google Workspace. I've been able to create individual calendars for a number of groups within the nonprofit and give each group access to create and update their own calendar events, then display all the events on their website in a single calendar, as well as provide individual calendars for some of the groups. With custom CSS, I've been able to style the calendar output to match the website's theme. The support for this free plugin has consistently been timely and helpful.

Klecka 05.10.2021

Title

Matthias Honert 14.04.2021

I love it. Thank you for your work!

elevatingcreativity 08.12.2020 4 ответа

We all love free plugins, especially ones that don’t charge a dime for “pro” versions or etc. This is one of those: it has some great features, and it is totally free. I will start with the positives to encourage further development, and then list some negatives. The positives are: It does what it says, and presents one or more Gcal’s in a nice, clean, and fast way The initial setup instructions are pretty good, and can usually get you going if you use Oauth for private calendar access There are various display options that give nice flexibility The caching feature is nice, reducing the API calls to Google For free, those are pretty nice. The downsides are several, though: It only seems to operate correctly in Oauth mode, giving access from the wordpress site and all admins therein to All of the calendars on the connected account. I ended up spending a bunch of time using a secondary account that had the calendars I wanted shared to it (and publicly), to avoid potential breach of my private calendars in the main account. I would far prefer to have a supported option to access only public calendars via the API key, but I tried that several times and it would not work. (Plus, the docs say that’s “unsupported.” It conflicts with several other plugins that use Oauth, including the well-written and supported “Use Your Drive” plugin and even Elementor Pro. Specifically, it blocks them from using Oauth to initially connect to external services. So this plugin has to be turned off to connect those, then it can be turned back on. While this is just a “minor inconvenience,” it took hours of wasted time to figure out what was going on. And then a support thread that was opened has been ignored for almost a week about that. Personally, I would rather pay for a plugin and get some real support, than have to wait for ??? amount of time for a fix to a problem like this. If you want any control over the display beyond the default, the documentation is somewhat limited, though after the author's response to my initial review I see there is a helpful examples page. This would solve some of the issues I had getting this to do what I need it to. This is a great plugin. Just beware, there is no upfront charge for this plugin, but if you value your time, there is a cost. It takes more to set up than the typical wordpress plugin (and I've set up 100's over the past 10 years). There are no great alternatives (only one commercial alternative whose install immediately caused a conflict), and this plugin is the main show. So I’ll give it 4 stars. It's great but not perfect.

el_diablo 06.11.2020

Powerful plugin, well written & useful. Keep up the good work!

Посмотреть все 23 отзыва

Участники и разработчики

«Private Google Calendars» — проект с открытым исходным кодом. В развитие плагина внесли свой вклад следующие участники:

michielve

«Private Google Calendars» переведён на 3 языка. Благодарим переводчиков за их работу.

Перевести «Private Google Calendars» на ваш язык.

Заинтересованы в разработке?

Посмотрите код, проверьте SVN репозиторий, или подпишитесь на журнал разработки по RSS.

Журнал изменений

20240106

Escape attributes during output.

20240104

XSS vulnerability caused a bug, which is fixed in this release

20240103

Fixed XSS Vulnerability

20231125

Fullcalendar 6.1.9

20230902

Fullcalendar 6.1.8

20230111

FullCalendar 6
Event popups now keyboard accessible (by using ‘focus’ trigger)
Removed Tippy theme — this can now be set in a custom theme
Moved custom themes dir to uploads dir so custom themes are preserved when updating this plugin

20220915

Version constant in previous version (20220910) was not updated. This could cause some files not correctly updated from the cache. This is now fixed.

20220910

Get more events by setting the PGC_EVENTS_MAX_RESULTS constant in wp-config.php
Setting a default private event title

20220701

Fix for depracation warning in PHP 8: required parameter cannot follow optional parameter in PHP 8.
Update NPM packages.

20220603

Loop through calendarList if there are more calendars
You can set the maximum number of calendars in the PGC_CALENDARS_MAX_RESULTS constant (you can set this in the wp-config.php file). Max = 250.

20220318

Fixed OAuth redirect takeover where we didn’t check for the state parameter which could interfere with other plugins

20220209

Set default FullCalendar 5 config if using FC version 5

20220206

Themes and overridable themes per calendar

20220205

FullCalendar 5 support!
Using eventColor overrules custom Google event colors

20211205

Option to show and hide private events.

20211103

Sorting bug fixed

20211102

Fixed bug timezone offset

20211101

Sort calendars in the filter alphabetically.
Enqueue FullCalendar with a prefixed name to make sure the files are loaded.

20211030

Renamed enqueue name for FullCalendar to prevent clashes with other themes or plugins that are loading different versions of fullcalendar.

20201204

Conditionally load defines to prevent logs.
Always show the «Remove plugin data» option, to prevent a lockin where you have no valid token anymore, but you can’t delete your plugin data.

20200902

Fixed security bug where you could display unselected private calendars
Now possible to use private and public calendars at the same time
Changed logic of displaying all or none of private calendars: before this change no selection means ALL private calendars are displyed. Now you have to select the calendars you want to display.
This change was necessary because it’s now possible to display private and public calendars at the same time.
These changes should not impact your current pages as long as you don’t edit them. If you experience changed behaviour of existing pages, please make sure to clear all caches.
Added new documentation at: https://michielvaneerd.github.io/privategooglecalendars/

20211205

Option to hide or show private events.

20200810

При доступе к публичным календарям используйте OAUth client ID, когда ключ API пуст.

20200809

Можно установить невыбранные календари для фильтра.

20200808

Отображаются пользовательские цвета событий.

20200717

Можно установить опцию firstDay / (shortcode = first_day) в + или в —
Добавлен PGC_EVENTS_DEFAULT_TITLE

20200711

Fix for links open in separate tab. Now target=_blank is injected into the A tags instead of adding an event listener.

20200710

Added data-calendarid attribute to each .fc-event so you can manipulate them.
Links in the event popups now always open in separate tab.

20200623

Set default of PGC_EVENTS_MAX_RESULTS to 250.
Make PGC_EVENTS_MAX_RESULTS configurable in wp-config.php.

20200615

Added ‘moment’ plugin so you can use date formatting strings.

20200515

Filter top default if true.

20200514

Place filter on top or bottom of calendar.

20200513

Loading and error element can be translated.
Better error message displayed.
Filter fixed position. Fixes scroll to top wghen clicking filter checkbox.

20200512

Updated all libraries like tippy, popper, fullCalendar and moment.

20200511

Added timezone and ISO datetime string to Google call

20200510

Removed «Z» from start and end (double)

20200509

Added UTC «Z» to start and end time and make end time next day 23:59:59 so it gets all events.

20200508

Fixed modal FullCalendar popup

20200502

Added translation files.

20200501

Prepare for translation.

20200209

Small bug fix: check for empty string when expecting array in get_option() call.

20200117

Use wp_remote_get and wp_remote_post instead of file_get_contents. Thanks to @maikewng for his help in understanding the problem.

20200116

Bug fixed: when start and end time of event are the same, the event.end is null. Now I use the event.start in that case.

20200115

Bug when submitting settings where file select input was not correctly checked, now this check is disabled because we can also have public calendars.
Added a Plugin settings link to the plugin page.

20200114

You can now specify title and color for public calendars.
Bug in widget fixed: when no private calendar was selected in settings, all private calendars were displayed in the widget form.

20200113

Adding referer to public calendar calls to handle restrictions on API key.

20200112

Now also access to public calendars with an API key instead of more difficult to setup OAuth2
Small layout changes

20200102

Gutenberg block implemented (you can use this instead of the shortcode)

20191211

Hidepassed and hidefuture accept number of days as well
Loading spinner active after timeout, so it’s not visible immediately

20191210

Moment timezone plugin — you can now set the timezone for each calendar; by default local times are displayed

20191209

Show popup also for weeklist

20191205

Popups can be dragged

20191204

Bugfix

20191203

Bugfix

20191202

Added version query parameters to enqueued styles and scripts for caching purposes
Make creator, location, attendees and attachments, calendarname available for events
CSS classes added to popup to make override style possible

20191201

Bug: cast attributes from shortcode to int or boolean
Add CSS classes to time, title, description and link of event in popup
Removed title attribute from event

20191133

Now also possible to display public calendars like national holidays

20191132

New option: eventlink
Changed option: eventpopup
Tippyjs theme change
Font size changes

20191131

You can now hide passed or future events

20191129

Title and button text change

20191129

No borders around events
Remove small font size header and button text

20191128

Timegrid week working
Bug fixed: using same cache for multiple calendars with different calendar selections
CSS overrides for WP
Mobile responsive toolbar

20191125

Tippy tooltips (https://atomiks.github.io/tippyjs/)
WP CSS override for specific fullCalendar

20191124

Now possible to specify specific calendars in the shortcode, so it’s now possible to show different calendars on different sections of your website.
FullCalendar update to v4.

20190219

Possible to override calendar color with fullCalendar eventColor or eventBackgroundColor properties

20181225

Fullcalendar locales check

20181224

Make working with PHP 5.4 as in requirements: Arrays are not allowed in class constants.
Rewrite empty() calls on methods to make it work with PHP 5.4
You can now sub-select calendars per widget, so you can add multiple calendars
as a widget, where each widget displays a different calendar.

20181222

Updated fullcalendar to 3.9.0
Tested with WordPress 5.0.2
Fixed path for fullcalendar.print.min.css
Removed moment.js file, because we use the WordPress one

20171009

Первая версия