Download the PHP package somoza/consider-donating without Composer
On this page you can find all versions of the php package somoza/consider-donating. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download somoza/consider-donating
More information about somoza/consider-donating
Files in somoza/consider-donating
Package consider-donating
Short Description A common protocol for gathering donations for your OSS package via Composer.
License MIT
Informations about the package consider-donating
Consider Donating Composer Plugin
This plugin was inspired by this thread on Twitter.
The aim of the project is to provide a common interface for package developers to prompt their users for donations in a way that feels "natural" for everyone involved.
Commitment
- Donations will always be optional.
- This project will always remain free and open source.
- We will never collect commission on any donations.
Usage
For Package Mantainers
As a package developer, you can prompt your users to donate to your package by doing the following:
- Setup a landing page where you collect your donations.
- Require this Composer plugin:
composer require gsomoza/consider-donating
- Add the following to your package's
composer.json
file:
That's it! When someone installs your package they will see a message on their terminal, like the following:
For end-users
End-users can follow on-screen instructions to donate, but additionally they can also:
Authenticate
Authenticating allows you to keep your donations even if you're working within VM's or Containers, or if you switch computers.
Roadmap
1. Implement basic protocol and functionality
Already implemented.
2. Donation Validations
The proposed donation validation flow (not yet implemented) would work as follows:
Version 1.0
- The user is redirected to a donation page where they can perform their donation.
- At the same time, an email is sent to the package maintainer with a link. Once the donation is confirmed, the package maintainer can click on that link to confirm the donation within our system.
- The next time the user uses Composer (with an Internet connection), our plugin will automatically validate the donation took place and cache the validation token locally. They will not see a suggestion to donate to that package anymore.
To be added after release:
- Integrations for the one or two most common donation platforms.
- Allow easily migrating donation tokens (e.g. to a new computer)
Version 2:
- Support for team-level donations (useful for companies)
All versions of consider-donating with dependencies
somoza/cli-auth Version ^0.1.3
composer-plugin-api Version ^1.1
webmozart/assert Version ^1.4