Google Calendar List View


The plugin is to create a shortcode for displaying the list view of public Google Calendars.


Please see the documentation in detail. Japanese documentation


  • List View of a public Google Calendar
  • How to use the Shortcode
  • Sample of public Google Calendars
  • How to use it
  • Goolge Calendar API Settings
  • General Settngs
  • Feature Expansion & Other notice


  1. Upload the plugin folder to /wp-content/plugins/ directory.
  2. Activate the plugin in your WordPress admin panel.

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

How to get past events.

Please set up «ALL» or past date to «Start Date» in the setting menu.
Default setting is to get from now to future events.

Cannot get Google Calendar event?

Please check «Google Calendar API Key» or «Google Calendar ID». If their setting is right, please wait for a day because the API queries limitation may be beyond. (Reference:

Can get events in multi Google Calendar?

Yes. You can set Google Calendar ID and API Key in the shortcode.

How to remove the settings

Deactivate the plugin.

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

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


«Google Calendar List View» переведён на 1 язык. Благодарим переводчиков за их работу.

Перевести «Google Calendar List View» на ваш язык.

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

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

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


  • Tested up WordPress 5.2.2 and php 7.3.
  • Fixed the array check issue in get_google_calendar_contents function.
  • Fixed the error message issue in case that there are not any shortcode options.
  • Fixed the warning message issue for file_get_contents function.


  • Supported the strtotime date format for shortcut option «start_date» and «end_date». Various date formats for strtotime function, such as «now», «+1 days», «-2 days», «yesterday», «-1 week», and so on can be used.
  • Added new shortcode option «max_display». «max_view» is for getting the number of items from Google Calendars. «max_display» is for displaying the number of items. If «max_display» isn’t set, «max_display» is automatically set the value of «max_view» value. If there are mixed events (1.2.3. events in Japanese, 5.6.7. events in English) and set «max_view=5″, lang=»en», 5. and 6. events are only displayed. Therefore, you need to set «max_view» is 6 or more and «max_display» is 5. By these shortcut options, the plugin gets 6 ore more events and picks up 5 events in English among 6 or more events.
  • Fixed the issue which could not get a date if the WordPress timezone setting is «Offset» time (+9, -1, etc.).
  • Fixed the processing issue regarding max_view (maxResults) value in case of multi Google calendars.


  • Allowed the html tag on «description» of Google Calendar.


  • Fixed help message for «start_date», «end_date» shortcode’s date format on the setting menu.


  • Fixed the processing of «start_date», «end_date» shortcode’s options.
  • Fixed the default value of «orderbysort» shortcode’s option (default: descending)


  • Added the value of «gc_description» on the hook.


  • Fixed current_time function error.
  • Tested up WordPress 5.0 and php 7.2.


  • Tested up WordPress 4.9.


  • Added target=»_blank» in a link tag.


  • Support of Multi Google Calendars.
  • Fixed getting local timestamp in case of not set «start_date» option.
  • Fixed the processing for #organizer hash tag in case of including a space in the value.
  • Changed the default for orderbysort is descending.


  • re-uploaded library/tags/lip.php template.


  • Added the hash tag «#organizer». If you set the hash tag, you can use $hash_tags_organizer_value or $hash_tags[‘organizer’][‘value’] on the hook.
  • Added shortcode option «enable_view_category». If you want to display the category (#type and #organizer), please set this value to «true» or not empty value (default is «»)
  • Deleted «html_tag_date_class» and «html_tag_title_class» for migrating «html_tag_class».
  • Reduced the code of the template tag files (library/tags/) for more easily use.


  • Moved get_select_lang_data function to the extended class.
  • Create gclv_hash_tags class for getting the hash tags in the description field on Google Calendar
  • Added the template html_tag «lip».
  • Fixed CSS name.
  • Added the attribution «hash_tags» and «hash_tags_type_title» for the hook.


  • Fixed to display a debug message in case of using lang shortcode.


  • Added shortcode option «lang».


  • Removed «lvgc_output_data» and «lvgc_gc_data» hooks for the security reason.
  • Fixed the setting name.
  • Added the secure option «hook_secret_key» on the shortcode for «lvgc_each_output_data» hook.


  • Added the translation for the documentation link.


  • Fixed the translation issue.
  • Fixed the documentation.


  • Tested up WordPress 4.8 and PHP 7.1.


  • fixed. «lvgc_each_output_data» hook.


  • fixed. «lvgc_each_output_data» hook.


  • added «lvgc_each_output_data» hook for handling each output data.


  • fixed default html_tag setting and added shortcode option «id».


  • added two hooks of «lvgc_output_data» and «lvgc_gc_data».
    «lvgc_output_data» hook can handle for the output data. «lvgc_gc_data» hook can handled for getting Google Calendar data.

  • Fixed timezone issue by using current_time and get_date_from_gmt function instead of date function.

  • Added to a class «list-view-google-calendar-holding» to html tag for a holding event.


  • added 4 shortcode options (max_view, html_tag_class, html_tag_date_class, html_tag_title_class)


  • First Released.