Pagelet
We are all familar with web pages, but Sandvox introduces the concept of pagelets. A pagelet is in effect, a miniature webpage that you place alongside a page's main content to display supplemental information.
Pagelets are generally 200 pixels wide and can be placed in the Sidebar or within a page as a callout. Note that sometimes, it may not be possible to add a pagelet to a page, as the page may not have a Sidebar, or accept callouts
Some pagelets are just miniature versions of their corresponding page type (e.g Text and Photo pagelets). Other pagelets (e.g. List of Links and RSS feeds) are specialized displays of information that only appear in pagelet form.
Pagelet Types
Sandvox 1.2 ships with 17 different pagelet types:
- Text Pagelet
- A simple lump of text that you can format.
- Photo Pagelet
- A small image with optional caption.
- Amazon List
- A list of Amazon products. You can pick them yourself or load an existing list, such as your Amazon Wish List.
- Collection Index
- Lists the pages in a Collection.
- Contact Form
- A form allowing site visitors to easily contact you while protecting your e-mail address.
- Del.icio.us List
- Lists your del.icio.us bookmarks.
- Digg List
- Displays the top stories from Digg.
- Embedded Page
- An external webpage contained within a pagelet. Sometimes known as an iFrame.
- Flickr Badge
- A small gallery of photos from Flickr.
- IM Status
- Displays if your iChat (AOL/AIM) or Skype is currently online.
- List of Links
- A customizable list of links to external webpages.
- Movie Pagelet
- Embeds a multimedia file (e.g video, audio, Flash content) in a pagelet with full playback controls.
- Page Counter
- Indicates how many times your site has been visited.
- RSS Badge
- Links to the RSS feed of a collection, allowing visitors to easily subscribe to it.
- RSS Feed Pagelet
- Displays the up-to-date headlines from an RSS or Atom feed.
- Sandvox Badge
- A small image that shows you used Sandvox to build the site. Click on it to go to the Sandvox site
- Raw HTML Pagelet
- Requires Sandvox Pro. A pagelet of your own custom HTML code.
Custom Pagelet Types
To expand on the basic page types, experienced Cocoa Developers can use the "Sandvox Developers Guide" to create custom pagelet types.
For a guide on how to install such third party pagelet types, please see "Installing Sandvox Plugins and Designs."
Working With Pagelets
Ways to add a new pagelet to a page:
Ways to edit a pagelet's settings:
- Click the pagelet to select it and open the Selection Inspector.
- Double-click the pagelet.
Ways to remove a pagelet from a page:
- Click the pagelet to select it, and choose "Delete Pagelet" from the Edit menu.
- Select the pagelet and press command-option-backspace.
- Control-click the pagelet and choose "Delete Pagelet" from the contextual menu.
To duplicate a pagelet:
- Click the pagelet to select it.
- Choose "Duplicate" from the Edit menu.
Additionally, all the usual clipboard commands (cut, copy and paste) can be used with Sandvox pagelets.
