=== Google Doc Embedder ===
Contributors: k3davis
Donate link: http://pledgie.com/campaigns/6048
Tags: pdf, ppt, tiff, powerpoint, google, embed, google docs, document
Requires at least: 2.8
Tested up to: 2.9
Stable tag: trunk
Lets you embed PDF, PowerPoint presentations (PPT), and TIFF images in a web page using the Google Docs Viewer (no Flash or PDF browser plug-ins required).
== Description ==
Google Doc Embedder lets you embed PDF files, PowerPoint presentations, and TIFF images in a web page using the Google Docs Viewer (no Flash or PDF browser plug-ins required).
Similar to services like Scribd, Google Doc Embedder will allow you to embed a PDF, PowerPoint (PPT), or TIFF file directly into your page or post, not requiring the user to have Adobe Reader, PowerPoint, or other software installed to view the contents. Unlike Scribd, the files do not need to be uploaded to any service first - including Google Documents - but can exist anywhere accessible on your site or the internet.
Note: While previously the functionality of this plug-in relied upon an undocumented feature of the Google Docs Viewer, this feature is now "official" and presumably reliable in the long term. However, use of this plug-in now does imply your agreement with Google's published Terms of Service.
== Installation ==
1. Upload the entire `google-document-embedder` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Done.
For basic usage, please see the FAQ.
Go to "GDE Settings" (under "Settings" in the admin panel) to change defaults, or override individually using the shortcode syntax in the FAQ.
== Frequently Asked Questions ==
= What file types can be embedded? =
This plug-in can embed PDF, PowerPoint (PPT), or TIFF files only. The file to embed must first be publicly available somewhere on the internet. You can upload it to your WordPress site using the standard techniques, or link to a file on another site.
= How do I embed a file in my page or post? =
Use the custom shortcode `[gview]` to embed the file, as shown:
`[gview file="http://url.to/file.pdf"]`
Note: the `file=` attribute (pointing to the full URL of the file) is **required**.
Optional attributes:
* `save=` : Set to 0 if you wish to suppress the direct download link to the file under the embedded viewer (1 for on, by default)
* `width=` : To override the default width of the viewer, enter a new width value - e.g., "400" (px) or "80%"
* `height=` : To override the default height of the viewer, enter a new height value - e.g., "400" (px) or "80%"
= Will it embed files that are password-protected or stored in protected folders/sites? =
Most likely, no. If your file requires a login to view - such as being saved in a password-protected directory, or behind a firewall (on your intranet, etc.), the viewer will probably not be able to access the file. For files stored on Google Docs, the viewer will prompt you to log in first, which most users presumably couldn't do. This is what is meant above, that the document should be "publicly available." Please save the file in a publicly accessible location for best results.
= Nothing is showing up! What do I do? =
View the source on the web page where you've embedded the viewer. In order to degrade gracefully in case an error occurs, error messages will be inserted as HTML comments in these pages at the spot the viewer is called.
= I wish the plug-in had feature XYZ... =
That's not a question ;) but if you have any particular ideas on further development of this plug-in, please post on the forum or privately using the support form and I'll see what I can do.
== Screenshots ==
1. Appearance of embedded viewer
2. Settings page
== Changelog ==
= 1.9.2 =
* Fixed: "Turn off beta notifications" needlessly still checked for beta version
* Confirmed WP 2.9 compatibility
* Beta delivery test
= 1.9.1 =
* Fixed: Options not saved in some instances due to variable collision (thanks gadgetto)
* Fixed: Options not saved when plugin is reactivated
* Changed: Default width now 100% (existing setting will be preserved)
* Added: Notification of beta versions - more info
= 1.9 =
* Added: Revealed more troubleshooting options (under "Advanced Options")
* Fixed: No longer relies on cURL for any function
* Changed: Function overhaul for general efficiency and reduced database calls
* Removed: WP 2.5 compatibility. Now requires WordPress 2.8+.
= 1.8.2 =
* Fixed: Fatal PHP error if cURL library not active (WAMPServer, etc.)
= 1.8.1 =
* Added: Temporary (I hope) workaround option to insert help statement for users of IE8 - more info
= 1.8 =
* Added: Ability to set height/width to percentage (thanks eturfboer)
* Fixed: Compatibility with PHP 5.3+, various function tuning
Full history...