https://github.com/astrotomic/laravel-github-sponsors
Retrieve the GitHub Sponsors of a given user/organization.
https://github.com/astrotomic/laravel-github-sponsors
github-sponsors laravel php sponsors
Last synced: about 1 year ago
JSON representation
Retrieve the GitHub Sponsors of a given user/organization.
- Host: GitHub
- URL: https://github.com/astrotomic/laravel-github-sponsors
- Owner: Astrotomic
- License: mit
- Created: 2021-08-10T13:38:47.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2023-04-17T10:40:36.000Z (about 3 years ago)
- Last Synced: 2025-04-06T03:31:57.497Z (about 1 year ago)
- Topics: github-sponsors, laravel, php, sponsors
- Language: PHP
- Homepage:
- Size: 180 KB
- Stars: 8
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Laravel GitHub Sponsors
[](https://github.com/Astrotomic/laravel-github-sponsors/blob/main/LICENSE.md)
[](https://packagist.org/packages/astrotomic/laravel-github-sponsors)
[](https://github.com/Astrotomic/laravel-github-sponsors/blob/main/composer.json)
[](https://forest.astrotomic.info)
[](https://larabelles.com)
[](https://opendor.me)
[](https://github.com/Astrotomic/laravel-github-sponsors/actions?query=workflow%3Apest)
[](https://github.com/Astrotomic/laravel-github-sponsors/actions?query=workflow%3Aphpcs)
[](https://packagist.org/packages/astrotomic/laravel-github-sponsors)
Retrieve the GitHub Sponsors of any user/organization and check if someone is sponsoring you.
## Installation
```bash
composer require astrotomic/laravel-github-sponsors
```
## Configuration
Set `services.github.sponsors_token` config value or override service binding in your own service provider.
The used PAT needs at least `read:user` and `read:org` permissions to retrieve all sponsors.
```php
$this->app->when(\Astrotomic\GithubSponsors\Graphql::class)
->needs('$token')
->give('my_custom_secret');
```
## Usage
```php
use Astrotomic\GithubSponsors\Facades\GithubSponsors;
// all sponsors for current authenticated user
GithubSponsors::viewer()->sponsors();
// all sponsors for given name without knowing what it is
GithubSponsors::login('larabelles')->sponsors();
// all sponsors for given user
GithubSponsors::user('Gummibeer')->sponsors();
// all sponsors for given organization
GithubSponsors::organization('Astrotomic')->sponsors();
// select specific attributes
GithubSponsors::viewer()->sponsors(['login', 'name', 'avatarUrl']);
// select specific attributes and company only for users
GithubSponsors::viewer()->sponsors(['login', 'name', 'avatarUrl'], ['company']);
// select specific attributes and email only for organizations
GithubSponsors::viewer()->sponsors(['login', 'name', 'avatarUrl'], [], ['email']);
// check if viewer sponsored by Gummibeer
GithubSponsors::viewer()->isSponsoredBy('Gummibeer');
// check if viewer sponsors Gummibeer
GithubSponsors::viewer()->isSponsoring('Gummibeer');
// check if viewer has sponsors
GithubSponsors::viewer()->hasSponsors();
// check how many sponsors the viewer has
GithubSponsors::viewer()->sponsorsCount();
```
## Changelog
Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.
## Contributing
Please see [CONTRIBUTING](https://github.com/Astrotomic/.github/blob/master/CONTRIBUTING.md) for details. You could also be interested in [CODE OF CONDUCT](https://github.com/Astrotomic/.github/blob/master/CODE_OF_CONDUCT.md).
### Security
If you discover any security related issues, please check [SECURITY](https://github.com/Astrotomic/.github/blob/master/SECURITY.md) for steps to report it.
## Credits
- [Tom Witkowski](https://github.com/Gummibeer)
- [Mert Aşan](https://github.com/mertasan)
- [All Contributors](../../contributors)
## License
The MIT License (MIT). Please see [License File](LICENSE.md) for more information.
## Treeware
You're free to use this package, but if it makes it to your production environment I would highly appreciate you buying the world a tree.
It’s now common knowledge that one of the best tools to tackle the climate crisis and keep our temperatures from rising above 1.5C is to [plant trees](https://www.bbc.co.uk/news/science-environment-48870920). If you contribute to my forest you’ll be creating employment for local families and restoring wildlife habitats.
You can buy trees at [ecologi.com/astrotomic](https://forest.astrotomic.info)
Read more about Treeware at [treeware.earth](https://treeware.earth)