Onigiri Documentation

Quick Specs (all Onigiri measurements in pixels)
• Default Post and Portfolio Width: 580
• Post and Portfolio Featured Image: max. 1280 + flexible height
• Content inside a div Container with the CSS class „wide-content“: max. 1280 + flexible height

1. Theme Installation

After the successful theme purchase you will receive an email including your individual theme or theme bundle download link. With this link you can download the Onigiri theme folder (onigiri.zip).

1.1. Installation via the WordPress admin panel

After downloading the onigiri.zip file to your computer, please go to Appearance → Themes in your WordPress admin panel and click the Add New button. Then click the Upload Theme button. Now you an choose to upload your the onigiri.zip file and click the Install now button. The Onigiri theme will then be your active theme.

1.2. Installation via FTP

Alternatively you can also install the theme directly to your server with a FTP client (e.g. Filezilla). Just drop the un-ziped Onigiri theme folder into your …/wp-content/themes/ folder. Now you can see the Onigiri theme in your WordPress admin panel under Appearance → Themes. From there you can activate the Onigiri theme, by hovering with your mouse cursor over the Onigiri preview image and clicking the Activate button.
Back to Top ↑

2. The Portfolio

Onigiri offers a one-column default blog option with a post width of 580px and Featured Posts with a max. width of 1280px. Next to the blog you can also create a portfolio, like you can see it on the Front Page of the Onigiri live demo. To use the Portfolio feature you will need the free Jetpack WordPress plugin.

2.1. Install Jetpack

Jetpack is a free WordPress plugin that offers a number of different features in one practical plugin (e.g. Share buttons, image gallery features, a gallery slideshow).
You can install Jetpack by searching for the plugin name under Plugins → Add New → Search and select it from the search results.

