Latest Updates: Our Blog

Entries on: embedding

Navis DocumentCloud plugin for WordPress

Jun 22nd, 2012

Code , ,

Samantha Sunne

Chris Amico had a problem he wanted to solve: when bloggers posted a document from DocumentCloud into WordPress, switching between the Visual and HTML modes destroyed the embed code. So he created Navis DocumentCloud, a plugin designed to protect the javascript from the Visual Editor.

“That crux of it is that it makes it safe to drop a document into WordPress and be certain that it won’t be broken,” said Amico, of the plugin he authored as an application developer for NPR’s StateImpact project.

Users can post their document using a DocumentCloud button on the post’s toolbar in Visual mode, or a shortcode in HTML mode.

documentcloud button

The plugin also allows users to configure the width and height of the document viewer in an administrative panel in the Settings menu. The “Full-width” option is designed to make the document viewer as wide as the post content.

“We wanted to give reporters the ability to make a post that is basically just the document,” Amico said.


The plugin is available on GitHub and the Project Argo site. StateImpact is a spinoff project of Project Argo, which are both run by NPR. Amico said he wanted to help bloggers use DocumentCloud because he used it as a reporter for PBS NewsHour. “At some point, my plan is to put it into WordPress’s plugin directory,” Amico said.

Samantha Sunne volunteers with DocumentCloud at its hub in Columbia, Missouri. She studies investigative and multimedia reporting at the University of Missouri.

Embed a Set of Documents

Mar 30th, 2011

Documents,Workspace ,


Sets of documents are nothing new to DocumentCloud.

The Las Vegas Sun published hundreds of pages of legislation, emails, court filings and medical records alongside their award winning package on hospital care in Las Vegas. The Sun‘s Marshall Allen assembled each document collection by hand to produce that page. Plenty of other newsrooms have used our API to do likewise. Even with the API it isn’t trivial to assemble and publish a set of documents.

Some document sets are living creatures that continue to grow: Chad Skleton at The Vancouver Sun has been adding documents retrieved from the local ferry authority’s website to a growing cache of public records on DocumentCloud. The only way to ensure his readers will find new documents as they roll in, is to point the public straight to DocumentCloud to find ferry authority FOIAs. It should be easier to embed that growing set of public documents right at The Vancouver Sun.

Samuel Clay has been working very hard to make that possible for every DocumentCloud newsroom. Continue reading »

New Embedding Options

Feb 2nd, 2011

Workspace , ,

Jeremy Ashkenas

You already know you can link directly to any page or annotation. Now you can embed documents so that they’ll open to any page or annotation, too. If you want to point your readers to the shocking revelation on page seventy five or open the viewer directly to a key annotation, check out our new embed dialog.

Select any document and choose “Embed Document Viewer” from the “Publish” menu, and you’ll find a new configuration option:

This document will open to an annotation on page 30. When you view the embed code, you’ll see the page number and annotation id designated in the javascript. Give it a try, and let us know what you think.

We build features like this because our users ask for them &emdash; what do you need DocumentCloud to do?