Control and promotion spuds

What you can learn in this topic

• What's the difference between a control and promotion spud
• Add and customize the control and promotion spuds you want to use
• Remove a control or promotion spud

What's the difference between a control spud and a promotion spud

Control spuds

You use control spuds on the same page as your main calendar spud. Visitors interact with control spuds to change the state of the main calendar spud. For example, you can add control spuds that let visitors change the view, filter the events they see, and search by keyword or location.

The following image shows several control spuds above and beside the main calendar.

1. Tabbed View Chooser spud
2. Month List spud
3. Keyword Search spud
4. Calendar, sub-calendar, category, and location Filter spuds

Promotion spuds

Promotion spuds promote events. You use them on pages of your website that do not contain your main calendar spud to attract the attention of site visitors and direct them to the main calendar page.

1. Date Finder spud
2. Upcoming events spud

Add and customize the control and promotion spuds you want to use

To add control and promotion spuds, you go to the Control Spuds and Promotion Spuds tabs in the Publishing Control Panel. For each spud you add, Trumba Connect generates the script that you use to embed the spuds into your webpages.

Tip When you first visit the tabs for a newly published calendar, you see the most popular spuds already in place. These spuds include the Month List, Search, and View Chooser control spuds and the Date Finder and Day Summary promotion spuds. You can preview (1) and edit the settings (2) for each of these default spuds. Or, if you decide not to use one of these spuds, you can easily remove it (3) (default spuds you remove are still visible in the hosted view).

To add a control or promotion spud

1. In your Trumba account, display the calendar to which you want to add control or promotion spuds. Click Publish.

   If you haven't published your calendar yet, go through the publishing settings, and click OK.

   I'd like more information about the publishing settings.

2. On the Control Spuds or Promotion Spuds tab, click Add a Control Spud or Add a Promotion Spud.
3. In the Add Spud page, select a spud that you want to add, and then click OK.
4. You see an Edit Settings page with Settings and Styles tabs.

   The available settings and styles vary widely depending upon the type of spud you're adding.

   By default, spuds inherit the global calendar styles but you can modify any of the settings for a specific spud.

   I'd like more information about global styles and the Color Picker.

   For promotion spuds, some of the important settings include selecting the start and end dates, the number of events you want the spud to show, the timeframe you want the spud to cover, and whether to show multi-day events on just the first day or on all days on which they occur.

   For example, if you set the end date to be Current day +180 days and number of events to 12, and the number of events on your calendar during the next 180 days is greater than 12, the spud will display only 12 events. On the other hand, if the next event starts 181 days from the current date, no events will appear in the spud.

   Tip When you're working with a spud's settings and styles, it's a good idea to frequently click Preview at the bottom of the page. In the preview, you can immediately see the repercussions of your choices.

5. When you're satisfied with the settings, click OK.

   The spud appears on the Control Spuds tab or Promotion Spuds tab, along with the script you copy to embed it in your webpage.

Tip You can modify a spud's settings and styles at any time by finding the spud on the Control Spuds or Promotion Spuds tab, and then clicking Edit Settings & Styles.

Remove a control or promotion spud

You can remove any of the default spuds you see when you first visit the Control Spuds or Promotion Spuds tab. You can also remove any spud you add yourself.

Caution If you embedded the code for the spud you're removing into any of your webpages, be sure to delete the code before you remove the spud. If code for a spud you remove is still embedded, the spud appears but it reverts to the default styles and settings. If you add the spud back to the control panel, you have to reset the custom settings manually.

To remove a control or promotion spud

1. In the Publishing Control Panel, on the Control Spuds or Promotion Spuds tab, find the spud you want to remove.
2. Click the Remove link.

   The spud and its script code disappear from the tab.