Pagelet
We are all familiar 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, like the Amazon List or Page Counter are specialized displays of information that only appear in pagelet form.
Pagelet Types
Sandvox 1.5 ships with 18 different pagelet types (19 in Sandvox Pro):
- Rich Text Pagelet
- A simple section 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 Archive
- Generates archival pages for a collection each month to keep track of changes to the 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.
- Delicious List
- Lists your delicious.com bookmarks.
- Digg List
- Displays the top stories from Digg.
- External 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.
- 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.
- Video
- Embeds a multimedia file (e.g video, audio, Flash content) in a pagelet with full playback controls.
- YouTube
- Displays a video from YouTube
- 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 Plug-ins 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.
