This page shows you how to start customizing the Nuxeo Platform using Nuxeo Studio. You'll see how to:
- Get a Nuxeo Studio project using Nuxeo Online Services
- Get a running Nuxeo Platform instance
- Change the logo of your Nuxeo Platform instance
- Create a new document type
Nuxeo Studio is a Nuxeo tool provided as part of the Nuxeo Online Services subscription offer. If you are a Nuxeo customer, you should already have a username and password to connect to and access your Studio project. Otherwise, we provide a 30-day trial offer so you can discover Nuxeo Studio and its configuration capabilities.
Get a Nuxeo Platform Instance
The Nuxeo Platform is available in different packages. Here we will use the ZIP archive.
To install and start the Nuxeo Platform ZIP archive:
- Unzip the
.ziparchive using your favorite tool.
- To start the Nuxeo Server:
MAC OS: Double-click on the
Start Nuxeo.commandfile. Windows: Double-click on the
Start Nuxeo.batfile. Linux:
chmod +x ./bin/nuxeoctl ./bin/nuxeoctl start --gui
- In a browser, go to http://localhost:8080/nuxeo.
- Fill in the information in the configuration wizard steps.
- At the Nuxeo Online Services step, provide your Nuxeo Online Services credentials. If you don't have an account, you can register for a free 30-day trial offer:
- Provide a valid email address
- Click on the confirmation link sent to the email address you provided
- Your Online Trial account should now be created
- At the Modules step, select Nuxeo JSF UI.
- Click on Start at the final step. Your application is ready to use.
Activate development mode to avoid having to package and deploy your application whenever you want to visualize your changes from Nuxeo Studio. This way you only need to hot reload from the Update Center or the Nuxeo Dev Tools extension.
To activate development mode:
- When the application has started, log in with Administrator/Administrator credentials.
- Click on ADMIN > Update Center. The Nuxeo Studio tab is displayed.
- Click on the Activate button to activate development mode.
- Click on the Restart Server button displayed on top of the Admin Center.
Edit the Logo
Our firs goal is to change the logo displayed in the banner of the Nuxeo Platform application. We'll assume you already have a logo in the PNG or JPG format.
Change the logo:
- In Studio's menu, under Customization, click on the Branding section.
- Click on the New button.
- In Feature ID field, type "MyBranding" and click on the Next button.
On the Main Pages tab:
- Check the box "Set as default branding".
- Click on the Select Resource button of the "Logo image" field. A "Select Resource" window pops up. It shows a list of images available by default, imported with the "Default Nuxeo Platform Configuration" template.
- Click on Choose File and select an image from your desktop.
- Click on the Upload button. The selected image is uploaded to Studio, added to the list of available images and selected.
- Click on the Ok button at the bottom of the popup window. The path of the uploaded image is displayed next to the Select resource button.
- Click on Save at the bottom of the screen.
Deploying Changes on Your Nuxeo Platform Instance
In Nuxeo Dev Tools extension, simply click on the Hot Reload button. Otherwise...
- Go to your Nuxeo Platform instance, typically available at http://localhost:8080/nuxeo.
- Connect with login/password Administrator/Administrator.
- Click on ADMIN > Update Center > Nuxeo Studio.
- Click on the Update button. Your logo is updated.
Here we want to create a custom document type named "Contract" that will hold specific metadata related to the notion of a contract: contract owner, starting date, policy.
- In Studio's menu, under Customization, click on the Content Model section, then Document Types. Click on the New button.
Fill in the creation form as follows and click on Next: ID: Contract Extends: File Label: Contract Description: Contract document type for internal use.
Your document type is created.
- Fill in the Definition tab:
- Fill in the Schema tab with the following metadata:
Now we'll customize the form that's used to create the document. On the Creation Layout tab:
- Click on the icon to remove the WARNING and Description widgets.
- Drag and drop the fields Owner, Start and Policy from the schema Contract to the grid.
- Click on if you wish to edit a label, then click on Save in the popup when you're done.
On the Edit Layout tab, we can customize the form used to update the metadata of the document:
- Click on the button Import Layout and select Import 'create' layout.
- Click on the button Add Row.
- Drag and drop the field Reminder from the schema Contract to the grid.
- Click on if you want to edit the widget label, then click on Save in the popup when you're done.
- On the View Layout click on the button Import Layout and select Import 'edit' layout.
- Click on Save.
- Deploy your changes on your Nuxeo Platform instance.
- Now go to a workspace in your Nuxeo Platform instance and create a new Contract document!