Coder Social home page Coder Social logo

banano-donate's Introduction

Welcome to BananoDonate 0.0.2

GitHub top language GitHub code size in bytes GitHub Discord

What is it?

Banano Donate is a Chrome Browser Extension (also works on all Chromium-based browsers, e.g. Brave browser) which allows you to easily make Banano currency donations to participating websites. The website owner specifies the Banano donation address beforehand so you can just concentrate on making the donation. It is will be available for download in all regions, and in 18 different languages covering 20 locales (locale identifiers in brackets):

  • Arabic (ar)
  • Danish (da)
  • German (de)
  • Greek (el)
  • English - default (en)
  • Spanish (es)
  • Latin Amrican Spanish (es_419)
  • Persian (fa)
  • French (fr)
  • Hindi (hi)
  • Bahasa Indonesia (id)
  • Italian (it)
  • Japanese (ja)
  • Dutch (nl)
  • Norwegian (no)
  • Brazilian Portuguese (pt_BR)
  • Portuguese (pt_PT)
  • Russian (ru)
  • Turkish (tr)
  • Chinese - Mandarin (zh_CN)

How to install?

The extension can be downloaded in the Google Chrome Webstore by following this link The extension has been submitted to the Google Chrome Webstore for review and publication. Until it is listed, you can manually install and test the latest build as explained in the following section.

Want to test the latest Development build?

Step 1 Download from github

Download the latest dev build from tags in github (Download ZIP)

Step 2 Enable Developer Mode in Chrome

Go to chrome extensions or for Brave Browser. Turn on the Developer Mode in the top left corner of the Extensions page in Chrome.

Step 3 Unzip the downloaded release package

Unzip to a folder on your HDD. This folder will be the main folder you select in step 4.

Step 4 Load the extension into Chrome

You can now select the extension. That's pretty easy, you go to load unpackaged, select the /dist/ folder from your unzipped release and that´s it!

How do I use it to make a donation?

You will now see the BananoDonate icon in the upper right corner of Chrome, next to the address bar. If the site you are visiting is already enabled to receive donations through BananoDonate, the icon will be colored. Click on it and you will see the extension window pop up, asking you to enter the amount of BAN you´d like to donate.

Once you have entered the desired donation amount, click the "Create QR-Code" button. You will see a QR-code which you can scan using Kalium to send your donation.

Alternatively, you can copy the donation address and send your donation manually. This option will be further simplified in the next version.

If you are visiting is not yet enabled to receive donations through BananoDonate, the icon will appear greyscaled. When you click it though, you will see instructions how to make that happen. (It links to this readme.)

How can I receive donations through BananoDonate?

If you are a website owner and want to enable your site to receive donations through BananoDonate there are just 3 sinple steps to be completed. This may be best done by your website administrator unless you are managing your website yourself and have a basic understanding of HTML.

1. Insert HTML meta tag into you main page´s header

The HTML meta tag below lets your users´ BananoDonate extension know where donations will be sent. It need to be placed in the header section of your main landing page, typically index.html.

If you do not have a banano wallet yet, go here to find out how to get one. Please replace the contents of the content property with the banano address you want to receive the donations.

 <meta name="banano"  content="ban_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"/>

2. Let your users know that they can donate to your site using BananoDonate

The extension can be downloaded in the Coogle Chrome Webstore by following this link

3. Put the BananoDonate logo on your page (optional)

You can give your visitors a hint that your site is enabled for BananoDonate by placing the following code on your page:

<!-- Start Banano-donate logo -->
<a href="https://github.com/sebrock/banano-donate" target="_blank">
<img border="0" src ="https://github.com/sebrock/banano-donate/blob/banano-dev/dist/images/ban-don-logo.png" 
     title="This site can receive donations via Banano-donate"  alt="This site can receive donations via Banano-donate" 
     height="70"</img> </a>
<!-- End Banano-donate logo -->

The following image will be displayed:

