Install the InDesign Plug-in

Help Center

Install the InDesign Plug-in

When using the InDesign Plug-in, you must make sure the names of your Publications and Issues do not contain any of these special characters or the plug-in will NOT work: \ / | < > ? : * “

You can install the Ad Orbit InDesign plugin for InDesign CC 2020 and later. You must have the InDesign module enabled to connect after installing the plug-in.

Close InDesign application if already open.
Download the ExMan Command Line Tool to your desktop from this location. (If the link doesn’t work, highlight the word, right-click and choose “copy link address” then open a new browser window and paste the address in the URL line, and hit return).
Extract the downloaded ExManCmdWin.zip file.
Download the InDesign Plug-in.zxp file from this location. Extract the .zip file on your desktop (this is a MUST)
Launch command prompt, run the following commands to install extension.
1. cd {space} drag the ExManCmd_win folder into the command prompt window and it will automatically populate the path hit the enter key.
2. ExManCmd.exe /install{space} drag the file MagBuilderTools_18.0.2.zxp and drop it in the terminal window to add the path - hit the Enter key

Note

Please check this link for more information on installation steps

Continue on to Configuring your Plug-in section of these instructions.

If you have a previous version of the plug-in installed, you will first need to uninstall that version before installing the latest version. If this is your first time installing the plug-in, then go directly to the Install the plug-in instructions.

Uninstall the plug-in

Close all Adobe applications
Download the ExMan Command Line Tool to your desktop from this location. (If the link doesn't work when you click on it, try right-clicking on it and Copy Link Address, then open a new web browser window and paste it into the URL line then hit enter).
1. Move the downloaded DMG file to your desktop.
2. Double click the dmg file to extract the disk.
3. Double click the cmdline64 disk image on your desktop to open.
4. Double click the Contents Folder - leave it open.
Next, open the Terminal application on your computer Applications > Utilities > Terminal.
Run the following commands to traverse to the Mac OS folder on cmdline64 disk.
1. cd{space} drag the MacOS folder (from inside the "cmdline64" disk image&Contents folder) into the terminal window and it will automatically populate the path - the code will look like this: cd /Volumes/cmdline64/Contents/MacOS. Hit the enter key.
2. To uninstall the plug-in, use the following command: sudo ./Contents/MacOS/ExManCmd --remove com.adorbit.adorbitwidget - NOTE: if this code doesn't work, try it without the sudo in front.
3. You should see it successfully uninstall the plug-in. To verify that it's gone, click on the Finder, under to Go menu, choose Go To Folder, type in /Library, hit enter, then in the folder that opens, go to the Application Support > Adobe > CEP > extenstions, and there should NOT be a folder named "com.adorbit.adorbitwidget" anymore.
DO NOT close the Terminal application window - we will need it to install the new plug-in below, start at step 4 of the Install the Plug-in instructions below – starting with step #4.

Installing the Plug-In

Close InDesign application if already open.
Download the ExMan Command Line Tool to your desktop from this location. (If the link doesn’t work, highlight the word, right-click and choose “copy link address” then open a new browser window and paste the address in the URL line, and hit return).
1. Double click the downloaded ExManCmdMac.dmg file.
2. Double click the cmndline64 disk image on your desktop to open.
3. Double click the Contents Folder (you’ll need access to the Mac OS folder in the next steps).
Download the InDesign Plug-in.zip file from this location. Extract the .zip file on your desktop (this is a MUST).
Launch terminal, run the following commands to install extension.
1. cd{space} drag the MacOS folder into the terminal window and it will automatically populate the path - the code will look like this: cd/Volumes/cmdline64/Contents/MacOS. Hit the enter key.
2. Make sure you are at the right location; your next line appears like this: MacOS kathy$ - (Your code will of course have your name instead of kathy$)
Next, to install the plug-in type in: sudo ./ExManCmd --install {space} drag the file MagBuilderTools_16.0.8.zxp and drop it in the terminal window to add the path - hit the Enter key, it should ask for your password (when entering your password, the cursor does NOT move – you cannot see yourself typing – just type it in and hit return). You should see it installing the plug-in and receive an Installation Successful message in terminal window.

Configuring the Plug-in

Once you’ve installed the plug-in as noted above, below are the instructions for configuring the plug-in to attach to your Ad Orbit system:

Open InDesign. On your computer’s menu bar, go to InDesign > Preferences > MagHub MagBuilder Tools.
There are three fields you need to enter to connect your Ad Orbit account to InDesign:
Base URL: http://yoursite.api.maghub.com/ This is the site you use to login to Ad Orbit (should be all lowercase). Replace “yoursite” with your ad orbit instance name. (Example – my testing site is https://adorbit.maghub.com/- for theBase URL line, I would enter http://adorbit.api.maghub.com/).
API Keys: Each user can generate their own API keys or you can use the API keys from a single user account. To generate your API keys: Go to Settings > Users > User Setup. Search for the user, click on the Pencil icon that appears when hover to right (next to the ellipsis).
Scroll down to the bottom of the settings and you will see the Integrations section.
Check the box to Allow API Access.
Click the Generate API Keys Button.
Click the SAVE button (you must SAVE to save the keys before entering them into your InDesign Plug-in or they won’t work).
You need to enter both the Public and Private keys.
Note
Pay close attention to entering the API Keys in the correct fields as they are reversed in Ad Orbit.
Go to InDesign, under the Window menu, you will now see MagHub MagBuilder Tools. Select the window to start working with the MagBuilder Tools.

Updated 01/08/2024

In this section:

Help Center

Install the InDesign Plug-in

Note

Note

Search results