3.27. Customize Developer Portal

Through its Developer Portal menu option, DigitMarket™ API Manager provides you options to:

  • Manage the content of the Developer portal through its Content Management System. You can add multiple folders, and upload files into these folders. The uploaded files can be used to change the way the controls and other screen elements look on the Developer portal.

  • Categorize API Packs using the API Pack Categories option wherein you can add/edit/delete a category and decide where exactly you want each API Pack to go and the kind of Category structure you need to follow for the API Store.

  • Respond to Developer queries posted in Developer portal Discussion Forum

For more information on customizing Developer Portal, refer: Developer Portal - Overview.

In this Section:

  1. Developer Portal Content Management

  2. Manage API Pack Categories

  3. Manage Discussion Forum

Common Tasks

  • Navigate to the Content Management screen.

    To navigate to the Content Management screen:

    1. In the main Navigation menu, click Developer Portal.

    2. In the sub-menu that appears, click Content Management.

    Content Management sub-menu

    Fig. 3.546 Content Management sub-menu

    The Developer Portal Customization - Content Management screen displays.

    Content Management screen

    Fig. 3.547 Content Management screen

  • Navigate to the API Store Categories Master screen

    To navigate to the API Store Categories Master screen:

    1. In the main Navigation menu, click Developer Portal.

    2. In the sub-menu that appears, click Categories Master.

    Categories Master sub-menu

    Fig. 3.548 Categories Master sub-menu

    The API Store Categories Master screen displays.

    API Store Categories Master screen

    Fig. 3.549 API Store Categories Master screen

  • Navigate to the Discussion Forum screen

    To navigate to the Discussion Forum screen:

    1. In the main Navigation menu, click Developer Portal.

    2. In the sub-menu that appears, click Discussion Forum.

    Discussion Forum sub-menu

    Fig. 3.550 Discussion Forum sub-menu

    The Discussion Forum screen displays.

    Discussion Forum screen

    Fig. 3.551 Discussion Forum screen

3.27.1. Developer Portal Content Management

To add a folder:

  1. Navigate to the Content Management screen.

  2. Click New Folder to display the Add Folder dialog box.

    Add Folder dialog

    Fig. 3.552 Add Folder dialog

  3. In the Folder Name box, type a folder name and then click Add. The folder is added to the Dev portal Customization - Content Management screen.

To upload a file to a folder:

  1. Navigate to Content Management screen.

  2. In the Dev portal Customization - Content Management screen, click to select the folder into which you want to upload a file.

    Select a folder to upload file

    Fig. 3.553 Select a folder to upload file

    Note

    You can skip the second step if you want to upload a file to the root folder.

  3. Click New File to display the Add Files dialog box.

    Add Files dialog

    Fig. 3.554 Add Files dialog

  4. Click Upload File to select a file from your machine. Alternatively, you can drag a file from your local folders into the Choose Files box to attach a file to be uploaded.

  5. Click Add to finish uploading the files. The uploaded file displays in the selected folder

To delete a file/folder from a folder:

  1. Navigate to Content Management screen.

  2. Browse to the location of the file/folder that you want to delete.

  3. In the row that has the file that you want to delete, click the delete icon delete. A notification message, “You are about to delete a file/folder ! Are you sure to proceed?” displays.

  4. Click OK to finish deleting the file/folder.

3.27.2. Manage API Pack Categories

Categorization of API Packs is necessary for it allows you to group similar products together, which makes the task of finding an API in the Developer portal an easy one. The API Store Categories Master helps you define the structure of your API Category Tree - to define the way it should appear in the API store in the Developer portal. For instructions on how to assign an API Pack to a category, refer Brand an API Pack for Developer portal.

To add API Pack Categories:

  1. Navigate to the API Store Categories Master screen.

  2. Hover over the text: Root or any other category in the tree. A Plus Symbol displays alongside the text.

    Add Category symbol

    Fig. 3.555 Add Category symbol

  3. Click the plus symbol (to the right of the text) to add a child category. An inline text box displays.

    Text box for category name

    Fig. 3.556 Text box for category name

  4. In the inline text box, type the name for your category.

  5. Repeat steps 2 to 4 to add more categories on the same hierarchy level.

  6. Hover over any of the newly created categories to start a new hierarchy and add child categories. Repeat steps 6, 3 and 4, in that order, to continue adding more child categories.

To edit an API Pack Category:

  1. Navigate to the API Store Categories Master screen.

  2. Hover over the Category you want to edit and click the boxed plus sign (to the left of the text) on the tree to display child categories. Navigate to the desired Category and hover over it. A set of three icons displays in the right of the text.

    Edit icons

    Fig. 3.557 Edit Icons

  3. Click the notepad icon.

    Notepad icon

    Fig. 3.558 Edit Icons

    The category name goes into edit mode.

    Edit mode

    Fig. 3.559 Edit mode

  4. Make the changes and then click anywhere in the blank area of the screen to save changes.

To delete an API Pack Category:

  1. Navigate to the Developer Portal Configuration screen.

  2. Click API Store Categories Master to display the API Store Categories Master screen.

  3. Click the boxed plus symbols (in the left of the text) on the tree to display an expanded view with child categories. Navigate to the Category that you want to delete and hover over it. A set of three icons displays.

    Edit icons

    Fig. 3.560 Edit Icons

  4. Click the delete icon. The category name is deleted from the category tree.

    Note

    You are allowed to delete a Category only if there are no API Packs assigned to the Category. Refer Brand an API Pack for Developer portal, for more information on API Pack Category.

3.27.3. Manage Discussion Forum

The Discussion forum serves as a medium that enables the Publisher user to answer Developer queries posted in the Developer portal Discussion Forum.

To view posts in the Developer Discussion Forum:

  1. Navigate to the Discussion Forum screen.

  2. Click the Filter drop down box to select a category for which you want to view the posts. Available categories are Bug, Question, Suggestion, and Uncategorized. Alternatively, select All to view all posts.

    Filter Category

    Fig. 3.561 Filter Category

To reply to a post in the Developer Discussion Forum:

  1. Navigate to the Discussion Forum screen.

  2. Click the row that has the post you want to reply to. The post details display.

    Post details

    Fig. 3.562 Post details

  3. Click Reply to display a reply box.

  4. In the reply box, type your reply and then click Add Reply to post the reply.

    Post reply

    Fig. 3.563 Post reply

  5. The reply displays below the post. The reply has its own reply button that allows another user to post a counter reply. Repeat steps 3 and 4 to post more replies to the forum.

The Pagination feature at the bottom-right corner of the page allows you to choose the number of items to display per page. Five entries per page is displayed by default, but you can customize it by entering your required value in the text box at the bottom-right corner of the page. Use the previous prev and next nex icons to navigate between the pages.

To delete a post in the Developer Discussion Forum:

  1. Navigate to the Discussion Forum screen.

  2. To delete a single post, click the delete icon del.

    Post reply

    Fig. 3.564 Post reply

  3. To delete multiple posts, click the check-box on the rows that have the post you want to delete and then click Delete.

  4. A confirmation message is displayed asking you to confirm your action. Click Yes to delete.

    Post reply

    Fig. 3.565 Post reply

Next Steps

In the next section, we will take you through the tasks related to configuring Subscription-level Settings.