Web Developers: iKnapsack™ Plug-in Support

This page explains how you can add iKnapsack Plug-in support on your web pages. These Plug-ins can be used by any iKnapsack-enabled web browser:

Add Palm Data: Add data to Address Book, Date Book, To Do List, Memo Pad, and Expense apps.
Open URL

Add Palm Data

The Add Palm Data Plug-in allows you to add data to the built-in Address Book, Date Book, To Do List, Memo Pad, and Expense applications on your Palm organizer. Add Palm Data replaces the original Add Address, Add Date, Add To Do, Add Memo, and Add Expense iKnapsack Plug-ins from iKnapsack 1.0.

Add Palm Data has five modes to let you add new addresses, dates, to do items, memos and expenses.

Add Date

This mode adds news dates and events to your organizer's Date Book. The parameter list for Add Date mode is listed below. With the exception of the first, all of these parameters are optional when using the Add Palm Data Plug-in:

Required Parameters

iPLG: iADD
This parameter tells iKnapsack to use the Add Palm Data iKnapsack Plug-in to process the incoming data. You must include this parameter.
type: 1
This parameter tells iKnapsack to use the Add Date mode of the Add Palm Data Plug-in.

Parameters

desc: Event description
date: Event data in YYYY-MM-DD format
text: Event note
start: Start time in HH:MM 24-hour format
end: End time in HH:MM format
notime: Specify whether the event should have a time or no time
1: No time. Ignore the start and end parameters
Anything else or omit: Use the start and end parameters to schedule the time for this event
alarm: Specify whether the event has an alarm or not
1: This event has an alarm
Anything else or omit: This event does not have an alarm
adv: Amount of time before the alarm occurs
advunit: Unit of time before the alarm occurs
0: Days
1: Hours
2: Minutes

Add Date Mode Usage Format

<FORM METHOD="get" ACTION="palmcall:iSAK.appl?iPLG=iADD&type=1">
	XXXX
	<INPUT TYPE="submit" VALUE="Y">
</FORM>

or

<A HREF="palmcall:iSAK.appl?iPLG=iADD&type=1XXXX"> Y </A>

where

XXXX = Parameter list
Y	= Title for submit button or anchor tag

Adding Support On Your Web Page

The following sample code demonstrates how to use the Add Date mode on your web site. You can send a message to the Add Palm Data Plug-in by

	<FORM METHOD="get" ACTION="palmcall:iSAK.appl?iPLG=iADD&type=1">
		<INPUT TYPE="hidden" NAME="desc" VALUE="Board Meeting">
		<INPUT TYPE="hidden" NAME="date" VALUE="1999-09-30">
		<INPUT TYPE="hidden" NAME="start" VALUE="12:00">
		<INPUT TYPE="hidden" NAME="end" VALUE="14:00">
		<INPUT TYPE="hidden" NAME="text" VALUE="Discuss financials">
		<INPUT TYPE="submit" VALUE="Add Event">
	</FORM>
	
or

	<A HREF="palmcall:iSAK.appl?iPLG=iADD&type=1&desc=Board Meeting&date=1999-09-30&
		start=12:00&end=14:00&text=Discuss financials">Schedule Board Meeting</A>

Method 2 creates a standard hyperlink, as shown here: Schedule Board Meeting

Both methods do the identical thing, which is to call the iKnapsack Plug-in Add Date to add an event for a board meeting to discuss financials from 12:00 pm to 2:00 pm on September 30, 1999

Add Address

This mode adds new addresses to your organizer's Address Book. The parameter list for Add Address is listed below. With the exception of the first, all of these parameters are optional when using the Add Address Plug-in:

Required Parameters

iPLG: iADD
This parameter tells iKnapsack to use the Add Palm Data iKnapsack Plug-in to process the incoming data. You must include this parameter.
type: 2
This parameter tells iKnapsack to use the Add Address mode of the Add Palm Data Plug-in.

Parameters

first: First name
last: Last name
comp: Company name
title: Title
work: Work phone number
home: Home phone number
fax: Fax number
other: Other phone number
email: Email
addr: Address
city: City
state: State
zip: ZIP Code
country: Country
cust1: Custom Field 1
cust2: Custom Field 2
cust3: Custom Field 3
cust4: Custom Field 4
text: Address Note

Add Address Mode Usage Format

<FORM METHOD="get" ACTION="palmcall:iSAK.appl?iPLG=iADD&type=2">
	XXXX
	<INPUT TYPE="submit" VALUE="Y">
</FORM>
	
or

<A HREF="palmcall:iSAK.appl?iPLG=iADD&type=2&XXXX"> Y </A>

where

XXXX = Parameter list
Y	= Title for submit button or anchor tag

Adding Support On Your Web Page

