Plugins/iPaper

< Plugins(Redirected from IPaper plugin)

iPaper is no longer supported or under active development. Please use DocsViewer instead.

The iPaper plugin embeds iPaper document viewers into your Omeka item pages.

Warning, use this plugin at your own risk: This plugin uses a deprecated iPaper technology that is no longer supported by Scribd (QuickSwitch). Omeka makes no guarantee that this plugin will function as expected, but recent tests show that it works for now. Omeka plans to update the code to work with Scribd's preferred technology, Scribd API.

Developed by the document sharing company Scribd, iPaper is a "document format built for the Internet." With Omeka's iPaper plugin you'll be able to automatically convert your documents to the iPaper format and embed them into your website. All you need is to register for a free Scribd Platform API account, install and configure the Omeka iPaper plugin, and your documents will be available for browsing and searching directly in your web browser. Supported documents include Portable Document Format (pdf), Microsoft Word (doc), PowerPoint (ppt), and most OpenDocument formats.

Installation

  1. Register for a free Scribd Platform API account (a third party web service)
  2. Upload and activate the iPaper plugin (see Installing_a_Plugin)
  3. Configure the plugin in Omeka (see below)

Configuring the iPaper plugin

The iPaper plugin has several configurations:

  • Scribd Publisher ID (required)
    • Enter the publisher ID given to you when you registered for a Scribd Platform (API) account
  • Make your documents public on Scribd?
  • Select the default iPage view mode
    • 'list' (the default)
    • 'book' (two-page spread)
    • 'slideshow' (the default for presentations)
    • 'tile'
  • Select the formats you want iPaper to display
    • There are currently 16 supported formats, including pdf, doc, ppt, and xls.
  • The height of the iPaper, in pixels
    • Leave this blank if you want iPaper to size itself for the webpage it's embedded in.
  • The width of the iPaper, in pixels
    • Leave this blank if you want iPaper to size itself for the webpage it's embedded in.
  • Show the iPaper document viewer on your admin theme?
  • Show the iPaper document viewer on your public theme?

Using iPaper in your Theme

If you want to include the iPaper functionality in your public theme, simply check the box next to "Show the iPaper document viewer on your public theme?" in the plugin configuration form (see above).

If this does not work try adding the following code near the bottom of the items/show.php file in your theme:

<?php echo plugin_append_to_items_show(); ?>