You are here

INSTALL.txt in Drupagram 6

Same filename and directory in other branches
  1. 7 INSTALL.txt
Dependencies
============

Make sure you download the oAuth module (http://dgo.to/oauth) and enable the 
oauth_common module.

This module comes with a couple of pre-made views so although it is not a 
dependency, it is a good idea to turn on the views and views_ui module.

The images are fetched on cron runs. Although you can manually trigger cron, in
order to maximize your experience with this app it is recommended that you setup
cron correctly.


Enabling the module
===================

Once you have taken care of the dependencies above, enable the drupagram module.
You should get a nice confirmation message with instructions on where to go to
fill out the variables required to connect to Tumblr API.

You will be presented with a link to admin/settings/services/instagram where you
will see a form. To enable OAuth based access for drupagram, you must register 
your application with Instagram and add the provided keys.

To register your app, click the "register your application" link or go to
http://instagr.am/developer/manage/ and follow their registration steps. Notice
that the callback URL MUST be http://YOUR-SITE-NAME/instagram/oauth

When you're done, copy the Instagram Client ID and Instagram Client Secret keys
over to the Drupal site and hit the Save configuration button.


How to add an Instagram account to a Drupal user account
========================================================

If all the steps above were successful you should now be able to go in and edit
any username and link an Instagr.am account to it.

If you are the site admin or a user with the "add instagram accounts" permission
you should be able to edit a user. Go to /user, notice you should be able to see
an Edit and an Instagram tab.

Click on the Edit tab and then choose the Instagram accounts sub tab.

Hit the Add account button. You will be taken to an Instagr.am authorization 
page. Enter your credentials and proceed to authorize the Drupal application.

You will then be redirected to the site and your Instagram profile information
should be listed. Hit the Save changes and you're done.

When cron runs, it will fetch any new pictures you have posted from the linked
account.

File

INSTALL.txt
View source
  1. Dependencies
  2. ============
  3. Make sure you download the oAuth module (http://dgo.to/oauth) and enable the
  4. oauth_common module.
  5. This module comes with a couple of pre-made views so although it is not a
  6. dependency, it is a good idea to turn on the views and views_ui module.
  7. The images are fetched on cron runs. Although you can manually trigger cron, in
  8. order to maximize your experience with this app it is recommended that you setup
  9. cron correctly.
  10. Enabling the module
  11. ===================
  12. Once you have taken care of the dependencies above, enable the drupagram module.
  13. You should get a nice confirmation message with instructions on where to go to
  14. fill out the variables required to connect to Tumblr API.
  15. You will be presented with a link to admin/settings/services/instagram where you
  16. will see a form. To enable OAuth based access for drupagram, you must register
  17. your application with Instagram and add the provided keys.
  18. To register your app, click the "register your application" link or go to
  19. http://instagr.am/developer/manage/ and follow their registration steps. Notice
  20. that the callback URL MUST be http://YOUR-SITE-NAME/instagram/oauth
  21. When you're done, copy the Instagram Client ID and Instagram Client Secret keys
  22. over to the Drupal site and hit the Save configuration button.
  23. How to add an Instagram account to a Drupal user account
  24. ========================================================
  25. If all the steps above were successful you should now be able to go in and edit
  26. any username and link an Instagr.am account to it.
  27. If you are the site admin or a user with the "add instagram accounts" permission
  28. you should be able to edit a user. Go to /user, notice you should be able to see
  29. an Edit and an Instagram tab.
  30. Click on the Edit tab and then choose the Instagram accounts sub tab.
  31. Hit the Add account button. You will be taken to an Instagr.am authorization
  32. page. Enter your credentials and proceed to authorize the Drupal application.
  33. You will then be redirected to the site and your Instagram profile information
  34. should be listed. Hit the Save changes and you're done.
  35. When cron runs, it will fetch any new pictures you have posted from the linked
  36. account.