The theme can be installed through the WordPress Admin panel.
- Log in to the WordPress Admin panel.
- Go to Appearance -> Themes.
- Click on the Add New button, at the top of the screen.
- In Add Themes screen, click on Upload Theme.
- Click on Choose theme, and then browse for theme file on your computer.
- Click on Install Now to start the install process.
- After the installation is done, click on Activate theme.
A detailed video for theme installation is available here: https://help.themeskingdom.com/how-to-install-and-setup-the-theme.
After activating the theme, you will be prompted to install the required plugins. Required plugins are:
JetPack is the world popular plugin that extends WordPress features. In the Obscuri theme, this plugin is used to extend galleries’ features and protection. The official documentation is available here: https://help.themeskingdom.com/jetpack-plugin/.
Kirki is a plugin that enhances theme experience by adding useful elements in the Customizer, like image position picker, font settings and such.
To set the theme as presented in our demo, you can import the demo file.
Obscuri is set to present a blogging/magazine site, with a video header.
To set up the theme, please follow the next steps:
- First, create several posts – set a featured image for each post. Group posts in categories.
- Create some pages – go to Pages -> Add New and create one page – About. The About page is a simple hybrid page with information and a contact form. To create the same page as in our demo, insert blockquote and change the text color to white. Insert an image, and under the image, insert a contact form from Jetpack.
- Leave theme reading as is – Obscuri theme is displaying the latest posts on the homepage.
- Creating Primary and other menus: Go to Appearance -> Menus. Create a new menu with title e.g. Primary. Add Journal as Custom Link that leads to your landing page, and add About Us page to the navigation. To create the Follow item, add a Custom Link menu item with title Follow, and # for a link. Add links to your social profile as subitems to Follow item. Mark the menu as Primary.
- Finally, you need to add some personal touch to the theme. Go to Appearance -> Customize.
- In the Site Identity option, set your logo or add site title, and a favicon.
- Header media: In our demo, we are displaying a short, recurring video. Upload your video, or set a YouTube link. Please note that the self-hosted video should be 1920x1080px, compressed and not too long. Larger videos can prolong site loading time. Insert your text into the Header Text field – you can style it with HTML elements.
- Content Options: Set the blog to display excerpt, and leave other options turned on.
- Theme Settings: Set Blog layout to Standard.
The Customizer allows you to modify theme visuals and settings quickly. Here are the customization options in the Obscuri theme:
- Content Options
- Homepage Settings
- Theme Settings
- Color Settings
- Featured Content
- Footer Settings
- Additional CSS
- Font Settings
The Site Identity panel is used for setting up basic site identity:
- Logo: Site logo is an image in a .jpg, .jpeg or .png format. Suggested logo image size is 210 x 40px.
- Site Title: The name of your site. The ideal length should not exceed 20 characters. If the site title is longer, it will be displayed in two (or more) lines.
- Tagline: Tagline is a short description of the site, or simply a punchline of your business.
- Title and Tagline Visibility: If Display Site Title and Tagline is checked, both Site Title and Tagline will be displayed.
- Site Icon: Site icon will be displayed in a browser tab, bookmarks or in the WordPress mobile app. The icon should be squarely-shaped, and the recommended icon size is 512 x 512px.
Header Media allows you to set the video in the header instead of the featured content slider. The video is displayed in a full-screen mode. It can be either locally hosted or pulled from YouTube. A local video can cause longer loading time because the site will load the whole video, so you will need to keep the video on an optimum size. Recommended video size is 1920x1080px.
Header image will be displayed before video loads and on mobile devices – on mobile devices, the video header is by default turned off by WordPress, but it can be enabled.
Header text is displayed over a video or image, and you can use an HTML to style it.
Depending on the use case, some users need to set a background image on the site. In the Background Image panel, you can set a background image. After choosing an image, you will be able to set background behavior.
- Preset: Defines image size – Fill Screen will stretch the image to fill the whole site; Fit to the screen will cover the only visible part of the site, and Repeat will keep original image proportions, but it will repeat the image. The Custom option allows you to manually set background parameters.
- Image Positions: Tool used to define what is the starting position for the image.
- Scroll with Page: Option available only if the background image is set to Repeat. If checked, the background will scroll together with the page content.
The Customizer menu option allows the user to manage available menu locations, and add and remove menu items. Obscuri theme has two menu locations available – the Header menu, which is mostly used for the Primary menu, and the Social menu. Menus can be managed from Appearance -> Menus as well.
The Content Options panel allows you to control the visibility of posts metadata. By enabling or disabling the options you can show or hide dates, categories, tags, and the author for all posts. You can also control how posts appear on the posts page – with full content, or just as the excerpt.
Widgets are useful extensions for content, which you can add to your sidebar or other widget areas. In the Widgets option in the Customizer, you can see available widgets area in the currently active theme.
Homepage Settings work the same way Reading settings in Settings -> Reading does. Homepage settings allow you to set the theme to use static homepage, or to display the latest posts.
Theme settings panel controls blog layout, which can be displayed in the standard grid, or in a shuffle layout. In the shuffle layout, posts will be scattered, without a precise grid.
In the Theme Settings, you can also set featured slider appearance and autoplay. By default, the slider is displayed boxed, while you can enable the slider to appear in a full-screen.
Featured Content can be set tag that is used for the posts to display them as the slider on the homepage.
- Tag name: Enter the tag name that you have used for posts that you wish to appear on the homepage.
- Do not display tag in post details and tag clouds: If enabled, the tag used for the slider will not be displayed anywhere.
- Also, display tagged posts outside the Featured Content area: If enabled, posts tagged with the tag used for the slider will be displayed on all post archives pages.
- Autoplay slider: If enabled, the slider will automatically play slides.
Setting up a slider
To set up the slider, follow these steps:
- Go to Settings -> Reading. Select the homepage to display Your latest posts.
- Go to Posts -> Add New. Create several posts. For each post enter the title, and set featured image. Tag desired posts with the same tag e.g. Featured. The Tag will be used to identify and display desired posts as a slider.
- Finally, go to Appearance -> Customize, and under Home Slider Options -> Slider – Featured Content enter the tag used for the posts.
Theme colors are used to add a personal, artistic touch to the site. Lines color setting controls the color of lines on the homepage. The background color will define background color on the whole site, while other options are used for text color on the site.
Footer Copyright Text: Text that will be displayed in the footer, as footer credits. You can enter basic HTML elements to create links and stylize footer text.
The Additional CSS section is used for custom CSS classes, without interfering with theme original CSS files, or creating a child theme. These classes are always loaded first, before other stylesheets. In the Useful CSS Classes section, you can find some most used classes.
The Font Settings panel is displayed only if the Kirki Framework plugin is installed and activated. Font Settings are used to set font families and weights for global text elements 一 content, headings, and navigation. Available fonts are from Google Fonts but without the extended variants. If you need assistance on how to integrate additional variants, please submit a support ticket.
Useful CSS classes
Adding a drop cap
To create a capitalized first letter, you will need to wrap the whole code block in a paragraph with the class “drop-cap-code”.