Simple Instagram Widget: Photos Box of your Instagram Profile for your blog or website with this WebComponent.
โ DISCLAIMER: This is an unofficial instagram library and offers no warranty! All trademarks and logos belong to their respective owners.
This project is free, open source and I try to provide excellent free support. Why donate? I work on this project several hours in my spare time and try to keep it up to date and working. THANK YOU!
- ๐ก Features
- ๐น Demo
- ๐ Screenshot
- ๐ How to use
-
- ๐ Web
-
- ๐ฆ Webpack/Browserify
-
- ๐ Wordpress
-
- โ๏ธ React
-
๐ ฐ๏ธ Angular
- ๐งฐ Options / Attributes
- ๐ Documentation
- ๐จโ๐ป Contributing
- ๐ Known Bugs
- ๐ป Community:
- [โ๏ธ] Easy to use
- [โ๏ธ] MIT License
- [โ๏ธ] Work with: Browserify / Webpack / ReactJS / Angular / Wordpress
- [โ๏ธ] Photos Widget of your Instagram Profile for your blog or website with this WebComponent
- [โ๏ธ] Translations: ๐ฌ๐ง ๐ฎ๐น ๐ต๐ฑ (Help me โค๏ธ)
See Demo here. Photos from @ptkdev account:
- Add html code to your page (and replace
@ptkdev
with your instagram username):
<instagram-widget username="@ptkdev" />
- Require javascript in yourpage (before
</body>
):
<script src="https://cdn.jsdelivr.net/npm/@ptkdev/webcomponent-instagram-widget@latest/dist/lib/en/instagram-widget.min.js"></script>
You can replace en
in jsdelivr cdn with it
or pl
and load different languages or replace @latest
with specific version, example @2.0.1
.
See folder examples
, run with npm run example
. Below is available a description of options
values and all logger methods.
- Install npm module:
npm install @ptkdev/webcomponent-instagram-widget --save
- Add html code to your page (and replace
@ptkdev
with your instagram username):
<instagram-widget username="@ptkdev" />
- Require javascript in your app:
require("@ptkdev/webcomponent-instagram-widget");
or
import '@ptkdev/webcomponent-instagram-widget';
See folder examples
, run with npm run example
. Below is available a description of options
values and all logger methods.
- Add html code to your widget / post / html box in your theme (and replace
@ptkdev
with your instagram username):
<instagram-widget username="@ptkdev" />
- Go to
Appearance
-->Editor
--> Editfooter.php
--> Add code to end of file before</body>
if exist:
<script src="https://cdn.jsdelivr.net/npm/@ptkdev/webcomponent-instagram-widget@latest/dist/lib/en/instagram-widget.min.js"></script>
You can replace en
in jsdelivr cdn with it
or pl
and load different languages or replace @latest
with specific version, example @2.0.1
.
See folder examples
, run with npm run example
. Below is available a description of options
values and all logger methods.
- Install npm module with
npm install @ptkdev/webcomponent-instagram-widget@latest --save
: - Import module in your
src/App.js
on header:
import '@ptkdev/webcomponent-instagram-widget';
- Add html code to your
App.js
template (and replace@ptkdev
with your instagram username):
<instagram-widget username="@ptkdev" />
Go to examples/reactjs
and run npm run start
in folder for more info. Below is available a description of options
values and all logger methods.
- Install npm module with
npm install @ptkdev/webcomponent-instagram-widget@latest --save
: - Import module in your
app/app.modules.ts
on header:
import '@ptkdev/webcomponent-instagram-widget';
- Add html code to your html component (and replace
@ptkdev
with your instagram username):
<instagram-widget username="@ptkdev" />
Demo: https://webcomponents-60bc6.firebaseapp.com/instagram-widget
Go to examples/angular
and run yarn install
then yarn start
in folder for more info. Below is available a description of options
values and all logger methods.
Parameter | Description | Values | Default value | Available since |
---|---|---|---|---|
username | Set your instagram username | Your instagram username with or without @ | @ptkdev |
v1.0.0 |
items-limit | Set the max number of pictures | number: from 0 to 12 |
9 |
v1.1.0 |
grid | Set grid aspect ratio | 1x1 , 2x2 , 3x3 , etc... or responsive |
responsive |
v1.1.0 |
image-width | Set width of images (NOTE: grid different than responsive overwrite this value) |
length units: 100% , 100px , 100pt |
100% |
v1.1.0 |
image-height | Set height of images | length units: 100% , 100px , 100 |
100% |
v1.1.0 |
border-spacing | Set spacing around images | length units: 5% , 5px , 5pt |
2px |
v2.1.0 |
border-corners | Set border radius of corners: 0: square / 15: rounded / 100: circle | number: from 0 to 100 |
5 |
v2.1.0 |
cache | Enable/disable cache | enabled / disabled |
enabled |
v2.1.0 |
- Download nightly, beta or stable.
- Remove
.tpl
suffix fromconfig.js.tpl
file inconfigs
folder and fill it properly. - Run
npm install
- Run
npm run dev
Run npm run docs
Support this project by becoming a sponsor. ๐ Become a sponsor on patreon or become top3 sponsor on ko-fi. Your logo will show up here with a link to your website.
Thank you to all our backers! ๐ Become a backer on patreon.
I โค๏ธ contributions! I will happily accept your pull request! Translations, grammatical corrections (GrammarNazi you are welcome! Yes my English is bad, sorry), etc... Do not be afraid, if the code is not perfect we will work together ๐ฏ and remember to insert your name in .all-contributorsrc
and package.json
file.
Thanks goes to these wonderful people (emoji key):
Patryk Rzucidลo ๐ป ๐ ๐ ๐ |
Emanuele Fricano ๐ป ๐ |
๐ฐ In the future, if the donations allow it, I would like to share some of the success with those who helped me the most. For me open source is share of code, share development knowledges and share donations!
I love snake_case syntax sorry for this ๐ญ don't hate me.
- Code and Contributions have MIT License
- Images and logos have CC BY-NC 4.0 License (Freepik Premium License)
- Documentations and Translations have CC BY 4.0 License