Info: The information in this article only applies to the on-premise version of Studio, not to the cloud version.
A full installation of Studio is an installation on a system on which Studio is not yet installed. This article explains the steps for installing Studio on such a system.
Studio is a central place in which articles can be created, managed, and published. To make these processes work, various applications, tools, platforms, and services are used. Some of the platforms and services are part of external, remote systems.
As a result, using Studio comes with various requirements which are listed below.
Studio is installed as part of Studio Server.
An internet connection is required for the following processes:
- Working with Digital articles. Studio needs to connect to the WoodWing Cloud Services, a cloud environment which stores Component Sets, Styles, and Publication channels, and which takes care of processes such as converting a Digital article to a print article and publishing a Digital article.
When no Internet connection is available, the following tasks cannot be performed:
- Creating, editing, previewing, or publishing a Digital article
- Converting a Digital article to a print article
Filter this section to show each step individually:
The installation consists of various steps which should be performed in the following order:
- Setting up the environment
- Installing Studio
- Configuring Studio
- (Optional) Adding the JSON MIME type to IIS
- Installing the Studio Server plug-in
- Installing and configuring InDesign Server
- (Optional) Enabling the Digital editor
- Testing the installation
- Starting InDesign Server
- Activating the Studio license
- Defining article components
- (Optional) Connecting to WoodWing Cloud Services
- Setting up article templates
- (Optional) Setting up layout templates
- (Optional) Setting up Publish Channels
- (Optional) Setting up an environment for working with Digital articles
- (Optional) Installing the Desktop application
- (Optional) Adding custom functionality
- Additional configuration steps
- Using Studio
Studio is installed in an existing installation of Studio Server. Make sure therefore that you have a fully working Studio Server environment already set up, including Brands and users.
In relation to using Studio, pay attention to the following areas:
- Granting users access to features. Part of the installation of Studio Server is setting up Access Profiles. These determine which features in the application users can and cannot make use of. Verify all Access Rights to see if any Access Profiles specific to Studio users need to be set up.
- Publishing stories using the Digital editor. When the Digital editor is used for publishing stories to a digital channel, Studio Server jobs need to be set up including a job queue processor. Make sure that this is in place.
Note: It is not needed to set up one of the available default Server Jobs, the publishing process makes use of a user-initiated Server Job.
- For Apache Web Server setups. Studio includes an .htaccess file which ensures that the index.html and config.js files are not cached by the Web browser. Make sure to also adjust the caching of the index.html and config.js files in Apache by enabling the mod_headers module. Do this by uncommenting or adding the following to your Apache configuration:
LoadModule headers_module modules/mod_headers.so
For information about the module, see the Apache documentation Apache Module mod_headers.
Note: The .htaccess file is a hidden file in the Finder on macOS.
Studio is provided as a package that needs to be installed in Studio Server.
Step 1. Download the following file from the Release Announcement:
Step 2. Unzip the file.
A folder named 'Studio-11.xx-bxxx' is created containing another folder named 'contentstation'.
Step 4. Place the folder 'contentstation' in the root of your Studio Server installation.
As a minimum configuration step, the URL of the Studio Server instance to connect to needs to be defined. Optional settings are tracking user behavior, enabling logging and making applications available.
Example of a minimum configuration:
Step 1. Open the following file:
<Studio Server path>/contentstation/config.js
Step 2. Connect Studio to Studio Server by adding the Studio Server URL to the serverUrl option. Use either a relative link or an absolute link.
Absolute link (full path to the server):
Step 3. Make sure that the serverName option matches one of the server names configured in the WWSettings.xml file distributed to your workstations.
Example: Here the server name in the WWSettings.xml file is 'Studio Server':
<SCEnt:ServerInfo name="Studio Server" url="http://localhost/StudioServer/index.php"/>
'Studio Server' is therefore entered as the serverName option:
Step 4. (Optional) Through the integration of Amplitude in Studio, WoodWing anonymously tracks user behavior (see User behavior tracking in Studio). To disable this tracking, clear the value for the amplitudeId option.
Note: We kindly request to keep tracking enabled so that we can continuously improve Studio and its performance.
Step 5. (Optional) Define the level of logging that should take place by defining one of the following settings in the logs option:
- 0 Logging is disabled
- 1 Basic logging (no stack trace)
- 2 Full logging
Step 6. (Optional) Access to applications (3rd-party applications or extra sources of information such as the Publication Overview Application, WoodWing Inception, Web sites and so on) can be provided through a link in the Apps menu. This is done by defining each app as described in Working with Applications in Studio. Leave empty to remove the Apps menu altogether.
Step 7. Save and close the file.
Note: This step only needs to be performed when running Windows with IIS as a Web Server.
In order for Studio to be loaded, IIS needs to be able to serve JSON files. This is done by making sure that the JSON MIME type is present in IIS.
Step 1. Open IIS Manager and navigate to the level you want to manage.
Step 2. In Features View, double-click MIME Types.
Step 3. Verify if the .json extension is listed.
In case the .json extension is listed, all is well and you can close the IIS Manager.
In case the .json extension is not listed, continue as follows:
Step 4. In the Actions pane, click Add.
The Add MIME Type dialog box appears.
Step 5. In the File name extension text box, type the '.json' file name extension.
Step 6. In the MIME type text box, type the MIME type "application/json".
Step 7. Click OK.
Various Studio features require the use of an Studio Server plug-in. This plug-in needs to be installed and initialized.
Step 1. Download the following file for your version of Studio from the software download page:
Studio 11.x Server Plug-in Build xx
Step 2. Unzip the file.
A folder named 'ContentStation' is created.
Step 3. Place the folder in the following folder of your Studio Server installation:
Step 4. Log in to Studio Server, access the Server plug-ins page and verify that the plug-in named 'WoodWing Studio' is enabled (as indicated by a green icon). When a red icon is shown, click it to enable the plug-in.
An installation of InDesign Server — together with the Studio for InDesign Server plug-ins installed — is needed to make use of the following functionality in Studio:
- Previewing layouts
- Copyfitting articles
- Creating layouts
Step 1. Install InDesign Server as per Adobe’s instructions.
For compatible versions, see the Compatibility Matrix.
Step 2. Install the Studio plug-ins for InDesign Server by running the Studio for InDesign installer on the machine(s) running InDesign Server.
Step 3. Define the InDesign Server host by following these steps:
Step 3a. Access the InDesign Server Maintenance page: in Studio Server, click Integrations in the Maintenance menu or on the Home page, followed by InDesign Servers.
Step 3b. Click New InDesign Server.
Step 3c. Add the configuration settings:
- Host Name (IP address): Defines the address on which the SOAP interface of InDesign Server is available.
Note: This is an http address. Enter either the host’s IP address or its DNS name.
- Port Number: The port you start the InDesign Server with.
- Application Version: The version of InDesign Server. Click the Auto Detect Version button to automatically detect the installed version.
- Description: Enter a descriptive name.
- Active: Enable or disable the InDesign Server instance (enabled by default).
Step 3d. Click Update.
Step 4. Configure the following options:
The default values for the WOODWINGSYSTEMDIRECTORY are:
Therefore, the resolved default location of WEBEDITDIR is:
In these examples, WebEdit is a share created on the Studio Servers machine mounted on the InDesign Servers machine. The share gives read/write access to the InDesign Server process and is mapped onto the WEBEDITDIR location on the Studio Servers machine.
Info: This only applies to Studio 11.109 and lower.
Add the following to the config_overrule.php file of Studio Server:
define( 'CS_DIGITAL_EDITOR_ENABLED', true );
The next step involves testing the installation and configuration of Studio and InDesign Server.
Step 1. Access the Health Check page in Studio Server:
Step 1a. In the Maintenance menu or on the Home page, click Advanced. A page showing links to advanced Studio Server options appears.
Step 1b. Click Health Check. The Health Check page appears.
Step 2. Click Clear All to deselect all selected tests.
Step 3. Select the following tests:
- InDesign Server / CS Editor
Step 4. Click Test.
The test results are displayed next to the test and should display OK.
Note: If the test fails, an error is displayed together with instructions for how to solve it. Follow the instructions to fix the issue and then run the test once more.
To start InDesign Server with the SOAP interface enabled, the port to the application needs to be specified.
After completing the steps below, the soap interface of the server will be available on port 18383.
On the system(s) where InDesign Server is installed, follow these steps:
Steps for macOS
Step 1. Open a new Terminal window.
Step 2. Change to the following directory:
/Applications/InDesign CC Server <version>/
Step 3. Enter ./InDesignServer -port 18383 -previews
Steps for Windows
Step 1. Open a command prompt.
Step 2. Change to the following directory:
C:\Program Files\Adobe\Adobe InDesign CC Server <version>\
Step 3. Enter indesignserver -port 18383 -previews
Tip: The startup of InDesign Server can also be automated using Macaroni (Mac) or Scheduled Tasks (Windows).
When a new article is created in Studio, it is based on an article template in which the default article components are defined.
Once the article is created, users can add or remove article components manually when needed .
The following can be configured:
- For the Print editor:
- Which article components can be added
- Which paragraph style should be applied to the text when a component is added
- If an article component can be added only once or multiple times
For information, see Adding article components to an existing Print article in Studio - configuration.
- For the Digital editor:
- No configuration is required.
The Digital articles that are created in Studio make use of various resources such as Component Sets, styles, custom swatches, and so on. These resources are stored in a central location in the cloud in a system named WoodWing Cloud Services.
Studio needs access to these resources to work with Digital articles in the following ways:
- Using the Digital editor
- Creating a Digital article
- Creating Component sets
- Mapping components
- Saving swatches
Access to these resources is given by connecting Studio Server to WoodWing Cloud Services.
When working with Digital articles, set up the connection as described in Connecting Studio Servers and Assets Server to WoodWing Cloud Services.
Creating an article in either the Print editor or Digital editor is based on a template, in which the default article components and the styles for formatting the text are defined.
Multiple article templates can be set up within a Brand, each with different components and/or styling. When users create a new article and multiple templates are available, they can choose which one to use. Once the article is created, users can add or remove article components manually when needed.
For information about setting up article templates, see Setting up article templates for Studio.
When content is created for output to print, layouts can be created directly from within Studio. The task of creating the layout is performed by InDesign Server and is based on a layout template. Layout templates are created in InDesign with Studio for InDesign installed.
It is assumed here that a fully functioning instance of InDesign Server and InDesign with Studio for InDesign is available.
For creating layout templates, see Working with layout templates or Layout Module templates in Studio for InDesign.
When publishing stories to publication channels by making use of the Digital editor, such channels need to be set up in Studio Server. Configuration steps may also be needed in the channel to which you are publishing.
Use the information in the following articles to set up the full workflow:
- Configuring Studio for publishing to a custom Publish Channel
- Configuring Studio for publishing to Pugpig
- Configuring Studio for publishing to Twixl
Note: It is assumed here that step 7 'Enabling the Digital editor' has been performed and that step 8 'Testing the installation' was successful.
In a 'digital first' workflow in Studio, stories are first published to one or more digital output channels such as a Web CMS.
This is done by creating and publishing a Digital article using the Digital editor. Various features for working with Digital articles can be enabled:
- Setting up article components. Content is added to an article by using components. Different types of components exist, one for each type of content: body text, title, header, image, slideshow, and so on. You can control for each Digital article exactly which article components should be available, how they are presented in the selection window, how they should look and work, and which properties can be set for them. For more information, see Configuring Digital article components in Studio.
- Setting up Styles. When a Digital article is created, it is based on a template. This template contains a Style that controls the look and feel of how the Story looks. Studio has a default Style to get you started, but you most likely will want to make custom styles available, for example to bring it in line with your house style. For more information, see Styling a Story in the Digital editor of Studio by using Styles.
- Creating a variant for print. Stories that are created with the Digital editor might be re-used in a print publication such as tomorrow's newspaper or next month's magazine. To re-use a Digital article in a print workflow, a print variant of the Digital article needs to be created which is optimized for a print environment and placed on a layout. For setting up this environment, see Creating a print variant of a Digital article in Studio - configuration.
The Desktop application is used for setting up the communication between Studio and other applications.
It can be used for the following features:
- Defining which version of InDesign should be used for opening layouts
- Defining if articles should be opened in Studio or in InCopy
- Automatically opening all types of files in their native application
- Setting up a connection to Studio Server through a proxy server
- Automatically downloading a file on a user's system when it is routed (Smart Caching)
Figure: The Settings window of the Desktop application.
For information about installing and setting up the Desktop app, see Using the Desktop app of Studio.
Different working environments and workflows require a variety of different tools to get the job done easily and efficiently. Such tools vary from using spell checkers, translating sections of text, accessing external references, and so on.
When such functionality is not available in Studio by default, it can be added as custom functionality.
For more information, see Adding custom functionality to Studio.
Various parts and features of Studio can be configured to suit your needs. Review these options to see if these need to be enabled or disabled in your environment. For more information, see:
- Configuring Studio
- Configuring the Publication Overview Application in Studio
- Configuration steps for using SVG images in Digital articles in Studio
As a final test, use Studio by logging in and creating a new article.
Step 1. Access Studio by entering the following URL in a Web browser:
<Studio Server URL>/contentstation
Step 2. In the toolbar, click 'Create new...' and follow the steps for creating a new article.
- 28 March 2022: Updated section 15 'Setting up Publish Channels' by adding references to Twixl and Pugpig.
- 3 February 2022: Updated section 7 'Enabling the Digital editor' with information about the version of Studio the step applies to.