What is a gadget?
A gadget is an element on a web page that displays content. The content can be static content such as text or a picture, or dynamic content such as a membership registration form, a blog, or a list of upcoming events.
A gadget can be inserted into a cell within a layout, or inserted above or below a layout. Gadgets can be added to individual site pages or to a page template so that all pages that use that template will automatically display the gadget.
Inserting a gadget
Gadgets can be inserted a number of locations, including:
- into a cell within a layout, either within the page or within the page template used by the page
- above or below a layout
- above or below another gadget
- into a placeholder within the page or page template
To insert a gadget, follow these steps:
- Begin editing the site page or page template.
- Click the Gadgets icon to display the list of available gadgets.
- Drag the gadget you want to insert from the Gadget list, and drop it on the desired location.
When a layout cell or placeholder is empty, a Drop gadget or layout here prompt will be displayed. When you begin dragging a gadget, possible destinations for the gadget appear blue. When you drag a gadget over an empty layout cell or placeholder, it turns green, indicating that you can drop the gadget there.
When you drag a gadget above or below a layout or another gadget, a prompt will appear indicating that you can drop the gadget before or after the layout.
Some gadgets – called singular gadgets – cannot be combined with other singular gadgets on the same page, and are therefore not available when editing templates or system pages. Once a singular gadget is added to a page – either directly or through the page template – all singular gadgets become disabled within the gadget list.
Controlling the content of the gadget
For most gadgets, the content is automatically retrieved and displayed. For content gadgets – displaying static rather than dynamic content – you add content to the gadget using the content editor .
For example, the information displayed by a member directory gadget is extracted from your Wild Apricot database and displayed without further effort on your part. The appearance and behavior can be controlled using the gadget's settings, but the actual content of the gadget is automatically rendered.
Once you have opened the content gadget for editing, you can add or modify text, picture, tables, links, and other content. Your changes will be reflected in the preview version of the page. For more information, see Using the content editor.
Gadgets added to a page template can only be modified while editing the template. Gadgets that cannot be modified while editing a page are marked by diagonal stripes.
Gadget settings: controlling appearance and behavior
By modifying a gadget's settings, you can control its appearance and behavior.
For an event calendar gadget, for example, you can control the type of events to be included, the section labels, and the text to be displayed if there are no events.
Gadget settings appear in a panel on the left side (which can be hidden to maximize the page design area).
In some cases, the content of a dynamic gadget can be affected by settings other than the gadget settings. For example, whether events appear on an event calendar gadget depend on the event detail settings for each event. Where a dynamic gadget displays a form – such as a membership application gadget – the fields that appear on the form will be drawn from the fields in your Wild Apricot database. You can customize the content of these forms by adding, removing, and modifying the fields in your Wild Apricot database.
Dynamic gadgets can also be affected by the settings of other related gadgets. For example, the forum categories that are used to group multiple forums within a forum summary gadget are set within the forum gadget's settings.
For some gadgets, the visibility of the data being displayed can be restricted to certain types of members. For all gadgets, access to the page on which the gadget appears can be controlled using the page settings.
Hiding the settings panel
To hide the settings panel, click the left chevron at the top of the panel.
To show the hidden panel, click the right chevron.
Common gadget settings
The gadget settings that are available depend on the gadget type, but a number of settings are available for most gadgets. These settings are described below.
By setting margins, you control how much space – in pixels – appears outside the gadget. You can set top, bottom, left, and right margins separately.
If you specify a gadget title, the title will appear specially formatted within the gadget. Depending on the gadget style you choose, the title may appear in a heading box.
The gadget style determines the physical appearance of the gadget. The style you choose will determine the color and format of the gadget title, the gadget content, and the gadget border.
You can choose from theme-specific styles and styles that are common to all themes.
Within the Advanced section, you can enter CSS code or classes to further control the appearance and behavior of a gadget. You can also use CSS in the same way to control the appearance of layouts and placeholders.
To display the advanced settings, click the triangle beside the Advanced heading.
The following advanced settings are available:
CSS code to control the behavior or appearance of the gadget. For example, you could enter width: 250px; to control the width of the gadget.
Controlling gadget dimensions
Normally, the width of a gadget depends on its content and the layout or placeholder in which it appears. For some gadgets, you can control the dimensions through their settings. For all gadgets, you can control the gadget width by entering the following code in the Inline style setting:
where the value of 250 can be replaced by whatever value you choose.
Moving a gadget
You can move the gadget to an empty layout cell, or to a spot above or below a layout.
Deleting a gadget
The following gadgets are available.
Blog to provide updates and information to your membership
List of your most recent blog posts
Text, graphics, links, and other custom content
Title or headline for gadgets and sections
Form that allows visitors to donate to your organization
Progress bar that measures progress towards donation goal
List or calendar of current and past events
List of upcoming events that links to event details
Forum that allows members to post and reply to messages
Summary of the activity in your forum(s)
List of the most recent forum updates
Log in button that links to an authentication page
Controls to log in or out, reset password, and view profile
Searchable list of members that links to individual member profiles
Form to apply for membership in your organization
Form that allows visitors to sign up to receive email blasts
Google map pinpointing specified location
Collection of pictures with thumbnail previews
Rotating set of pictures
Links to site pages grouped into menus
|Secondary menu||(Blueprint, Bookshelf, Building Blocks, Fiesta, Firma, Homestead, Showcase, Skyline, Tinted Tiles, Terra, and Whiteboard themes) Text links to internal or external pages|
Current location within the menu hierarchy
Text links to selected site pages
Text links to all pages within site hierarchy
|Site search||Search Wild Apricot site pages, events, blog, forums, and member profiles|
Embed a Facebook page
Allow Facebook users to comment on your site page
|Sharing buttons||Buttons to share the page with social networks|
Buttons that link to your profile on social networks
Some gadgets – called singular gadgets – cannot be combined with other singular gadgets on the same page, and are therefore not available when editing templates or system pages.
For example, you cannot combine an events calendar with a photo album on the same page.
The following gadgets are singular gadgets:
- Discussion forum
- Donation form
- Event calendar
- Forum summary
- Membership application
- Member directory
- Photo album
- Subscription form
What you can't do with gadgets
- You cannot insert a gadget into another gadget. For example, you cannot insert a Google map gadget into a content gadget.
- You cannot copy a gadget from one page or template to another, or within a page.
- You cannot undo changes to a gadget or its settings.
- You cannot restore a deleted gadget.