RDP PediaPress Embed

Description

RDP PediaPress Embed will pull content from PediaPress book pages and embed it in pages and posts.

RDP PediaPress Embed also allows lead capture capabilities, utilizing free PediaPress ebooks as a bribe.
The default behavior is to display a pop-up light box, which will display whatever text, HTML, and/or shortcode you desire.

Your site will have an RSS feed for all books on the site, as well.

Known Issues

  • CSS clashes with Lightbox Plus Colorbox plug-in

Sponsor

This plug-in brought to you through the generous funding of Laboratory Informatics Institute, Inc.

Usage

PediaPress Book

Use the shortcode [rdp-pediapress-embed] for embedding PediaPress book pages. The following arguments are accepted:

  • url: (required) the web address of the PediaPress book that you want to embed on this page
  • download_url: the web address to the ebook or the download page
  • toc_show: 0 (zero) to hide table of contents (TOC) or 1 to show
  • toc_links: Enabled — TOC links are enabled; Logged-in — TOC links are active only when a user is logged in; Disabled — TOC links are completely disabled, all the time
  • image_show: 0 (zero) to hide cover image or 1 to show
  • title_show: 0 (zero) to hide book title or 1 to show
  • full_title: 1 to display book titles as combination of Title and Subtitle or 0 (zero)
  • subtitle_show: 0 (zero) to hide book sub-title or 1 to show
  • editor_show: 0 (zero) to hide book editor or 1 to show
  • language_show: 0 (zero) to hide book language or 1 to show
  • book_size_show: 0 (zero) to hide book size or 1 to show
  • add_to_cart_show: 0 (zero) to hide Add-to-Cart button or 1 to show
  • add_to_cart_text: text for Add-to-Cart button
  • add_to_cart_size: size of the Add-to-Cart button – small, medium, large
  • add_to_cart_color: color of the Add-to-Cart button – blue, creme, grey, orange, red
  • cta_button_show: 0 (zero) to hide Call-to-Action button or 1 to show
  • cta_button_text: text for Call-to-Action button
  • cta_button_size: size of the Call-to-Action button – small, medium, large
  • cta_button_color: color of the Call-to-Action button – blue, creme, grey, orange, red

Examples

Create a lead capture popup:

