Box Cloud App
This article will describe the individual pieces of the Box Cloud App, how to have it enabled for your Eloqua instance, and configure it for display on your E10 landing page. This document assumes that the reader is an E10 user, and is familiar with using landing pages.
With the Box Cloud App, you can now share files stored in your Box account on an E10 landing page. You can choose to either display a link to your file, embed an image, or display the Box file previewer right on your page.
In order to use the Box App, you will need to have a valid Box account, and must be registered at cloudconnectors.eloqua.com.
Box Cloud App Components
The Box Cloud App consists of the following Cloud Component:
- Box File Share - allows you to embed an image, document link, or document previewer into an E10 landing page.
How to Install the Cloud App
The Box Cloud App is already available for use in E10, but may need to be enabled.
See here for more information.
Using the Component on a Landing Page
A Cloud Component is inserted into a landing page via drag and drop within the landing page editor.
From the editor toolbar, select the "Cloud Components" button. A select box containing all of the available Cloud Components will then display.
Drag and Drop the Box File Share component onto the landing page:
Next, save the page, then double-click the icon that you just dropped onto the page. The following screen will appear:
Enter your cloudconnectors.eloqua.com credentials and log in. The configuration screen for the Box File Share will then be displayed:
In order to access your Box files, you will need to grant the component access to your account. To do this, click "Authorize Account".
The following screen will then appear:
Enter your Box credentials and click "Log In".
(NOTE: If you are using a Single Sign On (SSO) service such as Okta, enter only your Email and leave the password blank)
Once successful, a window will display saying "Thank you. Close this window to continue". Close the window, you've now granted access to your files!
Next, select the file you would like to share on the page. Click on the Select File button.
The app will search your Box account and display the results.
Your Box account contents will be displayed as a set of folders and files. Click on a folder to see the files within it, or click on a file to select it. You can also page through results by clicking on the numbers below the file list.
Once you've selected your file, the app will check your Box account to see if the file is currently shared. If the file is not yet shared, you will be shown the following:
Since the app required you to share the file before displaying in on the landing page, you have a couple options. You can choose to go to your Box account and create the share there, or the app can create it for you. If you choose to do this through your Box account, you simply create the share manually, then come back to the app and click Save Settings again. The warning will then disappear. If you choose to have the app create it for you, simply select a share type (Open, Company, or Collaborators) and click Share. If the share is created successfully, you will see the following:
Your file is now shared. The shared file will show in the File to Share field.
You're now ready to select your Share Type.
You will be presented with three options for sharing. These include:
- Previewer - Embed the Box previewer directly in your page.
- Image Embed - Display an image from your Box account on your page.
- Link to File - Provide a link to a file in your page.
To embed an image from your Box account, choose Image Embed.
Click on Save Settings and close the Configuration screen.
Now, render the landing page, and you will see your Image Embed on the page where you placed it.
If you would like to embed a link to a file in your landing page, select Link to File.
For a "Link to File", you can use either the default icon, or a custom icon of your choosing.
To select a custom icon, select "Custom" from the "Image to display as link" dropdown, and enter the URL to the image.
Now, render the landing page, and you will see your file link on the page where you placed it.
The third option is embedding the file previewer on your page. Select Previewer from the option list. The following additional settings will appear.
In the Previewer Settings area, you can use the following to customize the previewer for display on your page.
- Permissions - Choose to either show or hide the Download, Share, or Print buttons.
- Dimensions - Set the size of the previewer (Note: make sure that the component on the landing page is at least the dimensions that you set here to allow all of your content to display).
When you have the settings the way you wish, render the landing page. You will see the previewer displayed on the page.