Skip to content

A Liferay widget that shows the last media uploaded to an Instagram account using the Instagram Basic Display API. Made with the Liferay js toolkit. First approach to React!

License

Notifications You must be signed in to change notification settings

cmgdragon/liferay-instagram-basic-display

Repository files navigation

Liferay Instagram Basic Display

A Liferay React widget that shows the last media uploaded to an Instagram account using the Instagram Basic Display API. Made with the Liferay js toolkit.

Requeriments

  • A Liferay 7.2 or 7.3 instance.
  • Access to the Instagram Basic Display API. You will need a token and an Instragram user ID. Follow the documentation, or use a third-party library.
  • Slick carousel loaded in your theme/page.
  • JQuery included in your theme/page (only for 7.3+, that it is not included by default anymore)

you could also include the last two assets directly using the web context path of you application /o/[web-context]/[resource], but it is not implemented here.

Installation

  1. Download the .jar located in ./dist, or clone this repo and run npm install & npm run build.
  2. Copy the .jar file into the ${liferayHome}/deploy folder of your Liferay instance.
  3. Add the portlet into your page. It will be in the Sample category unless you change it.
  4. Configure the portlet
    1. Add you token and user id mentioned before.

you may want to generate a long-lived token that you can use for 60 days and refresh it anytime

  1. Save it.
  2. You are done!

System settings

You can add the id and token in the system settings and those will be used by default if you do not specify any in the portlet configuration

Portlet settings

  • User ID - ID of your app Instagram user
  • Access Token - Token for your Instagram Basic Display app
  • Images Width
  • Images Height
  • Slides to show - Maximum number of slides to show per row
  • Captions - Show/Hide feed captions
  • Rows
  • Font Size - Size of the captions
  • Debounce responsive - Lapsus in seconds in which the component can resize its with again

Responsive behavior

The carousel should automatically adapt to the width of the layout where it is placed, and also resize when the screen changes its width. No responsive configuration needed.

ssajsa

About

A Liferay widget that shows the last media uploaded to an Instagram account using the Instagram Basic Display API. Made with the Liferay js toolkit. First approach to React!

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published