instagramplugin's Introduction

Instagram plugin for Cordova

Adds ability to share the content of a canvas element or a dataUrl encoded image using the Instagram application for iOS and Android.

Installing the plugin to your project

In your project directory:

cordova plugins add https://github.com/vstirbu/InstagramPlugin

Instagram plugin JavaScript API

Detect if the Instagram application is installed on the device. The function isInstalled accepts a callback function as parameter:

Instagram.isInstalled(function (err, installed) {
    if (installed) {
        console.log("Instagram is", installed); // installed app version on Android
    } else {
        console.log("Instagram is not installed");
    }
});

Share the content of a canvas element or a base64 dataURL image. The function share accepts a string, corresponding to the canvas element id or the dataURL, an optional caption, and a callback function as parameters:

Instagram.share(canvasIdOrDataUrl, caption, function (err) {
    if (err) {
        console.log("not shared");
    } else {
        console.log("shared");
    }
});

or:

Instagram.share(canvasIdOrDataUrl, function (err) {
    if (err) {
        console.log("not shared");
    } else {
        console.log("shared");
    }
});

A very basic application that uses the plugin can be found here.

Quirks:

Android

Passing caption in addition to sharing image requires Instagram Android application version 6.1.0 or higher.
Older versions of Android (2.x-3.x) do not have proper support for toDataURL on canvas elements. You can still get the canvas content as dataURL following these instructions. Pass the dataUrl instead of the canvas id to share.

iOS

Althought the plugin follows the instructions to show only Instagram in the document interaction controller, there are reports that other apps appear in the list.