Instafeed Particle

  • Tony
  • 18 April 2017
  • No comments
  • Docs
Display Instagram photos from any non-private Instagram accounts or special TAG. Add beautifully clean, customizable, and responsive Instagram feeds to your website. Super simple to set up and tons of customization options to seamlessly match the look and feel of your site. See how Instafeed can be designed beautifully on Demo Page.

# Instafeed Package contents

Files Description
jlinstafeed.yaml Contains the Instafeed particle settings.
jlinstafeed.html.twig The Twig file to pull information, settings.
instafeed.min.js Contains the Instafeed JavaScript library.

Installation Installing the particle on your website is a really simple process. You can refer to the document here to know more.

Requirements Instafeed requires Uikit 3 for Gantry 5 Atom to be installed and enabled in your theme layout settings.

Go to Template/Theme Settings > select the Layout to add Animated Text particle (i.e: Home) -> Layout tab -> Drag and drop the Instafeed Particle from Particles panel (left corner) to the section you want to display Instafeed.

Settings

Setting Description
Instagram Username Enter the Instagram username to fetch images from.
Access Token Required. The Instagram access token using Instagram Basic Display API
Items Number image items to show.
Instagram Layout Present the Instagram layout with Grid or Slider mode.
Column Gap Set the size of the gap between the grid/slider columns.
Dividers Display dividers between grid cells or slider columns.
Spinner Create an animated loading spinner while fetching images from Instagram.
Dividers Display dividers between grid cells or slider columns.
Grid Configuration Content layout for Instafeed
Enable Lightbox Create a responsive lightbox gallery with images.
Enable Masonry The masonry effect creates a layout free of gaps even if grid cells have different heights.
Parallax The parallax effect moves single grid columns at different speeds while scrolling.
Row Gap Set the size of the gap between the grid rows.
Match Height To match the height of the direct child of each cell.
Center columns Center the grid columns.
Center rows Center the grid rows content.
Grid Columns Common settings for Grid Columns Layout
Phone Portrait Set the number of grid columns for each breakpoint. Inherit refers to the number of columns on the next smaller screen size.
Phone Landscape
Tablet Landscape
Desktop
Large Screens
CSS Classes CSS class name for the particle.

Tab Slider

Layout All settings below for Instafeed Slider mode Layout only.

Settings Description
Item Width Mode Define whether the width of the slider items is fixed or automatically expanded by its content widths.

NOTE: The Height settings and Item Width columns are not working for the AUTO Item Width Mode.

Height The height will adapt automatically based on its content. Alternatively, the height can adapt to the height of the view port.

This option won’t have any effect unless FIXED Item Width Mode is selected.

Note: Make sure, no height is set in the section settings when using on of the viewport options.

Min Height Use an optional minimum height to prevent the slider from becoming smaller than its content on small devices.

This option won’t have any effect unless FIXED Item Width Mode and Viewport Height are selected.

Slider Columns Common settings for Columns – Set Item Width Mode to FIXED to use these settings.

Settings Description
Phone Portrait Set the item width for each breakpoint. Inherit refers to the item width of the next smaller screen size.
Phone Landscape
Tablet Landscape
Desktop
Large Screens

Slider Animation Common settings for Slider Animation.

Settings Description
Set Slide all visible items at once. Group items into sets. The number of items within a set depends on the defined item width, e.g. 33% means that each set contains 3 items.
Center Center the active slide.
Disable infinite Disable infinite scrolling between items.
Velocity Set the velocity in pixels per millisecond. Min 20, Max 300
Autoplay Enable autoplay for slider items.
Pause On Hover Pause autoplay on hover.
Interval Set the autoplay interval in seconds. Min 5 Max 15.

Navigation/Slidenav Common settings for Slider Navigation and Slidenav.

Settings Description
Navigation Select the navigation type.
Position Align the navigation’s items.
Margin Set the vertical margin.
Breakpoint Display the navigation only on this device width and larger.
Color Set light or dark color mode.
Show Tooltip Display Image ALT as tooltip when hovering.

Slidenav Common settings for Slidenav.

Settings Description
Position Select the position of the slidenav.
Show On Hover Show the slidenav on hover only.
Larger style To increase the size of the slidenav icons.
Margin Apply a margin between the slidenav and the slider container.
Breakpoint Display the slidenav only on this device width and larger.
Color Set light or dark color mode.
Outside Breakpoint Display the slidenav only outside on this device width and larger. Otherwise it will be displayed inside.
Outside Color Set light or dark color if the slidenav is outside of the slider.
Custom Slidenav Icons Custom previous/next icons (replace default Slidenav navigation)
Previous Icon An icon picker to choose custom Previous icon
Next Icon An icon picker to create choose custom Next icon
CSS Classes CSS class name for the particle.

Overlay Tab

Settings Description
Mode When using cover mode, you need to set the text color manually.
Overlay on hover Display content overlay on hover.
Animate background Animate background only on hover.
Style Select the style for the overlay.
Text Color Set light or dark color mode for text, buttons and controls (Cover mode)
Inverse text color Inverse the text color on hover.
Padding Set the padding between the overlay and its content.
Position Select the overlay or content position.
Margin Apply a margin between the overlay and the image container if the overlay style is Selected.
Max Width Set the maximum content width.
Overlay Transition Select a transition for the overlay when it appears on hover (support 15 transition effects).
Link overlay Link the whole overlay if a link exists.

Tab Style

Image Settings Common settings for images.

Settings Description
Image Border Select the image’s border style.
Box Shadow Select the image’s box shadow size.
Hover Box Shadow Select the image’s box shadow size on hover.
Image Transition Select an image transition. If the hover image is set, the transition takes place between the two images. If None is selected, the hover image fades in.
Width Enter the image’s width.
Height Enter the image’s height.

Content Settings Common settings for content.

Settings Description
Show Caption Show the Instagram Caption text on overlay hover mode.
Transition Select a transition for the content when the overlay appears on hover.
Style Select a predefined text style, including color, size and font-family.
Predefined Color Select the predefined meta color.
Content Color Customize the content color instead using predefined text color.
You need to set the predefined color to None to use the customize color option.
Font Size Customize the content text font size.
Transform The following options will transform text into uppercased, capitalized or lowercased characters.

Instagram access token

Screenshots Example:

To authorize Instafeed to fetch your media you’ll need to create a Facebook app, and add your Instagram user account as a test user:

The Instagram Basic Display API requires access tokens be refreshed at least every 60 days. You can’t create a token and paste it into your Instafeed option anymore – it will stop working when the token expires. Instafeed.js needs to be paired with a service which will keep your access token fresh. There are various ways to do this, depending on your skill level and environment. Learn more https://github.com/stevenschobert/instafeed.js/wiki/Managing-Access-Tokens

There’re two ways to keep your Instagram Basic Display API token fresh

  • – Using Instagram Token Agent, its FREE and require the Skill level
  • – Using 3rd service like Instant-Tokens.Com
  • General, Parallax and Parallax Background tab

    Please take a look the documentation here for more detail about these tabs settings

    Last updated Nov 06 2020

Comments

Leave a Reply

You must be logged in to post a comment.

Gantry5 particles 2.1.4 released, new features, bug fixes and more Changelog
HAPPY NEW YEAR - Save 40% Off Everything! Discount code: NEWYEAR2021 Shop Now