Using your own Box App is optional. For an easy setup you can just use the default App of the plugin itself. The advantage of using your own app is limited, but you can for example see your own API usage statistics in the Box Developer Console.
Step 1: Access the Box Developer Console
- Go to the Box Developer Console.
- Sign in with your Box account. If you don't have a developer account, create one first.
Step 2: Create a New Custom App
- Click Create Platform App.
- Select Custom App.
- Enter a name for your app and click Next.
- For the authentication method, select User Authentication (OAuth 2.0).
- Click Create App.
Step 3: Configure OAuth 2.0 Settings
- Open the Configuration tab of your newly created app.
- Under OAuth 2.0 Credentials, copy the Client ID and Client Secret.
- Paste these values on the plugin's settings page in WordPress and save.
- Copy the OAuth 2.0 Redirect URI shown on the plugin's main settings page.
- Back in the Box Configuration tab, paste this URL under OAuth 2.0 Redirect URIs and save.
Step 4: Configure Application Scopes
Still in the Configuration tab, under Application Scopes, enable the scopes the plugin needs:
- Read all files and folders stored in Box
- Write all files and folders stored in Box (if the plugin needs upload or write functionality)
- Manage users and/or Manage enterprise properties (only if your use case requires it; typically not needed)
Save the configuration.
Step 5: Authorize the Plugin
On the plugin's settings page in WordPress, click the authorize button to complete the OAuth flow.
Notice 1: If your Box account is part of an enterprise, the enterprise admin may need to approve the app before users can authorize it. Contact your Box administrator if authorization fails.
Notice 2: If you run into issues using your own App, fall back to the default App by clearing the Client ID and Client Secret on the plugin's settings page.