issuupress

Description

Issuu.com is a great place to host your PDF magazines, but you’d rather keep your visitors on your site then send them over, right?

Issuupress fetches (via the Issuu API) a list of all your PDFs hosted on issuu.com and allows you to display that list on your blog via a simple shortcode.

You can optionally restrict the list by tag, and control the issuu viewer via shortcode attributes.

You will need credentials to access the issuu API: login to issuu and access http://issuu.com/services/api/ to find your own API key and key secret.

Please rate the plugin if you like it.
Thanks,
pixeline

Usage

Simply put the [issuupress] shortcode where you would like the catalog to be. Add attributes to customize it.

Example:
[issuupress viewer=”mini” titlebar=”false” vmode=”” ctitle=”Pick a PDF file to read” height=”480″ bgcolor=”FFFFFF”]

To customize its appearance, use your theme’s CSS style.css file.

Screenshots

  • Mockup of the Issuu viewer with the list of pdfs underneath, fetched via the Issuu API.
  • The Settings screen.

Installation

  1. Extract the zip file
  2. Drop the contents in the wp-content/plugins/ directory of your WordPress installation
  3. Activate the Plugin from Plugins page.
  4. Go to Settings > IssuuPress, enter your API key and API secret, set the cache value.
  5. Use the shortcode wherever you see fit. To customize its appearance, use your theme’s CSS style.css file.

Example

[issuupress viewer="mini" titlebar="false" vmode="" ctitle="Pick a PDF file to read" height="480" bgcolor="FFFFFF"] 

Options

  • viewer=”mini” : Possible values: “no”,”mini”,”presentation” or “window”. Default: “mini”.
  • titlebar=”false” : Displays the PDF’s titlebar. Possible values: “true”, “false”. Default: “false”.
  • vmode=”” : Displays pages next to each other, or underneath each other (“single”). Possible values: “single”, “”. Default: “”.
  • ctitle=”” : Title to print on top of the list of pdf files. Default: “Pick a PDF file to read”
  • height=”480″ : Controls the viewer ‘s height dimension. In pixels. Default: “480”.
  • bgcolor=”FFFFFF” : Controls the viewer background color. In hexadecimal. Default :”FFFFFF”.
  • img=”false” : Set this to a number will display the thumbnail of each pdf at the provided width (ex: img=”120″ will display the thumbnail at the width of 120px).

Contributors & Developers

“issuupress” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.3.2

  • Fixed issue with links leading to 404
  • Tested against wordpress 4.4

1.3.1

  • Fixed issue if your website is using SSL (https protocol)
  • Tested against wordpress 4.2

1.3.0

  • Enhancement: added the option to only fetch public/private or both documents from your Issuu account.
  • removed Tag support, since Issuu removed it.
  • Enhancement: added the option to set the display order.
  • Fixed “Notice: has_cap”
  • Fixed issues related to the cache file not being writable
  • Fix: smarter automatic setup on plugin initial configuration
  • Fix: use “https” url instead of http to remove security warning on SSL websites.
  • Improvement: add “&debug” to the settings page url to display a Debug box with useful information (or simply click on the “View Debug information” link in the Settings screen.

1.2.5

  • removed causes for php notices.

1.2.4

  • Improved error reporting
  • Improved the Rebuild Cache process
  • Thanks to Adam Lazzarato for bug reporting and beta testing °-)

1.2.3

  • Fixed warnings appearing if no document was found.

1.2.2

  • Annoying warning happening on some installations after updating the plugin. Hopefully this should sort it out.

1.2.1

  • woops. A few quirks got left behind.

1.2.0

  • New option: show a message when no pdf is returned.
  • New shortcode attribute “img” that can be used to display pdf thumbnails (suggested by Adam Lazzarato). Set the img to the desired width (ex: img=”120″ will display the thumbnail at the width of 120px).
  • Removed an incoherence that could make it that no pdf would be displayed if no tag was provided. Sorry about that.

1.1.1.

  • Fixed the tag not actually filtering anything (duh!).

1.1.0.

  • Added many additional attributes to the shortcode to allow you to customize the viewer
  • Added admin option to manually refresh the cache.

1.0.1.

Fixed a lot of initalisation bugs. Sorry about that.

1.0.0.

Initial release.