Theme installation

The easiest way to install the theme, is by accessing your WordPress admin panel, then go to Appearance > Themes. Select the Install Themes tab and click the Upload link located just below the tab’s name. Click on Browse… and select the WordPress theme zip file you just downloaded. Then click the Install Now button, and after a few seconds, your new theme should be installed. Click activate and the theme is ready to use.

TIP: A more visual guide can be found here.

In order to install the theme manually, or in case you have trouble installing it through the admin panel, you have to unzip the WordPress theme’s zip file on your computer, and upload via FTP the resulting theme folder into your WordPress installation themes folder (wp-content/themes). Then, from the WordPress admin go to Appearance > Themes. The theme should be available in your themes list. Click activate.

Importing sample content

To get the sample content file you can click the link in the notice that will appear on your dashboard immediately after activating the theme.

download_sample

Extract the zip file you downloaded and upload the xml file in Tools > Import > WordPress (if not already present, you will be prompted to install the WordPress importer plugin), assing the authors to an existing user and make sure you check the “import attachments” box. You can now import the sample content.

Importing widgets

You can also import the widgets you see on the theme’s demo. To do that, you need the Widget Importer & Exporter plugin. To install it go to Plugins > Add new search for widget importer exporter and install the plugin. Activate it and go to Tools > Widget Importer & Exporter click choose file and upload the suisen_widgets.wie file which is located in the sample content zip file, click Import widgets and you are good to go.

WARNING: As this will create posts, pages, custom post types, categories, widgets, etc. and change various system settings, it is strongly advised that you do this on a clean WordPress installation, without any previous and/or precious data. Under no circumstances we can be held responsible for total or partial data loss, so please be careful.

WooCommerce

To enable eCommerce functionality for your website you need to install and activate the WooCommerce plugin by WooThemes. You can download the plugin free of charge from the WordPress Plugin Repository. For installation and usage instructions please refer to the plugin’s documentation.

Once you have installed and activated the WooCommerce plugin please install its pages by clicking on the button that WooCommerce provides on its banner. This will likely create a duplicate of some pages along with the pages installed by the sample content but its a needed step. You can delete the old pages that came with the sample content or use them instead by going to WooCommerce > Settings > Products > Display and assign them anew.

Setting up your theme

1) Populating your blog

To add new posts to your blog, go to Posts > add new and proceed to:

  1. add a title to your post,
  2. enter the content in the editor,
  3. add a category and/or tag to the post,
  4. upload a featured image by clicking “Set featured image” on the Featured Image panel,
  5. once done click the Publish/Update button.

2) Customizing the appearance

All theme customization is done via WordPress’s built in customizer. If you haven’t used it or want to learn more about it, please read this article.

Go to Appearance > Customize and you will see this

suisen_customizer

 

TIP: any changes you make in the tabs below will be previewed live on the site which appears in right side of the screen, however to save these changes you need to click the Save & Publish button on the top of the bar, if you have made a change but see the button grayed out (for example changed the font size of a heading), move the cursor outside the input box, for example, to the next input box, then the button should be clickable again.

Let’s take a look at the options each tab gives you.

  • Menus

    Here you can create and assign menus to the theme. The theme features one menu location, the main menu one. To learn more about menu creation check out the Codex’s menu user guide here.

  • Site Identity

    In this tab you can modify the site’s title, tagline, logo and site icon.

  • Layout Options

    Here you can select the number of words in the automatic excerpt, select pagination style, toggle product title and layout and enable the masonry effect.

  • Content Colors

    Are you looking to create your own unique color scheme? This tab will help you do it by allowing you to modify the colors of many elements of the content. To do that click the Select Color button and either use a hex color value in the box or use the palette to select a color.

    color_change
  • Widgets

    Through this tab you can add widgets to the theme’s sidebars. The theme features three sidebars, the homepage one and two pre-footer sidebars.

  • Social Networks

    Here you can fill in the URLs to your various social network profiles supported by the theme. You can display them in a sidebar by using the Theme – Social Icons widget.

  • Posts Options

    Here you can toggle various aspects of the single post and post listings, like the appearance of categories, tags, date, comments, social sharing etc.

  • Footer Options

    Here you can modify the footer text.

  • Static Front Page

    Use this tab to make the Home page your static front page so you can take advantage of the homepage template we have created for you.

  • Other

    In this tab we host the custom CSS panel which you can use to insert styles for elements not covered in the rest of the tabs. Also here you can set the Google Analytics ID to get statistics on your site.

Theme pages

The Home page

To create your home page, create a page named Home and apply to it the Homepage Template to it.

The blog page

To create a post listing page, create a new page named Blog and publish it.

Setting the static pages

Once we have created the two pages above  you need to set them as default. To do that go to Settings > Reading and configure them as shown below.

settings_reading

The contact page

To create a contact page similar to the one found on the theme’s demo, you can create a new page, name it Contact and use the Contact Form 7 plugin to help you create a contact form, then paste the shortcode it provides in the page’s text editor, publish and you are done.

Widgets

Along with WordPress’s widgets we have created 4 custom ones. You can see them below.

suisen_widgets

You will find a small description in each widget detailing its usage.

How to use the latest posts widget

The Theme – Latest Posts widget will help you display your posts on the front page. Let’s take a look at how to use it.

latest_posts_suisen

We start by adding a title to the widget, next we select a post category to display on it (leaving the option empty will display posts from all categories), below we can select whether we want our posts to appear at random (default is by date from newest to oldest) and how many posts we want to display on the widget. Finally you can choose to make the first item appear bigger by checking the corresponding box.

Excluding post categories from the widget

As mentioned above, if we don’t select a post category on the widget it will display posts from all categories. We can exclude some of them if we wish. In the example above we created a widget which pulls posts from the style category, now lets create another one, which displays posts from all categories apart from the style one.

latest_posts_exclude_suisen

as you can see it’s very easy, we just tick the box to exclude the category we want and we are done.

Recreating the demo’s homepage layout

If you chose not to import the default widgets, but still want to recreate the homepage layout of the theme’s demo, let’s have a look on how you can achieve it.

The Homepage sidebar

Under Customize > Widgets you can access the homepage sidebar, let’s take a look at the widgets used on the theme’s demo:

  • Text – a text widget with some introductory text.
  • Theme – Post Type Items displaying four WooCommerce products.
  • Text – a text widget with some text.
  • Theme – Product Category Images  displaying the images of two product categories.
  • Theme – Post Type Items displaying five WooCommerce products.

TIP: Info on how to use the latest posts widget can be found in the widgets section here.

How to use the page builder template

The theme comes bundled with a page builder template which allows you to use your favorite page builder plugin on it and create unique layouts very easily.

To use that template start by going to Pages > Add New. This will create a new page. Add a title to your page and select the Page builder template from the template drop down in the Page Attributes metabox.

ci_page_builder_template

That’s it. You can now start building your page using the page builder of your choice, once done publish it and check it out.

Additional information

Useful Plugins

  • Contact Form 7 use this plugin to create a contact form, then copy the shortcode it gives you and paste it in a page which will serve as your contact page.
  • WP Instagram Widget: Use this plugin to help you display your Instagram feed in any of the theme’s sidebars.
  • WordPress Jetpack: You can use this to create a contact form instead of Contact Form 7, insert sharing buttons, create tiled galleries etc.

Image Sizes

The minimum recommended image sizes for Suisen are:

  • Post listing thumbnail: 600x480px
  • Post single featured image: 1140x475px
  • Large thumbnail (single column layouts): 1140x750px
  • Cart thumb: 120x120px