[rdp-pediapress-embed url=’https://pediapress.com/books/show/f64f601dd8d018e8a3b1164d847dce/’ download_url=’http://example.com/pdf/ebook.pdf’][gravityform id=”1″ title=”true” description=”true”][/rdp-pediapress-embed]

Create a direct download button:

[rdp-pediapress-embed url=’https://pediapress.com/books/show/f64f601dd8d018e8a3b1164d847dce/’ download_url=’http://example.com/pdf/ebook.pdf’]

Default settings will create a book page with a Table of Contents (TOC) that has disabled links. To create a book page that requires visitors to be logged in for the TOC links to work, you would set the toc_links attribute to “logged-in”:

[rdp-pediapress-embed url=’https://pediapress.com/books/show/f64f601dd8d018e8a3b1164d847dce/’ download_url=’http://example.com/pdf/ebook.pdf’ toc_links=’logged-in’]

PediaPress Gallery

Embedding a PediaPress gallery of books is implemented using the shortcode [rdp-pediapress-embed-gallery]. It accepts the following arguments:

  • col: (required) number of columns to display per page
  • num: (required) number of books to display per page
  • size: accepted values – small, medium, large – dictate image and font size of gallery elements
  • cat: comma separated list of category id numbers books must belong to
  • tag: comma separated list of tag id numbers books must belong to
  • sort_col: column name by which to sort books
  • sort_dir: direction to sort books (ASC / DESC)
  • full_title: 1 to display book titles as combination of Title and Subtitle or 0 (zero)
  • image_show: 0 (zero) to hide cover images or 1 to show
  • title_show: 0 (zero) to hide book titles or 1 to show
  • subtitle_show: 0 (zero) to hide book sub-titles or 1 to show
  • editor_show: 0 (zero) to hide book editors or 1 to show
  • language_show: 0 (zero) to hide book languages or 1 to show
  • book_size_show: 0 (zero) to hide book sizes or 1 to show

Examples

[rdp-pediapress-embed-gallery col=’3′ num=’3′]

[rdp-pediapress-embed-gallery col=’2′ num=’10’ cat=’5′ tag=’7,8′ sort_col=’post_date’ sort_dir=’DESC’]

External Scripts Included

  • jQuery ColorBox Plugin v1.3.20.2 under MIT License

Hook Reference:

rdp_ppe_scripts_enqueued

  • Param: none
  • Fires after enqueuing plug-in-specific scripts and styles

rdp_ppe_book_scripts_enqueued

  • Param 1: array containing shortcode attributes
  • Param 2: null or string containing content of enclosed shortcode
  • Fires after enqueuing book-specific scripts and styles

rdp_ppe_gallery_scripts_enqueued

  • Param 1: array containing shortcode attributes
  • Param 2: null or string containing content of enclosed shortcode
  • Fires after enqueuing gallery-specific scripts and styles

PHP Filter Reference:

rdp_ppe_allow_shortcode

  • Param 1: boolean indicating if shortcode is allowed to execute – default: true
  • Param 2: array containing shortcode attributes
  • Param 3: null or string containing content of enclosed shortcode
  • Return: boolean indicating if shortcode is allowed to execute

rdp_ppe_book_main_content_classes

  • Param: String containing class names for the #rdp-ppe-main container when displaying a single book
  • Return: class names for the #rdp-ppe-main container when displaying a single book

rdp_ppe_before_meta_open

  • Param 1: array containing book content pieces
  • Param 2: array containing shortcode attributes
  • Return: string containing HTML / JavaScript / style block to inject before opening DIV of metadata section when displaying a single book

rdp_ppe_after_meta_open

  • Param 1: array containing book content pieces
  • Param 2: array containing shortcode attributes
  • Return: string containing HTML / JavaScript / style block to inject after opening DIV of metadata section when displaying a single book

rdp_ppe_book_atc_href

  • Param 1: string containing href value for Add-to-Cart button when displaying a single book
  • Param 2: string containing URL to PediaPress.com book page
  • Param 3: array containing book content pieces
  • Param 4: array containing shortcode attributes
  • Return: href value for Add-to-Cart button when displaying a single book

rdp_ppe_atc_button

  • Param 1: string containing HTML for Add-to-Cart button
  • Param 2: array containing book content pieces
  • Param 3: array containing shortcode attributes
  • Return: HTML for Add-to-Cart button

rdp_ppe_cta_button

  • Param 1: string containing HTML for Call-to-Action button
  • Param 2: array containing book content pieces
  • Param 3: array containing shortcode attributes
  • Return: HTML for Call-to-Action button

rdp_ppe_before_meta_close

  • Param 1: array containing book content pieces
  • Param 2: array containing shortcode attributes
  • Return: string containing HTML / JavaScript / style block to inject before closing DIV of metadata section when displaying a single book

rdp_ppe_after_meta_close

  • Param 1: array containing book content pieces
  • Param 2: array containing shortcode attributes
  • Return: string containing HTML / JavaScript / style block to inject after closing DIV of metadata section when displaying a single book

rdp_ppe_toc

  • Param 1: string containing HTML for Table of Contents of a single book
  • Param 2: array containing book content pieces
  • Param 3: array containing shortcode attributes
  • Return: HTML for Table of Contents of a single book

rdp_ppe_render_book

  • Param 1: string containing HTML for a single book
  • Param 2: array containing book content pieces
  • Param 3: array containing shortcode attributes
  • Return: HTML for a single book

rdp_ppe_gallery_item

  • Param 1: String containing HTML for a single gallery item
  • Param 2: Array of input values for the gallery item
  • Return: HTML for a single gallery item

Screenshots

  • Embedded PediaPress book page
  • Gallery of PediaPress books
  • Media button to launch shortcode embed helper form
  • PediaPress book shortcode embed helper form
  • PediaPress gallery shortcode embed helper form

Installation

From your WordPress dashboard

  1. Visit ‘Plugins > Add New’
  2. Search for ‘RDP PediaPress Embed’
  3. Click the Install Now link.
  4. Activate RDP PediaPress Embed once it is installed.

From WordPress.org

  1. Download RDP PediaPress Embed zip file.
  2. Upload the ‘rdp-pediapress-embed’ directory from the zip file to your ‘/wp-content/plug-ins/’ directory, using your favorite method (ftp, sftp, scp, etc…)
  3. Activate RDP PediaPress Embed from your Plugins page.

After Activation – Go to ‘Settings’ > ‘RDP PPE’ and:

  1. Set configurations as desired.
  2. Click ‘Save Changes’ button.
  3. Go to ‘Settings’ > ‘Permalinks’ and click the ‘Save Changes’ button so the custom RSS feed will work.

FAQ

Installation Instructions

From your WordPress dashboard

  1. Visit ‘Plugins > Add New’
  2. Search for ‘RDP PediaPress Embed’
  3. Click the Install Now link.
  4. Activate RDP PediaPress Embed once it is installed.

From WordPress.org

  1. Download RDP PediaPress Embed zip file.
  2. Upload the ‘rdp-pediapress-embed’ directory from the zip file to your ‘/wp-content/plug-ins/’ directory, using your favorite method (ftp, sftp, scp, etc…)
  3. Activate RDP PediaPress Embed from your Plugins page.

After Activation – Go to ‘Settings’ > ‘RDP PPE’ and:

  1. Set configurations as desired.
  2. Click ‘Save Changes’ button.
  3. Go to ‘Settings’ > ‘Permalinks’ and click the ‘Save Changes’ button so the custom RSS feed will work.

Contributors & Developers

“RDP PediaPress Embed” is open source software. The following people have contributed to this plugin.

Contributors

Translate “RDP PediaPress Embed” into your language.

Interested in development?

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

Changelog

1.0.5

  • refactored code to utilize subtitle as part of cover image file name

1.0.4

  • refactored code to use curl and tmp/cookies.txt to satisfy PediaPress cookie capabilities check
  • bug fix
  • added rel=”noindex, nofollow” to TOC links

1.0.3

  • Security update

1.0.2

  • Added shortcode to render RSS as gallery
  • Update gallery code to handle books added as both posts and pages

1.0.1

  • Update TOC link options
  • Update shortcode pop-up script – removed validation check of download URL

1.0.0

  • Initial RC