You can change the size by editing height or adding a width property.

How should I approach a website owner if I want them to enable them to receive donations via BananoDonate?

If you are not the owner but still want to donate Banano try sending a kind email along with this link to the website's owner through their contact page. You could use the following email template as a starting point:

Hi [SITE_OWNER],

I love your website and was hoping to donate some Banano digital currency to you. 
However I noticed your website is not enabled for BananoDonate. 
It's very easy to get enabled and you can learn how to do so at the 
following link (no sign-up required): 
https://github.com/sebrock/banano-donate/tree/banano-dev#how-can-i-receive-donations-through-bananodonate

Thanks!
[YOUR_NAME]

Sites enabled for Banano-Donate

The following sites are enabled to receive donations through banano-donate:

License

GNU GPLv3

Credits

Our sincere thanks go to everyone in the BANANO community who contributed and supported in the making of this. BAN fam - best fam! 💛

Translation and Proofreading

  • AhmedDhaif93 for Arabic
  • Goose for Chinese
  • Kryptopia for Danish
  • ATH for Dutch
  • Liberty_Seed and iazid for French
  • sebrock for German
  • Skittish for Hindi
  • Pramono for Bahasa Indonesia
  • macaleon for Italian
  • Africa by Toto for Japanese
  • mina_hanem for Farsi
  • nknown for Portuguese
  • pygo for Norwegian
  • MidNightSonne and andrecrjr for Brazilian Portuguese
  • YaroslavaWise and Nomina for Russian
  • Cristalla for Spanish
  • Tahadorukk '| Guns'NRoses for Turkish
  • Tu Hoang for Vietnamese
  • bbedward for reminding the jungle to support

Graphic Design support

  • Snappadoodle

*That's it guys. If you need to talk to us you can find us on Twitter:

Contribution Guide

Feel free to open Issues for bugs, feature requests, improvents to the code in https://github.com/sebrock/banano-donate/. Please commit to a separate branch and create PRs towards the master.

https://github.com/sebrock/banano-donate/

Made with 🧡 and potassium 🍌 in Brazil, Germany, and the BANANO Jungle.

banano-donate's People

Contributors

andrecrjr avatar dependabot[bot] avatar kilkelly avatar sebrock avatar tienna-0051 avatar

Stargazers

 avatar

Watchers

 avatar

Forkers

tienna-0051

banano-donate's Issues

Define scope (which languages)

Total number of Languages: 19 (Locales covered: 21)

Phase 1 - 8 locales

de - German
en - English
es - Spanish
es_419 - Spanish (Latin America and Caribbean)
fr - French
it - Italian
pt - Portuguese
pt_BR -Portuguese (Brazil)*

Phase 2 - 8 locales

ar - Arabic
da - Danish
fa - Persian (Farsi)
id - Bahasa Indonesia
nl - Dutch
ru - Russian
tr - Turkish
no - Norwegian

Phase 3 - 5 locales

el - Greek
hi - Hindi
ja - Japanese
vi - Vietnamese
zh_CN - Chinese (China)

i18n Implementation

Sub-Project breakdown: (separate Issues)

  • Define scope (which languages) #2
  • Setup POEditor #3
  • Recruit translators #4
  • Collect translations #5
  • Create messages.json files #6
  • Deploy languages #7

Recruit translators

Total number of Languages: 19 (Locales covered: 21)

Phase 1 - 8 locales

  • de - German
  • en - English
  • es - Spanish
  • es_419 - Spanish (Latin America and Caribbean)
  • fr - French
  • it - Italian
  • pt - Portuguese
  • pt_BR -Portuguese (Brazil)*

Phase 2 - 8 locales

  • ar - Arabic
  • da - Danish
  • fa - Persian (Farsi)
  • id - Bahasa Indonesia
  • nl - Dutch
  • ru - Russian
  • tr - Turkish
  • no - Norwegian

