Add Issuu to the internal whitelist of oembed providers

[issuu]

This patch simply adds Issuu to the internal whitelist of oembed providers to allow for easy embedding of Issuu publications.

[SergeyBiryukov]

For reference: ​http://make.wordpress.org/core/handbook/design-decisions/#whitelisting-oembed-providers

[johnbillion]

Thanks for the patch issuu.

Could you provide some responses to the points in Sergey's link please? We can then consider this for 4.0.

[unknowndomain]

I'd like to emphasis the importance of this, as the developer of the Issuu Embed plugin which has been emulating this feature for years it would be good to have this in core, I get many emails asking about this and have been working with Issuu for over a year to get them to add this feature specifically for WordPress.

They've finally added the feature, it would be nice if it were supported by WordPress core without the need for a plugin!

[iseulde]

+1

[DrewAPicture]

• Issuu has been around for 6 or 7 years and can be considered "main-stream"
• ​Wikipedia article
• 5+ year old ​Issuu Embed plugin (89,508 downloads)
• 43k followers on ​Twitter
• Competitor to the already-supported Scribd
• Never proposed before

Follow-up for @issuu:

• Is the oEmbed endpoint supported and maintained?

FWIW, I've used the Issuu Embed plugin on several of my own projects. +1 for adding Issuu to the core providers list.

[johnbillion]

Thanks Drew

[issuu]

Hi all

Thanks for chipping into this thread with arguments for getting this patch into Wordpress :) And thanks to for pointing us to the info on how to get whitelisted: ​http://make.wordpress.org/core/handbook/design-decisions/#whitelisting-oembed-providers

Please see below for answers to the questions from the link above. We hope this clarifies your questions. Don’t hesitate to ask for further details :)

Regards,
Jesper Holm Olsen
Issuu

Q: Is the service is popular enough for core developers to have heard of it before? Is it “mainstream?”
Q: If similar services are already supported, how does this service compare in terms of size, features, and backing?

To answer both questions above: Issuu is a popular world wide online publishing platform where anybody can digitally publish their content in a beautiful format that’s easy to share. Started 6 years ago with the idea of making publishing easier and more accessible, Issuu has grown to over 1 million publishers, 16 million publications (20,000 upload daily!), and 80 million monthly unique visitors. Issuu is currently one of the top 50 websites in dozens of countries around the world.

In addition to being an invaluable tool for publishing and sharing (including embedding), Issuu is also a great place for readers to dive in and discover new content. Both Issuu.com and the embedded readers recommend new and interesting publications to readers to keep them engaged and entertained.

Embedding Issuu content on WordPress blogs is valuable to both publishers (who want to gain a larger audience) and to readers (who want to discover and share exciting new content).

Q: Does this service have a large following on Twitter, Facebook, or other social media? Is its Twitter account verified?
43K followers on our official Twitter profile: ​https://twitter.com/issuu
208K likes on our official Facebook page: ​https://www.facebook.com/issuu

Q: Is its oEmbed endpoint clearly established and properly documented? Sometimes, they are just a developer’s pet project that may not be supported.)

We are fully committed to supporting oEmbed! Wordpress is the first site we have integrated with, but we strongly believe that oEmbed is something we must support for any site that can use it to embed our content. The official developer documentation can be found here:
​http://developers.issuu.com/api/oembed.html

Q: Does the service make an effort to build relationships with developers, such as through robust APIs?
We have public APIs which are used by many users for integrating Issuu with their own systems. See our official developer API documentation here: ​http://developers.issuu.com/api/.

As another example, there are also a couple of 3rd party Wordpress plugins that use the API to provide more advanced features than the oEmbed functionality:
​http://wordpress.org/plugins/issuu-pdf-sync/
​http://wordpress.org/plugins/issuupress/

Q: How old is the service?
Issuu has been around for about 6 years and we count on being around for a long time! We are currently around 60 employees and have our main offices in Palo Alto, California.

Q: Does it have a well-established Wikipedia article? (Seriously.)

​http://en.wikipedia.org/wiki/Issuu

Q: Has anyone written a WordPress plugin that leverages the service in some way, whether adding it as an oEmbed provider, creating a shortcode, or leveraging other APIs of the service? Do these plugins have any noticeable adoption or traction that would indicate usage and demand?

There are several plugins offering Issuu support. With the oEmbed support some of these plugins would no longer be necessary to install, making it much easier for users to embed Issuu publications in their blogs.
​http://wordpress.org/plugins/issuu-pdf-sync/ (31770 downloads)
​http://wordpress.org/plugins/issuupress/ (6878 downloads)
​http://wordpress.org/plugins/wp-issuu/ (89455 downloads). This is currently our official plugin, but will be deprecated.
​http://wordpress.org/plugins/issuu-embed/ (15098 downloads). We have agreed with the maintainer to take this over and make it our official plugin as it has the correct name. All our plugin does now is to whitelist Issuu.com for oembed support, so we might even be able to deprecate this down the line.
​http://wordpress.org/plugins/issuupress/ (6878 downloads)
​http://wordpress.org/plugins/pronamic-issuu/ (613 downloads)

Our support team receives MANY requests asking for more integration between Issuu and WordPress, so we know there is a demand :)

[wonderboymusic]

To compare, we already support Viddler:

Twitter 2,381 followers to 43K for Issuu
Facebook 1,868 to 208K for Issuu

Issuu has the support of some of the most active contributors as seen above. It goes in.

[wonderboymusic]

In 28554:

Add Issuu to list of whitelisted oEmbed providers.

Props issuu.
Fixes #28312.

[iseulde]

A problem that popped up... Some URLs don't give a good oEmbed response. Notice the missing data-url tag.

​http://issuu.com/oembed?url=http%3A%2F%2Fissuu.com%2Fglasgowguardian%2Fdocs%2Fissue_6_guardian_online%2F1%3Fe%3D0&format=json vs. ​http://issuu.com/oembed?url=http%3A%2F%2Fissuu.com%2Fglasgowguardian%2Fdocs%2Fissue_6_guardian_online&format=json

I sent them an email about it.

[issuu]

We have released a fix to our oEmbed service. Thank you for noticing the problem and helping us to improve our product.