After you installed Jetpack you will need to connect it with a free WordPress.com account. This is necessary, since a lot of Jetpack features are directly connected to WordPress.com features. But you don’t need to create a new blog with WordPress.com, you can also just create a username and password for an account-only (see https://signup.wordpress.com/signup/en/?user=1). Now you can add your new WordPress.com account info to Jetpack by clicking the green „Connect to WordPress.com“ button in your Jetpack menu.

For the Portfolio feature you will only need the Custom Content Types Jetpack feature, so you can deactivate all other features if you like under Jetpack → Settings.

2.2. Create your Portfolio Projects

As soon as you have activated the „Custom Content Types“ feature, you will find the new „Portfolio“ option in your WordPress admin menu. Here you can create new Portfolio projects, just as you are used to with blog posts or pages. You can include the content for your portfolio project and select your project „Project Types“ (this can be compared to categories in blog posts), project tags and your project Featured Image (with a max. width of 1280px, larger images will be scaled). Your Portfolio projects will be sorted by their publish date.

Your Portfolio Featured Images will be visible on the portfolio page template and on Portfolio archive pages, but not on the single portfolio project. If you like to include the same image for your single portfolio projects again, you can just add it as the first image to the project content. In the Onigiri theme it is important, that you upload the Featured Image for your Projects in it’s exact size that you want them to appear in the grid on the Portfolio front page. In the single project content you could add the same image is a bigger size again.

Note: The default content width in a project is 580 pixels. If you want to include content with a max. width of 1280px you can wrap this content in your project (or post HTML editor) in an additional div container with the CSS class of wide-content. Inside this div container your can add images, videos or text that will have a 1280px width.


Here is an example code:

<div class="wide-content">
Include your content with a max. width of 1280px here…
2.3. Set the Portfolio as Front Page

Just create a new, empty page (you can give the page the title e.g. „Portfolio“ or „My Work“) and select the Page Template Portfolio Page under Page Attributes → Template. Now you can select your new page as the static Front Page under Appearance → Customize → Static Front Page.

2.4. Use your Blog on a Sub Page

If you still want to use your blog as a news stream or online journal on your website you need to create another new, empty page (you can call this page „Blog“,“News“ or „Journal“). The template should stay the default page template. Now you can choose the new page as your blog page under Appearance → Customize → Static Front Page → Posts Page.
Back to Top ↑

3. The About Page-Template

Next to a portfolio Onigiri also comes with a beautiful About page template. With the About page template you have the option to choose a custom background and About page text color under Appearance → Customize → Colors . You can choose the about page template under Page Attributes → Template for your About page.

To further design your About page you can use extra CSS text styles and the Onigiri shortcodes. Here is the example code that we used in the Onigiri live demo:

<p class="intro">Your Intro text here...</p>

Include your About image here.


Your text here...



Your text here...

Your text here...


Back to Top ↑

4. Theme Options & Customizations

Under Appearance → Customize you will find all customization options for the Onigiri theme. The great thing about the Customizer is that you can see a live preview of your changes, so you can decide if you like your changes before you save and publish them.

In the Colors tab you can change your header text color, the background color, your text link color and the About background- and text colors.

Under Theme you can make your logo fixed-positioned on wider screens and check the box to hide the search form. If you use an image as your logo and the logo should be fixed-positioned, you will need to ad the logo image height in the theme options, to make sure the following content (e.g. your header intro text) does not overlap.

Next you can choose your header intro text (HTML is allowed). You can also include your contact email and phone number for your header. If you like your email address to be a link you can add it in the following HTML format:

<a href="mailto:contact@elmastudio.de">contact@elmastudio.de</a>

You can also change the footer credit text in the theme options.

The Onigiri theme options under Appearance / Customize / Theme.
The Onigiri theme options under Appearance → Customize → Theme.

4.1. Custom Header Logo Image

You can upload your own custom logo image under Appearance → Header. You can also choose to hide the default title text here.

A Note on Custom CSS:
To include custom CSS you can use the Custom CSS feature of the Jetpack WordPress plugin, in case you have already use the Jetpack plugin for your Portfolio. Alternatively you can use the Simple Custom CSS WordPress plugin.
Back to Top ↑

5. Custom Menu

To add your own custom main menu in the Onigiri header area you can create a custom menu under Appearance → Menus. Here you can include pages, categories, tags, custom links (e.g. to link to your Twitter or Facebook profiles) or Portfolio types and save your menu in the Menu Settings (see at the bottom of your new menu) as “Primary Menu” at the bottom of the menu settings. Now your custom menu will be the menu in your Onigiri header area.
Back to Top ↑

7. Typography Styles

You can use a number of typography styles to design more interesting content for your portfolio projects, pages and posts.

Intro Text – To highlight a paragraph (e.g. the first paragraph of your text) in a bigger font size, you can wrap the paragraph in a p tag with the CSS class of “intro”.

<p class="intro">F</span>Your intro text here…</p>

Wide-Content – To include content with a wider content area of 1280px (instead of the default 580px content width) on posts, you can wrap the content in a div container with the CSS class of “wide-content”.

<div class="wide-content">
Your content here...

Pull Quotes – You can use pull quotes on your text, by wrapping a sentence or short text in a p tag with the CSS class “pull-left” or “pull-right” for left or right aligned pull quotes.

<p class="pull-left">This is a left-aligned pull quote text.</p>

Back to Top ↑

7. Shortcodes

You can find a documentation and code snippets (ready to copy/paste) for all Onigiri shortcodes on the Onigiri live demo Shortcode page.
Back to Top ↑

8. Supported Plugins

Onigiri is ready to be used with the following WordPress plugins:

Jetpack for the Portfolio Custom Content Types, Share Buttons, Social Comments, the Jetpack Carousel Gallery, Infinite Scroll (for blog and archive pages only) or Tiled Galleries
Simple Share Buttons Adder for share buttons on posts on pages
Contact Form 7 for forms
Back to Top ↑

9. Theme Translations

Onigiri is ready for theme trans­la­tions. You can add your own trans­la­tion or cust­o­mize an exis­ting trans­la­tion easily using the WordPress plugin Loco Translate.
Back to Top ↑

10. Child Theme for Customizations

If you want to cust­o­mize the Onigiri theme a little further and you need to change the code in the styleeheet (style.css) or in any of the theme tem­plate files, please con­sider crea­ting a child theme for your changes. Using a child theme is quite easy and saves all your indi­vi­dual changes from being over ­written by a future update of the Onigiri parent theme. You can find more infor­ma­tion on crea­ting a child theme in the article “WordPress Child Theme Basics” on the Themeshaper blog.

To get started you can download the sample child theme folder for the Onigiri theme. Download: Onigiri Child-Theme.
Back to Top ↑

11. Print Doc / Save as PDF

To print out or save a PDF file of this Onigiri theme documentation, just click in the Print Friendly button below. You can choose to exclude images from your print file or delete certain parts of the text.

Print Friendly and PDFPrint or Save as PDF
Back to Top ↑