Plugin / Google Calendar Widget

Kaz Okuda
Download from WordPress

Frequently Asked Questions (FAQ)

Upload all the files to the /wp-content/plugins/google-calendar-widget directory Activate the plugin through the ‘Plugins’ menu in WordPress Get a Google API Key from the Developer Console and save it in the Google Calendar Widget Settings page. Drag the ‘Google Calendar’ widget to your sidebar Fill out the settings for each instance in your sidebar. You can ge the calendar ID from your Google calendar settings. For example: Calendar Title : Google Developer Calendar Calendar ID 1: [email protected] Calendar ID 2: [email protected] Calendar ID 3: Event Title Format: [STARTTIME -][TITLE] Maximum Results: 6
Go to https://console.developers.google.com. Create or select a project for your web site In the left sidebar, expand APIs & auth then select APIs Change the status of the Calendar API to ON In the left sidebar, select Credentials Click on Create new Key and choose Browser key For testing purposes you can leave the referrers empty, but to prevent your key from being used on unauthorized sites, only allow referrals from domains you administer.
See the here for more information about how to find your calendar key (http://googleappstroubleshootinghelp.blogspot.ca/2012/09/how-to-find-calendar-id-of-google.html).
You can download localized versions of date.js from here. Find the correct language version in the “build” folder of the zip file, and replace the date.js in the plugin folder.
The date and time is formatted using the date.js library. Look for code like the following two lines in ko-calendar.js and change the format argument to match the format you want. startJSDate.toString("ddd, MMM d, yyyy h:mm tt") dateString = startJSDate.toString('MMM dd'); The formatting represents how the information will look on the page “MMM” translates to the abbreviated name of the month. Take a look at the documentation for how you can change that formatting string to match what you want. http://code.google.com/p/datejs/wiki/FormatSpecifiers For example, you can change the following dateString = startJSDate.toString('MMM dd'); to this dateString = startJSDate.toString('dd.MM.yyyy'); to change the agenda item “Jan 2” to “02.01.2009”
The plugin uses the wiky.js library that generates HTML from a wiki-like markup language. It expects that the calendar item descriptions are marked up using that format. This is done to simplify the formatting for users who are already familiar with wiki markup and make the calendar entries easier to read when not interpreted. If you wish to remove this transformation simply replace the following line in ko-calendar.js bodyDiv.innerHTML = Wiky.toHtml(entry.description != null ? entry.description : ""); With bodyDiv.innerHTML = entry.description != null ? entry.description : "";
NOTE: After the V3 API upgrade this may not work correctly. You can insert the widget into a template directly, without adding it to a sidebar, by inserting php code directly into your theme. 'Calendar Title', 'url' => '[email protected]', ), array('before_widget' => '
', 'after_widget' => '
', 'before_title' => '
', 'after_title' => '
' )); ?> You can configure it with the same options available in the widget, as the second parameter to the_widget. ‘title’ will appear at the top of the calendar. ‘url’ is the id of your Google Calendar (see the Installation instructions for more details) ‘url2’, and ‘url3’ allow you to specify multiple calendars to be shown in the one view. ‘maxresults’ restricts the number of events to show. The default is 5. ‘titleformat’ is the format of the event titles. The default is “STARTTIME – TITLE”. If ‘autoexpand’ is TRUE, the calendar will show the details of each event by default. The default is FALSE. The third parameter lists the standard widget options. See the wordpress Widget documentation for more details. They can each be blank (i.e. ‘before_widget’=>”) or contain whatever formatting you desire to be inserted in the flow.
The “Event Title Format” option for each calendar allows you to format how you wish the calendar events to appear in the event list. The default format is “[STARTTIME – ][TITLE]” so, for example, an event that starts at 6:00pm would called “Birthday Party” would appear as “6:00PM – Birthday Party”. [TITLE] will be substituted with the event title. [STARTTIME] will become the start time (or “All Day” if it is an all day event). [ENDTIME] will become the end time (or blank if it is an all day event). Any extra characters included within the [] will be inserted if the value exists. That is, [ENDTIME – ] will insert ” – ” after the end time, if and only if there is an end time. If an event is an all-day event, then [STARTTIME] will be replaced with “All Day” and no [ENDTIME] will defined. All html tags are stripped except
and

tags. Examples "[STARTTIME] - [TITLE]" becomes "6:00AM - Test Event" or "All Day - Test Event" "[STARTTIME] - [ENDTIME - ][TITLE]" becomes "6:00AM - 9:00AM - Test Event" or "All Day - Test Event" "[STARTTIME][ - ENDTIME] : [TITLE]" becomes "6:00AM - 9:00AM : Test Event" or "All Day : Test Event" "[STARTTIME][ - ENDTIME]
[TITLE]" becomes "6:00AM - 9:00AM
Test Event" or "All Day
Test Event"

Yes! I have included an example with the plugin in “examples/stand_alone.html” that shows an example using the plugin code. Each element is tagged so it should be flexible for styling; see the existing stylesheet for examples. You must replace the text ‘YOUR API KEY HERE’ with your Google API Key

Ratings

4.3
7 reviews

Rating breakdown

Details Information

Version

1.4.6

First Released

20 Nov, 2014

Total Downloads

107,855

Wordpress Version

2.8 or higher

Tested up to:

4.0.28

Require PHP Version:

-

Tags

calendar google widget

Contributors

Poco

Languages

The plugin hasn't been transalated in any language other than English.

DIRECTORY DISCLAIMER

The information provided in this THEME/PLUGIN DIRECTORY is made available for information purposes only, and intended to serve as a resource to enable visitors to select a relevant theme or plugin. wpSocket gives no warranty of any kind, express or implied with regard to the information, including without limitation any warranty that the particular theme or plugin that you select is qualified on your situation.

The information in the individual theme or plugin displayed in the Directory is provided by the owners and contributors themselves. wpSocket gives no warranty as to the accuracy of the information and will not be liable to you for any loss or damage suffered by you as a consequence of your reliance on the information.

Links to respective sites are offered to assist in accessing additional information. The links may be outdated or broken. Connect to outside sites at your own risk. The Theme/Plugin Directory does not endorse the content or accuracy of any listing or external website.

While information is made available, no guarantee is given that the details provided are correct, complete or up-to-date.

wpSocket is not related to the theme or plugin, and also not responsible and expressly disclaims all liability for, damages of any kind, arising out of the use, reference to, or reliance on, any information or business listed throughout our site.

Keep Leading Your Followers!
Share it for them.