Update all files to use {% data %} (#15253)
* Add back changes from prior to purge * Manually fix some invalid Liquid * Updoot render-content * Improve test messages to show correct output * Run el scripto * Pass the remaining test
This commit is contained in:
Jason Etcovitch
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: Creating a GitHub App using URL parameters
|
||||
intro: 'You can preselect the settings of a new {{ site.data.variables.product.prodname_github_app }} using URL [query parameters](https://en.wikipedia.org/wiki/Query_string) to quickly set up the new {{ site.data.variables.product.prodname_github_app }}''s configuration.'
|
||||
intro: 'You can preselect the settings of a new {% data variables.product.prodname_github_app %} using URL [query parameters](https://en.wikipedia.org/wiki/Query_string) to quickly set up the new {% data variables.product.prodname_github_app %}''s configuration.'
|
||||
redirect_from:
|
||||
- /apps/building-github-apps/creating-github-apps-using-url-parameters
|
||||
versions:
|
||||
@@ -9,13 +9,13 @@ versions:
|
||||
---
|
||||
|
||||
|
||||
### About {{ site.data.variables.product.prodname_github_app }} URL parameters
|
||||
### About {% data variables.product.prodname_github_app %} URL parameters
|
||||
|
||||
You can add query parameters to these URLs to preselect the configuration of a {{ site.data.variables.product.prodname_github_app }} on a personal or organization account:
|
||||
You can add query parameters to these URLs to preselect the configuration of a {% data variables.product.prodname_github_app %} on a personal or organization account:
|
||||
* **User account:** `https://github.com/settings/apps/new`
|
||||
* **Organization account:** `https://github.com/organizations/:org/settings/apps/new`
|
||||
|
||||
The person creating the app can edit the preselected values from the {{ site.data.variables.product.prodname_github_app }} registration page, before submitting the app. If you do not include required parameters in the URL query string, like `name`, the person creating the app will need to input a value before submitting the app.
|
||||
The person creating the app can edit the preselected values from the {% data variables.product.prodname_github_app %} registration page, before submitting the app. If you do not include required parameters in the URL query string, like `name`, the person creating the app will need to input a value before submitting the app.
|
||||
|
||||
The following URL creates a new public app called `octocat-github-app` with a preconfigured description and callback URL. This URL also selects read and write permissions for `checks`, subscribes to the `check_run` and `check_suite` webhook events, and selects the option to request user authorization (OAuth) during installation:
|
||||
|
||||
@@ -25,25 +25,25 @@ The following URL creates a new public app called `octocat-github-app` with a pr
|
||||
|
||||
The complete list of available query parameters, permissions, and events is listed in the sections below.
|
||||
|
||||
### {{ site.data.variables.product.prodname_github_app }} configuration parameters
|
||||
### {% data variables.product.prodname_github_app %} configuration parameters
|
||||
|
||||
Name | Type | Description
|
||||
-----|------|-------------
|
||||
`name` | `string` | The name of the {{ site.data.variables.product.prodname_github_app }}. Give your app a clear and succinct name. Your app cannot have the same name as an existing GitHub user, unless it is your own user or organization name. A slugged version of your app's name will be shown in the user interface when your integration takes an action.
|
||||
`description` | `string` | A description of the {{ site.data.variables.product.prodname_github_app }}.
|
||||
`url` | `string` | The full URL of your {{ site.data.variables.product.prodname_github_app }}'s website homepage.
|
||||
`name` | `string` | The name of the {% data variables.product.prodname_github_app %}. Give your app a clear and succinct name. Your app cannot have the same name as an existing GitHub user, unless it is your own user or organization name. A slugged version of your app's name will be shown in the user interface when your integration takes an action.
|
||||
`description` | `string` | A description of the {% data variables.product.prodname_github_app %}.
|
||||
`url` | `string` | The full URL of your {% data variables.product.prodname_github_app %}'s website homepage.
|
||||
`callback_url` | `string` | The full URL to redirect to after someone authorizes an installation. This URL is used if your app needs to identify and authorize user-to-server requests.
|
||||
`request_oauth_on_install` | `boolean` | If your app authorizes users using the OAuth flow, you can set this option to `true` to allow people to authorize the app when they install it, saving a step. If you select this option, the `setup_url` becomes unavailable and users will be redirected to your `callback_url` after installing the app.
|
||||
`setup_url` | `string` | The full URL to redirect to after someone installs the {{ site.data.variables.product.prodname_github_app }} if the app requires additional setup after installation.
|
||||
`setup_url` | `string` | The full URL to redirect to after someone installs the {% data variables.product.prodname_github_app %} if the app requires additional setup after installation.
|
||||
`setup_on_update` | `boolean` | Set to `true` to redirect people to the setup URL when installations have been updated, for example, after repositories are added or removed.
|
||||
`public` | `boolean` | Set to `true` when your {{ site.data.variables.product.prodname_github_app }} is available to the public or `false` when it is only accessible to the owner of the app.
|
||||
`public` | `boolean` | Set to `true` when your {% data variables.product.prodname_github_app %} is available to the public or `false` when it is only accessible to the owner of the app.
|
||||
`webhook_url` | `string` | The full URL that you would like to send webhook event payloads to.
|
||||
`webhook_secret` | `string` | You can specify a secret to secure your webhooks. See "[Securing your webhooks](/webhooks/securing/)" for more details.
|
||||
`events` | `array of strings` | Webhook events. Some webhook events require `read` or `write` permissions for a resource before you can select the event when registering a new {{ site.data.variables.product.prodname_github_app }}. See the "[{{ site.data.variables.product.prodname_github_app }} webhook events](#github-app-webhook-events)" section for available events and their required permissions. You can select multiple events in a query string. For example, `events[]=public&events[]=label`.
|
||||
`events` | `array of strings` | Webhook events. Some webhook events require `read` or `write` permissions for a resource before you can select the event when registering a new {% data variables.product.prodname_github_app %}. See the "[{% data variables.product.prodname_github_app %} webhook events](#github-app-webhook-events)" section for available events and their required permissions. You can select multiple events in a query string. For example, `events[]=public&events[]=label`.
|
||||
`domain` | `string` | The URL of a content reference.
|
||||
`single_file_name` | `string` | When you grant `read` or `write` access to the `single_file` permission, this field provides the path to the single file your {{ site.data.variables.product.prodname_github_app }} will manage.
|
||||
`single_file_name` | `string` | When you grant `read` or `write` access to the `single_file` permission, this field provides the path to the single file your {% data variables.product.prodname_github_app %} will manage.
|
||||
|
||||
### {{ site.data.variables.product.prodname_github_app }} permissions
|
||||
### {% data variables.product.prodname_github_app %} permissions
|
||||
|
||||
You can select permissions in a query string using the permission name in the following table as the query parameter name and the permission type as the query value. For example, to select `Read & write` permissions in the user interface for `contents`, your query string would include `&contents=write`. To select `Read-only` permissions in the user interface for `blocking`, your query string would include `&blocking=read`. To select `no-access` in the user interface for `checks`, your query string would not include the `checks` permission.
|
||||
|
||||
@@ -61,7 +61,7 @@ Permission | Description
|
||||
[`issues`](/rest/reference/permissions-required-for-github-apps/#permission-on-issues) | Grants access to the [Issues API](/v3/issues/). Can be one of: `none`, `read`, or `write`.
|
||||
[`keys`](/rest/reference/permissions-required-for-github-apps/#permission-on-keys) | Grants access to the [Public Keys API](/v3/users/keys/). Can be one of: `none`, `read`, or `write`.
|
||||
[`members`](/rest/reference/permissions-required-for-github-apps/#permission-on-members) | Grants access to manage an organization's members. Can be one of: `none`, `read`, or `write`.{% if currentVersion == "free-pro-team@latest" %}
|
||||
[`metadata`](/rest/reference/permissions-required-for-github-apps/#metadata-permissions) | Grants access to read-only endpoints that do not leak sensitive data. Can be `read` or `none`. Defaults to `read` when you set any permission, or defaults to `none` when you don't specify any permissions for the {{ site.data.variables.product.prodname_github_app }}.
|
||||
[`metadata`](/rest/reference/permissions-required-for-github-apps/#metadata-permissions) | Grants access to read-only endpoints that do not leak sensitive data. Can be `read` or `none`. Defaults to `read` when you set any permission, or defaults to `none` when you don't specify any permissions for the {% data variables.product.prodname_github_app %}.
|
||||
[`organization_administration`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-administration) | Grants access to "[Update an organization](/v3/orgs/#update-an-organization)" endpoint and the [Organization Interaction Restrictions API](/v3/interactions/orgs/#set-interaction-restrictions-for-an-organization). Can be one of: `none`, `read`, or `write`.{% endif %}
|
||||
[`organization_hooks`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-hooks) | Grants access to the [Organization Webhooks API](/v3/orgs/hooks/). Can be one of: `none`, `read`, or `write`.
|
||||
`organization_plan` | Grants access to get information about an organization's plan using the "[Get an organization](/v3/orgs/#get-an-organization)" endpoint. Can be one of: `none` or `read`.
|
||||
@@ -79,41 +79,41 @@ Permission | Description
|
||||
`vulnerability_alerts`| Grants access to receive security alerts for vulnerable dependencies in a repository. See "[About security alerts for vulnerable dependencies](/articles/about-security-alerts-for-vulnerable-dependencies)" to learn more. Can be one of: `none` or `read`.
|
||||
`watching` | Grants access to list and change repositories a user is subscribed to. Can be one of: `none`, `read`, or `write`.
|
||||
|
||||
### {{ site.data.variables.product.prodname_github_app }} webhook events
|
||||
### {% data variables.product.prodname_github_app %} webhook events
|
||||
|
||||
Webhook event name | Required permission | Description
|
||||
------------------ | ------------------- | -----------
|
||||
[`check_run`](/webhooks/event-payloads/#check_run) |`checks` | {{ site.data.reusables.webhooks.check_run_short_desc }}
|
||||
[`check_suite`](/webhooks/event-payloads/#check_suite) |`checks` | {{ site.data.reusables.webhooks.check_suite_short_desc}}
|
||||
[`commit_comment`](/webhooks/event-payloads/#commit_comment) | `contents` | {{ site.data.reusables.webhooks.commit_comment_short_desc }}
|
||||
[`content_reference`](/webhooks/event-payloads/#content_reference) |`content_references` | {{ site.data.reusables.webhooks.content_reference_short_desc }}
|
||||
[`create`](/webhooks/event-payloads/#create) | `contents` | {{ site.data.reusables.webhooks.create_short_desc }}
|
||||
[`delete`](/webhooks/event-payloads/#delete) | `contents` | {{ site.data.reusables.webhooks.delete_short_desc }}
|
||||
[`deployment`](/webhooks/event-payloads/#deployment) | `deployments` | {{ site.data.reusables.webhooks.deployment_short_desc }}
|
||||
[`deployment_status`](/webhooks/event-payloads/#deployment_status) | `deployments` | {{ site.data.reusables.webhooks.deployment_status_short_desc }}
|
||||
[`fork`](/webhooks/event-payloads/#fork) | `contents` | {{ site.data.reusables.webhooks.fork_short_desc }}
|
||||
[`gollum`](/webhooks/event-payloads/#gollum) | `contents` | {{ site.data.reusables.webhooks.gollum_short_desc }}
|
||||
[`issues`](/webhooks/event-payloads/#issues) | `issues` | {{ site.data.reusables.webhooks.issues_short_desc }}
|
||||
[`issue_comment`](/webhooks/event-payloads/#issue_comment) | `issues` | {{ site.data.reusables.webhooks.issue_comment_short_desc }}
|
||||
[`label`](/webhooks/event-payloads/#label) | `metadata` | {{ site.data.reusables.webhooks.label_short_desc }}
|
||||
[`member`](/webhooks/event-payloads/#member) | `members` | {{ site.data.reusables.webhooks.member_short_desc }}
|
||||
[`membership`](/webhooks/event-payloads/#membership) | `members` | {{ site.data.reusables.webhooks.membership_short_desc }}
|
||||
[`milestone`](/webhooks/event-payloads/#milestone) | `pull_request` | {{ site.data.reusables.webhooks.milestone_short_desc }}{% if currentVersion == "free-pro-team@latest" %}
|
||||
[`org_block`](/webhooks/event-payloads/#org_block) | `organization_administration` | {{ site.data.reusables.webhooks.org_block_short_desc }}{% endif %}
|
||||
[`organization`](/webhooks/event-payloads/#organization) | `members` | {{ site.data.reusables.webhooks.organization_short_desc }}
|
||||
[`page_build`](/webhooks/event-payloads/#page_build) | `pages` | {{ site.data.reusables.webhooks.page_build_short_desc }}
|
||||
[`project`](/webhooks/event-payloads/#project) | `repository_projects` or `organization_projects` | {{ site.data.reusables.webhooks.project_short_desc }}
|
||||
[`project_card`](/webhooks/event-payloads/#project_card) | `repository_projects` or `organization_projects` | {{ site.data.reusables.webhooks.project_card_short_desc }}
|
||||
[`project_column`](/webhooks/event-payloads/#project_column) | `repository_projects` or `organization_projects` | {{ site.data.reusables.webhooks.project_column_short_desc }}
|
||||
[`public`](/webhooks/event-payloads/#public) | `metadata` | {{ site.data.reusables.webhooks.public_short_desc }}
|
||||
[`pull_request`](/webhooks/event-payloads/#pull_request) | `pull_requests` | {{ site.data.reusables.webhooks.pull_request_short_desc }}
|
||||
[`pull_request_review`](/webhooks/event-payloads/#pull_request_review) | `pull_request` | {{ site.data.reusables.webhooks.pull_request_review_short_desc }}
|
||||
[`pull_request_review_comment`](/webhooks/event-payloads/#pull_request_review_comment) | `pull_request` | {{ site.data.reusables.webhooks.pull_request_review_comment_short_desc }}
|
||||
[`push`](/webhooks/event-payloads/#push) | `contents` | {{ site.data.reusables.webhooks.push_short_desc }}
|
||||
[`release`](/webhooks/event-payloads/#release) | `contents` | {{ site.data.reusables.webhooks.release_short_desc }}
|
||||
[`repository`](/webhooks/event-payloads/#repository) |`metadata` | {{ site.data.reusables.webhooks.repository_short_desc }}{% if currentVersion == "free-pro-team@latest"%}
|
||||
[`check_run`](/webhooks/event-payloads/#check_run) |`checks` | {% data reusables.webhooks.check_run_short_desc %}
|
||||
[`check_suite`](/webhooks/event-payloads/#check_suite) |`checks` | {% data reusables.webhooks.check_suite_short_desc %}
|
||||
[`commit_comment`](/webhooks/event-payloads/#commit_comment) | `contents` | {% data reusables.webhooks.commit_comment_short_desc %}
|
||||
[`content_reference`](/webhooks/event-payloads/#content_reference) |`content_references` | {% data reusables.webhooks.content_reference_short_desc %}
|
||||
[`create`](/webhooks/event-payloads/#create) | `contents` | {% data reusables.webhooks.create_short_desc %}
|
||||
[`delete`](/webhooks/event-payloads/#delete) | `contents` | {% data reusables.webhooks.delete_short_desc %}
|
||||
[`deployment`](/webhooks/event-payloads/#deployment) | `deployments` | {% data reusables.webhooks.deployment_short_desc %}
|
||||
[`deployment_status`](/webhooks/event-payloads/#deployment_status) | `deployments` | {% data reusables.webhooks.deployment_status_short_desc %}
|
||||
[`fork`](/webhooks/event-payloads/#fork) | `contents` | {% data reusables.webhooks.fork_short_desc %}
|
||||
[`gollum`](/webhooks/event-payloads/#gollum) | `contents` | {% data reusables.webhooks.gollum_short_desc %}
|
||||
[`issues`](/webhooks/event-payloads/#issues) | `issues` | {% data reusables.webhooks.issues_short_desc %}
|
||||
[`issue_comment`](/webhooks/event-payloads/#issue_comment) | `issues` | {% data reusables.webhooks.issue_comment_short_desc %}
|
||||
[`label`](/webhooks/event-payloads/#label) | `metadata` | {% data reusables.webhooks.label_short_desc %}
|
||||
[`member`](/webhooks/event-payloads/#member) | `members` | {% data reusables.webhooks.member_short_desc %}
|
||||
[`membership`](/webhooks/event-payloads/#membership) | `members` | {% data reusables.webhooks.membership_short_desc %}
|
||||
[`milestone`](/webhooks/event-payloads/#milestone) | `pull_request` | {% data reusables.webhooks.milestone_short_desc %}{% if currentVersion == "free-pro-team@latest" %}
|
||||
[`org_block`](/webhooks/event-payloads/#org_block) | `organization_administration` | {% data reusables.webhooks.org_block_short_desc %}{% endif %}
|
||||
[`organization`](/webhooks/event-payloads/#organization) | `members` | {% data reusables.webhooks.organization_short_desc %}
|
||||
[`page_build`](/webhooks/event-payloads/#page_build) | `pages` | {% data reusables.webhooks.page_build_short_desc %}
|
||||
[`project`](/webhooks/event-payloads/#project) | `repository_projects` or `organization_projects` | {% data reusables.webhooks.project_short_desc %}
|
||||
[`project_card`](/webhooks/event-payloads/#project_card) | `repository_projects` or `organization_projects` | {% data reusables.webhooks.project_card_short_desc %}
|
||||
[`project_column`](/webhooks/event-payloads/#project_column) | `repository_projects` or `organization_projects` | {% data reusables.webhooks.project_column_short_desc %}
|
||||
[`public`](/webhooks/event-payloads/#public) | `metadata` | {% data reusables.webhooks.public_short_desc %}
|
||||
[`pull_request`](/webhooks/event-payloads/#pull_request) | `pull_requests` | {% data reusables.webhooks.pull_request_short_desc %}
|
||||
[`pull_request_review`](/webhooks/event-payloads/#pull_request_review) | `pull_request` | {% data reusables.webhooks.pull_request_review_short_desc %}
|
||||
[`pull_request_review_comment`](/webhooks/event-payloads/#pull_request_review_comment) | `pull_request` | {% data reusables.webhooks.pull_request_review_comment_short_desc %}
|
||||
[`push`](/webhooks/event-payloads/#push) | `contents` | {% data reusables.webhooks.push_short_desc %}
|
||||
[`release`](/webhooks/event-payloads/#release) | `contents` | {% data reusables.webhooks.release_short_desc %}
|
||||
[`repository`](/webhooks/event-payloads/#repository) |`metadata` | {% data reusables.webhooks.repository_short_desc %}{% if currentVersion == "free-pro-team@latest"%}
|
||||
[`repository_dispatch`](/webhooks/event-payloads/#repository_dispatch) | `contents` | Allows integrators using GitHub Actions to trigger custom events.{% endif %}
|
||||
[`status`](/webhooks/event-payloads/#status) | `statuses` | {{ site.data.reusables.webhooks.status_short_desc }}
|
||||
[`team`](/webhooks/event-payloads/#team) | `members` | {{ site.data.reusables.webhooks.team_short_desc }}
|
||||
[`team_add`](/webhooks/event-payloads/#team_add) | `members` | {{ site.data.reusables.webhooks.team_add_short_desc }}
|
||||
[`watch`](/webhooks/event-payloads/#watch) | `metadata` | {{ site.data.reusables.webhooks.watch_short_desc }}
|
||||
[`status`](/webhooks/event-payloads/#status) | `statuses` | {% data reusables.webhooks.status_short_desc %}
|
||||
[`team`](/webhooks/event-payloads/#team) | `members` | {% data reusables.webhooks.team_short_desc %}
|
||||
[`team_add`](/webhooks/event-payloads/#team_add) | `members` | {% data reusables.webhooks.team_add_short_desc %}
|
||||
[`watch`](/webhooks/event-payloads/#watch) | `metadata` | {% data reusables.webhooks.watch_short_desc %}
|
||||
|
||||
Reference in New Issue
Block a user