Awesome
🎁 WebComponent: Patreon Box
My Patreon Tier Box with avatars and link from rest/json api.
⛔ DISCLAIMER: This is an unofficial patreon library and offers no warranty! All trademarks and logos belong to their respective owners.
🎁 Support: Donate
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!
📎 Menu
- 💡 Features
- 🕹 Demo
- 👔 Screenshot
- 🚀 How to use
-
- 🌎 Web
-
- ⚛️ React
-
- 🅰️ Angular
- 🧰 Options / Attributes
- 📚 Documentation
- 👨💻 Contributing
- 🐛 Known Bugs
- 🍻 Community:
- <img src="https://raw.githubusercontent.com/ptkdev-components/webcomponent-patreon-box/master/.github/assets/social_discord.png" height="18px"> Discord (🇬🇧 English Channel | 🇮🇹 Italian Channel | 🇵🇱 Polish Channel)
💡 Features
- [✔️] Easy to use
- [✔️] MIT License
- [✔️] Without jQuery depencence
- [✔️] Configurable with attributes
- [✔️] Work with: Browserify / Webpack / ReactJS / Angular / Wordpress
- [✔️] My Patreon Tier Box with avatars and link from rest/json api.
- [✔️] Translations: 🇬🇧 🇮🇹 🇵🇱 (Help me ❤️)
👔 Screenshot
See Demo here. Photos from ptkdev's patreon rest api:
🚀 Installation (Web)
- Add html code to your page (and replace
api
with your endpoint):
<patreon-box api="https://api.ptkdev.io/backers/" image-width="80px" image-height="80px"></patreon-box>
- Require javascript in yourpage (before
</body>
):
<script src="https://cdn.jsdelivr.net/npm/@ptkdev/webcomponent-patreon-box@latest/dist/lib/en/patreon-box.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.
📦 Installation (NPM Module - Browserify/Webpack)
- Install npm module:
npm install @ptkdev/webcomponent-patreon-box --save
- Add html code to your page (and replace
api
with your endpoint):
<patreon-box api="https://api.ptkdev.io/backers/" image-width="80px" image-height="80px"></patreon-box>
- Require javascript in your app:
require("@ptkdev/webcomponent-patreon-box");
or
import '@ptkdev/webcomponent-patreon-box';
See folder examples
, run with npm run example
. Below is available a description of options
values and all logger methods.
📖 Installation (Wordpress)
- Download wordpress-plugin and install it.
- Add code to your html widget, example:
Appearance
-->Widget
--> insertHTML Widget
and paste html code (and replaceapi
with your endpoint):
<patreon-box api="https://api.ptkdev.io/backers/" image-width="80px" image-height="80px"></patreon-box>
You can insert this html code in posts, widget, html box or theme. Where you want see patreon photos box.
⚛️ Installation (React)
- Install npm module with
npm install @ptkdev/webcomponent-patreon-box@latest --save
: - Import module in your
src/App.js
on header:
import '@ptkdev/webcomponent-patreon-box';
- Add html code to your
App.js
template (and replaceapi
with your endpoint):
<patreon-box api="https://api.ptkdev.io/backers/" image-width="80px" image-height="80px"></patreon-box>
Below is available a description of options
values and all logger methods.
🅰️ Installation (Angular)
- Install npm module with
npm install @ptkdev/webcomponent-patreon-box@latest --save
: - Import module in your
app/app.modules.ts
on header:
import '@ptkdev/webcomponent-patreon-box';
- Add html code to your html component (and replace
api
with your endpoint):
<patreon-box api="https://api.ptkdev.io/backers/" image-width="80px" image-height="80px"></patreon-box>
Below is available a description of options
values and all logger methods.
🧰 Options / Attributes
Parameter | Description | Values | Default value | Available since |
---|---|---|---|---|
api | REST Api url | URI / URL of endpoint | https://api.ptkdev.io/backers/ | v1.0.0 |
items-limit | Set the max number of pictures | number: from 0 to 100 | 100 | v1.0.0 |
grid | Set grid aspect ratio | 1x1 , 2x2 , 3x3 , etc... or responsive | responsive | v1.0.0 |
image-width | Set width of images (NOTE: grid different than responsive overwrite this value) | length units: 100% , 100px , 100pt | 100% | v1.0.0 |
image-height | Set height of images | length units: 100% , 100px , 100 | 100% | v1.0.0 |
border-spacing | Set spacing around images | length units: 5% , 5px , 5pt | 2px | v1.0.0 |
border-corners | Set border radius of corners: 0 : square / 15 : rounded / 100 : circle | number: from 0 to 100 | 5 | v1.0.0 |
force-square | Force square aspect ratio if you post photos with different size on your patreon | yes / no | yes | v1.0.0 |
cache | Enable/disable cache | enabled / disabled | enabled | v1.0.0 |
HTML Code with attributes:
<patreon-box api="https://api.ptkdev.io/backers/" image-width="80px" image-height="80px" force-square="yes" items-limit="9" image-width="100%" image-height="100%" border-corners="5" border-spacing="2px" />
🔨 Developer Mode
- 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
📚 Documentation
Run npm run docs
👑 Sponsors
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.
🦄 Backers
Thank you to all our backers! 🙏 Become a backer on patreon.
👨💻 Contributing
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):
<!-- ALL-CONTRIBUTORS-LIST:START --> <!-- prettier-ignore-start --> <!-- markdownlint-disable --> <table> <tr> <td align="center"><a href="https://ptk.dev"><img src="https://avatars1.githubusercontent.com/u/442844?v=4" width="100px;" alt=""/><br /><sub><b>Patryk Rzucidło</b></sub></a><br /><a href="https://github.com/ptkdev/ptkdev-components/webcomponent-patreon-box/commits?author=ptkdev" title="Code">💻</a> <a href="#translation-ptkdev" title="Translation">🌍</a> <a href="https://github.com/ptkdev/ptkdev-components/webcomponent-patreon-box/commits?author=ptkdev" title="Documentation">📖</a> <a href="https://github.com/ptkdev/ptkdev-components/webcomponent-patreon-box/issues?q=author%3Aptkdev" title="Bug reports">🐛</a></td> <td align="center"><img src="https://avatars1.githubusercontent.com/u/26500344?v=4" width="100px;" alt=""/><br /><sub><b>Emanuele Fricano</b></sub><br /><a href="https://github.com/ptkdev/ptkdev-components/webcomponent-patreon-box/commits?author=emanuelefricano93" title="Code">💻</a> <a href="https://github.com/ptkdev/ptkdev-components/webcomponent-patreon-box/issues?q=author%3Aemanuelefricano93" title="Bug reports">🐛</a></td> <td align="center"><img src="https://avatars1.githubusercontent.com/u/1906677?v=4" width="100px;" alt=""/><br /><sub><b>Dominik Lubański</b></sub><br /><a href="https://github.com/ptkdev/ptkdev-components/webcomponent-patreon-box/issues?q=author%3Asmalluban" title="Bug reports">🐛</a></td> </tr> </table> <!-- markdownlint-enable --> <!-- prettier-ignore-end --> <!-- ALL-CONTRIBUTORS-LIST:END -->💰 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!
📲 Tools
🐍 Sorry for snake_case
I love snake_case syntax sorry for this 😭 don't hate me.
💫 License
- 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