jamesives/Add GitHub Sponsors to Readme
This GitHub Action will automatically add your GitHub Sponsors to your README.
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Stale
- License
- None
Inputs
| name | description | required | default |
|---|---|---|---|
| token | You must provide the action with a Personal Access Token (PAT) with either the user:read and org:read permission scope and store it in the secrets / with menu as a secret. This should be generated from the account or organization that receives sponsorship. [Learn more about creating and using encrypted secrets here.](https://help.github.com/en/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets) | yes | — |
| file | This should point to the file that you're generating, for example README.md or path/to/CREDITS.md | yes | — |
| organization | If you're displaying sponsorship information as an organization you should toggle this option to true. You also need to provide the action with an org:read scoped PAT. | no | — |
| minimum | Using this input you can set the minimum sponsorship threshold. For example setting this to 500 will only display sponsors who give of $5 USD and more. By default the action will display all of your sponsors. | no | — |
| maximum | For example setting this to 1000 will only display sponsors who give of $10 USD and less. By default the action will display all of your sponsors. | no | — |
| marker | This allows you to modify the marker comment that is placed in your file. By default this is set to sponsors - <!-- sponsors --> <!-- sponsors -->, if you set this to gold for example you can place <!-- gold --> <!-- gold --> in your file. | no | — |
| template | Allows you to modify the default template. Please refer to the `template` section of this README for more information. | no | — |
| fallback | Allows you to specify a fallback if you have no sponsors. By default nothing is displayed. | no | — |
| active-only | If set to false, inactive sponsors will be displayed. This can be useful if you want to display all sponsors, regardless of their status. | no | true |
| include-private | If set to true, private sponsors will be displayed in the list, however any identifying information will be redacted. This can be useful if you want to display all sponsors, regardless of their privacy settings. | no | false |
Outputs
| name | description |
|---|---|
| sponsorshipStatus | The status of the action that indicates if the run failed or passed. Possible outputs include: success|failed |