The following sample code demonstrates how to use the Add Address mode on your web site. You can send a message to the Add Palm Data Plug-in by

	<FORM METHOD="get" ACTION="palmcall:iSAK.appl?iPLG=iADD&type=2">
		<INPUT TYPE="hidden" NAME="first" VALUE="John">
		<INPUT TYPE="hidden" NAME="last" VALUE="Doe">
		<INPUT TYPE="hidden" NAME="home" VALUE="555-1234">
		<INPUT TYPE="hidden" NAME="email" VALUE="jdoe@jdoe.com">
		<INPUT TYPE="submit" VALUE="Add Address">
	</FORM>
	
or

	<A HREF="palmcall:iSAK.appl?iPLG=iADD&type=2&first=John&last=Doe&home=555-1234&
		email=jdoe@jdoe.com">Add Address</A>

Method 2 creates a standard hyperlink, as shown here: Add Address

Both methods do the identical thing, which is to call the iKnapsack Plug-in Add Address to add John Doe's contact information directly to your Address Book database.

Add Expense

This mode adds news items to your organizer's Expense App. The parameter list for Add Expense is listed below. With the exception of the first, all of these parameters are optional when using the Add Expense Plug-in:

Required Parameters

iPLG: iADD
This parameter tells iKnapsack to use the Add Palm Data iKnapsack Plug-in to process the incoming data. You must include this parameter.
type: 3
This parameter tells iKnapsack to use the Add Expense mode of the Add Palm Data Plug-in.

Parameters

date: Event data in YYYY-MM-DD format
amt: Expense amount in US dollars
vend: Vendor name
text: Event note
city: City
attendees: Attendees
pay: Transaction method
0: American Express
1: Cash
2: Check
3: Credit Card
4: MasterCard
5: Prepaid
6: Visa
7: Unfiled (default)
typ: Expense type
0: Airfare
1: Breakfast
2: Bus
3: Business Meals
4: Car Rental
5: Dinner
6: Entertainment
7: Fax
8: Gas
9: Gifts
10: Hotel
11: Incidentals
12: Laundy
13: Limo
14: Lodging
15: Lunch
16: Mileage
17: Other (default)
18: Parking
19: Postage
20: Snack
21: Subway
22: Supplies
23: Taxi
24: Telephone
25: Tips
26: Tolls
27: Train

Add Expense Mode Usage Format

<FORM METHOD="get" ACTION="palmcall:iSAK.appl?iPLG=iADD&type=5">
	XXXX
	<INPUT TYPE="submit" VALUE="Y">
</FORM>

or

<A HREF="palmcall:iSAK.appl?iPLG=iADD&type=5&XXXX"> Y </A>

where

XXXX = Parameter list
Y	= Title for submit button or anchor tag

Adding Support On Your Web Page

The following sample code demonstrates how to use the Add Expense mode on your web site. You can send a message to the Add Palm Data Plug-in by

	<FORM METHOD="get" ACTION="palmcall:iSAK.appl?iPLG=iADD&type=5">
		<INPUT TYPE="hidden" NAME="date" VALUE="1999-09-30">
		<INPUT TYPE="hidden" NAME="amt" VALUE="19.95">
		<INPUT TYPE="hidden" NAME="vend" VALUE="Foundation Systems">
		<INPUT TYPE="hidden" NAME="text" VALUE="iKnapsack Registration">
		<INPUT TYPE="hidden" NAME="typ" VALUE="17">
		<INPUT TYPE="hidden" NAME="pay" VALUE="4">
		<INPUT TYPE="submit" VALUE="Add iKnapsack Order">
	</FORM>

or

	<A HREF="palmcall:iSAK.appl?iPLG=iADD&type=5&date=1999-09-30&amt=19.95&vend=Foundation Systems&
		text=iKnapsack Registration&typ=17&pay=4">Add iKnapsack Order</A>

Method 2 creates a standard hyperlink, as shown here: Add iKnapsack Order

Both methods do the identical thing, which is to call the iKnapsack Plug-in Add Expense to add an expense item of $19.95 from Foundation Systems for an iKnapsack Registration on September 30, 1999. The purchase was paid for by MasterCard and filed as an expense type of other.

Add Memo

This mode adds news notes to your organizer's Memo Pad. Both parameters are required for Add Memo to operate correctly:

Required Parameters

iPLG: iADD
This parameter tells iKnapsack to use the Add Palm Data iKnapsack Plug-in to process the incoming data. You must include this parameter.
type: 4
This parameter tells iKnapsack to use the Add Memo mode of the Add Palm Data Plug-in.
text: Contents of the memo.

Add Memo Mode Usage Format

<FORM METHOD="get" ACTION="palmcall:iSAK.appl?iPLG=iADD&type=4">
	<INPUT TYPE="text" VALUE=XXXX>
	<INPUT TYPE="submit" VALUE="Y">
</FORM>
	
or

<A HREF="palmcall:iSAK.appl?iPLG=iADD&type=4&text=XXXX"> Y </A>

where

XXXX = Contents of new memo
Y	= Title for submit button or anchor tag

Adding Support On Your Web Page

