You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/guides/applications/integrations/index.md
+29-31Lines changed: 29 additions & 31 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,60 +14,58 @@ alias_paths:
14
14
15
15
# Integrations
16
16
17
-
The [Box Integrations][app-center] is the first place for Box users to find out
18
-
about applications that they can use in combination with Box. If your
19
-
application is suited to be used by other enterprises, listing your service in
20
-
the Integrations can be a great way to find new users.
21
-
Integrations groups apps into sections so that you can
17
+
[Box Integrations][app-center] is the first place for Box users to find out
18
+
about applications they can use in combination with Box. If your
19
+
application can be used by other enterprises, listing your service in
20
+
under **Integrations** can be a great way to find new users.
21
+
Integrations group apps into sections so that you can
22
22
quickly find featured, most popular, or recently added apps.
23
23
24
24
25
25
26
-
## Developing and app or becoming a Box Partner
26
+
## Developing a platform app or becoming a Box Partner
27
27
28
-
If you would more information on developing an application for the Box Integrations or becoming a Box Partner, visit our [Box Partner Resources][bp] guides on our community site.
28
+
If you need more information on developing a platform app for the Box Integrations or becoming a Box Partner, visit our [Box Partner Resources][bp] guides on our community site.
29
29
30
-
## Publishing an app
30
+
## Publishing a platform app
31
31
32
-
Use the following steps to publish an application in Box Integrations.
32
+
Use the following steps to publish a platform app in Box Integrations.
33
33
34
34
### Prerequisites
35
35
36
36
Your application must meet the following requirements:
37
37
38
-
* The application is in a finished state and ready for production usage.
39
-
* The application leverages OAuth 2.0 authentication, as the Integrations does not support any other authentication methods.
40
-
* You are a developer with access to the application in the [Developer Console][devconsole].
38
+
* The platform app is in a finished state and ready for production usage.
39
+
* The platform app leverages OAuth 2.0 authentication, as Integrations do not support any other authentication methods.
40
+
* You are a developer with access to the platform app in the **Developer Console**.
41
41
42
42
### Steps
43
43
44
-
1. Navigate to the [Developer Console][devconsole]and select your application to submit.
44
+
1. Navigate to the Developer Console > **My Platform Apps**and select the app you want to publish.
45
45
2. Select the **Publishing** tab from the top menu.
48
48
49
-
3. Fill in the form with your application's categories, a short and a long description, screenshots and an app icon.
50
-
4. Click **Preview** to see a preview of your application listing.
51
-
5. Finally, submit the application for approval by clicking the **Submit for Approval** button.
49
+
3. Read through the submission checklist and check the confirmation checkbox if your app meets all the requirements.
50
+
4. Fill in the form by providing:
52
51
53
-
<Message>
54
-
# Approval completion
52
+
* the categories your app falls under
53
+
* a short and a long description
54
+
* screenshots and an app icon
55
+
* supplementary information that will be used to support the users
55
56
56
-
Once a request for approval is received, the Box Partner team will be
57
-
notified and review your request as soon as possible.
57
+
5. Use the **Preview** button in the top right corner to see how your application will look when listed.
58
+
6. Finally, submit the application for approval by clicking the **Submit for Approval** button. Once a request for approval is received, the Box Partner team will be notified and review your request as soon as possible. For any questions, email [`integrate@box.com`][email].
58
59
59
-
For any questions, please email [`integrate@box.com`][email] or submit a
60
-
support ticket.
61
-
</Message>
60
+
## Unpublishing a platform app
62
61
63
-
## Unpublishing an application
62
+
Once approved and published, a platform app can be unpublished from the same
63
+
control panel:
64
64
65
-
Once approved and published, an application can be unpublished from the same
66
-
control panel. Navigate to the [Developer Console][devconsole] and select
67
-
your application. Then, select the **Integrations** panel from the left-hand
68
-
sidebar. The app can be unpublished from this page.
65
+
1. Navigate to the **Developer Console** and select your platform app.
Copy file name to clipboardExpand all lines: content/guides/getting-started/publish-app.md
+22-32Lines changed: 22 additions & 32 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,48 +2,38 @@
2
2
rank: 3
3
3
---
4
4
5
-
# Publish your application
5
+
# Publish your app
6
6
7
-
When you finish the app configuration and testing, you can publish
7
+
When you finish the platform app configuration and testing, you can publish
8
8
it in the [Box Integrations][integrations]. It allows customers to find
9
-
your application and add it to their Box accounts.
9
+
your app and add it to their Box accounts.
10
10
11
11
<Messagetype='warning'>
12
12
13
-
Only applications that use the OAuth 2.0 authentication have a
14
-
built-in publication option. You can use other user authentication
15
-
types, but such app can only serve as a marketing listing in the
16
-
Integrations and redirect customers to your website.
13
+
Only apps that use the OAuth 2.0 authentication have a built-in publication option. In case you use a different auth type for your integration, you can still create and publish an OAuth 2.0 platform app that will serve as a marketing listing in the **Integrations** and redirect customers to your website.
17
14
18
15
</Message>
19
16
20
-
To publish your app:
17
+
To publish your platform app:
21
18
22
19
1. Open the **Dev Console**.
23
-
2. Select the application you want to publish.
24
-
3. Go to the **Integrations** tab and submit your app.
25
-
26
-
This action gives you access to the marketing section of the
27
-
application, where you need to add the following app information:
28
-
29
-
-**General App Info** - choose correct categories and platforms for your application to make it easier to find in the Integrations,
30
-
-**App Description** - make sure it contains all information about your application that the customers may find useful,
31
-
-**Short Description** appears next to your app logo, together with your app name;
32
-
-**Long Description** is what the users see after they select your app to view its details. You can add clickable links to the long description.
33
-
34
-
<Messagetype='notice'>
35
-
36
-
Specific guidelines for screenshots and logos are provided in the Dev
37
-
Console.
38
-
39
-
</Message>
40
-
41
-
When you're finished with providing the details about your app,
42
-
submit your app for approval. Box will review your application
43
-
and publish it in the Integrations.
44
-
45
-
In case of any questions or issues, contact the Partners team:
46
-
[`integrate@box.com`][email]
20
+
2. Select the platform app you want to publish.
21
+
3. Go to the **Publishing** tab.
22
+
4. Read through the submission checklist and check the confirmation checkbox if your app meets all the requirements.
23
+
5. The next step is the marketing section of the app, where you need to add the following app information:
24
+
25
+
-**General Info** - choose correct categories and platforms for your app to make it easier to find in the Integrations,
26
+
-**Description** - make sure it contains all information about your app that the customers may find useful,
27
+
-**Short Description** appears next to your app logo, together with your app name;
28
+
-**Long Description** is what the users see after they select your app to view its details. You can add clickable links to the long description.
29
+
-**Screenshots** and **Icon** - provide the screenshots to allow the users see how the app looks like and how it integrates with Box. The icon is needed to represent your app in the list of Integrations.
30
+
-**Support Resources** - A list of links and supplementary information that will help the users to work with your app.
31
+
32
+
6. Before submitting your app, preview it to see if you included all the necessary information.
33
+
7. Submit your app for approval. Box will review your app and publish it under **Integrations**.
34
+
35
+
If you have any questions or issues, contact the **Partners** team:
0 commit comments