{"id":47081,"date":"2015-05-10T16:47:55","date_gmt":"2015-05-10T16:47:55","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/sourceafrica\/"},"modified":"2015-05-29T09:40:06","modified_gmt":"2015-05-29T09:40:06","slug":"sourceafrica","status":"closed","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/sourceafrica\/","author":9196695,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"0.1.3","stable_tag":"trunk","tested":"4.2.39","requires":"3.2","requires_php":"","requires_plugins":"","header_name":"sourceAFRICA","header_author":"","header_description":"","assets_banners_color":"","last_updated":"2015-05-29 09:40:06","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/sourceafrica.net\/","header_author_uri":"","rating":0,"author_block_rating":0,"active_installs":0,"downloads":492,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","changelog"],"tags":[],"upgrade_notice":{"0.1":"<p>Nada<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":0},"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.1.2","0.1.3"],"block_files":[],"assets_screenshots":[],"screenshots":[],"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[24407,9054,8868,3652,6319],"plugin_category":[],"plugin_contributors":[],"plugin_business_model":[],"class_list":["post-47081","plugin","type-plugin","status-closed","hentry","plugin_tags-documentcloud","plugin_tags-documents","plugin_tags-journalism","plugin_tags-reporting","plugin_tags-research","plugin_committers-davidlemayian"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/sourceafrica.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"<!--section=description-->\n<p><a href=\"https:\/\/sourceafrica.net\/\">sourceAFRICA<\/a> is a service provided by <a href=\"http:\/\/investigativecenters.org\">African Network of Centers for Investigative Reporting<\/a> that allows journalists to analyze, annotate, and publish documents, hosted by <a href=\"http:\/\/www.codeforafrica.org\">Code for Africa<\/a>. Initial development of this plugin supported by <a href=\"http:\/\/www.npr.org\">NPR<\/a> as part of <a href=\"http:\/\/stateimpact.npr.org\">StateImpact<\/a> project and continues to be supported by <a href=\"https:\/\/www.documentcloud.org\">DocumentCloud<\/a>.<\/p>\n <p>This plugin allows you to embed sourceAFRICA resources using either the raw URL on its own line:<\/p>\n <pre><code>Here's something you should really take a look at:  https:\/\/sourceafrica.net\/documents\/19789-everest.html  Isn't that interesting? <\/code><\/pre>\n <p>Or a custom shortcode:<\/p>\n <pre><code>[sourceafrica url=\"https:\/\/sourceafrica.net\/documents\/19789-everest.html\"] <\/code><\/pre>\n <p>When you save, WordPress fetches and stores the actual embed code HTML from the sourceAFRICA servers using oEmbed. You can freely toggle between visual and HTML mode without mangling embed code, and your embed will always be up to date with the latest embed code.<\/p>\n <p>By default, documents will have a responsive width (it will narrow and widen as necessary to fill available content area) and use the theme's default height. If you want to override this, you can either set <code>responsive=\"false\"<\/code> or explicitly set a <code>width<\/code>:<\/p>\n <pre><code>[sourceafrica url=\"https:\/\/sourceafrica.net\/documents\/19789-everest.html\" width=\"600\"] <\/code><\/pre>\n <p>You can set your own defaults in Settings &gt; DocumentCloud, but default widths will be ignored unless <code>responsive<\/code> is disabled:<\/p>\n <pre><code>[documentcloud url=\"https:\/\/sourceafrica.net\/documents\/19789-everest.html\" responsive=\"false\"] <\/code><\/pre>\n <p>To embed a note, just use any note-specific URL. Notes ignore <code>width\/height<\/code> and always act responsively:<\/p>\n <pre><code>[documentcloud url=\"https:\/\/sourceafrica.net\/documents\/19789-everest.html#document\/p1\/a143\"] <\/code><\/pre>\n <p>Here's the full list of embed options you can pass via shortcode attributes; some are specific to the type of resource you're embedding.<\/p>\n <p><strong>All resources (documents and notes):<\/strong><\/p>\n <ul>\n<li><code>url<\/code> (<strong>required<\/strong>, string): Full URL of the sourceAFRICA resource.<\/li>\n<li><code>container<\/code> (string): ID of element to insert the embed into; if excluded, embedder will create its own container.<\/li>\n<\/ul>\n <p><strong>Documents only:<\/strong><\/p>\n <ul>\n<li><code>height<\/code> (integer): Height (in pixels) of the embed.<\/li>\n<li><code>width<\/code> (integer): Width (in pixels) of the embed. If used, will implicitly set <code>responsive=\"false\"<\/code>.<\/li>\n<li><code>responsive<\/code> (boolean): Use responsive layout, which dynamically adjusts width to fill content area. Defaults <code>true<\/code>.<\/li>\n<li><code>responsive_offset<\/code> (integer): Distance (in pixels) to vertically offset the viewer for some responsive embeds.<\/li>\n<li><code>default_page<\/code> (integer): Page number to have the document scroll to by default.<\/li>\n<li><code>default_note<\/code> (integer): ID of the note that the document should highlight by default.<\/li>\n<li><code>notes<\/code> (boolean): Show\/hide notes:<\/li>\n<li><code>search<\/code> (boolean): Hide or show search form.<\/li>\n<li><code>sidebar<\/code> (boolean): Hide or show sidebar. Defaults <code>false<\/code>.<\/li>\n<li><code>pdf<\/code> (boolean): Hide or show link to download original PDF. Defaults <code>true<\/code>.<\/li>\n<li><code>text<\/code> (boolean): Hide or show text tab. Defaults <code>true<\/code>.<\/li>\n<li><code>zoom<\/code> (boolean): Hide or show zoom slider.<\/li>\n<li><code>format<\/code> (string): Indicate to the theme that this is a wide asset by setting this to <code>wide<\/code>. Defaults <code>normal<\/code>.<\/li>\n<\/ul>\n <p>You can read more about publishing and embedding sourceAFRICA resources on https:\/\/sourceafrica.net\/help\/publishing.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the contents of the plugin to <code>wp-content\/plugins\/documentcloud<\/code><\/li>\n<li>Activate the plugin through the \"Plugins\" menu<\/li>\n<li>In your posts, embed documents or notes using the sourceAFRICA button or the <code>[sourceAFRICA]<\/code> shortcode<\/li>\n<li>Optional: Set a default width\/height for all sourceAFRICA embeds (which can be overridden on a per-embed basis with the <code>height\/width<\/code> attributes) at Settings &gt; sourceAFRICA. (This default width will only be used if you set <code>responsive=\"false\"<\/code> on an embed.)<\/li>\n<\/ol>\n <p><strong>Using with DocumentCloud Plugin:<\/strong> If you're currently using the DocumentCloud's plugin (from which this plugin was built), you'll NOT need to deactivate or delete it before installing this plugin.<\/p>\n\n<!--section=changelog-->\n<h4>0.1.3<\/h4>\n <ul>\n<li>Fixed some more readme URLs.<\/li>\n<\/ul>\n <h4>0.1.2<\/h4>\n <ul>\n<li>Fixed Readme URLs.<\/li>\n<\/ul>\n <h4>0.1.1<\/h4>\n <ul>\n<li>Fixed TinyMCE url issues.<\/li>\n<\/ul>\n <h4>0.1<\/h4>\n <ul>\n<li>Initial release. v0.3.1 of DocumentCloud's Plugin.<\/li>\n<\/ul>","raw_excerpt":"Embed sourceAFRICA resources in WordPress content.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/47081","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=47081"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/davidlemayian"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=47081"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=47081"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=47081"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=47081"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=47081"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=47081"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}