{"id":24600951,"url":"https://github.com/benbarber/jekyll-instagram","last_synced_at":"2025-04-30T21:40:00.030Z","repository":{"id":28742251,"uuid":"32263774","full_name":"benbarber/jekyll-instagram","owner":"benbarber","description":"A Jekyll plugin for displaying your recent Instagram photos","archived":false,"fork":false,"pushed_at":"2024-05-16T20:09:05.000Z","size":47,"stargazers_count":29,"open_issues_count":2,"forks_count":4,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-12-06T21:19:48.935Z","etag":null,"topics":["instagram","instagram-api","instagram-feed","instagram-photos","jekyll","jekyll-instagram","jekyll-plugin","ruby"],"latest_commit_sha":null,"homepage":"https://benbarber.github.io/jekyll-instagram/","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/benbarber.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-03-15T14:11:40.000Z","updated_at":"2024-03-08T15:25:07.000Z","dependencies_parsed_at":"2023-01-14T09:28:28.000Z","dependency_job_id":null,"html_url":"https://github.com/benbarber/jekyll-instagram","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benbarber%2Fjekyll-instagram","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benbarber%2Fjekyll-instagram/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benbarber%2Fjekyll-instagram/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benbarber%2Fjekyll-instagram/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/benbarber","download_url":"https://codeload.github.com/benbarber/jekyll-instagram/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235448949,"owners_count":18991977,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["instagram","instagram-api","instagram-feed","instagram-photos","jekyll","jekyll-instagram","jekyll-plugin","ruby"],"created_at":"2025-01-24T14:19:38.942Z","updated_at":"2025-01-24T14:19:40.225Z","avatar_url":"https://github.com/benbarber.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Jekyll-Instagram Plugin\n\nJekyl-Instagram is a Jekyll plugin for displaying a feed of your recent Instagram photos.\n\n**Live demo available at: https://benbarber.github.io/jekyll-instagram/**\n\n\n### Installation and Setup\n\nTo install this plugin into your project you will need to copy `_plugins/jekyllgram.rb` into the `_plugins` directory\nin your Jekyll project.\n\nThen for the plugin to be able to communicate with Instagram you will need to register an application with the Instagram Basic Display API and then make your access token available as an environment variable on your dev/build machine named `JEKYLLGRAM_TOKEN`.\n\nThere is an easy step by step guide for getting your Instagram access token available [here](https://essential-addons.com/elementor/how-to-get-instagram-access-token/).\n\nYour instagram account will need to be public for this to work correctly. To avoid making your main account public you can create a separate Instagram account just for your public feed and use that account.\n\n\n### Working Example\n\nThere is a working example of a basic Jekyll site using this plugin that is available in the `example` directory of this repo.\n\n\n### Displaying the results in your templates\n\nTo display the feed of your recent Instagram photos you will need to insert the liquid template tag below into one of the pages of your Jekyll site. You can replace the 6 below with the number of photos from Instagram that you wish to display.\n\n```liquid\n{% jekyllgram 6 %}\n  \u003ca href=\"{{ photo.permalink }}\" title=\"{{ photo.caption }}\" id=\"IG-{{ photo.id }}\"\u003e\n    \u003cimg src=\"{{ photo.media_url }}\" title=\"{{ photo.caption }}\" width=\"250\" height=\"250\" /\u003e\n  \u003c/a\u003e\n{% endjekyllgram %}\n```\n\n### Notes\n\nIf publishing to GitHub pages and you get a \"jekyllgram - Liquid tag not found\" build error you will need to use a custom GitHub actions workflow for deployment. The reason for this is that the default GitHub pages deployment doesnt allow for 3rd party Jekyll plugins unless they have been whitelisted by GitHub.\n\nYou can find more information [here](https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll/about-github-pages-and-jekyll#plugins) and view the full whitelist of plugins [here](https://pages.github.com/versions/).\n\nYou can find a working example of a custom GitHub actions workflow that publishes with this plugin at `.github/workflows/pages.yml`. This is used to publish the demo site which is available at https://benbarber.github.io/jekyll-instagram/\n\n\n### Contributors\n\n- [Zachary Wright](https://github.com/zachwright)\n- [Jason](https://github.com/jschee)\n\n### Changelog\n\n- (v1.0.0) Initial release\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbenbarber%2Fjekyll-instagram","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbenbarber%2Fjekyll-instagram","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbenbarber%2Fjekyll-instagram/lists"}