The following sample code demonstrates how to use the Add Memo memo on your web site. You can send a message to the Add Palm Data Plug-in by

	<FORM METHOD="get" ACTION="palmcall:iSAK.appl?iPLG=iADD&type=4">
		<INPUT TYPE="hidden" NAME="text" VALUE="Hello World!">
		<INPUT TYPE="submit" VALUE="Add Memo">
	</FORM>

or

	<A HREF="palmcall:iSAK.appl?iPLG=iADD&type=4&text=Hello World!">Add Memo</A>

Method 2 creates a standard hyperlink, as shown here: Add Memo

Both methods do the identical thing, which is to call the iKnapsack Plug-in Add Memo to add a note with the text, "Hello World!"

Adding carriage returns

Adding the string %0A to your Add Memo query strings will allow you to add carriage returns to your new memo pad entries. For instance:

	<FORM METHOD="get" ACTION="palmcall:iSAK.appl?iPLG=iADD&type=4">
		<INPUT TYPE="hidden" NAME="text" VALUE="Hello%0AWorld!">
		<INPUT TYPE="submit" VALUE="Add Memo">
	</FORM>

or

	<A HREF="palmcall:iSAK.appl?iPLG=iADD&type=4&text=Hello%0AWorld!">Add Memo</A>

Will create a new memo that looks like this on your Palm:

	
	Hello
	World!

Add To Do

This mode adds news items to your organizer's To Do List. The parameter list for Add To Do is listed below. With the exception of the first two, all of these parameters are optional when using the Add To Do Plug-in:

Required Parameters

iPLG: iADD
This parameter tells iKnapsack to use the Add Palm Data iKnapsack Plug-in to process the incoming data. You must include this parameter.
type: 5
This parameter tells iKnapsack to use the Add Expense mode of the Add Palm Data Plug-in.
desc: Item description.

Parameters

priority: Priority for the item. Specify 1, 2, 3, 4, or 5. Default priority is 1
date: Due date for the item. Default due date is today
text: Item note

Add To Do Mode Usage Format

<FORM METHOD="get" ACTION="palmcall:iSAK.appl?iPLG=iADD&type=3">
	XXXX
	<INPUT TYPE="submit" VALUE="Y">
</FORM>
	
or

<A HREF="palmcall:iSAK.appl?iPLG=iADD&type=3&XXXX"> Y </A>

where

XXXX = Parameter list
Y	= Title for submit button or anchor tag

Adding Support On Your Web Page

The following sample code demonstrates how to use the Add To Do memo on your web site. You can send a message to the Add Palm Data Plug-in by

	<FORM METHOD="get" ACTION="palmcall:iSAK.appl?iPLG=iADD&type=3">
		<INPUT TYPE="hidden" NAME="desc" VALUE="Buy groceries">
		<INPUT TYPE="hidden" NAME="priority" VALUE="2">
		<INPUT TYPE="submit" VALUE="Buy Groceries">
	</FORM>

or

	<A HREF="palmcall:iSAK.appl?iPLG=iADD&type=3&desc=Buy groceries&priority=2">Buy groceries</A>

Method 2 creates a standard hyperlink, as shown here: Buy groceries

Both methods do the identical thing, which is to call the iKnapsack Plug-in Add To Do to tell you to buy groceries today with the priority of 2.

Open URL

This Plug-in opens any URL you specify to it:

Required Parameters

iPLG: iURL
This parameter tells iKnapsack to use the Open URL iKnapsack Plug-in to process the incoming data. You must include this parameter.
url: The URL to retrieve. Open URL supports the following formats:
http: http request
https: secure https request
file: Open a file on your handheld (only works with web clipping applications)
palm: palm/iKnapsack request
palmcall: Palmcall/iKnapsack request

Open URL Plug-in Usage Format

<FORM METHOD="get" ACTION="palmcall:iSAK.appl?iPLG=iURL">
	XXXX
	<INPUT TYPE="submit" VALUE="Y">
</FORM>
	
or

<A HREF="palmcall:iSAK.appl?iPLG=iURL?XXXX"> Y </A>

where

XXXX = Parameter list
Y	= Title for submit button or anchor tag

Adding Support On Your Web Page

The following sample code demonstrates how to use the Open URL Plug-in on your web site. You can send a message to the Open URL Plug-in by

	<FORM METHOD="get" ACTION="palmcall:iSAK.appl?iPLG=iURL">
		<INPUT TYPE="hidden" NAME="text" VALUE="Hello World!">
		<INPUT TYPE="submit" VALUE="Open URL">
	</FORM>

or

	<A HREF="palmcall:iSAK.appl?iPLG=iURL&url=www.tow.com">Foundation Systems Web Site</A>

Method 2 creates a standard hyperlink, as shown here: Foundation Systems Web Site

Both methods do the identical thing, which is to call the iKnapsack Plug-in Open URL to go to the Foundation Systems Web Site at http://www.tow.com/