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

Translate “issuupress” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

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.