Tutorial: Adding a custom block to a page other than the front page
You can customize the appearance of a page on your Developer Portal by adding a custom block. Blocks are boxes of content that are rendered into an area or region of a web page, such as the Products page or Apps page. Blocks can be displayed in regions, such as footer or sidebar, on your page.
Before you beginYou must have a Developer Portal enabled, and you must have administrator access to complete this tutorial. The tutorial Creating the Portal explains how to enable the portal if you have not already done so. The tutorial Adding a custom block to the front page explains how to add a custom block to the front page.
About this tutorial
In this tutorial, you create a custom block that contains extra guidance on application creation and registration, and add that custom block to the Apps page of your Developer Portal.
The Apps page displays like this before the block is added.
This tutorial takes you through creating a custom block, and configuring it to show on the Apps page.
- Log in to your Developer Portal as an administrator.
- If the administrator dashboard isn’t displayed, click Manage to display it.
- Navigate to .
- Enter App Info in the
- In the body area, click
Source, then enter this HTML:
<div class="tutorial_block_2"> <p>Before you can use an API, you must create an application. When you create an application you are provided with a client ID and client secret for the application. You must supply the client ID when you call an API that requires you to identify your application by using a client ID, or a client ID and client Secret.</p> </div>
- To see a preview of the block click
Sourceagain.Note: This block uses almost no inline-styling, instead it allows your theme to decide how it is rendered. The advantage of this set up is that you can easily change the rendering without modifying existing content in the database. Any styling that is required can be added to a custom theme. For more information, see Tutorial: Creating a custom theme for the Developer Portal.
- Enter Creating an App in the
Titlebox, keep the
- Enter /application in the
Pagestext area, keep the
Show for the listed pagesselected.
What you did in this tutorial
The Apps page now has an additional block with a guidance message.
What to do next
Instead of using inline styling like that provided in the html, adopt best practice by adding class selectors and developing a custom theme. By default this block is English, so you might want to consider adding translated versions.