The pando:send URL tells Pando to open a Send window. If provided, it will auto-fill the email address and local files so that the user can review the information and send it. It can be used by either web sites or applications.
pando:send?email_address=submissions@videosite.com&files_to_send=c:\Cover.JPG,c:\Video.avi
Both email_address and files_to_send are optional. If they are not provided, they are left blank for the user to fill in. This provides you with the flexibility for many uses:
The pando:send URL's can be used from either a web site or an application.
For example, a web site may want users to send video files to the site using Pando. It could do so by giving a single 'submissions' email address, like this:
pando:send?email_address=submissions@videosite.com
This would open Pando's Send New window, pre-filled to send a package to submissions@videosite.com. The user would simply add the video, and click send. This is much simpler for users than launching Pando, clicking "Send Now", and copying and pasting the email address.
To provide a link on a web page to allow people to send using Pando, here is a sample HTML:
<a href="pando:send?email_address=submissions@videosite.example.com"><img src="http://www.pando.com/files/Pando-Me-Button.png"></a>
We recommend that web sites use the above graphic, so that Pando users will be able to tell that you support Pando more easily.
The web site could choose to generate a unique email address for each sender to use, and to implement an automated email processing facility. This is a technique commonly used on photo hosting web sites to allow people to send photo's securely from camera-phones (so that other people can't post photos to your web site). Similarly, this technique would allow people to use Pando to send files into their personal web sites. In this case, the URL would be similar to the above, but with a unique user ID, like this:
pando:send?email_address=12345678@submissions.videosite.com
If you are interested in integrating Pando deliveries into your workflow, you should contact us to discuss the Pando Server Integration Toolkit.
An application that is used to create or organize rich media files (such as a photo organizer, a video editor, etc.) may want to make it easy for users to send the result of their work using Pando. This can be done by adding a button to the application to "Send using Pando" that opens a pando:send URL. This will cause Pando to launch (if it is not already running), and to prepare the sending.
For example, if a video editing application added a "send using Pando" command to its GUI, it could attach the files to Pando by opening an URL like:
pando:send?files_to_send=c:\Cover.JPG,c:\Video.avi
This would bring up a Send New window in Pando, with the cover art and video file pre-attached, so the user could enter the recipient's email address, name the package, and send it.
We recommend using this button:
for sending using Pando, so that Pando users can easily recognize that your application supports Pando.
The following is an example of how a Windows application can open a URL. The application should construct the URL as defined above, and then execute the following with the desired URL replacing the italicized example URL:
ShellExecute(m_hWnd, NULL, "pando:send?files_to_send=c:\Cover.JPG,c:\Video.avi", NULL, NULL, SW_SHOWDEFAULT);
If the application wants to use Pando to package and upload the files, but manage the delivery of the Pando Package URL itself, it can do so using the Pando Client Automation Toolkit.
pando:send links are supported in Pando version 1.4 and newer, Mac OS X and Windows. The files_to_send parameter may work on Mac 1.4, but the email_address parameter does not work in the current Mac version. This will be addressed in a future version of Pando.
Comments
We should provide pre-built
We should provide pre-built Windows and Mac "Pando It" button graphics for all of the button states (normal, selected, clicked, etc.).
All the Best!
All the Best!
All the Best! (thats my idea
All the Best! (thats my idea of a dumb but nevertheless true digital signature. It is supposed to come at the end, I just won't use one. Since I'm forgetful, fat-fingered, used to normal begin all f'd up (excuse me--as in the acronym now word from wwII, SNAFU. Thank God your intellects are not FUBAR like my own. I can hardly see (glare on the screen), sit up straignt, sleep comfortably. Tech has bitten me back, if you will. That's it too. Thanks for doing some work for us.
I had written, B4 what is above, the following:
I may as well take a nap and hire (had I the money) someone to input your comprehensive informatioin here. Bravo! Really. Great explanation. A great "How To". Exemplary. I shd write book jackets. I like the feel of and vibe (smart) of your site.
Dan Goldberg with the equivalent of no left eye from the word processing engine here...
Thanks for the kind words,
Thanks for the kind words, Dan!
- Laird Popkin, CTO, Pando Networks
I posted an example of
I posted an example of pando:send in this forum post.
- Laird Popkin, CTO, Pando Networks
Are there any other
Are there any other paramaters besides email_address and files_to_send? I'd like to have a way to specify more information (a unique id). If this were a mailto: tag, I'd put it in the subject or the body. In fact, since Pando packages have a subject and a body (message), it would make sense to expose those via the URL.
Here's a sample
Here's a sample AppleScript:
tell application "Finder"open location "pando:send?email_address=laird@pando.com&files_to_send=/debug.txt"
end tell
Executing this script causes Pando to launch and display the "send new" window with my email address pre-filled and /debug.txt selected. You can build on this technique to automate Pando sending of files as a part of a work flow.
- Laird Popkin, CTO, Pando Networks
Just for fun, I wrote a
Just for fun, I wrote a script that you can attach to a folder as a Folder Action. You create a folder whose name is an email address (e.g. "laird@pando.com"). You attach this script to that folder. When you drop a file, a set of files, or a folder onto the folder "laird@pando.com" it tells Pando to offer to send the stuff to me.
on adding folder items to theFolder after receiving theFilestell application "Finder"
set folderPath to the name of theFolder
end tell
set savedTextItemDelimiters to AppleScript's text item delimiters
set AppleScript's text item delimiters to ":"
set folderName to last text item of folderPath
set AppleScript's text item delimiters to savedTextItemDelimiters
set theMessage to ((the count of theFiles) as string) & ¬
" files will be Pandoed to “" & folderName & ¬
"”."
set theUrl to "pando:send?email_address=" & folderName & "&files_to_send="
set needComma to false
repeat with theFile in theFiles
try
set theFileInfo to the info for theFile
set fileName to the POSIX path of theFile
if needComma then
set theUrl to theUrl & ","
end if
set theUrl to theUrl & fileName
set needComma to true
on error e
display dialog "oops " & e & "."
end try
end repeat
display dialog (theUrl) buttons {"OK"} default button 1
tell application "Finder"
open location theUrl
end tell
end adding folder items to
- Laird Popkin, CTO, Pando Networks
Adding two new parameters in
Adding two new parameters in Pando 1.5.5.2: subject= and message=. These will allow you to provide the subject line and body of the email that Pando will send.
I'll update the documentation when we ship 1.5.5.2.
- Laird Popkin, CTO, Pando Networks
Laird, When will the Server
Laird,
When will the Server Integration Toolkit be available for implementing the "Example: Web Site with Uploader Accounts"? I'm very eager to try it out.
m.
We're expecting to release
We're expecting to release some version of a server integration tool (a limited command-line Pando client of some form) around the time of the Pando version 1.6 is release, though the final decision on what we release and when will depend on our internal development and testing resources. 1.6 is still a few weeks away, at least. Stay tuned...