<docbook><section><title>VirtCartInstagramOAuth</title><title>Instagram Cartridge - Configuration Guidelines</title>Instagram Cartridge - Configuration Guidelines
<bridgehead class="http://www.w3.org/1999/xhtml:h2"> Register an application endpoint</bridgehead>
<para>Use Instagram&#39;s developer interface to register a <ulink url="http://instagram.com/developer/clients/manage/">new client endpoint</ulink>.</para>
<para>The settings required for this are:</para>
<itemizedlist mark="bullet" spacing="compact"><listitem>Application Name: whatever you like (&quot;my Sponger instance&quot;) </listitem>
<listitem>Description: optional, free-form </listitem>
<listitem>Website: set this to the base of your Virtuoso installation, e.g.
 <ulink url="http://localhost:8890/">http://localhost:8890/</ulink> </listitem>
<listitem>OAuth redirect_uri: adjusting localhost and port number to your installation, put <ulink url="http://localhost:8890/sponger/instagram_oauth">http://localhost:8890/sponger/instagram_oauth</ulink>  in here (note no trailing slash)</listitem>
</itemizedlist><para>Once the client is created, it should give you a paragraph of its options including a client <emphasis>id and a client_secret.</emphasis></para>
<figure><graphic fileref="VirtCartInstagramOAuth/instagram-client-editing.png" /></figure><bridgehead class="http://www.w3.org/1999/xhtml:h2">Cartridge Options</bridgehead>
<para>In the Virtuoso Conductor (eg <ulink url="http://localhost:8890/conductor),">http://localhost:8890/conductor),</ulink> select the menu item Linked Data -&gt; Sponger -&gt; Extractor Cartridges.</para>
<para>In the list of cartridges, ensure `Instagr.am Photos&#39; is enabled (hit `Apply&#39; at the bottom if need be), then click on the name &quot;Instagr.am Photos&quot; to show its options:</para>
<figure><graphic fileref="VirtCartInstagramOAuth/instagram-cartridge-options.png" /></figure><para>The API Key should be the Client_ID parameter from Instagram.</para>
<para>The client_secret option is currently unused, but may be set against future updates.</para>
<para>The oauth-fallback cartridge option is a default username to use for authenticated requests.
 Currently, this is only used in order to list a user&#39;s media; if an access token for the user being sponged is not found, this will be used in its place - so you get a view from this user&#39;s perspective.</para>
<bridgehead class="http://www.w3.org/1999/xhtml:h2">View the Retrieved data</bridgehead>
<para>The cartridge will trigger on URLs matching either ^https?://(www.)?instagr.am/.* or ^https?://(www.)?instagram.com/.*; this caters for both old and new (after July-2012) patterns.
</para>
</section></docbook>