You can customize your Developer Portal home page to
display images in a carousel. The image carousel provides your Developer Portal home page with a
continuous slide show that is customized to your specifications.
Before you begin
You must have administrator access to complete this task.
About this task
By implementing an image carousel, you can replace the default welcome banner or any previously
set images.
Procedure
-
Click Modules, ensure that Views UI is set to
ON, and click Save configuration.
Note: Having the Views UI in the ON state slows
the performance in the Developer Portal. Ensure that it is
set to ON only for the setup process.
-
Create a content type for your carousel.
-
Click Structure, then click .
-
Enter the name of your content type in the Name field.
For example, Slide show Picture.
- Optional:
Specify the description of your content type in the Description field.
For example, A picture to display in the slideshow.
-
Click Save content type, then click manage fields
for your newly created content type.
-
Delete the Body field.
-
Label your field in the Add a new field section.
For example, slide image.
- Optional:
Label your machine name by clicking edit next to the label that is
generated automatically.
-
Select Image as your field type from the list.
-
Ensure that the widget type is Image, then click
Save.
-
Click Browse to assign the image that you want as your default image for
your slide show if no other images are found.
-
Click Save field settings, then click Save
settings.
-
Upload the images that you want to appear in your carousel.
-
Click , then click the content type that you added in step 2.
-
Enter a title for your image in the Title field.
For example, if you had an image of a lighthouse, you can label the content as
Lighthouse.
-
Click Browse to find an image for your slide show, click
Upload to upload the image, then click Save.
-
Click + Clone content to open a clone of the image you created. Replace
the title and image of the clone with what you want the next slide to contain.
-
Repeat the cloning and editing process until you are satisfied with the content your slides,
and the number of them.
-
Create a view for your carousel.
-
Click Structure, then click .
-
Label your view.
For example, Slide show.
-
Clear the Create a page check box, and select the Create a
block check box.
-
Select Slick carousel in the display format section.
-
Enter the number of slides you have for your carousel in the Items per
page field, then click Continue and edit.
-
Click Title and enter <none> into the text
field. Click Apply (all displays).
-
In the Format section, click Settings for Slick Carousel, and then set
Skin Main to Default. Click Apply (all
displays).
-
In the Fields section, click .
-
Clear the check box for Create a label, then click Apply (all
displays).
-
In the Fields section, click .
-
In the Filter Criteria section, click .
-
In the Filter Criteria section, click Add and
select one part of the slide image content type that you created for your carousel in step 2. Click Apply (all
displays), then click Apply (all displays) again.
Setting this filter criteria ensures that when new content is published to the Developer Portal, the slide show
continues to display correctly.
-
Click Save.
-
Enable the carousel functionality on your Developer Portal home page.
-
Click Configuration, then click .
-
For Default, click edit, then click the
settings tab in the list on the left.
-
Select Autoplay, then click Save.
-
Configure your home page to host the carousel.
-
Click Structure, then click Pages.
-
Click Edit for the Welcome page, then click
Content in the Panel section.
-
To remove the welcome banner, click the Settings icon in the
Welcome Banner section for the Top pane, and click
Remove.
-
For the Top pane, click . Click Finish.
-
Click Update and save.
-
Click Modules, and set Views UI to
OFF. Click Save configuration.
Results
Your Developer Portal
front page has a slide show carousel.
What to do next
The default color for the carousel arrows are orange. You can override the default color by
inserting the following code into the overrides.css file in a custom theme:
/* carousel */
.slick-prev::before, .slick-next::before {
color: #ffffff;
}
For more information on editing custom themes, see Tutorial: Customizing themes for the Developer Portal.