Get the Javascript

Integrating and using the Yard Javascript is free of charge, but it requires approval by Yard. Here are the steps to get up and running:

1. You have to send an integration request to Yard explaining the use case of the calendar and where you want to install it (website URL). After your request was accepted, you will get an authorization code, which is necessary to run the plugin.
2. After your integration request was accepted (step 1), you can include the following HTML line in your website exactly at the position where you would like to show the Yard Calendar:
   <script src="https://www.yard.global/yard-iframe.js?code=your_activation_code" class="yard-iframe" defer></script>
   Be sure to replace your_activation_code with your actual activation code you received from Yard. Note that this script will inject the Yard Calendar as iframe tag when the script is called.
3. After you copied the code (step 2) to your website and saved it, your calendar will appear. You can also include multiple calendars on the same page: simply include another script tag on your web page. To configure each Javascript call, see the details in the next section "Configuration".

Parameter Configuration

You can configure the Yard Plugin through these optional parameters:

• &topic=xxx - filter events by one or more supported topics (see "Topic Configuration"), where xxx is a topic.
• &tags=xxx - filter events by one or more keywords (see "Tags Configuration"), where xxx is a keyword.
• &city=xxx - filter events by one or more supported city names (see "Location Configuration"), where xxx is a city name.
• &state=xxx - filter events by one or more supported state names (see "Location Configuration"), where xxx is a state name.
• &country=xxx - filter events by one or more supported country names (see "Location Configuration"), where xxx is a country name.
• &region=xxx - filter events by one or more supported formats (see "Location Configuration"), where xxx is a region name.
• &languages=xxx - filter events by one or more supported talk languages (see "Talk Language Configuration"), where xxx is a talk language.
• &format=xxx - filter events by one or more supported region names (see "Location Configuration"), where xxx is a region name
• &maxwidth=xxx - override the default width of 100% to a specific value, where xxx is a width like '1200px' or '80%'.
• &mode=xxx - override the default mode tiles, where xxx is a mode name.
• &modal=xxx - show or hide a modal window when clicking on an event, where xxx turns the modal on (1) or off (0).
• &headline=xxx - show a custom headline for your calendar integration, where xxx is your headline text.
• &results_per_page=xxx - limit the rows to be displayed, where xxx is a number.

You can also combine the listed parameters as shown in the example above.

Example Integration

This example will show fintech events in Germany: <script src="https://www.yard.global/yard-iframe.js?code=your_activation_code&topic=fintech&country=Germany"></script>

Be sure to replace your_activation_code with your actual activation code you received. Yard is working on creating a management interface for the parameters, so that you don't have to play around with programming code.

Topic Configuration

The &topic= parameter is accepting one or multiple values from this list:

• &topic=blockchain - blockchain events
• &topic=finance - finance events
• &topic=fintech - fintech events
• &topic=artificialintelligence - AI events
• &topic=informationtechnology - IT events
• &topic=business - business events
• &topic=innovation - innovation events

You can also combine the above listed parameters for limiting the events to be shown, for example: &topic=finance,fintech

Please note that the topic web3 was renamed to blockchain.

Tags Configuration

The &tags= parameter is accepting one or multiple search keywords, for example: &tags=bitcoin

This filter uses an AND search combination concerning other parameters, such as topic.

Location Configuration

The &city=, &state=, &country=, and &region parameters are accepting one or multiple values from this list:

• &city=Berlin - events in Berlin
• &state=California - events in California
• &country=France - events in France
• &region=Europe - events in Europe

You can also include several locations for a given location parameter, for example: &country=Germany,Austria,Switzerland

Currently, location names are supported using their English or German spelling.

Talk Language Configuration

The &languages= parameter is accepting one or multiple talk languages, for  example:

• &languages=english - events conducted in English language
• &languages=german - events conducted in German language
• &languages=english,german - events conducted in English or German language

This filter uses an AND search combination concerning other parameters, such as topic.

Event format Configuration

The &format= parameter is accepting one or multiple values from this list:

• &format=conference - filter events by conferences or summits
• &format=ceremony - filter events by ceremonies or galas
• &format=dinner - filter events by dinners, lunches, or breakfasts
• &format=fair - filter events by fairs or exhibitions
• &format=hackathon - filter events by hackathons or technical events
• &format=leisure - filter events by leisure or sport events
• &format=livestream - filter events by live streams
• &format=longterm - filter events by long-term events (5+ days)
• &format=meetup - filter events by casual meetups
• &format=panel - filter events expert panels, symposiums, or lectures
• &format=party - filter events by parties or hanghouts
• &format=questions - filter events by Q&A sessions or AMAs
• &format=roadshow - filter events by roadshows, promotions, or pitches
• &format=scholarship - filter events by scholarships or educational programs
• &format=seminar - filter events by workshops or seminars

You can also combine the above listed parameters for limiting the events to be shown, for example: &format=conference,longterm,panel

Mode Configuration

The &mode= parameter is accepting one value from this list:

• &mode=details - show events in the detailed view
• &mode=list - show events as a list
• &mode=tiles - show events including preview images of the event website

If you leave out the mode parameter, &mode=tiles is used by default.

Modal Configuration

A modal is a popup window shown when you click on an event. The &modal= parameter is accepting one value from this list:

• &modal=1 - show a modal window when clicking on an event
• &modal=0 - do not show a modal window when clicking on an event

If you leave out the modal parameter, &modal=1 is used by default. 

Demo Calendars

You can see a demostration of how the Yard Calendar works as Javascript Integration on the Yard iFrame demo page.

Changelog

The Yard Javascript is constantly improved. You can view a record of the changes in the changelog.