You can use Prizm Viewer in different ways, depending on your needs. The most popular methods are described below, along with a table showing the optional parameters you can use to customize the viewer and tips for playing your document as a slideshow.
The steps below create a link in a social media update or email that opens your document in the Prizm Viewer demo page.
If you use a third-party content manager like WordPress, Joomla! or Drupal, you can install a plugin that will facilitate the insertion of Prizm Viewer into your content. You can even apply any of the optional parameters that customize the viewer.
The steps are easy, but they differ for each platform. To get started, visit the Plugins and Extensions page and click the logo for your content manager.
Immediately after you sign up, you’ll see the My Viewers page, which helps you correctly phrase a URL for displaying your document. Just fill in the address of your document, and the My Viewers page produces a URL for displaying it. You can copy the URL and paste it wherever you need it.On the My Viewers page, you can also set a few optional parameters, like the size of the viewer window. A button for returning to My Viewers appears at the top of the Prizm Viewer page, so you can return to create URLs to other documents.
Below are some additional details on the two ways you can manually set up viewing of a document through Prizm Viewer:
Make a link that includes the viewer address, your document address, and the key, and put it where you want it.
Write simple HTML that opens your document in a new tab/window, or within the current page in an <iframe> element (the powerful way).
Either way you go, you need to sign up first to get your key by email. And either way, you can apply optional parameters to define the height and width of the display window, choose whether to show the Print button on the toolbar, encrypt for added security, and more.
To display a document, simply create a link with a URL that includes the Prizm Viewer address (http://connect.ajaxdocumentviewer.com), the key you received when you signed up, and your document address. For example, suppose that:
A link with the following URL opens your document in a new browser tab/window, using the default settings for optional parameters. Pay special attention to where the characters ?, = and & appear. http://connect.ajaxdocumentviewer.com?key=12345&document=http://www.mydoc.com/resume.pdf
That’s all there is to it.
To embed a document, you can use a simple
The sample below creates a text link that opens the specified document in a new browser window.
The sample below opens the specified document in a 650x600 frame on the current page.
Any multi-page document you display with Prizm Viewer can be presented as a self-running slideshow that skips through its pages automatically at a pace that you control.
You can customize the experience, choosing how long each page is displayed, whether the show starts automatically or waits at the first slide for the visitor to start it, which animation style to use for page turns, and more. And your visitors can pause and play the slideshow, and go forward or backward through pages manually.
You can add the following parameters to the URL to adjust the look and functionality of Prizm Viewer. Simply add an ampersand (&) after the document file name, followed by the parameter name, an equals sign (=), and the setting you want to apply.
For example, to add parameters specifying a window size of 600 pixels high by 800 pixels wide for the simple sample at the top of this page:
The table below describes all of the available optional parameters, except for those that control encryption, which are described in the next section. The defaults indicated for some parameters are the settings that will be applied if you do not use the parameter.
Note: Prizm Viewer is actually three viewers: a default viewer for browsers equipped with Flash, another that opens automatically in HTML5 browsers only when Flash is not present, and the slideshow viewer. By giving you both HTML5 and Flash versions, Accusoft has ensured broad compatibility with the available recent browser versions, including mobile browsers. A few optional parameters are available only in the Flash version; see the Viewer column in the table below. You can use the viewertype parameter to force Prizm to use one viewer or the other.
Note: If the URL of your document contains a query string, the document URL must be "URL encoded" within the Prizm Viewer URL. For more information about URL encoding, see http://www.w3schools.com/tags/ref_urlencode.asp.
Note: For the best experience, the document and logoimage parameters should use secure links when SSL is enabled; otherwise the user will see security pop-ups.
If you use the Prizm Viewer Premium Edition, you can apply parameters that encrypt the document URL (and optional parameter settings, if any) so that it cannot be seen by users, providing an extra measure of security for the files on your server.
Encryption is a two-step process:
Phrase your full URL, including any optional parameters, as described in the preceding sections. Then create an HTTP GET request as follows, adding /encrypt between the document address and the key. For example:
If the request succeeds, the server responds with an encrypted string, like the following:
To display the document, you will phrase the URL for your link, <href> element or <iframe> element a little differently:
The following parameters can be used to load Prizm Viewer with encryption.