Phase 3 - 5 locales

  • el - Greek
  • hi - Hindi
  • ja - Japanese
  • vi - Vietnamese
  • zh_CN - Chinese (China)

Send with Vault

Instead of "or copy address to send manually from wallet!" . make a button "Send with BananoVault"

Construct target like so:

<a href="https://vault.banano.cc/send?to=ban_Address">

Send with Nault

Only after BananoNault is released and online.

Instead of "or copy address to send manually from wallet!" . make a button "Send with BananoNault"

Construct target like so:

<a href="https://banano.nault.cc/send?to=ban_Address">

Use the ban URI for QR generation

Another cool suggestion from Kirby 👍

If you use the ban URI it can open Kalium from any camera/QR app :)
ban:ban_1monkeyt1x77a1rp9bwtthajb8odapbmnzpyt8357ac8a1bcron34i3r9y66

image

Collect translations

Total number of Languages: 19 (Locales covered: 21)

Phase 1 - 8 locales

  • de - German
  • en - English
  • es - Spanish
  • es_419 - Spanish (Latin America and Caribbean)
  • fr - French
  • it - Italian
  • pt - Portuguese
  • pt_BR -Portuguese (Brazil)*

Phase 2 - 8 locales

  • ar - Arabic
  • da - Danish
  • fa - Persian (Farsi)
  • id - Bahasa Indonesia
  • nl - Dutch
  • ru - Russian
  • tr - Turkish
  • no - Norwegian

Phase 3 - 5 locales

  • el - Greek
  • hi - Hindi
  • ja - Japanese
    - [ ] vi - Vietnamese Vietnamese moved to #15
  • zh_CN - Chinese (China)

Add webstore badges to readme.md


![Chrome Web Store](https://img.shields.io/chrome-web-store/users/**_WEBSTORE_ID_**?label=chrome%20web%20store-users&style=plastic)

![Chrome Web Store](https://img.shields.io/chrome-web-store/rating/_**WEBSTORE_ID**_?label=chrome%20web%20store-rating&style=plastic)

Decimal separators not evaluated per locale, unusable QR code generated

Behaviour
Right now, entering a value like 19,19 (with a comma) does generate a QR code, but without BAN value.
Using 19.19 (with a period) works as expected.
This was with locale de (if that matters already).

Suggestion:
Catch entry of comma as an Error.
or
Evaluate locale specific separator and use appropriately for QR generation.

Create messages.json files

Create messages.json files

Export from POEditor in Key-value format, clean up, only message.

Total number of Languages: 19 (Locales covered: 21)

Phase 1 - 8 locales

  • de - German
  • en - English
  • es - Spanish
  • es_419 - Spanish (Latin America and Caribbean)
  • fr - French
  • it - Italian
  • pt - Portuguese
  • pt_BR -Portuguese (Brazil)*

Phase 2 - 8 locales

  • ar - Arabic
  • da - Danish
  • fa - Persian (Farsi)
  • id - Bahasa Indonesia
  • nl - Dutch
  • ru - Russian
  • tr - Turkish
  • no - Norwegian

Phase 3 - 5 locales

  • el - Greek
  • hi - Hindi
  • ja - Japanese
    - [ ] vi - Vietnamese Vietnamese moved to #15
  • zh_CN - Chinese (China)

Disclaimer in first screen

Upon first activation of the extension, a disclaimer shall be displayes, which has to be agreed to by the user by clicking "Accept"

Suggeted text (context msg_Disclaimer):

While reasonable effort has been made to ensure BananoDonate works securely please make sure to double-check all outgoing amounts from your wallet when making a donation. Test with a tiny donation amount first if you want peace of mind. The authors of this extension are not liable for any loss or damage arising directly or indirectly through use of this extension.

Setup POEditor

Sub-Project breakdown:

  • Create project
  • Select languages
  • Define terms
  • Define contexts
  • Define references
  • Assign translators

Readme.md errors

In Install Dev release description, the /dist/folder must be selected.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.