skip navigation
See Also
Customize spud code
URL parameters
Filter URL parameter
Search spuds

Search URL parameter

The search parameter is an optional parameter that can be:

  • Included in the url argument in the $Trumba.addSpud() method.
  • Appended to the trumbaEmbed parameter in a URL-encoded query string.
  • Appended to the base URL for an RSS, Atom (XML), iCalendar (ICS), Comma Separated Value (CSV), or JSON calendar feed.

I'd like to see a complete list of URL parameters.

I'd like to know more about calendar feeds.

Application

Searches the event title, location, and description fields to deliver only events that contain specific words or phrases.

Gives you the ability to provide pages for or links to the results of common event searches.

Values

The search parameter takes words and numbers as search terms. Words are case-insensitive.

You can search for a:

  • Specific word
  • Specific number
  • Phrase
  • List of nonconsecutive words or numbers from the same event

    Tip Separate words in the list with spaces. To be retrieved, an event must contain all of the words in the list.

Examples

url argument, $Trumba.addSpud() method, main calendar spud

Limits the events that display in the main calendar spud to those containing the specified phrase.

For example, this parameter limits the events that display in the main calendar spud to those containing the phrase "food values":

<script type="text/javascript">
$Trumba.addSpud(
{ webName: "calendarname",
  spudType: "main",
  url: {search:"food values"}
});
</script>

url argument, $Trumba.addSpud() method, promotion spuds

Limits the events that display in promotion spuds to those containing the specified word.

For example, this parameter limits the events that display in the event slider spud to those containing the word "pollution":

<script type="text/javascript">
$Trumba.addSpud(
{ webName: "calendarname",
  spudType: "eventslider",
  url: {search:"pollution"}
});
</script>

URL-encoded query string

Limits the events that display in main calendar and promotion spuds to those containing the specified phrase or nonconsecutive words.

For example, this parameter limits the events that display in main calendar and promotion spuds to those containing the phrase or nonconsecutive words "banff film festival":

https://www.yoursite.com/calendar.html?trumbaEmbed=search%3Dbanff%20film%20festival

Tip %3D is the URL-encoded equals sign (=). %20 is the URL-encoded space character.

Calendar feed URL

Limits the events included with calendar feeds to those that occur on a specified date forward and/or that contain certain words.

Note You can separate multiple search terms with spaces, as the example indicates, or with commas and no spaces.

For example, this parameter limits the events included with this feed to those occurring on January 1, 2021 forward and that contain both the words "tea" and "cup":

https://www.trumba.com/calendars/calendarwebname.rss?startdate=20210101&search=tea cup

Tip In calendar feed URLs, do not include trumbaEmbed= and do not URL-encode parameters.